M0M1 模组 smartconfig 例程指南

Size: px

Start display at page:

Download "M0M1 模组 smartconfig 例程指南"

钻崩弓
5 years ago
Views:

1 M0M1 模组 SMARTCONFIG 例程指南版本 V1.0.2 浙江劢领智能科技有限公司 1

2 版本信息日期版本撰写人修改说明 V1.0.0 HuiHongmei 初稿, 文档排版 V1.0.1 HuiHongmei 增加回调函数的使用方式 V1.0.2 HuiHongmei 修改烧写工具 2

3 目录第七章 SMARTCONFIG 例程简介 SMARTCONFIG 工作原理工程代码代码简析编译下载测试回调函数的使用

4 第七章 smartconfig 例程 7.1. 简介智能家居家电现阶段还处于普及阶段, 由于家庭 wifi 网络的普及, 目前普遍采用 wifi 与路由器完成连接, 与手机云端进行数据交互智能硬件, 如智能插座智能空调智能空气净化器由于不具备人机交互界面, 不能像电脑一样的搜索选择指定路由器, 输入连接密码的界面, 所以必须先解决正确连接路由问题目前流行的 wifi 配置模式一般有以下 2 种 : 1. 智能硬件处于 AP 模式, 手机用于 station 模式, 手机连接智能硬件, 比如插座的 AP 后组成局域网, 手机发送需要连接路由的 SSID 及密码至智能插座, 智能硬件主动去连接指定路由后, 完成连接 2. 一键配置 (smartconfig) 模式 : 智能硬件处于混杂模式下, 监听网络中的所有报文 ; 手机 APP 将 SSID 和密码编码到 UDP 报文中, 通过广播包或组播报发送, 智能硬件接收到 UDP 报文后解码, 得到正确的 SSID 和密码, 然后主动连接指定 SSID 的路由, 完成连接以上两种方式都可以达到让智能硬件连接至指定路由的效果, 但是 AP 模式需要手动切换手机 wifi 连接的网络, 先连接智能硬件的 AP 网络, 配置完成后再恢复连接正常 wifi 网络有一定的复杂性 ; 但是 smartconfig 由于路由器品牌及手机品牌众多, 存在一定的兼容性问题, 其应用广泛 7.2. Smartconfig 工作原理基于 wifi 技术的设备接入网方法, 也就是我们所说的一键配置 smartconfig, 主要使用 UDP 广播 ( ) 路由器的 SSID 和 KEY 的方法具体说明如下 : M0M1 模组工作在 AP+Station 模式或者 Station 模式 ( 同时处于混杂模式, 可以接收网络上一切包 ), 智能终端如手机 PAD 等工作在 Station 模式, 如图 7-1 所示, 此时 M0M1 模块在 channel1 channel13 之间不断切换, 进行循环监听网络环境中其他智能终端发出的 ssid 和 key 的网络通信数据广播包 ( ) 前导包, 如果收到相关信息, 则停止切换 channel, 继续接收相关信息, 直到全部信息接收完成,M0M1 模组收按照对应的解码规则解析出正确的 SSID 和 KEY 等信息, 配置自身连接到收到的 SSID 上, 然后发送配置成功的信息返回给智能终端, 智能终端收到 M0M1 模组配置上网络的消息后, 显示配置成功 4

5 图 7-1: 原理图本例程主要实现 M0M1 模组一键配置 smartconfig 功能, 为了方便检测 M0M1 模块是否连网成功, 我们建立 TCP 客户端实现 TCP 服务器与客户端之间的数据传输的测试 7.3. 工程代码在 SDK 工程文件里 :mylinks-m0m1-open-sdk, 通常含有用户工程 proj 头文件 include Lib 静态库及编译烧录生成目录 images 等, 如图 7-2 所示图 7-2:SDK 开发包在用户项目工程 proj 文件夹下, 提供了 M0M1 模组的开发例程, 其中包括 :TCP UDP 5

代码简析根据图 7-3 所示, 在 Main.c 文件里包含以下几个函数, 如图 7-4 所示图 7-4:main.

6 AT MQTT 阿里云物联网套件串口透传等例程, 方便用户使用和学习, 本篇主要讲述 smartconfig 例程, 如图 7-3 所示,smartconfig 文件代码图 7-3:smartconfig 例程源代码代码简析根据图 7-3 所示, 在 Main.c 文件里包含以下几个函数, 如图 7-4 所示图 7-4:main.c 中的函数在 void uart_init (void) 串口初始化函数里, 对 M0M1 串口 0 进行初始化, 用户也可更改波 6

7 特率等参数设置, 如图 7-5 串口初始化函数图 7-5: 串口初始化函数本例程借助串口助手工具, 其配置参数如图 7-6 所示图 7-6: 串口助手配置参数 void test_uart0_rev( void * arg) 串口数据接受处理函数, 如图 7-7 所示图 7-7: 串口接受数据函数 7

8 在 static int tcp_client_connect (void) 函数中, 配置了 tcpclient 连接服务器的过程, 用户连接服务器端口号 ( 也就是当前电脑的 IP 地址和端口号 ), 如图 7-8 所示, 本 TCP 服务地址为 : , 端口号 :8080, 修改连接 TCP 服务器的端口号服务器的地址图 7-8: 连接 TCP 服务器在 static void tcpclient( void *arg ) 函数中, 如图 7-9 所示,M0M1 模组等待 SAT 模式下, 获得 IP 地址, 若成功获得, 则启动 client 连接然后, 通过 write() 函数, 将 teststr 字符串通过 write() 函数将 buf 中的 nbytes 字节内容写入文件描述符 fd 而 read() 函数是负责从 fd 中读取内容成功时,read 返回实际所读的字节数 ( 具体请参考 TCP 例程教程, 本图 7-9 只是源代码部分截图, 详细源代码请参考整个例程 ) 8

9 图 7-9: 部分 tcpclient( void *arg ) 函数在 void user_init (void) 用户初始化函数里, 如图 7-10 所示, 用 wifi_set_opmode() 函数设置了 M0M1 模块的组网方式为 AP+STA 模式,smartconfig_start() 函数是开启快连接模式, 快速连接 M0M1 模组,M0M1 抓取空中的特殊的数据包, 包含目标 AP 的 SSID 和 password 信息, 同时, 用户需要通过手机或者电脑广播加密的 SSID 和 password 信息图 7-10:user_init() 函数 9

7.3.2. 编译下载利用 make 编译例程 smartconfig 文件, 生成 smartconfig.img 文件在 SDK 开发包目录下, 即.

MylinkDownloadTool.exe, 将编译好的 smartconfig 例程 smartconfig.

10 编译下载利用 make 编译例程 smartconfig 文件, 生成 smartconfig.img 文件在 SDK 开发包目录下, 即../mylinks-m0m1-open-sdk, 编译例程文件 smartconfig 文件, 如图 7-11 所示图 7-11: 编译 smartconfig 例程 2 下载使用劢领下载工具 MylinkDownloadTool.exe, 将编译好的 smartconfig 例程 smartconfig.img 文件, 放入劢领下载工具配置文件里, 选择 /mylinks-m0m1-open-sdk/image/smartconfig.img 文件, 如图 7-12 所示图 7-12: 添加 smartconfig.img 文件点击开始, 此时,M0M1 模组自动获取 MAC 地址, 如图 7-13 所示, 完成下载 10

图 7-13: 完成下载 7.4. 测试 M0M1 模组所需要的一键 smartconfig 软件是 :OMNICONFIG_omnicfg_v2.

11 图 7-13: 完成下载 7.4. 测试 M0M1 模组所需要的一键 smartconfig 软件是 :OMNICONFIG_omnicfg_v _ , 其下载方式 : 劢领群技术支持群里 ( )/M0M1 系列 WIFI 模组资料其中 Omnicfg 软件的安卓系统开发包是 : OMNICONFIG_omnicfg_v _ 在手机中安装 Omnicfg 软件, 如图 7-14 所示, 得到 Omnicfg 软件的图形界面 11

TCPserver 通讯过程, 在 static void tcpclient( void *arg ) 函数中, 我们定义了 static char *teststr = "Only Test" 字符串, 通过 write () 函数, 将 teststr 字符串通过 write()

12 图 7-14:Omnicfg 软件的图形界面此时, 手机连接到路由器上, 打开 Omnicfg 软件, 点击一键配置按钮并在 Wi-Fi 密码填写路由器密码后点击确定注 : 一键 smartconfig 时, 要确保当前手机已经连接路由器 M0M1 模块此时以上电状态, 在模块 LED 闪烁后点击开始一键配置会出现以下选项, 如图 7-15 所示图 7-15: 设置页面当手机界面提示成功并且 M0M1 模块上的 LED 灯快速闪烁时, 说明 WiFi 模块连接路由器成功当 M0M1 模块成功连接路由器后, 我们就可以实现 TCPclient 和 TCPserver 通讯过程, 在 static void tcpclient( void *arg ) 函数中, 我们定义了 static char *teststr = "Only Test" 字符串, 通过 write () 函数, 将 teststr 字符串通过 write() 函数将 buf 中的 nbytes 字节内容写入文件描述符 fd 成功而 read() 函数是负责从 fd 中读取内容成功时,read 返回实际所读的字节数如图 7-16 所示,M0M1 模组作为 TCPclient 跟 TCPserver 过程 ( 详细请参考 TCP 例程指南 ) 12

$.\mylinks-m0m1-open-sdk\include\mylinks_wifi.$ h 下, 增加了 smartconfig 回调函数 :smartconfig_callback(), 如图 7-16 所示图 7-16: 回调函数在 main.

13 图 7-15: 测试结果 7.5. 回调函数的使用 SDK 开发包工程目录..\mylinks-m0m1-open-sdk\include\mylinks_wifi.h 下, 增加了 smartconfig 回调函数 :smartconfig_callback(), 如图 7-16 所示图 7-16: 回调函数在 main.c 文件中, 增加 smartconfig_cb() 函数, 如图 7-17 所示,smartconfig 的连接过程的返回 int error 值, 来判断是否实现联网状态, 本例程列举了 5 种可能出现的状态, 通过 switch 语句来判断, 然后在通过 uart0_sendstr() 函数进行串口输出 13

14 图 7-17:smartconfig_cb() 函数然后通过用户初始化 user_init() 函数, 回调 smartconfig_callback() 函数, 如图 7-18 所示图 7-18:user_init() 函数通过 Omnicfg 软件, 快速配置 M0M1 模块, 当 M0M1 模块配网成功后, 其返回路由器的名称 :mylinks, 密码 :welcometomylinks 如图 7-19 所示 14

15 图 7-19: 配网成功有时, 在配网过程中, 时间过长时, 则返回错误, 提示你 Omnicfg 配网时间过长, 如图 7-20 所示图 7-20: 测试结果 15

M0M1 模组AT指令开发

M0M1 模组AT指令开发 M0M1 模组 AT 指令开发例程指南版本 V1.0.0 浙江劢领智能科技有限公司 1 版本信息日期版本撰写人修改说明 2017.09.27 V1.0.0 HuiHongmei 初稿, 文档排版 2 目录第十三章 AT 指令例程... 4 13.1. 简介... 4 13.2. 工程代码... 5 13.2.1. 代码简析... 6 13.2.2. 编译下载... 10 13.3. 测试...