*标准方案产品是指机智云通过接入数量丰富的不同品类的产品后积累的标准化产品,通过将常见品类的标准化功能进行提炼整合,提供标准的数据点,无需再创建数据点,可以实现免开发快速接入。
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 产品详情
点击顶部【硬件开发】功能,可查看产品的基本信息和数据点。
注意,标准方案的数据点无法修改。自定义方案的数据点可以修改。
*数据点:数据点即设备产品的功能的抽象,用于描述产品功能及其参数。创建数据点后,设备与云端通讯的数据格式即可确定,设备、机智云可以相互识别设备与机智云互联互通的数据。
*标准数据点:指机智云经过长期积累,接入数量丰富的不同品类的产品后,将常见品类的标准化功能进行提炼整合的数据点。
3.2.2 开发向导
点击左侧【开发向导】功能,机智云提供硬件开发流程向导,可以根据指引跳转到对应到开发功能和下载所需的协议文档。
机智云会根据定义的产品数据点,自动生成MCU串口通信代码或整个MCU工程代码,同时也有SOC方案的工程代码。可点击进入MCU开发。
根据数据点还会自动生成串口通信协议,可下载《xxxx - 机智云独立MCU方案接入通信协议文档》和提供功能参数的《xxxx - 机智云接入JSON文档》,此文档是对协议的格式化说明,包含每个数据点的ID、描述、数据类型、位置信息等,辅助硬件开发工程师使用。
3.2.3 模组信息
文章评论(0条评论)
登录后参与讨论