电信运营商设备接入
本文展示电信运营商设备接入平台的实践示例。
第一步: 电信NB平台地址
第二步:电信开发者平台 - 创建应用/项目(已创建忽略)
【步骤】：电信开发者平台首页 - 【我的项目】 - "+"号图标 - 新建项目
【注意】：
妥善保存应用密钥,后续IoT OS上配置产品时需要该配置项。
第三步:电信开发者平台 - 创建产品(已创建忽略)
【步骤】：选择新建的项目 - 【产品】 - 【产品开发】 - 【添加】 - 【自定义产品】
第四步:电信开发者平台 - 编写profile(已创建忽略)
【步骤】：选择新建的产品 - 【Profile定义】 - 【新建服务】
profile:用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息。
关于profile详情可参考官方定义profile介绍。
第五步:电信开发者平台 - 编写编解码插件(已创建忽略)
【步骤】：选择新建的产品 - 【编解码插件开发】 - 【在线编解码插件编辑器】 - 【新增消息】
【注意】：
在线编写后，需要保持部署方可生效。
第六步:IoT OS平台 - 创建产品
节点类型
| 参数 | 值 |
|---|---|
| 节点类型 | 设备 |
| 是否接入网关 | 否 |
联网与数据
| 参数 | 值 |
|---|---|
| 联网方式 | NB-IoT |
| 交互协议 | 运营商转发 |
| 数据格式 | KLink |
| 功能参数校验模式 | 严格模式 |
| 设备登录安全校验 | 关闭 |
选择"NB-iot"-"运营商转发"，根据实际需求选择"KLink"或者"自定义"。
第七步:IoT OS平台 - 创建协议
【注意】：
如果是"KLink"，则参数和命令必须和profile一一对应；
注意下发命令，格式为profile中 serviceId_method(服务名_方法名) 示例:up_down。
第八步:IoT OS平台 - 编写运营商信息
第九步:电信开发者平台 - 填写订阅地址
【步骤】：【应用】 - 【订阅调试】
【注意】：
格式: http://{运营商推送数据接收地址}/api/v1/telecom/{推送类型}/{pk}
其中推送类型为:
添加新设备 - deviceAdded
设备信息变化 - deviceInfoChanged
设备数据变化 - deviceDataChanged
第十步:IoT OS平台 - 新增设备
【注意】：
由于运营商平台id唯一性要求，暂时不支持批量导入和自动生成。
此时在电信平台可以看到刚刚新增的设备。
第十一步:模拟器 - 模拟设备上报数据
第十二步:IoT OS平台 - 使用在线调试模拟下发命令
【注意】：
下发命令后,设备必须上报消息后才能收到电信平台的下发命令。