-----------------------------------------------------------------------------------------------------------------------

 Description of HTTP GET from VALUES.XML for TAx6xx and PAx6xx Web Sensors

 v1.0 for firmware 11-0-0-0 or higher

-----------------------------------------------------------------------------------------------------------------------

1.  History of changes

    |-----------------------|--------------------|--------------------------------------------------------------------|
    | Date                  | Version            | Description of changes                                             |
    |                       |                    |                                                                    |
    |-----------------------|--------------------|--------------------------------------------------------------------|
    | 2026-03-20            | v1.0               | Initial revision of the document                                   |
    |-----------------------|--------------------|--------------------------------------------------------------------|


2.  Structure of VALUES.XML and parameters

2.1 Description

    Measured values can be obtained via HTTP GET requests sent to the HTTP server running on the Web Sensor. Requests 
    for the file values.xml can be sent to the server on port 80. This feature is independent of the HTTP(s) server 
    running on port 81 or 443 (when HTTPs is enabled), which is intended for user access. To use this feature, it must 
    be enabled in the device settings (Protocols / HTTP Server / JSON and XML). When the feature is disabled, an 
    HTTP 403 error code is returned. Access to the file values.xml is independent of the device security subsystem. 
    The files are accessible on port 80 without any restrictions. The XML file uses UTF-8 encoding.

    Responses to HTTP GET requests for the file values.xml on port 80 are served by an HTTP/1.0 server with single 
    TCP socket capability. Response time depends on the load of the HTTP server. The average response time is 10 ms. 
    In case of communication issues or server overload, the response time may be higher.


2.2 XML structure

    The structure of the XML file is defined by the XSD schema available in the "xsd" directory.


2.3 Tags at <root> key

    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | Parameter             | Type   | Range     | Description                                                        |
    |                       |        |           |                                                                    |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <devname>             | STR    | 64B len   | Device name                                                        |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <devsn>               | STR    | 8B len    | Serial number of the device (e.g. 26680001)                        |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <time>                | STR    | RFC3339   | Current device time                                                |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <timeunix>            | INT    | 32b unsig | Current device time as Unix timestamp (seconds since 01/01/1970)   |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <synch>               | INT    | 0, 1      | Indicates if device time is valid (1 = RTC time is valid)          |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <acc>                 | INT    | 0, 1      | Acoustic measurement active (1 = active)                           |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <ch1>                 |        |           | Elements containing information for each channel with current      |
    |  ...                  |        |           | measured values.                                                   |
    | <ch8>                 |        |           |                                                                    |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|


2.4 Tags at channels

    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | Parameter             | Type   | Range     | Description                                                        |
    |                       |        |           |                                                                    |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <name>                | STR    | 32B len   | English description of the measured value for the channel          |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <unit>                | STR    | 16B len   | Unit of the channel                                                |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <value>               | STR    | 32B len   | Measured value as string (e.g., 12.8, n/a, ErrorX)                 |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <alarm1>              | INT    | 0, 1      | Alarm 1 state (1 = alarm)                                          |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|
    | <alarm2>              | INT    | 0, 1      | Alarm 2 state (1 = alarm)                                          |
    |-----------------------|--------|-----------|--------------------------------------------------------------------|


3.  Example of values.xml

    An example XML file is available in the "xml-example" directory.


4.  Code examples

    The "code-examples" directory contains examples showing how to obtain values using different programming languages. 
    The current version of the SDK includes examples in Python only.

