【IoT开发手册】升级版机智云开发平台，让小白也能玩转Io...

Kara

【IoT开发手册】升级版机智云开发平台，让小白也能玩转IoT开发

最近收到私信有小伙伴问机智云新版开发者中心和旧版有什么区别，如何更快上手新版开发者中心，今天玛丽将通过五篇连载来说明，
前四篇主要讲述如何使用新版机智云开发平台来进行智能设备开发。

• 创建智能产品（讲硬件部分）
• 创建移动应用（讲APP应用）
• 开通语音应用（调用第三方语音服务）
• 开通业务应用（调用业务后台服务）
• 总结（旧版和新版开发平台的异同点）
  
  

第一篇：创建智能产品

新版机智云开发平台，在流程方面进行了优化，使得操作页面更简洁、流程更清晰，进一步丰富所见即所得在线开发方式，减少开发量，更重要的是，功能更丰富了，针对智能硬件产品这块儿：

• 默认提供150+种标准方案产品，涵盖家电、安防、网关、教育、农林牧、交通、医疗等行业。
• OTA升级更精准，精确统计版本分布情况，支持多种推送方式。
• 硬件产品只需通过在线点击“关联应用”即可被APP控制。
• 多种在线工具有针对性来简化开发，MCU开发在线自动生成、虚拟设备模拟硬件环境、产测工具助力批量化生产、D3引擎拖拉拽实现多种消息推送。
  
  

下面进入实践部分，通过这篇操作说明，可以全面了解新版机智云开发平台的IoT开发流程。




1. 注册机智云账号

注册机智云账号并登录，网址为 developer.gizwits.com

2. 创建智能产品点击【智能产品】旁边的“创建”按钮。



选择品类

选择标准方案 VS 自定义方案创建产品。

*标准方案产品是指机智云通过接入数量丰富的不同品类的产品后积累的标准化产品，通过将常见品类的标准化功能进行提炼整合，提供标准的数据点，无需再创建数据点，可以实现免开发快速接入。

*自定义方案产品是可以自定义创建和上传数据点或者使用Adapter进行协议互转的产品。

2.1. 标准方案产品教程创建标准方案产品，输入产品名称和选择通讯方式，并点击“创建产品”按钮。



创建成功后会自动生成一套标准的数据点，无需再创建数据点。



2.2. 自定义方案产品教程创建自定义方案产品，输入产品名称。选择通讯类型、数据传输方式，功耗方式后，点击“创建产品”按钮。

*数据传输方式：定长 VS 变长

定长：指在功能数据点上报下发时一并传输。

变长：指在功能数据点上报下发时只传输改变的功能数据点。

比如一个灯有开关、亮度两个功能时，触发改变亮度这个功能时，定长是两个功能数据点的状态数据都传输，变长则只会传输亮度这个功能数据点。

两者各有优势，定长对于开发更方便，变长则更节省传输资源。

*命令下发模式：PSM 、 eDRX 、DRX

PSM（Power Saving Mode）：终端非业务期间深度休眠，不接收下行数据，只有终端主动发送上行数据（MO Data）时可接收IoT平台缓存的下行数据，适合对下行数据无时延要求的业务。

eDRX（extended Discontinuous Reception）：终端设备兼顾低功耗和对时延有一定要求的业务，在每个eDRX周期内，只有在设置的寻呼时间窗口内，终端可接收下行数据，其余时间终端处于休眠状态，不接收下行数据，该模式可在下行业务时延和功耗之间取得平衡。

DRX（Discontinuous Reception）：可以认为下行业务随时可达终端设备，在每个DRX周期（1.28s，2.56s。5.12s或者10.24s），终端都会检测一次是否有下行业务到达，适用于对时延有高要求的业务。

自定义方案产品可以自定义创建和上传数据点或者使用Adapter进行协议互转。

上传数据点：点击标准数据点中“去编辑”按钮。

填写数据点的标示名、显示名称、读写类型、数据类型及备注：

标识名：用于应用层传输，客户端或业务云开发时需要使用。命名规则遵循标准的开发语言变量名命名规范，支持英文字母、数字和下划线，以英文字母开头。

显示名称：自定义功能点名称。

读写类型：

①　只读：表示该数据点非控制，数据只支持从设备上报。

②　可写：表示该数据点可控制。设备端可上报该数据点数据；云端/客户端可对该数据点数据做出下发控制。

③　报警：表示该数据点非控制，数据只支持从设备上报，数据类型需为布尔值。

④　故障：表示该数据点非控制，数据只支持从设备上报，数据类型需为布尔值。云端会对设备上报的该数据点做统计，可在“运行状态”查看。

数据类型：

①　布尔值：表示两个状态：0，或1。如开关状态等，建议使用布尔数据类型。例如gokit开发板的“宠物屋”，“开启/关闭红色灯”该数据点。

②　枚举类型：可定义一个有限的取值集合。当定义的某个功能（元器件）有固定的若干个值。例如GoKit开发板的“宠物屋”，“设定LED组合颜色”该数据点的枚举定义值：“自定义,黄色,紫色,粉色”。

③　数值：填写数值范围，数值可为负数/小数，机智云自动将数值转换为正数。例如GoKit开发板的“宠物屋”，“设定电机转速”该数据点：电机有正反转、调速功能，数据点值可定义为：-5～5。

④　扩展：填写数据长度，数据内容由用户自定义。对于上述功能点无法满足的复杂功能可采用。机智云不建议使用此类型数据，设备上报该数据点的数据，机智云无法识别。

备注：选填，用一段文本描述当前数据点的功能及定义方法，对字符格式不做限制。只用于提高数据点的易读性，如果需要团队协作开发，建议规范填写。

3. 产品管理3.1. 产品应用页面

产品应用页面：是用于配置此款产品在不同应用下的控制页面样式。

3.1.1 选择关联应用

可以将产品关联到已创建的移动应用或公版应用（智家APP）， 关联应用后，才能使用APP控制设备。

*公版应用（智家APP）：是机智云开发的一款智能家居移动应用APP，可以实现不同品牌、不同品类的产品接入，模版完善，可实现全屋智能、设备控制、场景联动、语音控制、账户管理等多种功能。

点击左侧“+关联应用”按钮。

选择要关联的应用。

方式一：若关联到自有应用，则需要先创建移动应用，并到移动应用界面构建应用后才生效。（自由应用是指自己创建的移动应用）

方式二：若关联到公版应用（智家APP），是指将配置好的产品发布到智家APP，可以在智家APP上通过添加设备，找到对应的品牌下的产品，并将产品配网绑定，最终实现在智家APP上进行设备控制与联动。关联并发布产品后需要等审核，审核通过后可在智家APP看到对应的品牌和产品。

关联我的应用，勾选应用后，点击“确定”。

若关联公版应用，切换标签栏选择“公版应用”，勾选“智家”，点击“确定”即可。

3.1.2 控制页面设置

制页面是指操作设备的主页面。

常规流程：右侧选择模板，每个品类都有通用模板，常用品类会有对应的模版，没有对应的模板时候也可以使用通用模板。

*通用模版：通用模板是根据数据点数量和类型自动生成的模版。

点击右侧【功能】，可以在功能列表中将需要的功能可以点击打开，不需要的功能点击关闭，不同模板对应的功能是根据数据点定义的功能显示的，编辑完成后点击中间的“保存”按钮。

自定义模板导入教程

鼠标移入模板，右上角显示复制按钮，用户可通过将公共模板复制后自行开发。

点击复制模版后，会创建新模版，填写模板标识名和模板名称，点击确定。（需要先在账号设置中配置SSH KEY）

*配置SSH KEY：在账号设置中配置，点击右上角的邮箱，下拉框中选择“账号设置”， 配置SSH KEY包括公钥标题和公钥，公钥可用于复制git代码时使用。

鼠标移入新建的模板点击“复制 Git 仓库地址”，通过 GIT 拉取模板代码然后修改并提交即可上传

上传模板图片后，点击“保存”按钮。

3.1.3 配网引导

机智云开发者中心支持多种方式的配网，并可配置相应的配网引导页面。

支持的配网方式

通讯方式	配网类型
Wi-Fi	通过Airlink、SoftAp（热点配网）、蓝牙
蜂窝	扫描二维码

*Airlink：机智云对各种SmartConfig、SmartLink这种UDP广播报方式对设备配置入网的技术统称，兼容了多个Wi-Fi模块厂商的配置协议，总结了一套良好用户体验的标准Onboarding操作流程，机智云的Wi-Fi 设备接入SDK已经内置AirLink技术。

*Softap：由于目前各个Wi-Fi模块厂商的Smart Config协议均未完全成熟，也不支持5G路由器信号。机智云在提供了AirLink配置模式的同时也支持SoftAP模式配置设备接入路由器。当设备进入SoftAP配置模式时，设备本身将成为一个AP，智能手机可直接与设备进行连接，然后在手机上的界面上输入路由器的SSID和密码，设备接收到信息的时候会自动尝试连接路由器，连接成功则自动切换到正常使用的模式。

击【配网引导】，在手机屏幕上方选择“主页面”和“重置设备”并填写相应的配网文案，两者的文案相互独立不受影响；

主页面：是设备出厂后首次配网时的默认配网提示。

重置设备页面：是指设备配网成功或失败后，重新将设备进入配网状态的页面提示。

右侧启动/禁用不同的配网模式，鼠标长按可拖动修改配网顺序。

目前支持配置的配网引导有：自动添加：Airlink、蓝牙，手动添加：Softap。  

中间点击【+】加号，添加图片或文案后，点击“保存”按钮。

3.1.4 国际化语言

支持全球化部署，配置多地区语言。（目前已支持28种多语言配置）

点击【国际多语言】，之前步骤中添加保存的文案会全部罗列出来，点击“添加语言”，选择需要配置的语言，点击确定。





选择需要添加的语言后，点击“确认”。

编辑文案对应的翻译内容，点击右侧填入翻译内容，修改完成后。点击右上角“保存编辑”按钮。（修改第一个产品名称，会显示在移动应用的默认产品名称中。）

3.1.5 发布申请

只有“关联应用”时候选择公版应用（智家APP）才有”发布申请”功能，关联自有应用的去构建应用即可发布产品。

点击【发布申请】，填写申请说明，点击“提交审核”。

审核通过后将成功接入智家，产品显示在智家 APP 的品牌列表中，通过智家APP添加和控制设备，还能实现与其他品牌的设备联动，场景联动，语音控制等功能。

在实践过程中，建议将 3.1部分的产品应用页面开发在收尾阶段来做这部分工作，优先进行3.2部分的硬件功能部分开发。

3.2. 硬件开发3.2.1 产品详情

点击顶部【硬件开发】功能，可查看产品的基本信息和数据点。

注意，标准方案的数据点无法修改。自定义方案的数据点可以修改。

*数据点：数据点即设备产品的功能的抽象，用于描述产品功能及其参数。创建数据点后，设备与云端通讯的数据格式即可确定，设备、机智云可以相互识别设备与机智云互联互通的数据。

*标准数据点：指机智云经过长期积累，接入数量丰富的不同品类的产品后，将常见品类的标准化功能进行提炼整合的数据点。

*定义数据点教程：http://docs.gizwits.com/zh-cn/quickstart/datapoint_tutorial.html

3.2.2 开发向导

点击左侧【开发向导】功能，机智云提供硬件开发流程向导，可以根据指引跳转到对应到开发功能和下载所需的协议文档。

机智云会根据定义的产品数据点，自动生成MCU串口通信代码或整个MCU工程代码，同时也有SOC方案的工程代码。可点击进入MCU开发。

根据数据点还会自动生成串口通信协议，可下载《xxxx - 机智云独立MCU方案接入通信协议文档》和提供功能参数的《xxxx - 机智云接入JSON文档》，此文档是对协议的格式化说明，包含每个数据点的ID、描述、数据类型、位置信息等，辅助硬件开发工程师使用。

3.2.3 模组信息

点击左侧【模组信息】功能，设置Wi-Fi模组SoftAP配网时候的热点和密码，点击“保存”。

*SoftAp：当设备进入SoftAP配置模式时，设备本身将成为一个AP，智能手机可直接与设备进行连接，然后在手机上的界面上输入路由器的SSID和密码，设备接收到信息的时候会自动尝试连接路由器，连接成功则自动切换到正常使用的模式。

3.2.4 虚拟设备

虚拟设备是机智云提供的用于调试设备的虚拟产品，可以模拟真实设备下发和上报功能，查看日志记录等。

点击左侧【虚拟设备】功能，智家 APP 扫描左侧顶部的二维码，左边调节数据点的数值点击“上报”按钮，右侧显示上报内容和下发内容。

注意：同一个二维码只能由一个用户绑定一次，重新绑定可以刷新页面更新二维码。关闭页面后，设备将处于离线状态。

3.2.5 设备管理

点击左侧【设备管理】功能，可查看设备列表，列表中显示设备Mac、设备ID、首次上线时间、累计上线次数、最后一次上线时间、设备状态、操作（实时调试/查看详情）

点击设备列表中的“实时调试”，可查看到设备实时上报及下发的日志记录，可以在原始数据和JSON中切换，方便调试设备。

点击设备列表中的“查看”，可查询设备的历史日志记录，包括：设备日志和上下线记录。

*历史日志查询范围：可查询1个月内的历史日志，有次数限制提示（默认5次），查询1天的日志将消耗1次查询次数，当天最多可查询5次即当天内最多可查询5天的历史记录，3天内查询过的历史日志将会缓存在云端，已缓存的日期背景会显示为绿色（缓存日志重复查询不消耗次数）；

设备日志

上下线记录

3.2.6 更多功能

点击左侧【+更多功能】可以添加机智云提供的多种增值服务，包括应用配置、应用开发、MCU开发、产测工具、固件升级（OTA）、D3 Engine、产品互联、SNoti服务、企业API、ECE 雾计算、应用邮件模版、实时大数据、离线数据。

【应用配置】：APP、微信开发使用机智云分配的用户系统。

【应用开发】：根据选择的平台，生成APP的源码。

【MCU开发】：根据选择的硬件平台，自动生成MCU开发需要的代码包。

【产测工具】：对生产出来的设备进行批量测试且可以设置测试的功能点。

【固件升级（OTA）】：远程对设备Wi-Fi模块，MCU模块进行固件程序升级。

【D3 Engine】：机智云为开发者提供的傻瓜式的数据处理、开发引擎。

【产品互联】：配置产品与第三方产品或服务联动，例如亚马逊Echo。

【SNoti服务】：为企业提供SSL通讯API，实时推送设备与产品相关的事件。

【企业API】：机智云为接入机智云平台的企业开发者提供的开发API服务。

【ECE 雾计算】：动态配置模组，自动适配设备私有协议。

【应用邮件模版】：可修改注册和找回密码的邮件内容，并可配置邮件服务器。

【实时大数据】：生成数据API，对产品数据点进行实时大数据统计分析。

【离线数据】：机智云为接入机智云平台的企业开发者提供的离线数据下载服务。

3.3. 发布上架

*点击【发布上架】，提交【申请发布】，机智云提供免费的人工审核，利用我们专业的QA团队，我们将严格测试你的产品并为你提供产品测试报告。产品成功发布后，您的设备将会运行在正式的生产服务器，并且机智云会为您的设备分配独立的云端运行环境，确保设备24小时稳定在线以供用户使用。