Espressif_FAQ_CN

Transcription

1 ESP8266EX 常 见问题 版本 1.6 乐鑫信息科技 版权所有

2 关于本 手册 本 文介绍 ESP8266EX 的常 见问题以及解答 发布说明 日期版本发布说明 V1.0 首次发布 V1.1 第 3 章增加问题 如何优化 ESP8266 应 用的内存使 用? V V1.3 第 1 章增加问题 如果应 用使 用的是不不 支持 FOTA 的固件, 要将 eagle.irom0.text.bin 下载到哪 里里? 第 3 章增加问题 如何让 ESP8266 上电后快速连接 AP? 第 7 章增加问题 调 用 wifi_softap_set_config() 时, 函数返回成功, 但为何 无法修改 ESP8266 的 SoftAP SSID 和密码? 第 3 章增加以下两个问题 : V1.4 为什什么 ESP8266 进 入启动模式 (2,7) 并触发看 门狗复位? ESP8266 上电时打印的 boot 模式信息代表什什么? 如何改变 boot 模式? V1.5 格式更更改 V1.6 增加第 7 章有关 如何修改默认上电校准 方式? 的问题 文档变更更通知 用户可通过乐鑫官 网订阅 页 面 订阅技术 文 档变更更的电 子邮件通知 证书下载 用户可通过乐鑫官 网证书下载 页 面 下载产 品证书

3 目录 1. 应 用 为什什么云端升级需要 2 个 BIN 文件? user1.bin 和 user2.bin 有什什么区别? 如何 生成 user1.bin 和 user2.bin? 如果应 用使 用的是不不 支持 FOTA 的固件, 要将 eagle.irom0.text.bin 下载到哪 里里? 云端升级失败有哪些原因? 如何通过我 自 己的服务器器进 行行云端升级? 如何使 用我 自 己的云服务器器进 行行云端升级? ESP8266 如何和云端服务器器进 行行交互? SmartConfig 配 网配不不上有哪些原因? SmartConfig 支持的 APP 对应的版本是什什么? ESP8266 支持 HTTP 服务端吗? 如何通过 AT 指令发 HTTP 包? 如何在 AT+ 指令中定义 自 己的函数? 如何在函数之间传递参数? 微信中的近场发现中使 用的 Product ID 是从哪 里里来的? ESP8266 如何添加 自定义 AT 命令, 自定义 AT 命令字段和参数段 长度限制是多少? 云平台 在乐鑫的云平台上, 设备的 生命周期是怎样的? 系统 ESP8266 的看 门狗是什什么作 用? 看 门狗的超时间隔是多少? 触发超时事件会有什什么现象? 如果我的应 用不不需要看 门狗, 如何关闭看 门狗? 如果我要在程序 里里 面引 入 10 秒的延迟, 怎么做最好? 对于 Non-OS SDK,memory leak 问题如何 debug? 对于 RTOS SDK,memory leak 问题如何 debug? 如何优化 ESP8266 应 用的内存使 用?... 9

4 3.8. 发 生 fatal exception 问题如何处理理? ESP8266 总共有 几个 timer? 使 用 timer 中断是否有特定条件? 如何调整 Tx Power? 为什什么 ESP8266_Non-OS_SDK 中有的函数前 面添加了了 ICACHE_FLASH_ATTR 宏? 为什什么编译 Non-OS SDK 时会发 生 IRAM_ATTR 错误? 为什什么编译的时候会发 生 irom0_0_seg 错误? ESP8266 有 main 吗? 操作指针有什什么需要注意的? RTOS SDK 和 Non-OS SDK 有何区别? 哪些接 口需要在 user_init 中调 用, 否则容易易出现问题, 或者不不 生效? Light-sleep 如何通过 GPIO 或 网络事件唤醒? ESP8266 FRC1 的 hw_timer 如何使 用? 如何让 ESP8266 上电后快速连接 AP? 为什什么 ESP8266 进 入启动模式 (2,7) 并触发看 门狗复位? ESP8266 上电时打印的 boot 模式信息代表什什么? 如何改变 boot 模式? 硬件 ESP8266 电压电流需求? 设计 ESP8266 的供电时, 需要注意哪些问题? ESP8266 上电时电流很 大, 是什什么原因? 可以使 用锂电池或者两节 AA 纽扣电池直接给 ESP8266 供电吗? SPI Flash 上电时, 是否有特殊需求? 上电时序是怎样的,boot 模式是如何选择的? ESP8266 的 RAM 的使 用结构是怎么的? 外设 ADC 的性能参数有 几个通道? 采样率和有效位数是多少? 从哪 里里可以得到 ADC 的寄存器器 bitmap 信息?... 21

5 5.3. ADC 的精度如何? 内部 ADC 的 用途是什什么? (u8 tx_addr, u8 tx_cmd, u8 tx_rep) 这三个参数是什什么意思? 为什什么 ESP8266 上电时会出现乱码? 如何修改波特率? 如何使能 UART 流控? 如何配置信息打印到 UART1 上? SDIO 是否 支持 SD 卡? SDIO 最 高速度能 支持到多少? 为什什么上电时会有 LED 灯闪 一下的情况? 使 用 PWM 时, 发现最开始时有窄波, 是什什么原因? 发现 PWM 的变化缓慢, 是什什么原因? GPIO 可以直接连 5 V 吗? 哪 里里能找到 GPIO 的 register 和 bitmap 信息? 如何编程 GPIO? HSPI 每个数据包的 大 小最 大是多少? 对于多设备同时连接到 ESP8266 的情况,HSPI 是如何同时驱动设备的? 如何使 用 64 字节的数据缓存? 如何配置 (H)SPI 接 口? 哪些 API 会保存到 Flash? 系统参数是如何保存的? Flash 任何位置都可以随意读写吗? 可以在所有的 ESP8266 上执 行行同样的 Flash 读写操作吗? 可否提供 Flash 擦写例例证? 如何判断 Flash 是否 支持 QIO 或 DIO 模式? 为什什么透传过程会丢包? ESP8266 有 几个 UART? GPIO 电平状态是怎样的? 如何屏蔽上电打印?... 30

6 6. 协议 TCP / UDP 的包 长是多少? RF 如何修改默认上电校准 方式? Wi-Fi 设备开启 SoftAP + Station 模式下, 连接的路路由是 X 网段时, 为什什么会失败? 路路由配置是正确的, 但是发 生找不不到路路由, 连接失败, 为什什么? 调 用 wifi_softap_set_config() 时, 函数返回成功, 但为何 无法修改 ESP8266 的 SoftAP SSID 和密码? ESP8266 SoftAP + Station 模式下 网络断开或丢包的情况? Wi-Fi 信道是什什么? 可以 自 行行选择信道吗? 如何配置 ESP8266, 以便便连接到 无线路路由器器? 工具 测试和 生产时如何烧录 Flash?... 36

7 ! 1. 应 用 1. 应 用 1.1. 为什什么云端升级需要 2 个 BIN 文件? user1.bin 和 user2.bin 有什什么区别? user1.bin 和 user2.bin 是 2 个不不同的 BIN 文件 生成 user1.bin 和 user2.bin 时, 必须使 用相同的 Flash 和 boot 设置, 以保证 OTA 升级成功 2 个 BIN 文件是互补的, 运 行行 user1.bin 的时候, 升级是下载 user2.bin; 运 行行 user2.bin 的时候, 升级是下载 user1.bin 这样可以保证升级过程中, 如果有掉线的情况发 生, 设备还是可以正常运 行行 1.2. 如何 生成 user1.bin 和 user2.bin? 编译环境下, 执 行行 gen_misc.sh 分别得到 user1.bin 和 user2.bin 步骤如下: 1. 使 用正确的 Flash 和 boot 配置, 编译 生成 user1.bin 2. 执 行行 make clean, 以便便清除之前的残余信息 3. 使 用相同的 Flash 和 boot 配置, 编译 生成 user2.bin 1.3. 如果应 用使 用的是不不 支持 FOTA 的固件, 要将 eagle.irom0.text.bin 下载到哪 里里? 对于 Non-OS SDK 和 RTOS SDK, 固件 BIN 文件的位置取决于合适的链接脚本内容 如果应 用中使 用的是不不 支持 FOTA 的固件, 则 用户代码包含在 eagle.irom0.text.bin 中 该 BIN 文件在 Flash 中的位置是由 SDK/ld 中的链接脚本 eagle.app.v6.ld 决定的 注意 : 在所有版本 ESP8266 SDK 中,eagle.irom0.text.bin 的默认位置并不不都是 一样的 用户可以确认在 自 己的 ESP8266 SDK 版本中, 该 BIN 文件在 Flash 中的位置 如下图所示 : Espressif! 1/!

8 1. 应 用 图中标蓝的数字表示 eagle.irom0.text.bin 在 Flash 中的地址 在上图的例例 子中, 该地址为 0x 云端升级失败有哪些原因? 云端升级的详细介绍参考 文档 ESP8266 FOTA 云端升级指南 请先检查以下问题 : 确认使 用了了正确 大 小的 Flash 确认是否烧录了了 blank.bin 做初始化 确认 user1.bin 和 user2.bin 下载到了了正确的地址 确认 生成 user1.bin 和 user2.bin 使 用了了相同的 Flash boot 配置 1.5. 如何通过我 自 己的服务器器进 行行云端升级? 如果通过客户 自 己的服务器器升级, 请确认服务器器满 足下 面的要求 1. 发送 HEAD 指令到云端服务器器, 询问待升级的 BIN 文件 长度, 服务器器回复的 HTTP 包头中要求带有 BIN 文件的 长度信息 2. 根据上述 方法查询到的 BIN 文件 长度, 在 ESP8266 模块的 Flash 待升级区域, 擦除该指定 长度 (spi_flash_erase_sector), 等待下载 3. 发送 GET 指令, 从服务器器下载 BIN 文件, 写 入到 Flash 的待升级区域 1.6. 如何使 用我 自 己的云服务器器进 行行云端升级? 客户可以使 用 自 己的云服务器器, 但是要能 支持 HTTP 请求, 并可以 支持设备控制功能 云端的 API, 请 见 : ESP8266 如何和云端服务器器进 行行交互? 可以使 用标准 HTTP 协议连接云服务器器 比如,ESP8266 使 用如下的 HTTP 请求 GET /your-bin-file-path.bin HTTP/1.1 Host: yourdomain.com Connection: keep-alive Cache-Control: max-age=0 Accept: text/html, application/xhtml+xml, application/xml; q=0.9, image/webp, */*; q=0.8 User-Agent: Espressif! 2/!

9 1. 应 用 Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/ (KHTML, like Gecko) Chrome/ Safari/ Accept-Encoding: gzip, deflate, sdch Accept-Language: en-us, en;q=0.8, ja; q=0.6,zh-cn; q=0.4,zh-tw; q=0.2 注意 : HTTP 协议规定请求以 \r\n\r\n 为结束, 所以在通讯过程中请不不要使 用这样的组合 客户可以通过下 面的 方法来 debug 服务器器 : telnet <sitename> <port_number> 请事先确认 telnet 在您的 PC 上是可以使 用的, 或者使 用其他的 支持 telnet 的终端软件也 可以达到同样的 目的, 比如 TeraTerm 1.8. SmartConfig 配 网配不不上有哪些原因? 请做以下检查 : APP 版本是否 支持 SDK 版本或 SmartConfig 版本 手机连接的路路由器器不不能是单 5G 路路由 ( 双频路路由器器除外 ) SmartConfig 过程中不不要调 用其他 API 使 用 AT 时, 设备没有获得 IP 之前, 不不要调 用 smartconfig_stop 如以上排除, 请把连接失败和成功的 log 发给我们技术做 支持分析 1.9. SmartConfig 支持的 APP 对应的版本是什什么? 调 用 smartconfig_start() 接 口, 会有 SC version: vx.x.x 版本信息打印 这是 ESP- TOUCH 模块的版本号 下 面是 非 OS 对应的 SmartConfig 版本和 APP 版本 SDK 版本 SmartConfig 版本 APP 版本 sdk v1.2.0 smartconfig v2.4 app v0.3.4.x sdk v1.3.0 smartconfig v2.5 app v0.3.4.x sdk v1.3.0 smartconfig v2.5.1 app v0.3.4.x sdk v1.4.0 smartconfig v2.5.2 app v0.3.4.x sdk v1.5.0 smartconfig v2.5.3 app v0.3.4.x sdk v1.5.4 smartconfig v2.5.4 app v0.3.4.x Espressif! 3/!

10 !! 1. 应 用 ESP8266 支持 HTTP 服务端吗? 支持 ESP8266 在 SoftAP 和 Station 模式下都可以作服务端 在 SoftAP 模式下,ESP8266 的服务端 IP 地址是 如果 Station 模式, 服务端的 IP 地址为路路由器器分配给 ESP8266 的 IP 如果是基于 SDK 二次开发, 那么需使 用 espconn 结构体和相关 API 如果是使 用 AT 指令, 需使 用 AT+CIPSERVER 开启服务端 如何通过 AT 指令发 HTTP 包? 1. AT 指令配置 SoftAP + Station 模式 :AT+CWMODE=3 // set softap+station mode 2. AT 指令连接路路由 :AT+CWJAP="SSID","password" // ESP8266 station connect to router 3. 创建 TCP 连接, 按照 HTTP 包的格式发送数据, 如下图红框标注, 请注意,HTTP 包 中的换 行行符 [(0x0d 0x0a) or (CR LF)] 是必须的, 不不能省去 4. 收到 HTTP 包的回复 Espressif! 4/!

11 1. 应 用 如何在 AT+ 指令中定义 自 己的函数? 如何在函数之间传递参数? 在 Non-OS SDK 中的 AT 示例例 (\ESP8266_NONOS_SDK\examples\at\user\user_main.c) 中有提供如何实现 一条 自定义的 AT 指令 AT+TEST 结构体 at_funcationtype 用于定义 一条指令的四种类型, 例例如指令名称 AT+TEST 类型 at_testcmd: 测试指令, 对应指令为 AT+TEST=?,AT 示例例中注册的实现回调为 at_testcmdtest, 测试指令可以设计为返回参数的取值范围 ; 注册为 NULL, 则 无测试指令 类型 at_querycmd: 查询指令, 对应指令为 AT+TEST?,AT 示例例中注册的实现回调为 at_querycmdtest, 查询指令可以设计为返回当前值 ; 注册为 NULL, 则 无查询指令 类型 at_setupcmd: 设置指令, 对应指令格式为 AT+TEST=parameter1,parameter2,...,AT 示例例中注册的实现回调为 at_setupcmdtest, 设置指令可以设计 用于设置参数值 ; 注册为 NULL, 则 无设置指令 类型 at_execmd: 执 行行指令, 对应指令为 AT+TEST,AT 示例例中注册的实现回调为 at_execmdtest, 执 行行指令可以设计 用于执 行行某项操作 ; 注册为 NULL, 则 无执 行行指令 微信中的近场发现中使 用的 Product ID 是从哪 里里来的? 需要建 立 一个 device ID, 比如在客户的微信号下, 建 立了了 一个 ID = 1234 的设备 通过如下命令 curl -q grant_type=client_credential&appid=wx0f74f861897f84b5&secret=your_wechatnam e_32characters_please // 注 : 目的是得到 access token ( your_wechatname_32characters_please 代表客户的 微信 API 应 用秘钥, 申请获得, 应该为 32 个字符 ) 返回 : {"access_token":"l2_2v1e98vkjtxenxdzjdt0gaudun_vgtra7o98hdft0ltza2b7nj6yvxn01gssqa3zrargjalucvxd- SamuPR885KJabaw1EYLA0kns-Yglr4ryolEhHb-QcnWMaNqSEDjACANZY","expires_in": 7200} curl -d '{"device_num":"1","device_list": [{"id":"1234","mac":"18fe3497d500","connect_protocol":"4","auth_key":" ","close_strategy":"1","conn_strategy":"1","cryp t_method":"0","auth_ver":"0","manu_mac_pos":"-2","ser_mac_pos":"-2"}],"op_t ype":"0", "product_id": 5157}' " Espressif! 5/!

12 1. 应 用 authorize_device?access_token=l2_2v1e98vk- jtxenxdzjdt0gaudun_vgtra7o98hdft0ltza2b7nj6yvxn01gssqa3zrargjalucvxd- SamuPR885KJabaw1EYLA0kns-Yglr4ryolEhHb-QcnWMaNqSEDjACANZY" // 注 : 建 立 一个 ID = 1234 的设备 这样, 您只需要使 用 AT 指令 AT+CWSTARTDISCOVER= gh_9e2cff3dfa51","1234",1 即可 ( gh_9e2cff3dfa51 是您的微信公众号名字 ) ESP8266 如何添加 自定义 AT 命令, 自定义 AT 命令字段和参数段 长度限制是多少? 客户可以基于 ESP8266_NONOS_SDK\examples\at 示例例代码, 在 ESP8266 自带 AT 命令的基础上, 添加客户 自定义的 AT 命令 关于 自定义 AT 命令,SDK 限制整条 AT 命令数据 长度最 大 128 字节 ( 含结束符 \r\n ), 不不单独限制命令段和参数段 例例如 :AT+CMDTEST=param1,param2,param3,.paramN\r\n 则 :strlen( AT+CMDTEST=param1,param2,param3,...paramN\r\n )<=128 bytes 相关 SDK 及参考资料料请 至乐鑫官 网下载 :ESP8266 SDK 和 Demo Espressif! 6/!

13 2. 云平台 2. 云平台 2.1. 在乐鑫的云平台上, 设备的 生命周期是怎样的? 1. 烧录 master-device-key, 出 厂 2. 到达终端 用户, 使 用 Airkiss/ESP_TOUCH 让设备联 网, 同时传递随机字符 (token, App 产 生 ) 作为权限标识, 设备上 网之后调 用 /v1/device/activate, 同时把 token 传递给云端 3. 终端 用户使 用 App 并且调 用 /v1/device/authorize 接 口 ( 使 用之前产 生的随机 token), 获得这个设备的所有权 ( 成为 owner, 获得对应的 owner key) 4. 终端 用户对设备的拥有本质上是对 device key 的拥有, 对于每 一个设备的控制, 是通过对应的 device key 来操作的 5. 终端 用户使 用 /v1/user/devices 列列出拥有的设备以及对应的 device key, 然后使 用对应的 device key 做具体的操作 6. 终端 用户是 owner 的权限下, 可以调 用 /v1/device/share 接 口分享设备给他 人, 对应的 用户使 用 /v1/device/authorize 接 口得到授权 Espressif! 7/!

14 3. 系统 3. 系统 3.1. ESP8266 的看 门狗是什什么作 用? 为了了提供系统稳定性, 以应对多冲突的操作环境,ESP8266 集成了了 2 级看 门狗机制, 包 括软件看 门狗和硬件看 门狗 默认 2 个看 门狗都是打开的 3.2. 看 门狗的超时间隔是多少? 触发超时事件会有什什么现象? 硬件看 门狗中断时间为 0.8*2048 ms, 即 ms, 中断后处理理时间为 0.8*8192 ms, 即 ms 其中中断处理理后时间为硬件看 门狗中断发 生后, 需要进 行行喂狗操作的时间, 如果超过该时间, 即会触发硬件看 门狗复位 因此, 在仅有硬件看 门狗的情况下, 一个程序段如果运 行行时间超过 ms, 即有可能触发硬件看 门狗复位, 若超过 8192 ms 则 一定会触发复位 软件看 门狗建 立在 MAC timer 以及系统调度之上, 中断时间为 1600 ms, 中断后处理理时间为 1600 ms 因此, 在有软件 + 硬件看 门狗的情况下, 一个程序段如果运 行行时间超过 1600 ms, 即有可能会触发软件看 门狗复位, 若超过 3200 ms 则 一定会触发复位 如果我的应 用不不需要看 门狗, 如何关闭看 门狗? 3.3. 如果我的应 用不不需要看 门狗, 如何关闭看 门狗? 当前 SDK 仅 支持关闭软件看 门狗, 支持同时喂软硬件看 门狗 可以通过如下 方式防 止执 行行时间过 长的 用户程序导致看 门狗复位 : 1. 如果 一个程序段运 行行时间在触发软件看 门狗和触发硬件看 门狗复位之间, 则可通过 system_soft_wdt_stop () 的 方式关闭软件看 门狗, 在程序段执 行行完毕后 用 system_soft_wdt_restart () 重新打开软件看 门狗 2. 可以通过在程序段中添加 system_soft_wdt_feed () 来进 行行喂软硬件狗操作, 防 止软硬件看 门狗复位 3.4. 如果我要在程序 里里 面引 入 10 秒的延迟, 怎么做最好? 看 门狗不不 支持 无限循环 如果客户使 用循环做延迟或者进 入 一个事件太 长时间, 就会触发硬件看 门狗重启 推荐使 用 callback 和 timer 的 API 做延迟 如果要轮询事件, 推荐使 用中断和 timer 的 API 来做 大多数事件都是关联到 callback 上的, 所以 大多数情况下, 轮询都是可以避免的 Espressif! 8/!

15 3. 系统 3.5. 对于 Non-OS SDK,memory leak 问题如何 debug? 可通过定义 MEMLEAK_DEBUG 宏启 用 memory leak debug 功能, 代码中调 用 os_malloc, os_zalloc,os_calloc,os_realloc,os_free 可将调 用的 文件以及调 用的对应 行行数记录在内存管理理链表中, 在有需要的地 方通过调 用 system_print_meminfo() 可打印出 heap 区内存分配情况 步骤 : 1. 修改 用户 工程 目录的 MakeFile, 在 CONFIGURATION_DEFINES 后加宏定义 : -DMEMLEAK_DEBUG 如 :CONFIGURATION_DEFINES = -DMEMLEAK_DEBUG 2. 在 用户代码, 如 user_main.c 中, 增加如下代码 : #include mem.h" bool ICACHE_FLASH_ATTR check_memleak_debug_enable(void) { return MEMLEAK_DEBUG_ENABLE; } 3. 在有可能内存泄露露的地 方调 用 system_print_meminfo(), 建议仅在关键代码位置加 入此函数进 行行 debug 3.6. 对于 RTOS SDK,memory leak 问题如何 debug? 暂不不 支持该功能 可以参考 FreeRTOS 官 网的 debug 方法 3.7. 如何优化 ESP8266 应 用的内存使 用? 通过以下四种 方法可以优化 ESP8266 应 用的内存使 用, 减少应 用的内存占 用空间 1. 将字符串串放到 Flash 中 : 有些字符串串可以放在 Flash 中, 特别是 长字符串串, 例例如 HTML 请求和响应模板 比如, 一个字符串串原来是 用 define 定义的 : #define test_string "hello world" 现在可以定义成如下 : static const char test_string[] ICACHE_RODATA_ATTR = "hello world"; 当 用 ICACHE_RODATA_ATTR 定义字符串串常量量时, 需要对数据内容进 行行四字节对 齐读取 由于 Flash 中的数据需要四字节对其读取, 所以定义 一个宏获取对 齐后的字符串串 长度 : #define GET_ALIGN_STRING_LEN(str) ((strlen(str) + 3) & ~3) Espressif! 9/!

16 3. 系统 使 用字符串串时, 动态分配 一个新的数组对象, 读写 Flash 中的数据 然后 用 os_memcpy API 来复制数据内容 : unsigned int str_len = GET_ALIGN_STRING_LEN(test_string); char *tmp_string = (char *)os_malloc(str_len); os_memcpy(tmp_string, test_string, str_len); 在 用户的应 用代码 里里使 用 tmp_string 进 行行操作, 而不不使 用 test_string 此 方法除了了减少应 用的 RAM 占 用空间, 也能解决由于对 Flash 中的数据进 行行 非对 齐读取时, 在应 用中引起的 exception. 当 用户代码中, 无需再使 用通过以上 方法读取的数据, 需要释放之前分配的内存空间 os_free(tmp_string); 注意 : 如果不不释放之前分配的内存空间, 重复分配内存将会减少核 心功能所需的内存, 导致 API 出现功能异常 或失败 2. 把 const 数据放到 Flash: uint32 类型的数组可以直接放到 Flash, 比如 : const uint32 array[4] ICACHE_RODATA_ATTR = {0x , 0x , 0x , 0x }; 可以直接使 用 array[0] 对于 uint8 和 uint16 类型的数组, 要注意读取数据的时候要四字节对 齐, 比如 : const uint8 array[7] ICACHE_RODATA_ATTR = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07}; 如果需要按字节读取 char 数组当中的元素, 可从软件上进 行行处理理, 先按四字节读取, 然后再按偏移取当中的 一个字节 如果直接读取 array[0], 会导致 crash 对于数据结构, 通常做法是分配 比 用户需要读取的结构更更 大的内存, 从 Flash 四字节读 取数据到内存 如同 方法 1, 在代码中依然使 用对象指针 修改代码操作内存中的数据 结构, 而不不是读取数组 3. 将调试字符串串放到 Flash 中 : 现在默认的 printf 打印的字符串串都还是放在 RAM 区, 占 用部分内存 如果 用户 无需频繁 打印 日志 文件, 或者调试字符串串太 长, 可以使 用优化的 os_printf 把打印的字符串串放到 Flash 而不不是 RAM 中 4. 避免使 用全局数组变量量 : Espressif! 10/!

17 3. 系统 全局数组变量量会在应 用的整个 生存期中占 用不不必要的内存 为减少全局数组变量量的使 用, 乐鑫提供了了动态内存分配 API 在基于事件的编程中, 请使 用 os_malloc 和 os_free 来动 态分配所需的内存空间 但注意, 我们不不建议过于频繁地分配和释放 大 小不不等的内存空间 3.8. 发 生 fatal exception 问题如何处理理? 可以在 (*.S) 文件中找出对应的地址, 添加打印以便便定位问题 Fatal exception (28): epc1=0x4025bfa6, epc2=0x , epc3=0x , excvaddr=0x f, depc=0x 比如使 用的是 user1.bin, 那么就在 user1.s 中找到 0x4025bfa6 地址, 并查明对应的函 数 如果使 用的是 flash.bin 和 irom0text.bin, 可以在 eagle.s 中查找出错的地址 3.9. ESP8266 总共有 几个 timer? ESP8266 有 2 个 timer 一个硬件的 timer, 一个软件的 timer API os_timer 是 DSR 处理理, 不不能产 生中断, 但是可以产 生任务 任务会按照普通等级排队 硬件 timer 能产 生中断和任务, 中断能触发任务, 任务按照普通等级排队 使 用 timer 中断是否有特定条件? 请参考 SDK 的 API 参考 : ESP8266 Non-OS SDK API 参考 和 ESP8266 RTOS SDK API 参考 一般情况, 使 用 Non-OS SDK 时, 硬件中断回调 里里 面不不要有声明为 ICACHE_FLASH_ATTR 的功能 同时中断回调 里里不不要占 用 CPU 太 长时间 如何调整 Tx Power? system_phy_set_max_tpw 用于设置 RF Tx Power 最 大值, 单位 :0.25 dbm 目前 Flash download tool 中已开放给客户 自 行行配置并 生成 esp_init_data_default.bin 其中关于 Tx power 的调整如下所示 : LowPowerEn: 同时设置每个模式下的 Tx Power BackOffEn: 同时设置每个模式下 TX Power 需要减 小的值 PowerLimitEn: 限制 Tx Power 的最 大值 Espressif! 11/!

18 ! 3. 系统 设置确认之后点击 GenInitBin, 并替换原先的 esp_init_data_default.bin 为什什么 ESP8266_Non-OS_SDK 中有的函数前 面添加了了 ICACHE_FLASH_ATTR 宏? 对于 ESP8266_Non-OS_SDK: 添加了了 ICACHE_FLASH_ATTR 宏的函数, 将存放在 IROM 中,CPU 仅在调 用到它们的时候, 将它们读到 cache 中运 行行 ; 没有添加 ICACHE_FLASH_ATTR 宏的函数, 将在 一开始上电运 行行时, 就加载到 IRAM 中运 行行 ; 由于空间有限, 我们 无法将所有代码都 一次性加载到 IRAM 中运 行行, 因此在 大部分函数前添加 ICACHE_FLASH_ATTR 宏, 放在 IROM 中 请注意, 不不要在中断处理理函数中调 用带有 ICACHE_FLASH_ATTR 宏的函数, 否则可能与 Flash 读写操作冲突 对于 ESP8266_RTOS_SDK: 函数默认存放在 IROM 中, 无需再添加 ICACHE_FLASH_ATTR 宏 中断处理理函数也可以定义在 IROM 中 如果开发者需要将 一些频繁调 用的函数定义在 IRAM 中, 在函数前添加 IRAM_ATTR 宏即可 为什什么编译 Non-OS SDK 时会发 生 IRAM_ATTR 错误? 如果需要在 IRAM 中执 行行功能, 就不不需要加 ICACHE_FLASH_ATTR 的宏, 那么该功能就是放 在 IRAM 中执 行行 为什什么编译的时候会发 生 irom0_0_seg 错误? 它表示代码量量太 大,IROM 区域存放不不下了了 我们可以在 SDK_v0.9.5( 及之后 ) 的软件版本中, 尝试如下步骤, 解决这个问题 : Espressif! 12/!

19 3. 系统 1. 使 用默认设置, 编译 生成 eagle.flash.bin 和 eagle.irom0text.bin (1) 如果 size of eagle.flash.bin + size of eagle.irom0text.bin >= 236KBytes: 很抱歉, 您的代码量量太 大了了, 只能换 大些的 Flash (2) 如果 size of eagle.flash.bin + size of eagle.irom0text.bin < 236KBytes: 请继续步骤 2 2. 在路路径 SDK/ld 下修改 文件 eagle.app.v6.new.512.app1.ld irom0_0_seg : org = 0x , len = 0x2B000 根据步骤 1 中编译的 eagle.irom0text.bin 大 小, 改写上述 len 的值 示例例 : 如果 eagle.irom0text.bin 大 小为 179 KB, 则可修改配置如下 : irom0_0_seg : 3. 重新编译 user1.bin 选择 boot_v1.2+ org = 0x , len = 0x2D000 补充说明 : 代码中, 函数前未加 ICACHE_FLASH_ATTR 的, 编译到 IRAM 中, 最 大 32 KB; 函数前加了了 ICACHE_FLASH_ATTR 的, 编译到 IROM 中 ; 因为 RAM 的空间有限, 因此做了了这两个部分的区分 : IRAM 中的代码, 会在上电初始就完整加载到 RAM 中 ; IROM 中的代码是 用到的时候才从 Flash 加载到 cache 中执 行行 ESP8266 有 main 吗? ESP8266 没有 main, 程序 入 口为 user_init 操作指针有什什么需要注意的? 内存必须 4 字节对 齐读取, 指针做转换时请确保为 4 字节对 齐, 否则转换失败, 不不能正常使 用 例例如, 请勿直接指针转换 float temp = *((float*)data); 而是使 用 os_memcpy (memcpy) 实现 RTOS SDK 和 Non-OS SDK 有何区别? 主要差异点如下 : Espressif! 13/!

20 Non-OS SDK 3. 系统 Non-OS SDK 主要使 用定时器器和回调函数的 方式实现各个功能事件的嵌套, 达到特定条件下触发特定功能函数的 目的 Non-OS SDK 使 用 espconn 接 口实现 网络操作, 用户需要按照 espconn 接 口的使 用规则进 行行软件开发 RTOS SDK 1. RTOS 版本 SDK 使 用 freertos 系统, 引 入 OS 多任务处理理的机制, 用户可以使 用 freertos 的标准接 口实现资源管理理 循环操作 任务内延时 任务间信息传递和同步等 面向任务流程的设计 方式 具体接 口使 用 方法参考 freertos 官 方 网站的使 用说明或者 USING THE FREERTOS REAL TIME KERNEL - A Practical Guide 这本书中的介绍 2. RTOS 版本 SDK 的 网络操作接 口是标准 lwip API, 同时提供了了 BSD Socket API 接 口的封装实现, 用户可以直接按照 socket API 的使 用 方式来开发软件应 用, 也可以直接编译运 行行其他平台的标准 Socket 应 用, 有效降低平台切换的学习成本 3. RTOS 版本 SDK 引 入了了 cjson 库, 使 用该库函数可以更更加 方便便的实现对 JSON 数据包的解析 4. RTOS 版本兼容 Non-OS SDK 中的 Wi-Fi 接 口 SmartConfig 接 口 Sniffer 相关接 口 系统接 口 定时器器接 口 FOTA 接 口和外围驱动接 口, 不不 支持 AT 实现 哪些接 口需要在 user_init 中调 用, 否则容易易出现问题, 或者不不 生效? 1. wifi_set_ip_info wifi_set_macaddr 仅在 user_init 中调 用 生效, 其他地 方调 用不不 生效 2. system_timer_reinit 建议在 user_init 中调 用, 否则调 用后, 需要重新 arm 所有 timer 3. wifi_station_set_config 如果在 user_init 中调 用, 底层会 自动连接对应路路由, 不不需要再调 用 wifi_station_connect 来进 行行连接 否则, 需要调 用 wifi_station_connect 进 行行连接 4. wifi_station_set_auto_connect 设置上电启动时是否 自动连接已记录的路路由 ; 例例如, 关闭 自动连接功能, 如果在 user_init 中调 用, 则当前这次上电就不不会 自动连接路路由, 如果在其他位置调 用, 则下次上电启动不不会 自动连接路路由 Espressif! 14/!

21 ! 3. 系统 Light-sleep 如何通过 GPIO 或 网络事件唤醒? 在 Light-sleep 模式下,CPU 在暂停状态下不不会响应来 自外围硬件接 口的信号与中断, 因 此需要配置通过外部 GPIO 信号将 ESP8266 唤醒, 唤醒过程 小于 3 ms wifi_station_disconnect(); wifi_set_opmode(null_mode); // set WiFi mode to null mode wifi_fpm_set_sleep_type(light_sleep_t); wifi_fpm_open(); PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U, FUNC_GPIO13); gpio_pin_wakeup_enable(13, GPIO_PIN_INTR_LOLEVEL);// 建议低电平唤醒 wifi_fpm_set_wakeup_cb(ssc_fpm_wakup_call); wifi_fpm_do_sleep(fpm_sleep_max_time); ESP8266 FRC1 的 hw_timer 如何使 用? 1. 模型 : (1) FRC1 的参考时钟为 80 M, 分频系数可以配置为 1 分频,16 分频,256 分频, 不不同的分频, 影响每个 tick 的时 长 (2) FRC1 为递减型 timer, 当 COUNT_VALUE 的值减到 0 后会触发中断 每 一个 tick, COUNT_VALUE 的值都会减 1 (3) FRC1 可以配置为 自动填装模式和 非 自动填装模式 自动填装模式 : 当发 生中断后,COUNT_VALUE 会 自动取 FRC1_LOAD_VALUE 的值, 放到本身, 做 自减操作 非 自动填装模式 : 当发 生中断后,COUNT_VALUE 会切到最 大值 0x7fffff 开始计 Espressif! 15/!

22 3. 系统 (4) FRC1 的中断可以配置为 FRC1 中断源和 NMI 中断源 NMI 中断被称为 CPU 不不可屏蔽中断 NMI 中断在 ESP8266 对应 LEVEL3 的中断, 其他中断对应 LEVEL1 的中断,NMI 中断可以打断任意 比其优先级低的中断 2. 关于 SDK HW_TIMER 的注意事项 SDK 中 hw_timer 的分频系数为 16, 每个 tick 的时 长为 0.2 μs hw_timer_arm 函数配置的参数单位为 μs, 最 大值为 μs 如何让 ESP8266 上电后快速连接 AP? ESP8266 与某个 AP 连接后, 会将该 AP 的信道信息存储在 RTC memory 中 当软件复位 ESP8266, 或 ESP8266 从 Deep-sleep 模式中唤醒之后,ESP8266 会从 RTC memory 中读取 AP 的信道信息, 并尝试连接该信道中的 AP 但如果上电启动或硬件复位 ESP8266,RTC memory 会被清空 因此,ESP8266 会扫描所有的信道, 这会占 用 一些时间 用户上电启动或硬件复位 ESP8266 时, 可通过以下 方式存储 AP 的信道信息, 以避免 ESP8266 重新扫描所有信道寻找上次连接的 AP 这将有助于减少 ESP8266 启动后的连接时间 在 ESP8266 与 AP 连接后, 调 用函数 wifi_get_channel 来读取当前 AP 的信道信息, 然后将该信息存储到 SPI Flash 中 在写 入 AP 的信道信息之前, 请确保该信道信息有效 ESP8266 上电或硬件复位时, 用户固件将从 Flash 中读取之前存储的信道信息 通过调 用函数 WRITE_PERI_REG(0x600011f4, 1 << 16 channel) 将该 AP 的信道信息写 入 RTC memory 中 之后便便可以从 RTC memory 获取信道信息, 加快 ESP8266 与 AP 的连接 使能 自动连接功能后,ESP8266 会从 RTC memory 中读取 AP 的信道信息, 并尝试连接该信道中的 AP 只有信道信息会被存储在 RTC memory 中 当调 用函数 wifi_station_set_config 时, 配置的其它信息 ( 比如 SSID 和密码 ) 已存储在 Flash 中 注意 : 如果应 用要求 ESP8266 频繁上电或硬件复位, 建议客户使 用 片外 RTC memory 来备份信道信息 由于 Flash 内存的写 入周期有限, 不不建议对 Flash 内存频繁地写 入 Espressif! 16/!

23 3. 系统 为什什么 ESP8266 进 入启动模式 (2,7) 并触发看 门狗复位? 请确保 ESP8266 启动时,strapping 管脚处于所需的电平 如果外部连接的外设使 strapping 管脚进 入到错误的电平,ESP8266 可能进 入错误的操作模式 在 无有效程序的情况下, 看 门狗计时器器将复位芯 片 因此在设计实践中, 建议仅将 strapping 管脚 用于连接 高阻态外部器器件的输 入, 这样便便不不会在上电时强制 strapping 管脚为 高 / 低电平 ESP8266 上电时打印的 boot 模式信息代表什什么? 如何改变 boot 模式? ESP8266 上电时会判断 boot strapping 管脚的状态, 并决定 boot 模式 例例如,ESP8266 上电时打印的 boot 模式信息如下 : ets Jan ,rst cause:1, boot mode:(3,2) 其中打印的 boot mode 的第 一位数字 (3) 代表当前的 boot 模式 Boot 模式由 strapping 管脚的 3 位值 [GPIO15,GPIO0,GPIO2] 共同决定 如下表所示 : Strapping 管脚的 3 位值 /[GPIO15,GPIO0, GPIO2] Boot 模式 7 / [1,1,1] SDIO HighSpeed V2 IO 6 / [1,1,0] SDIO LowSpeed V1 IO 5 / [1,0,1] SDIO HighSpeed V1 IO 4 / [1,0,0] SDIO LowSpeed V2 IO 3 / [0,1,1] Flash Boot 2 / [0,1,0] Jump Boot 1 / [0,0,1] UART Boot 0 / [0,0,0] Remapping Espressif! 17/!

24 4. 硬件 4. 硬件 4.1. ESP8266 电压电流需求? ESP8266 的数字部分的电压范围是 1.8 V ~ 3.3 V 模拟部分的 工作电压是 3.0 V ~ 3.6 V, 最低 2.7 V 模拟电源峰值 350 ma 数字电源峰值 200 ma 注意 : 选择的 SPI Flash 工作电压也需要与 GPIO 的电压匹配 CHIP_EN 还是 工作在 3.0 ~ 3.6 V, 使 用 1.8 V GPIO 控制时需要注意电平转换 4.2. 设计 ESP8266 的供电时, 需要注意哪些问题? 请注意如下 几点 : 1. 如果是使 用 LDO 变压, 请确保输 入电压和输出电压要 足够 大 2. 电源轨去耦电容器器必须接近 ESP8266 摆放, 等效电阻要 足够低 3. ESP8266 不不能直连 5 V 电压 4. 如果是通过 DC-DC 给 ESP8266 供电, 必要时要加上 LC 滤波电路路 4.3. ESP8266 上电时电流很 大, 是什什么原因? ESP8266 的 RF 和数字电路路具有极 高的集成度 上电后,RF 自校准会需要 大电流 模拟部分电路路最 大的极限电路路可能达到 500 ma; 数字电路路部分最 大电流达到 200 ma 一般的操作, 平均电流在 100 ma 左右 因此,ESP8266 需要供电能达到 500 ma, 能够保证不不会有瞬间压降 4.4. 可以使 用锂电池或者两节 AA 纽扣电池直接给 ESP8266 供电吗? 两节 AA 纽扣电池可以给 ESP8266 供电 锂电池放电时压降 比较 大, 不不适合直接给 ESP8266 供电 ESP8266 的 RF 电路路会受温度及电压浮动影响 不不推荐不不加任何校准的电源直接给 ESP8266 供电 推荐使 用 DC-DC 或者 LDO 给 ESP8266 供电 Espressif! 18/!

25 ! 4. 硬件 4.5. SPI Flash 上电时, 是否有特殊需求? SPI Flash 用于存储 用户的程序和数据 为了了保证兼容性,SPI Flash 的电压应该和 GPIO 的电压相匹配 4.6. 上电时序是怎样的,boot 模式是如何选择的? CHIP_EN 上电时序要求 :CHIP_EN 芯 片使能管脚, 内部 无上拉, 高电平有效 CHIP_EN 的上电要晚于或同时与系统电源 3.3 V 上电 一般 CH_EN 有外接 RC 电路路, 延时 大概在 μs 级即可 CHIP_EN 拉 高 大概 60 ms 后, 设备判断 boot mode {GPIO15, GPIO0, GPIO2}, 之后 UART 即可通讯 EXT_RSTB: 外部复位管脚, 内部有上拉, 悬空即为 高电平 EXT_RSTB 为电平触发, 低电平触发芯 片复位 如果是外部给 ESP8266EX 的 reset 信号, 则最低要求 (0.25 VIO, 100 μs) 描述最 小值最 大值单位 t1 VDD33 上升时间 μs t2 EXT_RSTB 上升时间 0 2 ms t3 EXT_RSTB 电平在 VDD33 电 平为 高后上升 ms t4 CHIP_EN 上升时间 0 2 ms t5 CHIP_EN 电平在 EXT_RSTB 电为 高后上升 ms Espressif! 19/!

26 4. 硬件 4.7. ESP8266 的 RAM 的使 用结构是怎么的? ESP8266 的 RAM 总共 160 KB IRAM 空间为 64 KB: 前 32 KB 用作 IRAM, 用来存放没有加 ICACHE_FLASH_ATTR 的代码, 即.text 段, 会通过 ROM code 或 二级 boot 从 SPI Flash 中的 BIN 中加载到 IRAM; 后 32 KB 被映射作为 icache, 放在 SPI Flash 中的, 加了了 ICACHE_FLASH_ATTR 的代码会被从 SPI Flash 自动动态加载到 icache DRAM 空间为 96 KB: 对于 Non-OS_SDK, 前 80 KB 用来存放.data/.bss/.rodata/heap,heap 区的 大 小取决于.data/.bss/.rodata 的 大 小 ; 还有 16 KB 给 ROM code 使 用 对于 RTOS_SDK,96 KB 用来存放.data/.bss/.rodata/heap,heap 区的 大 小取决于.data/.bss/.rodata 的 大 小 Espressif! 20/!

27 5. 外设 5. 外设 5.1. ADC 的性能参数有 几个通道? 采样率和有效位数是多少? 通道 :1 采样率 : 停 止 Wi-Fi 的情况下, 能达到每秒 次 Wi-Fi 正常 工作的情况下, 能达到每秒 1000 次 有效位数 : 内部 ADC 有效位数为 12 位 system_adc_read()//api 返回值的有效位数是 10 位 5.2. 从哪 里里可以得到 ADC 的寄存器器 bitmap 信息? ADC 是和内部 RF 电路路 高度集成的, 所以 bitmap 和寄存器器信息没有公开, 如有特殊需求请与技术 支持联系 5.3. ADC 的精度如何? ESP8266 连接路路由器器后, 单 STA 模式会进 入 modem-sleep, 导致芯 片内部电流发 生变化, 参考值变化, 因此 ADC 采集异常 用户如果需要测量量的 非常准确, 可以 用 system_adc_fast_read 的函数, 但是测量量之前需要关闭 RF,Wi-Fi 连接会断开 如果需要测试 比较准确, 数值相差 1, 或 2, 可以配置 Wi-Fi 为 non-sleep 模式 wifi_set_sleep_type(none_sleep_t); 建议该 用户这样配置 如果对精确性要求不不 高, 可以允许模块进 入 sleep 模式, 功耗较低 5.4. 内部 ADC 的 用途是什什么? 内部 ADC 可以 用于温度检测和粗略略地测量量外部设备电流 由于 ADC 容易易受噪声影响, 所以推荐只在低精度的需求时使 用 比如熔断机制 5.5. (u8 tx_addr, u8 tx_cmd, u8 tx_rep) 这三个参数是什什么意思? tx_addr 是发送地址 ; Espressif! 21/!

28 ! 5. 外设 u8 tx_cmd 是发送指令 ; u8 tx_rep 是重复发送的次数 5.6. 为什什么 ESP8266 上电时会出现乱码? 如何修改波特率? 如果使 用的是 26 MHz 晶振,ESP8266 UART0 上电后的波特率是 74880, 所以上电时会 有乱码 客户可以在 user_main.c 里里 面修改 UART 配置, 比如 : void ICACHE_FLASH_ATTR uart_init(uartbautrate uart0_br, UartBautRate uart1_br) { // rom use baut_rate, here reinitialize UartDev.baut_rate = uart0_br; uart_config(uart0); UartDev.baut_rate = uart1_br; uart_config(uart1); } 5.7. 如何使能 UART 流控? 1. UART 通信时, 如需配置 UART 通信的数据格式, 请参考 SDK/driver_lib/driver/ 路路径 下的 uart.c 文件 2. UART 通信, 如需配置硬件流控, 请执 行行下 面两个步骤 : (1) 请在 uart.h 中将下 面的宏置 1 #define UART_HW_RTS 1 //set 1: enable uart hw flow control RTS, PIN MTDO, FOR UART0 #define UART_HW_CTS 1 //set1: enable uart hw flow contrl CTS, PIN MTCK, FOR UART0 (2) 配置硬件流控的 门限值 截图中红 色标注部分为硬件流控的 门限值, 在 RXFIFO 中字节数 大于 110 后,RTS 会被拉 高 Espressif! 22/!

29 5. 外设 5.8. 如何配置信息打印到 UART1 上? UART1 只有 Tx 功能, 可以在 UART0 用于通讯时, 做打印 log 用途 请参考如下代码 : void ICACHE_FLASH_ATTR uart_init_new(void) { // Wait for FIFOs to be emptied UART_WaitTxFifoEmpty(UART0); UART_WaitTxFifoEmpty(UART1); // Configure UART settings 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_IntrConfTypeDef uart_intr; uart_intr.uart_intrenmask = UART_RXFIFO_TOUT_INT_ENA UART_FRM_ERR_INT_ENA UART_RXFIFO_FULL_INT_ENA; uart_intr.uart_rx_fifofullintrthresh = 100; uart_intr.uart_rx_timeoutintrthresh = 2; uart_intr.uart_tx_fifoemptyintrthresh = 20; UART_IntrConfig(UART0, &uart_intr); // Set UART1 for printing UART_SetPrintPort(UART1); // Register interrupt handler UART_intr_handler_register(uart0_rx_intr_handler); } ETS_UART_INTR_ENABLE(); Espressif! 23/!

30 5. 外设 5.9. SDIO 是否 支持 SD 卡? ESP8266 是 SDIO Slave, 不不 支持 SD 卡 SDIO 最 高速度能 支持到多少? SDIO 时钟能到 50 MHz, 理理论最 高速度是 200 Mbps 为什什么上电时会有 LED 灯闪 一下的情况? 要看灯的驱动是如何设计的 如是低电平灯亮, 并且在上电的时候将 IO 强制拉为低电平, 那么在上电的瞬间可能会出现灯闪 一下 是因为除了了 Flash 相关的 IO 和 GPIO4, GPIO5, 其他 IO 上电后上拉默认使能 解决 方法 : 1. 上电的瞬间,user_init 中将上拉关闭 2. 如第 一条 无效的, 需要我们提供相应的 boot.bin 在该 BIN 被搬到 RAM 的过程 里里,IO 的上拉就会被关闭 这 比 user_init 生效要早 使 用 PWM 时, 发现最开始时有窄波, 是什什么原因? 这个是精度较 高的 PWM 的调节 方式,PWM 的精度可以达到 深度 精度的调节主要靠后 面的窄波 注意这种 方式的 PWM Duty 无法配置为 100% 发现 PWM 的变化缓慢, 是什什么原因? 客户采 用了了 SDK example/iot_demo 中的渐变 API 如 light_set_aim 或 light_set_aim_r 这些 API 使 用的是渐变 方式 不不会 立即 生效, 需要渐变的过程 如 用户需要 PWM Duty 设置后 立即 生效, 需要调 用接 口 pwm_set_duty, 需要注意调 用 pwm_set_duty 后要调 用 pwm_start 此次设置才能 生效 GPIO 可以直接连 5 V 吗? 不不可以 GPIO 只能承受 3.6 V 需要通过降压电路路, 否则会造成 GPIO 损坏 哪 里里能找到 GPIO 的 register 和 bitmap 信息? 请参考 文档 ESP8266 技术参考 Espressif! 24/!

31 5. 外设 如何编程 GPIO? 对于 Non-OS SDK, 比如需要把 MTDO 配置成输 入, 同时下降沿触发中断 : void ICACHE_FLASH_ATTR gpio_init(void) { //GPIO Alternate Function PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDO_U,FUNC_GPIO15); GPIO_DIS_OUTPUT(GPIO_ID_PIN(15)); // Configure it in input mode. ETS_GPIO_INTR_DISABLE(); //Close the GPIO interrupt //Register the interrupt function ETS_GPIO_INTR_ATTACH(GPIO_INTERRUPT,NULL); gpio_pin_intr_state_set(gpio_id_pin(15),gpio_pin_intr_negedge); // Falling edge trigger ETS_GPIO_INTR_ENABLE() ; // Enable the GPIO interrupt } 对于 RTOS SDK, 实现相同的功能 { GPIO_ConfigTypeDef gpio_in_cfg; // Define GPIO Init Structure gpio_in_cfg.gpio_intrtype = GPIO_PIN_INTR_NEGEDGE; // Falling edge trigger gpio_in_cfg.gpio_mode = GPIO_Mode_Input; //Input mode gpio_in_cfg.gpio_pin = GPIO_Pin_15; // Enable GPIO gpio_config(&gpio_in_cfg); // Initialization function GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(GPIO_UART_IN_NUM)); gpio_intr_handler_register(interrupt_gpio_uart); // Register the interrupt function _xt_isr_unmask(1 << ETS_GPIO_INUM); // Enable the GPIO interrupt } 注意 : Non-OS SDK 和 RTOS SDK 的实现 方法稍有不不同 HSPI 每个数据包的 大 小最 大是多少? 数据包每次发送最 大 64 字节数据, 四字节对 齐, 在 memory map 上是连续的 数据可以先传输到 LSB 或者 MSB 中, 低位组在前或 高位组在前, 所以缓存是很灵活的 合理理的使 用 buffer, 可以稳定实现 90% 的时钟速度 Espressif! 25/!

32 5. 外设 对于多设备同时连接到 ESP8266 的情况,HSPI 是如何同时驱动设备的? 与 I2C 接 口不不同,HSPI 时钟不不需要配合最慢的连接设备 HSPI 时钟可以及时的配置为使能的设备 HSPI_CS0 管脚可以 自动选择 对于 LCD 类型的设备, 需要频繁使 用 CS 管脚 如果是连接 高速设备, 需要使 用源端接电阻 如何使 用 64 字节的数据缓存? 使 用函数 CLEAR_PERI_REG_MASK(SPI_USER(spiNum), SPI_USR_MISO_HIGHPART ); 使能 MISO 的 高位传输 如何配置 (H)SPI 接 口? 请参考 Non-OS SDK 下,example/peripheral_test 哪些 API 会保存到 Flash? wifi_station_set_auto_connect wifi_station_ap_number_set wifi_set_phy_mode wifi_softap_set_config wifi_station_set_config wifi_set_opmode system_restart_enhance system_restore system_upgrade_reboot 系统参数是如何保存的? SPI Flash 的最后三个扇区被定义为系统参数区, 其中前两个扇区 用于交替保存系统参数, 最后 一个扇区 用来保存使 用前 面两个扇区的 flag 这样设计的 目的是保证在擦写系统参数区时, 即使在擦写任意 一个扇区时意外掉电, 导致该扇区中数据异常的情况下, 也不不会导致系统的参数异常 Espressif! 26/!

33 5. 外设 Flash 任何位置都可以随意读写吗? 读写操作都需要四字节对 齐 我们推荐对 block 操作, 避免频繁的 小数据读写 可以在所有的 ESP8266 上执 行行同样的 Flash 读写操作吗? 对应不不同的 Flash 大 小, 有着不不同的 Flash map, 所以对应不不同的固件,Flash map 可能不不 一样, 比如对应 8 Mbit 的 Flash, 读写 0x 地址就是 非法的 可否提供 Flash 擦写例例证? uint32 sector 是开始的 sector,uint 32 cnt 是擦除的 sector 数 目 #define FLASH_WRITE_LEN_BYTE (1024*4) #define FLASH_WRITE_CONTENT (0X10) void flash_sector_rw_test(uint32 sector,uint32 cnt) { char* w_data=(char*)os_malloc(flash_write_len_byte); uint32 flash_operate=0; uint32 i=0; uint8 status=0; os_printf("test Sector is 0x%x\n",sector); if(null==w_data){ os_printf("memory little\n"); return; } os_memset(w_data,flash_write_content,flash_write_len_byte); for(i=0;i<cnt;i++){ if(spi_flash_erase_sector(sector+i)==0) { os_printf("erase sector0x%x ok\n",sector+i); } else{ os_printf("err:erase sector0x%x err\n",sector+i); } } for(i=0;i<cnt;i++){ Espressif! 27/!

34 if(spi_flash_write((sector+i)*(flash_write_len_byte), (uint32*)w_data,flash_write_len_byte)==0) } { } else{ } os_printf("write sector 0x%x ok\n",sector+i); os_printf("err:write sector 0x%x err\n",sector+i); for(i=0;i<cnt;i++){ os_memset(w_data,0x00,flash_write_len_byte); if(spi_flash_read((sector+i)*(flash_write_len_byte), (uint32*)w_data,flash_write_len_byte)==0) { uint32 j=0; for(j=0;j<flash_write_len_byte;j++){ if(*(w_data+j)!=flash_write_content){ 5. 外设 os_printf("err Flash read w_data[%d]=0x%x\n",j,w_data[j]); //status=1; } } if(*(w_data+j)==flash_write_content&&j==flash_write_len_byte-1) { os_printf("sector0x%x Test Ok\n",sector+i); } } } else{ os_printf("err:read sector0x%x err\n",sector+i); } } os_free(w_data); w_data=null; Espressif! 28/!

35 5. 外设 如何判断 Flash 是否 支持 QIO 或 DIO 模式? 判断 Flash 是否 支持四线 : 1. QE 在状态寄存器器的 BIT(9) 2. 写状态寄存器器的格式为 01H+StatusReg1+StatusReg2 3. 有读 Flash 的如下命令 : 若是选择 QIO, 必须 支持 EBh 命令 若是选择 QOUT, 必须 支持 6 Bh 命令 判断 Flash 是否 支持两线 : 有读 Flash 的如下命令 : 若是选择 DIO, 必须 支持 BBh 命令 若是选择 DOUT, 必须 支持 3 Bh 命令 特殊的 Flash:ISSI Flash 可以 支持 QIO 模式 为什什么透传过程会丢包? 因为没有设置硬件流控 如果需要避免丢包, 请设置硬件流控 透传功能使 用的是 TCP 协议, 每包数据是 1460( 取决于协议栈 ), 只要 网络良好,buffer 空间没有被消耗完, 就可以不不停地传输数据 对于透传, 串串 口接收数据间隔超过约 20 ms, 就会认为数据接收结束, 将已经接受的数据传输到 网络 如果 网络不不好, 就可能会丢弃 一些数据, 因此, 为避免这种情况, 可以将串串 口设置为流控模式 ESP8266 有 几个 UART? ESP8266 有两个 UART, 其中 UART0 有 TX RX, 可做数据传输 ;UART1 由于 RX 脚被 SPI-Flash 占 用, 只能使 用 TX, 可以做串串 口调试信息打印 GPIO 电平状态是怎样的? 除了了 XPD_DCDC,GPIO 可以配置上拉 关于 GPIO 的上电 IO 口默认状态为 : 除了了 SDIO 6 根线 GPIO4 GPIO5 GPIO16 上电 IO 默认 无上拉, 其他的 GPIO 口均有上拉 由于是内部配置上拉, 所以如需下拉, 需外部加下拉 方式或者加 一个三级管的反相电路路 Espressif! 29/!

36 ! 5. 外设 注意 : GPIO 不不能到 5 V GPIO4/5 外接 1 M 电阻不不能上拉到 高电平 ; 需 100 K 电阻 如何屏蔽上电打印? U0TXD 默认上电有系统打印, 对此敏敏感应 用可通过 UART 的内部引脚交换功能, 在初始化的时候, 调 用 system_uart_swap 函数, 将 U0TXD U0RXD 分别与 U0RTS(MTDO/ GPIO15),U0CTS(MTCK/GPIO13) 交换来屏蔽该上电的系统打印 交换后, 硬件上的下载管脚还是使 用 U0TXD + U0RXD, 通信时需要将 MTDO 对应接到 MCU 的 RXD,MTCK 对应接到 MCU 的 TXD Espressif! 30/!

37 6. 协议 6. 协议 6.1. TCP / UDP 的包 长是多少? 单包数据,TCP 单包 1460 字节,UDP 单包 1472 字节 Espressif! 31/!

38 7. RF 7. RF 7.1. 如何修改默认上电校准 方式? 上电时 RF 初始化默认采 用部分校准的 方案 esp_init_data_default.bin 中第 115 字节为 0x01,RF 初始化时间较短 不不关注上电启动时间, 可修改使 用上电全校准 方案 - 使 用 NONOS SDK 及 RTOS SDK 3.0 以前的版本 : a) 在 user_pre_init 或 user_rf_pre_init 函数中调 用 system_phy_set_powerup_option(3); b) 修改 phy_init_data.bin 中第 115 字节为 0x03 - 使 用 RTOS SDK 3.0 及以后版本 : a) 在 menuconfig 中关闭 CONFIG_ESP_PHY_CALIBRATION_AND_DATA_STORAGE; b) 如果在 menuconfig 中开启了了 CONFIG_ESP_PHY_INIT_DATA_IN_PARTITION, 修改 phy_init_data.bin 中第 115 字节为 0x03; 如果没有开启 CONFIG_ESP_PHY_INIT_DATA_IN_PARTITION, 修改 phy_init_data.h 中第 115 字节为 0x03 继续使 用上电部分校准 方案, 若需在业务逻辑中增加触发全校准操作的功能 - 使 用 NONOS SDK 及 RTOS SDK 3.0 以前的版本 : 擦除 RF 参数区中的内容, 触发全校准操作 - 使 用 RTOS SDK 3.0 及以后版本 : 擦除 NVS 分区中的内容, 触发全校准操作 Espressif! 32/!

39 8. Wi-Fi 8. Wi-Fi 8.1. 设备开启 SoftAP + Station 模式下, 连接的路路由是 X 网段时, 为什什么会失败? ESP8266 SoftAP 默认 IP 地址是 ESP8266 如果要连接 X 的路路由时, 不不能分辨是要连接 自 己本身的 SoftAp 还是外部路路由, 所以会造成错误 8.2. 路路由配置是正确的, 但是发 生找不不到路路由, 连接失败, 为什什么? 如果 SSID 和密码配置是正确的, 可能的原因有 2 个 1. 推荐使 用英 文字符, 不不要使 用中 文 2. 需要注意 bssid_set 的设置, 如果不不需要指定路路由的 MAC 地址, 那么需配置 stationconf.bssid_set = 调 用 wifi_softap_set_config() 时, 函数返回成功, 但为何 无法修 改 ESP8266 的 SoftAP SSID 和密码? 使 用函数 wifi_softap_set_config() 时, 如果 API 从回调函数内部调 用,ESP8266 SoftAP 的配置有时候会修改失败 例例如, 当应 用程序试图在 SoftAP 事件的回调函数内, 从 SoftAP 模式切换到 Station 模式时, 可能出现这种情况 为确保 wifi_softap_set_config() 所做的修改 立即 生效, 请使 用 system_os_task() API 创建 一个更更改 SoftAP 设置的任务 在调 用任何 SoftAP API 之前, 请确保 ESP8266 已成 功切换到 SoftAP 模式 例例如 : LOCAL void ICACHE_FLASH_ATTR some_callback_function (void) { unsigned char res; os_event_t *testqueue; res = wifi_set_opmode_current (0x02); 模式 os_printf ("\r\nset op mode returned: %d", res); testqueue = (os_event_t *)os_malloc(sizeof(os_event_t)*4); // 确保 ESP8266 处于 SoftAP Espressif! 33/!

40 8. Wi-Fi! } system_os_task (set_ap_config, USER_TASK_PRIO_1, testqueue, 4); ap_server_setup (AP_PORT); // 继续设置服务器等 void set_ap_config (os_event_t *e) { struct softap_config ap; wifi_softap_get_config(&ap); // 先获得之前的设置 os_memset(ap.ssid, 0, 32); os_memset(ap.password, 0, 64); os_memcpy(ap.ssid, "SSIDhere", 8); os_memcpy(ap.password, "PASSWDhere", 10); ap.authmode = AUTH_WPA2_PSK; ap.ssid_len = 0; // 或者 SSID 的实际 长度 ap.max_connection = 1; 数量 wifi_softap_set_config (&ap); 置 } // 允许接入 Station 的最大 // 更新 ESP8266 SoftAP 设 8.4. ESP8266 SoftAP + Station 模式下 网络断开或丢包的情况? 虽然 ESP8266 支持 SoftAP + Station 共存模式, 但是 ESP8266 实际只有 一个硬件信道, 由 ESP8266 Station 与 SoftAP 接 口共 用 因此在 SoftAP + Station 模式时,ESP8266 SoftAP 会动态调整信道值与 ESP8266 Station 一致 这个限制会导致 ESP8266 SoftAP + Station 模式时 一些 行行为上的不不便便, 用户请注意 例例如 : 情况 一 - 如果 ESP8266 Station 连接到 一个路路由 ( 假设路路由信道号为 6); - 通过接 口 wifi_softap_set_config 设置 ESP8266 SoftAP; - 若设置值合法有效, 该 API 将返回 true, 但信道号仍然会 自动调节成与 ESP8266 Station 接 口 一致, 在这个例例 子 里里也就是信道号为 6 情况 二 - 调 用接 口 wifi_softap_set_config 设置 ESP8266 SoftAP( 例例如信道号为 5); - 其他 Station 连接到 ESP8266 SoftAP; Espressif! 34/!

41 8. Wi-Fi! - 将 ESP8266 Station 连接到路路由 ( 假设路路由信道号为 6); - ESP8266 SoftAP 将 自动调整信道号与 ESP8266 Station 一致 ( 信道 6); - 由于信道改变, 之前连接到 ESP8266 SoftAP 的 Station 的 Wi-Fi 连接断开 情况三 - 其他 Station 与 ESP8266 SoftAP 建 立连接 ; - 如果 ESP8266 Station 一直尝试扫描或连接某路路由, 可能导致 ESP8266 SoftAP 端的连接断开, 或者 UDP 丢包,ping 丢包等情况 因为 ESP8266 Station 会遍历各个信道查找 目标路路由, 意味着 ESP8266 其实在不不停切换信道,ESP8266 SoftAP 的信道也因此在不不停更更改 这可能导致 ESP8266 SoftAP 端的原有连接断开, 或者 UDP 丢包,ping 丢包等情况 这种情况, 用户可以通过设置定时器器, 超时后调 用 wifi_station_disconnect 停 止 ESP8266 Station 不不断连接路路由的尝试 ; 或者在初始配置时, 调 用 wifi_station_set_reconnect_policy 和 wifi_station_set_auto_connect 禁 止 ESP8266 Station 尝试重连路路由 8.5. Wi-Fi 信道是什什么? 可以 自 行行选择信道吗? 信道指的是 Wi-Fi 使 用的指定频段中特定频率的波段 不不同国家地区使 用的信道数 目是不不同的 用户可以参考 ESP8266 Wi-Fi 信道选择指南 8.6. 如何配置 ESP8266, 以便便连接到 无线路路由器器? 有关配置连接 无线路路由器器, 一般有以下 几种 方式 : 1. smartconfig 一键配置 方式, 设备在 sniffer 模式扫描特征包的 方式 2. 设备开启 SoftAP, 手机连接 SoftAP 后建 立稳定的 TCP/UDP 连接后, 发送 SSID 和密码 3. WPS 配置 方式, 此 方式需要设备中增加按键 ; 或连接到设备的 SoftAP 后使 用 手机软件控制开启 WPS Espressif! 35/!

42 9. 工具 9. 工具 9.1. 测试和 生产时如何烧录 Flash? 测试时, 通过 UART 转 USB 芯 片, 使 用乐鑫提供的 Flash 下载 工具进 行行烧录, 具体 方法参 见 文档 ESP8266 SDK 入 门指南 下载 工具 : 下载 方法 : 生产时, 使 用 UART 接 口烧录 Flash 不不 方便便, 使 用 厂商提供的下载 工具可以加快这 一过程 用户可以使 用乐鑫的 Flash 下载 工具把 BIN 文件合成 一个完整的固件, 通过 Flash 厂商提供的下载器器, 下载到 Flash 里里 面, 再贴 片到模组或产品上 说明 : Flash mode,flash speed,flash size 选项要在 combine 前选好, 再执 行行 combine 键, 即可得到 target.bin Espressif! 36/!

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