ptcc_library API

Communication

ptcc_library Communication modules

Utils & Defines & Base Object

ptcc_library Utils & Defines & Base Object modules

Module contents

class ValType(*values)[source]

Bases: Enum

Enum for identifying PTCC data types.

CONTAINER = 0

CSTR = 1

INT8 = 2

UINT8 = 3

INT16 = 4

UINT16 = 5

INT32 = 6

UINT32 = 7

FLOAT = 8

DATE_TIME = 9

SERIAL_NUMBER = 10

BOOL = 11

class PtccCtrl(*values)[source]

Bases: Enum

Enum for setting operating mode of PTCC

AUTO = 0

OFF = 1

ON = 2

class PtccTimeStruct[source]

Bases: Structure

PTCC time format.

day: Structure/Union member

hour: Structure/Union member

min: Structure/Union member

mon: Structure/Union member

msec: Structure/Union member

sec: Structure/Union member

year: Structure/Union member

class PtccObjectID(*values)[source]

Bases: Enum

Enum for all possible PtccObject ids.

GET_PTCC_CONFIG: Container. Command is used to read PTCC device type.

GET_PTCC_MONITOR: Container. Command is used to read measured parameters of no memory module connected to PTCC device.

GET_PTCC_MOD_NO_MEM_IDEN: Container. Command is used to read identification and configuration data of module connected to PTCC device.

GET_PTCC_MOD_NO_MEM_USER_SET: Container. Command is used to read user settings.

GET_PTCC_MOD_NO_MEM_USER_MIN: Container. Command is used to read minimum settings.

GET_PTCC_MOD_NO_MEM_USER_MAX: Container. Command is used to read maximum settings.

GET_PTCC_MOD_NO_MEM_DEFAULT: Container. Command is used to read default configuration data.

SET_PTCC_MOD_NO_MEM_USER_SET: Container. Command is used to set and save user settings.

GET_MODULE_IDEN: Container. Command is used to read identification and configuration data of module connected to PTCC device.

GET_MODULE_USER_SET: Container. Command is used to read basic user settings.

GET_MODULE_USER_MIN: Container. Command is used to read minimum basic settings.

GET_MODULE_USER_MAX: Container. Command is used to read maximum basic settings.

GET_MODULE_DEFAULT: Container. Command is used to read default configurations.

SET_MODULE_USER_SET: Container. Command is used to set and save basic user settings.

GET_MODULE_LAB_M_MONITOR: Container. Command is used to read measured lab_m parameters of module connected to PTCC device.

GET_MODULE_LAB_M_USER_SET: Container. Command is used to read configuration.

GET_MODULE_LAB_M_USER_MIN: Container. Command is used to read minimum settings.

GET_MODULE_LAB_M_USER_MAX: Container. Command is used to read maximum settings.

GET_MODULE_LAB_M_DEFAULT: Container. Command is used to read default configuration.

SET_MODULE_LAB_M_USER_SET: Container. Command is used to set and save configuration.

PTCC_CONFIG: Container. Stores PTCC_CONFIG objects.

PTCC_MONITOR: Container. Stores PTCC_MONITOR objects.

MODULE_IDEN: Container. Stores MODULE_IDEN objects.

MODULE_BASIC_PARAMS: Container. Stores MODULE_BASIC_PARAMS objects.

MODULE_LAB_M_MONITOR: Container. Stores MODULE_LAB_M_MONITOR objects.

MODULE_LAB_M_PARAMS: Container. Stores MODULE_LAB_M_PARAMS objects.

GET_DEVICE_IDEN: Container. Command is used to read identification data of PTCC device.

DEVICE_IDEN: Container. Stores DEVICE_IDEN objects.

PTCC_CONFIG_VARIANT: PTCC_CONFIG object. Determines the version of PTTC device. Data Value:

See PTCC_CONFIG_VARIANT_VALUES.

PTCC_CONFIG_NO_MEM_COMPATIBLE

PTCC_CONFIG object. Responsible for availability of EEPROM memory. Data Value:

PTCC_MONITOR_SUP_ON

SMARTTEC_MONITOR object. Checks operation state of power supply lines. Data Value:

PTCC_MONITOR_I_SUP_PLUS: SMARTTEC_MONITOR object. Reads current value of positive supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_I_SUP_MINUS: SMARTTEC_MONITOR object. Reads current value of negative supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_FAN_ON

SMARTTEC_MONITOR object. Checks operation state of fan output. Data Value:

PTCC_MONITOR_I_FAN_PLUS: SMARTTEC_MONITOR object. Reads output current value of fan output. Data Value:

Available PtccUnits.

PTCC_MONITOR_I_TEC: SMARTTEC_MONITOR object. Reads current value of TEC output. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_TEC: SMARTTEC_MONITOR object. Reads output voltage value of TEC. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_SUP_PLUS: SMARTTEC_MONITOR object. Reads output voltage value of positive supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_SUP_MINUS: SMARTTEC_MONITOR object. Reads output voltage value of negative supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_T_DET: SMARTTEC_MONITOR object. Reads detector temperature in Kelvins. Data Value:

Available PtccUnits.

PTCC_MONITOR_T_INT: SMARTTEC_MONITOR object. Reads detector temperature in Celsius degrees. Data Value:

Available PtccUnits.

PTCC_MONITOR_PWM: SMARTTEC_MONITOR object. Reads PWM settings of TEC controller. Data Value:

Available PtccUnits.

PTCC_MONITOR_STATUS

SMARTTEC_MONITOR object. Data Value:

PTCC_MONITOR_MODULE_TYPE: SMARTTEC_MONITOR object. Reads type of module. Data Value

See PTCC_MONITOR_MODULE_TYPE_VALUES.

PTCC_MONITOR_TH_ADC: SMARTTEC_MONITOR object. Reads voltage value of thermistor. Data Value

Available PtccUnits.

MODULE_IDEN_TYPE: MODULE_IDEN object. Describes type of memory. Data Value

See MODULE_IDEN_TYPE_VALUES.

MODULE_IDEN_FIRM_VER: MODULE_IDEN object. Describes version of firmware. Data Value

UINT16.

MODULE_IDEN_HARD_VER: MODULE_IDEN object. Describes version of hardware. Data Value

UINT16.

MODULE_IDEN_NAME: MODULE_IDEN object. Describes module name. Data Value

CSTR. See MODULE_IDEN_NAME_SIZE.

MODULE_IDEN_SERIAL: MODULE_IDEN object. Describes module serial number. Data Value

SERIAL_NUMBER.

MODULE_IDEN_DET_NAME: MODULE_IDEN object. Describes detector name. Data Value

CSTR. See MODULE_IDEN_DET_NAME_SIZE.

MODULE_IDEN_DET_SERIAL: MODULE_IDEN object. Describes detector serial number. Data Value

SERIAL_NUMBER.

MODULE_IDEN_PROD_DATE: MODULE_IDEN object. Describes date of manufacture of the module. Data Value

DATE_TIME.

MODULE_IDEN_TEC_TYPE: MODULE_IDEN object. Data Value

See MODULE_IDEN_TEC_TYPE_VALUES.

MODULE_IDEN_TH_TYPE: MODULE_IDEN object. Describes thermistor type. Data Value

UINT8.

MODULE_IDEN_TEC_PARAM1: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM2: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM3: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM4: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM1: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM2: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM3: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM4: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_COOL_TIME: MODULE_IDEN object. Responsible for setting maximum time of cooling module. If the module does not reach desired temperature it will be turned off. Data Value

UINT16.

MODULE_BASIC_PARAMS_SUP_CTRL: MODULE_BASIC_PARAMS object. Describes operating modes of power supply lines. Data Value

See MODULE_BASIC_PARAMS_SUP_CTRL_VALUES.

MODULE_BASIC_PARAMS_U_SUP_PLUS: MODULE_BASIC_PARAMS object. Responsible for setting output voltage value of positive power line. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_U_SUP_MINUS: MODULE_BASIC_PARAMS object. Responsible for setting output voltage value of negative power line. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_FAN_CTRL: MODULE_BASIC_PARAMS object. Describes operation state of fan control. Data Value

See MODULE_BASIC_PARAMS_FAN_CTRL_VALUES.

MODULE_BASIC_PARAMS_TEC_CTRL: MODULE_BASIC_PARAMS object. Describes operating modes of TEC cooler. Data Value

See MODULE_BASIC_PARAMS_TEC_CTRL_VALUES.

MODULE_BASIC_PARAMS_PWM: MODULE_BASIC_PARAMS object. Describes PWM settings of TEC. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_I_TEC_MAX: MODULE_BASIC_PARAMS object. Describes maximum current for TEC output. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_T_DET: MODULE_BASIC_PARAMS object. Describes detector temperature in Kelvins. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_SUP_PLUS: MODULE_LAB_M_MONITOR object. Reads voltage value of positive power line. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_SUP_MINUS: MODULE_LAB_M_MONITOR object. Reads voltage value of negative power line. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_FAN_PLUS: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEC_PLUS: MODULE_LAB_M_MONITOR object. Reads maximum current for TEC positive output. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEC_MINUS: MODULE_LAB_M_MONITOR object. Reads maximum current for TEC negative output. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TH1: MODULE_LAB_M_MONITOR object. Reads voltage value of thermistor pin 1. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TH2: MODULE_LAB_M_MONITOR object. Reads voltage value of thermistor pin 2. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_DET: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_1ST: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_OUT: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEMP: MODULE_LAB_M_MONITOR object. Reads module enclosure temperature in Celsius degrees. Data Value

Available PtccUnits.

MODULE_LAB_M_PARAMS_DET_U: MODULE_LAB_M_PARAMS object. Describes value of voltage bias. Data Value

UINT16. Variable range 0…256 corresponds to 0-1V.

MODULE_LAB_M_PARAMS_DET_I: MODULE_LAB_M_PARAMS object. Describes value of current bias compensation. Data Value

UINT16. Variable range 0…256 corresponds to 0-10mA.

MODULE_LAB_M_PARAMS_GAIN: MODULE_LAB_M_PARAMS object. Responsible for setting gain in the second stage. Data Value

UINT16.

MODULE_LAB_M_PARAMS_OFFSET: MODULE_LAB_M_PARAMS object. Responsible for setting offset value. Data Value

Available PtccUnits.

MODULE_LAB_M_PARAMS_VARACTOR: MODULE_LAB_M_PARAMS object. Responsible for frequency compensation for the preamplifier first stage. Data Value

UINT16.

MODULE_LAB_M_PARAMS_TRANS: MODULE_LAB_M_PARAMS object. Responsible for transimpedance of first stage preamplifier. Data Value

See MODULE_LAB_M_PARAMS_TRANS_VALUES.

MODULE_LAB_M_PARAMS_ACDC: MODULE_LAB_M_PARAMS object. Responsible for the coupling mode. Data Value

See MODULE_LAB_M_PARAMS_ACDC_VALUES.

MODULE_LAB_M_PARAMS_BW: MODULE_LAB_M_PARAMS object. Describes value of bandwidth. Data Value

See MODULE_LAB_M_PARAMS_BW_VALUES.

DEVICE_IDEN_TYPE: DEVICE_IDEN object. Describes type of device. Data Value

UINT16.

DEVICE_IDEN_FIRM_VER: DEVICE_IDEN object. Describes devices version of firmware. Data Value

UINT16.

DEVICE_IDEN_HARD_VER: DEVICE_IDEN object. Describes devices version of hardware. Data Value

UINT16.

DEVICE_IDEN_NAME: DEVICE_IDEN object. Describes device name. Data Value

CSTR. See DEVICE_IDEN_NAME_SIZE.

DEVICE_IDEN_SERIAL: DEVICE_IDEN object. Describes device serial number. Data Value

SERIAL_NUMBER.

DEVICE_IDEN_PROD_DATE: DEVICE_IDEN object. Describes date of device prodution. Data Value

SERIAL_NUMBER.

GET_PTCC_CONFIG = 1280

GET_PTCC_MONITOR = 1312

GET_PTCC_MOD_NO_MEM_IDEN = 1536

GET_PTCC_MOD_NO_MEM_USER_SET = 1600

GET_PTCC_MOD_NO_MEM_USER_MIN = 1632

GET_PTCC_MOD_NO_MEM_USER_MAX = 1664

GET_PTCC_MOD_NO_MEM_DEFAULT = 1568

SET_PTCC_MOD_NO_MEM_USER_SET = 1616

GET_MODULE_IDEN = 2048

GET_MODULE_USER_SET = 2144

GET_MODULE_USER_MIN = 2176

GET_MODULE_USER_MAX = 2208

GET_MODULE_DEFAULT = 2112

SET_MODULE_USER_SET = 2160

GET_MODULE_LAB_M_MONITOR = 2560

GET_MODULE_LAB_M_USER_SET = 2720

GET_MODULE_LAB_M_USER_MIN = 2752

GET_MODULE_LAB_M_USER_MAX = 2784

GET_MODULE_LAB_M_DEFAULT = 2688

SET_MODULE_LAB_M_USER_SET = 2736

PTCC_CONFIG = 6144

PTCC_MONITOR = 7168

MODULE_IDEN = 8192

MODULE_BASIC_PARAMS = 9216

MODULE_LAB_M_MONITOR = 11264

MODULE_LAB_M_PARAMS = 12288

GET_DEVICE_IDEN = 32

DEVICE_IDEN = 256

PTCC_CONFIG_VARIANT = 6163

PTCC_CONFIG_NO_MEM_COMPATIBLE = 6187

PTCC_MONITOR_SUP_ON = 7195

PTCC_MONITOR_I_SUP_PLUS = 7204

PTCC_MONITOR_I_SUP_MINUS = 7220

PTCC_MONITOR_FAN_ON = 7243

PTCC_MONITOR_I_FAN_PLUS = 7252

PTCC_MONITOR_I_TEC = 7268

PTCC_MONITOR_U_TEC = 7284

PTCC_MONITOR_U_SUP_PLUS = 7300

PTCC_MONITOR_U_SUP_MINUS = 7316

PTCC_MONITOR_T_DET = 7334

PTCC_MONITOR_T_INT = 7348

PTCC_MONITOR_PWM = 7365

PTCC_MONITOR_STATUS = 7379

PTCC_MONITOR_MODULE_TYPE = 7395

PTCC_MONITOR_TH_ADC = 7415

MODULE_IDEN_TYPE = 8211

MODULE_IDEN_FIRM_VER = 8229

MODULE_IDEN_HARD_VER = 8245

MODULE_IDEN_NAME = 8257

MODULE_IDEN_SERIAL = 8282

MODULE_IDEN_DET_NAME = 8289

MODULE_IDEN_DET_SERIAL = 8314

MODULE_IDEN_PROD_DATE = 8329

MODULE_IDEN_TEC_TYPE = 8339

MODULE_IDEN_TH_TYPE = 8355

MODULE_IDEN_TEC_PARAM1 = 8376

MODULE_IDEN_TEC_PARAM2 = 8392

MODULE_IDEN_TEC_PARAM3 = 8408

MODULE_IDEN_TEC_PARAM4 = 8424

MODULE_IDEN_TH_PARAM1 = 8440

MODULE_IDEN_TH_PARAM2 = 8456

MODULE_IDEN_TH_PARAM3 = 8472

MODULE_IDEN_TH_PARAM4 = 8488

MODULE_IDEN_COOL_TIME = 8581

MODULE_BASIC_PARAMS_SUP_CTRL = 9235

MODULE_BASIC_PARAMS_U_SUP_PLUS = 9252

MODULE_BASIC_PARAMS_U_SUP_MINUS = 9268

MODULE_BASIC_PARAMS_FAN_CTRL = 9283

MODULE_BASIC_PARAMS_TEC_CTRL = 9299

MODULE_BASIC_PARAMS_PWM = 9317

MODULE_BASIC_PARAMS_I_TEC_MAX = 9332

MODULE_BASIC_PARAMS_T_DET = 9351

MODULE_LAB_M_MONITOR_SUP_PLUS = 11284

MODULE_LAB_M_MONITOR_SUP_MINUS = 11300

MODULE_LAB_M_MONITOR_FAN_PLUS = 11316

MODULE_LAB_M_MONITOR_TEC_PLUS = 11332

MODULE_LAB_M_MONITOR_TEC_MINUS = 11348

MODULE_LAB_M_MONITOR_TH1 = 11364

MODULE_LAB_M_MONITOR_TH2 = 11380

MODULE_LAB_M_MONITOR_U_DET = 11396

MODULE_LAB_M_MONITOR_U_1ST = 11412

MODULE_LAB_M_MONITOR_U_OUT = 11428

MODULE_LAB_M_MONITOR_TEMP = 11444

MODULE_LAB_M_PARAMS_DET_U = 12309

MODULE_LAB_M_PARAMS_DET_I = 12325

MODULE_LAB_M_PARAMS_GAIN = 12341

MODULE_LAB_M_PARAMS_OFFSET = 12357

MODULE_LAB_M_PARAMS_VARACTOR = 12373

MODULE_LAB_M_PARAMS_TRANS = 12387

MODULE_LAB_M_PARAMS_ACDC = 12403

MODULE_LAB_M_PARAMS_BW = 12419

DEVICE_IDEN_TYPE = 277

DEVICE_IDEN_FIRM_VER = 293

DEVICE_IDEN_HARD_VER = 309

DEVICE_IDEN_NAME = 321

DEVICE_IDEN_SERIAL = 346

DEVICE_IDEN_PROD_DATE = 361

class PtccMessageReceiveStatus(*values)[source]

Bases: Enum

Describes status of receiving PtccMessage

OVERFLOW: Message finished before appending all bytes.

NOT_BEGAN: Message empty.

IN_PROGRESS: Message began forming. No end character.

FINISHED: Message finished and valid.

OVERFLOW = -2

NOT_BEGAN = -1

IN_PROGRESS = 0

FINISHED = 1

class PtccSize[source]

Bases: object

Contains size (in bytes) of names used by PTCC device.

DEVICE_IDEN_NAME_SIZE = 32

MODULE_IDEN_DET_NAME_SIZE = 32

MODULE_IDEN_NAME_SIZE = 32

class ModuleType(*values)[source]

Bases: Enum

Type of module connected to PTCC device.

NONE: module not connected

NOMEM: standard IR module without memory EEPROM. Basic device settings are stored in Ptcc memory.

MEM: standard IR module with built-in memory. Basic device settings are stored in memory.

LAB_M: module LAB_M - communication via RS232 line, half-duplex. Data stored in memory.

NONE = 0

NOMEM = 1

MEM = 2

LAB_M = 3

class CallbackPtccObjectID(*values)[source]

Bases: Enum

Enum for all possible PtccObject ids which can be used for setting callbacks.

PTCC_CONFIG: Container. Stores PTCC_CONFIG objects.

PTCC_MONITOR: Container. Stores PTCC_MONITOR objects.

MODULE_IDEN: Container. Stores MODULE_IDEN objects.

MODULE_BASIC_PARAMS: Container. Stores MODULE_BASIC_PARAMS objects.

MODULE_LAB_M_MONITOR: Container. Stores MODULE_LAB_M_MONITOR objects.

MODULE_LAB_M_PARAMS: Container. Stores MODULE_LAB_M_PARAMS objects.

GET_DEVICE_IDEN: Container. Command is used to read configuration data.

DEVICE_IDEN: Container. Stores DEVICE_IDEN objects.

PTCC_CONFIG_VARIANT: PTCC_CONFIG object. Determines the version of PTTC device. Data Value:

See PTCC_CONFIG_VARIANT_VALUES.

PTCC_CONFIG_NO_MEM_COMPATIBLE

PTCC_CONFIG object. Responsible for availability of EEPROM memory. Data Value:

PTCC_MONITOR_SUP_ON

SMARTTEC_MONITOR object. Checks operation state of power supply lines. Data Value:

PTCC_MONITOR_I_SUP_PLUS: SMARTTEC_MONITOR object. Reads current value of positive supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_I_SUP_MINUS: SMARTTEC_MONITOR object. Reads current value of negative supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_FAN_ON

SMARTTEC_MONITOR object. Checks operation state of fan output. Data Value:

PTCC_MONITOR_I_FAN_PLUS: SMARTTEC_MONITOR object. Reads output current value of fan output. Data Value:

Available PtccUnits.

PTCC_MONITOR_I_TEC: SMARTTEC_MONITOR object. Reads current value of TEC output. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_TEC: SMARTTEC_MONITOR object. Reads output voltage value of TEC. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_SUP_PLUS: SMARTTEC_MONITOR object. Reads output voltage value of positive supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_U_SUP_MINUS: SMARTTEC_MONITOR object. Reads output voltage value of negative supply line. Data Value:

Available PtccUnits.

PTCC_MONITOR_T_DET: SMARTTEC_MONITOR object. Reads detector temperature in Kelvins. Data Value:

Available PtccUnits.

PTCC_MONITOR_T_INT: SMARTTEC_MONITOR object. Reads detector temperature in Celsius degrees. Data Value:

Available PtccUnits.

PTCC_MONITOR_PWM: SMARTTEC_MONITOR object. Reads PWM settings of TEC controller. Data Value:

Available PtccUnits.

PTCC_MONITOR_STATUS

SMARTTEC_MONITOR object. Data Value:

PTCC_MONITOR_MODULE_TYPE: SMARTTEC_MONITOR object. Reads type of module. Data Value

See PTCC_MONITOR_MODULE_TYPE_VALUES.

PTCC_MONITOR_TH_ADC: SMARTTEC_MONITOR object. Reads voltage value of thermistor. Data Value

Available PtccUnits.

MODULE_IDEN_TYPE: MODULE_IDEN object. Describes type of memory. Data Value

See MODULE_IDEN_TYPE_VALUES.

MODULE_IDEN_FIRM_VER: MODULE_IDEN object. Describes version of firmware. Data Value

UINT16.

MODULE_IDEN_HARD_VER: MODULE_IDEN object. Describes version of hardware. Data Value

UINT16.

MODULE_IDEN_NAME: MODULE_IDEN object. Describes module name. Data Value

CSTR. See MODULE_IDEN_NAME_SIZE.

MODULE_IDEN_SERIAL: MODULE_IDEN object. Describes module serial number. Data Value

SERIAL_NUMBER.

MODULE_IDEN_DET_NAME: MODULE_IDEN object. Describes detector name. Data Value

CSTR. See MODULE_IDEN_DET_NAME_SIZE.

MODULE_IDEN_DET_SERIAL: MODULE_IDEN object. Describes detector serial number. Data Value

SERIAL_NUMBER.

MODULE_IDEN_PROD_DATE: MODULE_IDEN object. Describes date of manufacture of the module. Data Value

DATE_TIME.

MODULE_IDEN_TEC_TYPE: MODULE_IDEN object. Data Value

See MODULE_IDEN_TEC_TYPE_VALUES.

MODULE_IDEN_TH_TYPE: MODULE_IDEN object. Describes thermistor type. Data Value

UINT8.

MODULE_IDEN_TEC_PARAM1: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM2: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM3: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TEC_PARAM4: MODULE_IDEN object. Describes TEC parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM1: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM2: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM3: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_TH_PARAM4: MODULE_IDEN object. Describes thermistor parameters. Data Value

FLOAT.

MODULE_IDEN_COOL_TIME: MODULE_IDEN object. Responsible for setting maximum time of cooling module. If the module does not reach desired temperature it will be turned off. Data Value

UINT16.

MODULE_BASIC_PARAMS_SUP_CTRL: MODULE_BASIC_PARAMS object. Describes operating modes of power supply lines. Data Value

See MODULE_BASIC_PARAMS_SUP_CTRL_VALUES.

MODULE_BASIC_PARAMS_U_SUP_PLUS: MODULE_BASIC_PARAMS object. Responsible for setting output voltage value of positive power line. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_U_SUP_MINUS: MODULE_BASIC_PARAMS object. Responsible for setting output voltage value of negative power line. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_FAN_CTRL: MODULE_BASIC_PARAMS object. Describes operation state of fan control. Data Value

See MODULE_BASIC_PARAMS_FAN_CTRL_VALUES.

MODULE_BASIC_PARAMS_TEC_CTRL: MODULE_BASIC_PARAMS object. Describes operating modes of TEC cooler. Data Value

See MODULE_BASIC_PARAMS_TEC_CTRL_VALUES.

MODULE_BASIC_PARAMS_PWM: MODULE_BASIC_PARAMS object. Describes PWM settings of TEC. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_I_TEC_MAX: MODULE_BASIC_PARAMS object. Describes maximum current for TEC output. Data Value

Available PtccUnits.

MODULE_BASIC_PARAMS_T_DET: MODULE_BASIC_PARAMS object. Describes detector temperature in Kelvins. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_SUP_PLUS: MODULE_LAB_M_MONITOR object. Reads voltage value of positive power line. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_SUP_MINUS: MODULE_LAB_M_MONITOR object. Reads voltage value of negative power line. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_FAN_PLUS: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEC_PLUS: MODULE_LAB_M_MONITOR object. Reads maximum current for TEC positive output. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEC_MINUS: MODULE_LAB_M_MONITOR object. Reads maximum current for TEC negative output. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TH1: MODULE_LAB_M_MONITOR object. Reads voltage value of thermistor pin 1. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TH2: MODULE_LAB_M_MONITOR object. Reads voltage value of thermistor pin 2. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_DET: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_1ST: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_U_OUT: MODULE_LAB_M_MONITOR object. Data Value

Available PtccUnits.

MODULE_LAB_M_MONITOR_TEMP: MODULE_LAB_M_MONITOR object. Reads module enclosure temperature in Celsius degrees. Data Value

Available PtccUnits.

MODULE_LAB_M_PARAMS_DET_U: MODULE_LAB_M_PARAMS object. Describes value of voltage bias. Data Value

UINT16. Variable range 0…256 corresponds to 0-1V.

MODULE_LAB_M_PARAMS_DET_I: MODULE_LAB_M_PARAMS object. Describes value of current bias compensation. Data Value

UINT16. Variable range 0…256 corresponds to 0-10mA.

MODULE_LAB_M_PARAMS_GAIN: MODULE_LAB_M_PARAMS object. Responsible for setting gain in the second stage. Data Value

UINT16.

MODULE_LAB_M_PARAMS_OFFSET: MODULE_LAB_M_PARAMS object. Responsible for setting offset value. Data Value

Available PtccUnits.

MODULE_LAB_M_PARAMS_VARACTOR: MODULE_LAB_M_PARAMS object. Responsible for frequency compensation for the preamplifier first stage. Data Value

UINT16.

MODULE_LAB_M_PARAMS_TRANS: MODULE_LAB_M_PARAMS object. Responsible for transimpedance of first stage preamplifier. Data Value

See MODULE_LAB_M_PARAMS_TRANS_VALUES.

MODULE_LAB_M_PARAMS_ACDC: MODULE_LAB_M_PARAMS object. Responsible for the coupling mode. Data Value

See MODULE_LAB_M_PARAMS_ACDC_VALUES.

MODULE_LAB_M_PARAMS_BW: MODULE_LAB_M_PARAMS object. Describes value of bandwidth. Data Value

See MODULE_LAB_M_PARAMS_BW_VALUES.

DEVICE_IDEN_TYPE: DEVICE_IDEN object. Describes type of device. Data Value

UINT16.

DEVICE_IDEN_FIRM_VER: DEVICE_IDEN object. Describes devices version of firmware. Data Value

UINT16.

DEVICE_IDEN_HARD_VER: DEVICE_IDEN object. Describes devices version of hardware. Data Value

UINT16.

DEVICE_IDEN_NAME: DEVICE_IDEN object. Describes device name. Data Value

CSTR. See DEVICE_IDEN_NAME_SIZE.

DEVICE_IDEN_SERIAL: DEVICE_IDEN object. Describes device serial number. Data Value

SERIAL_NUMBER.

DEVICE_IDEN_PROD_DATE: DEVICE_IDEN object. Describes date of device prodution. Data Value

SERIAL_NUMBER.

PTCC_CONFIG = 6144

PTCC_MONITOR = 7168

MODULE_IDEN = 8192

MODULE_BASIC_PARAMS = 9216

MODULE_LAB_M_MONITOR = 11264

MODULE_LAB_M_PARAMS = 12288

GET_DEVICE_IDEN = 32

DEVICE_IDEN = 256

PTCC_CONFIG_VARIANT = 6163

PTCC_CONFIG_NO_MEM_COMPATIBLE = 6187

PTCC_MONITOR_SUP_ON = 7195

PTCC_MONITOR_I_SUP_PLUS = 7204

PTCC_MONITOR_I_SUP_MINUS = 7220

PTCC_MONITOR_FAN_ON = 7243

PTCC_MONITOR_I_FAN_PLUS = 7252

PTCC_MONITOR_I_TEC = 7268

PTCC_MONITOR_U_TEC = 7284

PTCC_MONITOR_U_SUP_PLUS = 7300

PTCC_MONITOR_U_SUP_MINUS = 7316

PTCC_MONITOR_T_DET = 7334

PTCC_MONITOR_T_INT = 7348

PTCC_MONITOR_PWM = 7365

PTCC_MONITOR_STATUS = 7379

PTCC_MONITOR_MODULE_TYPE = 7395

PTCC_MONITOR_TH_ADC = 7415

MODULE_IDEN_TYPE = 8211

MODULE_IDEN_FIRM_VER = 8229

MODULE_IDEN_HARD_VER = 8245

MODULE_IDEN_NAME = 8257

MODULE_IDEN_SERIAL = 8282

MODULE_IDEN_DET_NAME = 8289

MODULE_IDEN_DET_SERIAL = 8314

MODULE_IDEN_PROD_DATE = 8329

MODULE_IDEN_TEC_TYPE = 8339

MODULE_IDEN_TH_TYPE = 8355

MODULE_IDEN_TEC_PARAM1 = 8376

MODULE_IDEN_TEC_PARAM2 = 8392

MODULE_IDEN_TEC_PARAM3 = 8408

MODULE_IDEN_TEC_PARAM4 = 8424

MODULE_IDEN_TH_PARAM1 = 8440

MODULE_IDEN_TH_PARAM2 = 8456

MODULE_IDEN_TH_PARAM3 = 8472

MODULE_IDEN_TH_PARAM4 = 8488

MODULE_IDEN_COOL_TIME = 8581

MODULE_BASIC_PARAMS_SUP_CTRL = 9235

MODULE_BASIC_PARAMS_U_SUP_PLUS = 9252

MODULE_BASIC_PARAMS_U_SUP_MINUS = 9268

MODULE_BASIC_PARAMS_FAN_CTRL = 9283

MODULE_BASIC_PARAMS_TEC_CTRL = 9299

MODULE_BASIC_PARAMS_PWM = 9317

MODULE_BASIC_PARAMS_I_TEC_MAX = 9332

MODULE_BASIC_PARAMS_T_DET = 9351

MODULE_LAB_M_MONITOR_SUP_PLUS = 11284

MODULE_LAB_M_MONITOR_SUP_MINUS = 11300

MODULE_LAB_M_MONITOR_FAN_PLUS = 11316

MODULE_LAB_M_MONITOR_TEC_PLUS = 11332

MODULE_LAB_M_MONITOR_TEC_MINUS = 11348

MODULE_LAB_M_MONITOR_TH1 = 11364

MODULE_LAB_M_MONITOR_TH2 = 11380

MODULE_LAB_M_MONITOR_U_DET = 11396

MODULE_LAB_M_MONITOR_U_1ST = 11412

MODULE_LAB_M_MONITOR_U_OUT = 11428

MODULE_LAB_M_MONITOR_TEMP = 11444

MODULE_LAB_M_PARAMS_DET_U = 12309

MODULE_LAB_M_PARAMS_DET_I = 12325

MODULE_LAB_M_PARAMS_GAIN = 12341

MODULE_LAB_M_PARAMS_OFFSET = 12357

MODULE_LAB_M_PARAMS_VARACTOR = 12373

MODULE_LAB_M_PARAMS_TRANS = 12387

MODULE_LAB_M_PARAMS_ACDC = 12403

MODULE_LAB_M_PARAMS_BW = 12419

DEVICE_IDEN_TYPE = 277

DEVICE_IDEN_FIRM_VER = 293

DEVICE_IDEN_HARD_VER = 309

DEVICE_IDEN_NAME = 321

DEVICE_IDEN_SERIAL = 346

DEVICE_IDEN_PROD_DATE = 361

class GainVoltPerVolt(*values)[source]

Bases: Enum

Used for setting gain multiplication.

X0_5 = 48

X1 = 56

X1_5 = 60

X2 = 64

X3 = 69

X5 = 75

X7 = 80

X10 = 85

X15 = 93

X20 = 99

X30 = 111

class DeviceRegister(*values)[source]

Bases: Enum

Describes which type of register should be written/read.

DEFAULT: register for default setting.

USER_SET: register for user setting.

USER_MIN: register for max allowed setting.

USER_MAX: register for min allowed setting.

DEFAULT = 0

USER_SET = 1

USER_MIN = 2

USER_MAX = 3

Bases: object

Represents a basic object used in PTCC messages.

PtccObject is the base class for all message components in the PTCC protocol. It can contain nested objects (if it’s a container), which are stored in the objects attribute.

Parameters:

raw_object (bytes or bytearray or list of int, optional) – Raw binary representation of the object. Used to parse and initialize the object.
obj_id (int or PtccObjectID, optional) – Identifier for the object. Can be a plain integer or a PtccObjectID enum.
data (bytes, bytearray, str, or list of int, optional) – Raw data payload for the object.
data_value (any, optional) – Parsed or human-readable representation of the data, if applicable.
value (any, optional) – The value represented in SI units. It is equivalent to data_value, but expressed using standard international units. If applicable.

property data: list[int]

Raw binary representation of data contained in object.

Type:: list[int]

property data_type: int

Represents data type of data contained in PtccObject.

Type:: int

flatten_container() → list[PtccObject][source]

Flattens container

Returns:: list[PtccObject]
Return type:: list of PtccObjects stored in container and self.
Raises:: TypeError – if PtccObject is not a container.

property is_container: bool

check if PtccObject is a container.

Type:: bool

property name: str

The full PtccObjectID name of this PtccObject.

Type:: str

property obj_id: int

The full object ID of this PtccObject.

Notes

Encodes both the object type and data type.

Type:: int

property objects: list[PtccObject]

list of PtccObjects stored in container. May return empty list if PtccObject is not a container, or container is empty.

Type:: list[PtccObject]

pack_container(ptcc_objects: list[PtccObject]) → list[int][source]

Adds objects to container

Parameters:

ptcc_objects (list[PtccObject]) – list of PtccObjects that should be stored in PtccObject.

Returns:

list[int]

Return type:

Raw binary representation of the object.

Raises:

TypeError – if PtccObject is not a container.
TypeError – if ptcc_objects contains types other than PtccObject.

property raw_object: list[int]

Raw binary representation of the object.

Type:: list[int]

unpack_container() → list[PtccObject][source]

Returns:: list[PtccObject]
Return type:: list of PtccObjects stored in container.
Raises:: TypeError – if PtccObject is not a container.

property value: any

Represents value of data contained in PtccObject.

Raises:: ValueError – if no data is stored in PtccObject, or if value is out of expected range.
Type:: list[int]

ptcc_message_to_ptcc_object(raw_msg: list[int] | bytearray | bytes) → PtccObject[source]

Converts a raw PTCC message into a PtccObject.

This function parses a raw byte sequence (typically received over serial communication) formatted according to the PTCC protocol. It validates framing characters ($ and #), checks message length, verifies the CRC, and decodes the message content into a PtccObject.

Parameters:: raw_msg (list of int, bytearray, or bytes) – The raw message bytes received from the device. Must begin with ‘$’ and end with ‘#’.
Returns:: A PtccObject instance reconstructed from the decoded message content.
Return type:: PtccObject
Raises:: ValueError – If the message is empty, improperly framed, too short, or fails CRC validation.

Notes

The function expects that the core object data is hex-encoded within the message. The format is as follows:

class PtccMessage(raw_message: list[int] | bytearray | bytes = None)[source]

Bases: object

Represents a raw PTCC protocol message with validation.

A PtccMessage encapsulates a raw PTCC message as a list of ASCII codes. It validates the structure of the message to ensure it conforms to expected PTCC protocol formatting rules.

Parameters:: raw_message (list of int, bytearray, or bytes, optional) – The raw message content represented as ASCII codes. If provided, the message is validated to ensure it starts with ‘$’, ends with ‘#’, and contains valid hexadecimal characters in between.
Raises:: ValueError – If the message: - Does not start with ‘$’ (ASCII 36) - Contains invalid characters (must be ‘0’-‘9’ or ‘A’-‘F’) - Contains embedded ‘$’ or ‘#’ characters (only allowed at start and end) - Ends with an invalid character (must be ‘#’ or a valid hex digit)

_raw_message

The validated raw message stored as a list of ASCII character codes.

Type:: list of int

Notes

This class is primarily intended for validating incoming or outgoing messages at a low level before further parsing into PtccObject structures or transmission over a communication interface.

append_byte(raw_byte: int) → PtccMessageReceiveStatus[source]

Appends a single byte (ASCII code) to the raw message stream and returns the current receive status.

This method is typically used in byte-wise message assembly scenarios, such as when receiving data from a serial port. It enforces PTCC framing and content rules to determine whether the message is valid, incomplete, or has overflowed.

Parameters:: raw_byte (int) – A single byte to append, expected to be the ASCII code of a valid PTCC character. The first byte must be ‘$’ (ASCII 36), and characters must be valid hex digits or ‘#’.
Returns:: The current status of the message after appending the byte. Can be: - NOT_BEGAN: message has not started (waiting for $) - IN_PROGRESS: receiving hex data - FINISHED: received terminating # - OVERFLOW: too many characters were appended beyond expected length
Return type:: PtccMessageReceiveStatus
Raises:: ValueError – If the message does not start with ‘$’, or if an invalid character (non-hex and not ‘#’) is appended.

Notes

This function performs strict validation: - First character must be ‘$’ - Hexadecimal characters must be in range ‘0’-‘9’ or ‘A’-‘F’ - Only one ‘#’ is allowed, and only at the end

append_bytes(raw_bytes: list[int] | bytearray | bytes) → tuple[PtccMessageReceiveStatus, list[int] | bytearray | bytes][source]

Appends a multiple bytes (ASCII code) to the raw message stream and returns the current receive status.

This method is typically used in byte-wise message assembly scenarios, such as when receiving data from a serial port. It enforces PTCC framing and content rules to determine whether the message is valid, incomplete, or has overflowed.

Parameters:

raw_bytes (Union[list[int], bytearray, bytes]) – Bytes to append, expected to be the ASCII code of a valid PTCC characters. The first byte must be ‘$’ (ASCII 36), and characters must be valid hex digits or ‘#’.

Returns:

PtccMessageReceiveStatus – The current status of the message after appending the byte. Can be: - NOT_BEGAN: message has not started (waiting for $) - IN_PROGRESS: receiving hex data - FINISHED: received terminating # - OVERFLOW: too many characters were appended beyond expected length
Union[list[int], bytearray, bytes] – bytes that were not appended to message because message was completed during appending.

Raises:

ValueError – If the message does not start with ‘$’, or if an invalid character (non-hex and not ‘#’) is appended.

Notes

This function performs strict validation: - First character must be ‘$’ - Hexadecimal characters must be in range ‘0’-‘9’ or ‘A’-‘F’ - Only one ‘#’ is allowed, and only at the end

classmethod generate_msg_get_basic_params(module_type: ModuleType, target: DeviceRegister = DeviceRegister.USER_SET)[source]

Generates message for reading configuration (power, cooling) data for module connected to PTCC device.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

ValueError – if module type is not supported for this kind of message, or if target register is not recognized.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_get_config()[source]

Generates message for reading PTCC device type.

Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_get_device_iden()[source]: Generates message for reading identification data of PTCC device.

classmethod generate_msg_get_lab_m_monitor(module_type: ModuleType)[source]

Generates message for reading measured lab_m parameters of module connected to PTCC device.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_get_lab_m_params(module_type: ModuleType, target: DeviceRegister = DeviceRegister.USER_SET)[source]

Generates message for reading lab_m configuration data for module connected to PTCC device.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_get_module_iden(module_type: ModuleType)[source]

Generates message for reading identification and configuration data of module connected to PTCC device.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_get_monitor()[source]

Generates message for reading measured parameters of no memory module connected to PTCC device.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_cooler_auto(module_type: ModuleType)[source]

Generates message for setting and saving operating mode of TEC as auto.

Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_cooler_disabled(module_type: ModuleType)[source]

Generates message for setting and saving operating mode of TEC as disabled.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_cooler_enabled(module_type: ModuleType)[source]

Generates message for setting and saving operating mode of TEC as enabled (Cooler will work with fixed supply current).

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_fan(module_type: ModuleType, mode: PtccCtrl)[source]

Generates message for setting and saving operation state of fan control.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
mode (PtccCtrl) – operation state of fan control. On, Off or Auto.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_max_current(module_type: ModuleType, value_in_amperes: float)[source]

Generates message for setting maximum current for TEC output.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
value_in_amperes (float) – Represented in Amperes. Describes maximum current for TEC output.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_bandwidth_high(module_type: ModuleType)[source]

Generates message for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_bandwidth_low(module_type: ModuleType)[source]

Generates message for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_bandwidth_mid(module_type: ModuleType)[source]

Generates message for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_coupling_ac(module_type: ModuleType)[source]

Generates message for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_coupling_dc(module_type: ModuleType)[source]

Generates message for setting and saving the coupling mode as DC for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_detector_current_bias_compensation(module_type: ModuleType, bias_value_in_ampers: float)[source]

Generates message for setting and saving value of bias current compensation for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_detector_voltage_bias(module_type: ModuleType, bias_value_in_volts: float)[source]

Generates message for setting and saving value of detector bias voltage for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
bias_value_in_volts (float) – lab_m voltage bias in Volts.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_gain(module_type: ModuleType, gain: GainVoltPerVolt | int)[source]

Generates message for setting and saving value of second stage gain for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
gain (Union[GainVoltPerVolt, int]) – lab_m gain.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_offset(module_type: ModuleType, offset_value_in_volts: float)[source]

Generates message for setting and saving lab_m output DC offset for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
offset_value_in_volts (int) – lab_m offset.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_param(module_type: ModuleType, ptcc_object: PtccObject)[source]

Generates message for setting and saving lab_m parameters.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
ptcc_object (PtccObject) – PTCC object to send as configuration.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_transimpedance_high(module_type: ModuleType)[source]

Generates message for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_transimpedance_low(module_type: ModuleType)[source]

Generates message for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_lab_m_varactor(module_type: ModuleType, compensation: int)[source]

Generates message for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
compensation (int) – lab_m frequency compensation.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_module_param(module_type: ModuleType, ptcc_object: PtccObject)[source]

Generates message for setting and saving module parameters.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
ptcc_object (PtccObject) – ID must be one of BASIC_PARAMS_IDS.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_supply_voltage(module_type: ModuleType, supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float)[source]

Generates message for setting output voltage values of power lines.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

classmethod generate_msg_set_temperature(module_type: ModuleType, value_in_kelvins: int)[source]

Generates message for setting and saving desired detector temperature.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
value_in_kelvins (int) – Represented in Kelvins. Describes desired detector temperature.

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

property is_crc_valid: bool

Returns True if message crc is valid or False if it is not valid.

Type:: bool

property raw_message: list[int]

The validated raw message stored as a list of ASCII character codes.

Type:: list[int]

property receive_status: PtccMessageReceiveStatus

Describes if message is fully formed.

Type:: PtccMessageReceiveStatus

reset()[source]: Used to reset PtccMessage object.

to_ptcc_object() → PtccObject[source]

Used to get PtccObject stored in PtccMessage.

Returns:: PTCC Object stored in message
Return type:: PtccObject

create_set_ptcc_message(set_command_id: PtccObjectID | int, ptcc_objects: PtccObject | list[PtccObject]) → list[int][source]

Creates a PTCC-formatted SET message containing the given PtccObject(s).

This function constructs a nested container message where the inner container holds the user-provided PtccObject, and the outer container corresponds to a specific set_command_id. The message is encoded in hex pairs, CRC-validated, and wrapped in $…`#` markers as per PTCC protocol.

Parameters:

set_command_id (PtccObjectID or int) – The type of SET command to be sent. Must correspond to a container-type object listed in SET_CONTAINER_IDS.
ptcc_objects (PtccObject or list of PtccObject) – One or more PtccObject instances to be included in the message payload.

Returns:

The complete PTCC message encoded as a list of ASCII values, ready to send over a byte stream. Message format: [ord(‘$’)] + encoded_data + [ord(‘#’)]

Return type:

list of int

Raises:

ValueError – If the command ID or derived container ID is not a valid container type according to the PTCC protocol rules.

Notes

The function builds a nested container structure as required by PTCC’s SET message format:

Outer container = set_command_id
Inner container = container_id (from SET_CONTAINER_IDS lookup)
Payload = one or more PtccObjects

The message structure is:

$ + HEX_ENCODED([outer_container( inner_container( objects ) ) + CRC]) + #

create_get_ptcc_message(get_command_id: PtccObjectID | int) → list[int][source]

Creates a PTCC-formatted GET message for the specified command ID.

This function builds a request message to retrieve data from a PTCC device. The message includes the command ID, is CRC-validated, hex-encoded, and framed with protocol-specific delimiters ($ and #).

Parameters:: get_command_id (PtccObjectID or int) – The command identifier for the GET request. Must correspond to a valid PtccObjectID.
Returns:: The complete PTCC GET message encoded as a list of ASCII values, ready to transmit. Format: [ord(‘$’)] + HEX_ENCODED_DATA + CRC + [ord(‘#’)]
Return type:: list of int

Notes

The message body is composed of a PtccObject with no payload (data=[]), just an object ID.
The data is hex-encoded as ASCII character pairs (e.g., byte 0x4A becomes ‘4A’ → [ord(‘4’), ord(‘A’)]).
A 2-byte CRC is calculated over the raw object and appended in hex format.
The message is framed with $ and # characters as start/end delimiters.

class PtccMessageReceiver(clear_all_after_receive: bool = True)[source]

Bases: object

Receives, assembles, and decodes PTCC protocol messages byte-by-byte.

This class manages the incremental reception of raw PTCC messages, converting them into PtccObject instances once a full message is received and validated. It can optionally trigger user-defined callbacks for specific object IDs and handles message buffering and errors.

Parameters:: clear_all_after_receive (bool, optional) – If True (default), the internal state (messages, objects, and errors) is cleared after each successful message decode.

messages

Stores the list of currently received PtccMessage objects.

Type:: list of PtccMessage

objects

Stores successfully decoded PtccObject instances.

Type:: list of PtccObject

errors

Captures exceptions raised during message parsing or decoding.

Type:: list of Exception

clear_all_after_receive

Controls whether the internal state is cleared after a full message has been successfully received.

Type:: bool

callbacks

A registry of callbacks mapped by object ID. Each callback takes a PtccObject and optional user data.

Type:: dict[int, Tuple[Callable[[Any, Any], None], Any]]

add_byte(byte: int) → PtccMessageReceiveStatus[source]: Processes an incoming byte and updates message state. Returns message receive status.

add_bytes(bytes: list[int] | bytes | bytearray) → None[source]: Processes an incoming bytes and updates message state. Returns message receive status.

clear_all() → None[source]: Clears messages, objects, and errors.

clear_errors() → None[source]: Clears any parsing or decoding errors.

clear_messages() → None[source]: Clears all received raw messages.

clear_objects() → None[source]: Clears all decoded PtccObject instances.

obj_received_callback(obj: PtccObject) → None[source]: Process a received object. If a callback is registered for this object’s id, call it; if the object id is in ignored_objects, ignore it; otherwise raise an error.

register_callback(object_id: int | CallbackPtccObjectID, callback: Callable[[Any], None] | Callable[[Any, Any], None], user_data: Any = None) → None[source]: Register a callback function (with or without user data) for a particular object ID.

reset()[source]: Clears all internal state, including callbacks.

generate_msg_get_device_iden() → list[int][source]

Generates message for reading identification data of PTCC device.

Returns:: List of bytes of message a single message.
Return type:: list[int]

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_module_iden(module_type: ModuleType) → list[int][source]

Generates message for reading identification and configuration data of module connected to PTCC device.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_monitor() → list[int][source]

Generates message for reading measured parameters of no memory module connected to PTCC device.

Returns:: List of bytes of message a single message.
Return type:: list[int]

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_basic_params(module_type: ModuleType, target: DeviceRegister = DeviceRegister.USER_SET) → list[int][source]

Generates message for reading configuration (power, cooling) data for module connected to PTCC device.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message, or if target register is not recognized.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_config() → list[int][source]

Generates message for reading PTCC device type.

Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_cooler_disabled(module_type: ModuleType) → list[int][source]

Generates message for setting and saving operating mode of TEC as disabled.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_cooler_enabled(module_type: ModuleType) → list[int][source]

Generates message for setting and saving operating mode of TEC as enabled (Cooler will work with fixed supply current).

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_cooler_auto(module_type: ModuleType) → list[int][source]

Generates message for setting and saving operating mode of TEC as auto.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_param(module_type: ModuleType, ptcc_object: PtccObject) → list[int][source]

Generates message for setting and saving module parameters.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
ptcc_object (PtccObject) – PTCC object to send as configuration. Objects ID must be from BASIC_PARAMS_IDS list.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_fan(module_type: ModuleType, mode: PtccCtrl) → list[int][source]

Generates message for setting and saving operation state of fan control.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
mode (PtccCtrl) – operation state of fan control. On, Off or Auto.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_max_current(module_type: ModuleType, value_in_amperes: float) → list[int][source]

Generates message for setting maximum current for TEC output.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
value_in_amperes (float) – Represented in Amperes. Describes maximum current for TEC output.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_temperature(module_type: ModuleType, value_in_kelvins: int) → list[int][source]

Generates message for setting and saving desired detector temperature.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
value_in_kelvins (int) – Represented in Kelvins. Describes desired detector temperature.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_param(module_type: ModuleType, ptcc_object: PtccObject) → list[int][source]

Generates message for setting and saving lab_m parameters.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
ptcc_object (PtccObject) – PTCC object to send as configuration.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_offset(module_type: ModuleType, offset_value_in_volts: float) → list[int][source]

Generates message for setting and saving lab_m output DC offset for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
offset_value_in_volts (int) – lab_m offset.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_supply_voltage(module_type: ModuleType, supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float) → list[int][source]

Generates message for setting output voltage values of power lines.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_lab_m_monitor(module_type: ModuleType) → list[int][source]

Generates message for reading measured lab_m parameters of module connected to PTCC device.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_get_lab_m_params(module_type: ModuleType, target: DeviceRegister = DeviceRegister.USER_SET) → list[int][source]

Generates message for reading lab_m configuration data for module connected to PTCC device.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message, or if target register is not recognized.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_detector_voltage_bias(module_type: ModuleType, bias_value_in_volts: float) → list[int][source]

Generates message for setting and saving value of detector bias voltage for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
bias_value_in_volts (float) – lab_m voltage bias in Volts.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_gain(module_type: ModuleType, gain: GainVoltPerVolt | int) → list[int][source]

Generates message for setting and saving value of second stage gain for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
gain (Union[GainVoltPerVolt, int]) – lab_m gain.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_detector_current_bias_compensation(module_type: ModuleType, bias_value_in_ampers: float) → list[int][source]

Generates message for setting and saving value of bias current compensation for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_varactor(module_type: ModuleType, compensation: int) → list[int][source]

Generates message for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

module_type (ModuleType) – Specifies type of device/module for which the message is generated.
compensation (int) – lab_m frequency compensation.

Returns:

List of bytes of message a single message.

Return type:

list[int]

Raises:

ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_transimpedance_low(module_type: ModuleType) → list[int][source]

Generates message for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_transimpedance_high(module_type: ModuleType) → list[int][source]

Generates message for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_coupling_ac(module_type: ModuleType) → list[int][source]

Generates message for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_coupling_dc(module_type: ModuleType) → list[int][source]

Generates message for setting and saving the coupling mode as DC for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_bandwidth_low(module_type: ModuleType) → list[int][source]

Generates message for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_bandwidth_mid(module_type: ModuleType) → list[int][source]

Generates message for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

generate_msg_set_module_lab_m_bandwidth_high(module_type: ModuleType) → list[int][source]

Generates message for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Parameters:: module_type (ModuleType) – Specifies type of device/module for which the message is generated.
Returns:: List of bytes of message a single message.
Return type:: list[int]
Raises:: ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

class CommunicationInterface(*args, **kwargs)[source]

Bases: Protocol

read(size: int = 1) → bytes[source]

write(data: bytes) → None[source]

detect_device(comm: CommunicationInterface, receiver: PtccMessageReceiver = None) → PtccDevice[source]

Detects the connected PTCC module type and returns an appropriate device interface instance.

This function sends a query to the connected PTCC device to identify type of module connected to it by requesting monitor information. Based on the response, it instantiates and returns the appropriate subclass of PtccDevice.

Parameters:

comm (CommunicationInterface) – The communication interface to send and receive data from the PTCC device.
receiver (PtccMessageReceiver, optional) – An optional receiver to be passed to the constructed PtccDevice instance. If not provided, a new receiver will be created internally.

Returns:

A specific subclass of PtccDevice based on the detected module type.

Return type:

PtccDevice

Raises:

IOError – If no response is received from the device after repeated attempts.
ValueError – If the received module type is not recognized.

Notes

The function reads bytes from the communication interface until a complete and valid message is received or the timeout threshold is reached. module type detection is based on a response to the generate_msg_get_monitor query.

class PtccDevice(comm: CommunicationInterface, receiver: PtccMessageReceiver = None)[source]

Bases: object

High-level interface for communicating with a PTCC device.

This class wraps a lower-level communication interface and handles message construction, throttling, and dispatching for PTCC commands. It optionally connects to a message receiver for returning values from received messages.

Use detect_device() for ensuring correct device/module type is used.

Parameters:

comm (CommunicationInterface) – A low-level communication object that handles byte-level I/O with the device.
receiver (PtccMessageReceiver, optional) – An optional receiver instance to manage incoming messages. If not provided, a default PtccMessageReceiver will be used.

comm

A communication wrapper that ensures a minimum delay (0.55s) between message transmissions.

Type:: ThrottledCommunication

receiver

The object responsible for receiving and decoding incoming PTCC messages.

Type:: PtccMessageReceiver

property module_type: ModuleType

type of module connected to PTCC device.

Type:: ModuleType

abstractmethod write_msg_get_basic_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading configuration (power, cooling) data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_config()[source]

Sends a message to PTCC device. Used for reading PTCC device type.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_device_iden()[source]

Sends a message to PTCC device. Used for reading identification data of PTCC device.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_get_lab_m_monitor()[source]

Sends a message to PTCC device. Used for reading measured lab_m parameters of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_get_lab_m_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading lab_m configuration data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_get_module_iden()[source]

Sends a message to PTCC device. Used for reading identification and configuration data of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_get_monitor()[source]

Sends a message to PTCC device. Used for reading measured parameters of no memory module connected to PTCC device.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_cooler_auto()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_cooler_disabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as disabled.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_cooler_enabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as enabled (Cooler will work with fixed supply current).

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_fan(mode: PtccCtrl)[source]

Sends a message to PTCC device. Used for setting and saving operation state of fan control.

Parameters:

mode (PtccCtrl) – operation state of fan control. On, Off or Auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_max_current(value_in_amperes: float)[source]

Sends a message to PTCC device. Used for setting maximum current for TEC output.

Parameters:

value_in_amperes (float) – Represented in Amperes. Describes maximum current for TEC output.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_bandwidth_high()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_bandwidth_low()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_bandwidth_mid()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_coupling_ac()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_coupling_dc()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as DC for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_detector_current_bias_compensation(bias_value_in_ampers: float)[source]

Sends a message to PTCC device. Used for setting and saving value of bias current compensation for lab_m module.

Parameters:

bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers. Must be in the range [0.0, 0.01].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_detector_voltage_bias(bias_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving value of detector bias voltage for lab_m module.

Parameters:

bias_value_in_volts (float) – detector bias voltage in Volts. Must be in the range [0.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_gain(gain: GainVoltPerVolt | int)[source]

Sends a message to PTCC device. Used for setting and saving value of second stage gain for lab_m module.

Parameters:

gain (Union[GainVoltPerVolt, int]) – lab_m gain. If integer (bit value) is provided the value must be in range [0, 256].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_module_lab_m_gain(GainVoltPerVolt.X5): Sets gain equal to 5 V/V.
write_msg_set_module_lab_m_gain(75): Sets gain equal to 5 V/V corresponding to number 75 [bit value].

abstractmethod write_msg_set_module_lab_m_offset(offset_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving lab_m output DC offset for lab_m module.

Parameters:

offset_value_in_volts (float) – lab_m output DC offset. Must be in the range [-1.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving lab_m parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_transimpedance_high()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_transimpedance_low()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_lab_m_varactor(compensation: int)[source]

Sends a message to PTCC device. Used for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

compensation (int) – lab_m frequency compensation.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_module_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving module parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration. Objects ID must be from BASIC_PARAMS_IDS list.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

abstractmethod write_msg_set_supply_voltage(supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float)[source]

Sends a message to PTCC device. Used for setting output voltage values of power lines.

Parameters:

supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_supply_voltage(supp_ctrl_mode=PtccCtrl.AUTO, supply_voltage_positive=9.0, supply_voltage_negative=-9.0)

abstractmethod write_msg_set_temperature(value_in_kelvins: int)[source]

Sends a message to PTCC device. Used for setting and saving desired detector temperature.

Parameters:

value_in_kelvins (int) – Represented in Kelvins. Describes desired detector temperature.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

class PtccNoMemDevice(comm: CommunicationInterface, receiver: PtccMessageReceiver = None)[source]

Bases: PtccDevice

write_msg_get_basic_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading configuration (power, cooling) data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_lab_m_monitor()[source]

Sends a message to PTCC device. Used for reading measured lab_m parameters of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_lab_m_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading lab_m configuration data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_module_iden()[source]

Sends a message to PTCC device. Used for reading identification and configuration data of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_auto()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_disabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as disabled.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_enabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as enabled (Cooler will work with fixed supply current).

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_fan(mode: PtccCtrl)[source]

Sends a message to PTCC device. Used for setting and saving operation state of fan control.

Parameters:

mode (PtccCtrl) – operation state of fan control. On, Off or Auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_max_current(value_in_amperes: float)[source]

Sends a message to PTCC device. Used for setting maximum current for TEC output.

Parameters:

value_in_amperes (float) – Represented in Amperes. Describes maximum current for TEC output.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_high()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_low()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_mid()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_ac()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_dc()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as DC for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_current_bias_compensation(bias_value_in_ampers: float)[source]

Sends a message to PTCC device. Used for setting and saving value of bias current compensation for lab_m module.

Parameters:

bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers. Must be in the range [0.0, 0.01].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_voltage_bias(bias_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving value of detector bias voltage for lab_m module.

Parameters:

bias_value_in_volts (float) – detector bias voltage in Volts. Must be in the range [0.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_gain(gain: GainVoltPerVolt | int)[source]

Sends a message to PTCC device. Used for setting and saving value of second stage gain for lab_m module.

Parameters:

gain (Union[GainVoltPerVolt, int]) – lab_m gain. If integer (bit value) is provided the value must be in range [0, 256].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_module_lab_m_gain(GainVoltPerVolt.X5): Sets gain equal to 5 V/V.
write_msg_set_module_lab_m_gain(75): Sets gain equal to 5 V/V corresponding to number 75 [bit value].

write_msg_set_module_lab_m_offset(offset_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving lab_m output DC offset for lab_m module.

Parameters:

offset_value_in_volts (float) – lab_m output DC offset. Must be in the range [-1.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving lab_m parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_high()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_low()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_varactor(compensation: int)[source]

Sends a message to PTCC device. Used for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

compensation (int) – lab_m frequency compensation.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving module parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration. Objects ID must be from BASIC_PARAMS_IDS list.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_supply_voltage(supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float)[source]

Sends a message to PTCC device. Used for setting output voltage values of power lines.

Parameters:

supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_supply_voltage(supp_ctrl_mode=PtccCtrl.AUTO, supply_voltage_positive=9.0, supply_voltage_negative=-9.0)

write_msg_set_temperature(value_in_kelvins: int)[source]

Sends a message to PTCC device. Used for setting and saving desired detector temperature.

Parameters:

value_in_kelvins (int) – Represented in Kelvins. Describes desired detector temperature.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

class PtccLabMDevice(comm: CommunicationInterface, receiver: PtccMessageReceiver = None)[source]

Bases: PtccMemDevice

write_msg_get_lab_m_monitor()[source]

Sends a message to PTCC device. Used for reading measured lab_m parameters of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_lab_m_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading lab_m configuration data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_high()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_low()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_mid()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_ac()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_dc()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as DC for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_current_bias_compensation(bias_value_in_ampers: float)[source]

Sends a message to PTCC device. Used for setting and saving value of bias current compensation for lab_m module.

Parameters:

bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers. Must be in the range [0.0, 0.01].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_voltage_bias(bias_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving value of detector bias voltage for lab_m module.

Parameters:

bias_value_in_volts (float) – detector bias voltage in Volts. Must be in the range [0.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_gain(gain: GainVoltPerVolt | int)[source]

Sends a message to PTCC device. Used for setting and saving value of second stage gain for lab_m module.

Parameters:

gain (Union[GainVoltPerVolt, int]) – lab_m gain. If integer (bit value) is provided the value must be in range [0, 256].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_module_lab_m_gain(GainVoltPerVolt.X5): Sets gain equal to 5 V/V.
write_msg_set_module_lab_m_gain(75): Sets gain equal to 5 V/V corresponding to number 75 [bit value].

write_msg_set_module_lab_m_offset(offset_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving lab_m output DC offset for lab_m module.

Parameters:

offset_value_in_volts (float) – lab_m output DC offset. Must be in the range [-1.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving lab_m parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_high()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_low()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_varactor(compensation: int)[source]

Sends a message to PTCC device. Used for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

compensation (int) – lab_m frequency compensation.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_supply_voltage(supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float)[source]

Sends a message to PTCC device. Used for setting output voltage values of power lines.

Parameters:

supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_supply_voltage(supp_ctrl_mode=PtccCtrl.AUTO, supply_voltage_positive=9.0, supply_voltage_negative=-9.0)

class PtccMemDevice(comm: CommunicationInterface, receiver: PtccMessageReceiver = None)[source]

Bases: PtccDevice

write_msg_get_basic_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading configuration (power, cooling) data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_lab_m_monitor()[source]

Sends a message to PTCC device. Used for reading measured lab_m parameters of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_lab_m_params(target: DeviceRegister = DeviceRegister.USER_SET)[source]

Sends a message to PTCC device. Used for reading lab_m configuration data for module connected to PTCC device.

Parameters:

target (DeviceRegister) – Specifies which type of register should be read: DeviceRegister.DEFAULT - register for default setting. DeviceRegister.USER_SET - register for user setting. DeviceRegister.USER_MIN - register for max allowed setting. DeviceRegister.USER_MAX - register for min allowed setting.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_get_module_iden()[source]

Sends a message to PTCC device. Used for reading identification and configuration data of module connected to PTCC device.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_auto()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_disabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as disabled.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_cooler_enabled()[source]

Sends a message to PTCC device. Used for setting and saving operating mode of TEC as enabled (Cooler will work with fixed supply current).

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_fan(mode: PtccCtrl)[source]

Sends a message to PTCC device. Used for setting and saving operation state of fan control.

Parameters:

mode (PtccCtrl) – operation state of fan control. On, Off or Auto.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_max_current(value_in_amperes: float)[source]

Sends a message to PTCC device. Used for setting maximum current for TEC output.

Parameters:

value_in_amperes (float) – Represented in Amperes. Describes maximum current for TEC output.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_high()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as HIGH (Depends on detector parameters and first stage transimpedance) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_low()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as LOW (1.5 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_bandwidth_mid()[source]

Sends a message to PTCC device. Used for setting and saving value of bandwidth as MID (15 MHz) for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_ac()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as AC for lab_m module for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_coupling_dc()[source]

Sends a message to PTCC device. Used for setting and saving the coupling mode as DC for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_current_bias_compensation(bias_value_in_ampers: float)[source]

Sends a message to PTCC device. Used for setting and saving value of bias current compensation for lab_m module.

Parameters:

bias_value_in_ampers (float) – lab_m currrent bias compensation in Ampers. Must be in the range [0.0, 0.01].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_detector_voltage_bias(bias_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving value of detector bias voltage for lab_m module.

Parameters:

bias_value_in_volts (float) – detector bias voltage in Volts. Must be in the range [0.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_gain(gain: GainVoltPerVolt | int)[source]

Sends a message to PTCC device. Used for setting and saving value of second stage gain for lab_m module.

Parameters:

gain (Union[GainVoltPerVolt, int]) – lab_m gain. If integer (bit value) is provided the value must be in range [0, 256].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_module_lab_m_gain(GainVoltPerVolt.X5): Sets gain equal to 5 V/V.
write_msg_set_module_lab_m_gain(75): Sets gain equal to 5 V/V corresponding to number 75 [bit value].

write_msg_set_module_lab_m_offset(offset_value_in_volts: float)[source]

Sends a message to PTCC device. Used for setting and saving lab_m output DC offset for lab_m module.

Parameters:

offset_value_in_volts (float) – lab_m output DC offset. Must be in the range [-1.0, 1.0].

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving lab_m parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_high()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as HIGH for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_transimpedance_low()[source]

Sends a message to PTCC device. Used for setting and saving transimpedance of first stage preamplifier as LOW for lab_m module.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_lab_m_varactor(compensation: int)[source]

Sends a message to PTCC device. Used for setting and saving frequency compensation for the preamplifier first stage for lab_m module.

Parameters:

compensation (int) – lab_m frequency compensation.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_module_param(ptcc_object: PtccObject)[source]

Sends a message to PTCC device. Used for setting and saving module parameters.

Parameters:

ptcc_object (PtccObject) – PTCC object to send as configuration. Objects ID must be from BASIC_PARAMS_IDS list.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

write_msg_set_supply_voltage(supp_ctrl_mode: PtccCtrl, supply_voltage_positive: float, supply_voltage_negative: float)[source]

Sends a message to PTCC device. Used for setting output voltage values of power lines.

Parameters:

supp_ctrl_mode (PtccCtrl) – Variable is used to set operating mode of power supply output. AUTO mode is used to protect the detector.
supply_voltage_positive (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.
supply_voltage_negative (float) – Represented in Volts. Responsible for setting output voltage value of positive power line.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

Example

write_msg_set_supply_voltage(supp_ctrl_mode=PtccCtrl.AUTO, supply_voltage_positive=9.0, supply_voltage_negative=-9.0)

write_msg_set_temperature(value_in_kelvins: int)[source]

Sends a message to PTCC device. Used for setting and saving desired detector temperature.

Parameters:

value_in_kelvins (int) – Represented in Kelvins. Describes desired detector temperature.

Raises:

TypeError – Raised to indicate that this message type is unsupported for specified device/module type.
ValueError – if module type is not supported for this kind of message.

Notes

PTCC device will respond to this message. You can set those CallbackPtccObjectID to see the response:

flatten(xss)[source]

to_bytes(t: ValType, value) → list[int][source]

Converts a value to a list of byte values based on the provided Type.

Returns a list of integers (0-255) that represent the bytes.

from_bytes(t: ValType, input_list: list[int] | bytes | bytearray) → any[source]: Converts a list of bytes (integers 0–255) into a Python value based on the provided Type.