/esp8266_aliyun_mqtt_app

基于ESP8266官方SDK快速接入阿里云物联网平台

Primary LanguageCMIT LicenseMIT

esp8266_aliyun_mqtt_app

基于ESP8266官方SDK接入阿里云物联网平台，只需填入阿里云设备认证三元组即可快速接入。

相关博客：使用ESP8266（基于官方SDK）接入阿里云物联网平台

本人所用的环境

使用步骤

  1. 首先到乐鑫官网或github下载ESP8266_NONOS_SDK；

  2. 下载本仓库，然后拷贝aliyun_mqtt_app文件夹到SDK主目录，用法类似于ESP8266_NONOS_SDK/examples里面的工程；

  3. 在ESP8266 IDE里导入整个SDK，如果不熟悉该环境，参考这里；

  4. 使用SDKv3.0.0还需要修改该SDK的顶层Makefile。编辑器打开该SDK的顶层Makefile，找到下面配置变量，修改SPI_SIZE_MAP为4（如果是使用32Mbit Flash）。

    # ...
# 25行
BOOT?=none
APP?=0
SPI_SPEED?=40
SPI_MODE?=QIO
SPI_SIZE_MAP?=4

    如果不修改，后面编译会报下面错误：

    #error "The flash map is not supported"

  5. 最后编译下载即可（建议先clean）。

project_list

如果想试试用smartconfig配置Wi-Fi信息，可下载smartconfig分支。

配置信息

当在阿里云物联网平台获取到设备认证三元组后，编辑app/include/user_config.h文件，修改下面信息，然后编译下载并重启ESP8266，最后应该就能在控制台看到设备上线了。

注意，阿里云三元组的宏定义，从上到下分别是：产品key，设备name，设备secret。不要拷贝错了。

#define PRODUCT_KEY     "PRODUCT_KEY"

#define DEVICE_NAME     "DEVICE_NAME"
#define DEVICE_SECRET   "DEVICE_SECRET"

#define WIFI_SSID       "WIFI_SSID"
#define WIFI_PASS       "WIFI_PASS"

当ESP8266IDE的Console打印出以下信息，则表示编译成功：

...
!!!
No boot needed.
Generate eagle.flash.bin and eagle.irom0text.bin successully in folder bin.
eagle.flash.bin-------->0x00000
eagle.irom0text.bin---->0x10000
!!!

编译成功

烧写bin

这一步对新手来说可能坑比较多。可参考安信可的烧写步骤，也可参考我ESP8266-Demos仓库里wiki的烧写说明（目前待完善）。

对老手来说，平时怎么烧写就怎么烧写。

主要模块说明

  • mqtt/：mqtt主模块，从官方SDK中的example/esp_mqtt_proj项目移植过来的；
  • user/md5.c：md5加密模块，生成阿里云mqtt password需要用到hmacmd5；
  • user/aliyun_mqtt.c：生成阿里云mqtt信息的核心模块，主要包括mqtt host、mqtt port、mqtt client id、mqtt username以及动态生成的mqtt password；
  • user/user_smartconfig.c：smartconfig模块（smartconfig分支才有），当定义了SMARTCONFIG_ENABLE可以以手机配网的方式给ESP8266连接Wi-Fi。

注意事项

  • 关于串口波特率

    ESP8266串口打印默认为74880bps，如果串口工具没有74880bps也可以选择76800bps。

    或者修改下user/user_main.c/user_init()的代码：

    // ...
void user_init(void) {
    //uart_init(BIT_RATE_74880, BIT_RATE_74880);
    uart_init(BIT_RATE_115200, BIT_RATE_115200);
    //...
}

  • 关于源码文件中的中文乱码

    因为源码文件编码默认为UTF-8，而Windows Eclipse IDE默认为GBK，所以可能需要设置一下：

    菜单栏Window -> Preferences -> General -> Workspace -> 面板Text file encoding -> 选择UTF-8 -> OK

串口打印效果图

MQTT连接阿里云成功：

MQTT连接成功

接收云端下发的命令hello world：

接收云端下发的命令

排错

首先要调试好ESP8266串口能正常打印出信息。一般来说，使用74880bps不会有乱码，使用115200bps，开头一小段会有乱码。

wifi连接失败

如果wifi连接失败，会重复打印下面信息：

下面是表示找不到WIFI_SSID的wifi热点。

no WIFI_SSID found, reconnect after 1s
reconnect
wifi connect fail!
wifi connect fail!
wifi connect fail!
wifi connect fail!
wifi connect fail!
wifi connect fail!
scandone
no WIFI_SSID found, reconnect after 1s
reconnect
wifi connect fail!
wifi connect fail!
wifi connect fail!
wifi connect fail!
wifi connect fail!
scandone
no WIFI_SSID found, reconnect after 1s
wifi connect fail!
reconnect
wifi connect fail!
wifi connect fail!
wifi connect fail!

wifi密码错误及其他原因则不断打印「wifi connect fail!」信息，因为本人没有在代码层面上做更多的判断。

MQTT连接阿里云失败

打印信息：

connected with TP-LINK, channel 13
dhcp client start...
wifi connect fail!
ip:192.168.0.113,mask:255.255.255.0,gw:192.168.0.1
TCP: Connect to domain PRODUCT_KEY.iot-as-mqtt.cn-shanghai.aliyuncs.com:1883
DNS: found ip ******
TCP: connecting...
MQTT: Connected to broker PRODUCT_KEY.iot-as-mqtt.cn-shanghai.aliyuncs.com:1883
MQTT: Sending, type: 1, id: 0000
TCP: Sent
TCP: data received 4 bytes
MQTT: Connected to PRODUCT_KEY.iot-as-mqtt.cn-shanghai.aliyuncs.com:1883
MQTT: Connected
MQTT: queue subscribe, topic"/PRODUCT_KEY/DEVICE_NAME/get", id: 1
MQTT: queuing publish, length: 41, queue size(37/2048)
TCP: Disconnected callback
MQTT: Disconnected

可以看到末尾有TCP/MQTT断开了连接的信息：

...
TCP: Disconnected callback
MQTT: Disconnected

其他补充