达实AIoT
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
期待您的声音
  1. 产品管理
  • 平台介绍
    • 平台概述
    • 接入方式
    • 快速入门
    • 应用场景
    • 技术架构
    • 技术优势
  • 操作指南
    • 设备安全认证
      • 概述
      • 一机一密
      • 一型一密
      • X.509认证
    • 实例
      • 实例管理
    • 产品管理
      • 创建单个产品
      • 批量创建产品
      • 删除产品
      • 方法
      • Topic管理
      • 扩展信息
      • 编解码插件
    • 物模型
      • 物模型介绍
      • 产品品类
      • 单个添加物模型
      • 批量添加物模型
      • 物模型TSL字段说明
      • 物模型支持的数据类型
    • 设备管理
      • 创建单个设备
      • 批量创建设备
      • 查看设备
      • 设备状态
      • 删除设备
      • 启停设备
      • 在线调试
      • 子设备
      • 设备影子
      • 标签
      • 文件管理
    • 规则引擎
      • 数据转发
      • SQL语句
      • 触发事件列表
        • 设备添加
        • 设备删除
        • 设备更新
        • 设备属性上报
        • 设备状态变更
        • 批量任务状态变更
        • 产品添加
        • 产品删除
        • 产品更新
        • 设备服务调用
        • 设备事件上报
        • 批量任务ota升级
        • 设备消息(按自定义topic上报消息)
    • 运维监控
      • OTA升级
      • 设备模拟器
      • 消息跟踪
    • 平台融合
      • 平台融合
    • 总览
      • 总览
    • 群组
      • 群组
    • 数据存储
      • 数据存储
    • 审计日志
      • 日志查询
      • 日志配置
  • 开发参考
    • 第三方子系统接入指南
    • 云端开发指南
      • 设备中心API参考
        • 设备属性控制(支持批量)
        • 设备服务控制(同步)
        • 设备列表查询
        • 获取设备属性列表
        • 获取设备事件列表
        • 获取设备服务列表
        • 获取属性当前数据
        • 获取设备属性历史数据
        • 获取设备的属性的实时值
        • 批量获取多个设备的属性当前数据
        • 批量获取设备位置信息
        • 分页获取设备统计信息
        • 分页查询符合条件的设备列表
        • 项目绑定设备
        • 项目解绑设备
        • 获取设备详情
        • 发送设备属性
        • 发送设备服务(同步)
        • 获取设备全部属性
        • 查询设备属性当前数据
        • 获取设备全部事件
        • 获取设备全部服务
        • 分页查询属性历史数据
      • IoT平台API参考
        • 产品管理
          • 产品分页
          • 产品详情
          • 新增产品
          • 删除产品
          • 更新产品
          • 获取物模型信息
          • 获取产品信息列表(带连接信息)
        • 设备管理
          • 修改设备
          • 批量删除设备
          • 新增设备
          • 分页查询符合条件的设备集合
          • 启停设备
          • 获取设备详情
          • 获取设备服务历史数据
          • 获取设备事件历史数据
          • 获取设备属性历史数据
          • 新增设备
          • 修改设备
          • 获取设备详情
          • 启停设备
          • 批量删除设备
          • 分页查询符合条件的设备集合
          • 查询所有属性数据
          • 分页查询属性历史数据
          • 分页查询服务历史数据
          • 分页查询事件历史数据
        • 设备命令
          • 发送服务
          • 同步发送服务
        • 设备属性
          • 查询所有属性数据
          • 在线调试-下发属性(同步)
        • 设备组管理(群组)
          • 解绑设备
          • 修改群组
          • 删除群组
          • 新增群组
          • 绑定设备
          • 列表查询
          • 分页查询符合条件的设备集合
          • 新增群组
          • 修改群组
          • 删除群组
          • 群组绑定设备
          • 群组解绑设备
        • 设备影子
          • 获取设备影子数据
          • 设置期望值
        • 设备控制
          • 下发属性
          • 下发属性(同步)
          • 发送服务
          • 发送服务(同步)
        • 云端数据上报
          • 云端上报设备属性
          • 云端上报设备事件
    • 设备接入
      • 设备接入概览
      • 设备接入手册
      • 开放协议接入
        • MQTT协议接入
        • 基于MQTT协议的设备动态注册
        • MQTT协议接入 - X.509证书认证
        • CoAP协议接入
        • CoAP协议接入 - Java代码示例
        • HTTP协议接入
      • 消息通信Topic
        • Topic定义
        • 报文定义
          • 系统基本功能 - 心跳
          • 系统基本功能 - 时间校准
          • 属性 - 属性上报
          • 属性 - 批量属性上报
          • 属性 - 属性查询全量
          • 属性 - 属性写值
          • 属性 - 属性查询
          • 事件 - 事件上报
          • 服务 - 服务下发
          • 在线状态 - 在线状态查询全量
          • 在线状态 - 子设备上线
          • 在线状态 - 子设备下线
          • 动态注册 - 子设备动态注册
          • 文件管理 - 获取文件上传URL
          • ota升级 - 升级包信息
          • ota升级 - 下载进度上报
          • ota升级 - 升级进度上报
          • ota升级 - 重新下发ota升级任务上报
          • ota升级 - 升级成功上报
          • ota升级 - 设备版本上报
          • 远程调用 - RPC通道
          • 设备信息 - 获取设备信息
          • 设备信息 - 获取子设备信息
          • 设备影子 - 获取影子数据
      • 设备接入SDK
        • .NET Link SDK
          • 物模型通信
          • 环境要求与配置
          • 认证与连接
          • 发布记录
          • 基于MQTT Topic通信
        • Java Link SDK
          • 发布记录
          • 环境要求与配置
          • 认证与连接
          • 物模型通信
        • Python Link SDK
          • 获取SDK
          • 认证与连接
          • 物模型通信
        • Go Link SDK
          • 物模型通信
          • 认证与连接
          • 获取SDK
        • Node.js Link SDK
          • 发布记录
          • 环境要求与配置
          • 认证与连接
          • 物模型通信
        • C Link SDK
          • 发布记录
          • 环境要求与配置
          • 认证与连接
          • 物模型通信
    • PulsarMQ服务端开发指南
      • 设备属性上报的订阅
      • 设备事件上报的订阅
  • 常见问题
    • IoT物联网平台相关问题
    • 应用集成相关问题
  1. 产品管理

编解码插件

        编解码插件是供物联网平台调用,可以完成二进制格式与JSON格式相互转换、也可以完成JSON格式之间的转换。
        以场景为例,部分设备应用层数据的格式由设备自行定义,不采用流行的JSON格式,而是采用二进制格式。但是,物联网平台与应用侧使用JSON格式进行通信。因此,您需要开发编码插件,供物联网平台调用,以完成二进制格式和JSON格式的转换。

使用JavaScript开发插件#

        脚本化开发是指使用JavaScript脚本实现编解码的功能。物联网平台支持JavaScript脚本编解码的功能,根据您提交的脚本文件,实现设备二进制格式与JSON格式相互转换或JSON格式之间的转换。本文以温度计、智能门锁、路灯设备为例,介绍如何开发一个支持设备属性上报和命令下发的JavaScript编解码脚本,并介绍JavaScript脚本开发编解码插件的格式转换要求和调试方法。

说明:#

JavaScript语法规则需要遵循ECMAScript 5.1规范。
产品部署JavaScript脚本插件后,该产品下所有设备的上下行数据都会进行JavaScript脚本解析。开发者实现JavaScript插件时需要注意实现设备所有的上下行场景。
上行数据JavaScript解码后的JSON数据需要符合平台的格式要求。
使用JavaScript编码时需要根据平台对应的JSON格式转换为对应的二进制码流或JSON。
部署后,JavaScript脚本文件路径为:
/oss/business/{租户ID}/iot-device/{脚本文件ID}.js

        对于在编解码代码中常用的一些函数,作为公用参数,不会在每个例子中列举这些代码,但是请注意,在实际运行这些编解码插件时,请将这些通用函数附加到脚本中。
1.
温度计设备进行温度上报(解码)
场景说明:有一类温度计设备,因为网络通信能力和数据解析能力有限,只能进行很有限的数据上报,以二进制的方式上报温度到平台
物模型中定义了名为temperature的属性,每当收到设备上报的二进制数据,并判断其为属性上报的topic时,就将其上报的二进制内容转换成代表温度的数字,并以标准数据上报格式上报到平台:
2.
智能门锁告警事件上报(解码)
场景说明:目前有一款智能门锁,能够根据当前运行状态进行事件上报,但是由于通信能力限制,其只能以二进制的格式上报简单的数字内容,其中0代表正常开门,1代表正常关门,2代表门长时间未关闭
我们希望当门锁上报的事件值为2时,向平台上报告警事件,平台定义了一种告警事件,其事件ID为door_alarm_event,具有参数ID为alarmTime的告警时间参数
编写如下代码,只有当门锁上报的值为2时,才上报告警事件,否则不做任何处理(当解析结果为空时平台会原报文转送):

3.
为路灯设备设置属性(编码)
场景说明:有一款路灯设备,支持接收设置属性命令,但是其只接收二进制格式的简单命令,不能解析JSON数据,故在数据下发时需要对其数据进行编码,下面的代码将下发数据转换.

期待您的宝贵建议

微信扫描二维码,为我们的AIoT产品提出您的宝贵建议,用户体验是我们坚持不懈的追求。

微信扫描二维码
修改于 2024-08-12 08:51:37
上一页
扩展信息
下一页
物模型介绍
Built with