beautypg.com

K-Patents PR-21-S User Manual

Page 118

background image

112

PR-21-S instruction manual

For example all these are valid message text lines:

ok

temp=23.45

headhum = 13.32

LEDcnt = 8341

ChemCurve = 1.234, 3.21, 0.00, 4.37, 1.11, 0.00002, 2.1345

StatusMessage = "Normal Operation"

Note: All the key identifiers (see Section 11.5.2 for additional information) are
case-insensitive. However, K-Patents recommends that they are written as in this
specification.

The server (DTR) may send the response keys in any order. It will send the manda-
tory keys (marked with an asterisk in Section 11.5.2) of the specific request, but it
may omit any other keys. The server may also send keys that are not specified in
this document, but the client (computer) may ignore them.

Request and response errors

When the server (DTR) detects an error, it responds with an error message (for
more information see Section 11.5.3). An error message can be caused for example
by an unknown request or inability to collect data for the mandatory keys of a
response.

11.5.2 Request-response pair specification

The list below describes the query messages, i.e. request-response pairs, used for
data collection via Ethernet. Mandatory response keys are preceded by an as-
terisk (*).
Note:

Even when multiple request data options are available, only one can be

used at a time. For example each sensor status request must be directed to either
sensor A or sensor B, not both.

NULL message

The null message is included in the query messages for debugging purposes as it
can be used to check whether the server is listening. The message gives a high-level
’ping’ functionality.

Request ID

0x00000000

Request data

(none)

Response key

IP

: IP address

MAC

: Ethernet MAC address