数据解析

更新时间:2024-06-20 04:37:44下载pdf

本文档介绍如何为生态设备接入(Tuyalink)方式创建的产品进行设备数据解析。

概念说明

数据解析

在硬件设备中,存在一些硬件配置低或自身无法构建的 JSON 格式数据与涂鸦开发者平台进行通讯的设备。针对这类设备,您可以将原始数据透传至平台,并通过提交脚本文件至平台提供的脚本运行环境中,实现自定义格式和 JSON 格式之间的转换。

数据协议

在创建产品时,需要选择数据协议,其中包含涂鸦标准协议和自定义透传协议:

  • 涂鸦标准协议
    涂鸦开发者平台定义的标准数据格式为 Tylink JSON,这是平台与设备间通讯的数据格式。选择涂鸦标准协议则代表该产品设备上下行内容为涂鸦标准 JSON 格式,可自行解析。

  • 自定义透传
    设备无法自行构建 JSON 格式或不便于构建,可将原始数据透传至云端,由云端解析脚本处理,完成涂鸦标准 JSON 转换。

目前,平台支持设备模型 Topic 数据的上下行解析:即将设备上报给云端的自定义格式设备模型数据解析为 Tylink JSON 格式,和将云端下发的 Tylink JSON 格式数据解析为设备自定义的格式。

数据解析

设备端开发

请参考 自定义透传协议

操作步骤

第一步:创建产品

  1. 登录 涂鸦开发者平台

  2. 在平台首页,单击 创建产品

    数据解析

  3. 选择您想创建的产品,选择 生态设备接入 智能化方式。

    数据解析

  4. 完善产品信息。选择 数据协议自定义透传

    数据解析
    关于创建产品,详情可查看 创建产品

第二步:进行数据解析

  1. 产品开发 页面,选择您想要进行数据解析的产品,单击 继续开发

  2. 在顶部页签中,单击 数据解析

  3. 单击 立即创建,进入调试脚本界面。
    数据解析
    数据解析

    脚本调试编辑器提供两个功能函数:

    • 上行转换函数:rawDataToTyLink
    • 下行转换函数:tyLinkToRawData

您可以根据设备端透传上报数据信息,结合实际需求进行编写 .js 脚本,从而实现上下线数据的标准化转化。

第三步:模拟数据输入

脚本开发完毕后,可借助模拟数据输入方式,进行脚本调试。

  1. 在脚本调试界面,在 模拟数据输入框中,可以选择 设备上报数据云端下发数据,分别模拟正常设备运行时,设备上报数据和云端下发数据。
  2. 单击 执行,可在右栏中的 执行结果 查看解析结果。
  3. 若未确认可单击 保存,保存解析结果。
    数据解析

第四步: 发布为正式版本

确认完成后,可单击 发布为正式版本,发布为正式版本的的脚本将运行在云端平台。
真实设备数据上下行中设备模型 Topic 会优先流转至数据解析脚本后,进行数据分发。此时,透传型产品便完成了数据解析接入。

数据解析

后续操作

完成数据解析脚本的编写和正式发布后,可配合 在线调试 进行功能验证。