Jean-François Milants 3a8c7dc038 Simple Weather Service - code cleaning and improvements

Add missing icons (heavy clouds, thunderstorm, snow).
Remove unneeded comparison operator (!=), improve conversion of Timestamp and MessageType, order includes.
Fix typo in documentation.
Remove not related change in StopWatch.

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