Sensoray 2255 Manuel d'utilisateur

USB 4-Channel Video Capture DeviceModel 2255Hardware and Software ManualVer.1.0.8 | May 2014

COLOR_JPG – color JPEG-compressed image. Compression quality (1..100, 100 being highest quality, largest file size) is passed in bits 8..15 of the col

} FRAME;Each BUFFER can contain up to SYS_FRAMES (64) FRAME’s. Using multiple FRAME’s may be beneficial for preserving captured data in case of signif

Parametershdev A handle to the 2255 device.channelchannel number (1-4).modea pointer to MODE2255 structure containing the desired operation mode (see

frmnum frame number to dequeue (0 to SYS_FRAMES – 1).Returns0 on success.S2255_StartAcquire (HANDLE hdev, int channel, HANDLE *phevent);Starts capture

function after acquiring with S2255_StartAcquire. Please see demo code for usage. Obsoletes S225_GetFrame.Parametershdev A handle to the 2255 device

channel number (1-4).pStatusa pointer to the current video status value. Bit [0]: a value of 1 indicates video signal present. Bit [8]: 0 for 60Hz si

a handle to the 2255 device.channelchannel number (1-4).frmnumIndex of frame in question (starting from 0). Must be smaller than number of registered

array of at least *pCount devices. If querying the number of devices (*pCount = 0), pDevices may be NULL.ReturnstReturns 0 on success.S2255_GetFirmwa

S2255_fill_bmi_vbhelper(HDEVICE hdev, BITMAPINFO *pbmi, int chn, int frm);Helper function for VB or VB.NET demo. This function is only intended for V

Additionally, the V4L driver may not have all the features of the non-V4L driver. For instance, the non-V4L driver has frame decimation. The V4L API

TABLE OF CONTENTSLIMITED WARRANTY...3SPEC

Linux SDK ReferenceGeneral NotesCapture modeThe operating mode of each of the 2255’s capture channels is defined by the settings of the MODE2255struct

fdecFrame decimation setting. Must be one of the following: FDEC_1 – capture every frame, FDEC_2 – capture every second frame, FDEC_3 – capture every

2) fdec 2 2 (channel 2 frame rate ½)3) fdec 3 24) fdec 4 25) start 16) start 27) start 38) start 4Capture 4 simultaneous channels, 1CIFS, full frame

Demo Application explanationWhen the demo application opens, it tries to open all board instances(up to 8) in the system. It looks foreach board in o

a snapshot is triggered, the acquisition loop will save the image to file with the planar_to_rgb8 and save_image_uncompressed files. In the demo appl

f2255usb.h: DSP firmware. Driver startup (probe function in Linux)On driver startup, the driver creates a board handle in the core. This is done wit

S2255_DeviceClose(HANDLE hdev);Must be called before application terminates for proper clean-up of the SDK and SDK objects.Parametershdevthe handle va

0 on success.S2255_StartAcquire (HANDLE hdev, int channel, HANDLE *phevent);Starts capture on the specified channel of the 2255.Parametershdev A handl

Pointer to last framesizesize of last frame (if capturing JPEGs)Returns0 if frame ready. Non-zero otherwise.S2255_check_frame_poll_ts(HDEVICE hdev, i

Pointer to last framesizesize of last frame (if capturing JPEGs)Returns0 if frame ready. Non-zero otherwise.S2255_check_frame_block_ts(HDEVICE hdev,

Limited warrantySensoray Company, Incorporated (Sensoray) warrants the hardware to be free from defects in material and workmanship and perform to app

ReturnsReturns negative value on error, 0 if frame not ready, 1 if frame in progress(filling), or 2 if frame isready.S2255_query_buf_ext(HDEVICE hdev,

Copies the buffer specified to pdata. Use if mmap not used (double buffering).ParametershdevHandle to devicechannelChannel(1-4)frameindex of framepda

a pointer to the current video status value. Bit [0]: a value of 1 indicates video signal present. Bit [8]: 0 for 60Hz signal (usually NTSC,) 1 for 5

Revision historyVersion Notes1.0.8, May 2014 Typo corrected in scale description.1.0.7, June 2012 New Linux functions descriptions added.1.0.6, Januar

Special handling instructionsThe circuit board contains CMOS circuitry that is sensitive to Electrostatic Discharge (ESD). Special care should be take

IntroductionModel 2255 is a USB video capture device (frame grabber). It converts the signal from 4 analog video sources (NTSC or PAL) into a digital

Operation basicsEach channel of the 2255 behaves as a separate video capture device (frame grabber). It could be configured for a specific operating m

7

Windows SoftwareInstallationThe following versions of Windows are supported: 2000, XP, Vista/7 (32 and 64 bits).Two separate types of SDK are availabl

Windows SDK ReferenceGeneral NotesCapture modeThe operating mode of each of the 2255’s capture channels is defined by the settings of the MODE2255stru