Galicaster Mobile Installation Guide

{pop-away:metadata | comments | children | labels}

{section}
{column:width=59%}
h2. Introduction

On this section you will be guided through a series of steps to finish the setup of your Galicaster Mobile unit. Please, read this documentation carefully and follow its instructions. In case of doubts please take advantage of the [Galicaster Community list|Galicaster:Community] to make any question or suggestion.

In the following sections you will receive instructions on how to connect and configure you Galicaster unit.

{column}
{column:width=38%}
h2. Contents

* [A. Cards and connectors|#cards]
** [1. NTSC-based configuration|#ntsc]
** [2. SDI-based configuration|#sdi]
* [B. Capture Devices configuration|#gcconf]
** [1. Hauppauge configuration|#hau]
** [2. Blackmagic configuration|#bm]
** [3. Sound configuration|#sound]
* [C. Network configuration|#net]
* [D. Opencast Matterhorn Related configuration|#mh]
{column}
{section}

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

Please, take a closer look to the image to identify the ports of each capture card before connecting anything.
{section}
{column: 59 %}
h5. a.Graphics card

|| \# ||Port || Description||
| A1 | *VGA output* | To connect the monitor of the computer.|
| A2 | *HDMI output* | To connect the monitor of the computer.|
| A3 | *DVI output* | To connect the monitor of the computer.|

h5. b.Blackmagic card

|| \# ||Port || Description||
| B1 | *Deck port* | To connect a control desk via RS-422 interface.|

{column: 39 %}
!ports.png|align=center,thumbnail,width=400,border=1!
{center}Click on the image to enlarge.{center}
{column}
{section}


h5. c.Hauppauge card

| C4 | *Audio input* | To connect a mixer or a microphone to record, mini-jack 3.5mm.|
| C5 | *IR input* | To connect an IR receptor for a remote control.|

h5. d.Epiphan card
|| \# ||Port || Description||
| D1 | *VGA capture* | To connect a laptop or computer VGA output to capture it |


h5. e.On-board sound card

|| \# ||Port || Description||
| E1 | *Line IN* | (Recommended) To connect a mixer or a line level microphone to record, mini-jack 3.5mm.|
| E2 | *Headphones OUT* | To connect a mixer or a microphone to record, mini-jack 3.5mm.|
| E3 | *Microphone IN* | To connect a microphone to record, mini-jack 3.5mm.|

h5. f.Motherboard

| F1 | *Mouse-Keyboard* | PS2 connector for keyboard or mouse|
| F2 | *USB hub* | External USB 2.0 hub for multiple purposes.|
| F3 | *SPDIF input* | External USB 2.0 hub for multiple purposes.|
| F4 | *HDMI output* | *DON'T USE*.|
| F5 | *VGA output* | *DON'T USE*.|
| F6 | *USB hub* | External USB 2.0 hub for multiple purposes.|
| F7 | *LAN input* | To connect a RJ45 connector for network purposes.|
\\

{anchor:ntsc}
h4. A.1 NTSC based configuration
----
On this scheme you will be using a Epiphan VGA2USB LR to capture the presentation and a Hauppauge PVR-250 to capture a composite NTSC video camera. The sound will be recorded and synchronized by the Hauppauge card.

* Connect your *monitor* to an output of the Graphics card *(A1 to A3)*
* Connect the *RCA* or 4-pin connector from your camera. *(C2 or C3)*

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

Once you have everything connected jump to [section B|#hau] to configure the device and the audio.


{anchor:sdi}

* Connect the BNC connector from your *camera*. *(B3)*
* Connect a *laptop* or computer to the Epiphan input. *(D1)*
* Connect a *mixer* or a line-level microphone to the sound card blue input. *(E1)*
* To monitor the sound connect a pair of *headphones* or speakers to the sound card green output. *(E3)*

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

Once you have everything connected jump to [section B|#gcconf] to configure the device and the audio.


{anchor:gcconf}
h3. B. Capture Devices 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]

h4. B.1 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}

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:bm}

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

{anchor:sound}

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

* Press F6 to select the input and F4 to go to the Capture section.
* You can check the real Gain on _Item_ on the top left corner of the screen.

{anchor:net}
h3. C. 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}
h3. D. Opencast Matterhorn related configuration
----

If you have a OC-Matterhorn running you have to ask your Matterhorn system administrator for some information.

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

{code:none}
host = http://fakeadmin.matterhorn.com:80
{code}

You also 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 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}

This piece of code must be written on one of the configurations file. Be aware that values in _conf.ini_ will overrule its equivalent in _conf-dist.ini_.