概述
文章目录
-
- 一、前言
- 二、创建产品
- 三、产品信息配置
-
-
- 3.1 AT+SYSVER 设置产品系统信息
- 3.2 AT+SYSPRAM 配置产品详细信息
- 3.3 AT+SYSTOKEN 设置产品 token 参数信息
- 3.4 AT+ACKEY 设置 ACKEY 信息
- 3.5 AT+PRODKEY 设置产品密钥
- 3.6 AT+DEVICE 配置产品基本信息,用于设备配网和设备注册
- 3.7 AT+PROFILE设置系统能力
- 3.8 AT+SVCINFO 设置设备服务信息
-
- 四、App设置
- 五、设备控制
-
-
- 5.1 AT+GETSTATE 云端获取设备状态信息
- 5.2 AT+REPORT 上报设备状态信息
-
- 联系我们
一、前言
Hi-12F模组搭载华为海思Hi3861芯片,目前已过HarmonyOS Connect生态模组认证!目前安信可已开发出一套AT固件,使用安信可AT固件有以下优势:
- 可使用华为公版
智慧生活
App对设备进行控制; - 避免二次开发时有可能引入新Bug的风险,导致后期认证不可控;
- 标准模组固件认证可继承,整机测试用例免测,上线周期更短!
二、创建产品
开发者在进行开发前需要在 Device Partner 平台创建产品,并注册一系列基础信息,包括:设备品类 ID、厂商英文简称,并完成功能定义。
产品信息注册网址:
https://devicepartner.huawei.com/console/home
产品定义参考文档:
https://developer.huawei.com/consumer/cn/doc/development/SmartDevicePartnerGuides/product-definition-0000001134540425
根据自己的产品信息填入
通信模组选择博安通Hi-12F
系统类型选择轻量系统
根据自己的需求设置UI界面
添加调试设备
设备SN录入模组的大写不带冒号的MAC地址并保存。测试设备必须录入设备mac地址,否则无法绑定。模组的mac地址用指令AT+MAC?查询
设置模组热点ssid
固件检查与帮助
HiLink SDK版本选择12.0.0.303
下载产品信息表到本地
下载到本地用记事本打开即可
三、产品信息配置
3.1 AT+SYSVER 设置产品系统信息
AT+SYSVER=< buildOS>,< buildVerShow>,< sdkAPILevel>,< FirstAPILevel>,< ohos_version>
参数说明:
< buildOS>:操作系统和操作系统版本号,中间用“-”连接。最长64个字符;
< buildVer>:用户可见软件版本号,最长64个字符;
< sdkAPILevel>:系统软件API version,最长64个字符;
< FirstAPILevel>:系统软件首版本SDK API level,最长64个字符;
< ohos_version>:差异版本号,最长64个字符;
这条指令如果没有什么特别需求的话直接复制示例即可
AT+SYSVER=OpenHarmony,OpenHarmony_release 1.1.0,3,1, OpenHarmony 1.0
3.2 AT+SYSPRAM 配置产品详细信息
AT+SYSPARAM=< manufacture>,< brand>,< market_name>,< product_series>,< product_model>,< software_model>,< hardware_model>,< bootloader_version>,< security_patch_tag>,< abi_list>,< serial>
参数说明:
< manufacture>:企业英文名简称,最长 32 个字符;
< brand>:品牌英文名,最长 32 个字符;
< market_name>:产品名称(传播名),最长 32 个字符;
< product_series>:产品系列,最长 32 个字符;
< product_model>:产品型号,最长 32 个字符;
< software_model>:产品软件版本,最长 32 个字符;
< hardware_model>:产品硬件版本,最长 32 个字符;
< bootloader_version>:当前设备 Bootloader 版本号,最长 64 个字符;
< security_patch_tag>:安全补丁标签,最长 64 个字节;
< abi_list>:Native 接口列表,最长 64 个字符;
< serial>:设备序列号(只能使用 MAC 地址),保持唯一,最长64 个字符。
指令部分参数在产品信息表中的对应关系:
产品序列号用模组的mac地址,mac地址可用指令AT+MAC获取,获取后统一转化为大写不带冒号的mac地址,如指令手册示例所示。其他参数可直接复制指令手册示例。
3.3 AT+SYSTOKEN 设置产品 token 参数信息
token生成方法见官网:
https://device.harmonyos.com/cn/docs/devicepartner/DevicePartner-Guides/device-authorization-0000001134626077
一个设备对应一个token。把生成的token直接复制到“AT+SYSTOKEN=”后面即可
3.4 AT+ACKEY 设置 ACKEY 信息
ACKEY 即产品信息表中的acKey
3.5 AT+PRODKEY 设置产品密钥
PRODKEY 即产品信息表中的prodKey
3.6 AT+DEVICE 配置产品基本信息,用于设备配网和设备注册
AT+DEVICE=< firmware_ver>,< software_ver>,< hardware_ver>,< product_id>,< device_type>,< manuafacturerID >,< device_model>,< device_type_name>,< manuafacturer_name>
参数说明:
< firmware_ver>:固件版本,最长 64 个字符;
< software_ver>:HiLink SDK 版本,最长 32 个字符;
< hardware_ver>:模组硬件版本,最长 32 个字符;
< product_id>:产品 ID,最长 5 字符;
< device_type>:产品类型 ID,最长 4 个字符;
< manuafacturerID>:厂商 ID,最长 4 个字符;
< device_model>:产品型号,最长 32 个字符;
< device_type_name>:设备类型名,和“集成开发环节”ssid 信息中保持一致;
< manuafacturer_name>:厂商名称,和“集成开发环节”ssid 信息中保持一致。
指令部分参数在产品信息表及Device Partner 控制台中的对应关系:
HiLink SDK版本选择12.0.0.303
3.7 AT+PROFILE设置系统能力
按照指令集示例即可
AT+PROFILE=ROM:352K,RAM:2M,WIFI:true
3.8 AT+SVCINFO 设置设备服务信息
下载profile
设置指令
AT+SVCINFO=< svc_info1>,< svc_info2>,…
参数说明:
< svc_info1>:使用键值对的格式输入,< ServiceType>:< sid >。
ServiceType对应priofile文件中的服务类型ServiceType,sid对应服务sid
如上图有两个服务,则指令形式为
AT+SVCINFO=switch:switch,colourMode:mode
设置完以上信息重启后生效
四、App设置
未认证产品不能直接用商用版本智慧生活App配网及控制,我们需要下载debug版本的智慧生活App
打开智慧生活App,进入设置->关于->环境设置,选择认证沙箱
添加设备
配好网后App如果提示未认证兼容性是否继续使用,我们点继续使用即可。如果App无法正常打开设备界面,需要重启下App。
五、设备控制
5.1 AT+GETSTATE 云端获取设备状态信息
AT+GETSTATE=< svc_id>,< payload>,< payload_len>
参数说明:
< svc_id>:物模型功能标识,最长 82 个字符;
< payload>:json 有效负载,最长 82 个字符;
< payload_len>:json 有效负载长度,最长 82 个字符。
设备上电联网成功或通过app控制,云平台会查询设备属性,查询命令为
+COMMAND: GET_STATE, < svc_id>,< payload>,< payload_len>
收到云端获取状态命令后,用户需要通过 AT+GETSTATE 指令回复(三秒内回复,如果没有回复,云端会一直获取属性)。
示例
云端下发
+COMMAND:GET_STATE,switch,(null),0
表示云端需要获取switch的属性,用户需要在用AT+GETSTATE回复设备属性。
通过查询profile文件,我们找到switch这个服务sid对应的属性为on,取值范围为[0,1],这里以on取值为1为例,回复指令应为:
AT+GETSTATE=switch,{"on":1},8
5.2 AT+REPORT 上报设备状态信息
AT+REPORT=< svc_id>,< payload>,< payload_len>
参数说明:
< svc_id>:物模型功能标识,最长 82 个字符;
< payload>:json 有效负载,最长 82 个字符;
< payload_len>:json 有效负载长度,最长 82 个字符。
示例
设备上报开关状态为关闭。查询profile文件可知,开关这个服务sid为switch,对应的属性为on,则上报的指令应为:
AT+REPORT =switch,{"on":0},8
注意
指令AT+GETSTATE和AT+REPORT 类似但作用不同,AT+GETSTATE为云端获取设备状态,在
+COMMAND: GET_STATE, < svc_id>,< payload>,< payload_len>
后面调用;
AT+REPORT 为设备主动上报设备状态。
联系我们
官方官网:https://www.ai-thinker.com
开发DOCS:https://docs.ai-thinker.com
官方论坛:http://bbs.ai-thinker.com
技术支持:support@aithinker.com
最后
以上就是俭朴画板为你收集整理的【 安信可海思Hi-12F模组】AT指令入门教程 && 接入鸿蒙智联的全部内容,希望文章能够帮你解决【 安信可海思Hi-12F模组】AT指令入门教程 && 接入鸿蒙智联所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复