Jean-François Milants c94a59e7d3 SimpleWeather service : new weather implementation

This new implementation of the weather feature provides a new BLE API and a new weather service.
The API uses a single characteristic that allows companion apps to write the weather conditions (current and forecast for the next 5 days).
The SimpleWeather service exposes those data as std::optional fields.

This new implementation replaces the previous WeahterService.

The API is documented in docs/SimpleWeatherService.md.

2023-12-23 21:12:25 +01:00

2.2 KiB

Raw Blame History

Simple Weather Service

Introduction

The Simple Weather Service provide a simple and straightforward API to specify the current weather and the forecast for the next 5 days. It effectively replaces the original Weather Service (from InfiniTime 1.8) since InfiniTime 1.14

Service

The service UUID is 00050000-78fc-48fe-8e23-433b3a1942d0.

Characteristics

Weather data (UUID 00050001-78fc-48fe-8e23-433b3a1942d0)

The host uses this characteristic to update the current weather information and the forecast for the next 5 days.

This characteristics accepts a byte array with the following 2-Bytes header:

[0] Message Type :
- 0 : Current weather
- 1 : Forecast
[1] Message Version : Version 0 is currently supported. Other versions might be added in future releases

Current Weather

The byte array must contain the following data:

[0] : Message type = 0
[1] : Message version = 0
[2][3][4][5][6][7][8][9] : Timestamp (64 bits UNIX timestamp, number of nanoseconds elapsed since 1 JAN 1970)
[10] : Current temperature (°C)
[11] : Minimum temperature (°C)
[12] : Maximum temperature (°C)
[13]..[44] : location (string, unused characters should be set to 0)
[45] : icon ID
- 0 = Sun, clear sky
- 1 = Few clouds
- 2 = Clouds
- 3 = Heavy clouds
- 4 = Clouds & rain
- 5 = Rain
- 6 = Thunderstorm
- 7 = snow
- 8 = mist, smog

Forecast