HaaS UI基础教学十：IoT平台连接

2024-03-19 13:26:52

名词解释

AliOS Things：阿里云智能IoT团队自研的物联网操作系统

HaaS：全称是Hardware as a Service，阿里云智能IoT团队基于AliOS Things系统推出的硬件即服务

HaaS UI：全称是Hardware as a Service User Interface，是源自AliOS Things操作系统上的一套应用&图形解决方案，支持C/C++和 JS两种开发语言

1、阿里云智能物联网平台简介

阿里云智能物联网平台为设备提供安全可靠的连接通信能力，向下连接海量设备，支撑设备数据采集上云；向上提供云端API，服务端通过调用云端API将指令下发至设备端，实现远程控制。

2、HaaS UI IoT平台接口简介

阿里云智能物联网平台支持海量设备连接上云，设备与云端可以通过js形式的IoT接口进行稳定可靠的双向通信，这些接口简称jsapi_iot。

jsapi_iot提供了设备上报属性、设备上报事件、云端设置属性、云端下发服务、mqtt连接状态监听等接口，可方便开发者使用阿里云物联网平台的相关功能。

示例代码

/* iot - 阿里云IoT连接平台连接组件示例，产品功能定义：

 * [功能类型] ------ [功能名称] ------ [标志符] ------ [数据类型]

 *   属性            主灯开关        LightSwitch      bool （0-关闭 1-开启）

 *   服务            开关翻转     ToggleLightSwitch   -

 *   事件            故障上报           Error         参数标志符：ErrorCode

 * */

import * as iot from 'iot';


this.device = iot.device();


/* 网络连接事件 */

device.on('connect', function () {

    console.log('(re)connected');

});

/* 网络断开事件 */

device.on('disconnect', function () {

    console.log('disconnect ');

});

/* 云端设置属性事件 */

device.on('props', function (payload) {

    console.log('cloud req data is ', payload);

    console.log('LightSwitch ', payload.LightSwitch ? 'ON' : 'OFF');

});

/* 云端下发服务事件 */

device.on('service', function (id, payload) {

    console.log('received cloud serviceid is ' + id);

    console.log('received cloud req_data is ' + payload);

});

2.1、device(Object option)

创建 iot 实例，同时会开始尝试连接阿里云IoT平台。iot实例默认开启TLS加密。

入参

属性	类型	必填	描述
region	String	否	阿里云region，默认值：cn-shanghai。阿里云region详细说明见阿里云物联网平台 - 地域和可用区

iot
实例。

2.2、iot 实例

事件

事件：'connect'

当iot client 连接到iot平台时，触发connect事件。断开重连时也会触发该事件。

事件：'disconnect'

当连接断开时，触发'disconnect'事件。

事件：'props'

当iot云端下发属性设置时，触发props事件。

事件：'service'

当iot云端调用设备service时，触发service事件。

方法

iot.postProps(Object option)

上报属性。

iot.postEvent(Object option)

上报事件。

iot.on(String event, Function callback)

注册iot事件回调函数。

事件：'connect'

当iot client 连接到iot平台时，触发'connect'事件。断开重连时也会触发该事件。

事件：'disconnect'

当连接断开时，触发'disconnect'事件。三元组错误、三元组重复上线、服务端断开连接、主动断开连接、网络发生异常等都会触发该事件。该事件触发时，会自动尝试重连。

事件：'props'

当iot云端下发属性设置时，触发'props'事件。

回调函数参数有：

属性	类型	描述
payload	Object	服务端设置设备属性的内容

事件：'service'

当iot云端调用设备service时，触发'service'事件。

回调函数参数有：

属性	类型	描述
id	String	服务标志符，详细请参考什么是物的模型
payload	Object	服务端设置设备属性的内容

方法：iot.postProps(Object options)

上报设备属性。

入参

Object类型，其属性有：

属性	类型	必填	描述
payload	Object	是	设备定义的属性参数。详细请参考什么是物的模型
success	Function	否	上报设备属性成功的回调函数
fail	Function	否	上报设备属性失败的回调函数

方法：iot.postEvent(Object options)

上报设备的事件。

入参

Object类型，其属性有：

属性	类型	必填	描述
id	String	是	事件标志符，详细请参考什么是物的模型
params	Object	是	要上报的事件参数
success	Function	否	上报设备事件成功的回调函数，其函数参数参见下面说明
fail	Function	否	上报设备事件失败的回调函数

success回调函数参数：

属性	类型	描述
res	String	服务端reply的消息内容

方法：iot.on(String event, Function callback)

监听事件。

入参

属性	类型	必填	描述
event	String	是	注册的事件名称
callback	Function	是	监听事件的回调函数

3、设备创建与三元组获取

登录阿里云IoT官网，iot.aliyun.com，点击企业物联网平台：

进入控制台：

点击公共实例：

点击创建产品：

根据需要配置产品相关属性并点击确认：

然后添加设备：

点击前往添加：

选择产品为上一步添加的产品，DeviceName自己命名：

设备添加完成后，点击“查看”即可查看设备三元组信息：

设备三元组信息如下所示：

拿到设备三元组之后，就可以注册设备到阿里云物联网平台了：

this.iot_device = iot.device({

  productKey: "xxx",

  deviceName: "xxx",

  deviceSecret: "xxx",

  region: "" // 默认是cn-shanghai

});

4、设备上报属性示例

首先需要在产品中创建相应属性，在产品页面点击查看：

选择功能定义：

点击编辑草稿：

点击添加自定义功能：

配置属性相关信息，点击确认：

属性配置完成后，点击发布上线，至此，属性就配置完成了：

属性创建完成后，设备就可以将对应的属性上报到物联网平台了，设备属性上报示例代码如下：

// 先注册设备到阿里云物联网平台

this.iot_device = iot.device({

  productKey: "xxx",

  deviceName: "xxx",

  deviceSecret: "xxx",

  region: "" // 默认是cn-shanghai

});



// 设备属性上报

postProps() {

  this.LightSwitch = this.LightSwitch == 0 ? 1 : 0;

  this.iot_device.postProps({

    payload: {

      LightSwitch: this.LightSwitch

    },

    success: function () {

      console.log('postProps success');

    },

    fail: function () {

      console.log('postProps failed');

    }

  });     

},

下面将模拟开关灯，以示例阿里云物联网平台收到的设备属性上报数据。当灯打开时，向平台上报“开”，当灯关闭时，向平台上报“关”，物联网平台将实时显示设备上报的数据：

开发者技术支持

如需更多技术支持，可加入钉钉开发者群，或者关注微信公众号

更多技术与解决方案介绍，请访问阿里云AIoT首页https://iot.aliyun.com/

码农公寓