#pragma once #include /* CAMERALINK PROTOCOL DEFINITIONS TO MANAGE RAPTOR EAGLE V 4240 CAMERA */ /* from EAGLE V 4240 Instruction Manual Revision 1.1 */ // default port settings // the values are ones for EB1 grabber card (see XCLIB Reference manual) // default read/write operation timeout in milliseconds (1 second) static constexpr std::chrono::duration CL_DEFAULT_TIMEOUT = std::chrono::milliseconds(1000); static constexpr int CL_DEFAULT_BAUD_RATE = 115200; static constexpr int CL_DEFAULT_START_BIT = 1; static constexpr int CL_DEFAULT_DATA_BITS = 8; static constexpr int CL_DEFAULT_STOP_BIT = 1; static constexpr bool CL_DEFAULT_ACK_ENABLED = true; static constexpr bool CL_DEFAULT_CHK_SUM_ENABLED = true; // ETX/ERROR codes static constexpr char CL_ETX = 0x50; static constexpr char CL_ETX_SER_TIMEOUT = 0x51; static constexpr char CL_ETX_CK_SUM_ERR = 0x52; static constexpr char CL_ETX_I2C_ERR = 0x53; static constexpr char CL_ETX_UNKNOWN_CMD = 0x54; static constexpr char CL_ETX_DONE_LOW = 0x55; /* BIT MASKS (0-7 bits) */ // system state static constexpr size_t CL_SYSTEM_STATUS_FPGA_EEPROM_COMMS_BIT = 0; static constexpr size_t CL_SYSTEM_STATUS_FPGA_RST_HOLD_BIT = 1; static constexpr size_t CL_SYSTEM_STATUS_FPGA_BOOT_OK_BIT = 2; static constexpr size_t CL_SYSTEM_STATUS_ACK_BIT = 4; static constexpr size_t CL_SYSTEM_STATUS_CK_SUM_BIT = 6; static constexpr char CL_SYSTEM_STATUS_CK_SUM = 0x40; // 6-th bit static constexpr char CL_SYSTEM_STATUS_ACK = 0x10; // 4-th bit static constexpr char CL_SYSTEM_STATUS_FPGA_BOOT_OK = 0x4; // 2-nd bit static constexpr char CL_SYSTEM_STATUS_FPGA_RST_HOLD = 0x2; // 1-st bit static constexpr char CL_SYSTEM_STATUS_FPGA_EEPROM_COMMS = 0x1; // 0-th bit namespace details { static constexpr std::string_view cl_system_status_bit(const size_t pos) { return pos == CL_SYSTEM_STATUS_FPGA_EEPROM_COMMS_BIT ? "FPGA COMMS EPROM ENABLED" : pos == CL_SYSTEM_STATUS_FPGA_RST_HOLD_BIT ? "HOLD FPGA RST" : pos == CL_SYSTEM_STATUS_FPGA_BOOT_OK_BIT ? "FPGA BOOTED OK" : pos == CL_SYSTEM_STATUS_ACK_BIT ? "COMM ACK ENABLED" : pos == CL_SYSTEM_STATUS_CK_SUM_BIT ? "CHECKSUM ENABLED" : "UNKNOWN"; } } // namespace details // FPGA CTRL register static constexpr size_t CL_FPGA_CTRL_REG_HIGH_GAIN_BIT = 7; // 7-th bit (0 if high pre-amp gain) static constexpr size_t CL_FPGA_CTRL_REG_TEMP_TRIP_RST_BIT = 1; // 1-st bit static constexpr size_t CL_FPGA_CTRL_REG_ENABLE_TEC_BIT = 0; // 0-th bit static constexpr char CL_FPGA_CTRL_REG_HIGH_GAIN = 0x80; // 7-th bit (0 if high pre-amp gain) static constexpr char CL_FPGA_CTRL_REG_TMP_TRIP_RST = 0x2; // 1-st bit static constexpr char CL_FPGA_CTRL_REG_ENABLE_TEC = 0x1; // 0-th bit namespace details { static constexpr std::string_view cl_fpga_ctrl_reg_bit(const size_t pos) { return pos == CL_FPGA_CTRL_REG_HIGH_GAIN_BIT ? "HIGH GAIN ENABLED" : pos == CL_FPGA_CTRL_REG_TEMP_TRIP_RST_BIT ? "OVERTEMP TRIPPED" : pos == CL_FPGA_CTRL_REG_ENABLE_TEC_BIT ? "TEC ENABLED" : "UNKNOWN"; } } // namespace details // trigger mode static constexpr size_t CL_TRIGGER_MODE_ENABLE_RISING_EDGE_BIT = 7; static constexpr size_t CL_TRIGGER_MODE_EXT_TRIGGER_BIT = 6; static constexpr size_t CL_TRIGGER_MODE_ABORT_CURRENT_EXP_BIT = 3; static constexpr size_t CL_TRIGGER_MODE_CONTINUOUS_SEQ_BIT = 2; static constexpr size_t CL_TRIGGER_MODE_FIXED_FRAME_RATE_BIT = 1; static constexpr size_t CL_TRIGGER_MODE_SNAPSHOT_BIT = 0; static constexpr unsigned char CL_TRIGGER_MODE_EXT_RISING_EDGE = 0b11000000; static constexpr unsigned char CL_TRIGGER_MODE_EXT_FALLING_EDGE = 0b01000000; static constexpr unsigned char CL_TRIGGER_MODE_FFR = 0b00000110; static constexpr unsigned char CL_TRIGGER_MODE_ITR = 0b00000100; static constexpr unsigned char CL_TRIGGER_MODE_IDLE = 0; // just clear all bits static constexpr unsigned char CL_ABORT_CURRENT_EXP = 0b00001000; namespace details { static constexpr std::string_view cl_trigger_register_bit(const size_t pos) { return pos == CL_TRIGGER_MODE_ENABLE_RISING_EDGE_BIT ? "RISING EDGE" : pos == CL_TRIGGER_MODE_EXT_TRIGGER_BIT ? "EXTERNAL TRIGGER" : pos == CL_TRIGGER_MODE_ABORT_CURRENT_EXP_BIT ? "ABORT ACQUISITION" : pos == CL_TRIGGER_MODE_CONTINUOUS_SEQ_BIT ? "SEQUENCE TRIGGER" : pos == CL_TRIGGER_MODE_FIXED_FRAME_RATE_BIT ? "FIXED FRAME RATE" : pos == CL_TRIGGER_MODE_SNAPSHOT_BIT ? "SNAPSHOT TRIGGER" : "UNKNOWN"; } } // namespace details /* SETUP CONTROL VALUES */ // shutter static constexpr char CL_SHUTTER_CLOSED = 0x0; static constexpr char CL_SHUTTER_OPEN = 0x1; static constexpr char CL_SHUTTER_EXP = 0x2; // readout rate (registers values) static constexpr unsigned char CL_READOUT_CLOCK_RATE_A3_2MHZ = 0x02; static constexpr unsigned char CL_READOUT_CLOCK_RATE_A4_2MHZ = 0x02; static constexpr unsigned char CL_READOUT_CLOCK_RATE_A3_75KHZ = 0x43; static constexpr unsigned char CL_READOUT_CLOCK_RATE_A4_75KHZ = 0x80; // readout mode static constexpr unsigned char CL_READOUT_MODE_NORMAL = 0x01; static constexpr unsigned char CL_READOUT_MODE_TEST = 0x04; static constexpr double ADC_CALIBRATION_POINT_1 = 0.0; // at 0 Celcius degree static constexpr double ADC_CALIBRATION_POINT_2 = 40.0; // at +40 Celcius degree static constexpr double DAC_CALIBRATION_POINT_1 = 0.0; // at 0 Celcius degree static constexpr double DAC_CALIBRATION_POINT_2 = 40.0; // at +40 Celcius degree /* REGISTER ADDRESSES */ static constexpr std::initializer_list CL_EXPTIME_ADDR = {0xED, 0xEE, 0xEF, 0xF0, 0xF1}; static constexpr std::initializer_list CL_FRAMERATE_ADDR = {0xDC, 0xDD, 0xDE, 0xDF, 0xE0}; static constexpr std::initializer_list CL_ROI_STARTX_ADDR = {0xB6, 0xB7}; static constexpr std::initializer_list CL_ROI_STARTY_ADDR = {0xBA, 0xBB}; static constexpr std::initializer_list CL_ROIWIDTH_ADDR = {0xB4, 0xB5}; static constexpr std::initializer_list CL_ROIHEIGHT_ADDR = {0xB8, 0xB9}; static constexpr std::initializer_list CL_XBIN_ADDR = {0xA1}; static constexpr std::initializer_list CL_YBIN_ADDR = {0xA2}; static constexpr std::initializer_list CL_TECPOINT_ADDR = {0x03, 0x04}; static constexpr std::initializer_list CL_READMODE_ADDR = {0xF7}; static constexpr std::initializer_list CL_READRATE_ADDR = {0xA3, 0xA4}; static constexpr std::initializer_list CL_SHUTTER_CONTROL_ADDR = {0xA5}; /* COMMANDS */ static unsigned char CL_COMMAND_SET_ADDRESS[] = { 0x53, 0xE0, 0x01, 0x00}; // set address given by the last byte. the last byte should be set by user) static unsigned char CL_COMMAND_READ_VALUE[] = {0x53, 0xE1, 0x01}; // read a byte value static unsigned char CL_COMMAND_WRITE_VALUE[] = {0x53, 0xE0, 0x02, 0x00, 0x00}; // write a byte value given by the last byte // at address given by 3-rd byte (starting from 0) static constexpr unsigned char CL_COMMAND_GET_MANUFACTURER_DATA_1[] = { 0x53, 0xAE, 0x05, 0x01, 0x00, 0x00, 0x02, 0x00}; // 1st command to get manufacturer's data static constexpr unsigned char CL_COMMAND_GET_MANUFACTURER_DATA_2[] = {0x53, 0xAF, 0x12}; // the second one