【资料】产品接入与云端管理

boboP · 发表于 2016-8-9 10:14:48

1-注册机智云账号

在使用机智服务前，你需要注册一个开发者账号。如何注册账号成为机智云开发者，具体步骤如下：

步骤一：进入官网

点击http://www.gizwits.com/访问官网。在导航栏中，显示【开发者中心】按钮，如图1-1。

图1-1

步骤二：进入开发者中心

点击【开发者中心】按钮，可跳转到开发者中心首页（跳转链接为http://site.gizwits.com/zh-cn/developer/）。在开发者中心首页导航栏中，显示【注册】按钮，如图1-2。

图1-2

步骤三：进入注册页面

点击【注册】按钮，即跳转到注册页面，如图1-3。在注册页面中，分“企业用户注册”和“个人用户注册”两种注册方式，可根据自身情况而进行选择注册。

步骤四：以“企业用户注册”为例:

1）行业分类

根据自身企业情况进行选择；行业类型大致分为：互联网公司、家电、智能家居、灯光照明、安防监控、医疗/健康/运动、可穿戴设备、智能玩具、汽车与周边、工业领域、通讯网络设备商、IC原厂、模组/方案商、主控板卡厂、创客空间及行业协会等；如没有以上的行业，可以选择“其他”作为行业类型，如图1-3。

图1-3

2）企业名称

根据自己的企业进行命名，例如：TEST1（企业名称）；成功注册后，登录账号，可以看到有“个人项目”和“企业项目”（项目的名称即是注册时企业命名的名称），如图1-4。

图1-4

3）登录邮箱及密码

填入自己的邮箱，例如QQ邮箱12****8@qq.com（满足格式的邮箱都可申请注册）；密码（弱密码保护提示）：密码不能是123456、111111、123abc等容易猜测的密码，如图1-5；所以设置密码及确认密码时，尽量提高密码复杂程度，以提高安全性。

图1-5

4）企业信息

企业联系人（变量包含不超过 30 字符）、联系电话（符合电话格式要求即可）、职务（变量包含不超过 32 字符）、需求情况描述（填写好需求之后，会有相应的工作人员去跟进请求）、地区选取栏（企业所在地）。

5）机智云了解路径

可以根据自己的情况进行选择，大致分为：从新闻媒体了解、朋友同事推荐、行业协会、模块商\芯片商介绍、线下活动、微信\QQ等线上推广、搜索引擎及技术论坛等，如非通过以上方式了解机智云的，可以选择“其他”，如图1-6。

图1-6

6）《机智云平台服务条款》：介绍机智云平台服务条款的详细情况。

7）注册成功

填入相应的注册信息，点击【注册】按钮，跳转页面如图（有相应的提示内容），如图1-7。

图1-7

8）激活账号

注册成功后会收到一封激活邮件，如图1-8；如“收件箱”无邮件，可以点击“垃圾箱”查看邮件是否有收到，如无，可以点击在注册成功跳转页面中的“再次发送激活邮件”可以给邮箱再次发送激活邮件。点击【激活账户】按钮，恭喜你已经成为机智云开发者。

图1-8

9）成功登录企业账号：输入邮箱账号及密码，点击【登录】按钮，成功登录，再次进入开发者中心首页，可以看到有“个人项目”和“企业项目”（项目的名称即是注册时企业命名的名称），如图1-9。

图1-9

步骤五：以“个人账号注册”为例，如图1-10:

1）登录邮箱、密码、联系电话、机智云了解路径及《机智云平台服务条款》注册的条件及详细同“企业账号注册”的方式一样，如图1-10。

图1-10

2）注册成功跳转页面、邮箱邮件、激活账号、激活成功跳转登录页面，同“企业账号注册”的方式一样。

3）成功登录个人账号，如图1-11，可以看到这里个人账号注册是无企业项目的，只有一个个人项目。

boboP · 发表于 2016-8-9 10:16:40

2-产品定义
一、产品接入前提

在使用机智云服务之前，你首先需要在机智云开发者中心注册一个开发者账号并登录。注册详细操作说明请参考注册机智云账号。

二、创建新产品

步骤一：点击机智云官网导航栏的“硬件接入”进入”设备列表“页面（http://site.gizwits.com/zh-cn/developer/product），点击页面设备列表栏的【+ 创建新产品】按键，弹出添加产品弹框，如图：

步骤二：按照添加产品弹框内的提示填写或选择产品基本信息，点击【添加】，进入“新设备接入向导—编辑数据点”页面

三、通过新设备接入向导完成设备配置编辑产品数据点

方法一：通过方案模板创建生成产品数据点

前提：用户所拥有的方案模板不为空

步骤1: 从“新设备接入向导—编辑数据点”页面显示的模板列表中选择与新产品类似的方案模板，点击方案模板上的【查看】可以查看方案模板的详细数据点列表，点击数据点列表弹框下的【关闭】，可以关闭数据点列表弹框，如图：

步骤2：点击方案模板中【应用此模板】按键，弹出提示框，点击提示框上的【添加】即可将模板数据点应用到新的产品，如图：

步骤3：通过方案模板创建生成数据点成功，自动跳转到手动编辑数据点页面，可以对生成的数据点进行编辑、添加或删除。

数据点添加，编辑和删除具体操作详情请见数据点定义

方法二：手动编辑产品数据点

如果当前用户没有模板或者没有合适的模板，或用户不想使用模板创建产品数据点时，此时用户可以根据新产品的功能手动逐个进行数据点的添加。

步骤1：点击“新设备接入向导—编辑数据点”页面的手动编辑数据点选项，进入手动编辑数据点页面。

步骤2：点击手动编辑数据点页面的【+新建数据点】按钮，弹出添加数据点弹框。根据提示填写数据点信息并保存，系统将为你的产品创建第一个数据点，你可以继续对数据点进行微调。

步骤3：重复步骤2的添加操作，直到产品功能需要的数据点全部添加完成。对生成的产品数据点你可以继续执行编辑，删除以及添加操作。

MCU编程

数据点编辑完成后，点击【下一步】，页面自动跳转到“新设备接入向导—MCU编程”页面，页面显示如下：

根据上一步添加的产品数据点，页面自动生成了《XX-机智云接入串口通信协议文档》和《XX-机智云接入JSON文档》（其中XX代表产品名称），点击文档名即可进行下载，硬件开发人员只需按照文档指示即可轻松完成硬件开发。

设备调试

点击“新设备接入向导—MCU编程”页面的【下一步】，进入“新设备接入向导—设备调试”页面，页面包含产品开发资源和轻应用开发资源两项。

产品开发资源项：

产品开发资源提供android和iOS SDK,集成文档以及Demo APP的下载。

当完成了产品数据点编辑后且产品的硬件设备已开发完成，可下载对应的SDK集成到已完成界面设计的移动应用，即可实现设备的控制。同时也可以直接下载并安装Demo App，登录后即可对连接并查看、控制设备。如果设备未完成开发，可以使用机智云提供的虚拟设备进行功能的调试。

虚拟设备调试详细说明请戳调试工具

轻应用开发项：

轻应用开发项提供API文档的查看链接，点击即可跳转到API文档说明页面。

使用机智云提供的Open APIs（Http / WebSocket），可以快速开发网页或微信应用等基于html的轻应用，用于管理和控制智能设备。

完成并退出向导

至此，你已完成了一款智能硬件产品的接入，接下来你将进入此设备页面，你可以直接申请发布，也可以继续编辑、查看,删除或调试设备。

四、通过方案模板创建产品

机智云为广大开发者提供了一系列方案模版，当选择相同产品时可选择直接套用模版，更高效的定义产品。

步骤1：点击机智云导航栏的“硬件接入”进入设备列表页面，点击页面右侧导航栏的“方案模板”选项进入方案模板页面：http://site.gizwits.com/zh-cn/developer/product

步骤2：在方案模板页面显示的模板列表中选择自己需要用到的模板，点击【应用此模板】，弹出使用方案模板创建新设备弹框，如图：

五、产品管理

设备正式上线之前，都可以对设备信息进行修改。只有拥有产品的管理员或开发者权限，才能对产品进行编辑。设备识别码是你的新设备在机智云中的唯一标识，由系统自动生成，无法更改。

产品信息查看和编辑

步骤1:进入产品管理页面,页面默认显示产品信息，如图：

步骤2：点击产品详细信息栏后的编辑图标，进入产品信息编辑页面，如图：

步骤3：修改产品信息，点击【保存】，修改成功，页面自动跳转到产品详情信息页面，产品详情变更为修改后的产品信息

产品删除

为方便广大开发者的产品管理，可以把暂时不需要用到的产品移至回收站。无论是产品被删除至回收站，还是存在于设备列表中，产品本身数据点及名称、应用属性等数据均不会改变，依旧可以正常使用。

进入产品信息编辑页面，点击页面的【删除】，弹出删除确认提示框，点击提示框内【确定】，即可將产品移至回收站，如图：

同时，为保证产品在使用上不受影响，删除的产品也可以在回收站中进行还原操作。

数据点

已进入产品管理页面，点击产品管理页面的”数据点“选项，进入产品数据点页面，如图：

可继续对产品数据点执行添加，编辑，删除动作，也可以将此设备的数据点方案另存为模板，在开发同类型设备时可重复使用。数据点具体操作请戳数据点定义。

虚拟设备

点击产品管理页面的”虚拟设备“选项，进入虚拟设备页面。点击页面【启动虚拟设备】，即可登录虚拟设备

虚拟设备具体使用请戳调试工具

运行状态

点击产品管理页面的”运行状态“选项，进入运行状态页面，实时显示设备信息，可以辅助调试：

产品开发资源

点击产品管理页面的”产品开发资源“选项，进入产品开发资源页面，显示产品开发资源，MCU开发资源，轻应用开发资源3项：

boboP · 发表于 2016-8-9 10:18:11

3-数据点定义

机智云云端，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

boboP · 发表于 2016-8-9 10:19:16

4-管理应用

根据不同的平台类型，APP开发者首先需要在开发者中心创建应用，并將产品与应用关联起来。创建应用步骤如下：

1、进入应用管理页面

点击【应用管理】链接，成功跳转到应用管理页面，显示应用列表详情，如图1-1；当前无应用，提示“您还没有添加任何应用”，点击右边的“添加新应用”按钮进行添加。

图1-1

2、创建新应用

2.1 页面显示

点击【创建新应用】按钮，弹出创建应用窗口，如图1-2。

图1-2

2.2 平台类型

分iOS、Android、微信Web应用等类型。

2.3 用户系统

同一款应用，Andriod、iOS已经微信的Web应用需要在创建时就进行绑定才能共用一个用户系统。

独立用户系统：一个应用独立一个用户系统。

绑定已有用户系统：指几个应用相互绑定共用一个用户系统，只有新创建的应用可以进行绑定旧应用。

2.4 输入应用名称

输入应用名称，默认选择平台为iOS，首个应用只能选择独立用户系统（绑定已有用户系统置灰），如图1-3。

图1-3

2.5 成功创建应用，如：微信宠物屋

点击【添加】按钮，成功创建应用，如图1-4，生成以“微信宠物屋”命名的应用。

图1-4

3、应用管理信息

在应用的详情页面中，可以看到该应用的名称、所选的平台类型、用户系统等信息，其中，

App ID：在SDK调用过程中唯一的一个应用标识（默认自动生成）。

App Secret：调用API时的Token，用来验证请求的合法性，请注意保密（默认自动生成）。

3.1 应用无设备接入

无设备接入时提示“您还没有接入任何设备”，如图1-5。

图1-5

3.2 设备接入应用

绑定应用就是將设备与应用进行关联，这样应用才可以对设备进行绑定控制等操作。如何绑定设备呢？

首先进入设备列表，再进入（如产品“微信宠物屋”）产品详细信息页面。可以看到已绑定的应用模块信息（当前无绑定应用），如图1-6；

图1-6

点击【绑定应用】按钮，弹出窗口，勾选需要绑定的应用再保存，此时在应用详情页面可以看到设备接入应用成功，当前设备存在于设备列表中，如图1-7。

图1-7

3.3 配置消息推送

机智云Android/ios应用支持接入“百度云推送”和“极光推送”。在接入之前需配置消息推送，需將应用与百度推送或极光推送绑定。

点击操作目录下的【配置消息推送】，可根据自身需求进行配置，在推送服务选择栏中，可选择“百度云推送”或“极光推送”（选择对应的选项后，有显示蓝色链接为“点击前往百度申请”或“点击前往极光申请”，点击链接可前往相应的网站申请所需的值，如百度的API Key和Secret Key或极光的App Key和Master Secret），输入申请到的key，点击【绑定】按钮即可。当成功绑定消息推送后，显示如图1-8，如“已绑定百度云推送服务”或“已绑定极光推送服务”。

图1-8

消息推送绑定成功后，如想更换新值，先删除旧值，再输入新值，点击【确认修改】按钮即可更改为新值；或想更换推送方式，需先解除绑定再重新选择新的推送服务方式。

3.4 修改应用信息

可以对当前的应用名称进行修改。

3.5 删除应用

对已经准备要丢弃的用户系统应用，可以直接点击【删除应用】，再点击【确定删除】按钮，便可直接删除。如果非准备丢弃的应用，请慎操作（警告：该操作是不可恢复的）。

3.6 第三方授权登录信息

点击【关联第三方登录】链接，弹出关联窗口，按提示去腾讯开放平台申请APP ID，完成关联。完成后，会显示对应值的，此时【关联第三方登录】显示为【取消关联第三方登录】。

注：目前仅支持QQ授权登录的关联，点击前往腾讯开放平台申请APPID关联再集成机智云SDK至您的APP进行登录校验。

图1-9

3.7 取消关联第三方登录

点击【取消关联第三方登录】链接，弹出窗口如图1-10，点击【确认取消】按钮，便可以取消关联第三方登录。