系统环境: ubuntu 16.04 64bit
SDK版本: esp_iot_sdk_v1.3.0
记录时间: 2016年10月13日
联系方式: yexiaopeng1992@126.com
背景:在Esp8266上实现Mqtt,使之可以和Mqtt服务器进行数据通讯,代替原本项目中使用的socket通讯。
一、Mqtt在esp8266上的移植
使用开源工程 esp_mqtt https://github.com/tuanpmt/esp_mqtt
1.下载esp_mqtt 代码
#git clone https://github.com/tuanpmt/esp_mqtt.git
2.将esp_mqtt中关于Mqtt需要的代码添加到自己工程
相关代码:esp_mqtt/mqtt 和 esp_mqtt/modules 下除 Makefile的文件
我将其中的 .h 和 .c 文件分别添加到 项目的 esp_iot_sdk_v1.3.0/app/driver 和 esp_iot_sdk_v1.3.0/app/include/driver下
在将esp_mqtt/include 下的user_config.sample.h文件中的有关配置信息的宏定义复制粘贴到 /esp_iot_sdk_v1.3.0/app/include下
的user_config.h 文件中即可。
3.添加mqtt的顶层代码
将 esp_mqtt/user 下的user_main.c 中除user_init之外的代码复制粘贴到自己的文件中。
4.修改平台相关代码
esp_mqtt项目和网络上的其他一些项目关于Mqtt&esp8266基本是基于NONOS_SDK的,与我项目中使用的esp_iot_sdk不同,因此在esp_mqtt
的代码中会有部分函数是esp_iot_sdk没有的,需要修改为esp_iot_sdk中相同功能的函数。
如将 mqtt_tcpclient_delete() 函数中 espconn_abort 替换为 espconn_disconnect,两者的功能皆为断开TCP连接
再将新添加的 mqtt相关代码的 头文件路径做修改后就能正常编译了。
二、Mqtt服务器搭建(仅测试)
http://makerpro.cc/2016/02/use-esp8266-and-mqtt-to-transfer-iot-data/ 或者
http://regishsu.blogspot.tw/2016/02/study-esp8266-notemcu-mqtt-study02xx.html
参考其关于服务器的搭建和测试方式即可
三、修改esp8266关于Mqtt的配置
user_config.h中,原始配置
#define MQTT_HOST "192.168.0.101" //or "mqtt.yourdomain.com"
#define MQTT_PORT 1883
#define MQTT_BUF_SIZE 1024
#define MQTT_KEEPALIVE 120 /*second*/ #define MQTT_CLIENT_ID "CLIENT_1234"
#define MQTT_USER "USER"
#define MQTT_PASS "PASS"
#define MQTT_CLEAN_SESSION 1
#define MQTT_KEEPALIVE 120 #define STA_SSID "SSID"
#define STA_PASS "PASS" #define MQTT_RECONNECT_TIMEOUT 5 /*second*/ #define DEFAULT_SECURITY 0
#define QUEUE_BUFFER_SIZE 2048 #define PROTOCOL_NAMEv31
其中主要修改 MQTT_HOST 为 Mqtt 服务器地址, STA_SSID 和STA_PASS 为 wifi的名称和密码即可,其他配置根据自己情况修改。
四、修改esp8266中与Mqtt服务器的数据接收和发送
就两个函数
MQTT_Publish():发送消息到Mqtt 服务器
mqttDataCb(): 接收到Mqtt消息的回调函数
说明:一开始esp8266和服务器可以正常连接,但按照 Mqtt服务器测试参考的链接(见上文)中的提供的方式,esp8266无法和服务器做数据通讯,回来将 esp_mqtt 中 /mqtt/topic/0 改为 和链接中一样为 hello/world 后可以数据通讯了(具体原因应该和Mqtt有关,此时未学习mqtt,故不知道原因)
例子
MQTT_Publish(&mqttClient, "hello/world", "mhjjs7", 6, 0, 0);