next_inactive up previous


LMLBT4x Installation and User Manual

Linux Media Labs

2010-12-07


Contents

1 General Description

The LMLBT4x board is a multi-channel PCI board based on the BT878 chip. These are the general LMLBT4x board's features:

LMLBT44 and LMLBT4M video capture function is fully supported in the shipping Linux kernel (version 2.6 and above) and does not require any additional patching or kernel modifications.

2 Notational Conventions

You input is designated with $, for the command shell input prompt, and with # for superuser mode input. Your input and system response are presented in bold face. Filenames and URLs are underlined. System commands (line uname -r) are using San Serif font.

3 System Requirements

4 Physical Installation

Open computer case. Install LMLBTx card into available PCI slot.

Video inputs on the main board are numbered IN1, IN2, IN2, IN4 counting from top. The video inputs on the expansion board are labeled in the same fashion. Connection of the Expansion Cable is simple. It must be connected to the main card to PINS labeled P7 with PIN 1 ( Red Cable ) UP. On the expansion card, the cable must also be connected with PIN 1 ( Red Cable ) UP.

\includegraphics[bb=0bp 0bp 829bp 500bp,scale=0.6]{LMLBT44Exp}

The Video Inputs on the back of the LMLBT44 Card, LMLBT4M Card and the Expansion Slot for the LMLBT44 are labeled from Top to bottom. NOTE: Channels in xawtv do not reflect the numbers etched on the back of either the LMLBT44card or its expansion slot. Instead, xawtv labels the channels from the bottom, in reverse to the etched numbers. However, if you have the LMLBT4M card, the numbers on the back of the card are the same as the xawtv channels (Composite0,1,2 and 3) : with Composite0 being the same as IN1 on the back of the card.

\includegraphics[scale=0.7]{LMLBT44conn}

Pin assignments on a 15-ping sensor/alarm IO connector are as follows:

Pin Name Comment
1

Sensor's GND1,2,3,4 are all connected together and to PCI bus ground. Sensor inputs (IN1,2,3,4) are optically decoupled. Sensor produces signal, when input and ground are connected with less then 100 Ohm resistance, i.e. some kind of a switch is required.

Relay outputs are all floating, there is no connection to ground on either COM or NO side.

5 Video4Linux Driver LMLBT4x overview

You may load the bttv driver after each reboot manually, or modify the/etc/modules and /etc/modprobe.d/bttv to let this happen automatically.

Make sure to install driver when no X11 is running, or restart X11 after inserting the driver. Otherwise V4L X11 module caches video card settings, preventing kernel driver from using LML patches provided features.

There is no need to patch the 2.6 series kenels, unless you want to take advantage of LMLBT44 sensor/alarm I/O capabilities. If you want to take advantage of sensor/alarm I/O follow the procdure in the patch file.

5.1 Manually Loading Driver Module

To manually load the driver:
$ sudo /sbin/modprobe bttv card=118 pll=1
or for LMLBT44:
$ sudo /sbin/modprobe bttv card=118,118,118,118 pll=1,1,1,1

5.2 Configuring the System to Load Driver Module Automatically

In order to load bttv.o module automatically you need to do the following:
Append the following line to file /etc/modules for LMLBT4M and LMLBT44:
bttv

Create /etc/modprobe.d/bttv.conf with this line for LMLBT4M:
options bttv card=118 pll=1

and for LMLBT44:
options bttv card=118,118,118,118 pll=1,1,1,1

run depmod to update system configuration:
# depmod -a
now, you should be able to autoload the driver when a program requests it.

6 Video monitoring Application (xawtv)

Xawtv software allows you to test LMLBT44 card operation at rather low level.

6.1 Building

6.2 Installation

Under Ubuntu:
sudo apt-get install xawtv

Under Fedora:
sudo yum install xawtv

6.3 Configuration file

You should create configuration presets and defaults for xawtv, by the way of editing ~/.xawtv file. This file is not created automatically during the installation process. You will need to create it in the home directory of the user(s) that will be using the application.

This is an example of the ~/.xawtvfile (for EU, PAL):

# this is a comment

[global]

[Camera1]

norm = PAL

input = Composite0

key = 1

[Camera2]

norm = PAL

input = Composite1

key = 2  

For the US replace PAL with NTSC.

6.4 Running xawtv application

LMLBT44 has 4 independent video capture engines, that are represented as 4 separate devices:

/dev/video0

/dev/video1

/dev/video2

/dev/video3

in order to connect to a certain device use this command line xawtv invocation (this is 2nd input, counting from card top):

xawtv -c /dev/video1

this brings the video application windows, right clicking on it brings congifucation menu, left clicking allows to select video input (such as Camera1 or Camera2 for the configuration in section 6.3 above). In order to use different capture device you need to restart xawtv with differenct -c option (i.e. xawtv -c /dev/video0)

7 ZoneMinder Video Surveillance software

Although it's an excellent package, installing it may be rather tricky. Therefore we're providing Ubuntu LiveCD with Zoneminder and LMLBT4x kernel patches for alarms/sensors inputs pre-installed. In order to use that ZM-LiveCD you need to make sure your computer boot sequence is set (in BIOS settings) to boot from the CD if it is inserted. After that, rebooting the system with ZM-LiveCD would bring you to the ZoneMinder control interface with all LMLBT44 or LMLBT4M channel(s) operational.

About this document ...

LMLBT4x Installation and User Manual

This document was generated using the LaTeX2HTML translator Version 2002-2-1 (1.71)

Copyright © 1993, 1994, 1995, 1996, Nikos Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.

The command line arguments were:
latex2html -no_subdir -split 0 -show_section_numbers LMLBT4x_manual.tex

The translation was initiated by Vassili Leonov on 2010-12-07


next_inactive up previous
Vassili Leonov 2010-12-07