K-Patents PR-33-AC - Manual (Page 45)

9 Ethernet protocol specification 39
© Copyright K-Patents 2014. All rights reserved.
size of the message does not exceed the maximum of 1472 octets. This may be useful,
for example, if the client implementation uses fixed-length packets.
9.1.2 Response format
The response data sent by the instrument is in ASCII format. With the exception of the
packet number, the data is human-readable. The data structure is very simple:
−
packet number (32-bit integer)
−
zero or more lines of ASCII (text) keys and values associated with these keys (for
example temperature key and process temperature in Celsius)
The packet number is echoed back without change. The client (software on computer)
can use the packet number to check the response against the packet number of the
request.
The message text consists of lines of text, each line a single key (of one word) and
its value or values. The values are separated from the key by an equal sign ( = ) and
multiple values are separated by a comma. White space (space or tabulator) is allowed
anywhere except within a single value or key name.
If the response consists of a character string, it is enclosed in double quotes (").
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 9.2 for additional information) are case-insen-
sitive. However, K-Patents recommends that they are written as in this specification.
The server (refractometer) may send the response keys in any order. It will send the
mandatory keys (marked with an asterisk in Section 9.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.