M0M1 模组AT指令开发

Size: px

Start display at page:

Download "M0M1 模组AT指令开发"

砧曹
5 years ago
Views:

1 M0M1 模组 AT 指令开发例程指南版本 V1.0.0 浙江劢领智能科技有限公司 1

2 版本信息日期版本撰写人修改说明 V1.0.0 HuiHongmei 初稿, 文档排版 2

3 目录第十三章 AT 指令例程简介工程代码代码简析编译下载测试

4 第十三章 AT 指令例程本例程主要包括 :AT 指令集 + 内置 WEB 服务器 + 内置网页 HTML5 和 JS, 其中 AT 指令集是在原来的 at 指令集的基础上 ( 所有的 at 指令使用请参考 M0M100D0 插针式 WI-FI 用户手册 ), 用户还可添加自定义的 at 指令简介 M0M1 模块为 wifi 转串口的透明传输模块, 可以将基于无线局域网 WLAN 的通信信号转给普通 TTL 串行接口的设备, 从而可轻松实现上位机 ( 电脑智能手机等 ) 对下位机 ( 单片机等具有 TTL 串行接口的设备 ) 的无线控制使用 wifi 模块较之普通无线传输具有更大的优点 :wifi 传输距离远大于蓝牙, 而且可以通过不同的 SSID 区分网络, 很多 wifi 网络同时同地工作也不会相互干扰串口 wifi 模块 M0M1 的接线比较简单, 只要接四个引脚,VCC RX TX GND 四根线就行为了实现 M0M1 wifi 模块与 PC 机或 MCU 之间的通讯, 我们需要对 M0M1 模块的参数进行设置, 因此, 可实现途径有 AT 指令集 Web 网页及 app 等, 其中 AT 指令是应用于终端设备与 PC 应用之间的连接与通信的指令 AT 即 Attention 每个 AT 命令行中只能包含一条 AT 指令 ; 对于由终端设备主动向 PC 端报告的 URC 指示或者 response 响应, 也要求一行最多有一个, 不允许上报的一行中有多条指示或者响应 AT 指令以回车作为结尾, 响应或上报以回车换行为结尾送完 AT 指令后, 一般需要等待模块做出响应串口通讯是一种流式通讯, 通讯另一方可能正常相应, 也有可能不能正常响应, 这是就需要对这种情况进行处理 1 可以设置读超时, 如果对方不能正常响应, 则系统会认为与对方通讯失败 2 如果对方成功响应, 那么还需要对对方相应的信息进行判断, 确定串口数据流中的那些是相应自己 AT 指令的数据一般地, 期望的响应都有一定的特征信息, 可以通过判断相应的数据是否包含特征信息来判断例如, 一般当发送一个 AT 指令后, 通常会有一个 OK 作为相应的结尾, 那么就可以通过相应数据是否包含 OK 判断针对自己的响应是否结束或者执行指令出错, 会返回 ERROR, 那么程序就不能一直等待自己期望的特征数据出现, 如遇到 ERROR, 就应该返回报错 3 即使对方能够成功响应, 有时候对方对指令的处理需要一定的时间, 这时候并不能通过一个 read 函数将所有的相应数据都读回因此就需要将每次读回的数据缓存起来, 然后不断的读 4

取数据, 直到期望的特征数据出现为止 4 在不断的读取数据时, 应该在每次读取之间 sleep 一小会, 以保证下次尽量能够读到数据 13.2.

所示图 13-1:SDK 开发包在用户项目工程 proj 文件夹下, 提供了 M0M1 模组的开发例程, 其中包括 :TCP UDP AT MQTT 阿里云物联网套件串口透传等例程, 方便用户使用和学习,

5 取数据, 直到期望的特征数据出现为止 4 在不断的读取数据时, 应该在每次读取之间 sleep 一小会, 以保证下次尽量能够读到数据工程代码在 SDK 工程文件里 :mylinks-m0m1-open-sdk, 通常含有用户工程 proj 头文件 include Lib 静态库及编译烧录生成目录 images 等, 如图 13-1 所示图 13-1:SDK 开发包在用户项目工程 proj 文件夹下, 提供了 M0M1 模组的开发例程, 其中包括 :TCP UDP AT MQTT 阿里云物联网套件串口透传等例程, 方便用户使用和学习, 本篇主要讲述 at 例程, 如图 13-2 所示,AT+ 内置网页服务器的例程序,AT 指令文件 :at_command.c, 用户可添加自己的 AT 指令函数内置网页 php 文件 :php.c, 可以更改内置网页等参数设置图 13-2:AT+ 内置网页服务器代码 5

6 代码简析 main.c 文件在 main.c 文件中, 定义了用户初始化 void user_init(void) 函数, 如图 13-3 所示在这里定义了 M0M1 模块 GPIO8 引脚, 作为 at 指令的 LED 灯显示, 串口初始化以及挂载 mni 文件系统的设置过程, 从而实现串口透传 +AT 指令集 + 内置 WEB 服务器 + 内置网页 HTML5 和 JS 图 13-3: user_init(void) 函数 M0M1 模块出厂默认的 IP 地址是 : , 可在浏览器地址栏中直接输入 : 或者就可直接登陆到 M0M1 模块的内置网页中在 void uart_init (void) 串口初始化函数里, 此时是对 M0M1 模组串口 ur0 进行初始化, 用户可根据需求更改波特率等参数设置, 如图 13-4 串口初始化函数其中 serial_conf() 初始化函数 : 参数 1: 波特率选择,8 表示波特率为 ; 6

$.\mylinks-m0m1-open-sdk\include\user_config.$

7 参数 2: 校验位, 无 ; 参数 3: 停止位,1 位 ; 参数 4: 串口号,UART0 图 13-4: 串口初始化函数本例程借助串口助手工具, 其配置参数如图 13-5 所示图 13-5: 串口助手配置参数 at_command.c 文件用户可在 at_command.c 文件里定义自己 AT 指令, 本例程举例 AT+TEST 指令和固件 web 升级指令设置和查询的程序代码路径..\mylinks-m0m1-open-sdk\include\user_config.h 文件中, 定义了 AT 指令响应返回值以及响应头部及尾部格式, 如图 13-6 所示图 13-6: 定义 AT 指令响应 7

此外, 还定义了标识符, 如图 13-7 所示图 13-7: 标识符在 at_command.

如图 13-9 所示图 13-9: 设置指令本例程, 为用户定义了 AT+UPGRADE

8 此外, 还定义了标识符, 如图 13-7 所示图 13-7: 标识符在 at_command.c 文件中, 在原来 at 指令基础上, 额外的定义了 AT+TEST 指令, 如图 13-8 所示,AT+TEST 查询指令的设置图 13-8: 查询指令设定此外, 设置 AT+TEST 的设置功能, 本例程 AT+TEST=Mylinks 对 M0M1 模块的响应做了简单处理, 如图 13-9 所示图 13-9: 设置指令本例程, 为用户定义了 AT+UPGRADE 指令, 用于升级 M0M1 固件,AT+ WUPDATE 指令, 用于升级 WEB 网页如图所示 8

9 图 13-10: 升级指令用户自定义的 AT 指令, 必须以 {NULL, 0, NULL, NULL} 格式结尾其中 : 参数 1:AT 指令字符, 比如 : WJAP, UPGRADE 等 ; 参数 2: 字符的个数, 比如 : WJAP 是 4 个字符, 因此为 4; 参数 3:AT 指令查询函数 ; 参数 4:AT 指令设置函数如图所示, 将上述设置的 AT 指令, 添加到 at_funtype at_test[] 函数中图 13-11: 添加自定义指令 9

10 php.c 文件 PHP 是一种 HTML 内嵌式的语言, 是一种在服务器端执行的嵌入 HTML 文档的脚本语言其中 m0m1_web_demos_xxx.zip 是 M0M1 AT 标准固件 web server 配套网页, 包括 html 和 js 的代码 ( 可在劢领 QQ 群里及开源 SDK 代码的附件中下载 ) 如图所示, 在 php.c 文件里, 我们给出了 webserver 两个实例, 用户可以结合劢领提供的 Web_demos 及 php.c 等来开发自己所需求来制作自己的 web 网页服务器例程给出了 webserver 两个实例, 一个 static int8_t get_systeminfo(int client) 例子, 和 static int8_t set_wifisystem(int client,webconn *conn) 例子图 13-12:webserver 编译下载利用 make 编译例程 at 文件, 生成 at.img 文件 10

在 SDK 开发包目录下, 编译例程文件 at 文件, 如图 13-13 所示图 13-13: 编译 at 例程利用 mkminifs 编译 webs 文件, 生成 minifs_rom.

zip 开发包目录下, 编译例程文件 web 文件, 如图 13-14 所示图 13-14: 编译 web 例程注 : 具体的编译过程, 请参考文档 :M0M1 模组 SDK 开发环境搭建教程 2 下载使用劢领下载工具

11 在 SDK 开发包目录下, 编译例程文件 at 文件, 如图所示图 13-13: 编译 at 例程利用 mkminifs 编译 webs 文件, 生成 minifs_rom.img 文件, 生成 web 网页在 m0m1_web_demos_xxx.zip 开发包目录下, 编译例程文件 web 文件, 如图所示图 13-14: 编译 web 例程注 : 具体的编译过程, 请参考文档 :M0M1 模组 SDK 开发环境搭建教程 2 下载使用劢领下载工具 Mylink_M0M1_DownloadToolv2.exe, 将编译好的 at 例程生成 at.img 文件, 放入劢领下载工具配置文件里, 选择 /mylinks-m0m1-open-sdk/image/at.img 文件, 以及用户自己设定的 web 网页编程生成的 minifs_rom.img 文件, 如图所示注 : 烧录程序时, 需要将 GPIO6 引脚拉低, 此时,M0M1 模组上的 LED 长亮 ( 有配套开发板 M0-01/12S-WiFi-EVK, 只需将跳帽 J3( 下载 ) 连接即可, 测试时, 将 J3 的跳帽取掉, 重新上 11

12 的即可实现测试 ) 图 13-15: 添加 xxxx.img 文件点击开始, 此时,M0M1 模组自动获取 MAC 地址, 如图所示, 完成下载图 13-16: 完成下载测试将下载好的 M0M1 模块重新上电后, 打开串口助手如图所示, 设置串口的波特率数 12

13 据位停止位校验码等参数配置图 13-17: 串口参数设置由于 M0M1 默认的模式是 : 透传模式, 因此我们需要模式切换, 将 M0M1 模块切换到指令模式下, 我们方可使用 AT 指令集, 如下表所示 1. 透传模式指令模式类型 AT 指令说明 +++ 模块退出透传模式, 进入指令设置模式 a a +ok 模块响应串口发送 a 给模块, 需在 3s 内完成并且此过程不要加换行符设置成功, 即模块进入指令模式成功切换到指令模式下, 我们即可使用 AT 指令集了, 用户可参考数据手册 :M0M10xx0 WI-FI 用户手册本例程除此数据手册的 AT 指令外, 还在.\mylinks-m0m1-open-sdk\proj\at\at_command.c 中设置了 AT+TEST 指令 ( 本例主要检测用户自定义 AT 指令的测试 ) 查询 AT+TEST 指令, 如图所示, 其 M0M1 模块响应值 13

14 图 13-18: 查询 AT+TEST 指令同理, 也可得到 AT+TEST=Mylinks 的设置指令, 如图所示其设置成功后, 则返回 +ok, 否则 +ERR=-1 图 13-19: 设置 AT+TEST 指令 14

15 注 :+ERR=-1, 其数字表示的含义, 如下表所示错误码说明 -1 无效的命令格式 -2 无效的命令 -3 无效的操作符 -4 无效的参数 -5 操作不允许自定义 AT+CHECK 指令为了使用户更加掌握 AT 指令的自定义用法,AT+CHECK 指令只是为了测试使用的, 在 M0M1 模块中本无实际意义如图所示, 设置 AT+CHECK 指令的查询指令, 其返回值 static char *teststr = "Only Test" 图 13-20:AT+CHECK 查询指令同理, 我们设置 AT+CHECK 的设置指令, 当 AT+CHECK= Only Test, 让 M0M1 模块响应 +ok, 或者 AT+CHECK= M0M1 时,M0M1 模块也响应 +ok, 否则, 响应 +ERR=-1 如图所示程序代码图 13-21:AT+CHECK 设置指令 15

AT+CHECK=M0M1 时, 如图 13-23 所示其设置成功后, 则返回 +ok

16 如图所示, 当我们输入 AT+CHECK 查询指令时, 可得到 +ok=only Test 图 13-22: 测试 AT+CHECK 查询指令同理, 设置 AT+CHECK=M0M1 时, 如图所示其设置成功后, 则返回 +ok 也可以设置 AT+CHECK= Only Test 图 13-23: 测试 AT+CHECK 设置指令 16

17 若当 AT+CHECK=only 时, 此时不在 AT+CHECK 设定指令范围内, 因此,M0M1 模块响应错误, 来提示此指令设置错误如图所示图 13-24: 检测 AT+CHECK 设置指令 17

M0M1 模组 smartconfig 例程指南

M0M1 模组 SMARTCONFIG 例程指南版本 V1.0.2 浙江劢领智能科技有限公司 1 版本信息日期版本撰写人修改说明 2017.08.30 V1.0.0 HuiHongmei 初稿, 文档排版 2017.09.05 V1.0.1 HuiHongmei 增加回调函数的使用方式 2018.01.09 V1.0.2 HuiHongmei 修改烧写工具 2 目录第七章 SMARTCONFIG