乐趣区

干货-设备快速上云轻松搞定设备与云端通信

本文主要讲解如何使用京东云物联网引擎产品,快速创建产品及设备,并通过 SDK 将设备安全地连接至云端,实现设备的数据上报与订阅,让刚接触该产品的用户能够对京东云物联网平台有个初步的认识。

目前京东云 IoT Device SDK 提供了 C 语言开发包,访问链接进行下载:

jdcloud-iot-device-sdk-c.zip (https://docs.jdcloud.com/cn/i…

京东云 IoT Device SDK,是提供给设备厂商,用于集成在设备之上,并通过 SDK 安全的将设备连接至京东云物联网引擎进行管理。设备必须要支持 TCP/IP 协议才能使用 Device SDK,其他非 IP 设备或非标准 MQTT 协议的设备,需要通过网关,边缘节点以及物联网协议适配才能接入物联网引擎。目前 SDK 面向 MQTT C 语言开发者,支持 Linux 系统环境。

SDK 架构

应用业务逻辑、SDK、HAL 的关系如下图所示:

应用只需关心使用 SDK API 组合业务逻辑,无需关心通信细节,HAL 层需要用户根据自身的 OS 和设备信息进行适配,SDK 提供了 Linux 的 HAL 层适配。

快速上手,设备接入操作步骤

登入物联网引擎控制台(https://iot-console.jdcloud.c…),用户进行开通服务后,即可进入快速接入设备页面。
(您也可在左侧菜单栏点击【快速接入设备】菜单,进入快速接入设备页面)

1、新建产品和设备

创建产品与设备是使用物联网引擎的第一步,填入产品名称和设备名称,默认系统会自动为产品添加 switch 和 message 这两条属性。产品创建成功后,您也可以通过产品详情中,修改编辑产品物模型定义。

2、记录设备的配置信息及接入域名,并下载 SDK 开发包以及配置文件。

请注意:务必要下载并保存好您的设备配置文件,用于后面做设备的连接鉴权使用。

3、根据页面提示,在开发机上运行 SDK 开发包中的 Demo 程序,之后查看设备连接情况。

4、完成快速接入设备。

设备鉴权

京东云设备鉴权分 一机一密 和 一型一密,SDK 中这两种模式是通过 iot_config.h 中的 DYNAMIC_REGISTER 宏来控制。

创建产品后默认是一机一密鉴权,开启产品的设备动态注册功能后,即会切换为一型一密鉴权。

一机一密

开发者需要将服务端生成的 product key、identifier 和 device secret 烧录至设备存储系统,并实现以下 HAL APIs,从而允许 SDK 从存储系统里获取这些信息。

SDK 包含了这些 HAL APIs 的简单实现文件(hal_os_linux.c),其中 _product_key、_identifier、_device_secret 示范了对这些信息的存储。

一型一密

云端根据 product key、product secret 动态生成 identifier、device secret。

启用 DYNAMIC_REGISTER 宏后

iot_mqtt_construct(iot_mqtt_param_t *pInitParams) 会自动去做一型一密认证,用户需要额外实现几个 HAL 层函数。

具体实现可以参考 platform/linux/hal_os_linux.c 的实现。

建立设备与云端的连接

Host 配置

在 SDK 文件 src/utils/iot_config.h 中,通过 INDEPENDENT_MODE 来控制 SDK 是否访问物联网引擎,物联网引擎产品在用户 VPC 内创建用户私有实例,所有资源为该用户独立使用,享有独立的接入入口。对物联网引擎开发者需要将 platform/linux/hal_os_linux.c 中_device_host 的地址替换为物联网引擎的公网域名地址。

初始化数据

开发者从控制台获取到设备三元组后,将信息写入存储系统或 HAL 文件后,即可从设备 app 调用 iot_mqtt_construct()来建立连接。

创建 MQTT 连接实例

接口:void iot_mqtt_construct(iot_mqtt_param_t pInitParams)接口说明:创建 MQTT 实例,初始化数据,建立 MQTT 连接返回值:成功返回 MQTT 实例,否则返回 NULL

参数说明

示例代码

iot_mqtt_param_t mqtt_params;pclient = iot_mqtt_construct(&mqtt_params);

销毁 MQTT 连接和实例

接口:Int iot_mqtt_destroy (iot_mqtt_param_t *pInitParams)
接口说明:销毁 Mqtt 实例,释放数据和连接
返回值:成功返回 SUCCESS_RETURN,否则返回其

示例代码

iot_mqtt_destroy (pInitParams);

以上,快速通过 SDK 进行设备接入及通信连接就算完成了。更多信息可以访问京东云官网文档(https://docs.jdcloud.com/cn/i…)。

目前物联网引擎产品 2 折促销中,欢迎使用。

退出移动版