在线开发Profile(联通用户专用)
非联通用户请查看设备接入服务。
在线创建Profile前需要先创建项目并定义产品。创建产品需要输入manufactureId、manufactureName、deviceType、Model等信息,Profile会使用这些信息作为设备能力字段取值。在产品创建时,如果选择使用系统模板,则系统将会自动使用相应的Profile模板,您可以直接使用或在此基础上进行修改;如果选择自定义产品模板,则需要完整定义Profile。
本节定义包含一个服务的Profile为示例,该Profile包含设备上报数据、下发命令、下发命令响应、软固件升级等场景的服务和字段。
- 在“产品开发”界面选择产品,选择具体产品,进入该产品的开发空间。
- 在产品开发空间,点击“Profile定义”,然后点击“新建服务”。
- 在“新建服务”区域,对服务名称、属性和命令进行定义。每个服务下,可以包含属性和命令,也可以只包含其中之一,请根据此类设备的实际情况进行配置。
- 填写“服务名称”,“服务名称”采用首字母大写的命名方式,比如:WaterMeter、Battery。
- 点击“添加属性”,在弹出窗口中配置属性的各项参数,点击“确定”。
- 名称:首位必须为字母,建议采用驼峰形式,如batteryLevel、internalTemperature。
- 数据类型:配置可参考如下原则:
- int:当上报的数据为整数或布尔值时,可以配置为此类型。
- decimal:当上报的数据为小数时,可以配置为此类型。配置“经纬度”属性时,数据类型建议使用“decimal”。
- string:当上报的数据为字符串、枚举值或布尔值时,可以配置为此类型。如果为枚举值或布尔值,值之间需要用英文逗号(“,”)分隔。
- DateTime:当上报的数据为日期时,可以配置为此类型。
- jsonObject:当上报的数据为json结构体时,可以配置为此类型。
- 访问模式:设置应用服务器通过接口访问数据的模式:
- R:通过接口可以查询该属性。
- W:通过接口可以修改该属性值。
- E:应用服务器订阅了数据变化通知后,设备上报了属性,应用服务器会收到推送通知。
- 是否必选:设备上报的这个属性是不是必选。
- 点击“添加命令”,在弹出窗口中配置“命令名称”,点击“确定”。“命令名称”首位必须为字母,建议采用全大写形式,单词间用下划线连接的命名方式,如DISCOVERY,CHANGE_STATUS。
- 点击“添加下发命令字段”,在弹出窗口中配置下发命令字段的各项参数,点击“确定”。“下发命令字段名称”首位必须为字母,建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueChange;其余参数,请根据此类设备的实际情况进行配置。
- 如果要添加命令响应,点击“添加响应命令字段”,在弹出窗口中配置响应命令字段的各项参数,点击“确定”。“响应命令字段名称”首位必须为字母,建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueResult;其余参数,请根据此类设备的实际情况进行配置。
- 如果要添加软件/固件升级能力,在“软件升级”/“固件升级”。
下,开启
提交后,Profile中会自动多出一个“DM服务”应用于升级。