收藏官网首页
查看: 13078|回复: 6

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

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
跳转到指定楼层
楼主
发表于 2016-8-9 10:14:48 | 只看该作者 回帖奖励 |倒序浏览 |阅读模式
免费使用STM32、APP自动代码生成工具
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,可以看到这里个人账号注册是无企业项目的,只有一个个人项目。


34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
沙发
 楼主| 发表于 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项:


34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
板凳
 楼主| 发表于 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


34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
地板
 楼主| 发表于 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,点击【确认取消】按钮,便可以取消关联第三方登录。
图1-10


5#
发表于 2016-8-26 10:53:02 | 只看该作者
注册成为机智云开发者,手机加虚拟设备快速开发
楼主整理好详细!!

3

主题

253

帖子

432

积分

中级会员

Rank: 3Rank: 3

积分
432
6#
发表于 2016-9-27 15:28:00 | 只看该作者
点赞点赞,谢谢楼主分享

0

主题

9

帖子

209

积分

中级会员

Rank: 3Rank: 3

积分
209
7#
发表于 2016-12-22 08:57:36 | 只看该作者
谢谢楼主分享
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

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