文档中心
智城云 文档中心

设备接入流程

企业智能云平台

1、注册成为开发者

​ 在企业智能云平台(http://portal.zcyun.cn)填写简单的个人信息和企业信息,经过平台审核通过后即可拥有企业智能云平台的所有基础功能。

​ 该账号作为企业的系统管理员账号,可以创建子账号,通过配置角色分配不同的功能菜单给子账号。

2、创建产品

创建产品是实现设备智能化的第一步,产品创建后会生成一个“平台产品型号ID”作为该产品在平台的唯一标志。

在【研发平台-产品管理】模块, 点击“新增”,开始创建产品,

img

填写产品基础信息,

img

产品类型:请选择合适的产品类型,在【属性信息】模块会根据产品类型推荐合适的属性模板,节省您的属性配置时间。

产品名称:可以配置多种语言环境下的名称,以便适配不同语言环境下的APP。

型号类型:

1) 智能设备:具备独立接入平台能力的设备,目前支持WiFi、GPRS。

2) 网关设备:具备独立接入平台的能力,且为子设备提供接入平台服务的设备,具有路由转发能力。

3) 子设备:不具备独立接入物联网能力的设备,需借助网关与平台进行通信。选择子设备不需要配置联网方式、绑定方式和绑定数量,需要选择一个网关设备型号作为其网关。

4) Pad类设备:一种特殊的设备上带pad的智能设备,支持WiFi、GPRS,一般不会使用。

绑定方式:针对的是WiFi类设备。

1) 100:设备绑定时需要配置WiFi,绑定时根据客户端选择(添加列表或者扫描)的型号,进行产品UI包资源的下载,并不验证烧录在设备上的平台型号。

2) 200:设备绑定时不需要配置WiFi,仅通过提供的二维码扫描后添加。

3) 300:设备绑定时需要配置WiFi,绑定时需要确保客户端选择(添加列表或者扫描)的型号与烧录在设备上的型号一致,才能进行产品UI包的下载。

绑定数量:该型号的一个设备可以最多被用户绑定的数量。

产品类型和型号类型保存后不能修改,请谨慎选择。

平台支持智能设备、网关设备、子设备以及pad等类型设备,wifi、2g/3g/4g等协议。

产品基础信息创建完后产品即创建成功,下一步可以定义产品功能点即【产品属性配置】。

产品创建完成后可以添加产品研发团队,

img

只有项目成员可以编辑产品信息,只有项目经理可以申请发布产品。

产品列表分为两部分:我的产品、企业产品。我的产品指开发者参与研发的产品,开发者对其拥有查看、编辑的权限,企业产品指同企业内其他开发者研发的产品,当前开发者对其只有查看权限。

3、定义功能点

产品创建完成后,点击左侧的【属性管理】,进行产品功能属性的定义,

img

​ 平台经过大量的市场调研,总结出适合于多种行业、不同品类产品的属性模板,开发者可以直接使用、快速开发,节省研发时间,当属性模板不满足您的需求时,您也可以添加自定义属性,

img

属性类型:

1) 数值类:有取值范围的类型,例:冰箱-冷藏室温度取值范围是1℃~10℃

2) 开关类:默认仅有开、关两种状态,数值0代表“关”,数值1代表“开”

3) 字符类:支持设备属性与云端的字符串传递,例:hellofit心电图数据

4) 枚举类:有固定取值的类型。例:冰箱工作模式key:1,value:速冻;key:2,value:假日;key:3,value:智能;key:4,value:自定义

5) 二进制类:按位设置功能,一个字节可支持多个功能,例:微波炉,上管开关:1~1位,上管温度:2~9位,下管开关:10~10位,下管温度:11~18位

容差范围:针对属性值属性,指数值型数据可上下波动的误差范围,只有超过该范围才会立即上报,如果一直在该范围内,则5S上报一次。

是否可控:定义该功能是否可以被控制,例:空气质量检测值“PM2.5”为10,则为”不可控”;空调的”开关”参数,则为”可控”

是否存储:定义属性的状态变化数据是否需要在云端存储

仅主人权限:该功能的可见范围,是指该功能仅对主人可见,否则对所有绑定该设备的人可见(第一个绑定设备的人被定义为主人,其他则为客人,主人权限可转移)。

权限控制:

1) 不限制:客户端侧在任何环境下都可以控制该属性

2) 不允许访问:客户端侧在任何环境下都不可以控制该属性

3) 仅允许局域网访问:客户端侧只能在局域网下可以控制该属性

4) 仅允许远程访问:只能通过远程控制(广域网)该属性

属性ID和属性类型保存后不能修改,请谨慎操作。

自定义属性提供修改和删除的功能。

配置完属性后,可以继续完善产品的其他配置信息,如故障和告警、配网引导等,也可进行硬件接入开发或产品UI设计。

4、硬件接入

平台提供了两种硬件接入方案,点击左侧菜单栏【硬件接入方案】进入查看,

img

一是平台通用WiFi模组接入

使用平台通用WiFi模组,优点:接入安全、快捷,模组价格高中低档齐全,另外还集成了京东微联、国美云智等第三方平台的通信协议。

1、选择平台通用WiFi模组平台通用WiFi模组型号及规格说明书

平台通用WiFi模组已经集成平台SDK,封装设备上云能力即实现了模组到云端的通讯,企业仅需关注模组和电控板的通讯研发即可。

模组购买请联系您平台上的商务经理或平台客服。

2、下载嵌入式开发资源,平台WiFi模组串口通信协议

平台提供标准串口通信协议,辅助企业快速完成模组和MCU的通信研发。

3、下载串口调试工具调试串口通信协议,串口通讯协议测试工具

平台提供串口调试工具,用户快速验证程序开发的成功和稳定性。

4、提供调试助手,用调试助手添加设备,控制设备上线进行设备的在线调试。调试助手

(1)将测试设备调至配网状态,不同设备的操作方法不同,下图以智城云智能插座为例:

a.手机连接路由器WiFi,且连接互联网;b.短按”开关键”,打开设备;c.长按”开关键”10秒,至指示灯以蓝色闪烁;


img

(2) 打开智城云调试助手,点击“添加设备”,选择“扫一扫”,扫描型号二维码(开发者在产品基础信息中获取“平台产品型号ID”,用任意二维码生成器生成二维码)进行添加。

(3) 输入WiFi密码一键配置,添加设备完成。

5、提供两种方式进行硬件调试,验证设备端数据通信是否正常。

方式1:通过企业智能云平台的硬件调试操作页面进行调试,如下图所示

img

方式2:通过智城云调试助手APP设备页面进行调试,如下所示

img

二是第三方模组接入

1、平台提供两种方案,实现模组和平台的通讯。

(1)提供设备接入SDK,优点是所占空间较小,缺点是研发先对复杂,需要平台提供技术支持。

(2)提供第三方模组通用模组设备端库,优点是研发简便,缺点是设备端库所占空间较大。

2、模组和MCU的通讯由设备厂商定协议或者电控板厂商定协议实现。

3、提供调试助手,用调试助手添加设备,控制设备上线进行设备的在线调试。调试助手

在【产品管理-硬件调试】模块,用调试助手添加设备,

img

设备添加后,控制设备上线,调试功能,在平台可以查看设备日志,

img

设备调试完成后,厂商如果仅需要获取设备数据无需APP控制,则可以跳过步骤5.1、5.2直接进入步骤6。

如果设备需要APP控制,请按照以下步骤完成APP研发和人机交互配置。

5、APP研发

1、如果您想节省APP研发的时间和费用,可以直接使用我们提供的超级APP-云合,一天以内即可实现设备用户对设备的绑定和管理功能。产品接入超级APP,请联系您平台上的商务经理或平台客服。

2、如果您想拥有自己独立的APP,但是自己没有研发能力,我们提供APP研发服务。请联系您平台上的商务经理或平台客服。

3、如果您本身拥有APP研发能力,我们提供功能完整强大的SDK和技术支持,帮助您实现APP快速研发持。详见应用研发流程

6、人机交互配置

绑定APP用户的智能设备在使用过程中,经常会和用户产生人机互动,用户希望能够通过APP控制设备、查看设备数据、设置联动场景、及时获取预警消息等,来感受智能设备带来的全新体验。为了让开发者可以更容易地实现人机交互的功能,平台提供了故障配置、产品UI开发调试、配网引导、告警配置的功能。

故障配置

平台支持故障告警信息的配置,便于用户及时接收到设备的故障消息,点击左侧的菜单栏【故障配置】进入,

img

故障告警是基于故障码的,请注意填写正确的故障码,

img

平台支持告警消息的应用推送和短信推送,如果要推送短信需要创建【告警通知】类的短信模板,告警内容会作为短信内容进行发送,鉴于短信超过70字会分成两条发送,所以请适当控制告警内容的字数。

故障信息变动需要打包到设备页面中,所以当修改了故障信息,请重新上传UI资源包。

客户端故障消息示例:

img

产品UI开发调试

产品UI开发调试用于研发设备的页面,研发流程如下:

img

1、平台提供常见产品的标准UI模板,供您参考使用,查看产品UI资源

2、开发者下载平台提供的标准UI模板,在其基础上进行自定义开发,如扩展功能等,大大降低开发人员的学习成本,提升开发效率。详见H5研发流程

3、将开发完的设备UI资源上传至平台,

img

关联APP:客户端设备绑定时会根据关联的APP下载相应的产品UI包资源,若想在企业所有APP中均获取此产品的UI包资源,请选择“默认通用”。注:关联APP目前只支持“默认通用”,选择其他APP无效。

版本号:版本号需高于当前已发布最高版本。

适配类型:根据APP适配手机类型,选择横屏、竖屏、电视、pad。

4、UI调试,两种方式:推送给指定用户验证调试、虚拟设备调试。

4.1推送给指定APP用户验证,前提是这个用户已经绑定了这个型号的设备,

img

在APP上获取该设备最新的配置文件,在配置页面中控制设备,查看是否能正常使用。

4.2虚拟设备验证,首先用企业APP扫码添加虚拟设备,然后进行在线调试,

img

在APP中点击设备功能,查看设备日志,判断功能是否能正常使用。

验证通过后,和产品一起进行发布,APP端用户获取的设备页面是已发布且版本最高的UI资源。

配网引导

平台支持配置设备的配网引导页,用于给APP用户提供配网引导,点击产品管理左侧的菜单栏【配网引导】进入,此模块提供配置设备在APP端的配网引导页面的功能。产品处于任何状态都可以进行新增、修改和删除。

img

并支持配置国际化语言配置,

img

选中某一个语言可以查看这个语言环境下的配网引导列表,并可以点击【新增】,添加这种语言环境下的配网引导信息,

img

引导标题:显示在引导页顶部,非必填项。

配网步骤:如果需要换行,在换行的位置输入换行符

产品图片:配网操作页面的引导图片,建议比例是5:3,最大1M。图片在页面中显示在配网步骤上方。

效果如下:

img

一种语言环境下如果有多条配网引导信息,则在APP端会按照添加的顺序显示每一页的信息,一条记录在APP端是一个页面,按照页面添加顺序确定引导页的显示顺序。

设备配网的时候,按照配网引导顺序一步步操作即可。

配网引导支持修改和删除。修改和删除保存后立即生效。

告警配置

平台支持基于属性的告警信息的配置,便于用户及时接收到设备的告警消息,点击左侧的菜单栏【告警配置】进入,此模块用于创建基于属性的告警规则,当设备触发告警条件的时候,方便用户及时接收到告警消息。产品处于任何状态都可以进行新增、修改和删除。

img

告警是基于产品属性的的,请注意选择正确的属性,

img

平台支持告警消息的应用推送和短信推送,如果要推送短信需要创建【告警通知】类的短信模板,告警内容会作为短信内容进行发送,鉴于短信超过70字会分成两条发送,所以请适当控制告警内容的字数。

可以设置不同的告警级别,便于区分消息提醒和设备预警。

支持多条件告警,满足其中一条即触发告警。告警条件不可编辑和删除,请谨慎操作。

告警支持修改和删除。

客户端告警消息示例:

img

7、审核发布,进入量产

产品研发完成,可以申请发布,

img产品审核

产品申请发布后,由审核人员进行审核,

img

审核通过后,产品信息不能编辑,若想修改产品信息,需要联系审核人员进行产品解锁。

审核发布后,该型号处于验证中的UI资源包同时发布,因此发布前请确认验证中的UI资源包已经验证通过。

固件升级

平台提供设备固件在云端的在线升级功能,当设备连接到云端之后,可以大幅度减少召回产品的费用,通过管理平台就可以实现对这些设备的在线升级管理。

img

设备固件升级提供“推送至设备,自动升级”,”推送至用户,选择升级”两种推送方式;“设备”、“模块”两种升级类型,为企业提供灵活多样化的升级类型,

img

平台提供验证功能,升级对设备影响较大,发布前,使用平台的验证功能,将升级文件推送至指定的设备进行验证,验证设备升级后功能是否正常,

img

验证无误后,申请发布,需要企业管理员进行审核,审核通过后即正式发布,

img