Esp8266进阶之路⑨ 【小实战上篇】Windows系统搭建8266的本地Mqtt服务器，局域网点亮一盏LED灯。(带Demo)「建议收藏」

大家好，又见面了，我是你们的朋友全栈君。

• 本系列博客学习由非官方人员 半颗心脏 潜心所力所写，不做开发板。仅仅做个人技术交流分享，不做任何商业用途。如有不对之处，请留言，本人及时更改。

• 很多人怎么联系我一起学习进步，下面打个小小公告和干货无偿分享：

玩转esp8266带你飞、加群付费QQ群，提高门槛，不喜的朋友勿喷勿加：434878850
esp8266源代码免费学习汇总（持续更新，欢迎star）：https://github.com/xuhongv/StudyInEsp8266
esp32源代码免费学习汇总（持续更新，欢迎star）：https://github.com/xuhongv/StudyInEsp32

目录：

文章目录

• • 目录：
  • @[toc]
  • 一、前言。
  • • 1.1 初认识MQTT协议。
  • 二、 Windows系统上集成MQTT服务器。
  • • • 2.1 下载压缩包。
      • 2.2 解压并运行。
      • 2.3 后台进去管理界面。
      • 2.4 管理界面说明。
  • 三、 8266上集成MQTT协议。
  • • 3.1下载官方工程demo并配置。
    • 3.2 配置完毕，烧录和看串口打印信息。
    • 3.3 在服务器查看这设备的消息。
  • 四 其他。

一、前言。

郑重说明：本篇博文的项目，只有在本地下可控制，移动网络不可以控制，因为服务器是部署在本地的！也就是8266和电脑连接在同一个网关路由器下。

• 小项目前需要做好以下基本认识：

• ①、8266需要集成MQTT协议。

• ②、控制端需要集成MQTT协议。包括 web端、ios端或android端。

• ③、本博文选择的服务器选择的是免费的、开源的和好用的MQTT服务器EMQ：http://emqtt.com

1.1 初认识MQTT协议。

问题 ①、MQTT协议究竟是怎么样的一个协议？好处是什么？

• 答： MQTT是IBM开发的一个即时通讯协议。MQTT是面向M2M和物联网的连接协议，采用轻量级发布和订阅消息传输机制。总的来说，就是因为集成简单，消息发布接收迅捷，适合在硬件这些本来有些的空间开发，实现远程控制。

问题 ②、MQTT协议怎么发，怎么收？怎么把消息指定发送到指定的用户？

• 答：为了说明方便，我特意画了一张图：如果图片看不清，设置浏览器缩放大小，把图片放大。

• 

二、 Windows系统上集成MQTT服务器。

2.1 下载压缩包。

前往EMQ下载地址：http://emqtt.com/downloads ，下载您的系统的版本，一般选择稳定版。目前的稳定版最新版是：2.2.0 。本博文用的是2.2.0版本。

2.2 解压并运行。

解压到不带中文字符的目录下，打开Windows的命令行窗口，CD到解压后的目录bin，执行命令：emqttd console，如果启动成功，会弹出控制台窗口。截图如下：

Tips：比如我的解压之后这目录 F:\MQTT\emqttd\bin，那么这样用（如果到最后一步没有回应，那就关闭窗口，再执行这样的操作！一般系统卡顿会造成没响应！）：

C:\Users\xuhong>F:
F:>cd \MQTT\emqttd\bin
F:\MQTT\emqttd\bin>emqttd console

• 注意CD的路径要和解压之后的包一致。
• 启动成功的弹窗会出现以下代码信息：

dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.
mqtt:tcp listen on 127.0.0.1:11883 with 16 acceptors.
mqtt:tcp listen on 0.0.0.0:1883 with 16 acceptors.
mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.
mqtt:ssl listen on 0.0.0.0:8883 with 16 acceptors.
mqtt:wss listen on 0.0.0.0:8084 with 4 acceptors.
mqtt:api listen on 127.0.0.1:8080 with 4 acceptors.
emqttd 2.2 is running now

2.3 后台进去管理界面。

在浏览器打开本地网址：http://127.0.0.1:18083 ，这个网址也可以从上面的弹窗出得到！如图，提示输入账户密码，默认是账户名 admin ，密码public ，输入点击登录。

2.4 管理界面说明。

如下所示，说明您已经大功告成！

三、 8266上集成MQTT协议。

3.1下载官方工程demo并配置。

• 因为乐鑫的SDK的demo已经有MQTT协议的代码了，所以我们拿过来，进一步改下配置就可以啦！下载地址：https://github.com/espressif/ESP8266_NONOS_SDK

• 下载之后就是个压缩包，解压之后，我们首先要做的导入到安信可IDE，（我一直用的是安信可IDE）。

  • 第一步：导入之后，其中给「dirver_lib」文件下面的Makeflie添加bak删除。

  • 第二步：从「example」文件夹中拷贝esp_mqtt_proj文件夹到主目录，截图如下第一张图 , 点击编译按钮，看控制台的 Console 的信息，如果不报错就完成了。恭喜，集成环境第一步完成！

  • 第三步：打开【esp_mqtt_proj】目录下的 mqtt_config.h 文件，截图为下面的第二张图，修改如下：

①、 把STA_SSID和STA_PASS修改为自己路由器的WiFI名和密码；

②、修改MQTT_USER和MQTT_PASS为对应的MQTT服务器的用户名和密码，EMQ服务器默认是admin 和 pubilc；

③、 修改MQTT_HOST和MQTT_PORT为MQTT服务器IP和PORT，目前是使用本地的MQTT服务器，所以是修改为自己电脑的IP地址，注意不是 : 127 . 0 . 0 . 1和MQTT_PORT :1883，关于怎么获取本地的Ip地址，另行百度！；

④、根据MQTT服务器的协议不同，可能需要使用MQTT v3.1.1版本，所以把PROTOCOL_NAMEv31注释掉，使用PROTOCOL_NAMEv311。源码的PROTOCOL_NAMEv311前面没有#define，自己加上就行。

⑤、最后，修改CFG_HOLDER，以让这些配置生效，**直接给原来CFG_HOLDER定义的数值1加后：0x00FF55A5 即可。 **

上图的IPv4的地址就是下面的HOST主机的地址哈！

3.2 配置完毕，烧录和看串口打印信息。

• 在user_main.c文件里面有以下一个方法，订阅了3个主题，同时发布了三则消息到服务器，打印串口如下：

void mqttConnectedCb(uint32_t *args)
{
    MQTT_Client* client = (MQTT_Client*)args;
    INFO("MQTT: Connected\r\n");
   //订阅了一个主题： "/mqtt/topic/0"
    MQTT_Subscribe(client, "/mqtt/topic/0", 0);
    //订阅了一个主题： "/mqtt/topic/1"
    MQTT_Subscribe(client, "/mqtt/topic/1", 1);
    //订阅了一个主题： "/mqtt/topic/2"
    MQTT_Subscribe(client, "/mqtt/topic/2", 2);

    //发布了一则消息，主题是"/mqtt/topic/0",消息是"hello0"
    MQTT_Publish(client, "/mqtt/topic/0", "hello0", 6, 0, 0);
    //发布了一则消息，主题是"/mqtt/topic/01",消息是"hello1"
    MQTT_Publish(client, "/mqtt/topic/1", "hello1", 6, 1, 0);
    //发布了一则消息，主题是"/mqtt/topic/2",消息是"hello2"
    MQTT_Publish(client, "/mqtt/topic/2", "hello2", 6, 2, 0);

}

3.3 在服务器查看这设备的消息。

打开网址 http://127.0.0.1:18083 ,账号 admin ，密码 public 。

点击 Session ，可以看到我们的8266的相关消息，我们看到ID已经在这里，说明已经连接成功。

点击 Topic ，可以看到全部的主题订阅情况。

使用小工具，我们可以验证下8266是否推送消息到达服务器？

• 选择webSocket ,订阅主题是 /mqtt/topic/0 ，也就是8266刚刚发布的消息的主题，重启下8266，让它发送一下至服务器！观察右下角的Message！

四 其他。

故障一：串口打印不断出现以下信息时，莫急莫急！这个是你的HOST地址出错了，请认真再一次核对HOST地址是否和电脑的IPv4地址一致？

your ESP SSL/TLS configuration is -134.[0:NO_TLS	1:TLS_WITHOUT_AUTHENTICATION	2ONE_WAY_ANTHENTICATION	3TWO_WAY_ANTHENTICATION]
TCP: Connect to ip  127.0.0.1:1883
TCP: Reconnect to: 127.0.0.1:1883
TCP: Reconnect to 127.0.0.1:1883

故障二：每次修改配置信息时候，发现都不执行配置信息的代码？那是因为这个Demo是加载到flash的，你要在mqtt_config.h的 宏定义CFG_HOLDER 的值改变一下，加一或减一即可！切记切记！ ：

#define CFG_HOLDER    0x00FF55A2   

• 本篇硬件的Demo下载：http://download.csdn.net/download/xh870189248/10154482