20A-ESP8266__RTOS_SDK__Programming Guide__CN.pages

Transcription

1 ESP8266 RTOS SDK 编程 手册 版本 1.5 版权 2017

2 关于本 手册 本 文档提供 ESP8266_RTOS_SDK 的编程示例例 文档结构如下 : 章节 标题 内容 第 1 章 前 言 介绍 ESP8266EX 第 2 章 概述 介绍 RTOS SDK 和编程注意事项 第 3 章 编程示例例 提供基于 ESP8266_RTOS_SDK 编程的示例例 第 4 章 附录 提供基于 ESP8266_RTOS_SDK 开发的补充说明 发布说明 日期 版本 发布说明 V1.4 首次发布 V1.5 基于 ESP8266_RTOS_SDK v1.5.0 的重 大更更新 V1.5 更更新章节 2.2

3 目录 1. 前 言 概述 RTOS SDK 简介 编程注意事项 RTOS SDK 目录结构 基本示例例 初始化 如何读取芯 片 ID ESP8266 作为 Station 连接路路由 ESP8266 作为 SoftAP 模式 Wi-Fi 连接状态的事件 读取和设置 ESP8266 MAC 地址 扫描附近 AP 获取 AP 的射频信号强度 (RSSI) 从 Flash 读取数据 RTC 使 用示例例 非 OS SDK app 如何移植为 RTOS SDK app 网络协议示例例 UDP 传输 TCP Client TCP Server 高级应 用示例例 OTA 固件升级... 25

4 强制休眠示例例 SPIFFS 文件系统应 用 SSL 应 用示例例 A. 附录 A.1. Sniffer 说明 A.2. ESP8266 SoftAP 和 Station 信道定义 A.3. ESP8266 启动信息说明... 36

5 1. 前 言 1. 前 言 ESP8266EX 由乐鑫公司开发, 提供了了 一套 高度集成的 Wi-Fi SoC 解决 方案, 其低功耗 紧凑设计和 高稳定性可以满 足 用户的需求 ESP8266EX 拥有完整的且 自成体系的 Wi-Fi 网络功能, 既能够独 立应 用, 也可以作为从机搭载于其他主机 MCU 运 行行 当 ESP8266EX 独 立应 用时, 能够直接从外接 Flash 中启动 内置的 高速缓冲存储器器有利利于提 高系统性能, 并且优化存储系统 此外 ESP8266EX 只需通过 SPI/SDIO 接 口或 I2C/UART 口即可作为 Wi-Fi 适配器器, 应 用到基于任何微控制器器的设计中 ESP8266EX 集成了了天线开关 射频 balun 功耗放 大器器 低噪放 大器器 过滤器器和电源管理理模块 这样紧凑的设计仅需极少的外部电路路并且将 PCB 的尺 寸降到最 小 ESP8266EX 还集成了了增强版的 Tensilica s L106 钻 石系列列 32-bit 内核处理理器器, 带 片上 SRAM ESP8266EX 可以通过 GPIO 外接传感器器和其他设备 软件开发包 (SDK) 提供了了 一些应 用的示例例代码 乐鑫智能互联平台 (ESCP-Espressif Systems Smart Connectivity Platform) 表现出来的领先特征有 : 睡眠 / 唤醒模式之间的快速切换以实现节能 配合低功耗操作的 自适应射频偏置 前端信号的处理理功能 故障排除和射频共存机制可消除蜂窝 / 蓝 牙 /DDR/LVDS/LCD 干扰 基于 ESP8266EX 物联 网平台的 SDK 为 用户提供了了 一个简单 快速 高效开发物联 网产品的软件平台 本 文旨在介绍该 SDK 的基本框架, 以及相关的 API 接 口 主要的阅读对象为需要在 ESP8266EX 物联 网平台进 行行软件开发的嵌 入式软件开发 人员 Espressif 1/37

6 2. 概述 2. 概述 2.1. RTOS SDK 简介 SDK 为 用户提供了了 一套数据接收 发送的函数接 口, 用户不不必关 心底层 网络, 如 Wi-Fi TCP/IP 等的具体实现, 只需要专注于物联 网上层应 用的开发, 利利 用相应接 口完成 网络数据的收发即可 ESP8266 物联 网平台的所有 网络功能均在库中实现, 对 用户不不透明 用户应 用的初始化功能可以在 user_main.c 中实现 void user_init(void) 是上层程序的 入 口函数, 给 用户提供 一个初始化接 口, 用户可在该函数内增加硬件初始化 网络参数设置 定时器器初始化等功能 2.2. 编程注意事项 建议使 用定时器器实现 长时间的查询功能, 可将定时器器设置为循环调 用, 注意 : - 定时器器 (freertos timer 或 os_timer) 执 行行函数内部请勿使 用 while(1) 或其他能阻塞线程的 方式延时, 例例如, 不不能在定时器器回调中进 行行 socket send 操作, 因为 send 函数会阻塞线程 ; - 定时器器回调执 行行请勿超过 15 ms; - os_timer_t 建 立的变量量不不能为局部变量量, 必须为全局变量量 静态变量量或 os_malloc 分配的指针 从 ESP8266_RTOS_SDK_v1.2.0 起, 无需添加宏 ICACHE_FLASH_ATTR, 函数将默认存放在 CACHE 区, 中断函数也可以存放在 CACHE 区 ; 如需将部分频繁调 用的函数定义在 RAM 中, 请在函数前添加宏 IRAM_ATTR; 网络编程使 用通 用的 socket 编程, 网络通信时,socket 请勿绑定在同 一端 口 ; freertos 操作系统及系统 自带的 API 说明请参考 RTOS SDK 的系统任务最 高优先级为 14, 创建任务的接 口 xtaskcreate 为 freertos 自带接 口, 使 用 xtaskcreate 创建任务时, 任务堆栈设置范围为 [176, 512] - 在任务内部如需使 用 长度超过 60 的 大数组, 建议使 用 os_malloc 和 os_free 的 方式操作, 否则, 大数组将占 用任务的堆空间 ; - SDK 底层已占 用部分优先级 :watchdog task 优先级 14,pp task 优先级 13, 高精度 timer (ms) 线程优先级 12,TCP/IP task 优先级 10,freeRTOS timer 优先级 2,Wi-Fi event 优先级为 2,idle task 优先级为 0; Espressif 2/37

7 2. 概述 - 可供 用户任务使 用的优先级为 1 ~ 9; 但注意, 用户任务请勿始终占 用 CPU, 导致低优先级的系统任务 无法执 行行 ; - 请勿修改 FreeRTOSConfig.h, 此处修改头 文件并不不能 生效, 设置由 SDK 库 文件决定 Espressif 3/37

8 3.1. RTOS SDK 目录结构 ESP8266 RTOS SDK 下载链接为 :ESP8266 RTOS SDK 以下为 RTOS SDK 目录结构 bin: 乐鑫官 方提供的 boot 和初始化参数固件 documents:esp8266_rtos_sdk 文档资料料 driver_lib: 乐鑫官 方提供的驱动示例例代码 examples: 乐鑫提供的应 用程序示例例代码 - openssl_demo: 乐鑫官 方提供的 OpenSSL 接 口功能示例例代码 - project_template: 乐鑫官 方提供的 工程模板示例例代码 - smart_config: 乐鑫官 方提供的 SmartConfig 功能示例例代码 - spiffs_test: 乐鑫官 方提供的 SPIFFS 文件系统功能示例例代码 - websocket_demo: 乐鑫官 方提供的 WebSocket 功能示例例代码 include:esp8266_rtos_sdk 的头 文件, 包含了了供 用户使 用的软件接 口和宏定义 ld: 编译时使 用的链接 文件, 用户 一般 无需修改 lib:esp8266_rtos_sdk 的库 文件 third_party: 乐鑫开放源代码的第三 方库, 当前包含 freertos JSON lwip, mbedtls nopoll OpenSSL SPIFFS 和 SSL tools: 工具, 用户 无需修改 3.2. 基本示例例 基本示例例包含如下 : 初始化 如何读取芯 片 ID 如何设置 Wi-Fi 工作模式 - ESP8266 作为 Station 模式, 连接路路由 - ESP8266 作为 SoftAP 模式, 可供其他 Station 连接 Espressif 4/37

9 Wi-Fi 连接状态的事件 如何读取和设置芯 片 MAC 地址 如何扫描附近的 AP 如何获取 AP 的 RF 信号强度 (RSSI) 如何从 Flash 读写数据 RTC 使 用示例例 非 OS SDK app 如何移植为 RTOS SDK app 初始化 1. 应 用程序的初始化可在 user_main.c 中实现 void user_init(void) 是上层程序的 入 口函数, 用户可在该函数内实现初始化操作, 建议打印 SDK 版本号, 并设置 Wi-Fi 工作模式 void user_init(void) printf("sdk version:%s\n", system_get_sdk_version()); /* station + soft-ap mode */ wifi_set_opmode(stationap_mode); 2. ESP8266_RTOS_SDK 默认使 用 UART0 打印调试信息, 默认波特率为 用户可以在 user_init 中 自定义初始化 UART, 参考 uart_init_new 实现 UART 驱动示例例 :\ESP8266_RTOS_SDK\driver_lib\driver\uart.c 以初始化 UART0 为例例 定义 UART 参数 : UART_ConfigTypeDef uart_config; uart_config.baud_rate = BIT_RATE_74880; uart_config.data_bits = UART_WordLength_8b; uart_config.parity = USART_Parity_None; uart_config.stop_bits = USART_StopBits_1; uart_config.flow_ctrl = USART_HardwareFlowControl_None; uart_config.uart_rxflowthresh = 120; uart_config.uart_inversemask = UART_None_Inverse; UART_ParamConfig(UART0, &uart_config); 注册 UART 中断处理理函数, 使能 UART 中断 : UART_IntrConfTypeDef uart_intr; Espressif 5/37

10 uart_intr.uart_intrenmask = UART_RXFIFO_TOUT_INT_ENA UART_FRM_ERR_INT_ENA UART_RXFIFO_FULL_INT_ENA UART_TXFIFO_EMPTY_INT_ENA; uart_intr.uart_rx_fifofullintrthresh = 10; uart_intr.uart_rx_timeoutintrthresh = 2; uart_intr.uart_tx_fifoemptyintrthresh = 20; UART_IntrConfig(UART0, &uart_intr); UART_SetPrintPort(UART0); UART_intr_handler_register(uart0_rx_intr_handler); ETS_UART_INTR_ENABLE(); 3. ESP8266_RTOS_SDK 支持多线程, 可以建 立多个任务 创建任务的接 口 xtaskcreate 为 freertos 自带接 口, 使 用 xtaskcreate 创建任务时, 任务堆栈设置范围为 [176, 512] xtaskcreate(task2, "tsk2", 256, NULL, 2, NULL); xtaskcreate(task3, "tsk3", 256, NULL, 2, NULL); 注册任务执 行行函数, 以 task2 为例例 : void task2(void *pvparameters) printf("hello, welcome to task2\r\n"); while (1) vtaskdelete(null); 4. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 5. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : SDK version:1.0.3(601f5cd) mode : sta(18:fe:34:97:f7:40) + softap(1a:fe:34:97:f7:40) Hello, welcome to task2 Hello, welcome to task 如何读取芯 片 ID 1. 软件接 口介绍 : system_get_chip_id 返回硬件模组的 ESP8266 芯 片 ID 值 ESP8266 芯 片 ID 具有唯 一性 printf("esp8266 chip ID:0x%x\n", system_get_chip_id()); Espressif 6/37

11 2. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 3. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : ESP8266 chip ID:0x97f ESP8266 作为 Station 连接路路由 1. 设置 ESP8266 为 Station 模式, 或者 Station+SoftAP 共存模式 wifi_set_opmode(station_mode); 2. 设置连接 AP 的信息 #define DEMO_AP_SSID "DEMO_AP" #define DEMO_AP_PASSWORD " " wifi_station_set_config 设置 ESP8266 Station 连接 AP 的信息 请注意将 station_config 中的 bssid_set 初始化为 0, 除 非需要指定 AP MAC 地址的情况才设 置为 1 wifi_station_connect 设置连接路路由 struct station_config * config = (struct station_config *)zalloc(sizeof(struct station_config)); sprintf(config->ssid, DEMO_AP_SSID); sprintf(config->password, DEMO_AP_PASSWORD); wifi_station_set_config(config); free(config); wifi_station_connect(); 3. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 4. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : connected with DEMO_AP, channel 11 dhcp client start... ip: ,mask: ,gw: ESP8266 作为 SoftAP 模式 1. 必须先设置 ESP8266 为 SoftAP 模式, 或者 Station+SoftAP 共存模式 wifi_set_opmode(softap_mode); 2. 设置 ESP8266 SoftAP 的配置 Espressif 7/37

12 #define DEMO_AP_SSID "DEMO_AP" #define DEMO_AP_PASSWORD " " struct softap_config *config = (struct softap_config *)zalloc(sizeof(struct softap_config)); // initialization wifi_softap_get_config(config); // Get soft-ap config first. sprintf(config->ssid, DEMO_AP_SSID); sprintf(config->password, DEMO_AP_PASSWORD); config->authmode = AUTH_WPA_WPA2_PSK; config->ssid_len = 0; // or its actual SSID length config->max_connection = 4; wifi_softap_set_config(config); free(config); // Set ESP8266 soft-ap config 3. 查询连接到 ESP8266 SoftAP 的 Station 的信息 struct station_info * station = wifi_softap_get_station_info(); while(station) printf(bssid : MACSTR, ip : IPSTR/n, MAC2STR(station->bssid), IP2STR(&station->ip)); station = STAILQ_NEXT(station, next); wifi_softap_free_station_info(); // Free it by calling functions 4. ESP8266 SoftAP 的默认 IP 地址为 , 开发者可以更更改 ESP8266 SoftAP 的 IP 地址, 请注意, 先关闭 DHCP server 功能 例例如, 设置 ESP8266 SoftAP 的 IP 地址为 wifi_softap_dhcps_stop(); // disable soft-ap DHCP server struct ip_info info; IP4_ADDR(&info.ip, 192, 168, 5, 1); IP4_ADDR(&info.gw, 192, 168, 5, 1); IP4_ADDR(&info.netmask, 255, 255, 255, 0); wifi_set_ip_info(softap_if, &info); // set IP // set gateway // set netmask 5. 开发者可以设置 ESP8266 SoftAP 分配给连 入 Station 的 IP 地址范围 例例如, 设置 IP 池范围为 : 到 请注意, 设置完成后, 再打开 DHCP server 功能 struct dhcps_lease dhcp_lease; IP4_ADDR(&dhcp_lease.start_ip, 192, 168, 5, 100); Espressif 8/37

13 IP4_ADDR(&dhcp_lease.end_ip, 192, 168, 5, 105); wifi_softap_set_dhcps_lease(&dhcp_lease); wifi_softap_dhcps_start(); // enable soft-ap DHCP server 6. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 7. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 使 用 PC 或者其他 Station 连接 ESP8266 SoftAP 运 行行结果 : ESP8266 作为 SoftAP 时, 如有 Station 连 入, 则打印如下信息 : station: c8:3a:35:cc:14:94 join, AID = Wi-Fi 连接状态的事件 1. 当 ESP8266 作为 Station 连接路路由, 或者 ESP8266 作为 SoftAP 时, 可由 wifi_set_event_handler_cb 注册 Wi-Fi 事件的回调 2. 示例例代码 : void wifi_handle_event_cb(system_event_t *evt) printf("event %x\n", evt->event_id); switch (evt->event_id) case EVENT_STAMODE_CONNECTED: printf("connect to ssid %s, channel %d\n", evt->event_info.connected.ssid, evt->event_info.connected.channel); break; case EVENT_STAMODE_DISCONNECTED: printf("disconnect from ssid %s, reason %d\n", evt->event_info.disconnected.ssid, evt->event_info.disconnected.reason); break; case EVENT_STAMODE_AUTHMODE_CHANGE: printf("mode: %d -> %d\n", evt->event_info.auth_change.old_mode, evt->event_info.auth_change.new_mode); Espressif 9/37

14 break; case EVENT_STAMODE_GOT_IP: printf("ip:" IPSTR ",mask:" IPSTR ",gw:" IPSTR, IP2STR(&evt->event_info.got_ip.ip), IP2STR(&evt->event_info.got_ip.mask), IP2STR(&evt->event_info.got_ip.gw)); printf("\n"); break; case EVENT_SOFTAPMODE_STACONNECTED: printf("station: " MACSTR "join, AID = %d\n", MAC2STR(evt->event_info.sta_connected.mac), evt->event_info.sta_connected.aid); break; case EVENT_SOFTAPMODE_STADISCONNECTED: printf("station: " MACSTR "leave, AID = %d\n", MAC2STR(evt->event_info.sta_disconnected.mac), evt->event_info.sta_disconnected.aid); break; default: break; void user_init(void) // TODO: add user s own code here... wifi_set_event_handler_cb(wifi_handle_event_cb); 3. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 4. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : 例例如,ESP8266 Station 连 入路路由器器的过程如下 : wifi_handle_event_cb : event 1 connect to ssid Demo_AP, channel 1 wifi_handle_event_cb : event 4 IP: ,mask: ,gw: wifi_handle_event_cb : event 2 disconnect from ssid Demo_AP, reason 8 Espressif 10/37

15 读取和设置 ESP8266 MAC 地址 1. ESP8266 可以 工作在 Station+SoftAP 共存模式,Station 接 口和 SoftAP 接 口的 MAC 地址不不同 乐鑫保证芯 片出 厂的默认 MAC 地址的唯 一性, 用户如果重新设置 MAC 地址, 则需要 自 行行确保 MAC 地址的唯 一性 2. 设置 ESP8266 为 Station+SoftAP 共存模式 wifi_set_opmode(stationap_mode); 3. 分别读取 Station 接 口和 SoftAP 接 口的 MAC 地址 wifi_get_macaddr(softap_if, sofap_mac); wifi_get_macaddr(station_if, sta_mac); 4. 分别设置 Station 接 口和 SoftAP 接 口的 MAC 地址 MAC 地址的设置不不保存到 Flash 中, 先使能对应接 口, 才能设置该接 口的 MAC 地址 char sofap_mac[6] = 0x16, 0x34, 0x56, 0x78, 0x90, 0xab; char sta_mac[6] = 0x12, 0x34, 0x56, 0x78, 0x90, 0xab; wifi_set_macaddr(softap_if, sofap_mac); wifi_set_macaddr(station_if, sta_mac); 5. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 6. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 注意 : ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同, 请勿设置为同 一 MAC 地址 ESP8266 MAC 地址第 一个字节的 bit 0 不不能为 1 例例如,MAC 地址可设置为 1a:fe:36:97:d5:7b, 但不不能设置为 15:fe:36:97:d5:7b 运 行行结果 : ESP8266 station MAC :18:fe:34:97:f7:40 ESP8266 soft-ap MAC :1a:fe:34:97:f7:40 ESP8266 station new MAC :12:34:56:78:90:ab ESP8266 soft-ap new MAC :16:34:56:78:90:ab 扫描附近 AP 1. 设置 ESP8266 为 Station 模式或者 Station+SoftAP 共存模式 wifi_set_opmode(stationap_mode); 2. 扫描附近 AP Espressif 11/37

16 wifi_station_scan 如果第 一个参数为 NULL, 则扫描附近所有 AP; 如果第 一个参数设置了了特定 SSID channel 等信息, 则返回特定的 AP wifi_station_scan(null,scan_done); 扫描 AP 完成的回调函数 void scan_done(void *arg, STATUS status) uint8 ssid[33]; char temp[128]; if (status == OK) struct bss_info *bss_link = (struct bss_info *)arg; while (bss_link = NULL) memset(ssid, 0, 33); if (strlen(bss_link->ssid) <= 32) memcpy(ssid, bss_link->ssid, strlen(bss_link->ssid)); else memcpy(ssid, bss_link->ssid, 32); printf("(%d,\"%s\",%d,\""macstr"\",%d)\r\n", bss_link->authmode, ssid, bss_link->rssi, MAC2STR(bss_link->bssid),bss_link->channel); bss_link = bss_link->next.stqe_next; else printf("scan fail \r\n"); 3. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 4. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : Hello, welcome to scan-task scandone (0,"ESP_A13319",-41,"1a:fe:34:a1:33:19",1) (4,"sscgov217",-75,"80:89:17:79:63:cc",1) (0,"ESP_97F0B1",-46,"1a:fe:34:97:f0:b1",1) (0,"ESP_A1327E",-36,"1a:fe:34:a1:32:7e",1) Espressif 12/37

17 获取 AP 的射频信号强度 (RSSI) 1. 如果 ESP8266 Station 未连接路路由, 可以使 用指定 SSID 扫描 AP 的 方式, 在扫描返回的信息中获得射频信号强度 指定 目标 AP 的 SSID: #define DEMO_AP_SSID DEMO_AP" 指定 SSID 扫描特定 AP, 扫描完成回调 scan_done 可参考前例例 struct scan_config config; memset(&config, 0, sizeof(config)); config.ssid = DEMO_AP_SSID; wifi_station_scan(&config,scan_done); 2. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 3. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : Hello, welcome to scan-task scandone (3,"DEMO_AP",-49,"aa:5b:78:30:46:0a",11) 从 Flash 读取数据 1. Flash 读写数据, 要求必须 4 字节对 齐 例例如, 从 Flash 读取数据 : #define SPI_FLASH_SEC_SIZE 4096 uint32 value; uint8 *addr = (uint8 *)&value; spi_flash_read(0x3e * SPI_FLASH_SEC_SIZE, (uint32 *)addr, 4); printf("0x3e sec:%02x%02x%02x%02x\r\n", addr[0], addr[1], addr[2], addr[3]); 2. 向 Flash 写 入数据同理理, 要求 4 字节对 齐 先使 用 spi_flash_erase_sector 擦除待写 入区域, 再使 用接 口 spi_flash_write 写 入即可 例例如, uint32 data[m]; // TODO: fit in the data spi_flash_erase_sector(n); spi_flash_write(n*4*1024, data, M*4); 3. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 4. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 Espressif 13/37

18 运 行行结果 : read data from 0x3E000 : RTC 使 用示例例 1. 软件复位 (system_restart) 时, 系统时间归零, 但是 RTC 时间仍然继续 但是如果外部硬件通过 EXT_RST 脚或者 CHIP_EN 脚, 将芯 片复位后 ( 包括 Deep-sleep 定时唤醒的情况 ),RTC 时钟会复位 具体如下 : 外部复位 (EXT_RST):RTC memory 不不变,RTC timer 寄存器器从零计数 watchdog reset:rtc memory 不不变,RTC timer 寄存器器不不变 system_restart:rtc memory 不不变,RTC timer 寄存器器不不变 电源上电 :RTC memory 随机值,RTC timer 寄存器器从零计数 CHIP_EN 复位 :RTC memory 随机值,RTC timer 寄存器器从零计数例例如,system_get_rtc_time 返回 10( 表示 10 个 RTC 周期 ), system_rtc_clock_cali_proc 返回 5.75( 表示 1 个 RTC 周期为 5.75 μs), 则实际时间为 10 x 5.75 = 57.5 μs rtc_t = system_get_rtc_time(); cal = system_rtc_clock_cali_proc(); os_printf("cal: %d.%d \r\n", ((cal*1000)>>12)/1000, ((cal*1000)>>12)%1000 ); 读写 RTC memory, 请注意读写 RTC memory 只能 4 字节对 齐 typedef struct uint64 time_acc; uint32 magic ; uint32 time_base; RTC_TIMER_DEMO; system_rtc_mem_read(64, &rtc_time, sizeof(rtc_time)); 2. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 3. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : rtc_time: cal: 非 OS SDK app 如何移植为 RTOS SDK app 1. 定时器器 (timer) 的程序可通 用, 无需改动 2. 回调函数 (callback) 的程序可通 用, 无需改动 Espressif 14/37

19 3. 创建任务的 方式, 需要改动 RTOS SDK 创建任务使 用的是 freertos 自带的软件接 口 :xtaskcreate 非 OS SDK 创建任务 : #define Q_NUM (10) ETSEvent test_q[q_num]; void test_task(etsevent *e) switch(e->sig) case 1: func1(e->par); break; case 2: func2(); break; case 3: func3(); break; default: break; void func_send_sig(void) ETSSignal sig = 2; system_os_post(2,sig,0); void task_ini(void) system_os_task(test_task, 2, test_q,q_num); // test_q is the corresponding array of test_task. // (2) is the priority of test_task. // Q_NUM is the queue length of test_task. RTOS SDK 创建任务 : #define Q_NUM (10) xqueuehandle test_q; xtaskhandle test_task_hdl; Espressif 15/37

20 void test_task(void *pvparameters) int *sig; for(;;) if(pdtrue == xqueuereceive(test_q, &sig, (portticktype)portmax_delay) ) vtasksuspendall(); switch(*sig) case 1: func1(); break; case 2: func2(); break; default: break; free(sig); xtaskresumeall(); void func_send_sig(void) int *evt = (int *)malloc(sizeif(int)); *evt = 2; if(xqueuesend(test_q,&evt,10/porttick_rate_ms)=pdtrue) os_printf("test_q is full\n"); // It is the address of parameter that stored in test_q, so int *evt and int *sig can be other types. void task_ini(void) test_q = xqueuecreate(q_num,sizeof(void *)); xtaskcreate(test_task,(signed portchar *)"test_task", 512, NULL, (1), &test_task_hdl ); // 512 means the heap size of this task, 512 * 4 byte. // NULL is a pointer of parameter to test_task. // (1) is the priority of test_task. // test_task_hdl is the pointer of the task of test_task. Espressif 16/37

21 3.3. 网络协议示例例 ESP8266_RTOS_SDK 的 网络协议即 socket 编程, 示例例包含如下 : UDP 传输示例例 TCP 连接示例例 - ESP8266 作为 TCP client - ESP8266 作为 TCP server UDP 传输 1. 设定 UDP 本地端 口号, 例例如, 端 口号为 1200 #define UDP_LOCAL_PORT 创建 socket LOCAL int32 sock_fd; struct sockaddr_in server_addr; memset(&server_addr, 0, sizeof(server_addr)); server_addr.sin_family = AF_INET; server_addr.sin_addr.s_addr = INADDR_ANY; server_addr.sin_port = htons(udp_local_port); server_addr.sin_len = sizeof(server_addr); do sock_fd = socket(af_inet, SOCK_DGRAM, 0); if (sock_fd == -1) printf("esp8266 UDP task > failed to create sock\n"); vtaskdelay(1000/porttick_rate_ms); while(sock_fd == -1); printf("esp8266 UDP task > socket OK\n"); 3. 绑定本地端 口 do ret = bind(sock_fd, (struct sockaddr *)&server_addr, sizeof(server_addr)); if (ret = 0) printf("esp8266 UDP task > captdns_task failed to bind sock\n"); vtaskdelay(1000/porttick_rate_ms); Espressif 17/37

22 while(ret = 0); printf("esp8266 UDP task > bind OK\n"); 4. 收发 UDP 数据 while(1) memset(udp_msg, 0, UDP_DATA_LEN); memset(&from, 0, sizeof(from)); setsockopt(sock_fd, SOL_SOCKET, SO_RCVTIMEO, (char *)&nnettimeout, sizeof(int)); fromlen = sizeof(struct sockaddr_in); ret = recvfrom(sock_fd, (uint8 *)udp_msg, UDP_DATA_LEN, 0,(struct sockaddr *)&from, (socklen_t *)&fromlen); if (ret > 0) printf("esp8266 UDP task > recv %d Bytes from %s, Port %d\n,ret, inet_ntoa(from.sin_addr), ntohs(from.sin_port)); sendto(sock_fd,(uint8*)udp_msg, ret, 0, (struct sockaddr *)&from, fromlen); if(udp_msg) free(udp_msg); udp_msg = NULL; close(sock_fd); 5. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 6. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : ip: ,mask: ,gw: ESP8266 UDP task > socket ok ESP8266 UDP task > bind ok ESP8266 UDP task > recv data 16 Bytes from , Port 在 PC 端使 用 网络调试 工具, 建 立 UDP 通信, 向 ESP8266 UDP 端 口发送数据 ESP8266 UDP test,esp8266 收到 UDP 数据后, 回复同样的消息给 PC Espressif 18/37

23 TCP Client 1. 设置 ESP8266 Station 连接路路由, 示例例可参考前例例 2. 使 用 网络调试 工具建 立 一个 TCP server #define SERVER_IP #define SERVER_PORT " " socket 编程实现 TCP 通信 建 立 socket: Espressif 19/37

24 sta_socket = socket(pf_inet, SOCK_STREAM, 0); if (-1 == sta_socket) close(sta_socket); vtaskdelay(1000 / porttick_rate_ms); printf("esp8266 TCP client task > socket fail\n"); continue; printf("esp8266 TCP client task > socket ok\n"); 建 立 TCP 连接 : bzero(&remote_ip, sizeof(struct sockaddr_in)); remote_ip.sin_family = AF_INET; remote_ip.sin_addr.s_addr = inet_addr(server_ip); remote_ip.sin_port = htons(server_port); if (0 = connect(sta_socket, (struct sockaddr *)(&remote_ip), sizeof(struct sockaddr))) close(sta_socket); vtaskdelay(1000 / porttick_rate_ms); printf("esp8266 TCP client task > connect fail\n"); continue; printf("esp8266 TCP client task > connect ok\n"); TCP 通信, 发送数据包 : if (write(sta_socket, pbuf, strlen(pbuf) + 1) < 0) close(sta_socket); vtaskdelay(1000 / porttick_rate_ms); printf("esp8266 TCP client task > send fail\n"); continue; printf("esp8266 TCP client task > send success\n"); free(pbuf); TCP 通信, 接收数据包 : char *recv_buf = (char *)zalloc(128); while ((recbytes = read(sta_socket, recv_buf, 128)) > 0) recv_buf[recbytes] = 0; printf("esp8266 TCP client task > recv data %d bytes\nesp8266 TCP client task > %s\n", recbytes, recv_buf); free(recv_buf); Espressif 20/37

25 if (recbytes <= 0) close(sta_socket); printf("esp8266 TCP client task > read data fail\n"); 4. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 5. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : ESP8266 TCP client task > socket ok ESP8266 TCP client task > connect ok ESP8266 TCP client task > send success ESP8266 TCP client task > recv data 17 bytes ESP8266 TCP client task > ESP8266 recv test 网络调试 工具端建 立的 TCP server 与 ESP8266 成功 TCP 通信 TCP Server 1. 建 立 TCP server, 绑定本地端 口 #define SERVER_PORT 1002 int32 listenfd; int32 ret; struct sockaddr_in server_addr,remote_addr; int stack_counter=0; Espressif 21/37

26 /* Construct local address structure */ memset(&server_addr, 0, sizeof(server_addr)); /* Zero out structure */ server_addr.sin_family = AF_INET; /* Internet address family */ server_addr.sin_addr.s_addr = INADDR_ANY; /* Any incoming interface */ server_addr.sin_len = sizeof(server_addr); server_addr.sin_port = htons(httpd_server_port); /* Local port */ /* Create socket for incoming connections */ do listenfd = socket(af_inet, SOCK_STREAM, 0); if (listenfd == -1) printf("esp8266 TCP server task > socket error\n ); vtaskdelay(1000/porttick_rate_ms); while(listenfd == -1); printf("esp8266 TCP server task > create socket: %d\n", server_sock); /* Bind to the local port */ do ret = bind(listenfd, (struct sockaddr *)&server_addr, sizeof(server_addr)); if (ret = 0) printf("esp8266 TCP server task > bind fail\n ); vtaskdelay(1000/porttick_rate_ms); while(ret = 0); printf("esp8266 TCP server task > port:%d\n,ntohs(server_addr.sin_port)); 建 立 TCP server 侦听 : do /* Listen to the local connection */ ret = listen(listenfd, MAX_CONN); if (ret = 0) printf("esp8266 TCP server task > failed to set listen queue\n"); vtaskdelay(1000/porttick_rate_ms); while(ret = 0); printf("esp8266 TCP server task > listen ok\n ); 等待 TCP client 连 入, 建 立 TCP 通信, 接收数据包 : Espressif 22/37

27 int32 client_sock; int32 len = sizeof(struct sockaddr_in); for (;;) printf("esp8266 TCP server task > wait client\n ); /*block here waiting remote connect request*/ if ((client_sock = accept(listenfd, (struct sockaddr *)&remote_addr, (socklen_t *)&len)) < 0) printf("esp8266 TCP server task > accept fail\n"); continue; printf("esp8266 TCP server task > Client from %s %d\n", inet_ntoa(remote_addr.sin_addr), htons(remote_addr.sin_port)); char *recv_buf = (char *)zalloc(128); while ((recbytes = read(client_sock, recv_buf, 128)) > 0) recv_buf[recbytes] = 0; printf("esp8266 TCP server task > read data success %d\nesp8266 TCP server task > %s\n", recbytes, recv_buf); free(recv_buf); if (recbytes <= 0) printf("esp8266 TCP server task > read data fail\n"); close(client_sock); 2. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 3. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 4. 使 用 网络调试 工具建 立 一个 TCP client, 连接到 ESP8266 TCP server, 并发送数据 Espressif 23/37

28 3.4. 高级应 用示例例 运 行行结果 : ip: ,mask: ,gw: got ip Hello, welcome to ESP8266 TCP server task ESP8266 TCP server task > create socket: 0 ESP8266 TCP server task > bind port: 1002 ESP8266 TCP server task > listen ok ESP8266 TCP server task > wait client ESP8266 TCP server task > Client from ESP8266 TCP server task > read data success 17 ESP8266 TCP server task > ESP8266 recv test ESP8266_RTOS_SDK 的 高级示例例包含如下 : OTA 固件升级 强制休眠示例例 SPIFFS 文件系统 SSL 应 用示例例 Espressif 24/37

29 OTA 固件升级 OTA 固件升级, 是指 ESP8266 硬件模块通过 Wi-Fi 无线 网络从服务器器下载新版本固件, 实现固件升级 注意 : 由于擦除 Flash 的过程较慢, 边下载边擦写 Flash 可能占 用较 长时间, 影响 网络传输的稳定性 因此, 请先调 用 spi_flash_erase_sector 将 Flash 待升级区域擦除, 再建 立 网络连接, 从 OTA server 下载新固件, 调 用 spi_flash_write 写 入 Flash 1. 搭建 用户 自 己的云端服务器器, 或者使 用乐鑫的云端服务器器 2. 将新版本固件上传到云端服务器器 3. 代码说明如下 : 设置 ESP8266 模块连接到路路由器器, 示例例可参考前述 在 upgrade_task 中查询 ESP8266 Station 是否获取到 IP 地址 wifi_get_ip_info(station_if, &ipconfig); /* check the IP address or net connection state*/ while (ipconfig.ip.addr == 0) vtaskdelay(1000 / porttick_rate_ms); wifi_get_ip_info(station_if, &ipconfig); ESP8266 获取到 IP 地址后, 与云端服务器器建 立连接, 可参考前例例 socket 编程 system_upgrade_flag_set 设置升级状态标志 : - UPGRADE_FLAG_IDLE: 空闲状态 - UPGRADE_FLAG_START: 开始升级 - UPGRADE_FLAG_FINISH: 从服务器器下载新版本固件完成 system_upgrade_userbin_check 查询当前正在运 行行的是 user1.bin 还是 user2.bin, 若正在运 行行 user1.bin 则下载 user2.bin, 否则下载 user1.bin system_upgrade_init(); system_upgrade_flag_set(upgrade_flag_start); 向服务器器发送下载请求, 从服务器器接收新固件数据, 并写 入 Flash if(write(sta_socket,server->url,strlen(server->url)+1) < 0) Espressif 25/37

30 while((recbytes = read(sta_socket,precv_buf,upgrade_data_seg_len)) > 0) // write the new firmware into flash by spi_flash_write 设置 一个软件定时器器检查升级状态, 如果定时器器超时, 仍未完成从服务器器下载固件, 则判断升级失败, 将升级状态置回空闲, 释放相关资源, 退出本次升级 若从服务器器下载固件成功, 升级状态设置为 UPGRADE_FLAG_FINISH, 在此状态下, 调 用软件接 口 system_upgrade_reboot, 可控制 ESP8266 重新启动, 运 行行新版本固件 4. 编译应 用程序, 生成固件烧录到 ESP8266 硬件模组中 5. 将硬件模组断电, 切换到运 行行模式, 重新上电, 运 行行应 用程序 运 行行结果 : 在 PC 端使 用 webserver 工具, 建 立 一个服务器器, 并上传 user1.bin 和 user2.bin, ESP8266 烧录固件后, 默认先运 行行 user1.bin, 从服务器器下载 user2.bin 下载 user2.bin 成功后,ESP8266 模块 自动重启, 运 行行新固件 user2.bin, user1.bin 直到下次 FOTA 升级前都不不会再被运 行行 当服务器器上出现新的固件, 且 用户需要再次更更新时, 用户发送升级请求, 下载 user1.bin 的新固件, 模块 自动重启后, 运 行行 user1.bin 如此循环 Espressif 26/37

31 ESP8266 升级流程的打印信息 : connected with Demo_AP, channel 6 dhcp client start... ip: ,mask: ,gw: Hello, welcome to client socket ok connect ok GET /user2.bin HTTP/1.0 Host: " ":80 Connection: keep-alive Cache-Control: no-cache User-Agent: Mozilla/5.0 (Windows NT 5.1) AppleWebKit/ (KHTML, like Gecko) Chrome/ Safari/ Accept: */* Accept-Encoding: gzip,deflate,sdch Accept-Language: zh-cn,zh;q=0.8 send success read data success upgrade file download start. read data success totallen = 1460 read data success totallen = 2920 read data success 强制休眠示例例强制休眠接 口, 在需要的情况下强制关闭 RF 电路路以降低功耗 Espressif 27/37

32 注意 : 强制休眠接 口调 用后, 并不不会 立即休眠, 而是等到系统 idle task 执 行行时才进 入休眠 请参考下述示例例使 用 示例例 一 :Modem-sleep 模式 ( 关闭射频 ) #define FPM_SLEEP_MAX_TIME 0xFFFFFFF void fpm_wakup_cb_func1(void) wifi_fpm_close(); // disable force sleep function wifi_set_opmode(station_mode); // set station mode wifi_station_connect(); // connect to AP void user_func( ) wifi_station_disconnect(); wifi_set_opmode(null_mode); // set WiFi mode to null mode. wifi_fpm_set_sleep_type(modem_sleep_t); // modem sleep wifi_fpm_open(); // enable force sleep #ifdef SLEEP_MAX /* For modem sleep, FPM_SLEEP_MAX_TIME can only be wakened by calling wifi_fpm_do_wakeup. */ wifi_fpm_do_sleep(fpm_sleep_max_time); #else // wakeup automatically when timeout. wifi_fpm_set_wakeup_cb(fpm_wakup_cb_func1); // Set wakeup callback wifi_fpm_do_sleep(50*1000); #endif #ifdef SLEEP_MAX void func1(void) wifi_fpm_do_wakeup(); wifi_fpm_close(); wifi_set_opmode(station_mode); wifi_station_connect(); #endif // disable force sleep function // set station mode // connect to AP Espressif 28/37

33 示例例 二 :Light-sleep 模式 ( 关闭射频和 CPU) 强制进 入 Light-sleep 模式, 即强制关闭射频和 CPU, 需要设置 一个回调函数, 以便便唤醒 后程序继续运 行行 void fpm_wakup_cb_func1(void) wifi_fpm_close(); wifi_set_opmode(station_mode); wifi_station_connect(); // disable force sleep function // set station mode // connect to AP #ifndef SLEEP_MAX // Wakeup till time out. void user_func( ) wifi_station_disconnect(); wifi_set_opmode(null_mode); // set WiFi mode to null mode. wifi_fpm_set_sleep_type(light_sleep_t); // light sleep wifi_fpm_open(); // enable force sleep wifi_fpm_set_wakeup_cb(fpm_wakup_cb_func1); // Set wakeup callback wifi_fpm_do_sleep(50*1000); #else // Or wakeup by GPIO void user_func( ) wifi_station_disconnect(); wifi_set_opmode(null_mode); // set WiFi mode to null mode. wifi_fpm_set_sleep_type(light_sleep_t); // light sleep wifi_fpm_open(); // enable force sleep PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U,3); gpio_pin_wakeup_enable(13, GPIO_PIN_INTR_LOLEVEL); wifi_fpm_set_wakeup_cb(fpm_wakup_cb_func1); wifi_fpm_do_sleep(0xfffffff); #endif // Set wakeup callback Espressif 29/37

34 SPIFFS 文件系统应 用 1. 调 用软件接 口 esp_spiffs_init, 初始化 SPIFFS 文件系统 void spiffs_fs1_init(void) struct esp_spiffs_config config; config.phys_size = FS1_FLASH_SIZE; config.phys_addr = FS1_FLASH_ADDR; config.phys_erase_block = SECTOR_SIZE; config.log_block_size = LOG_BLOCK; config.log_page_size = LOG_PAGE; config.fd_buf_size = FD_BUF_SIZE * 2; config.cache_buf_size = CACHE_BUF_SIZE; esp_spiffs_init(&config); 2. 打开并创建 一个 文件, 写 入数据 char *buf="hello world"; char out[20] = 0; int pfd = open("myfile", O_TRUNC O_CREAT O_RDWR, S_IRUSR S_IWUSR); if(pfd <= 3) printf("open file error \n"); int write_byte = write(pfd, buf, strlen(buf)); if (write_byte <= 0) printf("write file error \n"); close(pfd); 3. 通过 文件系统读取数据 open("myfile",o_rdwr); if (read(pfd, out, 20) < 0) printf("read errno \n"); close(pfd); printf("--> %s <--\n", out); Espressif 30/37

35 SSL 应 用示例例 1. 定义将连接的 SSL server IP 和端 口 #define SSL_SERVER_IP #define SSL_SERVER_PORT esp_test *ptestparamer = (esp_test *)zalloc(sizeof(esp_test)); ptestparamer->ip.addr = ipaddr_addr(ssl_server_ip); ptestparamer->port = server_port; 2. 创建 SSL client 的任务 xtaskcreate(esp_client, "esp_client", 1024, (void*)ptestparamer, 4, NULL); 3. 参考前 文示例例, 设置 ESP8266 Station 连接路路由 在 SSL client 的任务中, 先检查 ESP8266 Station 获得了了 IP 地址, 再建 立 SSL 连接 struct ip_info ipconfig; wifi_get_ip_info(station_if, &ipconfig); while (ipconfig.ip.addr == 0) vtaskdelay(1000 / porttick_rate_ms); wifi_get_ip_info(station_if, &ipconfig); 4. 建 立 socket 连接 client_fd = socket(af_inet, SOCK_STREAM, IPPROTO_TCP); if (client_fd < 0) printf("create with the socket err\n"); memset(&client_addr, 0, sizeof(client_addr)); client_addr.sin_family = AF_INET; client_addr.sin_port = htons(port); client_addr.sin_addr.s_addr = sin_addr; if(connect(client_fd, (struct sockaddr *)&client_addr, sizeof(client_addr))< 0) printf("connect with the host err\n"); 5. 创建 SSL 上下 文内容 (context) SSL 需要较 大内存, 建议调 用 system_get_free_heap_size 检查可 用内存容量量 uint32 options = SSL_SERVER_VERIFY_LATER SSL_DISPLAY_CERTS SSL_NO_DEFAULT_KEY; if ((ssl_ctx = ssl_ctx_new(options, SSL_DEFAULT_CLNT_SESS)) == NULL) Espressif 31/37

36 printf("error: Client context is invalid\n"); printf("heap_size %d\n,system_get_free_heap_size()); 6. 如果开发者需要认证功能, 如果不不使 用 SPIFFS 文件系统, 请先运 行行 esp_iot_sdk_freertos\tools\ make_cert.py 脚本, 生成 esp_ca_cert.bin 文件, 烧录到 Flash 自定义地址 以下代码示例例从 Flash 读取 SSL 密钥和证书信息 uint8 flash_offset = 0x78; // Example : Flash address 0x78000 if (ssl_obj_option_load(ssl_ctx, SSL_OBJ_RSA_KEY, XX.key, password, flash_offset)) printf("error: the Private key is undefined.\n"); if (ssl_obj_option_load(ssl_ctx, SSL_OBJ_X509_CERT, XX.cer, NULL, flash_offset)) printf("error: the Certificate is undefined.\n"); 如果使 用 SPIFFS 文件系统, 请运 行行 工具 spiffy( 注意, 此 工具内的 spiffs_config.h 文件必须修改成与 RTOS SDK 中的 spiffs_config.h 一致 ), 生成符合 SPIFFS 格式的 spiffs_rom.bin 文件, 烧录到 Flash SPIFFS 配置的地址, 可参考前例例 esp_spiffs_init 以下代码示例例使 用 SPIFFS 文件系统的情况下, 读取 SSL 密钥和证书信息 if (ssl_obj_load(ssl_ctx, SSL_OBJ_RSA_KEY, XX.key, password)) printf("error: the Private key is undefined.\n"); if (ssl_obj_load(ssl_ctx, SSL_OBJ_X509_CERT, XX.cer, NULL)) printf("error: the Certificate is undefined.\n"); 7. 开始 SSL client 握 手 ssl = ssl_client_new(ssl_ctx, client_fd, NULL, 0); if (ssl = NULL) printf("client handshake start\n"); 8. 检查 SSL 连接状态 if ((res = ssl_handshake_status(ssl)) == SSL_OK) Espressif 32/37

37 9. 如果 SSL 握 手成功, 则可以释放证书, 节省内存空间 const char *common_name = ssl_get_cert_dn(ssl,ssl_x509_cert_common_name); if (common_name) printf("common Name:\t\t\t%s\n", common_name); display_session_id(ssl); display_cipher(ssl); quiet = true; os_printf("client handshake ok heapsize %d\n",system_get_free_heap_size()); x509_free(ssl->x509_ctx); ssl->x509_ctx=null; os_printf("certificate free ok heapsize %d\n,system_get_free_heap_size()); 10. 发送 SSL 数据 uint8 buf[512]; bzero(buf, sizeof(buf)); sprintf(buf,httphead,"/", "iot.espressif.cn",port); os_printf("%s\n", buf); if(ssl_write(ssl, buf, strlen(buf)+1) < 0) ssl_free(ssl); ssl_ctx_free(ssl_ctx); close(client_fd); vtaskdelay(1000 / porttick_rate_ms); os_printf("send fail\n"); continue; 11. 接收 SSL 数据 while((recbytes = ssl_read(ssl, &read_buf)) >= 0) if(recbytes == 0) vtaskdelay(500 / porttick_rate_ms); continue; os_printf("%s\n", read_buf); free(read_buf); if(recbytes < 0) os_printf("error:read data fail recbytes %d\r\n",recbytes); Espressif 33/37

38 ssl_free(ssl); ssl_ctx_free(ssl_ctx); close(client_fd); vtaskdelay(1000 / porttick_rate_ms); 运 行行结果 : ip: ,mask: ,gw: BEGIN SSL SESSION PARAMETERS ae116a6a0445b369f010e0ea e92179a6602c8b5968c1f35b END SSL SESSION PARAMETERS----- CIPHER is AES128-SHA client handshake ok heapsize certificate free ok heapsize GET / HTTP/1.1 Host: iot.espressif.cn:443 Connection: keep-alive Espressif 34/37

39 附录 A A. 附录 A.1. Sniffer 说明 关于 sniffer 的详细说明, 请参考 ESP8266 技术参考 A.2. ESP8266 SoftAP 和 Station 信道定义 虽然 ESP8266 支持 SoftAP+Station 共存模式, 但是 ESP8266 实际只有 一个硬件信道 因此在 SoftAP+Station 模式时,ESP8266 SoftAP 会动态调整信道值与 ESP8266 Station 一致 这个限制会导致 ESP8266 SoftAP+Station 模式时 一些 行行为上的不不便便, 用户请注意 例例如 : 情况 一 1. 如果 ESP8266 Station 连接到 一个路路由 ( 假设路路由信道号为 6) 2. 通过接 口 wifi_softap_set_config 设置 ESP8266 SoftAP 3. 若设置值合法有效, 该 API 将返回 true, 但信道号仍然会 自动调节成与 ESP8266 Station 接 口 一致, 在这个例例 子 里里也就是信道号为 6 因为 ESP8266 在硬件上只有 一个信道, 由 ESP8266 Station 与 SoftAP 接 口共 用 情况 二 1. 调 用接 口 wifi_softap_set_config 设置 ESP8266 SoftAP( 例例如信道号为 5) 2. 其他 Station 连接到 ESP8266 SoftAP 3. 将 ESP8266 Station 连接到路路由 ( 假设路路由信道号为 6) 4. ESP8266 SoftAP 将 自动调整信道号与 ESP8266 Station 一致 ( 信道 6) 5. 由于信道改变, 之前连接到 ESP8266 SoftAP 的 Station 的 Wi-Fi 连接断开 情况三 1. 其他 Station 与 ESP8266 SoftAP 建 立连接 2. 如果 ESP8266 Station 一直尝试扫描或连接某路路由, 可能导致 ESP8266 SoftAP 端的连接断开 Espressif 35/37

40 附录 A 3. 因为 ESP8266 Station 会遍历各个信道查找 目标路路由, 意味着 ESP8266 其实在不不停切换信道,ESP8266 SoftAP 的信道也因此在不不停更更改 这可能导致 ESP8266 SoftAP 端的原有连接断开 4. 这种情况, 用户可以通过设置定时器器, 超时后调 用 wifi_station_disconnect 停 止 ESP8266 Station 不不断连接路路由的尝试 ; 或者在初始配置时, 调 用 wifi_station_set_reconnect_policy 和 wifi_station_set_auto_connect 禁 止 ESP8266 Station 尝试重连路路由 A.3. ESP8266 启动信息说明 ESP8266 启动时, 将从 UART0 以波特率 打印如下启动信息 : 其中可供 用户参考的启动信息说明如下 : 启动信息 说明 1: 上电 rst cause 2: 外部复位 4: 硬件看 门狗复位 boot mode 第 一个参数 chksum 1:ESP8266 处于 UART-down 模式, 可通过 UART 下载固件 3:ESP8266 处于 Flash-boot 模式, 从 Flash 启动运 行行 chksum 与 csum 值相等, 表示启动过程中 Flash 读取正确 Espressif 36/37

41 乐鑫 IOT 团队 免责申明和版权公告 本 文中的信息, 包括供参考的 URL 地址, 如有变更更, 恕不不另 行行通知 文档 按现状 提供, 不不负任何担保责任, 包括对适销性 适 用于特定 用途或 非侵权性的任何担保, 和任何提案 规格或样品在他处提到的任何担保 本 文档不不负任何责任, 包括使 用本 文档内信息产 生的侵犯任何专利利权 行行为的责任 本 文档在此未以禁 止反 言或其他 方式授予任何知识产权使 用许可, 不不管是明示许可还是暗示许可 Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有 蓝 牙标志是 Bluetooth SIG 的注册商标 文中提到的所有商标名称 商标和注册商标均属其各 自所有者的财产, 特此声明 版权归 2017 乐鑫所有 保留留所有权利利