在企业智能云平台(http://portal.zcyun.cn)填写简单的个人信息和企业信息,经过平台审核通过后即可拥有企业智能云平台的所有基础功能。
该账号作为企业的系统管理员账号,可以创建子账号,通过配置角色分配不同的功能菜单给子账号。
创建产品是实现设备智能化的第一步,产品创建后会生成一个“平台产品型号ID”作为该产品在平台的唯一标志。
在【研发平台-产品管理】模块, 点击“新增”,开始创建产品,
填写产品基础信息,
产品类型:请选择合适的产品类型,在【属性信息】模块会根据产品类型推荐合适的属性模板,节省您的属性配置时间。
产品名称:可以配置多种语言环境下的名称,以便适配不同语言环境下的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等协议。
产品基础信息创建完后产品即创建成功,下一步可以定义产品功能点即【产品属性配置】。
产品创建完成后可以添加产品研发团队,
只有项目成员可以编辑产品信息,只有项目经理可以申请发布产品。
产品列表分为两部分:我的产品、企业产品。我的产品指开发者参与研发的产品,开发者对其拥有查看、编辑的权限,企业产品指同企业内其他开发者研发的产品,当前开发者对其只有查看权限。
产品创建完成后,点击左侧的【属性管理】,进行产品功能属性的定义,
平台经过大量的市场调研,总结出适合于多种行业、不同品类产品的属性模板,开发者可以直接使用、快速开发,节省研发时间,当属性模板不满足您的需求时,您也可以添加自定义属性,
属性类型:
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设计。
平台提供了两种硬件接入方案,点击左侧菜单栏【硬件接入方案】进入查看,
使用平台通用WiFi模组,优点:接入安全、快捷,模组价格高中低档齐全,另外还集成了京东微联、国美云智等第三方平台的通信协议。
1、选择平台通用WiFi模组平台通用WiFi模组型号及规格说明书
平台通用WiFi模组已经集成平台SDK,封装设备上云能力即实现了模组到云端的通讯,企业仅需关注模组和电控板的通讯研发即可。
模组购买请联系您平台上的商务经理或平台客服。
2、下载嵌入式开发资源,平台WiFi模组串口通信协议
平台提供标准串口通信协议,辅助企业快速完成模组和MCU的通信研发。
3、下载串口调试工具调试串口通信协议,串口通讯协议测试工具
平台提供串口调试工具,用户快速验证程序开发的成功和稳定性。
4、提供调试助手,用调试助手添加设备,控制设备上线进行设备的在线调试。调试助手
(1)将测试设备调至配网状态,不同设备的操作方法不同,下图以智城云智能插座为例:
a.手机连接路由器WiFi,且连接互联网;b.短按”开关键”,打开设备;c.长按”开关键”10秒,至指示灯以蓝色闪烁;
(2) 打开智城云调试助手,点击“添加设备”,选择“扫一扫”,扫描型号二维码(开发者在产品基础信息中获取“平台产品型号ID”,用任意二维码生成器生成二维码)进行添加。
(3) 输入WiFi密码一键配置,添加设备完成。
5、提供两种方式进行硬件调试,验证设备端数据通信是否正常。
方式1:通过企业智能云平台的硬件调试操作页面进行调试,如下图所示
方式2:通过智城云调试助手APP设备页面进行调试,如下所示
1、平台提供两种方案,实现模组和平台的通讯。
(1)提供设备接入SDK,优点是所占空间较小,缺点是研发先对复杂,需要平台提供技术支持。
(2)提供第三方模组通用模组设备端库,优点是研发简便,缺点是设备端库所占空间较大。
2、模组和MCU的通讯由设备厂商定协议或者电控板厂商定协议实现。
3、提供调试助手,用调试助手添加设备,控制设备上线进行设备的在线调试。调试助手
在【产品管理-硬件调试】模块,用调试助手添加设备,
设备添加后,控制设备上线,调试功能,在平台可以查看设备日志,
设备调试完成后,厂商如果仅需要获取设备数据无需APP控制,则可以跳过步骤5.1、5.2直接进入步骤6。
如果设备需要APP控制,请按照以下步骤完成APP研发和人机交互配置。
1、如果您想节省APP研发的时间和费用,可以直接使用我们提供的超级APP-云合,一天以内即可实现设备用户对设备的绑定和管理功能。产品接入超级APP,请联系您平台上的商务经理或平台客服。
2、如果您想拥有自己独立的APP,但是自己没有研发能力,我们提供APP研发服务。请联系您平台上的商务经理或平台客服。
3、如果您本身拥有APP研发能力,我们提供功能完整强大的SDK和技术支持,帮助您实现APP快速研发持。详见应用研发流程
绑定APP用户的智能设备在使用过程中,经常会和用户产生人机互动,用户希望能够通过APP控制设备、查看设备数据、设置联动场景、及时获取预警消息等,来感受智能设备带来的全新体验。为了让开发者可以更容易地实现人机交互的功能,平台提供了故障配置、产品UI开发调试、配网引导、告警配置的功能。
平台支持故障告警信息的配置,便于用户及时接收到设备的故障消息,点击左侧的菜单栏【故障配置】进入,
故障告警是基于故障码的,请注意填写正确的故障码,
平台支持告警消息的应用推送和短信推送,如果要推送短信需要创建【告警通知】类的短信模板,告警内容会作为短信内容进行发送,鉴于短信超过70字会分成两条发送,所以请适当控制告警内容的字数。
故障信息变动需要打包到设备页面中,所以当修改了故障信息,请重新上传UI资源包。
客户端故障消息示例:
产品UI开发调试用于研发设备的页面,研发流程如下:
1、平台提供常见产品的标准UI模板,供您参考使用,查看产品UI资源。
2、开发者下载平台提供的标准UI模板,在其基础上进行自定义开发,如扩展功能等,大大降低开发人员的学习成本,提升开发效率。详见H5研发流程
3、将开发完的设备UI资源上传至平台,
关联APP:客户端设备绑定时会根据关联的APP下载相应的产品UI包资源,若想在企业所有APP中均获取此产品的UI包资源,请选择“默认通用”。注:关联APP目前只支持“默认通用”,选择其他APP无效。
版本号:版本号需高于当前已发布最高版本。
适配类型:根据APP适配手机类型,选择横屏、竖屏、电视、pad。
4、UI调试,两种方式:推送给指定用户验证调试、虚拟设备调试。
4.1推送给指定APP用户验证,前提是这个用户已经绑定了这个型号的设备,
在APP上获取该设备最新的配置文件,在配置页面中控制设备,查看是否能正常使用。
4.2虚拟设备验证,首先用企业APP扫码添加虚拟设备,然后进行在线调试,
在APP中点击设备功能,查看设备日志,判断功能是否能正常使用。
验证通过后,和产品一起进行发布,APP端用户获取的设备页面是已发布且版本最高的UI资源。
平台支持配置设备的配网引导页,用于给APP用户提供配网引导,点击产品管理左侧的菜单栏【配网引导】进入,此模块提供配置设备在APP端的配网引导页面的功能。产品处于任何状态都可以进行新增、修改和删除。
并支持配置国际化语言配置,
选中某一个语言可以查看这个语言环境下的配网引导列表,并可以点击【新增】,添加这种语言环境下的配网引导信息,
引导标题:显示在引导页顶部,非必填项。
配网步骤:如果需要换行,在换行的位置输入换行符
。
产品图片:配网操作页面的引导图片,建议比例是5:3,最大1M。图片在页面中显示在配网步骤上方。
效果如下:
一种语言环境下如果有多条配网引导信息,则在APP端会按照添加的顺序显示每一页的信息,一条记录在APP端是一个页面,按照页面添加顺序确定引导页的显示顺序。
设备配网的时候,按照配网引导顺序一步步操作即可。
配网引导支持修改和删除。修改和删除保存后立即生效。
平台支持基于属性的告警信息的配置,便于用户及时接收到设备的告警消息,点击左侧的菜单栏【告警配置】进入,此模块用于创建基于属性的告警规则,当设备触发告警条件的时候,方便用户及时接收到告警消息。产品处于任何状态都可以进行新增、修改和删除。
告警是基于产品属性的的,请注意选择正确的属性,
平台支持告警消息的应用推送和短信推送,如果要推送短信需要创建【告警通知】类的短信模板,告警内容会作为短信内容进行发送,鉴于短信超过70字会分成两条发送,所以请适当控制告警内容的字数。
可以设置不同的告警级别,便于区分消息提醒和设备预警。
支持多条件告警,满足其中一条即触发告警。告警条件不可编辑和删除,请谨慎操作。
告警支持修改和删除。
客户端告警消息示例:
产品研发完成,可以申请发布,
产品审核
产品申请发布后,由审核人员进行审核,
审核通过后,产品信息不能编辑,若想修改产品信息,需要联系审核人员进行产品解锁。
审核发布后,该型号处于验证中的UI资源包同时发布,因此发布前请确认验证中的UI资源包已经验证通过。
平台提供设备固件在云端的在线升级功能,当设备连接到云端之后,可以大幅度减少召回产品的费用,通过管理平台就可以实现对这些设备的在线升级管理。
设备固件升级提供“推送至设备,自动升级”,”推送至用户,选择升级”两种推送方式;“设备”、“模块”两种升级类型,为企业提供灵活多样化的升级类型,
平台提供验证功能,升级对设备影响较大,发布前,使用平台的验证功能,将升级文件推送至指定的设备进行验证,验证设备升级后功能是否正常,
验证无误后,申请发布,需要企业管理员进行审核,审核通过后即正式发布,