Datalogger ESC8816 communication protocol
Supported device types and versions
Communication line configuration
Communication station configuration
I/O tag configuration
Literature
Changes and modifications
Document revisions
| Kotva | ||||
|---|---|---|---|---|
|
...
Implementation was performed and verified according to the ESC Model 8816 – Data Logger Engineering Manual – TIN 96-1169, August 1996 for the datalogger software version 5.02.
Starting with D2000 version 10.0.37 communication with datalogger DLX1 is supported. For this device, communication on TCP/IP-TCP line was also implemented.
Protocol is compatible also with a datalogger EDL 15 produced by ECM Monitory for which addressing of channels above 99 is supported.
Communication includes:
Table 1
| Measurement type | I/O tag type | Communication function | Documentation |
|---|---|---|---|
| Current values | AI | Poll Most Recent Instantaneous Reading | Appendix A – A54 |
| Current value flags | DI | Poll Most Recent Instantaneous Reading | Appendix A – A54 |
| 1m averages with flags | AI, DI | Retrieve Averages | Appendix A – A24 |
| 15m averages with flags | AI, DI | Retrieve Averages | Appendix A – A24 |
| 30m averages with flags | AI, DI | Retrieve Averages | Appendix A – A24 |
| 60m averages with flags | AI, DI | Retrieve Averages | Appendix A – A24 |
| Custom-period averages with flags | AI, DI | Retrieve Averages | Appendix A – A24 |
| Digital inputs | DI | Poll Current Digital Input Status | Appendix A – A19 |
| Calibrations | AI | Poll Calibration Results | Appendix A – A22 |
| Real time – read | TOA | Poll Current Time | Appendix A – A56 |
| Real time – write | TOA | Download Current Time | Appendix A – A40 |
| Mathematic constants – write | AO | Download Math Pack Constants | Appendix A – A45 |
| Relay outputs – write | DOUT | Switch Digital Output Control Relay On/Off | Appendix A – A64 |
| Kotva | ||||
|---|---|---|---|---|
|
...
- Communication line category: Serial, SerialOverUDP Device Redundant, RFC2217 Client, TCP/IP-TCP (for DLX1).
- Baud rate according to the ESC 8816 datalogger settings - System Configuration Screen – Baud Rate – Port 1, Baud Rate – Port 2 or Baud Rate – Port 3 according to the used datalogger port, 1 stop bit, 8 data bits, no parity.
...
There can be defined the following line protocol parameters:
Table 2
| Keyword | Full name | Meaning | Unit | Default value | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Passive Mode | Enables the passive mode (listening) of the line. Definition of the parameter PM for one station on the line is enough. In the mode, there is monitored the communication between datalogger ESC 8816 and other device (datalogger's responses to master are monitored). Listening allows to get the following types of values:
If the passive mode has been enabled (PM=True), to disable it you must either set the parameter PM=False or restart the process D2000 KOM (i.e. deleting the parameter PM=True is not sufficient). | - | - | ||||||
| Passive Mode Timeout | Timeout after expiration of which all stations changes their states to the error state, if the line is in the passive mode (see the parameter PM). If no data are received within the timeout, all the stations on the line will changes their states to the error state. | sec | 10 | ||||||
| Debug Calibration | Extended debug information for calibration data reading. | - | False | ||||||
| Acknowledge Calibration Data | Acknowledgement of calibration data will be sent to datalogger. If acknowledgement is not sent, datalogger will repeatedly send all available calibration data. | - | True |
| Kotva | ||||
|---|---|---|---|---|
|
...
There can be defined the following station protocol parameters:
Table 3
| Keyword | Full name | Meaning | Unit | Default value | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Retry Count | Poll repetition count in case of a communication error. | - | 2 | ||||||
| Retry Timeout | Delay between poll repetition in case of a communication error. | ms | 1000 ms. | ||||||
| Wait First Timeout | Delay after transmitting the poll before reading the response. | ms | 500 ms. | ||||||
| Wait Timeout | Delay between response readings till its finalization. | ms | 400 ms. | ||||||
| Max Wait Retry | Repetition count of response readings till its finalization. | - | 8 | ||||||
| Get Stored Interval | Period, during which there are read archive data from the datalogger without interruption. The period is given in minutes. If the value of the period is e.g. 60 minutes, so there are read all archive data from e.g. June 3rd 1996 05:00 to 06:00, then from 06:00 to 07:00 etc. Loading archive data within the period couldn't take more than one minute, because there could be lost some current data acquired among archive readings. | min | 10 | ||||||
| Protocol Variant | Variant of protocol. Existing variants are:
| - | 0 - ESC8816 |
String containing the protocol parameters is being defined as follows:
...
Averages are value of AI type (Analog Input). Measurement type is 1m AV for 1m averages, 15m AV for 15m averages, 30m AV for 30m averages and 60m AV“ for 60m averages. Channel number is a decimal number within the range of 0..99 (see the note about channel addressing).
...
Flags of averages are values of DI type (Digital Input). Measurement type is 1mAV Flag for 1m averages, 15mAV Flag for 15m averages, 30mAV Flag for 30m averages and 60mAV Flag for 60m averages. Channel number is a decimal number within the range of 0..99 (see the note about channel addressing).
...
Calibration results are values of the AI type (Analog Input). Measurement type is CALIB Ph1 for acquiring the value of Average During Zero value or CALIB Ph2 for acquiring the value of Average During Span1. Channel number is a decimal number within the range of 0...99 (see the note about channel addressing).
...
I/O tag flags (from A to P) are adjusted according occurrence of datalogger flags for current values, 1m averages and 30m averages as follows:
Table 3
| I/O tag flag | Meaning | Datalogger flag |
|---|---|---|
| A | Invalid measurement | "<" or „C“, „B“, „M“, „P“ a „D“ |
| B | Transient operation | "F" |
| C | Calibration | "C" |
| D | Malfunction | "B" |
| E | Maintenance | "M" |
| F | Power cut | "P" |
| G | Inactive measurement | "D" |
| I | Layoff | "F" |
Acquisition of archive (stored) values
...