天气服务

本文介绍如何使用 MCU 通用协议接入，为设备获取天气数据。天气服务是智能设备最重要的功能之一，涂鸦 MCU 标准协议接入可通过蓝牙低功耗（Bluetooth LE）模组获取到相关的天气数据。

使用场景

蓝牙模组通过手机或者网关连接到云端后，MCU 可通过发送指令获取天气数据。值得注意的是，模组不支持订阅天气变化，因此，MCU 需要定期调用命令来查询天气数据，以便获取最新的天气信息。

相关协议

获取天气数据（CMD-0xB6）

• 通过该接口可向手机请求获取指定位置及指定的天气数据。
• 天气参数详情见附录。

MCU 发送

Data 说明：

• 位置：

  • 0x01：配网位置
  • 0x02：当前位置（手机）

• 天气参数

  (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. */
  

• 预报天数：需要预报天数（n 表示需要预报的天数，1 ≤ n ≤ 7，1 表示当天），详情见附录。

模组返回

Data 说明：Status（1 字节）+ weather_values（0 字节或 Len-1 字节）。

• Status：

  • 0x00：成功

  • 0x01：参数错误

  • 0x02：请求失败

  • 0x03：请求超时

  • 0x04：重复请求

  • 0x05：状态错误

• Weather_values：天气值，仅当 Status 为 0x00 时有该字段，格式见下表。

  {某天	天气参数（小端）	数据类型	数据长度 x	数据}	……	依以上格式循环
  1 字节	4 字节	1 字节	1 字节	x 字节	……	依以上格式循环

  数据类型：

  • 0x00：整形
  • 0x01：字符串

  示例：

  • MCU > 模组：55 AA 00 B6 00 06 01 00 00 00 0F 01 CC

  • 模组 > 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

附录

天气 UTF-8 编码对照表