Драйвер для камеры VEC-535 производства компании EVS (www.evs.ru)
------------------------------------------------

Драйвер позволяет использовать камеру VEC-535 в ОС Linux. Драйвер работает осуществляет работу
по интерфейсу video4linux. Этот интерфейс позволяет всем приложениям, которые предназначены для работы с видеокамерой, осуществлять захват через устройство /dev/video.

Камера поддерживает следующие разрешения:
864x600x30Гц
1280x960x4Гц
2136x1602x2Гц

Захват изображения возможен только в цветовом пространстве RGB24 (по 8бит на красный, зелёный и синий цвета)

Компиляция драйвер
------------------------------------------------
Для компиляции драйвера необходимо наличие компилятора gcc и заголовочных файлов ядра linux.
Компиляции происходит с помощью команды make, выполненной из директории с распакованными исходными текстами:
linux# make

Параметы драйвера
------------------------------------------------
Драйвер использует некоторые заранее предопределенные параметры для своей работы. Эти параметры могут быть переопределны при загрузке кода драйвера посредством опций в команде insmod. А именно:
	debug: 			уровень отладки (по умолчанию 0)
				0 - только критические сообщения
				1 - только основные сообщения и критические
				2 - все сообщения, кроме детальных
				3 - все 
	enhance:		использовать встроенные алгоритм увеличения 
				качества изображения(по умолчание не включен - 0)
				0 - не использовать
				1 - использовать (не рекомендуется)
	levelAE:		верхний уровень для АРУ/АРВН (по умолчанию 88)	
	levelAE:		верхний уровень для АРУ/АРВН (по умолчанию 88)
	gamma:		уровень гаммы (по умолчанию 2). Поддерживаемые 
				значения 0, 1, 2, 3
Пример: 
linux# sudo insmod levelAE=70 gamma=3 debug=0 ./vec535-driver.ko

Рекомендуется использовать стандартные настройки и загружать драйвер командой:
linux# sudo insmod ./vec535-driver.ko
 
Загрузка модуля
------------------------------------------------
Для загрузки модуля необходима поддержка видео устройств в ядре, а также поддержка интерфейса video4linux версии 1.0. Так как интерфейс video4linux 1 является устаревшим, то необходимо добавить в ядре поддержку режима совместимости (video4linux compatibility).

В ОС Linux Ubuntu 10.04 эта поддержка скомпилирована в виде модулей, которые можно загрузить командами:

linux# sudo modprobe v4l1_compat
linux# sudo modprobe videodev

Особенности работы некоторых программ с видеокамерой 
------------------------------------------------
Стандартные программы для работы с камерой в ОС Linux используют преимущественно 
интерфейс video4linux версии 2.0 и не всегда корректно поддерживают протокол первой версии

В процессе тестирования программного обеспечения выявились следующие особенности:
1) стандартное приложение Cheese не успевает вовремя выводит видеоряд с камеры на экран, 
что проявляется в возникновении мерцания и постоянной рассинхронизации видеопоследовательности. Рекомендуется использовать Cheese в режиме "Полного экрана", или отключить эффекты рабочего стола. Также Cheese использует ПРОГРАММНУЮ коррекцию цветов, что негативным образом сказывается на качестве изображении и производительности

2) плеер vlc (video-on-lan.org) умеет захватывать изображение с камеры, однако, в свойствах захвата
должен использоваться режим video4linux ver. 1.0 compatibiltity. Плеер поддерживает все режимы работы камеры, но по умолчанию производит захват только в единственном видео режиме (864x600x30Гц)

3) лучшей программой, как считает разработчик драйвера, является программа "camorama" (http://freshmeat.net/projects/camorama/), которая рекомендуется для осуществления видео захвата 

Аппаратная цветокоррекция
------------------------------------------------
Видеокамера VEC-535 позволяет задействовать аппаратную цветокоррекцию для улучшения
качества видеоизображения. Команды цветокоррекции передаются через интерфейс video4linux и позволяют на лету изменять следующие параметры:

1) насыщенность (contrast)
2) яркость (brightness)
3) цветосмещенность (hue)
4) баланс белого (whiteness)
5) цветность (colour)

Видеокамеры VEC-535 по умолчанию имеют автоматическую подстройку насыщенности, яркости и баланса белого, исходя из уровня текущей освещенности. Для включения режима "ручное управление"
необходимо выставить значение насыщенности, яркости и баланса белого в ненулевые значения.

Для возвращения в автоматический режим необходимо снова вернуть настройки в нулевое значение.

Производительность
------------------------------------------------
Камера сильно нагружает процессор и рекомендуются использовать компьютер не слабее Pentium4