ESP8266环境搭建和部署MQTT测试代码

lili821

一. 环境搭建

1.安装安信可提供的eclipse开发环境包，参考如何安装安信可一体化开发环境。

2.下载 ESP8266_RTOS_SDK 的开发包。

• 复制 examples/project_template 到项目根目录，更名为 app，删除里面的 sample_lib 文件夹。
• 把 driver_lib 和 extra_include 目录放到 examples 里，暂时项目不用。
• 将 third_party/makefile 重命名为 makefile.bak，暂时项目不用。
  

RTOS原始目录结构

RTOS修改后目录结构

3.导入项目

• eclipse中选择 File-->Import，选择 C/C++ 分支，选择 Existing Code as Makefile Project
• 配置项目名称、RTOS工程所在目录和选择合适的交叉编译器
  

4.配置项目
打开 app 目录下 Makefile 文件，添加和配置代码

1. # 在此处添加如下代码
   
2. #EXTRA_CCFLAGS += -u
   
3. parent_dir:=$(abspath $(shell pwd)/$(lastword $(MAKEFILE_LIST)))
   
4. parent_dir:=$(shell dirname $(parent_dir))
   
5. parent_dir:=$(shell dirname $(parent_dir))
   
6. 
   
7. SDK_PATH= $(parent_dir)
   
8. BIN_PATH=$(SDK_PATH)/bin

复制代码

1. # 因为开始我们删除了 sample_lib 目录，所以我们要在去除多余的配置
   
2. # 当我们项目需要更多子目录的时候，我们还会在这里添加相应的配置
   
3. 
   
4. SUBDIRS=    \
   
5.     user    \
   
6. #去除 sample_lib
   
7. 
   
8. ...
   
9. 
   
10. COMPONENTS_eagle.app.v6 = \
    
11.     user/libuser.a  \
    
12. # 去除    sample_lib/libsample.a

复制代码

5.编译程序
右键目标项目-->Build Project，编译成功之后在 Console 中可以看到显示出对应的应用文件的下载地址。


二. 部署MQTT测试代码

参考和使用了一个github上的库 ESP-RTOS-MQTT，对他的目录结构和测试代码做了一些修改，修改之后的整个项目可参考 esp8266-rtos-mqtt，对修改的地方稍作介绍，仍然在上面配置好的工程中操作。

• 复制参考库中的 examples/echo_example/user/user_main.c 替换本项目中的 app/user/user_main.c，配置本地WiFi AP信息。
  

1. // 配置AP信息
   
2. #define AP_SSID "ssid"
   
3. #define AP_PASSWORD "password"
   
4. 
   
5. ...
   
6. 
   
7. void wifi_task(void *pvParameters)
   
8. {
   
9.     struct station_config sta_config;
   
10.     struct ip_info ip_config;
    
11.     bzero(&sta_config, sizeof(struct station_config));
    
12.     // 配置AP信息
    
13.     sprintf(sta_config.ssid, AP_SSID);
    
14.     sprintf(sta_config.password, AP_PASSWORD);
    
15.     wifi_station_set_config(&sta_config);
    

复制代码

• 复制参考库中的 lib 目录到本项目的 app 中，在 app/lib 目录中新建 Makefile 文件并添加配置
  

1. ifndef PDIR
   
2. UP_EXTRACT_DIR = ..
   
3. GEN_LIBS = libcomm.a
   
4. COMPONENTS_libcomm = MQTTClient/libmqttclient.a \
   
5.                      MQTTPacket/libmqttpacket.a
   
6. endif
   
7. 
   
8. 
   
9. INCLUDES := $(INCLUDES) -I $(PDIR)include
   
10. INCLUDES += -I ./
    
11. PDIR := ../$(PDIR)
    
12. sinclude $(PDIR)Makefile

复制代码

• 在 app/lib/MQTTClient 中新建 Makefile 文件并添加配置
  

1. ifndef PDIR
   
2. GEN_LIBS = libmqttclient.a
   
3. endif
   
4. 
   
5. INCLUDES := $(INCLUDES) -I $(PDIR)include
   
6. INCLUDES += -I ./
   
7. PDIR := ../$(PDIR)
   
8. sinclude $(PDIR)Makefile

复制代码

• 在 app/lib/MQTTPacket 中新建 Makefile 文件并添加配置
  

1. ifndef PDIR
   
2. GEN_LIBS = libmqttpacket.a
   
3. endif
   
4. 
   
5. INCLUDES := $(INCLUDES) -I $(PDIR)include
   
6. INCLUDES += -I ./
   
7. PDIR := ../$(PDIR)
   
8. sinclude $(PDIR)Makefile

复制代码

测试项目中用到了串口UART，所以还要引入UART的驱动文件

• 在 app 目录中新建 driver/include 文件夹，复制 examples/driver_lib/include/uart.h 到 app/driver/include，复制 examples/driver_lib/driver/uart.c 到 app/driver。
• 在 app/driver 中新建 Makefile 文件并添加配置
  

1. ifndef PDIR
   
2. GEN_LIBS = libdriver.a
   
3. endif
   
4. 
   
5. INCLUDES := $(INCLUDES) -I $(PDIR)include
   
6. INCLUDES += -I ./
   
7. PDIR := ../$(PDIR)
   
8. sinclude $(PDIR)Makefile

复制代码

• 因为在项目新建了几个目录和文件，需要最后配置 app/Makefile
  

1. # 添加子目录
   
2. SUBDIRS=    \
   
3.     user    \
   
4.     driver  \
   
5.     lib
   
6. 
   
7. ...
   
8. 
   
9. # 添加静态链接库
   
10. COMPONENTS_eagle.app.v6 = \
    
11.     user/libuser.a  \
    
12.     driver/libdriver.a  \
    
13.     lib/libcomm.a
    
14. 
    
15. ...
    
16. 
    
17. # 添加头文件路径
    
18. INCLUDES := $(INCLUDES) -I $(PDIR)include
    
19. INCLUDES += -I $(PDIR)/driver/include   \
    
20.             -I $(PDIR)/lib/MQTTClient/include   \
    
21.             -I $(PDIR)/lib/MQTTPacket/include

复制代码

最终配置好的整个项目的目录树

1. │  gen_misc.bat
   
2. │  gen_misc.sh
   
3. │  Makefile
   
4. │  readme.txt
   
5. │
   
6. ├─driver
   
7. │  │  Makefile
   
8. │  │  uart.c
   
9. │  │
   
10. │  └─include
    
11. │          uart.h
    
12. │
    
13. ├─include
    
14. │      user_config.h
    
15. │
    
16. ├─lib
    
17. │  │  Makefile
    
18. │  │
    
19. │  ├─MQTTClient
    
20. │  │  │  Makefile
    
21. │  │  │  MQTTClient.c
    
22. │  │  │  MQTTESP8266.c
    
23. │  │  │
    
24. │  │  └─include
    
25. │  │          MQTTClient.h
    
26. │  │          MQTTESP8266.h
    
27. │  │
    
28. │  └─MQTTPacket
    
29. │      │  Makefile
    
30. │      │  MQTTConnectClient.c
    
31. │      │  MQTTConnectServer.c
    
32. │      │  MQTTDeserializePublish.c
    
33. │      │  MQTTFormat.c
    
34. │      │  MQTTPacket.c
    
35. │      │  MQTTSerializePublish.c
    
36. │      │  MQTTSubscribeClient.c
    
37. │      │  MQTTSubscribeServer.c
    
38. │      │  MQTTUnsubscribeClient.c
    
39. │      │  MQTTUnsubscribeServer.c
    
40. │      │
    
41. │      └─include
    
42. │              MQTTConnect.h
    
43. │              MQTTFormat.h
    
44. │              MQTTPacket.h
    
45. │              MQTTPublish.h
    
46. │              MQTTSubscribe.h
    
47. │              MQTTUnsubscribe.h
    
48. │              StackTrace.h
    
49. │
    
50. └─user
    
51.         Makefile
    
52.         user_main.c
    
53. 
    

复制代码

三. 程序烧写和启动

• ESP官方烧写工具下载 flash_download_tools，解压后直接可以双击运行。选择 ESP8266 DownloadTool
  

烧写工具配置

一共需要下载四个文件，都在RTOS项目的 bin 目录下

文件                                                 地址
bin/eagle.flash.bin                        0x00000
bin/eagle.irom0text.bin                0x20000
bin/esp_init_data_default.bin       0x3fc000
bin/blank.bin                                0x3fe000

COM串口选择需要对应ESP8266插入电脑的串口号，波特率可以自由选择，不要超过串口芯片极限值就可以。

2.下载串口驱动程序开始烧写程序
根据自己的串口芯片下载，目前使用的时CP2102的驱动芯片，可以下载 CP210x_Windows_Drivers，直接解压安装就可以，如果安装成功，插入USB之后不显示串口号，需要重新启动电脑。


ESP8266开发板

打开烧写软件，按照上述配置选择对应的串口，然后点击烧写软件上的 START 按钮就可以自动下载，等待下载完成，点击复位按键就可以启动程序。

如果确定配置都正确，点击 START 没有执行下载，可以按住ESP8266开发板的烧写按键不松开，然后再按一下复位按键。

若想查看串口调试信息和输出内容，需要下载 串口调试工具，在端口号一栏选择对应的串口号，波特率那一栏选择和程序中匹配的波特率，之后就可以打开串口查看输出。

串口调试工具


作者：Kake
來源：简书

feixiang20

iwha

初学者，谢谢