固件开发流程
本章描述设备生产商,如何接入广联达筑联平台,创建物模型,调试数据的上传和下发, 以及如何配网安装。
# 账号注册/登录
广联达筑联平台上暂时不支持个人开发者接入,不支持自行注册账号,如果设备生产商希望接入广联达筑联平台,需要申请开发者账号,申请人将手机号等信息提供给平台对接人,平台注册完成并开通开发者权限后通知申请人。授权通过后,申请人成为广联达智能硬件合作伙伴。 设备生产商使用开发者账号进行设备物模型定义、开发、调试、投产、运维等。 广联达筑联平台网址和广联达数字项目管理平台相同:xmgl.glodon.com。
# 创建产品
开发一款产品前,需要在筑联平台上先创建该类型产品的物模型。
# 物模型简介
产品物模型是平台对物联网设备功能的抽象,包括设备属性、设备事件以及设备命令,通过设备属性,设备可以上报属性值,也可以通过云平台更新设备的属性值;设备事件由设备上报给平台,可以携带参数;云平台还可以通过下发命令控制设备实现较复杂的功能。 合作开发者在新建产品前,需根据产品的功能和使用场景,明确待接入产品的产品类型,选择合适的接入方式,再在筑联平台上新建产品。 产品接入的方式有:WIFI、GPRS/4G、Lora、NB-iot等。(本文档按照WIFI模组描述详细接入过程)。
# 定义产品物模型
进入数字项目平台后,鼠标移动到导航按钮上,然后选择开发者中心的物联网平台,进入【设备管理】-【模型管理】-【自定义模型】-【新建】:
输入物模型名称,选择【从系统模型中创建】,点击【系统模型】,在弹出框里勾选系统模型的类别:
查看新建的物模型的详情:
如果物模型的功能定义不满足,可以新建更多的功能:
# 创建设备
开发阶段:在【物联网平台】-【设备管理】-【设备管理】中,选择新建一个设备
量产阶段:参考《量产相关》章节。
# 下载安全证书
设备接入筑联平台需要进行安全认证,因此需要提前将安全证书下载到模组中,安全证书可以有多种格式,目前支持三元组的方式。
三元组的内容如下:
MedelID: 模型ID,每个品类的设备共用模型ID,系统自动生成;
DeviceID: 设备ID,设备的全局惟一ID,通过该ID可以定位到一个设备,系统自动生成;
DeviceToken:设备口令,用于设备和平台之间的加密通信,系统自动生成
另外,还有一个ModelToken: 模型口令,使用模型口令和设备序列号可以和平台交换三元组。具体请参考《量产相关》章节。
在设备详情页中查找到设备ID和设备口令和模型ID:
获得三元组后,参考《AT指令》章节,将三元组通过AT指令传输给WIFI模组。
# 产品调试
产品调试,包括与WIFI模组的接口调试,将数据按约定格式上传给服务器,在服务器发起设备的读取数据和操作,与其他设备联动的逻辑关系调试、OTA升降级调试。
3.5.1 数据收发调试
打开调试界面:
在调试界面中可以进行属性测试、命令下发,操作过程在实时日志中可以查看:
设备上报数据,在设备详情>数据查询可以看到:
# 规则引擎调试
在【接入管理】-【规则引擎】,可以配置联动规则,并进行规则的测试:
在执行记录中可以查看规则的执行情况:
# 产品测试
在产品上线前,需要进行产品性能及全面的功能测试,并准备相应的产品测试报告,然后申请上线。测试报告包括如下内容:
- 功能测试;
- OTA测试;
- 性能测试;
# 产品上线
产品上线前,需要通过厂商测试和广联达验证。产品通过厂商内部测试后,厂商寄送样机到广联达,并提供功能、性能测试报告,待广联达验证后,厂商可以申请发布该产品模型。
产品发布后,便可以进入量产环节。参考《量产相关》章节。
# 设备安装与绑定
用户生产设备后,需要安装到特定的项目,才能在广联达SASS软件中使用。 现场实施或者工程管理人员,可以通过广联达提供的数字项目平台APP,进行设备的安装和绑定。 利用模组的蓝牙功能进行配网。手机打开蓝牙,运行APP,APP搜索附近设备ID,找到对应设备后,提示用户输入现场的WIFI的SSID和KEY,配网成功后,绑定该设备ID到特定的工地项目中。
- 打开【数字项目平台】-【工作台】,在左上角选择需要绑定的项目;
- 确保手机蓝牙打开后,选择 【物联网管理】右上角进行设备搜索;
- APP展现搜索到的设备列表;
- 点击需要绑定的设备,开始进行蓝牙连接,如果设备需要配网,则出现配网界面;
配网成功后,设备自动和项目进行绑定并进行绑定结果的提示。