产品创建教程

2. 创建产品

可以创建标准方案产品和自定义方案产品，支持的设备品类超过150+，快速实现产品定义、开发调试、设备管理。

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

► 选择品类

目前支持创建的品类

类别	品类
照明	球泡灯、灯带、吸顶灯、筒灯、调光器
电工	插座、排插、面板开关
中控网关	网关、中央控制系统、路由器、无线网、电网、门锁
安防	安防主机、可燃气体报警器、烟雾报警器、门磁、摄像头、温度传感器、湿度传感器、温湿度传感器、水浸传感器、人体红外传感器、甲醛传感器、一氧化碳传感器、可视对讲
环境电器	温控器、空气检测仪、空气净化器、消毒灯、除湿机、电风扇、加湿器、空调、新风机、空调扇
热家电	热泵、热水器、取暖器、地暖、电壁炉、加热棒、浴霸、集成吊顶
厨电	洗碗机、消毒柜、电冰箱、冷柜、酒柜、水槽、锅具、微波炉、电烤箱、电蒸箱、燃气灶、抽油烟机、压力锅、咖啡机、电饭煲、电磁炉、炖锅、面包机、冲奶机、水壶、豆浆机、电茶壶
生活小家电	净水器、饮水机、软水机、扫地机器人、吸尘器、电蚊拍、电蚊香、洗衣机、干衣机、晾衣架、电视机、遮阳、窗帘、闹钟
卫浴&个人护理	美容仪、电动牙刷、智能水杯、智能马桶
节能能源	家用水表、家用电表
教育娱乐	音箱、家庭影院、投影仪、打印机、点读机、故事机、智能机器人、教学设备
园艺农林	割草机、自动灌溉系统、智能种植设备、农业检测、养殖监控
可穿戴产品	手环、手表、运动鞋、运动服、防丢器、蓝牙耳机
交通运输	电动车跟踪器、电池跟踪器、车辆管理、物流仓库、车联网、单车、电动汽车、充电桩、物流柜管理、快递柜管理
医疗保健	按摩椅、血压计、血糖仪、睡眠垫、睡眠床、足疗仪、体脂测量仪、电子秤、治疗仪
运动器械	健身车、跑步机、高尔夫球轴传感器、辅助运动设备
玩具娱乐	麻将机、遥控飞机、夹娃娃机、遥控车、投篮机、婴童玩具
工业	智能水泵、压缩机、发电机、锅炉、变频器、工控设备、污水处理、机械重工、注塑机、工业检测仪、机器人/机械臂
其他	微信宠物屋（Gokit）、其他

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

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

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

标准方案与自定义方案的区别

	标准方案	自定义方案
产品名称	可填	可填
通讯类型	不可选	可选
数据传输方式	不可选	可选
功耗方式	不可选	可选
标准数据点	有	无

2.1. 标准方案产品教程

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

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

2.2. 自定义方案产品教程

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

自定义产品可选选项

支持的通讯类型	Wi-Fi、移动网络、NB-IoT、网关子设备（Mesh、串行接口、射频、LoRa、Zigbee）
支持的数据传输方式	定长、变长
支持的功耗方式	正常、低功耗
支持的通讯网络	电信、联通、移动
支持的命令下发模式	PSM、eDRX、DRX

*数据传输方式：

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

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

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

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

*命令下发模式：

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

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

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

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

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

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

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

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

1.3 读写类型：

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

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

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

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

1.4 数据类型：

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

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

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

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

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

► 使用Adapter进行协议互转，点击Adapter中的“去编辑”按钮。

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种多语言配置，分别为：

中文简体 zh

中文（繁体）

英语 -English

法语 -Französisch

德语 -Deutsch

意大利语 -Italienisch

阿拉伯语 -العربية

日语 -日文

西班牙语 -Español

保加利亚语 -български

克罗地亚语 -hrvatski

捷克语 -Česky

丹麦语 -Dansk

荷兰语 -Nederlands

希腊语 -Ελληνικά

匈牙利语 -Magyar

印度尼西亚语 -Orang indonesia

哈萨克语 -Қазақша

韩语 -한국어

老挝语 -Laotian

马来语 -Melayu

波兰语 -Polski

葡萄牙语 -Português

罗马尼亚语 -Românesc

瑞典语 -Svenska

泰语 -ไทย

越南语 -Tiếng việt

俄语-Pусский

乌克兰语-Український

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

► 编辑文案对应的翻译内容，点击右侧填入翻译内容，修改完成后。点击右上角“保存编辑”按钮。

（修改第一个产品名称，会显示在移动应用的默认产品名称中。）

3.1.5 发布申请

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

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

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

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. 发布上架

*发布上架功能将逐步开启，敬请期待

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

*点击咨询服务购买GDCS服务https://www.gizwits.com/price