130
•
Appendix B: Troubleshooting Installation Problems
Xtium-CL MX4 User's Manual
Teledyne DALSA Log Viewer
The third step in the verification process is to save in a text file the information collected by the
Log Viewer program. Run the program via the Windows Start Menu shortcut Start • Programs •
Teledyne DALSA • Sapera LT • Tools • Log Viewer.
The Log Viewer lists information about the installed Teledyne DALSA drivers. Click on File • Save
and you will be prompted for a text file name to save the Log Viewer contents. Email this text file
to Teledyne DALSA Technical Support when requested or as part of your initial contact email.
On-board Image Memory Requirements for Acquisitions
The Xtium-CL MX4 by default will allocate the maximum number of buffers that can fit in on-board
memory based on the size of the acquired image before cropping, to a maximum of 65535 buffers.
Note that an application can change the default number of on-board frame buffers using the
Sapera LT API. Usually two buffers will ensure that the acquired video frame is complete and not
corrupted in cases where the image transfer to host system memory may be interrupted and
delayed by other host system processes. That is, there is no interruption to the image acquisition
of one buffer by any delays in transfer of the other buffer (which contains the previously acquired
video frame) to system memory.
•
If allocation for the requested number of buffers fails, the driver will reduce the number of
on-board frame buffers requested until they can all fit.
•
If there is not enough memory for 2 on-board buffers, the driver will reduce the size such
that it allocates two partial buffers. This mode is dependent on reading out the image data
to the host computer faster than the incoming acquisition.
The maximum number of buffers that can fit in on-board memory can be calculated as follows:
𝑇𝑇𝑇𝑇𝑇𝑇𝑇𝑇𝑇𝑇
𝑂𝑂𝑂𝑂 − 𝐵𝐵𝑇𝑇𝑇𝑇𝐵𝐵𝐵𝐵
𝑚𝑚𝑚𝑚𝑚𝑚𝑇𝑇𝐵𝐵𝑚𝑚
𝐵𝐵𝐵𝐵𝐵𝐵𝐵𝐵𝑚𝑚𝐵𝐵
𝑆𝑆𝑆𝑆𝑆𝑆𝑚𝑚
𝑆𝑆𝑂𝑂
𝐵𝐵𝑚𝑚𝑇𝑇𝑚𝑚𝐵𝐵
+ 256
𝐵𝐵𝑚𝑚𝑇𝑇𝑚𝑚𝐵𝐵
𝐵𝐵𝐵𝐵𝑚𝑚𝐵𝐵
𝑇𝑇𝑇𝑇
𝐵𝐵𝑇𝑇𝑇𝑇𝐵𝐵𝑚𝑚
𝑇𝑇ℎ𝑚𝑚
𝐷𝐷𝐷𝐷𝐷𝐷
Dual Camera Input Configuration
When using the dual camera input configuration, the total on-board memory is divided evenly
between the 2 inputs.
For example, assuming 512MB of on-board memory and acquiring 1024 x 1024 x 8 bit images, the
number of on-board buffers would be:
512
𝐷𝐷𝐵𝐵
(1024
𝑥𝑥
1024) + 256
= 511.875
≥
511
𝑇𝑇𝑂𝑂 − 𝑏𝑏𝑇𝑇𝑇𝑇𝐵𝐵𝐵𝐵
𝑏𝑏𝐵𝐵𝐵𝐵𝐵𝐵𝑚𝑚𝐵𝐵𝐵𝐵
When running the board in the two Base Camera Link configuration, each input is assigned half of
the on-board memory. In the case where there are 512 MB of on-board memory, each input will be
assigned 256 MB.