# Communication Protocol

The communication protocol is the set of rules that govern how data is transmitted and received between the NEON devices and the application server. It defines the format, sequencing, and error control of the messages exchanged over LoRa. 

Each device type has its own communication protocol and, in some cases, there are multiple versions for a single device type. In said cases, the product identification on the label of the device will be necessary to determine which protocol version the device uses.

The user must read the communication protocol of the device being used to understand the structure and the different types of messages. A summary table specifying the communication protocol version per product type and variation is presented next.

{% hint style="danger" %}
The protocol version is related to the product type. Protocol v2 of the Temperature Transmitter (TT) is not the same as Protocol v2 of the Vibration Sensor (VB)
{% endhint %}

| Product type                        | Variation                                   | Protocol version                                                                                                 |
| ----------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Pressure Gauge (PG)                 | DS-RT-02-00                                 | [v1](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/PG/LoRa%20Communication/Protocol%20v1) |
| Pressure Sensor (PS)                | DS-RT-02-00                                 | [v1](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/PS/LoRa%20Communication/Protocol%20v1) |
| Temperature Sensor (TS)             | All TS devices                              | [v2](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/TS/LoRa%20Communication)               |
| Temperature Transmitter (TT)        | DS-TT-01-xx production batch AA             | [v2](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/TT/LoRa%20Communication/Protocol%20v2) |
|                                     | DS-TT-01-xx production batch AB and higher  | [v3](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/TT/LoRa%20Communication/Protocol%20v3) |
|                                     | DS-TT-01-03 production batch AD and higher  | [v4](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/TT/LoRa%20Communication/Protocol%20v4) |
|                                     | DS-TT-02-00                                 | [v4](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/TT/LoRa%20Communication/Protocol%20v4) |
| Vibration Sensor (VB)               | DS-LD-01-xx                                 | [v2](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VB/LoRa%20Communication/Protocol%20v2) |
|                                     | DS-LD-01-03 production batch AD             | [v3](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VB/LoRa%20Communication/Protocol%20v3) |
|                                     | DS-LD-02-00                                 | [v3](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VB/LoRa%20Communication/Protocol%20v3) |
|                                     | DS-LD-02-00 production batch AF and higher  | [v4](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VB/LoRa%20Communication/Protocol%20v4) |
|                                     | DS-LD-xx-xx after firmware update to v3.x.x | [v4](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VB/LoRa%20Communication/Protocol%20v4) |
| Contact Sensor (VS-CS)              | All VS-CS devices                           | [v1](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VS-CS/LoRa%20Communication)            |
| Valve Sensor - Multiturn (VS-MT)    | All VS-MT devices                           | [v2](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VS-MT/LoRa%20Communication)            |
| Valve Sensor - Quarter Turn (VS-QT) | All VS-QT devices                           | [v2](https://github.com/TWTG-R-D-B-V/neon-product-documentation/tree/main/VS-QT/LoRa%20Communication)            |

{% hint style="info" %}
X is used as a representation of any value applicable unless stated otherwise. 
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.twtg.io/docs/data-and-communication/communication-protocol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.