Weather Service

This topic describes how to use the MCU SDK to get the weather data for your product. The weather service is an important feature for smart devices, allowing the MCU to request weather data through the Bluetooth LE module.

Scenario

After the Bluetooth module is connected to the cloud through a mobile phone or gateway, the MCU can send commands to get weather data. The module does not support subscribing to weather changes. Therefore, the MCU needs to invoke commands regularly to get the latest weather information.

Related protocols

Get weather data (0xB6)

• The MCU can use this command to request the specified weather data in a specific location from the mobile app.
• For more information, see the Appendix.

The MCU sends the following data.

Data description:

• Location:

  • 0x01: The location where the device is paired.
  • 0x02: The location where the mobile phone is.

• Weather parameter

  (1 << 0), /**< temperature. */
  (1 << 1), /**< high temperature. */
  (1 << 2), /**< low temperature. */
  (1 << 3), /**< humidity. */
  (1 << 4), /**< weather condition. */
  (1 << 5), /**< pressure. */
  (1 << 6), /**< sensible temperature. */
  (1 << 7), /**< uvi. */
  (1 << 8), /**< sunrise. */
  (1 << 9), /**< sunset. */
  (1 << 10), /**< unix time, used with sunrise and sunset. */
  (1 << 11), /**< local time, used with sunrise and sunset. */
  (1 << 12), /**< wind speed. */
  (1 << 13), /**< wind direction. */
  (1 << 14), /**< wind speed scale/level. */
  (1 << 15), /**< aqi. */
  (1 << 16), /**< tips. */
  (1 << 17), /**< detailed AQI status and national ranking. */
  (1 << 18), /**< pm10. */
  (1 << 19), /**< pm2.5. */
  (1 << 20), /**< o3. */
  (1 << 21), /**< no2. */
  (1 << 22), /**< co. */
  (1 << 23), /**< so2. */
  (1 << 24), /**< weather condition mapping id. */
  

• Number of forecast days: Specifies the number of days for which the server returns forecast data. The valid value ranges from 1 to 7, and 1 indicates today. For more information, see the Appendix.

The module returns the following data.

Data description: status (1 byte) + weather_values (0 bytes or Len-1 bytes).

• Status:

  • 0x00: Success

  • 0x01: Parameter error

  • 0x02: Request failed

  • 0x03: Request timeout

  • 0x04: Repeated request

  • 0x05: Status error

• Weather_values: The value of weather, which is valid when status is 0x00. For more information about the data format, see the following table.

  {Day	Weather parameter (little-endian)	Data type	Data length x	Data}	…	Recurring in the specified format
  1 byte	4 bytes	1 byte	1 byte	x bytes	…	Recurring in the specified format

  Data type: 0x00: Integer, 0x01: String

  Example:

  • MCU to module: 55 AA 00 B6 00 06 01 00 00 00 0F 01 CC

  • Module to MCU: 55 AA 00 B6 00 2D 00 01 01 00 00 00 00 04 00 00 00 21 01 02 00 00 00 00 04 00 00 00 24 01 04 00 00 00 00 04 00 00 00 1C 01 08 00 00 00 00 04 00 00 00 44 AA

Appendix

Weather data in UTF-8 encoding