阿里云对接说明

崖塔工业智能物联网网关（下文简称为崖塔网关）接入以下设备
①　2个温湿度设备通过崖塔网关RS485-1串口接入，每5秒读取一次设备参数数据
②　1个灯光设备通过崖塔网关RS485-2串口接入，每2秒读取一次设备参数数据
下文将以上述网关为案例，说明崖塔网关对接阿里云物联网平台（下文简称为阿里云）的操作步骤。
1.阿里云物联网平台配置
登录阿里云，选择服务器地域，再单击选择实例（这里以免费的公共实例演示，如果需要更多的功能和更好的服务，选择购买企业版实例）。

(1)创建网关产品和设备
新增网关产品
1)在左侧导航栏，选择设备管理 > 产品，单击创建产品。

2)在新建产品页面，按下图所示配置参数后，单击确认
参数说明
①　产品名称：机房网关（根据实际情况自定义命名）
②　所属品类：自定义品类
③　节点类型：网关设备
④　连网方式：以太网（根据实际联网方式确定）
⑤　数据格式：ICA标准数据格式（Alink JSON）
⑥　其他参数：使用默认设置即可，无需修改设置

3)在左侧导航栏，选择设备管理 > 产品，查看新建网关产品，点击查看

4)在产品信息栏中，将动态注册开启

新增网关设备
1)在设备列表页签，单击添加设备，在弹出对话框中，按下图设置参数，单击确认。
参数说明
①　产品：机房网关（即选择之前创建的网关产品）
②　DeviceName：RoomGateway（自定义，不可用中文字符）
③　备注名称：机房网关设备（自定义，可用中文）

2)网关设备创建成功后，在设备列表页签，可查看新创建的网关设备，点击查看

3)在设备信息页面，点击DeviceSecret后的查看，弹出设备证书对话框，显示ProductKey、DeviceName、DeviceSecret三项信息，崖塔网关将使用这三项信息对接阿里云

(2)创建温湿度产品和设备
新增温湿度产品
1)在左侧导航栏，选择设备管理 > 产品，单击创建产品
2)在新建产品页面，按下图所示配置参数后，单击确认
参数说明
①　产品名称：机房温湿度（根据实际情况自定义命名）
②　所属品类：自定义品类
③　节点类型：网关子设备
④　接入网关协议：自定义
⑤　数据格式：ICA标准数据格式（Alink JSON）
⑥　其他参数：使用默认设置即可，无需修改

3)在左侧导航栏，选择设备管理 > 产品，查看新建网关产品，点击查看
4)在产品信息栏中，将动态注册开启，后文对接温湿度设备需要用到此产品的ProductKey

5)在功能定义栏中，点击编辑草稿设置温湿度产品功能。温湿度传感器有两个功能：采集湿度和采集温度，所以需要增加两个“温度”（用于读取温湿度传感器中的温度值）和“湿度”（用于读取温湿度传感器中的湿度值）两个自定义功能

6)在编辑草稿页面，点击添加自定义功能，新增自定义功能“湿度”
参数说明
①　功能名称：湿度（自定义）
②　标识符：Hum（自定义，不可为中文）
③　数据类型：double（湿度是允许有小数位的，这里选择使用double 或者 float）
④　取值范围：根据实际情况自定义设置，可为空
⑤　单位：相对湿度/%RH
⑥　读写类型：只读（根据传感器实际情况决定，一般的温湿度传感器仅支持读取湿度）
⑦　其他参数：使用默认设置

7)在编辑草稿页面，点击添加自定义功能，新增自定义功能“温度”
①　功能名称：温度（自定义）
②　标识符：Tem（自定义，不可为中文）
③　数据类型：double（温度是允许有小数位的，这里选择使用double 或者 float）
④　取值范围：根据实际情况自定义设置，可为空
⑤　单位：摄氏度/℃
⑥　读写类型：只读（根据传感器实际情况决定，一般的温湿度传感器仅支持读取湿度）
⑦　其他参数：使用默认设置

8)点击发布上线，保存自定义功能更改

新增温湿度设备
1)在设备列表页签，单击添加设备，在弹出对话框中，按下图设置参数，单击确认。
参数说明
①　产品：机房温湿度
②　DeviceName：RoomNorth（自定义，不可用中文字符）
③　备注名称：机房北温湿度（自定义，可用中文）

“机房北温湿度”设备创建成功后，再用同样的方法创建“机房南温湿度”：
①　产品：机房温湿度（选择温湿度产品）
②　DeviceName：RoomSouth（自定义，不可用中文字符）
③　备注名称：机房南温湿度（自定义，可用中文）
2)在设备列表页签，找到刚创建的温湿度设备，点击查看，进入设备信息页面。

3)在设备信息页面，选择物理型数据-运行状态，当崖塔网关和对应温湿度传感器设备成功接入到阿里云时，可查看自定义属性实时数据。

(3)创建灯光产品和设备
新增灯光产品
创建灯光产品与创建温湿度产品的操作基本相同，只是在设置的产品自定义功能不相同。
1)在左侧导航栏，选择设备管理 > 产品，单击创建产品
2)在新建产品页面，按下图所示配置参数后，单击确认
参数说明
①　产品名称：机房灯光（根据实际情况自定义命名）
②　所属品类：自定义品类
③　节点类型：网关子设备
④　接入网关协议：自定义
⑤　数据格式：ICA标准数据格式（Alink JSON）
⑥　其他参数：使用默认设置即可，无需修改
3)在左侧导航栏，选择设备管理 > 产品，查看新建网关产品，点击查看
4)在产品信息栏中，将动态注册开启
5)在功能定义栏中，点击编辑草稿设置灯光产品功能。灯光设备最重要的一个功能参数是“灯光开关”：通过获取“灯光开关”数值判断灯光的开关状态和通过修改“灯光开关”控制灯光的开关。
6)在编辑草稿页面，点击添加自定义功能，新增自定义功能“灯光开关”
参数说明
①　功能名称：灯光开关（自定义）
②　标识符：LightSwitch（自定义，不可为中文）
③　数据类型：bool（开关只有“0”和“1”两种状态）
④　布尔值：根据实际情况决定“0”和“1”对应的灯光开关状态
⑤　读写类型：读写
⑥　其他参数：使用默认设置

9)点击发布上线，保存自定义功能更改
新增灯光产品
创建灯光设备与创建温湿度设备的操作基本相同
1)在设备列表页签，单击添加设备，在弹出对话框中，按下图设置参数，单击确认。
参数说明
①　产品：机房灯光产品
②　DeviceName：NorthLight（自定义，不可用中文字符）
③　备注名称：机房北灯光（自定义，可用中文）
2)在设备列表页签，找到刚创建的灯光设备，点击查看，进入设备信息页面
3)在设备信息页面，选择物理型数据-运行状态，当崖塔网关和对应灯光设备成功接入到阿里云时，可查看自定义属性实时数据

2.崖塔网关配置
(1)登录崖塔网关配置系统
有两种方式打开崖塔网关配置系统登录页面：
第一种方式：如果知道崖塔网关的IP地址，局域网内使用浏览器访问该IP地址就会跳转到登录页面；
第二种方式：当不知道崖塔网关的IP地址时，在局域网内打开sgw-finder软件发现崖塔网关。sgw-finder发现网关后，点击“配置”按钮后，系统会调用默认浏览器打开崖塔网关登录页面。

崖塔网关登录页面截图：

默认登录密码为：12345678
(2)对接网关设备
在云平台页签，将崖塔网关设备对接上阿里云的网关设备RoomGateway（上文中创建的网关设备）。
崖塔网关配置系统中，打开云平台页签，配置相关参数（如下图所示），点击连接云平台。

参数说明
①　云平台选择“阿里云”
②　服务器地域与阿里云实例服务器地域一致
③　productkey，deviceName，deviceSecret则分别对应网关设备RoomGateway的productkey、deviceName、deviceSecret

当崖塔网关配置系统显示连接云平台成功后，再回到阿里云设备页签，RoomGateway设备状态会显示为“在线”，这就表示崖塔网关设备已成功对接上阿里云

(3)对接温湿度设备
在对接温湿度设备之前，需要在崖塔网关配置系统中完成以下工作：
设置接入485串口参数
前文已经交代温湿度设备接入串口是RS485-1，所以需要将RS485-1参数设置成符合温湿度设备要求。在串口管理页签，点击RS485-1操作按钮修改RS485-1参数：

创建温湿度产品
需要创建一个阿里云平台对应的温湿度产品
产品管理页签，点击新增，新增温湿度产品

参数说明
1)产品名称：同阿里云对应产品标识符一致（不能用中文字符）
2)ProductKey：阿里云对应产品的ProductKey
3)功能定义：创建的功能应该同阿里云对应产品的自定义功能一致
4)功能名称：对应阿里云产品自定义功能的标识符
5)地址：根据温湿度设备定义设置。演示温湿度设备湿度的默认地址为0，温度的默认地址为1
6)数据类型：int16
7)字节顺序：AB（低位在前，高位在后，根据温湿度设备确定）
8)读功能码：3
9)写功能码：- （温湿度设备不支持写入湿度和温度数据）
10)缩放倍数a、缩放常量b：温湿度设备采集的数据并不一定是实际的温湿度值，需要经过公式转化才能得到实际的温湿度值（假设温湿度设备采集的温度数据为X，那么实际的温度值 = aX + b）。如果常温为28.5℃，演示温湿度设备采集的数据到的温度数据为285（是真实温湿度数据的10倍），所以需要将a设置为0.1，b设置为0
11)精度：保留2位小数。实际温度值保留的小数位
12)连通性检查：用于测试接入设备和网关之间的连通性。按图示设置，网关设备会定时去采集温湿度设备Hum值，如果设备有数据返回表示网关与设备连通性良好，反之，则表示网关与设备之间的连通性有问题
创建温湿度设备
上文在阿里云平台创建了两个RoomNorth(机房北温湿度)和RoomSouth(机房南温湿度)两个温湿度设备，在崖塔网关配置系统中也需要创建两个对应的温湿度设备。下文以在崖塔网关配置系统中创建RoomNorth对应的温湿度设备举例
点击左边导航菜单中的子设备管理->添加设备，按下文要求设置各项参数，点击确定：

参数说明：
1)名称：RoomNorth（与阿里云平台对应的温湿度设备标识名一致）
2)所属产品：机房温湿度
3)通信端口：RS485-1（温湿度设备实际接入串口）
4)从设备地址：1（温湿度设备地址）
以同样的步骤再创建RoomSouth对应的温湿度设备，在子设备管理页签可以查看到刚创建的两个温湿度设备：

点击可测试设备连通性，如果连通性正常，说明设备与崖塔网关之间连接正常
点击可测试设备与阿里云平台是否对接成功，如果对接正常，在阿里云平台设备页签设备的状态显示为在线（前提条件：在云平台页签中，成功连接云平台）：

(4)对接灯光设备
对接灯光设备和对接温湿度设备的操作基本类似，需要在崖塔网关配置系统中完成以下工作：
设置接入485串口参数
前文已经交代灯光设备接入串口是RS485-2，所以需要将RS485-2参数设置成符合温湿度设备要求。在串口管理页签，点击RS485-2操作按钮修改RS485-2参数
创建灯光产品
需要创建一个阿里云平台对应的灯光产品
产品管理页签，点击新增，新增灯光产品

参数说明：
1)产品名称：同阿里云对应自定义功能标识符一致（不能用中文字符）
2)ProductKey：阿里云平台对应的灯光产品ProductKey
3)功能定义：创建的功能应该同阿里云对应产品的自定义功能一致
4)功能名称：对应阿里云产品自定义功能的标识符
5)地址：灯光设备地址
6)读功能码：1
7)写功能码：5
8)数据类型：bit（bit类型数据取值范围0-1）
9)连通性检查：用于测试接入设备和网关之间的连通性。当选择的功能具有读写功能的时候（比如LightSwitch），连通性检查-方法建议选择使用“获取（读操作）”，不推荐使用“设置（写操作）”，因为写操作会改变工作状态（比如灯光设备，会改变灯光的开关状态）
创建灯光设备
上文在阿里云创建了NorthLight（机房北灯光）设备，在崖塔网关配置系统中也需要创建对应的灯光设备
点击左边导航菜单中的子设备管理->添加设备，按下文要求设置各项参数，点击确定：

1)名称：NorthLight（与阿里云平台对应的温湿度设备标识名一致）
2)所属产品：机房灯光产品
3)通信端口：RS485-2（温湿度设备实际接入串口）
4)从设备地址：1（温湿度设备地址）
设备创建成功后，在子设备管理页签可以查看到刚创建成功的设备

点击可测试设备连通性，如果连通性正常，说明设备与崖塔网关之间连接正常
点击可测试设备与阿里云平台是否对接成功，如果对接正常，在阿里云平台设备页签设备的状态显示为在线（前提条件：在云平台页签中，成功连接云平台）：

(5)采集设备数据
崖塔网关设置采集任务
设备不会主动向崖塔网关上报数据，网关要采集设备数据，需要设置轮询/定时任务。
下文说明一下如何设置采集任务实现以下两个需求：
1)每5秒获取一次温湿度设备数据
2)每2秒获取一次灯光设备数据
在左边的导航栏里，点击任务管理->新增：

参数说明
1)操作类型：只读
2)任务名称：自定义
3)定时策略：*/5 * * * * ? （cron表达式，表示每5秒执行一次任务）
4)子设备名称：RoomNorth（采集设备）
5)功能：Hum、Tem（选择需要采集的功能数据）
上图的任务解析：崖塔网关每5秒采集一次RoomNorth温湿度设备的温度和湿度数据
点击定时策略编辑框，会弹出定时策略编辑对话框：

类型有“轮询”和“定时”两种，上图是“轮询”截图，下图是“定时”截图：

“轮询”和“定时”两种类型的主要区别是：
1)轮询：可按“时”、“分”、“秒”三个单位设置重复执行任务，比如每小时执行一次，每30分钟执行一次等
2)定时：可以“周”为单位设置重复执行任务，比如每周一、周二 10:00执行一次
重复操作，设置下图所示3个采集任务，点击启动任务后，崖塔网关就会按任务设置去采集设备数据

阿里云查看设备数据
给崖塔网关设置了采集任务之后，在阿里云平台上就可以查看到崖塔网关上传的设备数据。
在设备信息页面，选择物理型数据-运行状态，将实时刷新开启：