Simple Weather Service

Introduction

The Simple Weather Service provides 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 :
• 0 : Currently supported
• 1 : Adds support for sunrise and sunset

Current Weather

The byte array must contain the following data:

• [0] : Message type = 0
• [1] : Message version = 1
• [2][3][4][5][6][7][8][9] : Timestamp (64 bits UNIX timestamp, number of seconds elapsed since 1 JAN 1970) in local time (the same timezone as the one used to set the time)
• [10, 11] : Current temperature (°C * 100)
• [12, 13] : Minimum temperature (°C * 100)
• [14, 15] : Maximum temperature (°C * 100)
• [16]..[47] : location (string, unused characters should be set to 0)
• [48] : 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
• [49, 50] : Sunrise (number of minutes elapsed since midnight)
  • 0 sun already up when day starts
  • -1 unknown
  • -2 no sunrise (e.g. polar night)
• [51, 52] : Sunset (number of minutes elapsed since midnight)
  • -1 unknown
  • -2 no sunset (e.g. polar day)

Forecast

The byte array must contain the following data:

• [0] : Message type = 1
• [1] : Message version = 0
• [2][3][4][5][6][7][8][9] : Timestamp (64 bits UNIX timestamp, number of seconds elapsed since 1 JAN 1970) in local time (the same timezone as the one used to set the time)
• [10] Number of days (Max 5, fields for unused days should be set to 0)
• [11,12] Day 0 Minimum temperature (°C * 100)
• [13,14] Day 0 Maximum temperature (°C * 100)
• [15] Day 0 Icon ID
• [16,17] Day 1 Minimum temperature (°C * 100)
• [18,19] Day 1 Maximum temperature (°C * 100)
• [20] Day 1 Icon ID
• [21,22] Day 2 Minimum temperature (°C * 100)
• [23,24] Day 2 Maximum temperature (°C * 100)
• [25] Day 2 Icon ID
• [26,27] Day 3 Minimum temperature (°C * 100)
• [28,29] Day 3 Maximum temperature (°C * 100)
• [30] Day 3 Icon ID
• [31,32] Day 4 Minimum temperature (°C * 100)
• [33,34] Day 4 Maximum temperature (°C * 100)
• [35] Day 4 Icon ID