Hello World

更新时间：2018-10-30 11:32:18

简介

万丈高楼平地起，物联网丰富的应用场景离不开数据通信。本文介绍一个最简示例，用于演示搭载 AliOS Things 的设备与 Link Develop(以下简称LD) 的集成。此处我们姑且称之为 “物联网的 Hello World”。
本示例源码: simple_mqtt

simple_mqtt
├── README.md
├── simple_mqtt.c
├── simple_mqtt.mk
└── ucube.py

功能介绍

设备端 AliOS Things 启动后初始化与 LD 云端的 MQTT 连接，然后在串口 cli 中提供一个 pub 命令，用来向云端固定 topic 发布消息，消息格式遵循 Alink 协议规范。同时会订阅接收云端下发到固定 topic 的消息。
简而言之，本示例通过 MQTT 完成了最基本的设备端和云端双向通信。

环境要求

设备端环境

任意具有接入互联网能力，且已完成移植 AliOS Things 移植的设备，如：ST开发板, NXP开发板, TI开发板
亦可请参考其他已支持的硬件。

云端环境

• 在 Link Develop 注册账号(与阿里云账号通用)。

• 在 LD 产品创建好以后，在设备模型的自定义功能处，新增两个属性, 一个用于上行消息, 另一个用于下行消息, 均设为字符串类型。如图：

因此，消息内容的结构如下所示：

```
"params": {
    "down": "downstream payload",
    "up": "upstream payload"
}
```

• 设备模型创建完成后，新增一个测试设备，记下如下所示的三元组信息。 该组信息会用于烧写到实际设备中，而这个测试设备，则会是实际设备在云端的一个影子。
  • PRODUCT_KEY
  • DEVICE_NAME
  • DEVICE_SECRET

设备端编译构建

前置开发环境搭建请移步开发准备。

在 example/simple_mqtt.c 中, 将以下几个字段更新为上述生成的对应信息，如：

#define PRODUCT_KEY             "b1VxeCKSQeO"
#define DEVICE_NAME             "simple"
#define DEVICE_SECRET           "x9D0k0DjwtYG734unBm0YYsyoMRxgCNR"

然后在 AliOS Things 代码环境中编译出目标.bin文件，如：

aos make simple_mqtt@developerkit

烧录到板子中：

aos upload simple_mqtt@developerkit

注意: 此处烧录方式根据不同硬件会有所不同，此处以 Developer kit 为例

运行

启动并连网

烧录完成以后重新上电板子，在串口中 cli 中使用 netmgr 命令进行连网：

# netmgr connect ssid password

其中 ssid 和 password 是WiFi路由器的名字和密码。
看到如下信息以后即说明连网完成，并已经和 LD 云端建立好 MQTT 连接。

[inf] _TLSConnectNetwork(357):   . Setting up the SSL/TLS structure...
[inf] _TLSConnectNetwork(367):  ok
[inf] _TLSConnectNetwork(402): Performing the SSL/TLS handshake...
[inf] _TLSConnectNetwork(410):  ok
[inf] _TLSConnectNetwork(414):   . Verifying peer X.509 certificate..
[inf] _real_confirm(93): certificate verification result: 0x00
[005598]<V> mqtt service
[005652]<V> subscribe success, packet-id=1
#

发送上行消息

在串口 cli 用 pub 命令发送上行消息：

# pub [payload]

其中 payload 是消息内容，可以任意输入你喜欢的字符，回车即发射。
此时在 LD 的设备调试日志中，可以看到上行的消息，比如此处发送了 helloworld-from-my-device。

# pub helloworld-from-my-device
[499130]<V> id: 5, publish msg: {"id":"5","version":"1.0","method":"thing.event.property.post","params":{"up":"helloworld-from-my-device"}}

接收下行消息

如果我们按上图所示，在LD控制台的调试功能处选择下行消息，方法选设置，点击右侧发送指令按钮，即可在设备的串口日志中，看到如下信息：

# [509540]<V> ----
[509540]<V> Topic: '/sys/b1VxeCKSQeO/simple/thing/service/property/set' (Length: 50)
[509550]<V> Payload: '{"method":"thing.service.property.set","id":"64002324","params":{"down":"hi from link develop to device"},"version":"1.0.0"}' (Length: 124)
[509570]<V> ----

结语

至此，已经完成了物联网的基础：设备端和云端的双向通信。
一切尽在掌控，可以开始进一步的探索了，请参考更多示例。