蓝牙 Mesh 配网模组用户手册(基于 AT 命令) | 《无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案》第七章-阿里云开发者社区

开发者社区> 平头哥芯片开放社区> 正文

蓝牙 Mesh 配网模组用户手册(基于 AT 命令) | 《无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案》第七章

简介: 本节重点介绍 配网模组用户手册(基于 AT 命令)

上一篇:蓝牙 Mesh 灯控开发实例 | 《无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案》第六章>>>
下一篇:蓝牙 Mesh 配网模组的二次开发指南 | 《无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案》第八章>>>

点击免费下载
《无需从0开发 平头哥教你1天上手蓝牙Mesh应用解决方案》>>>

test

1. 概述

1.1 目的

本文主要介绍Mesh配网模块支持的AT指令集,为有Mesh配网需求的开发人员提供帮助。
开发者可以使用配网模块发现,添加未入网设备,对入网设备进行配置,管理。

1.2 名词解释

下面介绍本文中涉及的一些专有名词
image.png

1.3 介绍

本文将会涉及到的如下几部分按章节介绍:
1、AT命令语法
2、AT命令
AT命令将分为如下几个类别
• 基础AT命令
包括通信检查,帮助,复位等功能的AT命令
• Provisioner AT命令
配网相关功能AT命令,包括发现,添加,配置设备等功能
• Mesh Client models AT命令

 包括Config Client model,Generic OnOff Client model,Generic Level Client model,Light Lightness Client model,Light CTL Client model,Vendor Client model的AT命令

3、AT事件
4、AT使用指南
在6.0章节,以灯控为例,介绍了Mesh网络的构建和配置。

2. AT 指令语法

AT命令基于ASCII码编码,以回车符作为结束符。

2.1. AT请求消息格式

AT请求消息格式:AT+OP
AT 请求消息格式
image.png
image.png

2.2 AT 响应消息格式

AT 响应消息为针对 AT 命令的响应。
AT 响应消息格式:+CMD:
或者:
或者上述两者都有。
AT 响应消息格式
image.png

2.3 AT 事件消息格式

AT 事件是设备主动上报的消息
AT 事件格式:+CMD:

image.png

3. AT 指令总览

3.1 AT 控制指令

image.png
image.png
image.png

3.2 AT 事件

image.png
image.png
image.png

4. AT 指令说明

4.1 基础 AT 命令

主要完成 AT 状态测试、设备重启、AT 查询、MESH model 状态查询等功能
4.1.1 AT
基本功能:测试 AT 模块状态
4.1.2 AT+HELP
基本功能:测试 AT 支持地命令
4.1.3 AT+IREBOOT
基本功能:重启设备
4.1.4 AT+RST
基本功能:设备恢复出厂设置
4.1.5 AT+MESHQUERYSTA
基本功能:查询 model 的 status 状态

4.2 Provisioner AT 命令

4.2.1 AT+MESHPROVEN
基本功能:Provisioner 使能
4.2.2 AT+MESHPROVFILTERDEV
基本功能:Provisioner 设置上报过滤
4.2.3 AT+MESHPROVSHOWDEV
基本功能:Provisioner 设备上报功能开启
4.2.4 AT+MESHGETNODEINFO
基本功能:Provisioner 获取本地节点及入网节点信息
4.2.5 AT+MESHADDDEV
基本功能:Provisioner 添加待入网设备
4.2.6 AT+MESHAUTOCONFIG
基本功能:Provisioner 自动配置已入网节点
4.2.7 AT+MESHDELDEV
基本功能:Provisioner 删除待入网设备
4.2.8 AT+MESHOOB
基本功能:Provisioner OOB 输入
4.2.9 AT+MESHSETAPPKEY
基本功能:Provisioner 配置 app key
4.2.10 AT+MESHCLEARRPL
基本功能:清空 RPL 记录

4.3 Config Client model AT 命令

4.3.1 AT+MESHADDAPPKEY
基本功能: 通过 CFG CLI 给 node 节点添加 app key
4.3.2 AT+MESHBINDAPPKEY
基本功能: 通过 CFG CLI 给 node 节点绑定 app key
4.3.3 AT+MESHUNBINDAPPKEY
基本功能: 通过 CFG CLI 给 node 节点解绑 app key
4.3.4 AT+MESHGETCOMP
基本功能: 通过 CFG CLI 获取 node 节点信息
4.3.5 AT+MESHRELAY
基本功能: 通过 CFG CLI 配置 node relay 属性
4.3.6 AT+MESHPROXY
基本功能: 通过 CFG CLI 配置 node proxy 属性
4.3.7 AT+MESHFRIEND
基本功能: 通过 CFG CLI 配置 node friend 属性
4.3.8 AT+MESHGETSUB
基本功能: 通过 CFG CLI 获取 node model sub 属性
4.3.9 AT+MESHSETSUB
基本功能: 通过 CFG CLI 配置 node model sub 属性
4.3.10 AT+MESHDELSUB
基本功能: 通过 CFG CLI 删除 node model sub 地址
4.3.11 AT+MESHGETPUB
基本功能: 通过 CFG CLI 获取 node model pub 属性
4.3.12 AT+MESHSETPUB
基本功能: 通过 CFG CLI 配置 node model pub 属性
4.3.13 AT+MESHRST
基本功能: 通过 CFG CLI 将 node 移除 Mesh 网络

4.4 Generic OnOff Client model AT 命令

4.4.1 AT+MESHONOFF
基本功能: 通过 ONOFF CLI 发送消息

4.5 Generic Level Client model AT 命令

4.5.1 AT+MESHLEVEL
基本功能: 通过 LEVEL CLI 设置 level
4.5.2 AT+MESHLEVELMOVE
基本功能: 通过 LEVEL CLI 设置 level move
4.5.3 AT+MESHLEVELDELTA
基本功能: 通过 LEVEL CLI 发送消息设置 level delta

4.6 Light Lightness Client model AT 命令

4.6.1 AT+MESHLIGHTNESSRANGE
基本功能: 通过 LEVEL CLI 设置 lightness range
4.6.2 AT+MESHLIGHTNESSDEF
基本功能: 通过 LEVEL CLI 设置 lightness default
4.6.3 AT+MESHLIGHTNESS
基本功能: 通过 LEVEL CLI 设置 lightness
4.6.4 AT+MESHLIGHTNESSLIN
基本功能: 通过 LEVEL CLI 设置 lightness linear

4.7 Light CTL Client model AT 命令

4.7.1 AT+MESHCTLTEMPRANGE
基本功能: 通过 LIGHT CTL 设置 light ctl temperature range 状态
4.7.2 AT+MESHCTLDEF
基本功能: 通过 LIGHT CTL 设置 light ctl default 状态
4.7.3 AT+MESHCTL
基本功能: 通过 LIGHT CTL 设置 light ctl 状态
4.7.4 AT+MESHCTLTEMP
基本功能: 通过 LIGHT CTL 设置 light ctl temperature 状态

4.8 Vendor Client model AT 命令

4.8.1 AT+MESHTRS
基本功能: 通过 venodr model cli 透传数据

5 AT 事件

5.1 设备启动事件
5.2 provisioner 扫描设备信息上报事件
5.3 provisioner 扫描设备超时事件
5.4 Provisioner 设备入网失败事件
5.5 Provisioner 设备入网成功事件
5.6 OOB 输入提示事件
5.7 node 节点信息事件
5.8 Mesh Model 上报事件
5.8.1 config model status
5.8.1.1 appkey add status
5.8.1.2 appkey bind status
5.8.1.3 friend status
5.8.1.4 proxy status
5.8.1.5 relay status
5.8.1.6 RST status
5.8.1.7 composition data status
5.8.1.8 mesh sub list status
5.8.1.9 mesh sub set status
5.8.1.10 mesh pub status
5.8.1.11 mesh pub set status
5.9.2 onoff model status
5.9.3 level model status
5.9.4 light lightness model status
5.9.4.1 lightness status
5.9.4.2 lightness linear status
5.9.4.3 lightness range status
5.9.4.4 lightness last status
5.9.5 light ctl model status
5.9.5.1 light ctl status
5.9.5.2 light temperature status
5.9.5.3 ctl temperature range status
5.9.5.4 ctl defalut status
5.9.6 vendor model status
5.9.6.1 透传数据
5.9.6.2 autoconfig status

6. AT 使用指南

6.1 准备工作

3 块开发板,其中 1 块作为 provisioner 节点,2 块作为 Mesh 节点。

6.2 获取未入网设备

image.png

6.3 自动配网

使用自动配网功能,Provisioner 将自动设置绑定所有 model 的 app key,配置订阅
地址和发布地址。
6.3.1 单播地址自动配网
image.png
image.png

6.3.2 组播地址自动配网
image.png

6.4 手动配网

通过单独 AT 命令,配置指定 node 的 app key,绑定对应 model 的 app key,设
置订阅地址和发布地址。
image.png
image.png
image.png

6.5 AT App key 切换

image.png
image.png

6.6 SUB/PUB 地址配置

6.6.1 provisioner pub /node sub
image.png

6.6.2 provisioner sub /node pub
image.png
image.png

7. 附录

7.1 Mesh Model ID 查询表

image.png

7.2 Mesh Model 状态查询表

image.png
image.png

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
平头哥芯片开放社区
使用钉钉扫一扫加入圈子
+ 订阅

芯片开放社区(Open Chip Community 简称OCC),是平头哥芯片基础设施的云端载体,提供开发中心、创芯空间、技术部落等互动版块,汇聚海量应用资源,助力芯片合作伙伴构建软硬融合的芯片生态。面向芯片企业,OCC以应用驱动芯片精准定义、以全栈技术支撑芯片敏捷开发;面向开发者,OCC以芯片生态降低IoT开发门槛、以1520体系加速IoT产品落地。

官方博客
官网链接