Home
draft - baslerweb.com
Contents
1. lt la la La la la 4 H La la icta Figure 3 14 Bayer Filter Pattern on the A3TItc and A312fc When an A31lfc or A312fc is operating in a YUV color output mode each pixel goes through a two Step conversion process as it exits the sensor and passes through the camera s electronics In the first step of the process an interpolation algorithm is performed to get full RGB data for the pixel Because each individual pixel gathers information for only one color an interpolation must be made from the surrounding pixels to get full RGB data for an individual pixel The second step of the process is to convert the RGB information to YUV The conversion algorithm uses the following formulas Y 0 30R 0 59G 0 11B U 047HR 0 33G 0 50B V 0 50R 0 41G 0 09 B Once the conversion to YUV is complete pixels are transmitted from the camera in the YUV 4 2 2 format as defined in Sections 5 3 and 5 4 BASLER A310f 3 27 Basic Operation amp Standard Features The values for U and for V normally range from 128 to 127 Because the 1394
2. TrigRdy A4 ExTrig j gt 4 0 ps to 28 us A311f i 0 us to 28 us A311f 1 0 ps to 32 us A312f i Oysto32 ps A312f Exposure Exposure Exposure E Frame N Frame N 1 Frame N 2 xposure gt 5ps m i2 30ys gt Sus i lt gt 30us 20us 5i 100 ys lt 20us 5i s100us IntEn P Frame F hi Transfer Frame N Readout to the Image Buffer Frame N 1 Readout to the Image Buffer Transmission Start Delay Transmission Start Delay gt al FS cis Frame N Transmission to the PC Frame N 1 Transmission to the PC Figure 3 6 Exposure Start Controlled with an ExTrig Signal You can calculate the frame readout time with these formulas A311f Frame Readout Time 23 8 us x AOI Height 1836 us A311fc Frame Readout Time 23 8 us x AOI Height 1860 us A312f Frame Readout Time 28 27 us x AOI Height 2150 us A312fc Frame Readout Time 28 27 us x AOI Height 2178 us You can calculate the frame transmission time with this formula Frame Transmission Time Packets frame x 125 us To calculate the frame transmission time use the following information If the transmission time is greater than the readout time Transmission Start Delay 125 us If the transmission time is less than the readout time Transmission Start Delay Readout Time Transmiss
3. 00 ccc eae 3 35 3 9 2 Customizable Formats and Modes 0 000 e ee eee eens 3 36 3 10 Available Video Formats Modes amp Frame Rates on Color Cameras 3 37 3 10 1 Standard Formats Modes amp Frame Rates 000 eee aee 3 37 3 10 2 Customizable Formats and Modes 02 cee eee ees 3 38 3T ErrobFlags ic asit De bm Gelatin pain eel RR See Pug LP EE E e EUR 3 40 3 12 Configuration Sets and Memory Channels 20 0002 cece cence 3 41 3 12 1 Saving Configuration Sets llilliisiilil elles 3 41 3 12 2 Copying a Saved Configuration Set or the Factory Set into the Work Set 3 42 3 12 3 Designating a Startup Memory Channel llsllseslus 3 42 4 Configuring the Camera 4 1 Block Read and Write Capabilities liliis 4 2 4 2 Changing the Video Format Setting liliis 4 2 4 3 Configuration ROM ssssesselseee ere 4 2 4 4 Implemented Standard Registers lille 4 3 4 4 1ilnquiry Registers cs ede ee See ed B xy EE RR tg 4 3 4 4 1 1 Initialize Inquiry Register liliis 4 3 4 4 1 2 Inquiry Registers for Video Formats sullslsese 4 3 4 4 1 3 Inquiry Registers for Video Modes 00 eee eee eee 4 4 4 4 1 4 Inquiry Registers for Video Frame Rates suse 4 5 4 4 1 5 Inquiry Registers for Format 7 CSR Offsets 4 7 4 4 1 6 Inquiry Register for Basic Functions
4. 4 47 area of interest llle 3 22 B bayer filler retornier e n E 3 27 bitdepthiis use cede a a ees 3 31 block reads and writes 000 4 2 brightness vinee a ea 3 19 b fferingo sisri ewe Asa ea Ea 3 12 C cables maximum length ssuss 1 2 2 4 other requirements lusus 2 4 camera models 000 eee eee ee eee 1 3 camera power 2 000 00 05 2 4 cleaning the camera and sensor 1 6 color creation 20002 eee ee eee 3 27 color filter ID 00200 a ee eee 3 30 configuration sets 0 eee eee eee 3 41 connections general description 2 1 connector types saasaa eare 2 3 continuous shot operation with a shot command 3 4 with a software trigger 3 6 with an external trigger signal 3 11 CRC checksum smart feature 6 16 customized smart features 6 41 cycle time stamp smart feature 6 12 D data formats 0 eee eee eee 5 4 data structure 0 hi eee ees 5 14 DCAM values smart feature 6 13 dimensions 0200 cee eee ees 7 2 E environmental requirements 1 6 error flags ee coi d ve euk A ee E ER 3 40 exposure start controlling via the 1394 interface 3 3 controlling with a software trigger 3 5 controlling with an ExTrig signal
5. On A310f cameras exposure of a new image can begin while the previous image is being read out This is commonly referred to as overlap mode Following the recom mended method for exposure start in Section 3 2 6 will allow you to overlap exposure with readout and achieve the camera s maximum frame rate For more information about overlap mode see Section 3 2 8 BASLER A310f Basic Operation amp Standard Features 3 2 4 Controlling Exposure Start with a Software Trigger Exposure start can be controlled by sending a software trigger command to the camera via the 1394 bus The Trigger Mode control register see page 4 25 is used to enable the ability to start image exposure with a software trigger The Software Trigger control register see page 4 20 is used to set the software trigger If you are triggering the camera with a software trigger only the programmable exposure mode is available In programmable mode exposure starts when the Trigger field in the Software Trigger control register is set to 1 The length of the exposure is determined by the shutter settings described in Section 3 2 1 Note that the Trigger field in the Software Trigger control register will self clear to 0 when it is safe to begin each new exposure Figure 3 3 illustrates programmable exposure with a software trigger Software Trigger register self clears lt gt Exposure determined by shutter settings S
6. 6 When did the problem occur After start While running After a certain action e g a change of parameters 7 How often did does the prob Once Every time lem occur Regularly when Occasionally when 8 2 BASLER A310f Technical Support 8 How severe is the problem l Camera can still be used Camera can be used after take this action l Camera can no longer be used 9 Did your application ever run Yes r No without problems 10 Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred To make a copy of the parameters use the dump register tool available from the support sec tion of www baslerweb com the tool is available for XP PCs only the BCAM 1394 Driver must be installed Send the generated file to Basler technical support Or you can look up the settings with the BCAM Viewer by using View Camera Features and View Properties If you cannot access the camera please try to state the following parameter settings Video format Video mode Frame rate Gain Exposure time shutter Brightness If video format 7 is in use Color coding Bytes per packet AOI position Hoo in AOI size horizontal vertical 11 Live image test image If you are having an image problem try to gener
7. Field Bit Description Trigger 12 Indicates a trigger mode control error on the camera 0 no error present 1 A setting in the trigger mode control register see page 4 25 is outside of the allowed range This field is read only Trigger Delay 13 Not used on A310f cameras This bit should be ignored White Shading 14 Not used on A310f cameras This bit should be ignored Frame Rate 15 Not used on A310f cameras This bit should be ignored 16 31 Reserved Register Name Feature Control Error Status Low Offset from Base Address 0x644 Field Bit Description Zoom 0 Not used on A310f cameras This bit should be ignored Pan 1 Not used on A310f cameras This bit should be ignored Tilt 2 Not used on A310f cameras This bit should be ignored Optical Filter 3 Not used on A310f cameras This bit should be ignored 4 15 Reserved Capture Size 16 Not used on A310f cameras This bit should be ignored Capture Quality 17 Not used on A310f cameras This bit should be ignored 18 31 Reserved BASLER A310f 4 27 Configuring the Camera 4 4 2 4 Control and Status Registers for Format 7 Mode 0 Format 7 Mode 0 is available on all A310f cameras The base address for each Format 7 Mode 0 camera control register is Bus ID Node ID FFFF F1F0 0000 In each Format 7 Mode 0 register description an Offset from the Base Address is provided This is a
8. 20 008s 4 8 4 4 1 7 Inquiry Register for Feature Presence sss 4 9 4 4 1 8 Inquiry Registers for Feature Elements 45 4 12 4 4 2 Control and Status Registers liliis 4 16 4 4 2 1 Control and Status Registers for Basic Camera Operation 4 16 4 4 2 2 Control and Status Registers for Features 4 21 4 4 2 3 Error Status Registers for Feature Control 4 26 4 4 2 4 Control and Status Registers for Format 7 Mode 0 4 28 4 4 2 5 Control and Status Registers for Format 7 Mode 1 4 35 II BASLER A310f Contents 4 4 2 6 Control and Status Registers for the PIO Control Function 4 42 4 4 2 7 Control and Status Registers for the Strobe Signal Function 4 43 4 4 3 Advanced Features Registers llli eee 4 47 5 Image Data Structures and Formats 5 1 Imaje Data Basics c sepe a waka eee a la aie lie ee REDE RR 5 1 5 1 1 Pixel Transmission Sequence 000 0 cece eee 5 1 5 2 Packet Payload Charts for Standard Format Mode and Frame Rate Combinations on A310f Cameras 0 0 eens 5 3 5 2 1 Format 03 Mode T zu s Gata t oaredgas GA ed a a a wh dalew abd dus 5 3 5 2 2 Format 0 Mode 3 2 eee eens 5 3 5 2 0 Format Mode 5 seld da sO as eae angu eee ds a 5 3 5 2 4 Format 0 Mode 6 2 0 eee eens 5 3 5 3 Image Data Formats 000 cee tees 5 4 5 3 1 Data Format with the Camera Set fo
9. 6 39 SUPPONE ose Eea e ie A DU UU REM 8 1 T technical support ierosmi r aimantar ap a 8 1 temperature requirements 1 6 test image smart feature 6 19 trigger counter smart feature 6 32 trigger flag smart feature 6 32 trigger ready signal lessen 3 16 U user configuration sets 2 3 41 V ventilation requirements 04 1 6 video format changing the setting 4 2 video formats modes and frame rates customizable color cameras 3 38 customizable monochrome cameras 3 36 standard color cameras 3 37 standard monochrome cameras 3 35 video output formats lees 1 2 W Welglt zn SERE INED NE 1 2 white balance 0 000000 eee eee 3 29 work configuration set 2 5 3 41 Y YUV sec eh trie Ch De b edet td 3 27 BASLER A3l0f
10. When using software triggering overlapped exposure is not available As you can see running the camera with readout and exposure overlapped can allow higher frame rates because the camera is performing two processes at once Image Capture N Exposure Readout Image Capture N 1 Exposure Readout Image Capture N 2 Exposure Readout Image Capture N 3 Exposure Readout Time Figure 3 8 Overlapped Exposure BASLER A3l0f Basic Operation amp Standard Features Determining whether your camera will operate with overlapped or non overlapped exposures is not a matter of writing to a register or switching a setting on or off Rather the way that you operate the camera will determine whether the exposures are overlapped or not overlapped If we define the Frame Period as the time from the start of exposure for one image capture to the start of exposure for the next image capture then Exposure will overlap when Frame Period lt Exposure Time Readout Time Exposure will not overlap when Frame Period gt Exposure Time Readout Time You can calculate the readout time for a captured image by using the formula on page 3 13 Guidelines for Overlapped Operation If you will be operating the camera with overlapped exposures there are two very important guidelines to keep in mind You must not begin the exposure of a new frame while the exposure of the previous frame is
11. Register Name Current Memory Channel Offset from Base Address 0x624 Field Bit Description Current Channel 0 Writing a value to this field will cause the settings saved in the specified memory channel to be copied into the work configuration set see Sec tion 3 12 The valid values for writing to this register are 0 1 2 and 3 Reading the value from this register will indicate the last memory chan nel that was copied into the work configuration set 1 31 Reserved Register Name VMode Error Status Field Offset from Base Address Bit 0x628 Description Status 0 Used only when the camera is set for a standard format not Format 7 This field will be updated each time the video format mode frame rate or ISO speed setting is changed The value in this field indicates whether the current combination of video format mode frame rate and ISO speed settings is acceptable to the camera 0 the combination is OK image capture can be started 1 the combination is not OK image capture can not be started This field is read only Reserved BASLER A310f 4 19 Configuring the Camera 4 20 Register Name Software Trigger Offset from Base Address 0x62C Field Bit Description Trigger 0 When the Trigger Source field of the Trigger Mode register see page 4 25 is set for a software trigger this fie
12. 1 Byte ter to the current AOI See Section 3 5 2 and page 4 33 K M 24 Chunk GUID 94ED7C88 1COF 11D8 82E0 00105A5BAE55 16 Bytes K M 40 Chunk Length This chunk s total length in bytes 4 Bytes K M 44 Inverted Chunk Length The bitwise complement of the chunk length 4 Bytes 6 10 BASLER A3l0f Smart Features 6 7 2 Frame Counter The frame counter feature numbers images sequentially as they are captured The counter starts at 0 and wraps at 4294967296 operating continuously at 100 frames per second it would take the counter about 500 days to wrap The counter increments by one for each captured frame Whenever the camera is powered off the counter will reset to 0 Note that if the camera is in continuous shot mode and continuous capture is stopped up to two numbers in the counting sequence may be skipped This happens due to the internal image buffering scheme used in the camera The extended data stream feature see Section 6 7 1 must be enabled in order to use the frame counter feature or any of the other smart feature that adds information to the image data stream Disabling the extended data stream feature switches off all smart features that add information to the image data stream The frame counter feature will only work when the camera is set for video format 7 Control and Status Register for the Frame Counter Feature Name Frame Counter Address See
13. 320 x 240 YUV 4 2 2 16 bits pixel avg 3 75 fps 320 x 240 YUV 4 2 2 16 bits pixel avg 7 5 fps 320 x 240 YUV 4 2 2 16 bits pixel avg 15 fps 320 x 240 YUV 4 2 2 16 bits pixel avg 30 fps 320 x 240 YUV 4 2 2 16 bits pixel avg 60 fps 640 x 480 YUV 4 2 2 16 bits pixel avg 1 875 fps 640 x 480 YUV 4 2 2 16 bits pixel avg 3 75 fps 640 x 480 YUV 4 2 2 16 bits pixel avg 7 5 fps 640 x 480 YUV 4 2 2 16 bits pixel avg 15 fps 640 x 480 YUV 4 2 2 16 bits pixel avg 30 fps 640 x 480 Y Mono 8 bits pixel 1 875 fps 640 x 480 Y Mono 8 bits pixel 3 75 fps 640 x 480 Y Mono 8 bits pixel 7 5 fps 640 x 480 Y Mono 8 bits pixel 15 fps 640 x 480 Y Mono 8 bits pixel 30 fps 640 x 480 Y Mono 8 bits pixel 60 fps 640 x 480 Y Mono 16 bits pixel 1 875 fps 640 x 480 Y Mono 16 bits pixel 3 75 fps 640 x 480 Y Mono 16 bits pixel 7 5 fps 640 x 480 Y Mono 16 bits pixel 15 fps 640 x 480 Y Mono 16 bits pixel 30 fps D Since there are no standard formats that provide raw data output from color cameras the Mono 8 and Mono 16 modes of operation are included on A3llfc A312fc Mono 8 and Mono 16 output is normally associated with monochrome cameras When one of these modes is used on an A3llfe or an A312fc color camera the camera outputs the raw data for each pixel The pixel data is not processed to account for the color fi
14. Even Lines Odd Lines Byte Data Byte Data Bo Low byte of red value for Pg Bg Low byte of green value for Po B High byte of red value for Pg B4 High byte of green value for Po Bo Low byte of green value for P4 Bo Low byte of blue value for P4 B3 High byte of green value for P4 B3 High byte of blue value for P4 B4 Low byte of red value for Po B4 Low byte of green value for Po Bs High byte of red value for Po B5 High byte of green value for Po Be Low byte of green value for P3 Be Low byte of blue value for P5 B7 High byte of green value for P3 B7 High byte of blue value for P3 e e e e e e e e e e e e Bm 7 Low byte of red value for Ph 3 Bm 7 Low byte of green value for Ph 3 Bm 6 High byte of red value for Ph 3 Bm 6 High byte of green value for Ph 3 Bm 5 Low byte of green value for Pp Bm 5 Low byte of blue value for Ph 2 Bm 4 High byte of green value for Ph 2 Bm 4 High byte of blue value for Pu Bm 3 Low byte of red value for Ph 14 Bm 3 Low byte of green value for Ph 1 Bm 2 High byte of red value for P4 Bm 2 High byte of green value for Py Bm 1 Low byte of green value for P Bm 1 Low byte of blue value for Ph Bm High byte of green value for Ph Bm High byte of blue value for Ph BASLER A3l0f For Filter ID 1 GB RG Image Data Structures amp Formats Even Lines Odd Lines Byte Data Byte Data Bo Low byte of green value for
15. Offset from Base Address 0x640 Field Bit Description Brightness 0 Indicates a brightness control error on the camera 0 no error present 1 Asetting in the brightness control register see page 4 21 is out side of the allowed range This field is read only Auto Exposure 1 Not used on A310f cameras This bit should be ignored Sharpness 2 Not used on A310f cameras This bit should be ignored White Balance 3 Indicates a white balance control error on an A311fc or A312fc 0 no error present 1 A setting in the white balance control register see page 4 22 is outside of the allowed range This field is read only Hue 4 Not used on A310f cameras This bit should be ignored Saturation 5 Not used on A310f cameras This bit should be ignored Gamma 6 Not used on A310f cameras This bit should be ignored Shutter 7 Indicates a shutter control error on the camera 0 no error present 1 A setting in the shutter control register see page 4 23 is outside of the allowed range This field is read only Gain 8 Indicates a gain control error on the camera 0 no error present 1 A setting in the gain control register see page 4 24 is outside of the allowed range This field is read only Iris 9 Not used on A310f cameras This bit should be ignored Focus 10 Not used on A310f cameras This bit should be ignored Temperature 11 Not used on A310f cameras This bit should be ignored BASLER A310f Configuring the Camera
16. data such as image height and width Chunk Chunk sum Figure 6 2 Data Used for the Checksum Calculation The extended data stream feature see Section 6 7 1 must be enabled in order to use the CRC Checksum feature or any of the other smart feature that adds informa tion to the image data stream Disabling the extended data stream feature switches off all smart features that add information to the image data stream The CRC Checksum feature will only work when the camera is set for video format 7 The data transmission method used on A310f cameras is extremely reliable The CRC Checksum feature is included on the camera because CRC checksums are so com monly used with data transmission applications Control and Status Register for the CRC Checksum Feature Name CRC Checksum Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 3B34004E 1B84 11D8 83B3 00105A5BAE55 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable Disable this feature Read write 0 Disable 1 Enable 6 16 BASLER A310f Smart Features CRC Checksum Chunk Layout The CRC checksum is an exception to the normal chunk structure The CRC chunk is always 32 bits wide and is always the last chunk appended to the image data The lower 16 bits of the chunk are fille
17. Input Port 1 E eo Input Port 3 Table 2 2 Pin Assignments for the RJ 45 Jack 2 2 BASLER A310f Camera Interface pa e 2 4 6 l xlii DU I i y 1 3 5 0 Figure 2 2 A310f Pin Numbering The camera housing is connected to the cable shields and coupled to signal ground through an RC network see Figure 2 3 for more details 2 1 3 Connector Types The 6 pin connector on the camera is a standard IEEE 1394 socket The 10 pin connector on the camera is an RJ 45 jack Caution The plug on the cable that you attach to the camera s RJ 45 jack must have 10 pins Use of a smaller plug such as one with 8 pins or 4 pins can damage the pins in the RJ 45 jack on the camera BASLER A310f 2 3 Camera Interface 2 2 Cables The maximum length of the IEEE 1394 cable used between the camera and the adapter in your PC or between the camera and a 1394 hub is 4 5 meters as specified in the IEEE 1394 standard Standard shielded IEEE 1394 cables must be used The maximum length of the I O cable is at least 10 meters The cable must be shielded and must be constructed with twisted pair wire Close proximity to strong magnetic fields should be avoided 2 3 Camera Power Power must be supplied to the camera via the IEEE 1394 cable Nominal input voltage is 12 0 VDC however the camera will operate prop
18. continuous shot transmission Default 0 on all A310f cameras 1 31 Reserved Register Name Memory Save Offset from Base Address 0x618 Field Bit Description Save 0 Writing a 1 to this field will cause the current settings in the work con figuration set see Section 3 12 to be saved to the memory channel specified in the Memory Save Channel register see page 4 19 This register self clears 1 81 Reserved Register Name One Shot Multi Shot Offset from Base Address 0x61C Field Bit Description One Shot 0 When the camera is set for video Format 0 or Format 7 this field con trols the one shot video transmission mode 1 transmit one frame of video data Field is self cleared after transmission Default 2 0 on all A310f cameras Multi Shot 1 Multi shot is not supported on A310f cameras 2 15 Reserved Count Number 16 31 The count number for multi shot is not supported on A310f cameras 4 18 BASLER A3l0f Configuring the Camera Register Name Memory Save Channel Offset from Base Address 0x620 Field Bit Description Save Channel 0 When a 1 is written to the Memory Save register see page 4 18 the current settings in the work configuration set see Section 3 12 will be saved to the memory channel specified in this register The valid values for this register are 1 2 and 3 1 31 Reserved
19. 31 If bit n is set then value n is valid for use in the Read only Source Select field For example if bit O is set then 0 is a valid value for use in the Source Select field If bit 1 is set then 1 is a valid value for use in the Source Select field Etc 8 pbp 0 30 Reserved Monitor 31 Shows the current state of the output Read only 0 Low non conducting 1 High conducting 12 0 30 Reserved Invert 31 Enables signal inversion Read write 0 Do not invert 1 Invert 16 0 30 Reserved User Setting 31 If the Source Select field is set to user set this field Read write sets the state of the output 0 Low non conducting 1 High conducting Sets the state of the output before the inverter 20 l 0 31 Reserved 6 34 BASLER A310f Smart Features Name Output Port 1 Configuration Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 949D820A 4513 11D8 9EB1 00105A5BAE55 Position Field Bit Description 0 Same as port 0 4 Same as port 0 8 Same as port 0 12 Same as port 0 16 Same as port 0 20 Same as port 0 Name Output Port 2 Configuration Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID C14E5072 4513 11D8 81F3 00105A5BAE55 Positi
20. Offset from Base Address 0x038 Field Bit Description Bytes Per Frame 0 81 Indicates the higher quadlet of the total bytes of image data per frame The value in this register depends on settings in the Format 7 Mode 0 Image Size and Color Coding ID registers see page 4 29 The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Total Bytes Low Inquiry Low Offset from Base Address 0x03C Field Bit Description Bytes Per Frame 0 81 Indicates the lower quadlet of the total bytes of image data per frame The value in this register depends on settings in the Format 7 Mode 0 Image Size and Color Coding ID registers see page 4 29 The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Packet Para Inquiry Packet Offset from Base Address 0x040 Field Bit Description Unit Bytes Per 0 15 Indicates the increment for setting the Bytes Per Packet field of the Packet Bytes Per Packet register see page 4 32 4 the increment for setting the bytes per packet on A310f cameras Max Bytes Per 16 31 Indicates the maximum bytes per packet 4096 the maximum bytes per packet for A310f cameras BASLER A310f 4 31 Configuring the Camera 4 32 Register Name Bytes Per Packet Field
21. A310f Monochrome Camera Spectral Response D The spectral response curve excludes lens characteristics and light source characteristics BASLER A310f Introduction The spectral response for A310f color cameras is shown in Figure 1 3 1 0 0 8 e D eo T Relative Response 0 2 450 500 550 600 650 700 Wave Length nm Figure 1 3 A310f Color Camera Spectral Response D The spectral response curves exclude lens characteristics light source characteristics and IR cut off filter characteristics To obtain the best performance from A3l0fe color cameras use of a dielectric IR cut off filter is recommended The filter should transmit in a range of 400 nm to 700 720 nm and it should cut off from 700 720 nm to 1100 nm A suitable filter is included in the standard C mount adapter on A310fc cameras BASLER A310f Introduction 1 5 1 6 1 6 Environmental Requirements 1 5 1 Temperature and Humidity Housing temperature during operation 0 50 C 32 F 122 F Humidity during operation 20 80 relative non condensing Storage temperature 20 C 80 4 F 176 F Storage humidity 5 96 95 96 relative non condensing 1 5 2 Ventilation Allow sufficient air circulation around the camera to prevent internal heat build up in your system and to keep the housing temperature below 50 C Additional coolin
22. Available Image Inq 6 13 Presence of test image 6 Read only 0 Not Available 1 Available Image Inq 7 14 Presence of test image 7 Read only 0 Not Available 1 Available 15 Reserved Image On 16 18 0 No test image active Read write 1 Test image 1 active 2 Test image 2 active 3 Test image 3 active 19 31 Reserved BASLER A310f Smart Features 6 7 7 Extended Version Information A310f cameras include a register that contains version numbers for the camera s internal software For troubleshooting purposes Basler technical support may ask you to read this register and to supply the results The extended version information smart feature does not add information to the im age data stream and can be accessed even when the extended data stream feature see Section 6 7 1 is disabled The extended version feature will work when the camera is set for any valid video for mat Control and Status Register for the Extended Version Information Feature Name Extended Version Information Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 2B2D8714 C15E 4176 A235 6EF843D747B4 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 7 Reserved Length 8 15 Specifies the length in quadlets of the string field nonce 16 31 Reser
23. Disable this feature Read write 0 Disable 1 Enable 4 Increment 0 31 Increment in seconds by which the time base field Read only can be adjusted The value in the increment field is a standard IEEE 754 single precision 32 bit floating point number 8 Min 0 31 Minimum value in seconds for the time base field Read only The value in the min field is a standard IEEE 754 single precision 32 bit floating point number 12 Min 0 31 Maximum value in seconds for the time base field Read only The value in the max field is a standard IEEE 754 single precision 32 bit floating point number 16 Time Base 0 31 Sets the shutter time base in seconds Read write The time base can range from 0 000015 second to 0 001221 second in increments of 0 000001 sec ond The value in the time base field is a standard IEEE 754 single precision 32 bit floating point number Default 0 000020 second BASLER A3l0f Smart Features 6 7 14 Strobe Time Base The strobe time base smart feature can be used to change the delay time base and the duration time base for the strobe control feature see Section 3 7 Changing the Strobe Delay Time Base As described in Section 3 7 the delay for any one of the strobe signals is determined by a combination of two values The first is the setting in the Delay Value field of the corresponding Strobe Control register see page 4 43 The second is the Strobe
24. Mode 1 BASLER A3IOf 4 7 Configuring the Camera 4 4 1 6 Inquiry Register for Basic Functions Each bit in the basic function inquiry register indicates the availability of a specific basic function 0 function not available 1 function available The memory channel bits are an exception Refer to the description below Register Name Basic Function Inquiry available If these bits are set to 0 the camera does not support memory channels Offset from Base Address 0x400 Field Bit Description A311f A311fc A312f A312fc Value Advanced Feature 0 Advanced vendor unique features 1 Inq availability Vmode Error 1 VMode Error Status register availability 1 Status Inq Feature Control 2 Feature Control Error Status register availability 1 Error Status Register Inq Optional Function 3 Optional Function Control and Status register 1 CSR Inq availability 4 7 Reserved ges 1394 b Mode 8 IEEE 1394b capability 0 Capability 9 15 Reserved ses Camera Power Ctrl 16 Power on off capability 0 17 18 Reserved pet One Shot Inq 19 One Shot image capture mode availability 1 Multi Shot Inq 20 Multi Shot image capture mode availability 0 21 27 Reserved sa Memory Channels 28 31 Indicates the maximum memory channel number 3 BASLER A3l0f Configuring the Camera 4 4 1 7 Inquiry Register for Feature Presence E
25. Mono 16 12 bits pixel ID 9 Raw 8 8 bits pixel ID 10 Raw 16 12 bits pixel 8 31 Reserved Register Name Color Filter ID Offset from Base Address 0x058 Field Bit Description Filter ID 0 7 Indicates the alignment of the camera s color filter to the current AOI This field is valid for cameras equipped with an RGB primary color filter such as the A311fc or A312fc See Sections 3 4 and 3 5 2 Value in this field Pixel color order 0 RG GB 1 GB RG 2 GR GB 3 BG GR 8 31 Reserved BASLER A310f 4 33 Configuring the Camera 4 34 Register Name Value Setting Offset from Base Address 0x07C Field Bit Description Presence Inq 0 Indicates whether the fields in this register are valid 0 not valid 1 valid The fields in this register are valid on all A310f cameras The Presence Inq field is read only Setting 1 1 On A310f cameras this field is not relevant and should be ignored Updates to the register values monitored by this field are performed automatically 2 7 Reserved Error Flag 1 8 Indicates whether the combination of the values in the ISO Speed reg ister and the Format 7 Mode 0 Image Position Image Size and Color Coding ID registers is acceptable 0 acceptable 1 not acceptable and no image capture can be started Error Flag 2 9 Indicates whether the value in the Bytes per Packet register is accept able 0 acceptable 1 not accepta
26. Strobe 0 Duration Strobe 0 Duration Value Setting x Strobe Duration Time Base The strobe duration time base is fixed at 1 1024 ms by default and the strobe duration is normally adjusted by changing the setting in the Duration Value field of the corresponding Strobe Control register However if you require a duration that is longer than what you can achieve by changing the strobe duration value alone the Strobe Time Base CSR can be used to change the strobe duration time base To change the strobe duration time base Set the Duration Time Base field in the Strobe Time Base CSR to your desired time base value BASLER A310f 6 39 Smart Features Example Assume that you have set the Duration Value field of the Strobe O control register to 423 Also assume that you have set the Duration Time Base field in the Strobe Time Base CSR to 5 In this case Strobe 0 Duration Strobe 0 Duration Value Setting x Strobe Duration Time Base Strobe 0 Duration 423 x 5 1024 ms Strobe 0 Duration 2 07 ms D There is only one setting for the strobe delay time base and this single setting is used by all four of the available strobe outputs There is only one setting for the strobe duration time base and this single setting is used by all four of the available strobe outputs The strobe time base smart feature does not add information to the image data stream and can be accessed even when the extended data stream feature
27. in progress You must not end the exposure of a new frame until readout of the previous frame is com plete If either of these guidelines is violated the camera will produce unacceptable images or may stop capturing images and require a reset When you are operating the camera with overlapped exposures you could use the camera s shutter settings and the timing numbers shown in Section 3 2 7 to calculate when it is safe to begin and end each exposure However there is a much more convenient way to know when it safe to begin and end overlapped exposures A310f cameras supply a Trigger Ready signal that is specifically designed to let you perform overlapped exposures safely and efficiently For more information on using the Trigger Ready signal see Section 3 2 9 You can find information and guidelines for using ExTrig signals with level controlled mode for overlapped exposure in the Application Notes Using a Specific External Trigger Signal with Overlapped Exposure AW000565xx000 You can download the Application Notes free of charge from the Basler website at www baslerweb com BASLER A310f 3 15 Basic Operation amp Standard Features 3 16 3 2 9 Trigger Ready Signal The trigger ready signal is not defined in the 1894 Trade Association Digital Camera Specification Trigger ready is a patented feature of Basler cameras that allows our cameras to have optimized timings The trigger ready signal will only be present if th
28. see page 4 36 and on the setting of the Bytes per Packet register see above The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Unit Position Inquiry Offset from Base Address 0x04C Field Bit Description Hposunit 0 15 Indicates the increment in columns for adjusting the area of interest starting column see Section 3 4 For example if the Hposunit is 2 the starting column should be adjusted in increments of 2 Hposunit 2 Vposunit 16 31 Indicates the increment in rows for adjusting the area of interest start ing row see Section 3 4 For example if the Vposunit is 1 the starting row should be adjusted in increments of 1 Vposunit 2 BASLER A310f 4 39 Configuring the Camera Register Name Frame Interval Inquiry Offset from Base Address 0x050 Field Bit Description Frame Interval 0 81 Indicates the current frame period in seconds This value will be up dated when you adjust any register that affects the frame period The value in this register is a standard IEEE 754 single precision 32 bit floating point number Register Name Data Depth Inquiry Offset from Base Address 0x054 Field Bit Description Data Depth 0 7 Indicates the effective depth of the data in the transmitted images The value in t
29. 12 bit depth 3 6 1 A311f and A312f Monochrome Cameras Set the value in the Format field of the Current Video Format register see page 4 17 and the value in the Mode Field of the Current Video Mode register see page 4 16 so that the camera will operate in Format 7 Mode 0 For 8 Bit Depth Set the value in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 to Mono 8 see Section 3 10 2 and page 4 33 With this ID set the camera outputs 8 bits per pixel For 12 Bit Depth Set the value in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 to Mono 16 With this ID set the camera outputs 16 bits per pixel but only 12 bits are effective The effective pixel data fills from the LSB and the unused bits are filled with zeros Pixel data is stored in the PC memory in little endian format i e the low byte for each pixel is stored at the lower address and the high byte is stored at the neighboring higher address 3 6 2 A311fc and A312fc Color Cameras Set the value in the Format field of the Current Video Format register see page 4 17 and the value in the Mode Field of the Current Video Mode register see page 4 16 so that the camera will operate in Format 7 Mode 0 For 8 Bit Depth Set the value in the Coding ID field of the Color Coding ID Register for Format 7 Mode O0 to either Mono 8 or Raw 8 see Section 3 10 2 and page 4 33 With either of these IDs set the camera outputs 8 bits per
30. 3 8 controlling with shot commands 3 4 recommended method for controlling 3 12 exposure time setting 006 3 3 extended data stream smart feature 6 9 extended version info smart feature 6 25 BASLER A310f Index external trigger signal continuous shot operation 3 11 controlling exposure with 3 8 min high low time llle 3 8 one shot operation lesse 3 10 F factory configuration set 3 41 firmware ID number 5 1 1 frame buffering llle 3 12 frame counter smart feature 6 11 frame rate basic specification llus 1 2 changes with AOI 0 005 3 25 standard frame rates 00 3 35 functional description 04 3 1 G galli ities REIN m xe WE 3 19 H housing sIZO cnra ee ae nea Meee Sena 1 2 humidity requirements lesse 1 6 l IEEE 1394 Device Information 2 4 image data formats lees 5 4 image data structure 2 4 5 14 input circuit samples 0000 0 2 7 INDUL POMS ss oe ces ae pokey D RARE REM a 2 5 input output control 2 0 eee 3 34 integrate enabled signal 3 18 IPSO niche eh yeso beh Ba teal ES 1 2 7 2 IRicutfilter oue RE 7 4 L lens adapters 000s 1 2 lens thread length 0 2 eee e
31. 31 Maximum value for brightness 255 Register Name White Balance Inquiry Offset from Base Address 0x50C Field Bit Description A311f A311fc A312 A312fc Value Value Presence Inq 0 White balance feature is present 0 1 Abs Control Inq 1 White balance can be set with an absolute 0 0 value 2 Reserved One Push Inq 3 One push auto mode is present 0 0 Read Out Inq 4 The white balance value can be read 0 1 On Off Inq 5 White balance can be switched on off 0 0 Auto Inq 6 A white balance auto control mode is present 0 0 Manual Inq 7 The white balance value can be set manually 0 1 Min Value 8 19 Minimum value for white balance ses 16 Max Value 20 31 Maximum value for balance 255 BASLER A310f Configuring the Camera Register Name Shutter Inquiry Offset from Base Address 0x51C Field Bit Description A311f A311fc A312f A312fc Value Presence Inq 0 Shutter control feature is present 1 Abs Control Inq 1 Shutter can be set with an absolute value 0 2 Reserved One Push Inq 3 One push auto mode is present 0 Read Out Inq 4 The shutter value can be read 1 On Off Inq 5 Shutter control can be switched on off 0 Auto Inq 6 A shutter auto control mode is present 0 Manual Inq 7 The shutter value can be set manually 1 Min Value 8 19 Minimum value for shutter 1 Max Value 20 31 Maximum value for shutter In Format
32. 5 3 3 Data Format with the Camera Set for Y Mono 16 Output The table below describes how the data for a received frame will be ordered in the image buffer in your PC The following standards are used in the table Po the first pixel transmitted by the camera P the last pixel transmitted by the camera Bg the first byte in the buffer Bm the last byte in the buffer Byte Data Bo Low byte of Y value for Pg B High byte of Y value for Po Bo Low byte of Y value for P B3 High byte of Y value for P4 B4 Low byte of Y value for Ps Bs High byte of Y value for P3 Bg Low byte of Y value for P5 B High byte of Y value for P4 Bg Low byte of Y value for P4 Bg High byte of Y value for P4 Bio Low byte of Y value for Ps B44 High byte of Y value for P5 e e e e e e Bm 7 Low byte of Y value for Ph 3 Bm 6 High byte of Y value for Ph 3 Bm 5 Low byte of Y value for P Bm 4 High byte of Y value for P Bm 3 Low byte of Y value for Ph 14 Bm 2 High byte of Y value for P 4 Bm 1 Low byte of Y value for Ph Bm High byte of Y value for Ph As shown in the table above when the camera is set for 16 bit output data is placed in the image buffer in little endian format The DCAM standard specifies big endian format for 16 bit output but we do not follow this recommendation We use little en dian format so that 16 bit data can be processed more ef
33. Base Address 0x180 Field Bit Description A311f A311fc A312f A312fc Value Mode 0 0 160 x 120 YUV 4 44 24 bits pixel 0 Mode 1 1 320 x 240 YUV 4 2 2 16 bits pixel 1 Mode 2 2 640 x 480 YUV 4 1 1 12 bits pixel 0 Mode 3 3 640 x 480 YUV 4 222 16 bits pixel 1 Mode 4 4 640 x 480 RGB 24 bits pixel 0 Mode 5 5 640 x 480 Y Mono 8 bits pixel 1 Mode 6 6 640 x 480 Y Mono 16 bits pixel 1 Mode x 7 Reserved for another mode 8 31 Reserved T Register Name Video Mode Inquiry for Format 7 Offset from Base Address 0x19C A312 A312fc Value Value Mode 0 0 Format 7 Mode 0 1 1 Mode 1 1 Format 7 Mode 1 0 1 Mode 2 2 Format 7 Mode 2 0 0 Mode 3 3 Format 7 Mode 3 0 0 Mode 4 4 Format 7 Mode 4 0 0 Mode 5 5 Format 7 Mode 5 0 0 Mode 6 6 Format 7 Mode 6 0 0 Mode 7 7 Format 7 Mode 7 0 0 8 81 Reserved 4 4 BASLER A310f Configuring the Camera 4 4 1 4 Inquiry Registers for Video Frame Rates Each bit in the video frame rates inquiry register indicates the availability of a specific video format mode frame rate combination e g Format 0 Mode 0 Frame Rate 0 0 format not available 1 format available Register Name Video Frame Rate Inquiry for Format 0 Mode 1 Offset from Base Address 0x204 Field Bit Description A311f A311fc A312 A312fc Value Frame Rate 0 0 1 875 fps standard frame rate 1 F
34. Cycle Time Stamp Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 5590D58E 1B84 11D8 8447 00105A5BAE55 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable Disable this feature Read write 0 Disable 1 Enable Cycle Time Stamp Chunk Layout Position Name Description 0 Cycle Time Stamp Field Bit Description 4B Lt Bytes Second Count 0 6 Counts the seconds Wraps to zero after 127 seconds Cycle Count 7 19 Counts the 125 us isochronous bus cycles Wraps to zero after counting to 7999 Cycle Offset 20 31 Counts at 24 576 MHz and wraps to zero after counting to 3071 re sulting in a 125 us cycle 4 Chunk GUID 994DD430 1COF 11D8 8F6B 00105A5BAE55 16 Bytes 20 Chunk Length This chunk s total length in bytes 4 Bytes 24 Inverted Chunk Length The bitwise complement of the chunk length 4 Bytes 6 12 BASLER A310f Smart Features 6 7 4 DCAM Values The DCAM values feature adds a chunk to each image frame containing the current settings for some standard DCAM features The settings are sampled at the start of exposure of each image The extended data stream feature see Section 6 7 1 must be enabled in order to use the DCAM values feature or any of the other smart feature that add
35. Delay Time Base For example the Strobe 0 delay will be determined by the product of these two parameters Strobe 0 Delay Strobe 0 Delay Value Setting x Strobe Delay Time Base The strobe delay time base is fixed at 1 1024 ms by default and the strobe delay time is normally adjusted by changing the setting in the Delay Value field of the corresponding Strobe Control register However if you require a delay that is longer than what you can achieve by changing the strobe delay value alone the Strobe Time Base CSR can be used to change the strobe delay time base To change the strobe delay time base Set the Delay Time Base field in the Strobe Time Base CSR to your desired time base value Example Assume that you have set the Delay Value field of the Strobe 0 control register to 186 Also assume that you have set the Delay Time Base field in the Strobe Time Base CSR to 14 In this case Strobe 0 Delay Strobe 0 Delay Value Setting x Strobe Delay Time Base Strobe 0 Delay 186 x 14 1024 ms Strobe 0 Delay 2 54 ms Changing the Strobe Duration Time Base As described in Section 3 7 the duration for any one of the strobe signals is determined by a combination of two values The first is the setting in the Duration Value field of the corresponding Strobe Control register see page 4 43 The second is the Strobe Duration Time Base For example the Strobe 0 duration will be determined by the product of these two parameters
36. Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable Disable this feature Read write 0 Disable 1 Enable Extended Data Chunk Layout Position Name Description 0 Pixel Data The pixel data from the captured image K Bytes K Gap For technical reasons there might be a gap between the M Bytes pixel data and the other data in the extended image data BASLER A310f 6 9 Smart Features K M Stride Signed integer Indicates the number of bytes needed to 4 Bytes advance from the beginning of one row in an image to the beginning of the next row K M 4 Reserved 3 Bytes K M 7 Data Depth Effective data depth in bits of the pixels in the image 1 Byte K M 8 Top Y coordinate of the top left corner of the current area of in 2 Bytes terest AOI K M 10 Left X coordinate of the top left corner of the current AOI 2 Bytes K M 12 Height Height in pixels of the current AOI 2 Bytes K M 14 Width Width in pixels of the current AOI 2 Bytes K M 16 Reserved 3 Bytes K M 19 Color Coding ID Color Coding ID that describes the pixel data format See 1 Byte Sections 3 9 2 and 3 10 2 and pages 4 29 and 4 30 K M 20 Reserved 3 Bytes K M 23 Color Filter ID For color cameras describes the orientation of the color fil
37. Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 4433C4A4 1B84 11D8 86B2 00105A5BAE55 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable Disable this feature Read write 0 Disable 1 Enable Frame Counter Chunk Layout Position Name Description 0 Counter The frame counter 4 Bytes 4 Chunk GUID 8C5DB844 1COF 11D8 965F 00105A5BAE55 16 Bytes 20 Chunk Length This chunk s total length in bytes 4 bytes 24 Inverted Chunk Length The bitwise complement of the chunk length 4 bytes BASLER A310f 6 11 Smart Features 6 7 3 Cycle Time Stamp The cycle time stamp feature adds a chunk to each image frame containing the value of the counters for the IEEE 1394 bus cycle timer The counters are sampled at the start of exposure of each image The extended data stream feature see Section 6 7 1 must be enabled in order to use the cycle time stamp feature or any of the other smart feature that adds informa tion to the image data stream Disabling the extended data stream feature switches off all smart features that add information to the image data stream The cycle time stamp feature will only work when the camera is set for video format 7 Control and Status Register for the Cycle Time Stamp Feature Name
38. Dig ital Camera specification requires that U values and V values be transmitted with un signed integers 128 is added to each U value and to each V value before the values are transmitted from the camera This process allows the values to be transmitted on a scale that ranges from 0 to 255 see Section 5 4 2 When an Adllfc or A312fc is operating in a YUV 4 2 2 mode the average number of bits per pixel is 16 This means that the camera will require twice the bandwidth of a camera operating in an 8 bit monochrome mode The A3IItc or A312fc can operate in several YUV 4 2 2 color modes as well as sev eral monochrome 8 bit modes see Section 3 9 3 28 BASLER A3l0f Basic Operation amp Standard Features 3 5 1 White Balance White balance capability has been implemented on the A3llfe and A312tc cameras With white balancing correction factors are applied to the interpolated RGB values for each pixel The correction factors can be used to adjust the color balance of the images transmitted from the camera The white balancing scheme outlined in the IIDC specification dictates that blue and red are adjustable and that green is not On A3llfe and A312fe cameras green has a fixed value of 96 0x60 which corresponds to a correction factor of 1 5 You can effectively raise the relative amount of green by lowering the correction factor for blue and red below 1 5 You can effectively lower the relative amount of green by raising
39. Enable Disable this feature Read write 0 Disable 1 Enable 4 In Depth Inq 0 15 Bit depth of the pixel data reported by the Read only sensor Out Depth Inq 16 31 Bit depth of the pixel data transmitted from Read only the camera 8 Quadlet 0 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 0 The 8 LSBs of the quadlet carry the data for the field The 24 MSBs are all zeros 12 36 Quadlet 1 7 7 Quadlets Not used The values written in these qua Read write dlets will be ignored 40 Quadlet 8 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 8 44 68 Quadlet 9 15 7 Quadlets Not used The values written in these qua Read write dlets will be ignored 72 Quadlet 16 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 16 76 100 Quadlet 17 23 7 Quadlets Not used The values written in these qua Read write dlets will be ignored 104 Quadlet 24 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 16 e e e e e e e e e e e e 16296 Quadlet 4072 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera
40. Fixed Diagonal Gray Gradient in Mono 8 As shown in Figure 6 3 test image one consists of rows with several gray scale gradients ranging from 0 to 255 Assuming that the camera is operating at full 656 x 491 resolution and is set for a monochrome 8 bit output mode when the test images are generated row O starts with a gray value of 0 for the first pixel row 1 starts with a gray value of 1 for the first pixel row 2 starts with a gray value of 2 for the first pixel and so on If the camera is operating at a lower resolution when the test images are generated the basic appearance of the test pattern will be similar to Figure 6 3 but the starting pixel values on each row will not be as described above The mathematical expression for test image one at 8 bit output Gray value x y MOD 256 Figure 6 3 Test Image One in Mono 8 BASLER A310t 6 19 Smart Features 6 20 Test Image One Fixed Diagonal Gray Gradient in Mono 16 As shown in Figure 6 4 on page 6 20 test image two consists of a gray scale gradient ranging from 0 to 4080 The gray value increments by 16 from pixel to pixel Assuming that the camera is operating at full 656 x 491 resolution and is set for a monochrome 16 bit output mode 12 bits effective when the test images are generated row O starts with a gray value of 0 for the first pixel row 1 starts with a gray value of 16 for the first pixel row 2 starts with a gray value of 32
41. Low byte of red value for P B3 High byte of green value for P4 B3 High byte of red value for P4 B4 Low byte of blue value for P3 B4 Low byte of green value for Ps Bs High byte of blue value for Po Bs High byte of green value for Ps Bg Low byte of green value for P4 Bg Low byte of red value for P5 B High byte of green value for P3 B High byte of red value for P4 e e e e e e e e e e e e Bm 7 Low byte of blue value for Ph 3 Bm 7 Low byte of green value for P 3 Bm 6 High byte of blue value for P 4 Bm High byte of green value for P 3 Bm 5 Low byte of green value for Py Bm 5 Low byte of red value for P Bm 4 High byte of green value for Py Bm 4 High byte of red value for P Bm 3 Low byte of blue value for P4 Bm 3 Low byte of green value for Py Bm 2 High byte of blue value for Pj Bm 2 High byte of green value for Py Bm 1 Low byte of green value for Ph Bm 1 Low byte of red value for Ph Bm High byte of green value for Ph Bm High byte of red value for P As shown in the tables above when the camera is set for 16 bit output data is placed in the image buffer in little endian format The DCAM standard specifies big endian format for 16 bit output but we do not follow this recommendation We use little en dian format so that 16 bit data can be processed more effectively on little endian hard ware such as Intel processor based PCs When the camera is set for 16 bit output 16 bits of data wi
42. Po Bo Low byte of red value for Po B4 High byte of green value for Po B4 High byte of red value for Po Bo Low byte of blue value for P4 Bo Low byte of green value for P4 B3 High byte of blue value for P4 B3 High byte of green value for P4 B4 Low byte of green value for Ps B4 Low byte of red value for P Bs High byte of green value for Ps Bs High byte of red value for Po Bg Low byte of blue value for P4 Bg Low byte of green value for P5 B High byte of blue value for P5 B High byte of green value for P4 e e e e e e e e e e e e Bm 7 Low byte of green value for P 3 Bm 7 Low byte of red value for P 3 Bm High byte of green value for P 3 Bm 6 High byte of red value for P 3 Bm 5 Low byte of blue value for P Bm 5 Low byte of green value for Pj Bm 4 High byte of blue value for Ph 2 Bm 4 High byte of green value for Ph 2 Bm 3 Low byte of green value for Py Bm 3 Low byte of red value for P4 Bm 2 High byte of green value for Py Bm 2 High byte of red value for P 4 Bm 1 Low byte of blue value for P Bm 1 Low byte of green value for Ph Bm High byte of blue value for Ph Bm High byte of green value for Ph BASLER A310f 5 11 Image Data Structures amp Formats 5 12 For Filter ID 2 GR BG Even Lines Odd Lines Byte Data Byte Data Bo Low byte of green value for Po Bo Low byte of blue value for Pg B4 High byte of green value for Po B4 High byte of blue val
43. Properties Window You can also access the firmware ID number by using the Extended Version Information smart feature See Section 6 7 7 for more information BASLER A310f 1 1 Introduction 1 2 Performance Specifications 1 2 Specification A311f A311fc A312 A312fc Sensor Type Sony ICX 414AL AQ Sony ICX 415AL AQ Progressive Scan CCD Progressive Scan CCD Pixels 659 H x 494 V 658 H x 492 V 782 H x 582 V 780 H x 580 V Pixel Size 9 9 um H x 9 9 um V 8 3 um H x 8 3 um V Max Frame Rate at full resolution 73 5 fps in 8 bit output modes 53 7 fps in 8 bit output modes 50 3 fps in 16 bit output modes 35 8 fps in 16 bit output modes Video Output Formats A311f A312f Mono 8 8 bits pixel Mono 16 16 bits pixel 12 bits are effective Pseudo YUV 4 2 2 16 bits pix avg Mono 8 8 bits pixel Mono 16 16 bits pixel 12 bits are effective Raw 8 8 bits pixel Raw 16 16 bits pixel 12 bits are effective YUV 4 2 2 16 bits pixel avg A311fc A312fc See Section 3 9 1 for more details Gain and Brightness Programmable via IEEE 1394 bus Exposure Time Control Programmable via IEEE 1394 bus Synchronization External via External Trigger signal Power Requirements 48 0 to 436 0 VDC 12 VDC nominal lt 1 96 ripple 3 W max 12 VDC typical supplied via 1394 cable I O Electrical Inpu
44. Windows XP accessories such as Movie Maker Format 0 Mode 5 FrameRate O 640 x 480 Y Mono 8 bits pixel 1 875 fps Format 0 Mode 5 FrameRate 1 640 x 480 Y Mono 8 bits pixel 3 75 fps Format 0 Mode 5 FrameRate 2 640 x 480 Y Mono 8 bits pixel 7 5 fps Format 0 Mode 5 FrameRate 3 640 x 480 Y Mono 8 bits pixel 15 fps Format 0 Mode 5 FrameRate 4 640 x 480 Y Mono 8 bits pixel 30 fps Format 0 Mode 5 FrameRate 5 640 x 480 Y Mono 8 bits pixel 60 fps Format 0 Mode 6 FrameRate O 640 x 480 Y Mono 16 bits pixel 1 875 fps Format 0 Mode 6 FrameRate 1 640 x 480 Y Mono 16 bits pixel 3 75 fps Format 0 Mode 6 FrameRate 2 640 x 480 Y Mono 16 bits pixel 7 5 fps Format 0 Mode 6 FrameRate 3 640 x 480 Y Mono 16 bits pixel 15 fps Format 0 Mode 6 FrameRate 4 640 x 480 Y Mono 16 bits pixel 30 fps BASLER A3IOf 3 35 Basic Operation amp Standard Features 3 36 3 9 2 Customizable Formats and Modes Format 7 Mode 0 is available on ASTIf and A312f monochrome cameras Format 7 Mode 0 Format 7 Mode 0 is used to enable and set up the area of interest AOI feature described in Section 3 4 Format 7 Mode 0 is parameterized by using the Format 7 Mode 0 control and status registers see page 4 28 When the camera is operating in Format 7 Mode 0 the frame rate can be adjusted by setting the number of bytes transmitted in each packet The number of bytes per packet i
45. a Y mono 16 component or an R G or B Raw 16 component is 16 bit data of the unsigned short little endian type The range of data values for a Y mono component and the corresponding indicated signal levels are shown below This Data Value Indicates This Signal Level Hexadecimal Decimal OxOFFF 4095 OxOFFE 4094 e e e e e e 0x0001 1 0x0000 0 However when an A310f camera is set for 16 bit output only 12 bits are effective Therefore the highest data value you will see is OXOFFF indicating a signal level of 4095 Normally the data values for a 16 bit component would range from 0x0000 to OxFFFF BASLER A310f 5 15 Image Data Structures amp Formats 5 16 BASLER A3l0f 6 1 6 2 Smart Features Smart Features and the Smart Features Framework What Are Smart Features Smart features are features unique to Basler cameras Test Images the Cycle Time Stamp and the CRC Cyclic Redundancy Check Checksum are examples of Basler smart features In some cases enabling a smart feature will simply change the behavior of the camera The Test Image feature is a good example of this type of smart feature When the Test Image feature is enabled the camera outputs a test image rather than a captured image When certain smart features are enabled the camera actually develops some sort of information about each image that it acquires In these cases the informa
46. brightness setting of around 8 decimal will result in an offset of 0 in the digital values output for the pixels Due to tolerances in the electronic components in your camera you may find that the default brightness is set to a slightly different setting An increase of 16 decimal in the brightness setting will result in a positive offset of 1 in the digital values output for the pixels For example a brightness setting of around 24 8 16 decimal would be required to reach a positive offset of 1 A brightness setting of around 40 8 16 16 decimal would be required to reach a positive offset of 2 and so on On an AST A312f set to Mono 16 or an AS3Ilfc ASI2tc set to Raw 16 a brightness setting of around 0 decimal will result in an offset of 0 in the digital values output for the pixels An increase of 1 decimal in the brightness setting will result in a positive offset of 1 in the digital values output for the pixels BASLER A310f 3 21 Basic Operation amp Standard Features 3 4 3 22 Area of Interest AOI The area of interest AOI feature allows you to specify a portion of the CCD array and during operation only the pixel information from the specified portion of the array is transmitted out of the camera The area of interest is referenced to the top left corner of the CCD array The top left corner is designated as column 0 and row 0 as shown in Figure 3 13 The location and size of the area of interest i
47. can be used to control the start of exposure For more information about the ExTrig signal and for information on assigning the ExTrig signal to a different input port see Section 3 2 5 As stated above the nominal input voltage for the LED on each input is 5 VDC If a 560 Ohm resistor is added to the positive line for an input the input voltage can be 12 VDC If a 1 2 or 1 5 kOhm resistor is added to the positive line for an input the input voltage can be 24 VDC 2 5 2 Output Ports A310f cameras are equipped with four physical output ports designated as Output Port 0 Output Port 1 Output Port 2 and Output Port 3 The output ports are accessed via the 10 pin RJ 45 jack on the back of the camera See Table 2 2 and Figure 2 2 for output port pin assignments and pin numbering As shown in the schematic in Figure 2 3 each output port is opto isolated The minimum forward voltage is 2 V the maximum forward voltage is 35 V the maximum reverse voltage is 6 V and the maximum collector current is 100 mA A conducting transistor means a logical one and a non conducting transistor means a logical zero By default Output Port O is assigned to transmit an integration enabled IntEn signal that indicates when exposure is taking place For more information about the IntEn signal see Section 3 2 10 By default Output Port 1 is assigned to transmit a trigger ready TrigRdy signal that goes high to indicate the earliest poin
48. described in the table below Values are stated in decimal format except when marked Ox Values marked as Ox e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit Register Name Special Features Access Control Register Offset from Base Address 0x000 Field Bit Description Feature ID High 0 81 On all A310f cameras the value for Feature ID High field is 0x0030 533B Feature ID Low 32 47 On all A310f cameras the value for Feature ID Low field is 0x73C3 OxF 48 51 This value for this field always OxF Time Out 52 63 On all A310f cameras the value for Time Out field is 0x000 On A310t cameras all advanced features registers including the Access Control register have been made part of Basler s Smart Features Framework SFF See Section 6 for a detailed explanation of using the SFF framework to access advanced features Section 6 5 1 contains specific information about using the Access Control register BASLER A310f 4 47 Configuring the Camera 4 48 BASLER A310f Image Data Structures amp Formats 5 Image Data Structures and Formats 5 1 Image Data Basics Image data is transmitted as isochronous data packets according to the 1394 based Digital Camera Specification DCAM issued by the 1394 Trade Association see the trade association s web site www 1394ta org The first packet of each frame is identified by a 1 in the sync b
49. each standard format mode framerate combination available on the A310f cameras This information is especially useful when calculating a camera s bandwidth usage 5 2 1 Format 0 Mode 1 320 x 240 YUV 4 2 2 16 bits pixel avg Frame Rate 1 875 fps 3 75 fps 7 5 fps 15 fps 30 fps 60 fps Lines per Packet 1 16 1 8 1 4 1 2 1 2 Pixels per Packet 20 40 80 160 320 640 Bytes per Packet 40 80 160 320 640 1280 5 2 2 Format 0 Mode 3 640 x 480 YUV 4 2 2 16 bits pixel avg Frame Rate 1 875 fps 3 75 fps 7 5 fps 15 fps 30 fps Lines per Packet 1 8 1 4 1 2 1 2 Pixels per Packet 80 160 320 640 1280 Bytes per Packet 160 320 640 1280 2560 5 2 3 Format 0 Mode 5 640 x 480 Y Mono 8 bits pixel Frame Rate 1 875 fps 3 75 fps 7 5 fps 15 fps 30 fps 60 fps Lines per Packet 1 8 1 4 1 2 1 2 4 Pixels per Packet 80 160 320 640 1280 2560 Bytes per Packet 80 160 320 640 1280 2560 5 2 4 Format 0 Mode 6 640 x 480 Y Mono 16 bits pixel Frame Rate 1 875 fps 3 75 fps 7 5 fps 15 fps 30 fps Lines per Packet 1 8 1 4 1 2 1 2 Pixels per Packet 80 160 320 640 1280 Bytes per Packet 160 320 640 1280 2560 BASLER A310f 5 3 Image Data Structures amp Formats 5 3 5 4 Image Data Formats 5 3 1 Data Format with the Camera Set for YUV 4 2 2 Output The table below describes how the data for a received frame will be ordered in the image buffer in your PC The following standards are used in the table Po the first pixel transmitted by the came
50. for the first pixel and so on If the camera is operating at a lower resolution when the test images are generated the basic appearance of the test pattern will be similar to the one explained above but the starting pixel values on each row will not be as described above The mathematical expression for test image one at 16 bit output 12 bit effective Gray value x y MOD 256 x 16 408 Qd B EET 6 32 Figure 6 4 Test Image One in Mono 16 BASLER A310f Smart Features Test Image Two Fixed Diagonal Flattened Gray Gradient in Mono 8 As shown in Figure 6 5 test image two consists of a flattened gray scale gradient ranging from 0 to 255 Assuming that the camera is operating at full 656 x 491 resolution and is set for a monochrome 8 bit output mode when the test images are generated row 0 starts with a gray value of 0 for the first 16 pixels row 1 starts with a gray value of 0 for the first 12 pixels row 2 starts with a gray value of 0 for the first 8 pixels row 3 starts with a gray value of 0 for the first 4 pixels row 4 starts with a gray value of 1 for the first 16 pixels and so on If the camera is operating at a lower resolution when the test images are generated the basic appearance of the test pattern will be similar to Figure 6 5 but the starting pixel values on each row will not be as described above The mathematical expression for test image two at 8 bit output x 4y MOD 40
51. number of bytes needed to transmit a frame the packets per frame will increase Due to limitations in the DCAM structure a maximum of 4095 packets per frame is allowed If you set the bytes per packet too low the number of packets per frame will exceed the 4095 packet limit and the camera will not transmit frames properly When the camera is operating in Format 7 the Current Video Frame Rate control reg ister is not used and has no effect on camera operation Color Codings In Format 7 Mode 0 the Mono 8 Raw 8 Raw 16 and YUV 4 2 2 color codings are available When the Mono 8 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode O0 the camera outputs 8 bits per pixel and outputs only the Y component brightness of the YUV format When the Raw 8 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 the camera outputs 8 bits per pixel and outputs the raw data for each pixel The pixel data is not processed to account for the color filter This type of output is sometimes called Bayer 8 When the Raw 16 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 the camera outputs 16 bits per pixel but only 12 bits are effective The effective pixel data fills from the LSB and the unused bits are filled with zeros Pixel data is stored in the PC memory in little endian format i e the low byte for each pixel is stored at the lower
52. one or more triggers has been detected since the last time the Trigger Flag field was read the trigger flag is set to one The flag self clears with each read access Writes to the Trigger Count or Trigger Flag fields are ignored The counter field or the flag field can be polled by your camera control software to detect the receipt of a trigger signal by the camera The camera control software can react synchronously to each trigger signal received By using the results of the polling to know when a trigger signal is received by the camera you can eliminate the need for a hard wired signal from the hardware device that is issuing the trigger Keep in mind that your degree of precision depends on your polling frequency and the 1394 bus latency The trigger flag and trigger counter smart feature does not add information to the im age data stream and can be accessed even when the extended data stream feature see Section 6 7 1 is disabled The trigger flag and counter feature is always enabled regardless of the video format Control and Status Register for the Trigger Flag and Counter Feature Name Trigger Flag and Counter Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 16C31A78 3F75 11D8 94EC 00105A5BAE55 Position Field Bit Description 0 Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 15 Reserved Trigger C
53. pixel When the Mono 8 color coding ID is set the camera outputs 8 bits per pixel and outputs only the Y component brightness of the YUV format When the Raw 8 color coding ID is set the camera outputs 8 bits per pixel and outputs the raw data for each pixel The pixel data is not processed to account for the color filter For 12 Bit Depth Set the value Coding ID field of the Color Coding ID register for Format 7 Mode 0 to Raw 16 When the Raw 16 color coding ID is set the camera outputs 16 bits per pixel and outputs the raw data for each pixel The pixel data is not processed to account for the color filter Although the camera outputs 16 bits per pixel in this mode only 12 bits are effective The effective pixel data fills from the LSB and the unused bits are filled with zeros Pixel data is stored in the PC memory in little endian format i e the low byte for each pixel is stored at the lower address and the high byte is stored at the neighboring higher address BASLER A310f 3 31 Basic Operation amp Standard Features 3 7 3 32 Strobe Control Output Signals A310f cameras include a feature designed to help you control strobe lighting The feature allows a user to enable and parameterize up to four strobe control output signals The signals are designated as Strobe 0 Strobe 1 Strobe 2 and Strobe 3 The Strobe Signal Function control registers see page 4 43 are used to enable and parameterize the strobe output signal
54. quadlets 4 2 Changing the Video Format Setting Whenever the Video Format setting is changed you should also do the following If the Video Format is changed from Format 7 to Format 0 you should also check the Video Mode and the Video Frame Rate settings see page 4 17 If necessary change the Mode and Frame Rate settings so that they are compatible with Format 2 If the Video Format is changed from Format 0 to Format 7 you should also check the Video Mode the Image Position the Image Size and the Bytes Per Packet settings see pages 4 17 and 4 28 If necessary change the Mode Position Size and Bytes per Packet settings so that they are compatible with Format 7 4 3 Configuration ROM The configuration ROM in the A310f is compliant with the DCAM specification V 1 31 4 2 BASLER ASIOt 4 4 Configuring the Camera Implemented Standard Registers This section includes a description of all DCAM standard registers implemented in the A310f 4 4 1 Inquiry Registers The base address for all inquiry registers is Bus ID Node ID FFFF FOFO 0000 In each inquiry register description an Offset from Base Address is provided This a byte offset from the above base address The address of an inquiry register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as Ox e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant
55. should be set in increments of 2 Hunit 2 Vunit 16 31 Indicates the increment in rows for adjusting the area of interest height see Section 3 4 For example if the Vunit is 1 the height should be set in increments of 1 Vunit 2 BASLER A310f 4 35 Configuring the Camera 4 36 Register Name Image Position Offset from Base Address 0x008 Field Name Bit Description Left 0 15 Sets the left starting column of pixels for the area of interest see Sec tion 3 4 Default 0 Top 16 31 Sets the top row of pixels for the area of interest see Section 3 4 Default 0 Register Name Image Size Offset from Base Address 0x00C Field Bit Description Width 0 15 Sets the width in columns for the area of interest see Section 3 4 Default 658 on the A311fc Default 780 on the A312fc Height 16 31 Sets the height in rows for the area of interest see Section 3 4 Default 492 on the A311fc Default 580 on the A312fc Register Name Color Coding ID Offset from Base Address 0x010 Field Bit Description Coding ID 0 7 Sets the color coding Valid color codings for Format 7 Mode 1 are listed in the Color Coding Inquiry register see the next register de scription Default ID 0 8 31 Reserved BASLER A310f Configuring the Camera Register Name Color Coding Inqu
56. the correction factor for blue and red above 1 5 The Blue Value field of the White Balance control register see page 4 22 can be used to change the blue correction factor The usable range of settings for this field is from 64 0x40 to 255 OxFF If the field is set to 96 0x60 blue will have the same 1 5 correction factor as green If the field is set to a lower value blue will have a lower correction factor and the image will be less blue If the field is set to a higher value blue will have a higher correction factor and the image will be more blue The default setting for the Blue Value is 160 OxA0 To determine the correction factor for blue use this formula Blue Correction Factor Blue vane Settin The Red Value field of the White Balance control register can be used to change the red correction factor The usable range of settings for the this field is from 64 0x40 to 255 OxFF If the field is set to 96 0x60 red will have the same 1 5 correction factor as green If the field is set to a lower value red will have a lower correction factor and the image will be less red If the field is set to a higher value red will have a higher correction factor and the image will be more red The default setting for the Red Value is 115 0x73 To determine the correction factor for red use this formula Red Correction Factor Red vane Settin however only the settings from 64 0x40 to 255 OxFF are useful If you set the
57. through an FPGA and into an image buffer The data leaves the image buffer and passes back through the FPGA to a 1394 link layer controller where it is assembled into data packets that comply with the 1394 based Digital Camera Specification DCAM issued by the 1394 Trade Association The packets are passed to a 1394 physical layer controller which transmits them isochronously to a 1394 interface board in the host PC The physical and link layer controllers also handle transmission and receipt of asynchronous data such as programming commands The image buffer between the sensor and the link layer controller allows data to be read out of the sensor at a rate that is independent of the data transmission rate between the camera and the host computer This ensures that the data transmission rate has no influence on image quality BASLER A310f 3 1 Basic Operation amp Standard Features CCD Sensor Vert Vert Vert Vert Shift Shift Shift Shift Reg Pixels Reg Pixels Reg Pixels Reg Pixels a L4 r4 e 4 Y a y ja lt Y Y a a y a r4 t 7 e a Y 4 a ADC VGC Horizontal L Shift Register ADC VGC Figure 3 1 A310t Sensor Architecture TrigRdy Link ccp Layer en
58. to the minimum the camera will use the minimum exposure time If the exposure time as controlled by the ExTrig signal is greater than the minimum the cam era will use the exposure time determined by the ExTrig signal Example 1 Assume that you set your camera for level controlled exposure with rising edge triggering and that you set the shutter settings for a 2000 uis minimum exposure time Now assume that you triggered an exposure start by raising the ExTrig signal and that the signal remained high for 1500 us In this case the camera would have a 2000 us exposure time because the ExTrig high time was less than the minimum exposure setting Example 2 Assume that you set your camera for ExTrig level controlled exposure with rising edge triggering and that you set the shutter settings for a 2000 us minimum exposure time Now assume that you triggered an exposure start by raising the ExTrig signal and that the signal remained high for 3500 us In this case the camera would have a 3500 us exposure time because the ExTrig high time was greater than the minimum exposure setting When using level controlled exposure you should adjust the shutter settings to set the minimum exposure time to the shortest exposure you intend to use For example assume that you will be using level controlled exposure and that you intend to use the ExTrig signal to vary the exposure time in a range from 3000 us to 5500 us In this case you would use the shutter setti
59. 0 depends on the format mode and frame rate set tings In Format 7 the maxi mum is 4095 BASLER A310f 4 13 Configuring the Camera 4 14 Register Name Gain Inquiry Offset from Base Address 0x520 Field Bit Description A311f A311fc A312 A312fc Value Value Presence Inq 0 Gain control feature is present 1 1 Abs Control Inq 1 Gain can be set with an absolute value 0 0 2 Reserved E us One Push Inq 3 One push auto mode is present 0 0 Read Out Inq 4 The gain value can be read 1 1 On Off Inq 5 Gain control can be switched on off 0 0 Auto Inq 6 A gain auto control mode is present 0 0 Manual Inq 7 The gain value can be set manually 1 1 Min Value 8 19 Minimum value for gain 192 192 Max Value 20 31 Maximum value for gain 768 640 511 if setfor 511 if set Mono 16 for Raw 16 BASLER A3l0f Configuring the Camera BASLER A310f Register Name Trigger Inquiry Offset from Base Address 0x530 Field Bit Description A311f A311fc A312f A312fc Value Presence Inq 0 Trigger control feature is present 1 Abs Control Inq 1 Trigger can be set with an absolute value 0 2 Reserved s Read Out Inq 4 The trigger value can be read 1 On Off Inq 5 Trigger control can be switched on off 1 Polarity Inq 6 The trigger input polarity can be changed 1 Value Read 7 The raw t
60. 0 2 for more information Formula 1 1 Max Frames s L ax pramesiS 28 8 us x 110 1836 us Max Frames s 224 5 Formula 2 Max F LI ax Frames s 3 x 125 us Max Frames s 2666 7 Formula 3 A3IIt c 1 Max Frames s ax Frames s 2000 us 81 5 ps Max Frames s 480 4 Formula one returns the lowest value So in this case the limiting parameter is the frame readout time and the maximum frame rate would be 224 5 frames per second 3 26 BASLER A310f 3 5 Basic Operation amp Standard Features Color Creation in the A311fc and A312fc The CCD sensor used in the A3llfe and A312fc is equipped with an additive color separation filter known as a Bayer filter With the Bayer filter each individual pixel is covered by a micro lens which allows light of only one color to strike the pixel The pattern of the Bayer filter used in the A3llfc and A312fc is shown in Figure 3 14 As the figure illustrates within each block of four pixels one pixel sees only red light one sees only blue light and two pixels see only green light This combination mimics the human eye s sensitivity to color
61. 1 4 1 5 Environmental Requirements 0 0 00 eee eee 1 6 1 5 1 Temperature and Humidity llle 1 6 15 2 Ventilation crie cde e Rm t kno qe Tee YHP E RO e ce 1 6 1 6 Precautions suy oe km DIR ee eee em REIS IEEE SINE 1 6 2 Camera Interface 2 1 Gonfiections eto VH RSEN e Ue s 2 1 2 1 1 General Description 0 0 ccc eee 2 1 2402 Pin Assignments s dae he tea a a hele ed Gil ade TU VELIE 2 2 2 1 9 Connector Types aac o str pem tpe ews DGC ek ee ae a 2 3 2 2 Cables e enge eS rice phim aea 2 4 2 3 Camera Power T e E a rh 2 4 2 4 IEEE 1394 Device Information liliis 2 4 2 5 Input and Output Poms s eeu tuetbereuebenbxeswedee rera eq uei c4wus 2 5 2 55 Input POrtSs um PE De tae eke hag ads bee AE RUN Dene Re eo oa 2 5 2 5 2 Output Ports 2 de bo E RTI ee eet n EE 2 5 2 5 3 Typical Input Circuits liliis 2 7 2 5 4 Typical Output Circuits llli 2 8 3 Basic Operation and Standard Features 3 1 Functional Description ut ene ett et te ert x pond te dh ede 3 1 951 OVOIVIOW aru wind ees ea et Needle ber se Pe ot aee ire E eae 3 1 3 2 Exposure Control rorem a taea ena E E a D EAE ren 3 3 3 2 1 Setting the Exposure Time 0000 c cee eee 3 3 3 2 2 Maximum Exposure Time 00 eh 3 3 3 2 3 Controlling Exposure Start with Shot Commands via the 1394 Interface 3 4 3 2 4 Controlling Exposure Start with a Software Trigger llis 3 5
62. 17 to 7 and the Mode field of the Current Video Mode control register to 0 The location of the area of interest is defined by setting a value for the Left field and a value for the Top field of the Image Position control register for Format 7 Mode 0 see page 4 28 The size of the area of interest is defined by setting a value for the Width field and a value for the Height field of the Image Size control register for Format 7 Mode 0 BASLER A310f Basic Operation amp Standard Features To use the entire CCD array in A3llf cameras set the value for Left to 0 the value for Top to 0 the value for Width to 659 and the value for Height to 494 in ASTIfc cameras set the value for Left to 0 the value for Top to 0 the value for Width to 658 and the value for Height to 492 in ASI2t cameras set the value for Left to 0 the value for Top to 0 the value for Width to 782 and the value for Height to 582 in ASI2t cameras set the value for Left to 0 the value for Top to 0 the value for Width to 780 and the value for Height to 580 The sum of the setting for Left plus the setting for Width must not exceed 659 on A3IIf cameras 658 on A3llfc cameras 782 on A312f cameras 780 on A3I2tfc cameras The sum of the setting for Top plus the setting for Height must not exceed 494 on A3IIf cameras 492 on A3llfc cameras 582 on A312f cameras 580 on A3I2tfc cameras Due to the Bayer filter pattern when y
63. 3 2 5 Controlling Exposure Start with an ExTrig Signal 2 3 8 3 2 6 Recommended Method for Controlling Exposure Start 3 12 3 2 7 Frame Bufferinig eoi ele VER ex ERR BERG Faw E Yd 3 12 3 2 8 Overlapped and Non overlapped Exposure 000ee eee 3 14 3 2 9 Trigger Ready Signal liliis lees 3 16 3 2 10 Integrate Enabled Signal liliis 3 18 3 3 Gain and Brightness nse gay an tees 3 19 3 3 1 Setting Gain 0 teens 3 20 3 3 2 Setting Brightness 0 0 0 c tees 3 21 BASLER A3l0f l Contents 3 4 Area of Interest AOI 0 0 0 ct tee 3 22 3 4 1 Changing AOI Parameters On the Fly 0 0000 cae eee 3 24 3 4 2 Changes to the Frame Rate with AOI 1 2 20 0 0 00 eee 3 25 3 5 Color Creation in the A311fc and A3812fc 2 es 3 27 3 51 White Balance yoia sete eed Gane Odds okies d eae desde He 3 29 3 5 2 Color Filter ID eead aa e e ea eee eee eee 3 30 3 5 3 Integrated IR Cut Filler llle 3 30 3 6 Selectable 8 or 12 Bit Pixel Depth 0 0 0 0 cee 3 31 3 6 1 A311f and A312f Monochrome Cameras 0 000 3 31 3 6 2 A311fc and A312fc Color Cameras llle llle 3 81 3 7 Strobe Control Output Signals 000 cee 3 32 3 8 Parallel Input Output Control 1 2 2 0 0c eh 3 34 3 9 Available Video Formats Modes amp Frame Rates on Monochrome Cameras 3 35 3 9 1 Standard Formats Modes amp Frame Rates
64. 310f 5 7 Image Data Structures amp Formats 5 8 For Filter ID 1 GB RG Even Lines Odd Lines Byte Data Byte Data Bo Green value for Po Bo Red value for Po B4 Blue value for P4 B4 Green value for P4 Bo Green value for Po Bo Red value for Po B3 Blue value for P3 B3 Green value for P3 B4 Green value for P4 B4 Red value for P4 B5 Blue value for P5 B5 Green value for Ps e e e e e e e e e e e e Bm 5 Green value for P 5 Bm 5 Red value for P5 Bm 4 Blue value for P4 Bm 4 Green value for Ph 4 Bm 3 Green value for P 3 Bm 3 Red value for P 3 Bm 2 Blue value for P Bm 2 Green value for Pj Bm4 Green value for P 4 Bm4 Red value for P Bm Blue value for Ph Bm Green value for P For Filter ID 2 GR BG Even Lines Odd Lines Byte Data Byte Data Bo Green value for Po Bo Blue value for Po B4 Red value for P4 B4 Green value for P4 Bo Green value for Po Bo Blue value for Po B3 Red value for P4 B3 Green value for P4 B4 Green value for P4 B4 Blue value for P4 B5 Red value for P5 B5 Green value for Ps e e e e e e e e e e e e Bm 5 Green value for Ph 5 Bm 5 Blue value for P 5 Bm 4 Red value for Ph 4 Bm 4 Green value for Ph 4 Bm 3 Green value for P 3 Bm 3 Blue value for Py 3 Bm 2 Red value for Ph 2 Bm 2 Green value for Py Bm Green value for Py Bm Blue value f
65. 310f cameras have a startup channel feature that lets you change this behavior The startup channel feature designates which memory channel will be used at power on or reset For example if the startup channel is designated as memory channel 2 the settings in memory channel 2 will be copied into the work set at power on or reset The startup channel feature on A310f cameras has been implemented as a smart feature See Section 6 7 12 for more information on the startup channel smart feature previously saved a configuration set into the designated channel You cannot use an You can only designate memory channel 1 2 or 3 as the startup channel if you have empty memory channel as the startup channel BASLER A310f Configuring the Camera 4 Configuring the Camera A310f cameras are configured by setting status and control registers as described in the 1394 Based Digital Camera Specification issued by the 1394 Trade Association The specification is commonly referred to as the DCAM standard or the IIDC standard It is available at the 1394 Trade Association s web site www 1394ta org Except where noted all registers conform to version 1 31 of the DCAM standard If you are creating your own driver to operate the camera Sections 4 1 through 4 4 provide the basic information you need about the registers implemented in the camera along with some information about read write capabilities and the image data forma
66. 37 Configuring the Camera 4 38 Register Name Pixel Number Inquiry Offset from Base Address 0x034 Field Bit Description Pixels Per Frame 0 31 Indicates the total number of pixels per frame The value in this register depends on settings in the Format 7 Mode 1 Image Size register see page 4 36 Register Name Total Bytes High Inquiry Offset from Base Address 0x038 Field Bit Description Bytes Per Frame 0 81 Indicates the higher quadlet of the total bytes of image data per frame High The value in this register depends on settings in the Format 7 Mode 1 Image Size and Color Coding ID registers see page 4 36 The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Total Bytes Low Inquiry Offset from Base Address 0x03C Field Bit Description Bytes Per Frame 0 81 Indicates the lower quadlet of the total bytes of image data per frame Low The value in this register depends on settings in the Format 7 Mode 1 Image Size and Color Coding ID registers see page 4 36 The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Packet Para Inquiry Offset from Base Address 0x040 Field Bit Description Unit Bytes Per 0 15 Indicates the increment for sett
67. 511 are valid Settings above 511 should not be used with the camera set for Mono 16 or Raw 16 output In all other output modes the entire range of gain set In normal operation a gain setting lower than 192 should not be used When the gain setting is lower than 192 the sensor output signal that is mapped to the input of the The camera s gain is determined by the setting in the Value field in the Gain control register see page 4 24 If you know the decimal number DN setting for the gain on your camera the equivalent decibel value can be calculated using one of the following equations When DN setting 192 to 511 When DN setting gt 512 3 20 658 DN dB 20xlog t 5 221 dB 0 0354 x DN 5 221 BASLER A3l0f The gain settings result in the following amplifications Basic Operation amp Standard Features Decimal Number DN Hexadecimal dB Factor 192 0x0CO 0 x1 374 0x176 6 X2 499 0x1F3 12 X4 640 0x280 17 4 X7 5 768 0x300 22 X12 6 A3nif A312f only Table 3 1 Examples of Gain Settings in dB 3 3 2 Setting Brightness The camera s brightness is determined by the setting in the Value field in the Brightness control register see page 4 21 The brightness setting can be programmed on a decimal scale that ranges from 0 to 255 0x000 to OxOFF If the camera is operating in any output mode other than Mono 16 A3IIt A312f or Raw 16 A3llfc A312fc a
68. 96 16 Gray value truncate all decimals Figure 6 5 Test Image Two in Mono 8 BASLER A310t 6 21 Smart Features Test Image Two Fixed Diagonal Flattened Gray Gradient in Mono 16 As shown in Figure 6 6 test image two consists of a flattened gray scale gradient ranging from 0 to 4095 Assuming that the camera is operating at full 656 x 491 resolution and is set for a monochrome 16 bit output mode 12 bits effective when the test images are generated row O starts with a gray value of 0 for the first pixel row 1 starts with a gray value of 4 for the first pixel row 2 starts with a gray value of 8 for the first pixel and so on If the camera is operating at a lower resolution when the test images are generated the basic appearance of the test pattern will be similar to the one explained above but the starting pixel values on each row will not be as described above The mathematical expression for test image two at 16 bit output 12 bit effective Gray value x 4y MOD 4096 truncate all decimals 16 17 18 19 Figure 6 6 Test Image Two in Mono 16 6 22 BASLER A310f Smart Features Test Image Three Moving Diagonal Gray Gradient in Mono 8 Test image three is similar to test image one but it is not stationary The image moves by one pixel from right to left whenever a one shot or a continuous shot command signal is sent to the camera The test pattern uses a counter that increments
69. A310f 4 21 Configuring the Camera Register Name White Balance Offset from Base Address 0x80C Field Bit Description Presence Inq 0 Indicates the presence of the white balance control feature The value will be 0 on A311f and A312f cameras indicating that white balance control is not available The value will be 1 on A311fc and A312fc cameras indicating that white balance control is available This field is read only Abs Control 1 Determines whether the white balance will be controlled by the Value field of this register or by the Absolute Value CSR for white balance The value will be 0 indicating that white balance can only be controlled by the Value field of this register Absolute value control is not available on A310f cameras This field is read only 2 4 Reserved One Push 5 Sets One Push operation The value will be 0 indicating that one push is not in operation One push operation is not available on A310f cameras This field is read only On Off 6 Sets whether white balance control is on or off The value will be 1 on A311fc and A312fc cameras indicating that white balance control is on The white balance control feature can t be switched off on A311fc or A312fc cameras This field is read only A M Mode 7 Sets whether the camera is in automatic or manual white balance con trol mode The value will be 0 indicating that white balance control is in manual m
70. A310f cameras support PIO control Register Name Strobe Output CSR Inquiry Quadlet Offset Offset from Base Address 0x48C Field Bit Description Strobe Output 0 81 Indicates the quadlet offset from the base address of the initial register space for the strobe output Control and Status Registers CSR All A310f cameras support strobe output control BASLER A310f Configuring the Camera 4 12 4 4 1 8 Inquiry Registers for Feature Elements The feature element inquiry registers indicates the availability of elements modes maximum and minimum values for features Note that changing the video format or video mode may change the availability of a feature element 0 element not available 1 element available Register Name Brightness Inquiry Offset from Base Address 0x500 Field Bit Description A311f A311fc A312f A312fc Value Presence Inq 0 Brightness control feature is present 1 Abs Control Inq 1 Brightness can be set with an absolute value 0 2 Reserved One Push Inq 3 One push auto mode is present 0 Read Out Inq 4 The brightness value can be read 1 On Off Inq 5 Brightness control can be switched on off 0 Auto Inq 6 A brightness auto control mode is present 0 Manual Inq 7 The brightness value can be set manually 1 Min Value 8 19 Minimum value for brightness 0 Max Value 20
71. Basler A310f USER S MANUAL Document Number DA000668 Version 04 Language 000 English Release Date 7 December 2010 BASLER For customers in the U S A This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to Part 15 of the FCC Rules These limits are designed to provide reasonable protec tion against harmful interference when the equipment is operated in a commercial environ ment This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instruction manual may cause harmful interference to radio communications Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense You are cautioned that any changes or modifications not expressly approved in this manual could void your authority to operate this equipment The shielded interface cable recommended in this manual must be used with this equipment in order to comply with the limits for a computing device pursuant to Subpart J of Part 15 of FCC Rules For customers in Canada This apparatus complies with the Class A limits for radio noise emissions set out in Radio In terference Regulations Pour utilisateurs au Canada Cet appareil est conforme aux normes Classe A pour bruits radio lectriques sp cifi es dans le R glement sur le brouil
72. Blue Value lower than 64 0x40 the camera will continue to operate but you will see unacceptable changes in the color balance The actual range of valid settings for the Red Value is from 16 0x10 to 255 OxFF however only the settings from 64 0x40 to 255 OxFF are useful If you set the Red Value lower than 64 0x40 the camera will continue to operate but you will see unacceptable changes in the color balance The actual range of valid settings for the Blue Value is from 16 0x10 to 255 OxFF BASLER A310f 3 29 Basic Operation amp Standard Features 3 5 2 Color Filter ID The Color Filter ID register for Format 7 see page 4 33 has been implemented on A3llfe and A312fe cameras This Color Filter ID register can be used to determine the alignment of the camera s color filter to the current Area of Interest AOI To use this feature make all desired changes to the camera s parameter settings and then read the value in the Filter ID field of the Color Filter ID register The field will indicate an ID of 0 1 2 or 3 as appropriate As shown in Table 3 2 each ID identifies the color of the first two pixels in the first row of the current AOI and the color of the first two pixels in the second row of the AOI Due to the repetitive nature of the Bayer RGB primary color filter see Section 3 5 2 used in the A3llfe and A312fc this information is all you need to determine the order of the pixel colors with your curr
73. Mapped for Higher Camera Output at Low Sensor Readings D The lookup table smart feature does not add information to the image data stream and can be accessed even when the extended data stream feature see Section 6 7 1 is disabled The gain and offset funtions remain active when the lookup table is used Gain and offset are applied to the pixel values reported from the sensor before the pixel values are processed with the lookup table The lookup table feature will work when the camera is set for any valid video format that outputs Mono 8 Raw 8 or YUV 4 2 2 When you enable the lookup table feature a default lookup table is automatically loaded into the camera see Section 6 7 9 for more information about the default ta ble If you want use your own customized lookup table you must 1 Use the look table feature Control and Status Register CSR to enable the lookup table feature 2 Write the values for your customized lookup table to the CSR BASLER A310f 6 27 Smart Features Control and Status Register for the Lookup Table Feature Name Lookup Table Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID B28C667C DF9D 11D7 8693 000C6EOBD1BO Position Field Bit Description 0 Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31
74. Offset from Base Address Bit 0x044 Description Bytes Per Packet 0 15 Sets the number of bytes per packet the packet size Note When you lower the bytes per packet setting the number of packets needed to transmit a frame the packets per frame will in crease Due to limitations in the DCAM structure a maximum of 4095 packets per frame is allowed If you set the bytes per packet too low the number of packets per frame will exceed the 4095 packet limit and the camera will not transmit frames properly Rec Byte Per Packet 16 31 Indicates the minimum bytes per packet needed to achieve the highest possible frame rate with the current camera settings The recommended bytes per packet field is updated whenever the For mat 7 settings are changed Register Name Packets Per Frame Inquiry Offset from Base Address 0x048 Field Bit Description Packets Per Frame 0 31 Indicates the total packets per frame The value in this register depends on settings in the Format 7 Mode 0 Image Size and Color Coding ID registers see page 4 29 and on the setting of the Bytes per Packet register see above The value in this register includes image data padding bytes and any data added by enabled smart features see Section 6 Register Name Unit Position Inquiry Offset from Base Address 0x04C Field Bit Description Hposunit 0 15 Indicat
75. SIZG 52159 eH Vence ueni RC dei gerens 1 2 TYPO ox Soit Rd pU VERE 1 2 shot commands controlling exposure with 3 4 shutter time base smart feature 6 37 smart features CRC checksun 220 0055 6 16 customized smart features 6 41 cycle time stamp 0000 6 12 DCAM values 000000ee 6 13 detined 7 2 vx ede At pa Eee 6 1 extended data stream 6 9 extended version info 6 25 frame counter llllslllsss 6 11 lookup table 0000 6 26 lossless compression 6 31 output port configuration 6 33 requirements 000 0c eee ee eee 6 2 shutter time base 4 6 37 startup memory channel 6 36 strobe time base 000 6 39 testimage 2 eee eee 6 19 trigger flag and counter 6 32 iv smart features framework defined 2 00 c ee eee 6 1 smart features framework software 6 2 software trigger continuous shot operation 3 6 controlling exposure with 3 5 one shot operation 0 3 5 specifications lese 1 2 spectral response llle 1 4 1 5 startup memory channel 3 42 startup memory channel smart feature 6 36 strobe control a an anaana aana 3 32 strobe time base smart feature
76. Strobe 0 Inq 0 Presence of the Strobe 0 signal feature 1 Strobe 1 Inq 1 Presence of the Strobe 1 signal feature 1 Strobe 2 Inq 2 Presence of the Strobe 2 signal feature 1 Strobe 3 Inq 3 Presence of the Strobe 3 signal feature 1 4 91 Reserved ase Register Name Strobe 0 Inquiry Offset from Base Address 0x100 Field Bit Description A311f A311fc A312 A312fc Value Presence Inq 0 Strobe 0 signal feature is present 1 1 3 Reserved sm Read Out Inq 4 The Strobe 0 value can be read 1 On Off Inq 5 Strobe 0 control can be switched on off 1 Polarity Inq 6 Strobe 0 polarity can be changed 1 7 Reserved x Min Value 8 19 Minimum value for Strobe 0 controls 0 Max Value 20 31 Maximum value for Strobe 0 controls 4095 If a bit is set to 0 the camera does not support this feature If a bit is set to 1 the camera supports this feature BASLER A3IOf 4 43 Configuring the Camera Register Name Strobe 1 Inquiry Field Offset from Base Address Bit 0x104 Description A311f A311fc A312f A312fc Value Same definitions and values as Strobe 0 Inq Register Name Strobe 2 Inquiry Field Offset from Base Address Bit 0x108 Description A311f A311fc A312f A312fc Value Same definitions and values as Strobe 0 Inq Register Name Strobe 3 Inquiry Offset from Base Address 0x10C 4 44 Field Bit Descriptio
77. a s sensor to 8 bit output transmitted from the camera The basis for the lossless compression feature is a mathematical process that compresses the 12 bit output from the sensor to 8 bits by removing information characterized as noise Because this method removes only the portion of the sensor s output that represents noise no image information is lost and the resulting images have an extended dynamic range compared to normal 8 bit images Lossless compression is implemented on the A310f by means of a lookup table To enable lossless compression simply enable the lookup table feature as described in Section 6 7 8 When you enable the lookup table feature a default table is automatically loaded into the camera The values in the default lookup table were determined using the lossless compression technique So if you operate the camera with the lookup feature enabled and the default table loaded the camera will output 8 bit data via lossless compression BASLER A310f 6 31 Smart Features 6 32 6 7 10 Trigger Flag and Trigger Counter A310t cameras include a trigger flag and trigger counter feature The trigger counter increments by one each time an image capture is triggered regardless of whether the trigger is internal one shot or continuous shot commands or is external hardware or software trigger Triggers that occur when the camera is not ready are discarded and not counted The trigger counter wraps to zero after 65535 is reached If
78. ach bit in the feature presence inquiry registers indicates the availability of a camera feature or optional function Note that changing the video format or video mode may change the availability of a feature 0 feature not available 1 feature available Register Name Feature High Inquiry Offset from Base Address 0x404 Field Bit Description A311f A311 fc A312 A312fc Value Value Brightness 0 Brightness control availability 1 1 Auto Exposure 1 Auto exposure control availability 0 0 Sharpness 2 Sharpness control availability 0 0 White Balance 3 White balance control availability 0 1 Hue 4 Hue control availability 0 0 Saturation 5 Saturation control availability 0 0 Gamma 6 Gamma control availability 0 0 Shutter 7 Shutter speed control availability 1 1 Gain 8 Gain control availability 1 1 lris 9 Iris control availability 0 0 Focus 10 Focus control availability 0 0 Temperature 11 Temperature control availability 0 0 Trigger 12 Trigger control availability 1 1 Trigger Delay 13 Trigger delay control availability 0 0 Control White Shading 14 White shading control availability 0 0 Frame Rate 15 Frame rate prioritization control availability 0 0 16 Reserved BASLER A310f 4 9 Configuring the Camera Register Name Feature Low Inquiry Offset from Base Addre
79. address and the high BASLER A310f Basic Operation amp Standard Features byte is stored at the neighboring higher address The camera outputs raw data for each pixel The pixel data is not processed to account for the color filter When the 4 2 2 YUV ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 the camera outputs image data in the YUV 4 2 2 format at an average of 16 bits per pixel When the camera is operating in the YUV 4 2 2 or Raw 16 modes On the A3llfc with the AOI is set to full resolution the maximum frame rate is 50 3 fps On the A3I2tc with the AOI is set to full resolution the maximum frame rate is 35 8 fps The Raw 8 and Raw 16 color codings are defined in version 1 31 of the IIDC specifi cation Color code definitions can vary from camera model to camera model This is especially true for older models of Basler cameras Format 7 Mode 1 Format 7 Mode 1 is very similar to Format 7 Mode 0 with the exception of the available color codings and how the color codings work Format 7 Mode 1 is parameterized by using the Format 7 Mode 1 control and status registers see page 4 35 Color Codings In Format 7 Mode 1 only the Mono 8 color coding is available and the color coding works differently than the Mono 8 color coding available in Format 7 Mode 0 When the Mono 8 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 1 t
80. amera continuously exposes and transmits images The exposure of the first image begins after the Continuous Shot field of the ISO En Continuous Shot control register is set to 1 see page 4 18 The exposure time for each image is determined by the shutter settings described in Section 3 2 1 The start of exposure on the second and subsequent images is automatically controlled by the camera If the camera is operating in video Format 0 the rate at which images will be captured and transmitted is determined by the setting in the Frame Rate field of the Current Video Frame Rate Revision control register see page 4 16 If the camera is operating in video Format 7 the rate at which images will be captured and transmitted is determined by the setting in the Bytes Per Packet field of the Bytes Per Packet control register see Section 3 10 2 and page 4 32 Image exposure and transmission stop after the Continuous Shot field of the ISO En Continuous Shot control register is set to O These explanations of exposure start are included to give the user a basic insight into the interactions of the camera s registers Typically IEEE 1394 cameras are used with a driver which includes an interface that allows the user to parameterize and op erate the camera without directly setting registers The Basler BCAM 1394 Camera Driver for example has both a simple Windows interface and a programmer s API for parameterizing and operating the camera
81. as indicated in the drawings 0 2 62 gt 8 6 p A eS co E d N p N co N lo G Q 17 526 Y Y Photo sensitive 12 surface of the Lge Sandor Th 8x M4 6 deep 6 5 4 x M4 6 5 deep Figure 7 1 A310t Mechanical Dimensions in mm 7 2 BASLER A3l0f Mechanical Considerations 7 2 Sensor Positioning Accuracy The sensor positioning accuracy in the horizontal and vertical directions is as shown in Figure 7 2 Reference position is the side of the camera housing Rotational accuracy is also shown in Figure 7 2 Reference position is the center of the camera housing Reference Plane Tolerances are typical Drawings are not to scale Figure 7 2 Sensor Positioning Accuracy BASLER A310f 7 3 Mechanical Considerations 7 3 Maximum Lens Thread Length on the A310fc A3IIfc and A312fe cameras are normally equipped with a C mount lens adapter that contains an internal IR cut filter As shown in Figure 7 3 the thread length of the C mount lens used on the camera must be less than 7 5 mm If a lens with a longer thread length is used the IR cut filter will be damaged or destroyed and the camera wi
82. at earliest safe low when Signal high amp Signal goes high Signal goes moment to begin exposure for ignali goes high Signal goes at earliest safe low when exposure for capture N 1 at earliest safe low when moment to begin exposure for capture N 1 begins moment to begin exposure for exposure for capture N 3 exposure for capture N 2 capture N 3 begins M captureN 2 begins i 4 TrigRdy S H Signal Image Capture N Exposure Readout Image Capture N 1 Exposure Readout Image Capture N 2 Exposure Readout Image Capture N 3 Exposure Readout Time Figure 3 9 Trigger Ready Signal BASLER A310f Basic Operation amp Standard Features By default the TrigRdy signal is assigned to physical output port 1 on the camera See Section 2 5 2 for a description of the electrical characteristics of the camera s physical output ports The assignment of the TrigRdy signal to a physical output port can be changed See Section 6 7 11 for more information on changing the assignment of camera output signals to physical output ports D If you signal the camera to start an exposure when trigger ready is low the camera will simply ignore the signal If the camera is in continuous shot mode and external triggering is disabled the trig ger ready output signal will not be present BASLER A310f 3 17 Basic Operation amp Standard Features 3 18 3 2 10 In
83. ate and save live images that show the problem Also generate and save test images Please save the images in BMP format zip them and send them to Basler technical support BASLER A310f 8 3 Technical Support 8 4 BASLER A3l0f Revision History Revision History Doc ID Number Date Changes DA00066801 13 May 2004 Initial release of the manual DA00066802 2 March 2005 Added Sections 2 5 3 and 2 5 4 showing typical input circuit and typ ical output circuit digrams Added Section 3 2 7 to clarify the terminology used to describe frame readout buffering and transmission Updated the YUV formulas in Section 3 5 Reworded the white balance and color filter ID descriptions in Sec tions 3 5 1 and 3 5 2 for better clarity Added information about the new strobe time base feature to Sec tions 3 7 and 6 7 14 Added information about the new configuration sets and memory channels to Sections 3 12 4 4 and 6 7 12 Reformatted and expanded the register descriptions in Section 4 4 Added Section 5 describing image data formats and structures Corrected the CSR GUID for Output Port 3 configuration on page 6 35 DA00066803 18 December 2008 Updated front page and contact addresses Indicated IP30 conformity to Sections 1 2 and 7 Added storage temperature and humidity to Section 1 5 1 Added Do not remove the camera s serial number label paragraph to Section 1 6 Removed reference to TrigRdy and adjusted instructio
84. atus Registers for Basic Camera Operation Register Name Current Video Frame Rate Revision Offset from Base Address 0x600 Field Bit Description Frame Rate 0 2 If a camera is set for video Format 2 this field sets the current video Revision frame rate 0 frame rate 0 4 frame rate 4 1 frame rate 1 5 frame rate 5 2 frame rate 2 6 frame rate 6 3 frame rate 3 7 frame rate 7 Default 0 on all A310f cameras Check Sections 3 9 and 3 10 to determine the standard frame rates supported If the camera is set for Format 7 the setting in this field is ignored If the camera is set for Format 6 this field sets the current revision A310f cameras do not support Format 6 3 31 Reserved Register Name Current Video Mode Offset from Base Address 0x604 Field Bit Description Mode 0 2 This field sets the current video mode 0 mode 0 4 mode 4 1 mode 1 5 mode 5 2 mode 2 6 mode 6 3 mode 3 7 mode 7 Default 0 on all A310f cameras Check Sections 3 9 and 3 10 to determine the video modes supported by A310f cameras 3 31 Reserved 4 16 BASLER A310f Configuring the Camera Register Name Current Video Format Offset from Base Address 0x608 Field Bit Description Format 0 2 This field sets the current video format 0 format 0 6 format 6 1 format 1 7 format 7 2 format 2 Default 7 on all A310f cameras Check Sec
85. available for Format 7 only If you are operating the camera in Format 7 Mode 0 the flag is set in the Error Flag 1 field of the Value Setting register for Format 7 Mode 0 see page 4 34 If you are operating the camera in Format 7 Mode 1 the flag is set in the Error Flag 1 field of the Value Setting register for Format 7 Mode 1 see page 4 41 An error flag that indicates whether the current bytes per packet setting is acceptable to the camera This error flag is available for Format 7 only If you are operating the camera in Format 7 Mode 0 the flag is set in the Error Flag 2 field of the Value Setting register for Format 7 Mode 0 see page 4 34 If you are operating the camera in Format 7 Mode 1 the flag is set in the Error Flag 2 field of the Value Setting register for Format 7 Mode 1 see page 4 41 The error flag registers are defined in version 1 31 of the IIDC specification BASLER A310f Basic Operation amp Standard Features 3 12 Configuration Sets and Memory Channels A configuration set is a group of values that contains all on volatile of the register settings needed to control the camera Memory There are two basic types of configuration sets the cet Volatile emory work configuration set and the factory configuration set ue RAM gt lt _ gt Work Configuration Set T f Work Set The work configuration set contains the camera s current register settings and t
86. available on A310t cameras Each smart feature description includes the GUID assigned to the feature s CSR To determine the starting address of a smart feature s CSR the features CSR GUID must be written to the Smart Features Inquiry register The Smart Features Inquiry register s offset relative to the Advanced Features Access Control Register is 0x10 If the camera recognizes the GUID as the CSR GUID for an implemented smart feature the address of CSR for the feature can be read from the Smart Features Address Register at offset 0x20 If the feature isn t supported by the device a value of 0x0 will be read from the Smart Features Address Register Smart Features Inquiry Register Layout Bit Offset 0 7 8 15 16 23 24 31 10h D1 14h D3 D2 18h D4 3 D4 2 DA 1 D4 0 1ch D4 7 D4 6 D4 5 D4 4 Smart Features Address Register Layout Bit Offset 0 7 8 15 16 23 24 31 20h Address Low 24h Address High BASLER A310f Smart Features Example Determine the address of the CRC Checksum smart feature which has a CSR GUID of 3B34004E 1B84 11D8 83B3 00105A5BAE55 D1 Ox3B34 004E D2 0x1B84 D3 0x11D8 D4 0 0x83 D4 1 OxB3 D4 2 0x00 D4 3 0x10 D4 4 0x5A D4 5 Ox5B D4 6 OxAE D4 7 0x55 Step 1 Write the CSR GUID to the Smart Features Inquiry Register Assuming that the address for the Access Control Register is OXFFFF F2F0 0000 p
87. benzine and thinners they can damage the surface finish BASLER A3l0f Camera Interface 2 Camera Interface 2 1 Connections 2 1 1 General Description The A310f is interfaced to external circuitry via an IEEE 1394 socket and a 10 pin RJ 45 jack located on the back of the housing Figure 2 1 shows the location of the two connectors 10 pin RJ 45 Jack IEEE 1394 Socket Figure 2 1 Camera Connectors BASLER A310f 2 1 Camera Interface 2 1 2 Pin Assignments The IEEE 1394 socket on the camera is used to supply power to the camera and to interface video data and control signals The pin assignments for the socket are shown in Table 2 1 Pin Signal k Power Input 8 0 to 36 0 VDC DC Gnd TPB TPB TPA JAJAJ OJIN TPA Table 2 1 Pin Assignments for the IEEE 1394 Socket Caution The polarity of the input power to the camera must be as shown in Table 2 1 Do not reverse the input power polarity Reversing the polarity will damage the camera The 10 pin RJ 45 jack on the camera is used to access the four physical input ports and four physical output ports on the camera The pin assignments for the jack are shown in Table 2 2 Pin Designation Output Port 3 Output Port 2 Output Port 1 Output Port 0 Input Port 0 In Gnd Comm Out VCC Comm Input Port 2 c oj o oc1 m c0o rnm
88. bit 4 4 1 1 Initialize Inquiry Register Register Name Camera Initialize Offset from Base Address 0x000 Field Bit Description Initialize 0 If you set this bit to 1 the camera will reset itself break any state lock and re initialize itself to the settings in the currently assigned startup memory channel see Sections 3 12 and 6 7 12 The bit is self cleared 1 31 Reserved 4 4 1 2 Inquiry Registers for Video Formats Each bit in the video format inquiry register indicates the availability of a specific format 0 format not available 1 format available Register Name Video Format Inquiry Offset from Base Address 0x100 Field Name Bit Description A311f A311fc A312f A312fc Value Format 0 0 VGA non compressed format 1 Format 1 1 Super VGA non compressed format 1 0 Format 2 2 Super VGA non compressed format 2 0 Format x 3 5 Reserved Format 6 6 Still image format 0 Format 7 7 Partial image size format 1 Ea 8 81 Reserved zs BASLER A310f 4 3 Configuring the Camera 4 4 1 3 Inquiry Registers for Video Modes Each bit in the video mode inquiry register indicates the availability of a specific video format and mode combination e g Format 0 Mode 0 0 not available 1 available Register Name Video Mode Inquiry for Format 0 Offset from
89. ble and no image capture can be started This field is updated whenever a value is written in the Bytes per Packet register 10 31 Reserved BASLER A310f Configuring the Camera 4 4 2 5 Control and Status Registers for Format 7 Mode 1 Format 7 Mode 0 is available on A3llfe and ASI2tc cameras only The base address for each Format 7 Mode 1 camera control register is Bus ID Node ID FFFF F1F0 0100 In each Format 7 Mode 0 register description an Offset from the Base Address is provided This is a byte offset from the above base address The address of a Format 7 Mode 1 register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as Ox e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit Register Name Max Image Size Inquiry Offset from Base Address 0x000 Field Bit Description Hmax 0 15 Indicates the maximum horizontal image size in pixels Hmax 658 on the A311fc Hmax 780 on the A312fc Vmax 16 31 Indicates the maximum vertical image size in pixels Vmax 492 on the A311fc Vmax 580 on the A312fc Register Name Unit Size Inquiry Offset from Base Address Field Bit 0x004 Description Hunit 0 15 Indicates the increment in columns for adjusting the area of interest width see Section 3 4 For example if the Hunit is 2 the width
90. bsolute value control is not available on A310f cameras This field is read only 2 4 Reserved One Push 5 Sets One Push operation The value will be 0 indicating that one push is not in operation One push operation is not available on A310f cameras This field is read only On Off 6 Sets whether shutter control is on or off The value will be 1 indicating that shutter control is on The shutter control feature can t be switched off on A310f cameras This field is read only A M Mode 7 Sets whether the camera is in automatic or manual shutter control mode The value will be 0 indicating that shutter control is in manual mode Automatic shutter control is not available on A310f cameras This field is read only 8 19 Reserved Value 20 31 Sets the shutter value The shutter value can range from 1 to 4095 Exposure time Shutter Value Setting x Shutter Time Base Default 500 on the A311f and A312f Default 750 on the A311fc and A312fc Notes The shutter time base is normally 20 us but it can be adjusted by using the shutter time base smart feature See Sections 3 2 1 and 6 7 13 for more information BASLER A310f 4 23 Configuring the Camera Register Name Gain Offset from Base Address 0x820 Field Bit Description Presence Inq 0 Indicates the presence of the gain control feature The value will be 1 on all A310f cameras indicating that gain control
91. by one for each new image acquisition The mathematical expression for test image three at 8 bit output Gray value x y counter MOD 256 Test Image Three Moving Diagonal Gray Gradient in Mono 16 Test image three is similar to test image one but it is not stationary The image moves by one pixel from right to left whenever a one shot or a continuous shot command signal is sent to the camera The test pattern uses a counter that increments by one for each new image acquisition The mathematical expression for test image three at 16 bit output 12 bit effective Gray value x y counter MOD 256 x 16 BASLER A310f 6 23 Smart Features 6 24 Control and Status Register for the Test Image Feature Name Test Images Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 2A411342 COCA 4368 B46E EESDEEBF0548 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 7 Reserved Image Inq 1 8 Presence of test image 1 Read only 0 Not Available 1 Available Image Inq 2 9 Presence of test image 2 Read only 0 Not Available 1 Available Image Inq 3 10 Presence of test image 3 Read only 0 Not Available 1 Available Image Inq 4 11 Presence of test image 4 Read only 0 Not Available 1 Available Image Inq 5 12 Presence of test image 5 Read only 0 Not Available 1
92. byte offset from the above base address The address of a Format 7 Mode 0 register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as Ox e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit Register Name Max Image Size Inquiry Offset from Base Address 0x000 Field Bit Description Hmax 0 15 Indicates the maximum horizontal image size in pixels Hmax 659 on the A311f Hmax 658 on the A311fc Hmax 782 on the A312f Hmax 780 on the A312fc Vmax 16 31 Indicates the maximum vertical image size in pixels Vmax 494 on the A311f Vmax 492 on the A311fc Vmax 582 on the A312f Vmax 580 on the A312fc Register Name Unit Size Inquiry Offset from Base Address 0x004 Field Bit Description Hunit 0 15 Indicates the increment in columns for adjusting the area of interest width see Section 3 4 For example if the Hunit is 2 the width should be set in increments of 2 Hunit 1 on the A311f and A312f Hunit 2 on the A311fc and A312fc Vunit 16 31 Indicates the increment in rows for adjusting the area of interest height see Section 3 4 For example if the Vunit is 1 the height should be set in increments of 1 Vunit 1 on the A311f and A312f Vunit 2 on the A311fc and A312fc 4 28 BASLER A310f Configuring the Camera Register Nam
93. c A312f A312fc Value Value Mono 8 0 Y only 8 bits non compressed 1 1 ID 0 4 1 1 YUV8 1 4 4 1 YUV 8 bits component non compressed 0 0 ID 1 4 2 2 YUV 8 2 4 2 2 YUV 8 bits component non compressed 0 1 ID 2 4 4 4 YUV 8 3 4 4 4 YUV 8 bits component non compressed 0 0 ID 3 RGB 8 4 RGB 8 bits component non compressed 0 0 ID 4 Mono 16 5 Y only 16 bits non compressed 1 0 unsigned integer ID 5 RGB 16 6 RGB 16 bits component non compressed 0 0 unsigned integer ID 6 Signed Mono 16 7 Y only 16 bits non compressed 0 0 signed integer ID 7 Signed RGB 16 8 RGB 16 bits component non compressed 0 0 signed integer ID 8 Raw 8 9 8 bit raw data output from a color filter sensor 0 1 ID 9 Raw 16 10 16 bit raw data output from a color filter sensor 0 1 ID 10 11 31 Reserved es ues If a bit is set to 0 the camera does not support this color coding ID in Format 7 Mode 0 If a bit is set to 1 the camera supports this color coding ID in Format 7 Mode 0 BASLER A310f Configuring the Camera Register Name Pixel Number Inquiry Offset from Base Address 0x034 Field Bit Description Pixels Per Frame 0 31 Indicates the total number of pixels per frame The value in this register depends on settings in the Format 7 Mode 0 Image Size register see page 4 29 Register Name Total Bytes High Inquiry High
94. d The number at location 8 in the table represents the 8 bit value that will be transmitted out of the camera when the sensor reports that a pixel has a value of 8 The numbers at locations 9 through 15 are not used The number at location 16 in the table represents the 8 bit value that will be transmitted out of the camera when the sensor reports that a pixel has a value of 16 The numbers at locations 17 through 23 are not used The number at location 24 in the table represents the 8 bit value that will be transmitted out of the camera when the sensor reports that a pixel has a value of 24 And soon As you can see the table does not include an 8 bit output value for every pixel value that the sensor can report So what does the camera do when the sensor reports a pixel value that is between two values that have a defined 8 bit output In this case the camera performs a straight line interpolation to determine the 8 bit value that it should transmit For example assume that the sensor reports a pixel value of 12 In this case the camera would perform a straight line interpolation between the values at location 8 and location 16 in the table The result of the interpolation would be reported out of the camera at an 8 bit depth Another thing to keep in mind about the table is that location 4088 is the last location that will have a usable 8 bit value associated with it Locations 4089 to 4095 are not used If the sensor re
95. d by using the strobe time base smart feature See Sections 3 7 and 6 7 14 for more information Register Name Strobe 1 Control Field Offset from Base Address Bit 0x204 Description Same definitions and values as Strobe 0 Control BASLER A310f 4 45 Configuring the Camera 4 46 Register Name Strobe 2 Control Offset from Base Address 0x208 Field Bit Description Same definitions and values as Strobe 0 Control Register Name Strobe 3 Control Offset from Base Address 0x20C Field Bit Description Same definitions and values as Strobe 0 Control D If a strobe signal is on the signal will only be present on the associated output port if the output port is configured for strobe For example if the Strobe 0 signal is on the signal will only be present on physical output port 0 if the port is configured for strobe If the Strobe 1 signal is on the signal will only be present on physical output port 1 if the port is configured for strobe Etc See Section 6 7 11 for more information about configuring the output ports BASLER A3l0f Configuring the Camera 4 4 3 Advanced Features Registers The base address for all advanced features registers is Bus ID Node ID FFFF F2F0 0000 The first eight quadlets of the advanced features register space is designated as the advanced features Access Control Register as
96. d in version 1 31 of the IIDC specification The Basler BCAM 1394 Driver does not include a method call to access the software trigger feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the Software Trigger and Trigger Mode registers Contact Basler technical support to ob tain the Smart Features Framework Software Why Use the Software Trigger At first glance using the software trigger feature to start image exposure appears to be equivalent to just issuing a shot command as described in Section 3 2 3 The difference is in the way the camera reacts to each method With a shot command there will be some delay between the One Shot field in the One Shot Multi Shot control register being set to 1 or the Continuous Shot field in the ISO En Continuous Shot control register being set to 1 and the actual start of exposure time This delay is required so that the camera can be properly set up to react to the receipt of the shot command With the software trigger method there is no delay between the Trigger field being set to 1 and the start of exposure Exposure begins immediately when the field value is set So the advantage of the software trigger feature is that it gives you more precise control of exposure start BASLER A310f 3 7 Basic Operation amp Standard Features 3 8 3 2 5 Controlling Exposure Start with an ExTr
97. d with the checksum and the upper 16 bits of the chunk are filled with zeros Bit Description 0 7 CRC Checksum low byte 8 15 CRC Checksum high byte 16 23 0x00 24 31 0x00 Using the Checksum to Check the Data Integrity When the checksum smart feature is enabled the following two C functions can be used to check if an acquired frame contains a valid CRC checksum The user must pass the acquired image buffer and the buffer s length in bytes to the CheckBuffer function The CheckBuffer function uses the CRC16 function to calculate the checksum These two samples are intended to aid you in developing the code for your application They are provided solely as examples brief Calculates a 16 bit CRC checksum param pData Pointer to the data buffer param nbyLength Size of the buffer in bytes return The CRC checksum 7 unsigned short CRC16 const unsigned char pData unsigned long nbyLength unsigned long i j c bit unsigned long crc 0 for i 0 i lt nbyLength i c unsigned long pData for j 0x80 j j gt gt 1 bit crc amp 0x8000 cre lt lt 1 if c amp j bit 0x8000 if bit crc 0x1021 return unsigned short crc amp Oxffff BASLER A310f 6 17 Smart Features Vorief Verifies a frame buffer s CRC checksum param pData Pointer to the frame param nbyLength Size of frame in bytes return 1 if the check succeeds 0 oth
98. does not implement the feature set associated with that Feature ID Assuming that the address of the Advanced Features Access Control Register is OxFFFF F2F0 0000 perform the following steps to see if a camera is smart features capable 1 Write the quadlet data 0x0030 533B to OxFFFF F2F0 0000 2 Write quadlet data 0x73C3 F000 to OxFFFF F2F0 0004 3 Read quadlet data from OxFFFF F2F0 0000 and OxFFFF F2F0 0004 If at least one of the read operations returns a value that is not equal to OXFFFF FFFF the camera supports smart features If both read operations return OXFFFF FFFF the camera does not support smart features Note that instead of performing two single quadlet write operations a block write can be performed The last three zeros in this quadlet represent a timeout value When the timeout value is 000 as it is on A3IOf cameras it means that advanced features are always available BASLER A310f 6 3 Smart Features 6 5 2 Determining the Address of a Smart Feature s CSR The control and status register CSR for each smart feature is identified by a 128 bit Globally Unique Identifier GUID GUIDs are also known as UUIDs Universal Unique Identifier A GUID consists of One 32 bit number D1 Two 16 bit numbers D2 D3 A sequence of 8 bytes D4 0 D4 7 GUID example CA8A916A 14A4 4D8E BBC9 93DF50495C16 D1 D2 D3 D4 0 D4 1 D4 2 D4 7 Section 6 7 describes the standard smart features
99. e Image Position Offset from Base Address 0x008 Field Name Bit Description Left 0 15 Sets the left starting column of pixels for the area of interest see Sec tion 3 4 Default 0 on all A310f cameras Top 16 31 Sets the top row of pixels for the area of interest see Section 3 4 Default 0 on all A310f cameras Register Name Image Size Offset from Base Address 0x00C Field Bit Description Width 0 15 Sets the width in columns for the area of interest see Section 3 4 Default 659 on the A311f Default 658 on the A311fc Default 782 on the A312f Default 780 on the A312fc Height 16 31 Sets the height in rows for the area of interest see Section 3 4 Default 494 on the A311f Default 492 on the A311fc Default 2 582 on the A312f Default 2 580 on the A312fc Register Name Color Coding ID Offset from Base Address 0x010 Field Bit Description Coding ID 0 7 Sets the color coding Valid color codings for Format 7 Mode 0 are listed in the Color Coding Inquiry register see the next register de scription Default ID 0 on the A311f and A312f Default ID 2 on the A311fc and A312fc 8 81 Reserved BASLER A3IOf 4 29 Configuring the Camera Register Name Color Coding Inquiry Offset from Base Address 0x014 Field Name Bit Description A311f A311f
100. e camera is configured for external triggering It will not be present if the camera is configured for software triggering As described in Section 3 2 8 you can operate the camera in an overlapped exposure fashion When operating the camera in this manner it is especially important that exposure of a new image not start until exposure of the previous image has ended and exposure of the new image not end until readout of the previous image is complete All A310f cameras supply a Trigger Ready TrigRdy you can use to ensure that these conditions are met When you are capturing images the camera automatically calculates the earliest moment it is safe to begin each new exposure The trigger ready signal will go low when an exposure is started and will go high again when it is safe for the next exposure to begin see Figure 3 9 The camera calculates the rise of the trigger ready signal based on the current shutter settings the current size of the area of interest and the time it will take to read out the captured pixel values from the sensor The trigger ready signal is especially useful if you want to run the camera at the maximum frame rate for the current conditions If you monitor the trigger ready signal and you begin the exposure of each new image immediately after the signal goes high you will be sure that the camera is operating at the maximum frame rate for the current conditions Signal goes high Signal goes
101. eceive the transmitted images BASLER A3l0f 6 7 Smart Features Standard Smart Features on the A310f 6 7 1 Extended Data Stream The extended data stream feature has two functions Whenit is enabled information such as image height image width and AOI size is added to the basic pixel data for each image t must be enabled before you can use any other smart feature that adds information to the image data stream With the extended data stream feature enabled the basic pixel data for each image and the added information such as the image height and width are included in an extended data chunk Refer to the extended data chunk layout below for a complete description of the information included in the extended data chunk smart feature that adds information to the image data stream Disabling the extended data stream feature switches off all smart features that add information to the image data stream The extended data stream feature must be enabled in order to use any of the other The extended data stream feature and any other smart features which add informa tion to the image data stream will only work when the camera is set for video format 7 Control and Status Register for the Extended Data Stream Feature Name Extended Data Stream Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 4E7ABCBO 1B84 11D8 9651 00105A5BAE55 Field Bit
102. ee Section 3 2 9 for more about TrigRdy 4 When ExTrig rises exposure will begin Exposure will continue for the length of time you specified in step 1 5 Atthe end of the specified exposure time readout and transmission of the captured image will take place 6 Repeat steps 3 and 4 each time you want to begin exposure and capture an image 7 To disable continuous shot operation set the Continuous Shot field in the ISO En Continuous Shot control register to 0 These explanations of exposure start are included to give the user a basic insight into the interactions of the camera s registers Typically IEEE 1394 cameras are used with a driver which includes an interface that allows the user to parameterize and op erate the camera without directly setting registers The Basler BCAM 1394 Camera Driver for example has both a simple Windows interface and a programmer s API for parameterizing and operating the camera On A310f cameras exposure of a new image can begin while the previous image is being read out This is commonly referred to as overlap mode Following the recom mended method for exposure start in Section 3 2 6 will allow you to overlap exposure with readout and achieve the camera s maximum frame rate For more information about overlap mode see Section 3 2 8 BASLER A310f 3 11 Basic Operation amp Standard Features 3 2 6 Recommended Method for Controlling Exposure S
103. ee 7 4 level controlled exposure mode 3 9 lookup table smart feature 6 26 lossless compression smart feature 6 31 M mechanical considerations 7 1 8 1 models camera 0 cece eee ees 1 3 mounting facilities sees 7 2 N non overlapped exposure 3 14 Index O one shot operation with a shot command sss 3 4 with a software trigger 3 5 with an external trigger signal 3 10 output circuit samples esses 2 8 output port configuration smart feature 6 33 OUTPUT DOITS Leser Saree Sa ie eh ee 2 5 overlapped exposure 2245 3 14 P packet payloads e eee eee ee 5 3 parallel I O control 0 cee ee eee 3 34 performance specifications 1 2 pin assignments 0 eee eee ee 2 2 pixel depth 2 ec eee eee 3 31 pIXel SIZG as iex a td E Ae ee a 1 2 power requirements 0 1 2 2 4 precautions 4 neue re en E RR Rd 1 6 programmable exposure mode with a software trigger 3 5 with an external trigger signal 3 8 R registers implemented in the camera 4 3 4 47 return material authorization 8 1 RMA number 2 02000 eee eens 8 1 S sensor pixel size eel Ree e elER ia 1 2 positioning accuracy 7 3
104. ent settings IDO ID 1 ID 2 ID 3 First pixel in the first row R G G B Second pixel in the first row G B R G First pixel in the second row G R B G Second pixel in the second row B G G R Table 3 2 Color Filter IDs The Color Filter ID register for Format 7 is defined in version 1 31 of the IIDC speci fication The Basler BCAM 1394 Driver does not include a method call to access the color filter ID feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the Filter ID field Contact Basler technical support to obtain the Smart Features Frame work Software 3 5 3 Integrated IR Cut Filter A310fc color cameras are equipped with an IR cut filter as standard equipment The filter is mounted in the lens adapter Cameras without an IR cut filter are available on request Caution The location of the filter limits the thread length of the lens that can be used on the camera The thread length on your lens must be less than 7 5 mm If a lens with a longer thread length is used the camera will be damaged and will no lon ger operate See Section 7 3 for more details 3 30 BASLER A310f 3 6 Basic Operation amp Standard Features Selectable 8 or 12 Bit Pixel Depth When an A310fc camera is operating in Format 7 it can be set to output pixel data at either 8 bit or
105. erform the following quadlet write operations to the Smart Features Inquiry Register a Write quadlet data 0x3B34 004E to OxFFFF F2F0 0010 D1 b Write quadlet data 0x11D8 1B84 to OxFFFF F2F0 0014 D3 D2 c Write quadlet data 0x1000 B383 to OxFFFF F2F0 0018 D4 3 D 0 d Write quadlet data Ox55AE 5B5A to OxFFFF F2F0 001C D4 7 D 4 Instead of performing four quadlet write operations one block write operation can be performed Step 2 Read the start address for the smart feature from the Smart Features Address Register a Read quadlet data from OxFFFF F2F0 0020 Address Low b Read quadlet data from OxFFFF F2F0 0024 Address High If both Address Low and Address High return zero the camera doesn t support the CRC checksum feature Assuming the read operations yielded Address Low OxF2F0 0038 and Address High 0x0000 FFFF the CRC Checksum feature CSR s address is OXFFFF F2F0 0038 BASLER A310f 6 5 Smart Features 6 5 3 Enabling and Parameterizing a Smart Feature Once you have determined the starting address of the control and status register CSR for your desired smart feature you are ready to enable and parameterize the feature by setting bits within the CSR Section 6 7 describes the standard smart features available on A310f cameras Each smart features description includes an explanation of what the feature does and an explanation of the parameters associated with the feature The descriptions also include a deta
106. erial without an RMA number we reserve the right to reject the material You can find detailed information about how to obtain an RMA number on the Basler website at www baslerweb com beitraege beitrag en 79701 html Before Calling Basler Technical Support When a problem has occurred and if you can access the camera check the error flags see Section 3 11 as the first step toward solving the problem yourself If you can t solve the problem contact Basler technical support To help you as quickly and efficiently as possible when you have a problem with a Basler camera itis important that you collect several pieces of information before you contact technical support Copy the form that appears on pages 8 2 and 8 3 or download it from the support section of www baslerweb com and fill it out use an extra sheet of paper if necessary Fax the page to your local dealer or to your nearest Basler support center Or you can write an e mail listing the requested pieces of information and with the requested files attached Our technical support contact numbers are shown in the front section of this manual BASLER A310ff 8 1 Technical Support 1 The camera s product ID 2 The camera s serial number 3 1394 adapter that you use with the camera 4 Describe the problem in as much detail as possible If you need more space use an extra sheet of paper 5 If known what s the cause of the problem
107. erly on any input voltage from 8 0 VDC to 36 0 VDC as specified in the IEEE 1394 standard Maximum power consumption for the A310f is 3 W at 12 VDC Ripple must be less than 1 96 Caution Use only standard IEEE 1394 connectors The polarity of the input power to the camera must be as shown in Table 2 1 Do not reverse the input power polarity Reversing the polarity will damage the camera 2 4 IEEE 1394 Device Information The A3l0f uses an IEEE 1394a 2000 compliant physical layer device to transmit pixel data Detailed spec sheets for devices of this type are available at the Texas Instruments web site www ti com 2 4 BASLER A310f 2 5 Camera Interface Input and Output Ports 2 5 1 Input Ports A310f cameras are equipped with four physical input ports designated as Input Port 0 Input Port 1 Input Port 2 and Input Port 3 The input ports are accessed via the 10 pin RJ 45 jack on the back of the camera See Table 2 2 and Figure 2 2 for input port pin assignments and pin numbering As shown in the schematic in Figure 2 3 each input port is opto isolated The nominal input voltage for the LED in the opto coupler is 5 0 V 1 0 V The input current for the LED is 5 to 15 mA with 10 mA recommended For each input port a current between 5 and 15 mA means a logical one A current of less than 0 1 mA means a logical zero By default Input Port 0 is assigned to receive an external trigger ExTrig signal that
108. erwise int CheckBuffer const unsigned char pData unsigned long nbyLength unsigned long nCurrentCRC nDesiredCRC Calculate the CRC checksum of the buffer Don t take the last four bytes containing the checksum into account nCurrentCRC CRC16 pData nbyLength sizeof unsigned long Retrieve the desired CRC value from the data buffer nDesiredCRC unsigned long pData nbyLength sizeof unsigned long 1 Return TRUE if they are equal return nCurrentCRC nDesiredCRC 6 18 BASLER A3l0f Smart Features 6 7 6 Test Images A310t cameras include a test image mode as a smart feature The test image mode is used to check the camera s basic functionality and its ability to transmit an image via the video data cable The test image mode can be used for service purposes and for failure diagnostics In test mode the image is generated with a software program and the camera s digital devices and does not use the optics the CMOS pixel array or the ADCs Test images one two and three are available on all A310f cameras When a test image is active the gain brightness and exposure time have no effect on the image The test image smart feature does not add information to the image data stream and can be enabled even when the extended data stream feature see Section 6 7 1 is disabled The test image feature will work when the camera is set for any valid video format Test Image One
109. es the increment in columns for adjusting the area of interest starting column see Section 3 4 For example if the Hposunit is 2 the starting column should be adjusted in increments of 2 Hposunit 1 for the A311f and A312f Hposunit 2 for the A311fc and A312fc Vposunit 16 31 Indicates the increment in rows for adjusting the area of interest start ing row see Section 3 4 For example if the Vposunit is 1 the starting row should be adjusted in increments of 1 Vposunit 1 for the A311f and A312f Vposunit 2 for the A311fc and A312fc BASLER A3l0f Configuring the Camera Register Name Frame Interval Inquiry Offset from Base Address 0x050 Field Bit Description Frame Interval 0 81 Indicates the current frame period in seconds This value will be up dated when you adjust any register that affects the frame period The value in this register is a standard IEEE 754 single precision 32 bit floating point number Register Name Data Depth Inquiry Offset from Base Address 0x054 Field Bit Description Data Depth 0 7 Indicates the effective depth of the data in the transmitted images The value in this register depends on the setting in the Format 7 Mode 0 Color Coding ID register see page 4 29 This field is read only Color Coding ID setting Effective data depth indicated ID 0 Mono 8 8 bits pixel ID 2 YUV 4 22 8 bits component ID 5
110. f Configuring the Camera BASLER A310f Register Name Trigger Mode Offset from Base Address 0x830 Field Bit Description Presence Inq 0 Indicates the presence of the trigger mode control feature The value will be 1 on all A310f cameras indicating that trigger mode control is available This field is read only Abs Control 1 Determines whether the trigger mode will be controlled by the Value field of this register or by the Absolute Value CSR for the trigger mode The value will be 0 indicating that the trigger mode can only be con trolled by the Value field of this register Absolute value control is not available on A310f cameras This field is read only 24155 Reserved On Off 6 Sets whether trigger mode control is on or off 0 trigger mode control is on 1 trigger mode control is off Default 0 on all A310f cameras Trigger Polarity T Sets the trigger polarity when the camera is using a hardware trigger 0 low active input 1 high active input Default 1 on all A310f cameras Trigger Source 8 10 Sets the trigger source 0 External trigger signal applied to physical input port 0 1 External trigger signal applied to physical input port 1 2 External trigger signal applied to physical input port 2 3 External trigger signal applied to physical input port 3 7 Software trigger Default 0 on all A310f cameras Trigger Value 11 Not used on A310f cameras This bit sho
111. f Introduction 1 Introduction 1 1 Documentation Applicability This User s Manual applies to cameras with a firmware ID number of 31 Cameras with a lower or a higher firmware ID number may have fewer features or have more features than described in this manual Features on cameras with a lower or a higher firmware ID number may not operate exactly as described in this manual An easy way to see the firmware ID number for an A310f camera is by using the BCAM Viewer included with the Basler BCAM 1394 driver To see the firmware ID number 1 2 Attach your camera to a computer equipped with the BCAM 1394 driver Double click the BCAM Viewer icon on your desktop or click Start gt All Programs Basler Vision Technologies BCAM 1394 BCAM Viewer The viewer program window will open Find the camera name in the Bus Viewer panel that appears on the left side of the Info Video Format Trigger Advanced Features window and click on the Properties camera name Model ASTU i F x Vendor Bash Click on the icon in the a tool bar at the top of the Node ID 0003053111111111 This is the wi ndow Driver Version 1 7 0013 idiota A properties window similar to the one shown in Figure 1 1 will open Use the figure as a Device Name BASLER8A311FHC76B9F06533000 guide to find the firmware ID number Firmware Version 101657 01 mk2c6_A311f v1 cag f81 ox Abbrechen Figure 1 1 BCAM
112. fectively on little endian hard ware such as Intel processor based PCs When the camera is set for 16 bit output 16 bits of data will be transmitted for each pixel but only 12 bits are effective see Section 3 6 BASLER A310f 5 3 4 Data Format with the Camera Set for Raw 8 Output Image Data Structures amp Formats The tables below describe how the data for the odd lines and for the even lines of a received frame will be ordered in the image buffer in your PC The following standards are used in the tables Po the first pixel transmitted by the camera for a line P the last pixel transmitted by the camera a line Bg the first byte of data for a line Bm the last byte of data for a line For Filter ID 0 RG GB Even Lines Odd Lines Byte Data Byte Data Bo Red value for Pg Bo Green value for Po B4 Green value for P4 B4 Blue value for P Bo Red value for P2 Bo Green value for P5 B3 Green value for P3 B3 Blue value for P3 B4 Red value for P4 B4 Green value for P4 B5 Green value for P5 B5 Blue value for P5 e e e e e e e e e e e e Bm 5 Red value for Ph 5 Bm 5 Green value for Ph 5 Bm 4 Green value for Ph 4 Bm 4 Blue value for Ph 4 Bm 3 Red value for Ph 3 Bm 3 Green value for Ph 3 Bm 2 Green value for Ph 2 Bm 2 Blue value for Pu Bm 1 Red value for Py Bm 1 Green value for P 4 Bm Green value for Ph Bm Blue value for P BASLER A
113. g devices such as fans or heat sinks are not normally required but should be provided if necessary Precautions To ensure that your warranty remains in force Do not remove the camera s serial number label If the label is removed and the serial number can t be read from the camera s registers the warranty is void Read the manual Read the manual carefully before using the camera Keep foreign matter outside of the camera Do not open the camera housing Touching internal components may damage them Be careful not to allow liquid flammable or metallic material inside the camera housing If operated with any foreign matter inside the camera may fail or cause a fire Electromagnetic Fields Do not operate the camera in the vicinity of strong electromagnetic fields Avoid electrostatic charging Transporting Transport the camera in its original packaging only Do not discard the packaging Cleaning Avoid cleaning the surface of the CCD sensor if possible If you must clean it use a soft lint free cloth dampened with a small quantity of high quality window cleaner Because electrostatic discharge can damage the CCD sensor you must use a cloth that will not generate static during cleaning cotton is a good choice To clean the surface of the camera housing use a soft dry cloth To remove severe stains use a soft cloth dampened with a small quantity of neutral detergent then wipe dry Do not use volatile solvents such as
114. g in the Duration Value field of the Strobe 0 Control register is set to 250 0xOFA for example the Strobe 0 duration will be 250 1024 ms or approximately 244 1 us The strobe duration will determine the duration of the strobe signal as shown in Figure 3 15 As mentioned above the strobe duration time base is normally fixed at 1 1024 ms and the Strobe 0 duration is normally adjusted by changing the duration value setting only However if you require a duration that is longer than what you can achieve by changing the strobe duration value alone the strobe duration time base can also be changed The Strobe Time Base smart feature can be used to change the strobe duration time base For more information on changing the strobe delay time base see Section 6 7 14 Assigning the Strobe 0 Signal to a Port Once the Strobe 0 output signal has been enabled and parameterized it must be assigned to a physical output port on the camera The Strobe 0 signal can only be assigned to physical output port 0 Strobe output signals are assigned to physical ports by using the Output Port Configuration smart feature See Section 6 7 11 for information on assigning strobe output signals to physical output ports If you enable the Strobe 1 Strobe 2 and Strobe 3 output signals you must also use the Output Port Configuration smart feature to assign these signals to physical output ports on the camera The Strobe 1 signal can only be assigned to physical output po
115. gure 3 15 As mentioned above the strobe delay time base is normally fixed at 1 1024 ms and the Strobe 0 delay is normally adjusted by changing the delay value setting only However if you require a delay that is longer than what you can achieve by changing the strobe delay value alone the strobe delay time base can also be changed The Strobe Time Base smart feature can be used to change the strobe delay time base For more information on changing the strobe delay time base see Section 6 7 14 High Active Strobe Signal Low Active Strobe Signal j Duration Delay Delay gt Duration Shutter Start Shutter Start start of image exposure start of image exposure Figure 3 15 Strobe Signal BASLER A310f Basic Operation amp Standard Features Setting the Duration for Strobe 0 The strobe duration is determined by a combination of two values The first is the setting in the Duration Value field of the Strobe 0 Control register see page 4 45 The second is the Strobe Duration Time Base Strobe 0 duration will be determined by the product of these two values Strobe 0 Duration Strobe 0 Duration Value Setting x Strobe Duration Time Base The strobe duration time base is fixed at 1 1024 ms by default Strobe 0 duration is normally adjusted by changing the setting in the Duration Value field of the Strobe 0 Control register The duration value setting can range from 0 to 4095 0x000 to OxFFF So if the settin
116. he Mono 16 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 the camera outputs 16 bits per pixel but only 12 bits are effective The effective pixel data fills from the LSB and the unused bits are filled with zeros Pixel data is stored in the PC memory in little endian format i e the low byte for each pixel is stored at the lower address and the high byte is stored at the neighboring higher address BASLER A3l0f Basic Operation amp Standard Features 3 10 Available Video Formats Modes amp Frame Rates on Color Cameras 3 10 1 Standard Formats Modes amp Frame Rates The following standard video formats modes and frame rates are available on A3llfe and A312fc color cameras Format 0 Mode 1 FrameRate 0 Format 0 Mode 1 FrameRate 1 Format 0 Mode 1 FrameRate 2 Format 0 Mode 1 FrameRate 3 Format 0 Mode 1 FrameRate 4 Format 0 Mode 1 FrameRate 5 Format 0 Mode 3 FrameRate 0 Format 0 Mode 3 FrameRate 1 Format 0 Mode 3 FrameRate 2 Format 0 Mode 3 FrameRate 3 Format 0 Mode 3 FrameRate 4 Format 0 Mode 5 FrameRate 0 Format 0 Mode 5 FrameRate 1 Format 0 Mode 5 FrameRate 2 Format 0 Mode 5 FrameRate 3 Format 0 Mode 5 FrameRate 4 Format 0 Mode 5 FrameRate 5 Format 0 Mode 6 FrameRate 0 Format 0 Mode 6 FrameRate 1 Format 0 Mode 6 FrameRate 2 Format 0 Mode 6 FrameRate 3 Format 0 Mode 6 FrameRate 4 320 x 240 YUV 4 2 2 16 bits pixel avg 1 875 fps
117. he camera outputs 8 bits per pixel and outputs the raw data for each pixel The pixel data is not processed to account for the color filter This type of output is sometimes called Bayer 8 This mode of operation is included on the A3llfe and A312fc for compatibility with versions 1 6 and below of the Basler BCAM 1394 driver software These early versions of the BCAM software cannot properly access the Raw 8 color coding Instead they require a Mono 8 color coding that results in the output of raw pixel data BASLER A310f 3 39 Basic Operation amp Standard Features 3 11 Error Flags 3 40 A310f cameras support the following error flags Error flags that indicate whether the current trigger shutter gain brightness and white bal ance settings are outside the specified range of allowed values These error flags are set in the Trigger Shutter Gain Brightness and White Balance fields of the Feature Control Error Status High register see page 4 26 An error flag that indicates whether the current combination of the following settings is acceptable to the camera Video format Mode Frame rate SO speed This error flag is available for Format 0 only and is set in the Vmode Error Status register see page 4 19 An error flag that indicates whether the current combination of the following settings is acceptable to the camera Image position mage size Color coding ID SO speed This error flag is
118. his register depends on the setting in the Format 7 Mode 1 Color Coding ID register see page 4 36 This field is read only Color Coding ID setting Effective data depth indicated ID 0 Mono 8 8 bits pixel 8 31 Reserved Register Name Color Filter ID Offset from Base Address 0x058 Field Bit Description Filter ID 0 7 Indicates the alignment of the camera s color filter to the current AOI This field is valid for cameras equipped with an RGB primary color filter such as the A311fc or A312fc See Sections 3 4 and 3 5 2 Value in this field Pixel color order 0 RG GB 1 GB RG 2 GR GB 3 BG GR 8 31 Reserved 4 40 BASLER A310f Configuring the Camera Register Name Value Setting Field Offset from Base Address Bit 0x07C Description Presence Inq 0 Indicates whether the fields in this register are valid 0 not valid 1 valid The fields in this register are valid on A311fc and A312fc cameras The Presence Inq field is read only Setting 1 On A310f cameras this field is not relevant and should be ignored Updates to the register values monitored by this field are performed automatically Reserved Error Flag 1 Indicates whether the combination of the values in the ISO Speed reg ister and the Format 7 Mode 1 Image Position Image Size and Color Coding ID registers is acceptable 0 acceptable 1 not acceptable and no image capture can be s
119. hus determines the camera s performance that is what your image currently looks like When you change settings by writing to the camera s registers you are making changes to the work configuration set The work configuration set is located in the camera s volatile memory and the settings are lost if the camera is reset or if power is switched off The work configuration set is usually just called the work set for short Figure 3 16 Configuration Sets Factory Configuration Set When a camera is manufactured a test setup is performed on the camera and an optimized configuration is determined The factory configuration set contains the camera s factory optimized configuration The factory set is saved in a permanent file in the camera s non volatile memory The factory set can not be altered and since it is stored in non volatile memory it is not lost when the camera is reset or switched off The factory configuration set is usually just called the factory set for short 3 12 1 Saving Configuration Sets As mentioned above the work configuration set is stored in the camera s volatile memory and the settings are lost if the camera is reset or if power is switched off A310f cameras can save the current work set values in the volatile memory to reserved areas in the camera s non volatile memory called memory channels Configuration sets saved to memory channels in the non volatile memory are not lost at reset o
120. ig Signal The external trigger ExTrig input signal can be used to control the start of exposure A rising edge or a falling edge of the signal can be used to trigger exposure start The Trigger Mode control register see page 4 25 is used to enable ExTrig exposure start control to select rising or falling edge triggering and to assign a physical input port to receive the ExTrig signal The ExTrig signal can be periodic or non periodic When the camera is operating under control of an ExTrig signal the period of the ExTrig signal determines the camera s frame rate 1 frame rate ExTrig period in seconds For example if you are operating a camera with an ExTrig signal period of 20 ms 0 020 s a 50f gog 9 IPs So in this case the frame rate is 50 fps The minimum high time for a rising edge trigger or low time for a falling edge trigger is 1 us Exposure Modes If you are triggering the camera with an ExTrig signal two exposure modes are available programmable mode and level controlled mode Programmable Exposure Mode When programmable mode is selected the length of the exposure is determined by the shutter settings described in Section 3 2 1 If the camera is set for rising edge triggering exposure starts when the ExTrig signal rises If the camera is set for falling edge triggering exposure starts when the ExTrig signal falls Figure 3 4 illustrates programmable exposure
121. iled layout of how the bits contained within the feature s CSR relate to the parameters for the feature After reading the description of your desired smart feature you can enable and parameterize the feature by setting the appropriate bits within the CSR 6 6 BASLER A310f 6 6 Smart Features Getting Smart Features Results In many cases activating a smart feature results in additional data that must be transmitted by the camera i e the results of the smart feature The results of a smart feature will be appended to the image data so that each frame contains both image data and smart features results Before using any of the smart features that add information to the image data the extended data stream feature must be enabled The extended data stream is in itself a smart feature When the extended data stream feature is enabled information such as the height of the image the width of the image and the AOI size is added to each image s basic pixel data Disabling the extended data stream feature switches off all smart features that add information to the image data stream The extended data stream feature and any other smart features which add information to the image data stream will only work when the camera is set for video format 7 For other video formats enabling the extended data stream feature or any of the other smart features that normally add data to the image stream does not affect the image data stream the camera only se
122. images in format 7 and that provides access to the DCAM registers can be used to work with smart features If you do use a different driver you can adapt the access techniques described in the SFF Software tutorial see Section 6 4 to the driver you are using We strongly recommend that you use the Basler BCAM 1394 driver However any You should be aware that drivers other than the Basler BCAM driver have not been tested with smart features 6 4 What Is the Smart Features Framework Software A Smart Features Framework Software SFF Software package is available from Basler technical support The SFF Software has two major components An SFF Viewer The viewer is a Windows based tool that allows you to easily enable and disable smart features parameterize the camera capture and view images and view smart features results An SFF Tutorial The tutorial explains how to access the cameras smart features from within your own applications The tutorial is based on the assumption that you are using the Basler BCAM 1394 driver with your camera The SFF Viewer will only work on PCs that have the BCAM driver v1 7 or higher in stalled 6 2 BASLER A310f 6 5 Smart Features Enabling and Parameterizing Smart Features The camera provides a control and status register CSR for each smart feature see Sect 6 7 for details of each feature and its CSR To enable and parameterize a smart feature the f
123. inear output range directly matches the input voltage range of the ADC Thus with the default gain of 0 dB a gray value of 1 is produced when the pixels are exposed to no light and a gray value of 255 in modes that output 8 bits per pixel or 4095 in modes that output 12 effective bits per pixel is produced when the pixels are exposed to bright light 0 dB of gain is achieved when gain is programmed to a decimal value of 192 Increasing the gain setting to more than 192 maps a smaller portion of the sensors linear output range to the ADC s input Gray values 4095 255 12 bit 8 bit 0 25 50 100 Sensor output signal 96 Figure 3 12 Gain Settings in dB Increasing the gain is useful when at your brightest exposure a gray value lower than 255 in modes that output 8 bits per pixel or 4095 in modes that output 12 effective bits per pixel is reached For example if you found that at your brightest exposure your gray values were no higher than 127 8 bit mode you could increase the gain to 6 dB amplification factor of 2 and thus reach gray values of 254 see Figure 3 12 Gain is adjustable and can be programmed on a decimal scale that ranges from e 192 to 768 0x0CO to 0x300 on an ASIIt or ASI2t e 192 to 640 0x0CO to 0x280 on an A3dllfe or A312fc tings is valid ADC will not be linear On an ASIIt A312f set to Mono 16 or an A3llfe A312fc set to Raw 16 only settings from 192 to
124. ing 8 bit output that will be transmitted from the camera Not every value in the file is actually used Only the values in line 0 line 8 line 16 line 24 etc are used for the lookup process However the file must contain 4096 lines with two comma separated values on each line The values on lines 1 through 7 9 through 15 17 through 23 etc must be included in the text file even though they are ignored The sample below shows part of a typical text file for a lookup table Assuming that you have enabled the lookup table feature on your camera and used the Upload button to load a file similar to the sample into the camera Ifthe sensor reports that a pixel has a value of 0 the camera will output a value of 0 Ifthe sensor reports that a pixel has a value of 8 the camera will output a value of 1 Ifthe sensor reports that a pixel has a value of 16 the camera will output a value of 3 f the sensor reports that a pixel has a value of 4088 the camera will output a value of 255 r34000 1O0Yy 01 COND S CO CO CO CO CO CO CO EB E E ES p ES 4082 254 4083 254 4084 254 4085 254 4086 254 4087 254 088 255 089 255 090 255 091 255 092 255 093 255 094 255 095 255 KA GS GS GS GPS GS uS Figure 6 9 Sample Text File for Use With Upload Button BASLER A3l0f Smart Features 6 7 9 Lossless Compression The A310f includes a feature that allows lossless compression of the 12 bit output from the camer
125. ing the Bytes per Packet field of the Packet Bytes per Packet register see page 4 39 4 the increment for setting the bytes per packet Max Bytes Per 16 31 Indicates the maximum bytes per packet Packet 4096 the maximum bytes per packet BASLER A310f Configuring the Camera Register Name Bytes Per Packet Field Offset from Base Address Bit 0x044 Description Bytes Per Packet 0 15 Sets the number of bytes per packet the packet size Note When you lower the bytes per packet setting the number of packets needed to transmit a frame the packets per frame will in crease Due to limitations in the DCAM structure a maximum of 4095 packets per frame is allowed If you set the bytes per packet too low the number of packets per frame will exceed the 4095 packet limit and the camera will not transmit frames properly Rec Byte Per Packet 16 31 Indicates the minimum bytes per packet needed to achieve the highest possible frame rate with the current camera settings The recommended bytes per packet field is updated whenever the For mat 7 settings are changed Register Name Packets Per Frame Inquiry Offset from Base Address 0x048 Field Bit Description Packets Per Frame 0 31 Indicates the total packets per frame The value in this register depends on settings in the Format 7 Mode 1 Image Size and Color Coding ID registers
126. ion Time 125 us BASLER A310f 3 13 Basic Operation amp Standard Features 3 14 3 2 8 Overlapped and Non overlapped Exposure The image capture process on A310f cameras includes two distinct parts The first part is the exposure of the pixels in the CCD sensor Once exposure is complete the second part takes place i e readout of the pixel values from the sensor In regard to this image capture process there are two common ways for the camera to operate with non overlapped exposure and with overlapped exposure In the non overlapped mode of operation each time an image is captured the camera completes the entire exposure readout process before capture of the next image is triggered This situation is illustrated in Figure 3 7 Image Capture N Image Capture N 1 Image Capture N 2 Exposure Readout Exposure Readout Exposure Readout Time Figure 3 7 Non overlapped Exposure While operating in a non overlapped fashion is perfectly normal and is appropriate for many situations it is not the most efficient way to operate the camera in terms of frame rate On A310f cameras when the cameras atomatically expose and transmit images in continuous shot operation or when using external triggering it is allowable to begin exposing a new image while a previously captured image is being read out This situation is illustrated in Figure 3 8 and is known as operating the camera with overlapped exposure
127. iry Field Name Offset from Base Address Bit 0x014 Description A311cf A312fc Value Mono 8 8 bit raw value non compressed ID 0 This is a non standard definition When set to this color cod ing ID in Format 7 Mode 1 an A311fc or A312fc will output the raw value for each pixel The pixel data is not processed in any way to account for the color filter on the sensor This type of output is sometimes called Bayer 8 1 4 1 1 YUV8 4 4 1 YUV 8 bits component non compressed ID 1 4 2 2 YUV 8 4 2 2 YUV 8 bits component non compressed ID 2 4 4 4 YUV 8 4 4 4 YUV 8 bits component non compressed ID 3 RGB 8 RGB 8 bits component non compressed ID 4 Mono 16 Y only 16 bits non compressed unsigned integer ID 5 RGB 16 RGB 16 bits component non compressed unsigned integer ID 6 Signed Mono 16 Y only 16 bits non compressed signed integer ID 7 Signed RGB 16 RGB 16 bits component non compressed signed integer ID 8 Raw 8 8 bit raw data output from a color filter sensor ID 9 Raw 16 10 16 bit raw data output from a color filter sensor ID 10 11 31 Reserved If a bit is set to 0 the camera does not support this color coding ID in Format 7 Mode 1 If a bitis set to 1 the camera supports this color coding ID in Format 7 Mode 1 BASLER A310f 4
128. is available This field is read only Abs Control 1 Determines whether the gain will be controlled by the Value field of this register or by the Absolute Value CSR for gain The value will be 0 indicating that gain can only be controlled by the Value field of this register Absolute value control is not available on A310f cameras This field is read only 2 4 Reserved One Push 5 Sets One Push operation The value will be 0 indicating that one push is not in operation One push operation is not available on A310f cameras This field is read only On Off 6 Sets whether gain control is on or off The value will be 1 indicating that gain control is on The gain control feature can t be switched off on A310f cameras This field is read only A M Mode 7 Sets whether the camera is in automatic or manual gain control mode The value will be 0 indicating that gain control is in manual mode Au tomatic gain control is not available on A310f cameras This field is read only 8 19 Reserved Value 20 31 Sets the gain On the A311f and A312f the gain value can normally range from 192 to 768 If an A311f or A312f is set for Mono 16 output the gain value can range from 192 to 511 On the A311fc and A312fc the gain value can normally range from 192 to 640 If an A311fc or A312fc is set for Raw 16 output the gain value can range from 192 to 511 Default 300 on all A310f cameras 4 24 BASLER A310
129. is read only 2 4 Reserved One Push 5 Sets One Push operation The value will be 0 indicating that one push is not in operation One push operation is not available on A310f cameras This field is read only On Off 6 Sets whether brightness control is on or off The value will be 1 indicating that brightness control is on The bright ness control feature can t be switched off on A310f cameras This field is read only A M Mode 7 Sets whether the camera is in automatic or manual brightness control mode The value will be 0 indicating that brightness control is in manual mode Automatic brightness control is not available on A310f cameras This field is read only 8 19 Reserved Value 20 31 Sets the brightness The brightness value can range from 0 to 255 Default 16 on all A310f cameras If a camera is set for any output mode other than Mono 16 or Raw 16 a brightness setting of around 8 will result in an offset of 0 in the digital values output for the pixels An increase of 16 in the brightness setting will result in a positive offset of 1 in the digital values output for the pix els If a camera is set for Mono 16 A311f A312f or Raw 16 A311fc A312fc a brightness setting of around 0 will result in an offset of 0 in the digital values output for the pixels An increase of 1 in the bright ness setting will result in a positive offset of 1 in the digital values out put for the pixels BASLER
130. it of the packet header 5 1 1 Pixel Transmission Sequence Pixel data is transmitted from the camera in the following sequence on the A311f Row 0 Pixel 0 Row 0 Pixel 1 Row 0 Pixel 2 Row 0 Pixel 657 Row 0 Pixel 658 Row 1 Pixel 0 Row 1 Pixel 1 Row 1 Pixel 2 Row 1 Pixel 657 Row 1 Pixel 658 Row 2 Pixel 0 Row 2 Pixel 1 Row 2 Pixel 2 Row 2 Pixel 657 Row 2 Pixel 658 Row 491 Pixel 0 Row 491 Pixel 1 Row 491 Pixel 2 Row 491 Pixel 657 Row 491 Pixel 658 Row 492 Pixel 0 Row 492 Pixel 1 Row 492 Pixel 2 Row 492 Pixel 657 Row 492 Pixel 658 Row 493 Pixel 0 Row 493 Pixel 1 Row 493 Pixel 2 Row 493 Pixel 657 Row 493 Pixel 658 Pixel data is transmitted from the camera in the following sequence on the A311fc Row 0 Pixel 0 Row 0 Pixel 1 Row 0 Pixel 2 Row 0 Pixel 656 Row 0 Pixel 657 Row 1 Pixel 0 Row 1 Pixel 1 Row 1 Pixel 2 Row 1 Pixel 656 Row 1 Pixel 657 Row 2 Pixel 0 Row 2 Pixel 1 Row 2 Pixel 2 Row 2 Pixel 656 Row 2 Pixel 657 Row 489 Pixel 0 Row 489 Pixel 1 Row 489 Pixel 2 Row 489 Pixel 656 Row 489 Pixel 657 Row 490 Pixel 0 Row 490 Pixel 1 Row 490 Pixel 2 Row 490 Pixel 656 Row 490 Pixel 657 Row 491 Pixel 0 Row 491 Pixel 1 Row 491 Pixel 2 Row 491 Pixel 656 Row 491 Pixel 657 BASLER A310f 5 1 Image Data Structures amp Formats Pixel data is transmitted from the camera in the following sequence on the A312f Row 0 Pixel 0 Row 0 Pixel 1 Row 0 Pixel 2 Row 0 Pixel 780 Ro
131. lage radio lectrique Life Support Applications These products are not designed for use in life support appliances devices or systems where malfunction of these products can reasonably be expected to result in personal injury Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale Warranty Note Do not open the housing of the camera The warranty becomes void if the housing is opened All material in this publication is subject to change without notice and is copyright Basler Vision Technologies Contacting Basler Support Worldwide Europe Basler AG An der Strusbek 60 62 22926 Ahrensburg Germany Tel 49 4102 463 515 Fax 49 4102 463 599 bc support europe baslerweb com Americas Basler Inc 855 Springdale Drive Suite 203 Exton PA 19341 U S A Tel 1 610 280 0171 Fax 1 610 280 7608 bc support usa baslerweb com Asia Basler Asia Pte Ltd 8 Boon Lay Way 03 03 Tradehub 21 Singapore 609964 Tel 65 6425 0472 Fax 65 6425 0473 bc support asia baslerweb com www baslerweb com Contents Table of Contents 1 Introduction 1 1 Documentation Applicability llle 1 1 1 2 Performance Specifications lssiseisleel eee 1 2 1 3 Camera Models ssulseesssselee hn 1 3 1 4 Spectral Response ie ea ee RI a hae aa das
132. ld controls the software trigger 0 reset the software trigger 1 2 set the software trigger If the Trigger Mode field of the Trigger Mode register is set to O this field will self clear 1 31 Reserved Register Name Data Depth Offset from Base Address 0x630 Field Bit Description Depth 0 7 Indicates the effective depth of the data in the transmitted images Depends on the current format and mode settings Also depends on the Color Coding ID if the camera is set for Format 7 This field is read only Camera set for Effective data depth indicated Mono 8 output 8 bits pixel Mono 16 output 12 bits pixel Raw 8 output 8 bits pixel Raw 16 output 12 bits pixel 4 2 2 YUV output 8 bits component 8 31 Reserved BASLER A310f Configuring the Camera 4 4 2 2 Control and Status Registers for Features Register Name Brightness Offset from Base Address 0x800 Field Bit Description Presence Inq 0 Indicates the presence of the brightness control feature The value will be 1 on all A310f cameras indicating that brightness control is available This field is read only Abs Control 1 Determines whether the brightness will be controlled by the Value field of this register or by the Absolute Value CSR for brightness The value will be 0 indicating that brightness can only be controlled by the Value field of this register Absolute value control is not available on A310f cameras This field
133. ll be transmitted for each pixel but only 12 bits are effective see Section 3 6 BASLER A310f 5 13 Image Data Structures amp Formats 5 4 Image Data Structure 5 4 1 Data Structure for a Y Mono 8 or an R G or B Raw 8 Component The data output for a Y mono 8 component or an R G or B raw 8 component is 8 bit data of the unsigned char type The range of data values for a Y mono component and the corresponding indicated signal levels are shown below 5 14 This Data Value Indicates This Signal Level Hexadecimal Decimal OxFF 255 OxFE 254 e e e e e e 0x01 1 0x00 0 5 4 2 Data Structure for a U or a V Component The data output for a U or a V component is 8 bit data of the straight binary type The range of data values for a U or a V component and the corresponding indicated signal levels are shown below This Data Value Indicates This Signal Level Hexadecimal Decimal OxFF 127 OxFE 126 e e e e e e 0x81 1 0x80 0 Ox7F 1 e e e e e e 0x01 127 0x00 128 The signal level of a U component or a V component can range from 128 to 127 decimal Notice that the data values have been arranged to represent the full signal level range BASLER A3l0f Image Data Structures amp Formats 5 4 3 Data Structure for a Y Mono 16 or an R G or B Raw 16 Component The data output for
134. ll no longer operate 7 5 mm D IR Cut Filter C Mount Lens Fi Lens Adapter Drawing is not to scale Figure 7 3 Maximum Lens Thread Length on A310fc Cameras Caution A3Tlfc and A312fc color cameras are equipped with an IR cut filter mounted in of the lens adapter The location of the filter limits the thread length of the lens that can be used on the camera The thread length on your lens must be less than 7 5 mm If a lens with a longer thread length is used the camera will be dam aged and will no longer operate 7 4 BASLER A3l0f 8 1 8 2 8 3 Technical Support Technical Support Technical Support Resources If you need advice about your camera or if you need assistance troubleshooting a problem with your camera you can contact the Basler technical support team for your area Basler technical support contact information is located in the front pages of this manual You will also find helpful information such as frequently asked questions downloads and appli cation notes on the Basler website at www baslerweb com indizes beitrag index en 22089 html Obtaining an RMA Number Whenever you want to return material to Basler you must request a Return Material Authorization RMA number before sending it back The RMA number must be stated in your delivery documents when you ship your material to us Please be aware that if you return mat
135. lter Camera users can use the raw data to perform a color interpolation BASLER A310f 3 37 Basic Operation amp Standard Features 3 38 3 10 2 Customizable Formats and Modes Format 7 Mode 0 and Format 7 Mode 1 are available on A3llfe and A3llfc color cameras Format 7 Mode 0 Format 7 Mode 0 is used to enable and set up the area of interest AOI feature described in Section 3 4 Format 7 Mode 0 is parameterized by using the Format 7 Mode 0 control and status registers see page 4 28 When the camera is operating in Format 7 Mode 0 the frame rate can be adjusted by setting the number of bytes transmitted in each packet The number of bytes per packet is set by the Bytes Per Packet field of the Bytes Per Packet control register The value that appears in the Max Bytes Per Packet field of the Packet Para Inquiry register will show the maximum allowed bytes per packet setting given the current AOI settings When the bytes per packet is set to the maximum the camera will transmit frames at its maximum specified rate By default the AOI is set to use the full sensor area and the bytes per packet is set to 4096 If you setthe bytes per packet to a value lower than the maximum the camera will transmit frames at a lower rate The rate is calculated by the formula 1 Frames s Packets per Frame x 125 us Keep in mind that when you lower the bytes per packet setting the
136. lue 1 The feature was enabled A M Mode 7 0 The feature was in manual control mode 1 The feature was in auto control mode Blue Value 8 19 Blue value Red Value 20 31 Red Value 28 White Balance Field Bit Description Absolute Value CSR r 4 Bytes Abs Value 0 31 Floating point value with IEEE real 4 format Unit K Kelvin 32 Brightness CSR Content of the DCAM Brightness CSR 4 bytes Same layout as the Gain CSR 36 Brightness Absolute Field Bit Description Value CSR i 4 Bytes Abs Value 0 31 Floating point value with IEEE real 4 format Unit 96 40 Chunk GUID 911C8982 1COF 11D8 8AFO 00105A5BAE55 16 Bytes 56 Chunk Length This chunk s total length in bytes 4 bytes 60 Inverted Chunk Length The bitwise complement of the chunk length 4 bytes BASLER A310f 6 15 Smart Features 6 7 5 CRC Checksum The CRC Cyclic Redundancy Check Checksum feature adds a chunk to each image frame containing a 16 bit CRC checksum calculated using the Z modem method The CRC Checksum chunk is always the last chunk added to the image data stream and the chunk is always 32 bits in size As shown in Figure 6 2 the checksum is calculated using all of the image data and all of the appended chunks except for the checksum itself This data is used to calculate the checksum J Extended Image Data Chunk 1 Smart i Smart CRC includes basic image data plus added Feature A Feature B Check
137. meterizing any customized smart feature and for returning the results from the feature The Basler camera development team is ready and able to handle requests for customized smart features The cost to the customer for adding a customized smart feature to the A310t will depend on the complexity of algorithm software and firmware development of incorporating the feature within the smart features framework and of testing to ensure that the feature meets specifications Please contact your Basler sales representative for more details about customized smart features BASLER A310f 6 41 Smart Features 6 42 BASLER A3l0f Mechanical Considerations 7 Mechanical Considerations The A310t camera housing is manufactured with high precision Planar parallel and angular sides guarantee precise mounting with high repeatability The camera housing conforms to protection class IP30 provided the lens mount is covered by a lens or by the lens cap that is shipped with the camera Caution The camera is shipped with a cap on the lens mount To avoid collecting dust on the sensor make sure that at all times either the cap is in place or a lens is mounted on the camera BASLER A310ff 7 1 Mechanical Considerations 7 1 Camera Dimensions and Mounting Facilities The dimensions for A310f cameras are as shown in Figure 7 1 A310t cameras are equipped with four M4 mounting holes on the front and two M4 mounting holes on each side
138. n A311f A311fc A312f A312fc Value Same definitions and values as Strobe 0 Inq BASLER A3IOf Configuring the Camera Register Name Strobe 0 Control Offset from Base Address 0x200 Field Bit Description Presence Inq 0 Indicates the presence of the Strobe 0 signal control feature 0 not available 1 available The Strobe 0 control feature is available on all A310f cameras This field is read only 1 5 Reserved On Off 6 Sets whether the Strobe 0 signal is on or off 0 2 off 1 on Default 0 on all A310f cameras If this bit is O all other fields in this register are read only Signal Polarity 7 Sets the polarity of the Strobe 0 signal 0 low active 1 high active Default 2 1 on all A310f cameras Delay Value 8 19 Sets the delay value for the Strobe 0 signal see Section 3 7 The de lay value can range from 0 to 4095 Strobe 0 Delay Delay Value Setting x Strobe Delay Time Base Default 0 on all A310f cameras Note The strobe delay time base is normally 1 1024 ms but it can be adjusted by using the strobe time base smart feature See Sections 3 7 and 6 7 14 for more information Duration Value 20 31 Sets the duration value for the Strobe 0 signal The duration value can range from 0 to 4095 Strobe 0 Duration Dur Value Setting x Strobe Dur Time Base Default 4095 on all A310f cameras Note The strobe duration time base is normally 1 1024 ms but it can be adjuste
139. n be accessed even when the extended data stream feature see Section 6 7 1 is disabled The startup memory channel smart feature is always enabled regardless of the video format Control and Status Register for the Startup Memory Channel Feature Name Startup Memory Channel Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 93A06C5C 87BF 11D8 86DD 00105A5BAE55 Position Field Bit Description 0 Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available ae 1 27 Reserved Channel 28 31 Selects a memory channel At camera power on or re set the selected channel will be copied into the cam era s work configuration set 0 Channel 0 Factory set 1 Channel1 2 Channel 2 3 Channel 3 Default 0 6 36 BASLER A3l0f Smart Features 6 7 13 Shutter Time Base As described in Section 3 2 1 exposure time is determined by a combination of two values The first is the setting in the Value field of the Shutter control register see page 4 23 The second is the Shutter Time Base Exposure time is determined by the product of these two values Exposure Time Shutter Value Setting x Shutter Time Base The shutter time base is fixed at 20 us by default and the exposure time is normally adjusted by changing the setting in the Value field of the Shutter control register However if you require an exposu
140. n external 1 2 k resistor has been added to the circuit This will result in approximately 15 mA being applied to the input In Figure 2 5 the signal is applied to input port 3 Your Gnd 24 VDC EN e Your Gnd NM Co 4 O O OC o 10 Pin RJ 45 Jack Figure 2 5 Typical 24 VDC Input Circuit BASLER A310f 2 7 Camera Interface 2 5 4 Typical Output Circuits Figure 2 6 shows a typical circuit you can use to monitor an output port with a voltage signal The circuit in Figure 2 6 is monitoring camera output port 1 A310f Your Gnd o 5 35 VDC Out VCC Com Voltage Output Signal to You M CQ 4 O O C o RJ 45 Jack Your Gnd Figure 2 6 Typical Voltage Output Circuit Figure 2 7 shows a typical circuit you can use to monitor an output port with a LED or an optocoupler In this example the voltage for the external circuit is 24 VDC Current in the circuit is limited to approximately 10 mA by an external 2 2k resistor The circuit in Figure 2 7 is monitoring camera output port 2 A310f Your Gnd 10 9 24 VDC Out VCC Com 6 5 4 3 2 1 2 2kQ to You Jack Your Gnd Figure 2 7 Typical LED Output Signal 2 8 BASLER A3l0f 3 1 Basic Operation amp Standard Features Basic Operation and Standard Features Functional Description 3 1 1 Overview A310f area scan cameras employ a CCD sensor chip which provides features such a
141. nals when they are exposed to light These voltages are amplified by the VGC and transferred to the ADC which converts the voltages to digital output signals Two parameters gain and offset are associated with the VGC As shown in Figures 3 7 and 3 8 increasing or decreasing the gain increases or decreases the amplitude of the signal that is input to the ADC Increasing or decreasing the offset moves the signal up or down the measurement scale but does not change the signal amplitude For most applications black should have a gray value of 1 and white should have a gray value of 255 in modes that output 8 bits per pixel or 4095 in modes that output 12 effective bits per pixel Attempt to achieve this by varying exposure and illumination rather than changing the camera s gain Basic Operation amp Standard Features input signal to ADC V increasing gain increases the amplitude of the input signal 4 Y light intensity uJ cm Figure 3 10 Gain input signal to ADC V increasing offset moves the input signal up the measurement scale offset light intensity uJ cm Figure 3 11 Offset Because increasing gain increases both signal and noise the signal to noise ratio does not change significantly when gain is increased BASLER A310f 3 19 Basic Operation amp Standard Features 3 3 1 Setting Gain When the gain is set to default the sensors l
142. nds the basic image data without any added information Frame N Frame N 1 Extended Image Data Chunk Smart 1 Smart includes basic image data plus added Feature A Feature B eco data such as image height and width Chui hunk Extended Image Data Chunk includes basic image data plus added data such as image height and width 1 Figure 6 1 Image Data Stream with Smart Features Enabled As illustrated in Figure 6 1 when smart features are enabled each image frame consists of chunks For example the frame may include a chunk which contains the extended image data the basic image data plus the added height width etc information a chunk which contains the results for the frame counter smart feature a chunk which contains the results for the cycle time stamp smart feature etc Table 6 1 describes the general structure of a chunk Position Name Description 0 Data The data that the chunk is transporting K Bytes K Chunk GUID Identifies the type of chunk and the smart feature associated with the 16 Bytes chunk Note that a smart feature s chuck GUID is not the same as its CSR GUID K 16 Length The chunk s total length in bytes 4 Bytes K 20 Inverted Length The bitwise complement of the length 4 Bytes Table 6 1 General Structure of a Chunk Each chunk ends with a four byte unsigned integer indicating the length of the chunk and four bytes which indicate the bitwise complemen
143. nfigured as User Set see Section 6 7 11 For any output port not configured as user set the bit setting in the PIO Output register will be ignored Register Name PIO Input Offset from Base Address 0x004 Field Bit Description 0 27 Reserved Port 3 In 28 Indicates the current state of physical input port 3 0 low 1 high Port 2 In 29 Indicates the current state of physical input port 2 0 low 1 high Port 1 In 30 Indicates the current state of physical input port 1 0 low 1 high Port 0 In 31 Indicates the current state of physical input port 0 0 low 1 high BASLER A310f Configuring the Camera 4 4 2 7 Control and Status Registers for the Strobe Signal Function The base address for the Strobe Signal control and status registers is Bus ID Node ID FFFF F2F0 0300 In each Strobe Signal register description an Offset from the Base Address is provided This a byte offset from the above base address The address of a strobe signal register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as 0x e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit Register Name Strobe Control Inquiry Offset from Base Address 0x000 Field Bit Description A311f A311fc A312f A312fc Value
144. ngs to set the minimum exposure time to 3000 ps You can find information and guidelines for using ExTrig signals with level controlled mode for overlapped exposure in the Application Notes Using a Specific External Trigger Signal with BASLER A310f 3 9 Basic Operation amp Standard Features 3 10 Overlapped Exposure AW000565xx000 You can download the Application Notes free of charge from the Basler website at www baslerweb com Enabling the External Trigger Feature To enable the external trigger feature Setthe On Off field of the Trigger Mode control register to 1 to enable triggering Set the Trigger Polarity field of the Trigger Mode control register to 0 to select falling edge triggering or 1 to select rising edge triggering Set the Trigger Mode field of the Trigger Mode control register to 0 to select the programma ble exposure mode or 1 to select the level controlled exposure mode Set the Trigger Source field in the Trigger Mode control register to select which one of the four physical input ports on the camera will be used to receive the external trigger signal Set the Trigger Source field to 0 to select physical input port 0 to receive the ExTrig signal Set the Trigger Source field to 1 to select physical input port 1 to receive the ExTrig signal Set the Trigger Source field to 2 to select physical input port 2 to receive the ExTrig signal Set the Trigger Source field to 3 to select physical input
145. ns in Section 3 2 4 Revised Section 3 2 5 to add that the minimum length of a level con trolled trigger pulse is determined by the shutter setting Included reference to Application Notes AW000565xx000 in Sec tions 3 2 5 and 3 2 8 Added Section 3 2 8 Indicated the unavailability of overlapped exposure when using soft ware trigger in Sections 3 2 4 and 3 2 8 Revised Section 3 2 9 Corrected the description of the On Off field in the trigger mode register description in Section 4 4 2 2 Removed the link related to downloading the SFF software from Section 6 4 Corrected test image descriptions for mono 8 output format in Sec tion 6 7 6 replaced Figure 6 3 and Figure 6 5 Added test image descriptions for mono 16 output format to Section 6 7 6 and corrected gray value numbers for Figure 6 3 and Figure 6 5 BASLER A310f Revision History Doc ID Number Date Changes DAO00066803 18 December 2008 Corrected the Delay Time Base 24 31 in the strobe time base register description in Section 6 7 14 from being read only to being read write Revised Figure 7 2 on page 7 3 Added Section 8 Technical Support Minor corrections throughout the manual DA00066804 7 December 2010 Updated the European and American contact addresses Added the PS2805C 4 optocoupler in Figure 2 3 Removed the feedback page BASLER A3l0f Index A advanced features registers
146. ntrolling the camera To copy a saved configuration set from a memory channel into the work set 1 Set the value in the Current Memory Channel control register see page 4 19 to 1 2 or 3 When you set the register the configuration settings will be copied from the designated channel into the work set By default the factory set is stored in memory channel 0 This is a protected memory channel and the factory settings in this channel can t be altered in any way You can copy the factory configuration set into the work set if you desire To copy the factory set from memory channel 0 into the work set 1 Setthe value in the Current Memory Channel control register to 0 When you set the register the factory configuration settings will be copied into the work set Copying a saved configuration set or the factory set into the work set is only allowed when the camera is idle i e when it is not capturing images continuously and does not have a one shot capture pending Copying the factory set into the work set is a good course of action if you have grossly misadjusted the settings in the camera and you are not sure how to recover The fac tory settings are optimized for use in typical situations and will provide good camera performance in most cases 3 12 3 Designating a Startup Memory Channel Whenever a camera is powered on or is reset by default it copies the factory set settings in memory channel 0 into the work set A
147. ode Automatic white balance control is not available on A310f cam eras This field is read only Blue Value 8 19 Adjusts the blue level in the captured images The valid values for this field can range from 16 to 255 however only settings from 64 to 255 should be used When set to 96 this register has no effect on the image Settings less than 96 make the images less blue Settings greater than 96 make the images more blue Default 160 on the A311fc and A312fc Red Value 20 31 Adjusts the red level in the captured images The valid values for this field can range from 16 to 255 however only settings from 64 to 255 should be used When set to 96 this register has no effect on the image Settings less than 96 make the images less red Settings greater than 96 make the images more red Default 115 on the A311fc and A312fc 4 22 BASLER A310f Configuring the Camera Register Name Shutter Offset from Base Address 0x81C Field Bit Description Presence Inq 0 Indicates the presence of the shutter control feature The value will be 1 on all A310f cameras indicating that shutter control is available This field is read only Abs Control 1 Determines whether the shutter will be controlled by the Value field of this register or by the Absolute Value CSR for the shutter The value will be 0 indicating that the shutter can only be controlled by the Value field of this register A
148. oftware Trigger register set to 1 Figure 3 3 Programmable Exposure with a Software Trigger When using software triggering only non overlapped exposure is available Over lapped exposure where exposure of a new image begins while the previous image is being read out See Section 3 2 8 is not available Enabling the Software Trigger Feature To enable the software trigger feature e Set the On Off field of the Trigger Mode control register to 1 to enable triggering Set the Trigger Source field of the Trigger Mode control register to 7 to select software trig gering Set the Trigger Mode field of the Trigger Mode control register to 0 to select the programma ble exposure mode Software Trigger One shot Operation In Software Trigger One shot operation a One Shot Command is used to prepare the camera to capture a single image With this method of operation exposure will begin when the Trigger field of the Software Trigger control register is set to 1 To use this operating method follow this sequence BASLER A310f 3 5 Basic Operation amp Standard Features 3 6 Use the shutter settings described in Section 3 2 1 to set your desired exposure time Set the One Shot field in the One Shot Multi Shot control register to 1 see page 4 18 This prepares the camera to capture a single image Set the Trigger field in the Software Trigger control register to 1 see page 4 20 This starts the exposure Exposu
149. ollowing steps must be performed 1 Check to see if the camera supports smart features 2 Ask the camera for the address of the CSR for the desired smart feature 3 Enable and parameterize the desired smart features The next two sections describe steps 1 and 2 The layout of the registers used to enable and parameterize the smart features is described in section 6 7 6 5 1 Checking to See if the Camera Supports Smart Features Smart features are vendor unique Such features are referred to in the 1394 Trade Association DCAM standard as advanced features The DCAM standard specifies how vendors should implement advanced features According to the standard advanced features must be unlocked that is enabled by writing an advanced features set identifier Feature ID and a time out value to the Advanced Features Access Control Register The Feature ID associated with Basler smart features is 0x0030 533B 73C3 From the point of view of the DCAM standard smart features are a set of advanced DCAM features For Basler cameras unlocking advanced features is not strictly necessary because any implemented smart features are always available However the unlock mechanism is also used to check to see if a camera supports vendor unique features such as smart features If a device doesn t recognize a Feature ID written to the Access Control Register a value of OxFFFF FFFF FFFF FFFF will be read back from the ACR This value indicates that the device
150. on Field Bit Description 0 Same as port 0 4 Same as port 0 8 Same as port 0 12 Same as port 0 16 Same as port 0 20 Same as port 0 Name Output Port 3 Configuration Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID E79233CA 4513 11D8 9B9A 00105A5BAE55 Position Field Bit Description 0 Same as port 0 4 Same as port 0 8 Same as port 0 12 Same as port 0 16 Same as port 0 20 Same as port 0 BASLER A310f 6 35 Smart Features 6 7 12 Startup Memory Channel As described in Section 3 12 A310f cameras include four memory channels that can be used to store camera configuration sets Memory channel 0 contains a factory configuration set Channels 1 2 and 3 can be used to store user created configuration sets The startup memory channel smart feature lets you designate a memory channel and when the camera is powered on or reset the contents of the designated channel will be copied into the work set in the camera s volatile memory To designate a startup memory channel write a value to the Channel field of the Startup Memory Channel CSR You can only designate memory channel 1 2 or 3 as the startup channel if you have previously saved a configuration set into the designated channel You cannot use an empty memory channel as the startup channel See Section 3 12 The startup memory channel smart feature does not add information to the image data stream and ca
151. or P Bm Red value for Ph Bm Green value for P BASLER A3l0f For Filter ID 3 BG GR Image Data Structures amp Formats Even Lines Odd Lines Byte Data Byte Data Bo Blue value for Po Bo Green value for Po B4 Green value for P4 B4 Red value for P4 Bo Blue value for Po Bo Green value for Po B3 Green value for P3 B3 Red value for P3 B4 Blue value for P4 B4 Green value for P4 B5 Green value for P5 B5 Red value for Ps e e e e e e e e e e e e Bm 5 Blue value for Ph 5 Bm 5 Green value for Ph 5 Bm 4 Green value for P4 Bm 4 Red value for P 4 Bm 3 Blue value for P 4 Bm 3 Green value for P 3 Bm 2 Green value for P Bm 2 Red value for P Bm4 Blue value for P4 Bm4 Green value for P Bm Green value for Ph Bm Red value for Ph BASLER A310f 5 9 Image Data Structures amp Formats 5 10 5 3 5 Data Format with the Camera Set for Raw 16 Output The tables below describe how the data for the odd lines and for the even lines of a received frame will be ordered in the image buffer in your PC The following standards are used in the tables Po the first pixel transmitted by the camera for a line P the last pixel transmitted by the camera a line Bg the first byte of data for a line Bm the last byte of data for a line For Filter ID 0 RG GB
152. or more information on changing the shutter time base see Section 6 7 13 3 2 2 Maximum Exposure Time The maximum exposure time for a given frame rate is determined by the following formula 1 maximum exposure time frame rate For example if a camera is operating at 40 fps 1 0 02 40 fps 0 0250 s So in this case the maximum exposure time is 25 0 ms Exceeding the maximum exposure time for your frame rate will cause the camera to slow down i e it will cause the camera to operate at a lower frame rate BASLER A310f 3 3 Basic Operation amp Standard Features 3 2 3 Controlling Exposure Start with Shot Commands via the 1394 Interface Exposure start can be controlled by sending shot commands directly to the camera via the 1394 bus In this case a software trigger or an external trigger ExTrig signal is not used When exposure start is controlled with shot commands via the 1394 bus two modes of operation are available one shot and continuous shot One Shot Operation In one shot operation the camera exposes and transmits a single image Exposure begins after the One Shot field of the One Shot Multi Shot control register is set to 1 see page 4 18 Exposure time is determined by the shutter settings described in Section 3 2 1 The One Shot field is self cleared after transmission of the image data Continuous Shot Operation In continuous shot operation the c
153. ou are setting the AOI on a color camera The setting for Width must be divisible by 2 The setting for Height must be divisible by 2 The setting for Left must be zero or be divisible by 2 The setting for Top must be zero or be divisible by 2 BASLER A310f 3 23 Basic Operation amp Standard Features 3 4 1 Changing AOI Parameters On the Fly Making AOI parameter changes on the fly means making the parameter changes while the camera is capturing images continuously On the fly changes are only allowed for the parameters that determine the position of the AOI i e the parameters for top and left Changes to the AOI size are not allowed on the fly The camera s response to an on the fly change in the AOI position will vary depending on the way that you are operating the camera f the exposure time is 100 us the changes will take effect on the next trigger after the changes are received by the camera f the exposure time is 100 us and the camera is running in non overlapped mode the changes will take effect on the next trigger after the changes are received by the camera f the exposure time is lt 100 us and the camera is running in overlapped mode when the changes are received by the camera the camera will delay the triggering of the next image until transmission of the current image is complete When transmission of the current image is complete the camera will change the AOI position will
154. ount 16 31 The trigger counter increments by one each time an im Read only age capture is triggered The counter is reset at power on or when an initialize command is issued 4 0 70 jJ 0 30 Reserved Trigger Flag 31 The flag is setto 1 by each trigger Itis cleared by a read Read only access to this register BASLER A310f Smart Features 6 7 11 Output Port Configuration A310f cameras are equipped with four physical output ports designated as Output Port 0 Output Port 1 Output Port 2 and Output Port 3 The output port configuration feature can be used to change the assignment of camera output signals such as Integrate Enabled and Trigger Ready to the physical output ports As shown on pages 6 34 and 6 35 there is a control and status register CSR for each physical output port The Source Select field in each register is used to assign a camera signal to the associated output port For example the Source Select field in the register for Output Port 0 is used to assign a camera output signal to physical output port 0 Each physical output port can be unassigned or it can have one and only one camera output signal assigned to it You can assign a camera output signal to more than one physical output port For example the Trigger Ready signal could be assigned to both physical output port 0 and physical output port 1 The Source Select field can also be used to designate an output port as
155. p a complete image data frame Don t confuse CSR GUIDs with chunk GUIDs Each smart feature has a control and status register CSR associated with it and each CSR has a unique CSR GUID assigned to the register The CSR GUIDs are used to help you keep track of which CSR is associated with each smart fea ture Any smart feature that adds a chunk of data to the image data stream also has a unique chunk GUID assigned to the feature The chunk GUID will be included the chunk of data that a smart feature adds to the image data The chunk GUIDs let you determine which smart feature is associated with each added chunk in the image data stream The CRC Checksum is an exception to the general structure of a chunk See Section 6 7 5 for more information 6 6 1 How Big a Buffer Do Need When smart features that add data to the image are enabled the size of each transmitted frame will be larger than you would normally expect for a frame which contains only image data To determine the size of the buffer that you will need to hold an image with appended smart features data check the Total Bytes High Inquiry and Total Bytes Low Inquiry registers of the Format 7 mode you are currently using Make sure to check these registers after all smart features have been enabled and all other settings affecting the image size have been completed The size information in these fields will allow you to properly set up buffers to r
156. port 3 to receive the ExTrig signal The default setting is for physical input port 0 to receive the ExTrig signal Refer to Sections 2 5 1 and 2 5 2 for a description of the physical and electrical characteristics of the physical input ports The Trigger Source field in the Trigger Mode register is defined in version 1 31 of the IIDC specification The Basler BCAM 1394 Driver does not include a method call to access the trigger source feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the Trigger Source field Contact Basler technical support to obtain the Smart Features Framework Software The ExTrig signal must be used in combination with a one shot or a continuous shot command If more precise control of exposure start time is desired you must also monitor the Trigger Ready signal and you must base the timing of the ExTrig signal on the state of the Trigger Ready signal See Section 3 2 6 for recommended methods for using the signals The following descriptions assume that the ExTrig signal is set for rising edge triggering and the programmable exposure mode ExTrig One shot Operation In ExTrig One shot operation a One shot Command is used to prepare the camera to capture a single image When the ExTrig signal rises exposure will begin To use this operating method follow this sequence 1 Use the shu
157. ports a value above 4088 the camera will not be able to perform an interpolation In cases where the sensor reports a value above 4088 the camera simply transmits the 8 bit value from location 4088 in the table Please look at page 6 28 and examine the layout of the control and status register for the lookup table smart feature You will notice that the first two quadlets of the register include bits that allow you to check for this feature s presence and to enable or disable the feature These initial two quadlets are followed by 4096 quadlets The 4096 quadlets contain the values that make up the customized lookup table BASLER A310f Smart Features The advantage of the lookup table feature is that it allows the user to customize the response curve of the camera The graphs below represent the contents of two typical lookup tables The first graph is for a lookup table where the values are arranged so that the output of the camera increases linearly as the sensor output increases The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the sensor output moves from 0 through 2048 and increases gradually as the sensor output moves from 2049 through 4096 255 8 Bit Camera Output 0 0 1024 2048 3072 4095 12 Bit Sensor Reading Figure 6 7 LUT with Values Mapped in a Linear Fashion 255 8 Bit Camera Output 0 0 1024 2048 3072 4095 12 Bit Sensor Reading Figure 6 8 LUT with Values
158. r YUV 4 2 2 Output 5 4 5 3 2 Data Format with the Camera Set for Y Mono 8 Output 5 5 5 3 3 Data Format with the Camera Set for Y Mono 16 Output 5 6 5 3 4 Data Format with the Camera Set for Raw 8 Output 5 7 5 3 5 Data Format with the Camera Set for Raw 16 Output 5 10 5 4 Image Data Structure 2 0 ete 5 14 5 4 1 Data Structure for a Y Mono 8 or an R G or B Raw 8 Component 5 14 5 4 2 Data Structure fora U or a V Component lilii sels eee eee 5 14 5 4 3 Data Structure for a Y Mono 16 or an R G or B Raw 16 Component 5 15 6 Smart Features and the Smart Features Framework 6 1 What Are Smart Features 2 0 0 les 6 1 6 2 What Is the Smart Features Framework llle 6 1 6 3 What Do Need to Use Smart Features 0 0 0 0 0 nes 6 2 6 4 What Is the Smart Features Framework Software 00 0a eee eae 6 2 6 5 Enabling and Parameterizing Smart Features lille eee 6 3 6 5 1 Checking to See if the Camera Supports Smart Features 6 3 6 5 2 Determining the Address of a Smart Feature s CSR 6 4 6 5 3 Enabling and Parameterizing a Smart Feature 0 0005 6 6 6 6 Getting Smart Features Results 0 000 6 7 6 6 1 How Big a Buffer Do Need 0 0200 eee 6 8 6 7 Standard Smart Features on the AS10f 0 0 ee eee 6 9 6 7 1 Extended Da
159. r power off There are three memory channels available for saving configuration sets channel 1 channel 2 and channel 3 A configuration set saved in a memory channel is commonly referred to as a user configuration set or user set Saving the current work set to one of the memory channels is a three step process 1 Make changes to the camera s settings until the camera is operating in a manner that you would like to save 2 Set the value of the Memory Save Channel control register see page 4 19 to 1 2 3 This will select the channel were the configuration set will be saved 3 Setthe value of the Memory Save control register see 4 18 to 1 When you set this value to 1 the camera will save the current register settings to the designated memory channel Saving a configuration set to one of the memory channels will overwrite any set that was previously saved to the selected channel BASLER A310f 3 41 Basic Operation amp Standard Features 3 42 3 12 2 Copying a Saved Configuration Set or the Factory Set into the Work Set If you have saved one or more configuration sets to memory channels in the camera as described in Section 3 12 1 you can copy one of the saved sets from a memory channel into the camera s work set When you do this the copied set overwrites the parameters in the work set Since the settings in the work set control the current operation of the camera the settings from the copied set will now be co
160. ra P the last pixel transmitted by the camera Bo the first byte in the buffer Bm the last byte in the buffer Byte Data Bo U value for Po B4 Y value for Po Bo V Value for Pg B3 Y value for P4 B4 U value for Po B5 Y value for P2 Bg V Value for P2 B7 Y value for P3 Bg U value for P4 Bg Y value for P4 Bio V Value for P B41 Y value for P5 e e e e e e Bm 7 U value for Ph 3 Bm 6 Y value for Ph 3 Bm 5 V Value for Ph 3 Bm 4 Y value for P Bm 3 U value for P4 Bm 2 Y value for P4 Bm 1 V Value for Ph 4 Bm Y value for Ph BASLER A3l0f Image Data Structures amp Formats 5 3 2 Data Format with the Camera Set for Y Mono 8 Output The table below describes how the data for a received frame will be ordered in the image buffer in your PC The following standards are used in the table Po the first pixel transmitted by the camera P the last pixel transmitted by the camera Bg the first byte in the buffer Bm the last byte in the buffer Byte Data Bo Y value for Po B Y value for P4 Bo Y value for P3 B3 Y value for P3 B4 Y value for P4 Bs Y value for Ps Bg Y value for Pg B Y value for P7 e e e e e e Bm 3 Y value for Ph 3 Bm 2 Y value for P Bm 1 Y value for P4 Bm Y value for Ph BASLER A310f 5 5 Image Data Structures amp Formats 5 6
161. rame Rate 1 1 3 75 fps standard frame rate 1 Frame Rate 2 2 7 5 fps standard frame rate 1 Frame Rate 3 3 15 fps standard frame rate 1 Frame Rate 4 4 30 fps standard frame rate 1 Frame Rate 5 5 60 fps standard frame rate 1 Frame Rate 6 6 120 fps standard frame rate 0 Frame Rate 7 T 240 fps standard frame rate 0 8 81 Reserved Register Name Video Frame Rate Inquiry for Format 0 Mode 3 Offset from Base Address 0x20C Field Bit Description A311f A311fc A312 A312fc Value Frame Rate 0 0 1 875 fps standard frame rate 1 Frame Rate 1 1 3 75 fps standard frame rate 1 Frame Rate 2 2 7 5 fps standard frame rate 1 Frame Rate 3 3 15 fps standard frame rate 1 Frame Rate 4 4 30 fps standard frame rate 1 Frame Rate 5 5 60 fps standard frame rate 0 Frame Rate 6 6 120 fps standard frame rate 0 Frame Rate 7 7 240 fps standard frame rate 0 no 8 31 Reserved BASLER A310f 4 5 Configuring the Camera 4 6 Register Name Video Frame Rate Inquiry for Format 0 Mode 5 Offset from Base Address 0x214 Field Bit Description A311f A311fc A312 A312fc Value Frame Rate 0 0 1 875 fps standard frame rate 1 Frame Rate 1 1 3 75 fps standard frame rate 1 Frame Rate 2 2 7 5 fps standard frame rate 1 Frame Rate 3 3 15 fps standard frame rate 1 Frame Rate 4 4 30 fps standard frame rate 1 Frame Rate 5 5 60 fps
162. re time that is shorter or longer than what you can achieve by changing the shutter value alone the Shutter Time Base CSR can be used to change the shutter time base To change the shutter time base Set the Enable field in the Shutter Time Base CSR to 1 Setthe Time Base field to your desired time base value Example Assume that you have set the Value field of the Shutter control register to 325 Also assume that you have enabled the time base smart feature and that you have set the Time Base field in the Shutter Time Base CSR to 0 000150 second In this case Exposure Time Shutter Value Setting x Shutter Time Base Exposure Time 325 x 0 000150 s Exposure Time 0 048750 s stream and can be accessed even when the extended data stream feature see Sec The shutter time base smart feature does not add information to the image data tion 6 7 1 is disabled The shutter time base smart feature can be enabled regardless of the video format BASLER A310f 6 37 Smart Features 6 38 Control and Status Register for the Shutter Time Base Feature Name Shutter Time Base Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 648BE1DA A416 11D8 9B47 00105A5BAE55 Position Field Bit Description 0 Presence Inq 0 Presence of the shutter time base feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable
163. re was enabled A M Mode 7 0 The feature was in manual control mode 1 The feature was in auto control mode 8 19 Reserved Value 20 31 Value of the feature 4 Gain Absolute Value CSR Field Bit Description 4 Bytes Abs Value 0 31 Floating point value with IEEE real 4 format Unit dB 8 Shutter CSR Content of the DCAM Shutter CSR 4 bytes Same layout as the GAIN CSR 12 Shutter Absolute Value Field Bit Description CSR 4 Bytes Abs Value 0 31 Floating point value with IEEE real 4 format Unit seconds 16 Gamma CSR Content of the DCAM Gamma CSR 4 bytes Same layout as the Gain CSR 20 Gamma Absolute Value Field Bit Description CSR 4 Bytes Abs Value 0 31 Floating point value with IEEE real 4 format Unit dB 6 14 BASLER A310f Smart Features 24 White Balance CSR Content of the DCAM White Balance CSR 4 Bytes inti Field Bit Description Presence Inq 0 Presence of this feature If 0 the DCAM feature is not avail able and all of its values should be ignored Abs Control 1 Absolute control mode If 1 the DCAM feature is in absolute control mode and the current value can be read from the Absolute Value CSR Otherwise the Value field holds the current raw value setting 2 4 reserved One Push 5 If 1 a one push operation was in progress ON OFF 6 0 The feature was disabled ignore the va
164. re will continue for the length of time you specified in step 1 At the end of the specified exposure time readout and transfer of the captured image will take place The Trigger field in the Software Trigger control register will self clear to 0 when it is safe to begin a new exposure To capture another image wait until the Software Trigger control register has self cleared to 0 Then repeat the above procedure starting with step 2 The Software Trigger register and the Trigger Source field of the Trigger Mode control register are defined in version 1 31 of the IIDC specification The Basler BCAM 1394 Driver does not include a method call to access the software trigger feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the Software Trigger and Trigger Mode registers Contact Basler technical support to ob tain the Smart Features Framework Software Software Trigger Continuous shot Operation In Software Trigger Continuous shot operation a Continuous Shot Command is used to prepare the camera to capture multiple images With this method of operation exposure will begin when the Trigger field of the Software Trigger control register is set to 1 To use this operating method follow this sequence 1 2 3 Use the shutter settings described in Section 3 2 1 to set your desired exposure time Se
165. rigger input can be read 1 Trigger Source 0 Inq 8 Trigger source 0 is present ID 0 1 Trigger Source 1 Ing 9 Trigger source 1 is present ID 1 1 Trigger Source 2 Inq 10 Trigger source 2 is present ID 2 1 Trigger Source 3 Ing 11 Trigger source 3 is present ID 3 1 12 14 Reserved zen Software Trigger Inq 15 Software trigger is present ID 7 1 Trigger Mode 0 Inq 16 Trigger mode 0 is present 1 Trigger Mode 1 Inq 17 Trigger mode 1 is present 1 Trigger Mode 2 Inq 18 Trigger mode 2 is present 0 Trigger Mode 3 Inq 19 Trigger mode 3 is present 0 Trigger Mode 4 Inq 20 Trigger mode 4 is present 0 Trigger Mode 5 Inq 21 Trigger mode 5 is present 0 22 29 Reserved asa Trigger Mode 14 Inq 30 Trigger mode 14 is present 0 Vendor unique trigger mode 0 Trigger Mode 15 Inq 31 Trigger mode 15 is present 0 Vendor unique trigger mode 1 4 15 Configuring the Camera 4 4 2 Control and Status Registers The base address for all camera control and status registers is Bus ID Node ID FFFF FOFO 0000 In each control and status register description an Offset from the Base Address is provided This a byte offset from the above base address The address of a control and status register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as Ox e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit 4 4 2 1 Control and St
166. rt 1 The Strobe 2 signal can only be assigned to physical output port 2 The Strobe 3 signal can only be assigned to physical output port 3 If you start an image exposure and the strobe signal for the previously captured image is still running the running strobe signal ends immediately and the next delay and du ration begin The Strobe Control Output Signal registers are defined in version 1 31 of the IIDC specification The Basler BCAM 1394 Driver does not include a method call to access the strobe control output signal feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the strobe control output signal registers Contact Basler technical support to obtain the Smart Features Framework Software BASLER A310f 3 33 Basic Operation amp Standard Features 3 8 3 34 Parallel Input Output Control A parallel I O control feature is available on A310f cameras The feature allows a user to set the state of the four physical output ports on the camera and to read the state of the four physical input ports To set state of the four physical output ports write values to the fields in the PIO Output register see page 4 42 The value in the Port 0 Out field sets the state of physical output port 0 The value in the Port 1 Out field sets the state of physical output port 1 The value in the Port 2 Out field
167. s The text below describes using the Strobe Signal Function registers for Strobe 0 to enable and parameterize Strobe 0 Strobe 1 Strobe 2 and Strobe 3 are enabled and parameterized in similar fashion by using the respective registers for each strobe Enabling the Strobe 0 Control Feature To enable the Strobe 0 signal Set the value in the On Off field of the Strobe 0 Control register to 1 Set the value in the Signal Polarity field to 0 for a low active signal or 1 for a high active signal as desired Seiting the Delay for Strobe 0 The strobe delay is determined by a combination of two values The first is the setting in the Delay Value field of the Strobe 0 Control register see page 4 45 The second is the Strobe Delay Time Base The Strobe 0 delay will be determined by the product of these two values Strobe 0 Delay Strobe 0 Delay Value Setting x Strobe Delay Time Base The strobe delay time base is fixed at 1 1024 ms by default Strobe 0 delay time is normally adjusted by changing the setting in the Delay Value field of the Strobe 0 Control register The delay value setting can range from 0 to 4095 0x000 to OxFFF So if the setting in the Delay Value field of the Strobe 0 Control register is set to 100 0x064 for example the Strobe 0 delay will be 100 1024 ms or approximately 97 7 us The strobe delay will determine the time between the start of image exposure and when the strobe signal changes state as shown in Fi
168. s on Monochrome Cameras 3 9 1 Standard Formats Modes amp Frame Rates The following standard video formats modes and frame rates are available on A3TIt and ASI2t monochrome cameras Format 0 Mode 1 FrameRate O 320 x 240 YUV 4 2 2 16 bits pixel avg 1 875 fps Format 0 Mode 1 FrameRate 1 320 x 240 YUV 4 222 16 bits pixel avg 3 75 fps Format 0 Mode 1 FrameRate 2 320 x 240 YUV 4 2 2 16 bits pixel avg 7 5 fps Format 0 Mode 1 FrameRate 3 320 x 240 YUV 4 222 16 bits pixel avg 15 fps Format 0 Mode 1 FrameRate 4 320 x 240 YUV 4 222 16 bits pixel avg 30 fps Format 0 Mode 1 FrameRate 5 320 x 240 YUV 4 222 16 bits pixel avg 60 fps Format 0 Mode 3 FrameRateO 640 x 480 YUV 4 2 2 16 bits pixel avg 1 875 fps Format 0 Mode 3 FrameRate 1 640 x 480 YUV 4 2 2 16 bits pixel avg 3 75 fps Format 0 Mode 3 FrameRate 2 640 x 480 YUV 4 2 2 16 bits pixel avg 7 5 fps Format 0 Mode 3 FrameRate 3 640 x 480 YUV 4 2 2 16 bits pixel avg 15 fps Format 0 Mode 3 FrameRate 4 640 x 480 YUV 4 2 2 16 bits pixel avg 30 fps YUV 4 2 2 output is normally associated with color cameras but in this case it is also available on ASTIt and A312t monochrome cameras When one of these cameras is set for YUV 4 2 2 its output will be in the YUV 4 2 2 format but the output will be mono chrome not color This monochrome version of the YUV 4 2 2 format is provided so that the camera can be used with
169. s a full frame shutter and electronic exposure time control Normally exposure time and charge readout are controlled by values transmitted to the camera s control registers via the IEEE 1394 interface Control registers are available to set exposure time and frame rate There are also control registers available to set the camera for single frame capture or continuous frame capture Exposure start can also be controlled via an externally generated trigger ExTrig signal The ExTrig signal facilitates periodic or non periodic start of exposure When exposure start is controlled by a rising ExTrig signal and the camera is set for the programmable exposure mode exposure begins when the trigger signal goes high and continues for a pre programmed period of time Accumulated charges are read out when the programmed exposure time ends At readout accumulated charges are transported from each of the sensor s light sensitive elements pixels to vertical shift registers see Figure 3 1 The charges from the bottom line of pixels in the array are then moved into a horizontal shift register The charges are shifted out of the horizontal shift register As the charges are shifted out of the horizontal shift register they are converted to voltages The voltages are amplified an offset is applied and they are digitized by a 12 bit analog to digital converter ADC Shifting is clocked according to the camera s internal data rate The digitized voltages pass
170. s defined by declaring a left most column a width a top row and a height For example suppose that you specify the left column as 10 the width as 16 the top row as 4 and the height as 10 The area of the array that is bounded by these settings is shown in Figure 3 13 The camera will only transmit pixel data from within the area defined by your settings Information from the pixels outside of the area of interest is discarded Column 012 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Starting Row Row Row 1 Row 2 Row 3 4 Row 4 Row 5 EEE Row 6 Height ROW T a a in Row 8 HEE J Rows Row 9 Bm rH Row 10 is ai Fb Row 11 E B j Row 12 Y Row 13 The camera will Row 14 P only transmit Row 14 the pixel data from this area Row 15 L Row 17 Row 18 Row 19 LLLI OI CLA LO p Starting Column 4 gt Width in Columns Figure 3 13 Area of Interest The AOI feature is enabled by setting the camera to operate in Format 7 Mode O This is accomplished by setting the Format field of the Current Video Format control register see page 4
171. s information to the image data stream Disabling the extended data stream feature switches off all smart features that add information to the image data stream The DCAM values feature will only work when the camera is set for video format 7 Control and Status Register for the DCAM Values Feature Name DCAM Values Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 494DE528 1B84 11D8 8A0C 00105A5BAE55 Field Bit Description Presence Inq 0 Presence of this feature Read only 0 Not Available 1 Available 1 30 Reserved Enable 31 Enable Disable this feature Read write 0 Disable 1 Enable BASLER A310f 6 13 Smart Features DCAM Values Chunk Layout Position Name Description 0 Gain CSR Content of the DCAM Gain CSR 4 Bytes f m Field Bit Description Presence Inq 0 Presence of this feature If 0 the DCAM feature is not avail able and all of its values should be ignored Abs Control 1 Absolute control mode If 1 the DCAM feature is in absolute control mode and the current value can be read from the Absolute Value CSR Otherwise the Value field holds the current raw value setting 2 4 reserved One Push 5 If 1 a one push operation was in progress ON OFF 6 0 The feature was disabled ignore the value 1 The featu
172. s set by the Bytes Per Packet field of the Bytes Per Packet control register The value that appears in the Max Bytes Per Packet field of the Packet Para Inquiry register will show the maximum allowed bytes per packet setting given the current AOI settings When the bytes per packet is set to the maximum the camera will transmit frames at its maximum specified rate By default the AOI is set to use the full sensor area and the bytes per packet is set to 4096 If you setthe bytes per packet to a value lower than the maximum the camera will transmit frames at a lower rate The rate is calculated by the formula 1 Frames s _ Packets per Frame x 125 us Keep in mind that when you lower the bytes per packet setting the number of bytes needed to transmit a frame the packets per frame will increase Due to limitations in the DCAM structure a maximum of 4095 packets per frame is allowed If you set the bytes per packet too low the number of packets per frame will exceed the 4095 packet limit and the camera will not transmit frames properly When the camera is operating in Format 7 the Current Video Frame Rate control reg ister is not used and has no effect on camera operation Color Codings In Format 7 Mode 0 the Mono 8 and Mono 16 color codings are available When the Mono 8 ID is set in the Coding ID field of the Color Coding ID register for Format 7 Mode 0 the camera outputs 8 bits per pixel When t
173. see Sec tion 6 7 1 is disabled The strobe time base smart feature can be enabled regardless of the video format Control and Status Register for the Strobe Time Base Feature Name Strobe Time Base Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID E77E6336 E617 11D8 9653 00105A5BAE55 Position Field Bit Description 0 Presence Inq 0 Presence of the shutter time base feature Read only 0 Not Available 1 Available 1 15 Reserved Duration 16 23 The value in this field is an integer value and can Time Base range between 1 and 85 Read write The value sets the duration time base in units of 1 1024 ms Example If the value in this field is set to 14 the du ration time base will be 14 1024 ms 13 7 us Default 1 Delay Time Base 24 31 The value in this field is an integer value and can Read write range between 1 and 85 The value sets the delay time base in units of 1 1024 ms Example If the value in this field is set to 14 the de lay time base will be 14 1024 ms 13 7 us Default 1 6 40 BASLER A3l0f Smart Features 6 8 Customized Smart Features The Basler A310f has significant processing capabilities and Basler can accommodate customer requests for customized smart features A great advantage of the smart features framework is that it serves as a standardized platform for para
174. sets the state of physical output port 2 The value in the Port 3 Out field sets the state of physical output port 3 Writing to the PIO Output register will only set the state of physical output ports that are configured as User set For any output ports not configured as user set the bit settings in this register will be ignored See Section 6 7 11 for information on configuring physical output ports To determine the current state of the four physical input ports read the contents of the PIO Input register see page 4 42 The value in the Port 0 In field indicates the current state of physical input port 0 The value in the Port 1 In field indicates the current state of physical input port 1 The value in the Port 2 In field indicates the current state of physical input port 2 The value in the Port 3 In field indicates the current state of physical input port 3 The PIO Control registers are defined in version 1 31 of the IIDC specification The Basler BCAM 1394 Driver does not include a method call to access the PIO con trol feature As a work around you can use the techniques described in the tutorial for the Basler Smart Features Framework Software to directly read from or write to the PIO registers Contact Basler technical support to obtain the Smart Features Frame work Software BASLER A310f Basic Operation amp Standard Features 3 9 Available Video Formats Modes amp Frame Rate
175. shown in Figure 3 6 after each image is captured the camera begins reading out the captured image data from the CCD sensor into a buffer in the camera When the camera has determined that a sufficient amount of image data has accumulated in the buffer it will begin transmitting the image data from the camera to the host PC This buffering technique avoids the need to exactly synchronize the clock used for sensor readout with the clock used for data transmission over the IEEE 1394 bus The camera will begin transmitting data when it has determined that it can safely do so without over running or under running the buffer This buffering technique is also an important element in achieving the highest possible frame rate with the best image quality The frame readout time is the amount of time it takes to read out a captured image from the CMOS sensor into the image buffer The frame transmission time is the amount of time it takes to transmit the captured image from the buffer in the camera to the host PC via the IEEE 1394 bus The transmission start delay is the amount of time between the point where the camera begins reading out a captured image into the buffer to the point where it begins transmitting the data for the captured image from the buffer to the host PC 3 12 BASLER A310f Basic Operation amp Standard Features TIMING CHARTS ARE NOT DRAWN TO SCALE
176. sor Controller Isochronous and Asynchronous Data Control Control AOI Gain Brtness Micro controller Asynchronous Data Figure 3 2 A310f Block Diagram Physical IEEE Layer 1394 Controller sochronous Bus and Asynchronous Data BASLER A310f Basic Operation amp Standard Features 3 2 Exposure Control 3 2 1 Setting the Exposure Time Exposure time is determined by a combination of two values The first is the setting in the Value field of the Shutter control register see page 4 23 The second is the Shutter Time Base Exposure time is determined by the product of these two values Exposure Time Shutter Value Setting x Shutter Time Base The shutter time base is fixed at 20 us by default Exposure time is normally adjusted by changing the setting in the Value field of the Shutter control register The shutter value setting can range from 1 to 4095 0x001 to OxFFF So if the Value field of the Shutter register is set to 100 0x064 for example the exposure time will be 100 x 20 us or 2000 us As mentioned above the shutter time base is normally fixed at 20 us and the exposure time is normally adjusted by changing the shutter value setting However if you require an exposure time that is shorter or longer than what you can achieve by changing the shutter value alone the shutter time base can also be changed The Shutter Time Base smart feature can be used to change the shutter time base F
177. ss 0x408 Field Bit Description A311f A311fc A312f A312fc Value Zoom 0 Zoom control availability 0 Pan 1 Pan control availability 0 Tilt 2 Tilt control availability 0 Optical Filter 3 Optical filter control availability 0 4 15 Reserved see Capture Size 16 Format 6 capture size availability 0 Capture Quality 17 Format 6 capture quality availability 0 18 31 Reserved Register Name Optional Function Inquiry Offset from Base Address 0x40C Field Bit Description A311f A311fc A312f A312fc Value 0 Reserved PIO 1 Parallel input output control availability 1 SIO 2 Serial input output control availability 0 Strobe Output 3 Strobe output control availability 1 4 91 Reserved zem Register Name Advanced Features Inquiry Offset from Base Address 0x480 Field Bit Description Advanced Feature 0 81 Indicates the quadlet offset from the base address of the initial register Quadlet Offset space for the advanced features Control and Status Registers CSR All A310f cameras support advanced vendor unique features BASLER A310f Configuring the Camera Register Name PIO Control CSR Inquiry Offset from Base Address 0x484 Field Bit Description PIO Control 0 81 Indicates the quadlet offset from the base address of the initial register Quadlet Offset space for the PIO Control and Status Registers CSR All
178. standard frame rate 1 Frame Rate 6 6 120 fps standard frame rate 0 Frame Rate 7 T 240 fps standard frame rate 0 MER 8 81 Reserved Register Name Video Frame Rate Inquiry for Format 0 Mode 6 Offset from Base Address 0x218 Field Bit Description A311f A311fc A312 A312fc Value Frame Rate 0 0 1 875 fps standard frame rate 0 Frame Rate 1 1 3 75 fps standard frame rate 1 Frame Rate 2 2 7 5 fps standard frame rate 2 Frame Rate 3 3 15 fps standard frame rate 3 Frame Rate 4 4 30 fps standard frame rate 4 Frame Rate 5 5 60 fps standard frame rate 0 Frame Rate 6 6 120 fps standard frame rate 0 Frame Rate 7 7 240 fps standard frame rate 0 E 8 81 Reserved s BASLER A3IOf Configuring the Camera 4 4 1 5 Inquiry Registers for Format 7 CSR Offsets Register Name Video CSR Inquiry for Format 7 Mode 0 Offset from Base Address Ox2EO0 Field Bit Description Mode 0 0 81 Indicates the quadlet offset from the base address of the initial register space for the Format 7 Mode 0 Control and Status Register CSR All A310f cameras support Format 7 Mode 0 Register Name Video CSR Inquiry for Format 7 Mode 1 Offset from Base Address Ox2E4 Field Bit Description Mode 1 0 81 Indicates the quadlet offset from the base address of the initial register space for the Format 7 Mode 1 Control and Status Register CSR The A311fc and A312fc support Format 7
179. t The DCAM standard also outlines a set of Advanced Features registers These registers can be used to implement vendor unique features not defined in the standard The Basler Smart Features Framework takes advantage of these registers to implement features such as a frame counter and test images See Section 6 for more information The BCAM Driver A fully functional driver is available for Basler IEEE 1394 cameras such as the A310f The Basler BCAM 1394 Driver Software Development Kit includes an API that allows a C programmer to easily integrate camera configuration and operating functions into your system control software The driver also includes a Windows based viewer program that provides camera users with quick and simple tools for changing camera settings and viewing captured images The BCAM 1394 Driver SDK comes with comprehensive documentation including a programmer s guide and code samples For more information visit the Basler web site at www baslerweb com BASLER A310f 4 1 Configuring the Camera 4 1 Block Read and Write Capabilities The camera supports block reads and block writes If you do a single read or a block read the camera will return a O for all non existent registers If you do a single write to a non existent register or a block write that includes non existent registers the writes to non existent registers will have no effect on camera operation Block reads or writes are limited to a payload of 32
180. t at which exposure start for the next frame can be triggered For more information about the TrigRdy signal see Section 3 2 9 The assignment of camera output signals to physical output ports can be changed by the user See Section 6 7 11 for more information about configuring output ports By default output ports 0 1 and 2 are set to a low state after power on Output port 3 is initially set to low but will go high approximately 100 to 300 ms after power on Output port 3 will remain high for approximately 750 ms and will then reset to low BASLER A310f 2 5 Camera Interface 10 Pin RJ 45 Jack Out 3 Out 2 Out 1 Out 0 In 0 In Gnd Com In Gnd Comm Out VCC Com In 24 In 14 560 Q Out VCC Com In 3 1 2 3 4 5 6 7 8 9 o Cable Shields 4 Cable Shields 1M Gnd PS2805C 4 or PC3Q64Q Shield To IEEE 1394a 2000 Compliant Physical Layer Controller IEEE Camera Power In 1394 Socket Figure 2 3 I O Schematic 2 6 BASLER A3l0f Camera Interface 2 5 3 Typical Input Circuits Figure 2 4 shows a typical 5 VDC circuit you can use to input a signal into the camera In Figure 2 4 the signal is applied to input port 1 Your Gnd 5 VDC e Your Gnd NV 4A OO 0 Qo 10 Pin RJ 45 Jack Figure 2 4 Typical 5 VDC Input Circuit Figure 2 5 shows a typical 24 VDC circuit you can use to input a signal into the camera Notice that a
181. t of the length Transferring both the chunk length and the bitwise complement of the length serves as a mechanism to detect transmission errors If the last four bytes of a chunk aren t the bitwise complement of the preceding four bytes the chunk s length information isn t valid and this indicates that a transmission error occurred BASLER A310f 6 7 Smart Features 6 8 There are different types of chunks for example the chunk that is added when the cycle time stamp smart feature is enabled and the chunk that is added when the frame counter smart feature is enabled Although most chunks follow the general structure described in Table 6 1 each type of chunk has unique aspects to its layout To allow you to distinguish between the chunks each chunk carries a chunk GUID The GUID for each chunk is transferred just before the chunk s length information If you look through the descriptions of the smart features in Section 6 7 you will notice that for smart features which add a chunk to the image data stream there is a description of the layout of the chunk and the chunk GUID associated with the chunk A chunk s length field contains the chunk s total length in bytes The GUID the length and the inverted length are included as part of the total chunk length By appending length information and a chunk GUID to each chunk the camera sends a self describing data stream and allows easy navigation through the individual chunks that make u
182. t port configuration smart feature does not add information to the image data stream and can be accessed even when the extended data stream feature see Section 6 7 1 is disabled The output port configuration feature is always enabled regardless of the video for mat By default the Integrate Enabled signal is assigned to physical output port 0 and the Trigger Ready Signal is assigned to physical output port 1 BASLER A310f 6 33 Smart Features Control and Status Registers for the Output Port Configuration Feature Name Output Port 0 Configuration Address See Determining the Address of Smart Features CSRs on page 6 4 CSR GUID 5A889D7E 41E5 11D8 845B 00105A5BAE55 Position Field Bit Description 0 Presence Inq 0 Presence of the output port 0 configuration feature Read only 0 Not Available 1 Available Monitor Inq 1 Presence of the monitor field Read only 0 Not Available 1 Available Invert Inq 2 Presence of the invert field Read only 0 Not Available 1 Available User Setting Inq 3 Presence of the user setting field Read only 0 Not Available 1 Available 4 26 Reserved Source Select 27 31 Write a value to select a signal for output port 0 Read write 0 Integrate Enabled signal 1 Trigger Ready signal 3 User set state can be set with the User Setting field described below 4 Strobe 4 Source Select Inq 0
183. t the Continuous Shot field in the ISO En Continuous Shot control register to 1 see page 4 18 This prepares the camera to capture multiple images Set the Trigger field in the Software Trigger control register to 1 see page 4 20 This starts the exposure Exposure will continue for the length of time you specified in step 1 At the end of the specified exposure time readout and transfer of the captured image will take place To capture another image repeat the above procedure starting with step 3 When you are triggering exposure start with a software trigger you must not capture frames at a rate that exceeds the maximum allowed for the current settings See Section 3 4 2 for more information about the maximum frame capture rate Note that the camera will only react to the software trigger when it is safe to begin a new exposure that is the Trigger field in the Software Trigger control register has self cleared to 0 To make sure that you do not overtrigger the camera read out the Trigger field in the Software Trigger control register and wait until the Software Trigger control register has self cleared to 0 before you trigger each next exposure To disable continuous shot operation set the Continuous Shot field in the ISO En Continuous Shot control register to 0 BASLER A310f Basic Operation amp Standard Features The Software Trigger register and the Trigger Source field of the Trigger Mode control register are define
184. ta Stream 6 eens 6 9 6 7 2 Frame Counter 0 0 ee tee rn 6 11 6 7 3 Gycle Time Stamp renee Tani eck eaeds a maueadd eta cag epi bie 6 12 6 7 4 DCAM Values 20 000 teen eee e nes 6 13 6 7 5 CRC Checksum 0 0 0 eee nets 6 16 6 7 6 Test Images boe orai Rer aed Yao eds Wa eae EA 6 19 6 7 7 Extended Version Information 0200 cece eee eee 6 25 6 7 8 Lookup Table 0 aa a eee 6 26 BASLER A310f ll Contents 6 7 9 Lossless Compression 0000 ccc eee eee see 6 31 6 7 10 Trigger Flag and Trigger Counter 0 000 c cece eee ee 6 32 6 7 11 Output Port Configuration 00 eee 6 33 6 7 12 Startup Memory Channel 00 0c eects 6 36 6 7 13 Shutter Time Base 0000 cette 6 37 6 7 14 Strobe Time Base 0 0 00 cee ees 6 39 6 8 Customized Smart Features 0600 c ec tee eee 6 41 7 Mechanical Considerations 7 1 Camera Dimensions and Mounting Facilities 000 00 eee 7 2 7 2 Sensor Positioning Accuracy 0 00 eee 7 3 7 3 Maximum Lens Thread Length on the A310fc 0 0 eee eee 7 4 8 Technical Support 8 1 Technical Support Resources 0 00 e eens 8 1 8 2 Obtaining an RMA Number 000 cece eee eee 8 1 8 3 Before Calling Basler Technical Support liliis 8 1 FGVISION FUSION soo ori vendiendo Ope oe beca Sia o Eats Hane Doe Ruinen i ndek ainara a ado a Lacus a es a Ree na jii IV BASLER A310
185. tart The camera can be programmed to begin exposure on a rising edge or on a falling edge of an ExTrig signal Also two modes of exposure control are available program mable and level controlled see Section 3 2 5 For this illustration we are assuming that a rising edge trigger and the programmable exposure mode are used If a camera user requires close control of exposure start there are several general guidelines that must be followed The camera should be placed in continuous shot mode The user must use an external trigger ExTrig signal to start exposure The user must monitor the trigger ready TrigRdy signal Arising edge of the ExTrig signal must only occur when the TrigRdy signal is high Assuming that these general guidelines are followed the reaction of the camera to a rising external trigger signal will be as shown in Figure 3 6 The start of exposure will occur between 0 us and 28 us A3TIf O us and 32 us A312f after the rise of the ExTrig signal The integrate enabled IntEn signal will rise between 5 and 20 us after the start of exposure The actual length of exposure will be equal to the programmed exposure time The IntEn signal will fall between 30 and 100 us after the end of exposure For information about operating the camera in overlap mode where exposure of a new image begins while the previous image is being read out see Section 3 2 8 3 2 7 Frame Buffering As
186. tarted Error Flag 2 Indicates whether the value in the Bytes per Packet register is accept able 0 acceptable 1 not acceptable and no image capture can be started This field is updated whenever a value is written in the Bytes per Packet register 10 31 Reserved BASLER A310f 4 41 Configuring the Camera 4 42 4 4 2 6 Control and Status Registers for the PIO Control Function The base address for the PIO Control Function control and status registers is Bus ID Node ID FFFF F2F0 00C8 In each PIO register description an Offset the from Base Address is provided This a byte offset from the above base address The address of a PIO register equals the above base address plus the indicated offset Values are stated in decimal format except when marked Ox Values marked as 0x e g 0x123 are in hexadecimal format Bit 0 in each register is the most significant bit Register Name PIO Output Offset from Base Address 0x000 Field Bit Description 0 27 Reserved Port 3 Out 28 Sets the state of physical output port 3 0 low 1 high Port 2 Out 29 Sets the state of physical output port 2 0 low 1 high Port 1 Out 30 Sets the state of physical output port 1 0 low 1 high Port 0 Out 31 Sets the state of physical output port 0 0 low 1 high D The PIO Output register can only set the state of a physical output port if that port is co
187. tegrate Enabled Signal The Integrate Enabled IntEn signal goes high when exposure begins and goes low when exposure ends This signal can be used as a flash trigger and is also useful when you are operating a system where either the camera or the object being imaged is movable For example assume that the camera is mounted on an arm mechanism and that the mechanism can move the camera to view different portions of a product assembly Typically you do not want the camera to move during exposure In this case you can monitor the IntEn signal to know when exposure is taking place and thus know when to avoid moving the camera By default the IntEn signal is assigned to physical output port 0 on the camera See Section 2 5 2 for a description of the electrical characteristics of the camera s physical output ports The assignment of the IntEn signal to a physical output port can be changed See Section 6 7 11 for more information on changing the assignment of camera output signals to physical output ports and the fall of the signal in relation to the start and the end of exposure See Figure When you use the integrate enabled signal be aware that there is a delay in the rise 3 6 for details BASLER A310f 3 3 Gain and Brightness The major components in the A310f electronics include a CCD sensor one VGC Variable Gain Control and one ADC Analog to Digital Converter The pixels in the CCD sensor output voltage sig
188. tion is added to each image as trailing data when the image is transmitted from the camera Examples of this type of smart feature are the Cycle Time Stamp feature and the CRC Checksum When the Cycle Time Stamp feature is enabled after an image is captured the camera determines when the acquisition occurred and develops a cycle time stamp for the image And if the CRC Checksum feature is enabled the camera calculates a checksum for the image The cycle time stamp and checksum are added as trailing data to each image as the image is transmitted from the camera What Is the Smart Features Framework The first component of the Smart Features Framework SFF is a mechanism that allows you to enable and to parameterize smart features This mechanism is essentially an extension of the register structure defined in the DCAM specification for use with Advanced Features The SFF establishes a register for each smart feature By setting bits within the register for a particular smart feature you can enable the feature and control how the feature operates When certain smart features are enabled the camera actually develops some sort of data about each image that it acquires For example when the Cycle Time Stamp feature is enabled the camera creates a time stamp for each image based on when the image exposure started In the cases where a smart feature develops some sort of data about a captured image the smart feature s data is added as trailing data
189. tions 3 9 and 3 10 to determine the video formats supported on A310f cameras E 3 81 Reserved Register Name ISO Offset from Base Address 0x60C Field Bit Description ISO Channel L 0 3 Sets the isochronous channel number for video transmission for the legacy mode 0 channel 0 6 channel 6 11 channel 11 1 channel 1 7 channel 7 12 channel 12 2 channel 2 8 channel 8 13 channel 13 3 channel 3 9 channel 9 14 channel 14 4 channel 4 10 channel 10 15 channel 15 5 channel 5 Default 0 on all A310f cameras ite 4 5 Reserved Iso Speed L 6 7 Sets the isochronous transmit speed code for the legacy mode 0 100M 1 200M 2 400M Default 2 on all A310f cameras 8 15 Reserved Operation Mode 16 Sets the 1394 operation mode 0 Legacy 1 1394 b Default 0 on all A310f cameras A310f cameras do not support 1394b 17 Reserved Iso Channel B 18 23 Not supported on the A310f cameras 24 28 Reserved Iso Speed B 29 31 Not supported on the A310f cameras BASLER A310f 4 17 Configuring the Camera Register Name ISO EN Continuous Shot Offset from Base Address 0x614 Field Bit Description Continuous Shot 0 When the camera is set for video Format 0 or Format 7 this field con trols the continuous shot video transmission mode 1 start continuous shot transmission 0 stop
190. to each image as the image is transmitted from the camera The SFF provides a mechanism for parsing the smart features data added to images transmitted out of the camera by assigning a unique identifier GUID to each smart feature Whenever the camera adds data for a smart feature to an image it includes the GUID for the smart feature as BASLER A310f 6 1 Smart Features part of the added data The GUIDs are especially useful when you enable several smart features that add data to the image stream The GUIDs make it possible to identify which portion of the added data is the result of each enabled smart feature Refer to Sections 6 6 and 6 7 for detailed information about getting smart features results 6 3 What Do I Need to Use Smart Features To use smart features you will need A camera that supports smart features Not all camera models support smart features And with some camera models that do support smart features you may find that older cameras may not support all available smart features or may not support smart features at all Section 6 5 contains information about checking a camera to see if it supports smart features A method of accessing the camera s DCAM register structure We strongly recommend that you use the Basler BCAM 1394 Driver v1 7 or higher along with the Basler Smart Features Framework software to access the registers See Section 6 4 for more information about the SFF Software driver that can get
191. trigger the next image and will resume running in overlapped mode 1 The term non overlapped mode means that image capture is triggered in the following manner the camera captures exposes an image and completely transmits that image out of the camera before the next image capture is triggered In other words exposure and transmission of image N are both completed before exposure of image N 1 begins The term overlapped mode means that image capture is triggered in the following manner the camera captures exposes an image and while this image is being transmitted out of the camera capture of the next image is triggered In other words capture of image N 1 begins while transmission of image N is still in progress 3 24 BASLER A3l0f Basic Operation amp Standard Features 3 4 2 Changes to the Frame Rate with AOI In general the maximum frame rate for A310f cameras increases as the number of lines in the AOI decreases However the maximum frame rate can also be limited by any one of three factors The amount of time it takes to read out a captured image from the image sensor to the frame buffer The amount of time it takes to transmit an image from the frame buffer to the PC via the IEEE 1394 bus The exposure time setting To determine the maximum frame rate for a given AOI use your AOI and exposure time settings to calculate a result in each of the three formulas below These formulas take your AOI size into acco
192. ts 4 x opto isolated 5 VDC nominal 10 mA nominal Characteristics Outputs 4 x opto isolated 2 to 35 VDC maximum forward voltage 100 mA max collector current See Sections 2 5 1 and 2 5 2 for more details Max Cable 1394 4 5 m specified 10 m tested Lengths VO 10m See Section 2 2 for more details Lens Adapter C mount Housing Size Without lens adapter 42 mm x 62 mm x 62 mm Lx WxH With C mount adapter 49 mm x 62 mm x 62 mm Weight 210g Conformity CE FCC IP30 Table 1 1 A310t Performance Specifications BASLER A310f 1 3 Camera Models A310f series cameras are available in different models The model depends on the sensor size and whether the camera is monochrome or color Table 1 2 lists the available camera models Introduction Throughout this manual the camera will be called the A310f Passages that are only valid for a specific model will be so indicated Camera Version Mono Color Sensor Size A3lit Mono 659 H x 494 V A3lltc Color 658 H x 492 V A312f Mono 782 H x 582 V A312fc Color 780 H x 580 V Table 1 2 A310f Camera Models BASLER A310f Introduction 1 4 Spectral Response The spectral response for A310f monochrome cameras is shown in Figure 1 2 1 4 1 0 0 9 0 8 0 7 0 6 0 5 0 4 Relative Response 0 3 0 2 0 1 0 400 500 600 700 800 900 1000 Wave Length nm Figure 1 2
193. tter settings described in Section 3 2 1 to set your desired exposure time 2 Setthe One Shot field of the One Shot Multi Shot control register to 1 3 Check the state of the TrigRdy signal a If TrigRdy is high you can toggle ExTrig when desired BASLER A310f Basic Operation amp Standard Features b If TrigRdy is low wait until TrigRdy goes high and then toggle ExTrig when desired See Section 3 2 9 for more about TrigRdy 4 When ExTrig rises exposure will begin Exposure will continue for the length of time you specified in step 1 5 Atthe end of the specified exposure time readout and transmission of the captured image will take place The One Shot field of the One Shot Multi Shot control register is self cleared after image transmission ExTrig Continuous shot Operation In ExTrig Continuous shot operation a Continuous shot command is used to prepare the camera to capture multiple images With this method of operation exposure will begin on each rising edge of the ExTrig signal To use this operating method follow this sequence 1 Use the shutter settings described in Section 3 2 1 to set your desired exposure time 2 Setthe Continuous Shot field of the ISO En Continuous Shot control register to 1 see page 4 18 3 Check the state of the TrigRdy signal a If TrigRdy is high you can toggle ExTrig when desired b If TrigRdy is low wait until TrigRdy goes high and then toggle ExTrig when desired S
194. ue for Po Bo Low byte of red value for P Bo Low byte of green value for P4 B3 High byte of red value for P4 B3 High byte of green value for P4 B4 Low byte of green value for Ps B4 Low byte of blue value for P Bs High byte of green value for P Bs High byte of blue value for P3 Bg Low byte of red value for P5 Bg Low byte of green value for P5 B High byte of red value for P4 B High byte of green value for P4 e e e e e e e e e e e e Bm 7 Low byte of green value for P 3 Bm 7 Low byte of blue value for Ph 3 Bm High byte of green value for P 3 Bm 6 High byte of blue value for P4 Bm 5 Low byte of red value for P Bm 5 Low byte of green value for Py Bm 4 High byte of red value for P Bm 4 High byte of green value for Ph 2 Bm 3 Low byte of green value for Py Bm 3 Low byte of blue value for Ph 1 Bm 2 High byte of green value for Py Bm 2 High byte of blue value for P Bm 1 Low byte of red value for Ph Bm 1 Low byte of green value for Ph Bm High byte of red value for Ph Bm High byte of green value for Ph BASLER A3l0f For Filter ID 3 BG GR Image Data Structures amp Formats Even Lines Odd Lines Byte Data Byte Data Bo Low byte of blue value for Po Bo Low byte of green value for Po B4 High byte of blue value for Pg B4 High byte of green value for Po Bo Low byte of green value for P4 Bo
195. uld be ignored Trigger Mode 12 15 Sets the trigger mode 0 mode 0 programmable mode 1 mode 1 level mode Default 1 on all A310f cameras When an external trigger signal is used mode 0 and mode 1 are both valid When a software trigger is used only mode 0 is valid See Sec tion 3 2 for more information on exposure modes 16 19 Reserved Parameter 20 31 Not used on A310f cameras These bits should be ignored 4 25 Configuring the Camera 4 26 4 4 2 3 Error Status Registers for Feature Control As defined in the IIDC specification each field in this register is an error or warning flag for the corresponding feature control register If a bit 2 1 the mode and or value of the corresponding feature control register has an error or warning If a bit 0 no error or warning is present Each field in this register will be updated whenever the corresponding feature control register is updated If a bit 1 we strongly recommend checking the corresponding control register On A310f cameras a feature s bit will become 1 when the feature s setting is outside the specified range of allowed settings that is the setting is lower than the allowed minimum or higher than the allowed maximum If this situation occurs A310f cameras will continue image capture and you will see the undesired effects that result from the setting Register Name Feature Control Error Status High
196. unt plus the three factors that can limit the frame rate The formula that returns the lowest value will determine the maximum frame rate for the given AOI Formula 1 calculates the maximum frame rate based on the sensor readout time 1 Max F s ee Frame Readout Time The frame readout time is calculated using the formulas on page 3 13 Formula 2 calculates the maximum frame rate based on the frame transmission time 1 Max F a Pramas Packets frame x 125 us Formula 3 calculates the maximum frame rate based on the exposure time ASIlf c 1 Max Frames s _ _ i Exposure Time in us 81 5 us ASI2t c 1 Max Frames s Exposure Time in us 94 9 us BASLER A310f 3 25 Basic Operation amp Standard Features Example Assume that your camera is an A3llf that it is set for Format 7 Mode 0 that your AOI is set for 100 columns wide and 110 rows high and that your exposure time is set for 2000 us Also assume that after making all camera settings you check the Packet Per Frame Inquiry register in the control and status registers for Format 7 You find that the packets per frame with the current settings is 3 The number of packets per frame depends on the setting of the Format 7 Mode 0 Bytes Per Packet control register In this example we assume that the bytes per packet is set to the maximum See Sections 3 9 2 and 3 1
197. user set If an output port is designated as user set its state can be set to high or low by using the User Setting field in the CSR for the port The Invert field can be used to invert the signal before it is applied to the output port and the Monitor field can be used to check the current state of the output port When using the output port configuration feature you should follow this sequence 1 Read the Presence Inq field and the Source Select Inq field for the physical port you want to work with Determine whether the port configuration feature is available for the port and if the source for the port is selectable 2 Use the Source Select field to select a source for the output port If you select User set as the source the state of the physical output port may change when you set the bits in the Source Select field This is an artifact of the camera design 3 Checkthe Monitor Inq Invert Inq and User Setting Inq fields The state of these fields will tell you if the Monitor Invert and User Setting fields are available The availability of the Monitor Invert and User Setting fields will vary depending on the selected source 4 fthe Invert field is available set the field as desired 5 f you selected User set as the source use the User Setting field to set the state of the output as desired 6 If the Monitor field is available use the field as desired to check the current state of the output The outpu
198. ved Version Info n Bytes An ASCII character string that includes the version numbers for the camera s internal software The length of this string field is equal to the number of quadlets given in the length field above The ASCII character string in the Version Info field contains the camera s firmware ID number You can read the string to determine your camera s firmware ID The ID number s position in the string is described in Section 1 1 BASLER A310f 6 25 Smart Features 6 26 6 7 8 Lookup Table The A310f camera has a sensor that reads pixel values at a 12 bit depth however the camera can be set to output pixel values at an 8 bit depth When set for 8 bit output the camera normally uses an internal process to convert the 12 bit pixel values from the sensor to the 8 bit values transmitted out of the camera A310f cameras also include a smart feature that allows you to use a custom lookup table to map the 12 bit sensor output to 8 bit camera output rather than using the internal process The lookup table is essentially just a list of 4096 values however not every value is the table is actually used If we number the values in the table from 0 through 4095 the table works like this The number at location 0 in the table represents the 8 bit value that will be transmitted out of the camera when the sensor reports that a pixel has a value of 0 The numbers at locations 1 through 7 are not use
199. w 0 Pixel 781 Row 1 Pixel 0 Row 1 Pixel 1 Row 1 Pixel 2 Row 1 Pixel 780 Row 1 Pixel 781 Row 2 Pixel 0 Row 2 Pixel 1 Row 2 Pixel 2 Row 2 Pixel 780 Row 2 Pixel 781 Row 579 Pixel 0 Row 579 Pixel 1 Row 579 Pixel 2 Row 579 Pixel 780 Row 579 Pixel 781 Row 580 Pixel 0 Row 580 Pixel 1 Row 580 Pixel 2 Row 580 Pixel 780 Row 580 Pixel 781 Row 581 Pixel 0 Row 581 Pixel 1 Row 581 Pixel 2 Row 581 Pixel 780 Row 581 Pixel 781 Pixel data is transmitted from the camera in the following sequence on the A312fc Row 0 Pixel 0 Row 0 Pixel 1 Row 0 Pixel 2 Row 0 Pixel 778 Row 0 Pixel 779 Row 1 Pixel 0 Row 1 Pixel 1 Row 1 Pixel 2 Row 1 Pixel 778 Row 1 Pixel 779 Row 2 Pixel 0 Row 2 Pixel 1 Row 2 Pixel 2 Row 2 Pixel 778 Row 2 Pixel 779 Row 577 Pixel 0 Row 577 Pixel 1 Row 577 Pixel 2 Row 577 Pixel 778 Row 577 Pixel 779 Row 578 Pixel 0 Row 578 Pixel 1 Row 578 Pixel 2 Row 578 Pixel 778 Row 578 Pixel 779 Row 579 Pixel 0 Row 579 Pixel 1 Row 579 Pixel 2 Row 579 Pixel 778 Row 579 Pixel 779 These sequences assume that the camera is set for full resolution 5 2 BASLER A3l0f Image Data Structures amp Formats 5 2 Packet Payload Charts for Standard Format Mode and Frame Rate Combinations on A310f Cameras The following charts describe the packet payload for
200. when the 12 bit pixel value from the sensor is 16 6 28 BASLER A310f Smart Features 16300 16324 Quadlet 4073 4079 7 Quadlets Not used The values written here will be Read write ignored 16328 Quadlet 4080 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 4080 16332 16356 Quadlet 4081 4087 7 Quadlets Not used The values written here will be Read write ignored 16360 Quadlet 4088 1 Quadlet Defines the 8 bit value that will be transmit Read write ted from the camera when the 12 bit pixel value from the sensor is 4088 16364 16388 Quadlet 4089 4095 7 Quadlets Not used The value written here will be ig Read write nored BASLER A310f 6 29 Smart Features 6 30 Using the SFF Viewer to Upload a Lookup Table The Configurator window in the Basler SFF Viewer see Section 6 4 includes a drop down list that can be used to enable the lookup table feature It also includes an Upload button that can be used to easily load a text file containing a customized lookup table into the camera The file must be plain text and must be formatted correctly The file must have 4096 lines with each line containing two comma separated values The first value on each line represents a 12 bit pixel reading from the sensor and the second value represents the correspond
201. with the camera set for rising edge triggering ExTrig Period Exposure determined by shutter settings Figure 3 4 Programmable Exposure with Rising Edge Triggering BASLER A3l0f Basic Operation amp Standard Features Level Controlled Exposure Mode When level controlled mode is selected the start of exposure and the length of the exposure are both controlled by the ExTrig signal If the camera is set for rising edge triggering exposure begins when the ExTrig signal rises and continues until the ExTrig signal falls If the camera is set for falling edge triggering exposure begins when the ExTrig signal falls and continues until the ExTrig signal rises Figure 3 5 illustrates level controlled exposure with the camera set for rising edge triggering Level controlled exposure is especially useful if you intend to vary the length of the exposure time for each captured image ExTrig Period j e Min Exposure determined by shutter settings Figure 3 5 Level Controlled Exposure with Rising Edge Triggering When you operate the camera in level controlled mode you are required to set an exposure time by using the shutter settings as described in Section 3 2 1 In level controlled operation the exposure time determined by the shutter settings represents an absolute minimum time for each exposure For each full cycle of the ExTrig signal f the exposure time as controlled by the ExTrig signal is less than or equal
Download Pdf Manuals
Related Search
Related Contents
Manual Fabricante Alcatel-Thomson 510 v4.2.7 JVC GM-V42EB User's Manual RIDGID RSM33 Instructions / Assembly ManualCubiertasAjover Manual de usuario Partner on iOS User Manual Massive Suspension light 36841/17/10 Sandberg Solar Power Bank 2000 mAh Valueline VLCB89300T wire connector Copyright © All rights reserved.
Failed to retrieve file