Galicaster Mobile Installation Guide

** [1. NTSC-based configuration|#ntsc]
** [2. SDI-based configuration|#sdi]
* [B. Network configuration|#net]
** [Matterhorn configuration|#mh]
* [C. Galicaster configuration|#gcconf]
** [1. Blackmagic configuration|#bm]
** [2. Hauppauge configuration|#hau]
** [3. Sound configuration|#sound]

{anchor:cards}
h3. A. Cards and connectors

You can use 3 different capture cards to record your multistream material on your Galicaster Mobile unit. Depending on the scheme you are about to use, you have to combine different inputs.

* VGA grabber: Epiphan VGA2USB LR
* SDI capturer: Blackmagic Decklink SDI
* NTSC capturer: Hauppauge PVR-350

!mobile_cards.png|align=center,border=1,width=400,thumbnail!

Once you have chosen which devices to use, you need to connect your camera to the Blackmagic Card (SDI) or to the Hauppauge card (NTSC / PAL ). Apart from that, remember to connect the monitor to the graphic card output, not to the motherboard.

{center}Click on the image to enlarge.{center}

h5. Port Description

# Audio input
# Video capture
# VGA capture
# Monitor output
\\
!cards_hau_closer.png|align=center,border=1,width=400!


{anchor:sdi}
h4. A.2 SDI based configuration

!sdi_scheme.png|align=center,border=1,width=400,thumbnail!
{center}Click on the image to enlarge.{center}

h5. Port Description

# Audio input
# Video capture
# VGA capture
# Monitor output
\\
!cards_bm_closer.png|align=center,border=1,width=400!

{anchor:net}
h3. B. Network Configuration

To change your IP settings, pleas read this [official Ubuntu guideline|https://help.ubuntu.com/10.04/internet/C/connecting-wired.html]

The Network Manager is on the top right corner, Right-button click on the double arrow icon

!netmanager.png|align=left!
\\



{anchor:mh}
h4. B.1 Matterhorn configuration

If you have a OC-Matterhorn running you have to ask your Matterhorn system administrator for some information. First of all, you need a *digest user* - a regular one won't work-. There is a default digest account that should be replaced with your own values.

{code:none}
username: matterhorn_system_account
password: CHANGE_ME
{code}

You need the admin host address, including the port. For example:

{code:none}
host = http://fakeadmin.matterhorn.com:80
{code}
You also need to set up a default workflow and its parameters. Scheduled recordings will have his own workflow and parameters, defined in the scheduling operation, but the recordings started manually won't. The usual parameters you have to set up are *captions* and *trimHold*, which default to *False*. The normal configuration is:

{code:none}
workflow = full
workflow-parameters = trimHold:true
{code}

If you set up more than one parameter:

{code:none}workflow-parameters = trimHold:true;captions=True{code}

Finally, you have to decide if your recordings will be recorded automatically or not. If you want to do so, set *default* to True. All the configuration together will look like:

{code:none}
[ingest]
active = True
default = False
host = http://fakeadmin.matterhorn.com:80
username = matterhorn_system_account
password = CHANGE_ME
workflow = full
workflow-parameters = trimHold:true
{code}

{anchor:gcconf}
h3. C. Galicaster configuration

Galicaster configuration is specified in two files _conf-dist.ini_ and _conf.ini_. You can download two different models of _conf.ini_ depending on the cards you are using:

* Blackmagic + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/bm_mobile/conf.ini]

* Hauppauge + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]

Now, it's time to configure the card you've selected. More information about this matter is available [here|Galicaster:Cookbook].

{anchor:bm}
h4. C.1 Blackmagic configuration
To list the input standars and formats supported by Blackmagic cards run the following line in a shell:

{code:none}
gst-inspect-0.10 decklinksrc | grep Enum -A 20
{code}

Once you identified the format you want to capture, edit the _conf.ini_ file you've just downloaded and change parameters _input_ and _input_type_ for their right values. Some try-and-error may be neccessary since maybe you can't gather all the information from your video source.
The _p_ in 1080p stands for _progresive_
The _i_ in 1080i stands for _interlaced_

{anchor:hau}
h4. C.2 Hauppauge configuration
Before running Galicaster you may have to configure your Hauppauge card. Connect your camera and do the following:

*Standard selection*
You have to choose between a list of standards. To list and select the standard, run in a shell:

{code:none}
v4l2-ctl -d /dev/haucamera --list-standards | grep Index -A 2
v4l2-ctl -d /dev/haucamera -s 0
{code}

*Input selection*
Depending on the input you are using you have to choose bettween S-Video (4-pin) and Composite (RCA). To list and select the input, run in shell:

{code:none}
v4l2-ctl -d /dev/haucamera -n | grep Input -A 1
v4l2-ctl -d /dev/haucamera -i 2
{code}

Inputs 1 and 3 are for 4-pin.
Inputs 2, 4 and 5 are for RCA.


{anchor:sound}
h4. C.3 Sound configuration

To have the best audio feedback on your interface you should configure your audio inputs properly.

*Pulse input ( Line in):*
_If you are using the Hauppauge card please skip this section_
First of all, go to the Sound Manager (speaker icon on the top right corner of the desktop), select the input you are using and set the values to no amplification, 100% volume.
Later, if you have distortion on your audio input, edit the conf.ini and set _amplification = 1.0_ in the AudioSource device.

*Headphones output*
Regulate this slide bar to a confortable sound level.

*Galicaster Vumeter*
Add this section in the _conf.ini_ file.

{code:none}
[audio]
min = -60
max = 0
{code}

If the NO SOUND dialog is coming in and out constantly, set a higher value on _min_, for example -40.

* Alsa Advanced configuration *

If you still experience problems after configuring the Sound Manager and your Mixer or Sound input device, you should take a look to ALSA.
Run _alsamixer_ on a shell and ensure that your device is not being amplified. You can check the real Gain on _Item_ on the top left corner of the screen. Press F6 to select the input and F4 to go to the Capture section.