文档首页/ IoT物联网/ 开发指南/ 平台侧开发/ 开发Profile/ 在线开发Profile(联通用户专用)
更新时间:2023-04-07 GMT+08:00
分享

在线开发Profile(联通用户专用)

非联通用户请查看设备接入服务

在线创建Profile前需要先创建项目定义产品。创建产品需要输入manufactureId、manufactureName、deviceType、Model等信息,Profile会使用这些信息作为设备能力字段取值。在产品创建时,如果选择使用系统模板,则系统将会自动使用相应的Profile模板,您可以直接使用或在此基础上进行修改;如果选择自定义产品模板,则需要完整定义Profile。

本节定义包含一个服务的Profile为示例,该Profile包含设备上报数据、下发命令、下发命令响应、软固件升级等场景的服务和字段。

  1. 在“产品开发”界面选择产品,选择具体产品,进入该产品的开发空间。

  2. 在产品开发空间,点击“Profile定义”,然后点击“新建服务”。

  3. 在“新建服务”区域,对服务名称、属性和命令进行定义。每个服务下,可以包含属性和命令,也可以只包含其中之一,请根据此类设备的实际情况进行配置。

    1. 填写“服务名称”,“服务名称”采用首字母大写的命名方式,比如:WaterMeter、Battery。

    2. 点击“添加属性”,在弹出窗口中配置属性的各项参数,点击“确定”。
      • 名称:首位必须为字母,建议采用驼峰形式,如batteryLevel、internalTemperature。
      • 数据类型:配置可参考如下原则:
        • int:当上报的数据为整数或布尔值时,可以配置为此类型。
        • decimal:当上报的数据为小数时,可以配置为此类型。配置“经纬度”属性时,数据类型建议使用“decimal”
        • string:当上报的数据为字符串、枚举值或布尔值时,可以配置为此类型。如果为枚举值或布尔值,值之间需要用英文逗号(“,”)分隔。
        • DateTime:当上报的数据为日期时,可以配置为此类型。
        • jsonObject:当上报的数据为json结构体时,可以配置为此类型。
      • 访问模式:设置应用服务器通过接口访问数据的模式:
        • R:通过接口可以查询该属性。
        • W:通过接口可以修改该属性值。
        • E:应用服务器订阅了数据变化通知后,设备上报了属性,应用服务器会收到推送通知。
      • 是否必选:设备上报的这个属性是不是必选。

    3. 点击“添加命令”,在弹出窗口中配置“命令名称”,点击“确定”。“命令名称”首位必须为字母,建议采用全大写形式,单词间用下划线连接的命名方式,如DISCOVERY,CHANGE_STATUS。

    4. 点击“添加下发命令字段”,在弹出窗口中配置下发命令字段的各项参数,点击“确定”。“下发命令字段名称”首位必须为字母,建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueChange;其余参数,请根据此类设备的实际情况进行配置。

    5. 如果要添加命令响应,点击“添加响应命令字段”,在弹出窗口中配置响应命令字段的各项参数,点击“确定”。“响应命令字段名称”首位必须为字母,建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueResult;其余参数,请根据此类设备的实际情况进行配置。

  4. 如果要添加软件/固件升级能力,在维护能力配置 下,开启“软件升级”/“固件升级”

    提交后,Profile中会自动多出一个“DM服务”应用于升级。

相关文档