Loading sub-menu...

Galicaster Mobile Installation Guide

compared with
Current by developer
on ago 23, 2012 14:47.

Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (88)

View Page History
{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]
* [BC. Network configuration|#net]
** [Matterhorn configuration|#mh]
* [C. Galicaster configuration|#gcconf]
** [1. Sound configuration|#sound]
* [D. Troubleshooting|#trouble]
* [D. Opencast Matterhorn Related configuration|#mh]
{column}
{section}

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

On your Galicaster Mobile unit you can use 3 different capture cards to record your multistream material. Depending on the scheme you are about to use you should combine different inputs.
The Galicaster Mobile Unit comes equipped with different inputs to fulfil your needs on recording multistream material. Depending on the devices you are about to use you should combine those inputs properly.

* VGA grabber: Epiphan VGA2USB LR
* SDI capturer: Blackmagic Decklink SDI
* NTSC capturer: Hauppauge PVR-350
There are two main combinations, depending on the type of camera (NTSC or SDI) you use to record the presenter. In both cases you have to use a VGA grabber to record the slides. Those combinations will be explained briefly on the next two sections.

!mobile_cards.png|align=center,border=1,width=400,thumbnail!
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

Depending on the scheme you're using you should connect your camera to the Blackmagic Card (SDI) or to the Hauppauge card (NTSC / PAL ). Appart for it, remember to connect the monitor to the graphical card output, not to the motherboard.
|| \# ||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.|
| B2 | *SDI output* | To connect an auxiliary monitor for the SDI video.|
| B3 | *SDI input* | To connect the video camera, BNC connector.|
| B4 | *Ref IN* | To connect a reference signal the monitor of the computer.|

{column}
{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

|| \# ||Port || Description||
| C1 | *Antenna input* | For TV tuning purposes, coaxial wire.|
| C2 | *S-Video input* | To connect the video camera, 4-pin connector.|
| C3 | *Composite input* | To connect the video camera, RCA connector.|
| 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.

!RCA_scheme.png|align=center,border=1,width=400,thumbnail!
* 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)*
* Connect a *laptop* or computer to the Epiphan input. *(D1)*
* Connect a *mixer* or a line-level microphone to the Hauppauge Line input. *(C4)*
* To monitor the sound connect a pair of *headphones* or speakers to the sound card green output. *(E3)*

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

# Audio input
# Video capture
# VGA capture
# Monitor output
\\
!cards_hau_closer.png|align=center,border=1,width=400!
Once you have everything connected jump to [section B|#hau] to configure the device and the audio.


{anchor:sdi}
h4. A.2 SDI based configuration
----
On this scheme you will be using a Epiphan VGA2USB LR to capture the presentation and a Blackmagic Decklink SDI to capture a SD-SDI or HD-SDI (720p or 1080p i.e.) video camera. The sound will be recorded via the sound card.

!SDI_scheme.png|align=center,border=1,width=400,thumbnail!
* Connect your *monitor* to an output of the Graphics card. *(A1 to A3)*.
* 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)*

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

# Audio input
# Video capture
# VGA capture
# Monitor output
\\
!cards_bm_closer.png|align=center,border=1,width=400!
Once you have everything connected jump to [section B|#gcconf] to configure the device and the audio.

{anchor:net}
h3. B. Network Configuration

{anchor:mh} {anchor:gcconf}
h3. B. Capture Devices configuration
----

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

If you have a OC-Matterhorn running you should ask your Matterhorn system manager for some information. First of all you need a *digest user* - a regular one won't work-, there is a default account for this matters that should be replaced for custom ones.
* Blackmagic + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/bm_mobile/conf.ini]

{code:none}
username: matterhorn_system_account
password: CHANGE_ME
{code}
* Hauppauge + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]

You need the admin host address, port included. For example:
Now, it's time to configure the card you've selected and audio. More information about this matter is available [here|1.1 Cookbook].

{anchor:hau}
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}
host = http://fakeadmin.matterhorn.com:80
v4l2-ctl -d /dev/haucamera --list-standards | grep Index -A 2
v4l2-ctl -d /dev/haucamera -s 0
{code}
You also need to stablish a default workflow and its parameters. Scheduled recordings will have his own workflow and parameters, set on the scheduling operation, but not the recordings started manually. The usual parameters you have to set are *captions* and *trimHold*, which value is *False* by default. The usual configuration is:

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

{code:none}
workflow = full
workflow-parameters = trimHold:true
v4l2-ctl -d /dev/haucamera -n | grep Input -A 1
v4l2-ctl -d /dev/haucamera -i 2
{code}

If you have more than one parameter:
Inputs 1 and 3 are for 4-pin.
Inputs 2, 4 and 5 are for RCA.

{code:none}workflow-parameters = trimHold:true;captions=True{code}
{anchor:bm}
h4. B.2 Blackmagic configuration
----
To list the input standards and formats supported by Blackmagic cards run the following line in a shell:

Finally, you have to decide if your recordings should 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
gst-inspect-0.10 decklinksrc | grep Enum -A 20
{code}

{anchor:gccong}
h3. C. Galicaster configuration
Once you identified the format you want to capture, edit the _conf.ini_ file you've just downloaded. Search for the _track_ Blackmagic and change the 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 _progressive_
The _i_ in 1080i stands for _interlaced_

Galicaster is configurated by a pair of files _conf-dist.ini_ and _conf.ini_. You can download two different models of _conf.ini_ depending on the cards you are using:
{anchor:sound}
h4. C.3 Sound configuration
----
To have the best audio feedback on your interface you should configure your audio inputs properly. First of all, go to the Sound Manager (speaker icon on the top right corner of the desktop)

* Blackmagic + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/bm_mobile/conf.ini]
*Headphones output*
Regulate this slide bar to a comfortable sound level.

* Hauppauge + Epiphan: [conf.ini | http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]
*Pulse input ( Line in):*
_If you are using the Hauppauge card please skip this section_
Select the input you are using and set the values to 100% volume, no amplification.
Later, if you have distortion on your audio input, edit the conf.ini and set _amplification = 1.0_ in the AudioSource device.

{anchor:sound} _Recommendation_
h4 C.1 Sound configuration
----
On the pulse track of your conf.ini, don't leave the value _location_ as _default. List the inputs and set it. This way you won't need to check it every time you switch on your unit. To do that, run in a shell:

To have the best audio feedback on your interface you should configurate your audio inputs properly.
{code:none}
pactl list | grep Source -A 2
{code}

*Pulse input ( Line in):*
_If you are using the Hauppauge card you don't have to worry about all this._
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 it with no amplification, 100% volume.
Later, if you have distortion on your audio input, edit the conf.ini and set _amplification = 1.0_ on the AudioSource device.
Identify the input you want to use, for example
{code:none}
alsa_input.pci-0000_00_1b.0.analog-stereo
{code}

*Headphones output*
Regulate this slide bar to a confortable sound level.
Use the _name_ as _location_ on the _conf.ini_ pulse track
{code:none}
[track3]
name = AudioSource
device = pulse
flavor = presenter
active = True
*location = alsa_input.pci-0000_00_1b.0.analog-stereo*
file = sound.mp3
amplification = 2.0
vumeter = True
player = True
{code}
----
\\

*Galicaster Vumeter*

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.
* 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.

If after configure the Sound Manager and your Mixer or Sound input device you still have problems, 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
{anchor:net}
h3. C. Network Configuration
----

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

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

* Monitor
* Power supply
!netmanager.png|align=left!
\\

h5. Video malfunctioning
{anchor:mh}
h3. D. Opencast Matterhorn related configuration
----

* Green image
* Black & White
* Black screen
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_.