【银尔达IOT物联网平台】企业用户数据点定义说明

 银尔达IOT物联网开发平台：iot.yinerda.com

更多资料访问：https://yinerda.yuque.com/yt1fh6/iot

功能支持4G设备的连接，管理；支持设备数据点定义，解析，处理，储存，统计；支持微信小程序/APP管理对接；通过电话、短信、微信、邮件等报警信息通知；支持服务与服务器对接；支持服务器边缘计算数据；支持私有化部署,log替换，特殊功能定制。

---

一、简介

数据点其实就是一个产品的功能的数据符号表示方法。比如一个远程开关，要定义继电器的状态是关闭还是打开，需要用一个符号去表示。要定义一个数字量输入高低电平，需要定义一个符号去表示。这些符号方便程序和系统认识和处理。

比如把继电器状态名字定义sw1 ,为0的时候关闭，为1的时候打开。

比如把数字量状态名字定义in1,为0的时候表示触发(异常)，为1的时候表示没触发(正常)

比如把一个温度名字定义成temp，范围-40-100，记录环境温度。

二、简单数据点

数据点包含显示名称，标识ID，数据类型，单位，最大，最小，修正系数，增量，功能用途，读写类型等属性。

属性	功能	说明
显示名称	人看的功能描述	显示先APP上面
标识ID	程序处理的描述符号	程序解析处理用的
数据类型	整数 开关量 布尔量 浮点数 字符串 枚举类型	不同数据类型的取值，范围不同，用在不同的场景
单位	数据的单位	显示在APP上面 比如温度是摄氏度 水位是米等
小数位数	浮点和双精度有效	最大6位
最小值 最大值	规定数据的有效范围	超过这个范围数据不能设置，报错
修正系数 增量	最终显示值= 设备上报原始值*修正系数+增量	一般不需要
功能用途	决定这个数据点，在APP上的显示位置	设备状态显示在APP的设备状态界面 参数设置显示在APP的设置参数界面
读写类型	只读，只能设备上报，比如输入状态 可写，设备上报和服务器设置都可以，比如继电器开关

三、系统保留数据点

系统预留的数据点，被系统占用了，用户无法再定义可以直接用。如果要重新修改客户可以自己定义自己的数据点，然后重新赋值即可。

系统保留数据点，就是系统默认已经创建了一些必要的字段，用户不需要再重新创建，可以直接使用上传。如果这些字段的功能不满足你需求，可以重新创建其他名字的字段替代。

表示ID	显示名称	类型	读写	作用
imei	IMIE	字符串	只读	设备的IMEI编码，一般是4G模块有，唯一属性 支持IMEI编码的设备才上报，建议注册包上报一次 设备详情里面显示
mac	MAC	字符串	只读	设备的MAC地址 支持MAC地址的设备才上报，建议注册包上报一次 设备详情里面显示
iccid	ICCID	字符串	只读	SIM卡ICCID，可以用来管理SIM卡，查询SIM卡流量等，基本是必要的 建议注册包上报一次 设备详情里面显示
imsi	IMSI	字符串	只读	SIM卡IMSI，可以用来管理SIM卡，查询SIM卡的归属运营商等 建议注册包上报一次 设备详情里面显示
pver	硬件版本	字符串	只读	建议注册包上报一次 设备详情里面显示
fver	固件版本	字符串	只读	建议注册包上报一次 设备详情里面显示
rssi	信号强度	整形	只读	0-100% 用来指示设备信号强度，会显示在APP顶部状态栏中。 建议随着dup命令，周期心跳上报 控制顶部菜单信号强度显示
pele	电量	整形	只读	0-100% 用来指示设备电量，会显示在APP顶部状态栏中 只有能采集的才需要上报，建议随着dup命令，周期心跳上报 控制顶部菜单电量显示

四、添加复杂数据点

基本数据点是单个名字点。复杂数据点是一个数据集合，包含多个内容。比如对象，数组，定位，定时等结构。

比如JSON对象结构"a"：{"b":1,"c":"1"} ,整个a是一个复杂结构，里面包含的b和c 是简单结构。 平台为了简化设计只支持一级复杂结构,b和c不能再是复杂结构了。

复杂数据点的一个特定是，他是一个整体，在读取和设置的时候，都需要一次性全部上报，不能被分开。

步骤是先添加复杂数据点的名字，然后在点击编辑，添加内部数据点，可以添加多个，解析和组装按格式要求处理即可。

先定义一个复杂数据点，然后按基本数据点方式添加内容。