4.4 开发 Profile
4.4.2 在线开发 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服务”应用于升级。
----结束