diff --git a/Documentation/bluetooth/ess.rst b/Documentation/bluetooth/ess.rst new file mode 100644 index 0000000000000000000000000000000000000000..6a84a6aba07cdb58e34a084291562e4e8a89089b --- /dev/null +++ b/Documentation/bluetooth/ess.rst @@ -0,0 +1,65 @@ +Environmental Sensing Service +======================== + +.. warning:: + This service will be available in version v1.17 + +The Environmental Sensing Service (ESS) implements access to +the BME680 environmental sensor of the card10. + +It provides: + +- Temperature +- Relative humidity +- Pressure + + +If notifcations are enabled a measurement of all values is performed every 3 seconds. For each measurement a notification is sent for the characteristics which have notifications enabled. + + +A measurement can also be triggered by reading from a characteristic. A measurement takes roughly 200 ms. A notifciation will be sent to all characteristics which have notifications enabled except the one which was used to trigger the measurement. + + +BLE Service +----------- + +- Service + + UUID: ``181A`` + +- Temperature characteristic: + + UUID: ``2A6E`` + read and notify + +- Humidity characteristic: + + UUID: ``2A6F`` + read and notify + +- Pressure characteristic: + + UUID: ``2A6D`` + read and notify + +Temperature characteristic +--------------------------------- + +- 16 bit little endian value representing the measured temperature. + +- Unit: 0.01 deg C + + +Humidity characteristic +--------------------------------- + +- 16 bit little endian value representing the measured relative humidity. + +- Unit: 0.01% + +Pressure characteristic +--------------------------------- + +- 32 bit little endian value representing the measured pressure. + +- Unit: 0.1 Pa (0.001 hPa) diff --git a/Documentation/index.rst b/Documentation/index.rst index f83d9ee79b55cae3248cb1529be9cc1f02cda897..1090ad48cb9d2fce0e4cc5ed58512cd4b133c737 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -69,6 +69,7 @@ Last but not least, if you want to start hacking the lower-level firmware, the :maxdepth: 1 :caption: Bluetooth + bluetooth/ess bluetooth/file-transfer bluetooth/card10 bluetooth/nimble