收藏官网首页
查看: 2683|回复: 0

3-数据点定义

560

主题

1219

帖子

7690

积分

版主

Rank: 7Rank: 7Rank: 7

积分
7690
发表于 2016-8-9 16:49:20 | 显示全部楼层 |阅读模式
教您5分钟接入机智云,实现傻瓜式开发
智云云端,APP对设备上报的数据进行分析、处理,或设备对机智云云端,APP下发数据进行分析、处理,前提是双方明确数据的含义。机智云后台提供了数据点的定义界面,通过数据点定义,设备与云端、APP端数据通信的含义将得到明确。数据点定义的好处:
  • 明确设备与云端、APP端数据通信的含义。
  • 云端根据数据点定义,解析设备数据,用户可使用“设备运行状态”,“统计分析”等功能。
  • 机智云具有大数据统计接口,通过接口,可快速分析设备数据。
  • 方便APP开发者开发,APP SDK可解析下发/上报等设备数据。
  • 方便MCU开发,机智云根据数据点定义,生成MCU与GAgent通信详细串口通讯协议。

数据点定义之数据点定义步骤:
1. 进入硬件接入,选择相应“设备”。如下图:
2. 选择“数据点”,“新增数据点”
3. 填写数据点“标识名”,“读写类型”,“数据类型”,及“备注”。
4. 对已存在“数据点”可进行重新编辑、删除。
5. 数据点定义完成后,点击应用。同时可以选择将该产品数据点定义保存为模板,创建新产品时候,可直接引用该产品数据点。
数据点定义之数据点详解:
数据点定义基本内容可分为显示名称,标识名,读写类型,数据类型及备注。概图如下:
1. 显示名称:请用最清晰的方式描述一个数据点的名称,默认为等于“标识名”,点击编辑可修改“显示名称”。支持所有中英文及符号字符类型(为了正常显示请避免使用特殊字符)。不在硬件端存储传输,用于虚拟设备及IoE Demo App开发调试时的识别。
2. 标识名:用于应用层传输,客户端或业务云开发时需要使用,不在硬件端存储和传输。命名规则遵循标准的开发语言变量名命名规范,支持英文字母、数字和下划线,以英文字母开头。
3. 读写类型:
① 只读:表示该数据点非控制,数据类型可为布尔值/枚举/数值/扩展等。云端/客户端无法对该数据点数据做出下发控制,只能设备端上报该数据点数据。例如“微信宠物屋”,“红外传感器故障”该数据点。
② 可写:表示该数据点可控制,数据类型可为布尔值/枚举/数值/扩展等。设备端可上报该数据点数据;云端/客户端可对该数据点数据做出下发控制。例如“微信宠物屋”,“开启/关闭红色灯”该数据点。
③ 报警:表示该数据点非控制,数据类型需为布尔值。云端/客户端无法对该数据点数据做出下发控制,只能设备端上报该数据点数据。例如“微信宠物屋”,“报警1”该数据点。
④ 故障:表示该数据点非控制,数据类型需为布尔值。云端会对设备上报的该数据点做统计,可在“运行状态”查看。云端/客户端无法对该数据点数据做出下发控制,只能设备端上报该数据点数据。例如“微信宠物屋”,”报警1”该数据点。
4. 数据类型:
① 布尔值:表示两个状态:0,或1。如开关状态等,建议使用布尔数据类型。例如“微信宠物屋”,“开启/关闭红色灯”该数据点。
② 枚举类型:可定义一个有限的取值集合,每2个值占用1bit。当定义的某个功能(元器件)有固定的若干个值。例如“微信宠物屋”,“设定LED组合颜色”该数据点。
③ 数值:填写数值范围,数值可为负数/小数,机智云自动将数值转换为正数。例如“微信宠物屋”,“设定电机转速”该数据点。
④ 扩展:填写数据长度,数据内容由用户自定义。机智云不建议使用此类型数据,因为此类型数据机智云无法识别,也就无法使用机智云其他的各种基于数据分析的服务和增值服务。
5. 备注:选填,用一段文本描述当前数据点的功能及定义方法,对字符格式不做限制。只用于提高数据点的易读性,如果需要团队协作开发,建议规范填写。
数据点定义之编辑数据点:
    针对不同类型数据格式,需要填写的参数均有所不同,以下分别对不同数据类型提供编辑方法:
1. 布尔型数据类型添加/编辑方法:
    布尔型是最简单的格式类型,没有参数,只有两个值:true (1) 、false (0)。如图
2. 枚举型数据类型添加/编辑方法:
    “数据类型”选择[枚举]类型后,在“枚举范围”文本框中直接输入枚举值,每一个值使用英文逗号“,”隔开。点击保存提交后,程序将自动为每一个枚举值添加一个序号,客户端或硬件端开发直接使用枚举序号。如图
3. 数值型数据类型添加/编辑方法:
   “数据类型”选择[数值]类型后,出现数据范围和分辨率文本框,数据范围输入最小值和最大值,分辨率可理解为调节的精度或元器件本身支持的最高精度。数据点编辑如下图。数值类型数据点分辨率的换算方法,可见下文“数据点定义之数值型数据类型换算实现原理”。
4. 扩展型数据类型添加/编辑方法:
    “数据类型”选择[扩展]类型后,出现“数据长度”必填文本框,开发者可输入小于等于2047(单位Byte)的正整数。本质上就是约定了一条指令为此数据点保留的空间长度。
数据点定义之数值型数据类型换算实现原理:
    如以上提到,在定义数值型数据点的时候,取值范围可以使用包括小数、负数等非uint类型数值,熟悉嵌入式开发的开发者会知道,这些数值在设备端都是不被支持的。
机智云为了让设备功能定义更加简单直接、所见即所得,研究出来一套算法,用于将用户输入的数值转换成设备能够识别的uint类型,这套算法的核心公式是:y=kx+m。
    y表示“显示值”,就是用户可见的最终数值,也是数据点定义时输入的值。包括 Ymin(最小值) 和 Ymax(最大值)。
    x表示“传输值”,就是实际指令间传输使用的数值,云端/客户端接收到的值。一定是uint格式。也包括 Xmin 和 Xmax。
    k表示“分辨率”,就是用户输入的分辨率一值,确定了每个取值的步进。
    m表示“取值偏移量”或“增量”,算法通过m值将y值偏移到满足x值uint格式的要求,m值默认等于Ymin,确保Xmin=0 。
    以下用一个电子温度计举例说明换算过程 数据点内容: 取值范围:-30(Ymin) ~ 50(Ymax),分辨率:0.1
根据公式:y=kx+m,m默认等于Ymin -30
Xmin = (-30+30) / 0.1 = 0
Xmax = (50+30) / 0.1 = 800

1、机智云QQ群: 287087942
机智云爱好者-APP开发群: 599735135
QQ群目前非常活跃,欢迎大家参与进来,交流,讨论,答疑,解惑~~
2、机智云微信公众号: 机智云 gizwits /   机智云智能宠物屋go-kit
关注机智云Gizwits官方公众号随时掌握最新资讯和活动信息
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

© 2006-2022 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表