file: vmtpod53cmd.html
14 Feb 2003

VMTPOD53 Command Set - Version 3.xx

- The following commands are available on the RS-485 communications link to the VMTPOD53 board. This board is used for the temperature option in the VMCM2.

- Note: commands sent are indicated in BOLD, responses in normal text. <crlf> represents ASCII carriage return and line feed.

- Refer to Latest Version Information for reference info on latest firmware version numbers.

     Command    Description

A Address acknowledge - returns address of module, terminated by <crlf> - e.g. #TPD01A TPD01<crlf> - NOTE 1: TPD01 is the default address of the VMTPOD53 board; it may be changed by the 'U' command but any failure of EEPROM will result in the use of the default address. In addition, use of defaults is reported in the 'L' command. H Help - #TPD01H - a multiple line response with text similar to the first line of each command description in this document as the help line, with each line terminated <crlf>, as follows: Firmware VMTPOD53 v3.00 A - Address acknowledge H - Display Help message L - Report ID, serial #, cal info M - Report cal constant set 1: A B C P - Calibrated and raw data S[0-4] - Report status 0 to 4 T - Enter test mode U - Update EEPROM constants - password 'OK' - A,Cxy,D,M,Q,S,T,WOK L Report ID, serial #, cal info, etc. - the 'L' command provides miscellaneous status information about the module in a multi-line response. - 6 lines of info are provided, as follows: #TPD01L module id from EEPROM module serial number from EEPROM firmware name and version from program EPROM thermistor info from EEPROM setup date from EEPROM cal constants from EEPROM - example normal response (6 lines plus initial <crlf> for formatting): TPD01 001 VMTPOD53 v3.00 YSI-12345 sr#321 04FEB03 9.30950e-04 2.21690e-04 1.25570e-07 M Output first set of calibration constants - returns cal set #1 values A B C without heading, space separated (for easy access from main VMCM2 logger board) - example: #TPD01M 9.30950e-04 2.21690e-04 1.25570e-07 P Output polled mode data - outputs both calibrated and raw data, after slight delay to acquire new data; parameters including raw counts from A/D converter, as follows: deg_C therm_resistance_ohms therm_counts ref_counts<crlf> - example: #TPD01P 18.396 40069.9 15869 11881 S Report status 0 to 4 - returns 1 of 5 values from EEPROM (set via UOK) and EPROM (for easy access from main VMCM2 logger board) - S0 firmware revision from EPROM - S1 model info from EEPROM - S2 serial number from EEPROM - S3 setup date from EEPROM - S4 thermistor info from EEPROM - example: #TPD01S0 VMTPOD53 v3.00 T Enter test mode - responds with continuous scans (about 1 second interval) of all parameters including raw counts from A/D converter, as follows: deg_C therm_resistance_ohms therm_counts ref_counts<crlf> - example: #TPD01T 18.396 40069.9 15869 11881<crlf> . . - exits on receipt of ESC character. U Update EEPROM contents - enters the update mode after confirmation of 'OK' password. New EEPROM values may be entered in this mode. - upon initial entry, you must send the letters OK after the command or the command is ignored, e.g. #TPD01UOK may be sent as one. Upon receipt of the correct 'password', the response will be OK if current parameters are valid, or NEW if parameters have never been entered or are suspicious (i.e. EEPROM failure or bad internal checksum). - response to an unknown command is '?' - IMPORTANT! command letter or letters A, Cxy, D, M, S or T will respond with the current setting when issued followed by <cr> only . If followed by =xxxxx<cr>, where xxxxx is some appropriate value, the EEPROM setting will be changed pending receipt of 'WOK' command to make it permanent. Subsequent requests for current settings will report the new value while still in update mode. However, if update mode is exited with 'Q', the original settings of all parameters will remain intact. - note that D, M, S, and T are free-format alpha-numeric entries - the following commands are available in EEPROM update mode: A - module Address (1 to 5 characters) Cxy - Cal Constants, where x is set 1, and y is constant A to C D - Date of Setup or Calibration (7 char max) M - Model info (15 char max) Q - Quit without writing new info to EEPROM S - Serial number (7 char max) T - Thermistor info (31 char max) WOK - Write new info to EEPROM and exit - Cal constants are used as follows: Degrees_C = (1.0 / (A + (B * log(thermistor_resistance_ohms)) + (C * (log(thermistor_resistance_ohms^3)))) - 273.15 - examples: To change the current address: A=TP302<cr> To see the address: A<cr> To see the current C1A cal constant: C1A<cr> To change it: C1A=9.3095e-4<cr> NOTE: New value is echoed back. NOTE: Upon completion, the newly updated module address will not take effect until the next reset or power-up.