新物
ESP32 是什么？先看懂你要做的小智 AI
用一台会聊天的小装置认识开发板、固件与智能体，再选适合自己的成品或面包板路线。第一次做小智，可以从现成固件开始。
现成固件与排错 · 2 张图阅读图文ESP32 动手实验室从第一块板子，到你的 AI 小硬件。
给想动手的好奇心，一个起点。
选定路线 · 跟着示例 · 检查结果
小小一块板，大大一个想法。让想法，
让想法，
在现实里有个回应。
一块开发板，加一点好奇心。
选定一条路线，从灯光、数据或一次对话开始，慢慢做出自己的小装置。
CHOOSE YOUR NEXT BUILD
从你想做的事，选一条路线。
只列出已有完整教程的系列，按前置关系逐步学习。
15 篇教程
做第一台小智
硬件准备、现成固件、配网与故障排查。
进入系列 10 篇教程认识板子与开发环境
认清型号、选定路线，再运行第一个程序。
进入系列 10 篇教程输入输出与编程
灯、按钮、计时与总线，建立独立调试的基本功。
进入系列 10 篇教程传感器与可信数据
从读到数值，到知道数据是否可信。
进入系列 10 篇教程家庭自动化
将自己的传感器和控制器接入家庭。
进入系列 10 篇教程显示屏与桌面作品
把状态、数据和交互放到屏幕上。
进入系列 10 篇教程联网与数据交换
连接、传输、恢复，让数据可靠到达。
进入系列 10 篇教程故障定位与升级
记录现场，定位原因，安全恢复。
进入系列 10 篇教程ESP-IDF 工程能力
将单个示例变为能维护的工程。
进入系列 10 篇教程低功耗与电池
测量真实耗电，建立可维护的电池节点。
进入系列 10 篇教程视觉与机电作品
从图像到判断，再到可控动作。
进入系列 10 篇教程AI 语音与工具
分段验证声音、命令和实际动作。
进入系列 10 篇教程无线与 USB 拓展
按任务选择 ESP-NOW、BLE 与 USB。
进入系列BUILD YOUR FIRST XIAOZHI
做第一台小智，沿着这条路开始。
参考官方教程，按步骤操作，逐步检查结果。
- 01准备硬件与接线
做第一台小智 AI：硬件清单、选板与接线准备
- 02刷入小智固件
小智 AI 浏览器刷机教程：选固件、连接、烧录与排错
- 03配网、激活与对话
小智 AI 配网与激活：从 Wi-Fi 热点到第一次对话
这条路线使用匹配的现成固件，可以先从操作开始。已有刷好固件的设备，可直接进入配网与激活。 小智官方教程 ↗
THE ESP32 FIELD NOTES
从一个问题，开始动手。
135 篇已发布文章 · 可按系列、框架、芯片与难度查找
零基础入门
认识器件，读懂固件与接线。
做第一台小智 AI：硬件清单、选板与接线准备
按官方 ESP32-S3 面包板 Wi-Fi 方案整理开发板、麦克风、功放、喇叭和线材，讲清 N16R8、板型版本与接线图怎样对应。
现成固件与排错 · 8 张图阅读图文
小智固件怎么选？看懂包名、屏幕版本与合并文件
面对一长串小智固件下载项，按芯片、板型、网络和屏幕逐项缩小范围。用 v2.5.2 的实际包名说明 Wi-Fi、4G、128×32、128×64 与 merged-binary.bin 的区别。
现成固件与排错 · 2 张图阅读图文
小智接线里的 Simplex 和 Duplex，到底差在哪？
两张音频接线表都来自官方，却不一定能混着用。用麦克风与功放的时钟线解释 I2S Simplex / Duplex，并说明它们与能否打断对话的区别。
现成固件与排错 · 2 张图阅读图文
ESP32、S3、C3、C6 怎么选？先按你要做的项目筛一遍
从温湿度联网、语音显示和 USB 键盘三个实际任务出发，分清芯片、模组与开发板，核对 Wi-Fi、蓝牙、802.15.4、存储和 USB 能力。
基础闭环 · 2 张图阅读图文
Arduino、ESP-IDF、MicroPython、ESPHome，第一步选哪条路？
按串口小程序、系统开发、Python 交互和 Home Assistant 实体四种完成物选择起点，分清代码、解释器、YAML 与设备固件的关系。
基础闭环 · 2 张图阅读图文
ESP32 引脚怎么查？GPIO、板上编号和保留引脚一次分清
以 DevKitC-1 v1.1 N8R8 为唯一参考板，从 J1/J3 排针追到 GPIO 与程序参数，排除 PSRAM、USB、启动和板载器件冲突。
基础闭环 · 2 张图阅读图文
面包板和 3.3V 怎么接？先搭一个不会接错电源的小电路
不用程序，先用 3V3、1kΩ 电阻和具体型号红 LED 完成常亮回路，学会面包板连通关系、极性检查、共地与断电恢复。
基础闭环 · 2 张图阅读图文
Arduino IDE 配好 ESP32：从安装开发板包到编译第一份代码
固定 Arduino IDE 2.3.8、CLI 1.5.1 与 Espressif core 3.3.12，在 Windows、macOS 和 Linux 中安装同一开发板包，编译官方 GetChipID。
基础闭环 · 2 张图阅读图文
ESP32 第一次上传：选串口、进下载模式、读启动日志
固定使用 DevKitC-1 v1.1 的 USB-to-UART 接口，从编译、下载模式到 UART0 日志，再把程序标记 A 改 B 完成两次上传验收。
基础闭环 · 2 张图阅读图文
ESP32 接线前怎么核对模块？把供电、信号和库版本写成清单
拿 Kingbright 两脚红 LED、Adafruit SHT40 PID4885 与 SSD1306 OLED PID326 分别填清供电、信号、地址、修订和库版本，建立可复用接线记录。
基础闭环 · 2 张图阅读图文
乐鑫文档怎么读？从芯片型号找到正确版本和可运行例程
以S3开发板、Arduino LEDC和IDF例程三个具体问题，练习辨认芯片手册、板级修订、框架文档与固定源码。给出可填写的阅读记录和错误入口恢复路径。
家庭与桌面作品 · 2 张图阅读图文动手实战
从刷机到配网，做好升级准备。小智 AI 浏览器刷机教程：选固件、连接、烧录与排错
以 ESP32-S3 面包板 Wi-Fi 方案为例，用 ESP Launchpad 写入合并固件，逐步核对下载包、USB 串口、0x0 地址和启动结果。
现成固件与排错 · 4 张图阅读图文
小智 AI 配网与激活：从 Wi-Fi 热点到第一次对话
已刷好小智固件后，连接 Xiaozhi 热点、打开 192.168.4.1、配置家中网络，再创建智能体并用六位码添加设备。每一步附成功标志。
现成固件与排错 · 5 张图阅读图文
小智升级固件前先看：版本、分区变化与回退准备
设备已经能用，升级时更要保存成功配置。参考官方 v2.5.2 说明，区分 v1.x 到 v2.x 的迁移条件，准备匹配固件、记录原配置，并分阶段验证结果。
现成固件与排错 · 2 张图阅读图文
ESP32 点亮第一盏灯：外接 LED 和板载 RGB 灯要分开看
从GPIO4和330Ω限流电阻搭起第一盏灯，再解释DevKitC-1 v1.1的GPIO38可寻址RGB为什么不能照搬普通LED程序。附Arduino 3.3.12完整源码、接线与重启检查。
基础闭环 · 2 张图阅读图文
按钮按一次为什么触发多次？给 ESP32 加上消抖
机械触点会在一次动作中来回跳变。本篇用30毫秒稳定窗口和下降沿计数，完成按钮切灯、30次计数与长按检查，避免用delay掩盖问题。
基础闭环 · 2 张图阅读图文
不用 delay 同时做两件事：让按钮和闪灯一起工作
把按钮消抖、两档闪烁和循环间隔日志放进同一个loop，用无符号时间差处理millis回绕。包含可立即执行的合成时间戳检查与响应记录方法。
基础闭环 · 2 张图阅读图文
ESP32 PWM 调光：用新版 LEDC 做一个五档小灯
使用Arduino-ESP32 3.3.12的ledcAttach和按引脚ledcWrite，制作0到255的五档按钮调光器，记录API返回值，并区分占空比、频率与肉眼亮度。
基础闭环 · 2 张图阅读图文
ESP32 读电压：ADC 原始值、毫伏与三点测量方法
用受限电位器输入、GPIO1和32点采样窗口，区分12位raw与analogReadMilliVolts校准值。提供三点万用表比较步骤与空白记录表，不虚构实测误差。
基础闭环 · 2 张图阅读图文
I2C 扫不到设备？从 SDA、SCL 和地址开始检查
明确S3的GPIO8/GPIO9和Adafruit SHT40的3.3V接法，运行带超时与目标探测的扫描器。逐步复现正常、断SDA与错误地址，保留错误码和恢复路径。
基础闭环 · 2 张图阅读图文
做一个 ESP32 温湿度计：先把 SHT40 数据读对
给指定 SHT40 模块接好电源与 I2C，用锁定版本的 Sensirion 库读取带 CRC 检查的温湿度。完整示例遇到断线输出 NA，恢复后重新确认数据有效。
基础闭环 · 2 张图阅读图文
ESPHome 第一个设备：不写 C++，把一个按钮接进 Home Assistant
固定ESPHome2026.9.1与IDF5.5.5，完成按钮状态、外接LED开关、首次USB写入、HA加密API集成和可识别的OTA验收。
基础闭环 · 2 张图阅读图文
ESPHome 温湿度节点：把 SHT40 接进 Home Assistant 看历史
用固定SHT40模块与完整YAML发布温湿度，增加35秒陈旧超时、数据有效标记与HA不可用模板，再检查Recorder和HA重启后的历史边界。
基础闭环 · 2 张图阅读图文
BME280 和 BMP280 买错了怎么办？先读标识，再做气压环境节点
固定Adafruit模块读取0xD0，区别BME280三项与BMP280两项能力，提供完整ESPHome主例/替代配置、单位和断线不可用处理。
基础闭环 · 2 张图阅读图文
ESP32 OLED 第一屏：显示传感器数值和异常状态
固定SSD1306 128×64与SHT40模块，显示温湿度或明确错误；用单独I2C任务隔离整帧发送，主循环继续给按钮消抖。附完整依赖锁和断线/恢复记录模板。
基础闭环 · 2 张图阅读图文
ESP32 自己连 Wi-Fi：连接状态、超时和重试怎么写
用10秒应用连接窗口和2到30秒退避代替无限等待；日志保留真实断开原因，本地按钮与串口输入继续运行。公开包只含占位配置，不声称已连上无线网络。
基础闭环 · 2 张图阅读图文
ESP-IDF 入门：用 EIM 管理环境并跑通 hello_world
从固定 EIM 与 IDF 版本开始，分清安装、构建、烧录和监视。提供自包含 S3 工程、新终端重建方法、OS 差异与真实 EIM 注册和编译记录。
基础闭环 · 2 张图阅读图文
用手机控制 ESP32 小灯：做第一个局域网页面
把普通LED接到GPIO4，用固定Arduino core提供网页与状态API。处理错误参数、刷新读回和断网重连，区分HTTP成功、引脚电平与实体灯。
基础闭环 · 2 张图阅读图文
让 ESP32 请求 JSON：把超时、状态码和旧数据分清
用固定IDF客户端访问自己的局域网故障服务，逐层检查状态码、正文上限和字段协议，让失败时的最后有效读数带上年龄。
基础闭环 · 2 张图阅读图文
把传感器数据发到 MQTT，并让命令回到一盏灯
用固定SHT40与IDF C驱动向自己的broker发布带有效性的温湿度，再通过独立topic控制普通LED，处理失败、保留状态和重连边界。
基础闭环 · 2 张图阅读图文
ESP32 串口通信：把另一台设备的数据读完整
用 UART1 和固定帧界定处理分片、粘包、缺结束符与超长输入；附 Arduino 3.3.12 完整解析器、故障发送脚本及同源主机检查。
家庭与桌面作品 · 2 张图阅读图文
给 ESP32 接一个旋钮：方向、计数和按压菜单
用 ESP-IDF 5.5.5 读取 Bourns 24格旋钮，完整四相解码、短按菜单和长按回零；附正反20格记录方法、同源fixture与PCNT速度边界。
家庭与桌面作品 · 2 张图阅读图文
不用机械按钮：用 ESP32-S3 做一个触摸开关
从绝缘面板后的电极开始，记录 ESP32-S3 触摸读数、冻结上电基线并设置回差；附 Arduino3.3.12新触摸驱动版本边界和完整测量表。
家庭与桌面作品 · 3 张图阅读图文
ESP32 蓝牙代理：让远处的 BLE 传感器接进 Home Assistant
固定Govee H5075与S3代理，分清主动扫描和GATT连接；完整YAML、HA集成与远近位置实验，不把编译写成覆盖实测。
家庭与桌面作品 · 2 张图阅读图文
做一个桌面实体按钮：单击与长按切换 Home Assistant 场景
完整ESPHome按钮与HA演示包：区分短按/长按，离线本地提示，不把重启恢复状态当按键事件。
家庭与桌面作品 · 2 张图阅读图文
ESP32 小屏显示中文：字体、编码和字库大小怎么取舍
固定OFL字体与SSD1306完整YAML，比较26和281字形的实际固件体积，另提供能编译的故意缺字配置，区分乱码、缺字和裁切。
家庭与桌面作品 · 2 张图阅读图文
ESP-IDF 项目由什么组成？CMake、组件、menuconfig 和 defaults
用一个真实滑动窗口组件分清公开接口、本地配置与构建产物；从干净目录改参重建，再用缺失组件和非法输入检查失败路径。
家庭与桌面作品 · 2 张图阅读图文
从 Arduino 迁移到 ESP-IDF：把一个按钮灯项目拆成组件
沿用P03的同一回路与按压行为，拆出纯C状态组件和GPIO适配。对照初始化、时间与任务入口，并用原样Arduino源码做输入比较。
家庭与桌面作品 · 2 张图阅读图文
ESP-IDF 组件怎么管理？锁版本、看依赖、换电脑也能构建
用真实led_strip依赖比较registry精确版本、Git完整commit和两份锁；从干净目录重建，并用不存在版本验证失败与恢复。
家庭与桌面作品 · 2 张图阅读图文
用 MicroPython 玩 ESP32：刷固件、进 REPL、读一个按钮
固定MicroPython v1.29.0的S3 Octal固件，分清REPL、临时run和持久main.py；完整去抖按键例程、恢复步骤与同源Unix逻辑检查，实板明确待测。
家庭与桌面作品 · 3 张图阅读图文
花盆缺水提醒：先校准土壤探头，再决定报警阈值
用指定SEN0193记录同土干端、排水湿端和中间样本，生成自己的相对指数；完整程序保留原始值、迟滞与异常状态，不把网络百分比当含水量。
家庭与桌面作品 · 2 张图阅读图文
门磁开合记录器：给 ESP32 做一个可靠的状态输入
固定两线PID375门磁，用稳定窗口分开初始状态、当前开合与事件次数；完整串口记录器覆盖30周期、保持和信号断开方法，明确二线输入的诊断边界。
家庭与桌面作品 · 2 张图阅读图文
ESP32 对时与时区：断网后时钟还能信吗？
把首次未同步、在线已同步、断网保持和过期分开记录；用固定ESP-IDF工程保留epoch、UTC、本地偏移与同步年龄，并检查重启后的信任边界。
家庭与桌面作品 · 2 张图阅读图文
不用记 IP：用 mDNS 找到 ESP32，并准备发现失败的后路
用固定mDNS组件发布只读HTTP服务，分清主机名、实例和服务浏览；电脑与手机分别验证，并用串口当前IP保留发现失败后的入口。
家庭与桌面作品 · 2 张图阅读图文
传感器偶尔跳值怎么办？用范围、迟滞和时间窗口处理
在固定SHT40例程里同时保留原始值、质量、趋势、年龄与告警；注入NaN、通信错、停采样和突变，避免用平滑曲线掩盖断线。
家庭与桌面作品 · 2 张图阅读图文
SPI 上挂两块设备：屏幕和存储卡为什么会互相干扰？
用同一块ST7789+microSD板先分别验收，再交替写卡、读回与刷屏100轮。解释两个片选、SD上电模式与DMA缓冲所有权，附完整IDF工程和空白记录。
家庭与桌面作品 · 2 张图阅读图文
ESP32 接 ST7789 彩屏：先画色块，再核对方向与偏移
固定PID3787的240×240窗口，逐项核对RGB565、四种旋转与gap；再接SHT40显示真实样本，读取失败立即隐藏旧值。附完整IDF工程和四方向记录。
家庭与桌面作品 · 2 张图阅读图文
ESP32 墨水屏第一次刷新：选对控制器和驱动类
从GDEY0213B74面板号锁到SSD1680与GxEPD2具体类，完成整屏图案、BUSY异常和断电保持三类可执行检查；明确void超时与光学成功的区别。
家庭与桌面作品 · 2 张图阅读图文
ESP32 做 CO₂ 桌面提醒器：用 SCD41 看通风变化
固定SCD41真实CO₂模块与OLED，等待data-ready、显式临时关闭ASC，保留稳定观察/陈旧状态和完整迟滞提醒。
家庭与桌面作品 · 2 张图阅读图文
PIR 人体感应灯：为什么坐着不动会熄灯？
用固定PIR模块做启动屏蔽与可重延长的低压LED；分开硬件脉冲和软件保持，并在HA区分启动不可用与运动状态。
家庭与桌面作品 · 2 张图阅读图文
桌面漏水提醒器：传感器断线也要看得出来
给固定SEN0121加探头端偏置与本地下拉，用有效电压窗区分干、湿和SIG/整插头断线，保留本地灯与HA不可用状态。
家庭与桌面作品 · 2 张图阅读图文
LD2410 存在传感器：区分有人移动、静坐和环境误触发
锁定LD2410B与2.44固件，用完整UART帧区分移动、微动、空房与通信陈旧，给出门限、风扇对照和HA资格实体。
家庭与桌面作品 · 2 张图阅读图文
ESP32 红外遥控器：先发对一个码，再做空调控制
固定有FET驱动的Adafruit收发模块，从实际NEC捕获到单次重放，再分开检查Daikin完整状态帧、光学发送与家电动作。
家庭与桌面作品 · 2 张图阅读图文
用 ESP32 控制低压小风扇：开关、调速和温度迟滞
固定5V四线Noctua风扇、推挽缓冲与SHT40，外供电/共地、25kHz PWM、29/27℃迟滞和独立TACH故障反馈都有完整配置。
家庭与桌面作品 · 2 张图阅读图文
ESP32-S3 触摸屏与 LVGL：做一个真正能点击的设置页
固定BOX-3的屏幕、触摸和LVGL9组合，做带保存回执的开关与背光滑条；用同源模型检查保存快照，并保留坐标与断电恢复的实板清单。
家庭与桌面作品 · 2 张图阅读图文
FreeRTOS 多任务第一课：采样、显示和网络通过队列协作
用SHT40、SSD1306与局域网HTTP做生产者和两个消费者，故意拖慢消费并明确覆盖/丢新策略；保留单核双核构建与实板栈、延迟记录方法。
语音与视觉 · 2 张图阅读图文
ESP32 数据存哪里？NVS、小文件和 SD 卡分别适合什么
用一个可构建工程把NVS配置与追加日志分开，分别构建SPIFFS和SD分支；对缺键、应用限额、写失败和坏尾保留明确结果与恢复步骤。
无线与续航 · 2 张图阅读图文
ESP32 刷 WLED：把一条桌面灯分段、存预设，再接入 HA
固定S3 N8R8、WLED16.0.1与30颗RGB SK6812灯条，核固件和5V供电，把分段、亮度、预设备份与HA控制逐层走通。
家庭与桌面作品 · 2 张图阅读图文
两个 I²C 设备地址一样怎么办？让两块 SHT40 各走一条总线
固定两块不可软件改址的0x44 SHT40，在S3上分别用Wire和Wire1采集；保留各自序列号、错误与恢复，避免扫描一次ACK就当双设备成功。
无线与续航 · 2 张图阅读图文
桌面墨水屏信息牌：从自己的 JSON 显示天气和待办
用自托管JSON做带日期的墨水屏快照，区分数据时间、缓存与下载成功；缺字段、旧数据和超时都能检查，默认无配置不生成虚构天气。
家庭与桌面作品 · 2 张图阅读图文
不用触摸屏也能做菜单：旋钮选择、按下确认、返回
保留P09的准确旋钮，解决TFT引脚冲突；用有边界和草稿取消的菜单控制真实温湿度页，采样、输入与绘制各自推进。
家庭与桌面作品 · 2 张图阅读图文
做一个桌面番茄钟：旋钮、屏幕和提示音组成完整作品
用旋钮设置工作和休息时长，暂停时冻结计时；NVS保存带回执的检查点，重启只恢复暂停状态，并用同源快进夹具检查完整周期与边界。
家庭与桌面作品 · 2 张图阅读图文
ESP32 省电模式怎么选？从一直在线到每小时上报一次
从远程响应、周期与事件保持三项约束选模式，用可复建工程比较任务等待、手动Light-sleep、Deep-sleep和自动管理的执行位置。
无线与续航 · 2 张图阅读图文
明明 Deep-sleep 却耗电很高？先量整块开发板
锁定5V整板边界、仪器量程与USB旁路，给出板/传感器/屏幕三组固件、空记录和可拒绝缺样的电量积分工具；无本站电流结果。
无线与续航 · 2 张图阅读图文
ESP32 定时唤醒：采一次温湿度就回去睡觉
用SHT40单次采样建立可校验RTC周期号，分清定时深睡与普通重启；给出30次连续唤醒记录与自动检查方法，实板实验待执行。
无线与续航 · 2 张图阅读图文
按钮或门磁唤醒 ESP32：为什么睡下去又立刻醒？
用S3 RTC GPIO5/6建立EXT0与EXT1三种明确事件配置，等待非触发电平稳定后再武装；持续按下、开门和重上电各有可执行验收。
无线与续航 · 2 张图阅读图文
MQTT断线后怎样恢复状态？遗嘱、保留消息和命令去重
用固定ESP-IDF工程分别记录连接、样本和LED命令；实际主机broker检查遗嘱、retain、QoS1重投与序号去重，解释断电及业务幂等的边界。
无线与续航 · 2 张图阅读图文
给自己的ESP32项目加SoftAP安全配网入口：保存Wi-Fi和清配置恢复
采用ESP-IDF5.5.5自带SoftAP与Security1官方客户端，交互填写凭据，分开验证错误密码、持久配置、重启和长按清除；明确不是普通浏览器填表页面。
无线与续航 · 2 张图阅读图文
ESP32实时曲线：用有界WebSocket流观察SHT40
原生ESP-IDF WebSocket页面显示温湿度与连接状态，限制采样、待执行广播、客户端和图表点数；用实际浏览器及本机服务核多页面、断线重连和慢消费者。
无线与续航 · 2 张图阅读图文
墨水屏刷新预算实验：记录残影、耗时和整板电量
固定GDEY0213B74与DESPI-C02，比较驱动全窗口快刷和局刷；提供脱离USB的实体操作、空实测表、明确单位的电量积分与残影记录方法。
可维护设备 · 2 张图阅读图文
连续室内环境站：把有效读数、CSV和断网补传接成闭环
用SHT40、OLED和SD建立连续环境站，记录时间资格和样本身份；SQLite提交后应用ACK，故障停写、原行重传和人工恢复都有边界。
可维护设备 · 2 张图阅读图文
ESPHome 深睡节点：留出可靠的 OTA 维护窗口
用实体唤醒、API保持和OTA失败锁定维护睡眠节点，再以HA实际收件年龄识别旧值，明确独立电池供电与未测边界。
无线与续航 · 2 张图阅读图文
可维护漏水设备：本地报警、自检与 HA 通知
在断线可辨的S07回路上增加实体TEST/ACK、低压声光、湿态锁存和有资格的HA提醒，按月维护并如实记录重启丢失历史。
可维护设备 · 2 张图阅读图文
ESP32控制舵机：把脉宽、动力电源和真实角度分开
用指定FS90与独立5V电源建立空载舵机台，限定1400..1600µs命令、保持使能和10秒窗口，再分层检查波形、供电与实际位置。
语音与视觉 · 2 张图阅读图文
ESP32加电机驱动：正反请求、调速与COAST停止状态
用指定DRV8833载板与LP齿轮电机建立架空单电机台，有限占空比、切向前COAST、全松重武装与故障输入各有明确边界。
语音与视觉 · 2 张图阅读图文
ESP32-S3录一段WAV：把真实I2S采集变成可检查的文件
固定ICS43434与SD，完整采集、24/32/16位转换、WAV提交和复制修复；用文件验证定位静音/饱和，不以合成音冒充实录。
语音与视觉 · 2 张图阅读图文
ESP32播放WAV：先用低幅测试音确认数字功放输出链
严格PCM16文件解析、左右声道选择、实体ARM/PLAY与默认静音，说明MAX98357A BTL接法、电源与限幅，附合成音验证器。
语音与视觉 · 2 张图阅读图文
外设也要睡：控制传感器和屏幕电源时要检查什么？
用两路指定负载开关分时供电，逐一核对I2C释放、放电、重初始化，并建立常供电与断电的整周期能量对照。
无线与续航 · 2 张图阅读图文
Wi-Fi 上传太耗电？比较每次上传与攒一批再发
以相同24次SHT40采样比较阈值1与4，建立有RTC边界、应用ACK、去重和满丢新策略的节点，并记录有效送达、时延与整周期能量。
无线与续航 · 2 张图阅读图文
ESP32 读电池电量：为什么一条直线换算百分比不可靠？
在经典ESP32 Feather V2 Rev F上核200k分压、C5与ADC校准，记录USB、负载和静置条件下的电压，用自己的万用表数据核验而不生成SOC百分比。
无线与续航 · 2 张图阅读图文
事件驱动怎么组织 ESP32？让配网、采样和显示状态一致
用明确的生命周期状态表、单一owner和有界事件队列，组织Security1配网、SHT40采样与OLED；重放超时、掉线和读错，实板结果独立待测。
可维护设备 · 2 张图阅读图文
ESP32 固件为什么装不下？读懂 Flash、分区表和 OTA 空间
以真实8MiB布局与app.bin预算工具区分物理Flash、镜像头、双OTA槽和整包；保留错误分区拒绝、备份与原布局恢复步骤。
语音与视觉 · 2 张图阅读图文
给 ESP32 示例加自动构建和测试：让后续教程跟得上版本
提供固定镜像的5.5.5/5.5.4四行CI矩阵、同源Unity测试和真实S3 QEMU；收集器逐摘要验收产物，主机、仿真和实板分开。
可维护设备 · 2 张图阅读图文
Wi-Fi、ESP-NOW 和 BLE 谁更省电？按同一个任务测
用六个完整角色、同一20B任务与应用ACK，建立包含失败和深睡的整周期能量对照；没有本站协议排名。
无线与续航 · 2 张图阅读图文
ESP32 要一直在线也能省电吗？试试自动 Light-sleep
保持同一UDP命令和实体按钮任务，对照只切换自动Light-sleep的两个固件，分别记录能量、主机RTT与掉线。
可维护设备 · 2 张图阅读图文
一周续航实验：把传感器做成可以交接维护的电池节点
为指定Feather电池节点交付持久未ACK队列、低压/离线/维护状态、服务器原始记录和真实七天观察空表，区分估算与实测。
可维护设备 · 2 张图阅读图文
ESP32-S3拍第一张照片：从板级引脚到可解码JPEG
固定S3-EYE v2.2与OV2640，先验证PSRAM和单帧路径，再用序号、CRC和真实JPEG解码接收照片；提供完整原生USB工程与故障顺序。
语音与视觉 · 2 张图阅读图文
ESP32摄像头局域网预览：用两档分辨率检查帧与内存
固定S3-EYE与单客户端异步MJPEG流，提供控制/状态页、严格接收工具、两档分辨率和断线内存回收实验；无伪造FPS数据。
语音与视觉 · 2 张图阅读图文
语音前端AFE做什么？先把降噪和VAD结果看见
用Korvo-2 V3.0采MIC1，独立保存RAW/AFE十秒WAV与VAD索引；明确单M、无AEC、软件提交与声学效果的边界。
语音与视觉 · 2 张图阅读图文
ESP32-S3离线唤醒词：先跑通WakeNet，再测误触发
锁定wn9_hiesp，用独立工程输出本地LED反馈，给出距离/噪声单因素试验、模型字节检查和误触发的真实分母。
语音与视觉 · 2 张图阅读图文
不用云端也能控制灯：用MultiNet做有限离线命令
Hi ESP后打开一次有限命令窗口，固定英文开灯/关灯；解释chunk、top1阈值、超时、fst与本地LED动作的证据边界。
语音与视觉 · 2 张图阅读图文
ESP32-C5 双频 Wi-Fi 怎么比较：配网、覆盖和重连实验方法
用同一台C5和双频AP做成对探测，记录失败包、真实频段/国家设置和断线恢复；提供完整两种固件、LAN回显服务与拒绝坏记录的分析器，不虚构覆盖结果。
前沿实验 · 2 张图阅读图文
ESP32-C6 做 Zigbee 传感器：加入自己的协调器
用两块同款C6分别做自有协调器与SHT40终端，完成标准温湿度端点、物理入网窗口、属性报告、离网与重新入网的完整工程及检查步骤。
前沿实验 · 2 张图阅读图文
两块 ESP32-C6 组一个 Thread 网络：用 CLI 核对连接和 sleepy 模式
保留同版ot_cli入口，分别构建FTD/MTD，以同一Dataset核对入网、IPv6消息、重启保存和RxOffWhenIdle；把普通节点、Border Router与CPU低功耗分开。
前沿实验 · 2 张图阅读图文
ESP32-P4 加无线协处理器：把大屏看板跑起来
固定P4 v1.4/EK79007屏与板载C6，交付匹配的Hosted host/cp工程、自己的LAN数据页与整机复位恢复步骤。
前沿实验 · 2 张图阅读图文
ESP32 做第一个 Matter Wi-Fi 小灯：从编译到控制器配对
固定ESP-Matter与IDF，提供外接LED、单槽按钮、状态恢复和完整Home Assistant配对路线；开发身份与实板配对结果分开记录。
前沿实验 · 2 张图阅读图文
ESP32-C6 Matter over Thread 按钮：补齐 Border Router 和控制器链路
独立C6 Generic Switch工程，明确Thread终端、Border Router、手机与控制器职责；四边沿缓存、位置重同步和配对步骤均给出范围。
前沿实验 · 2 张图阅读图文
做一台桌面小车：无线请求、状态反馈与失联COAST
用两块S3与指定DRV8833双轮架空台，把握持意图、新序号租期、重放不续期和独立动力恢复做成可检查的完整工程。
语音与视觉 · 2 张图阅读图文
ESP32-S3 二维码读取：解码、重复门禁与板载显示
用固定S3-EYE和真实Quirc实现有限ID读取，处理重复、非法字节与模糊无结果；构建和桌面解码通过，镜头与LCD待实板验证。
语音与视觉 · 2 张图阅读图文
ESP-DL 第一份推理：先跑官方小模型，再理解输入输出
用固定猫图和S3版MobileNetV2核对输入身份、RGB归一化、Top5分数与资源记录；实际构建已通过，实板分类、耗时与内存待验证。
语音与视觉 · 2 张图阅读图文
ESP RainMaker 做远程小灯：先分清设备、账号和云服务
固定Classic1.17.0和Home6.2.1 Global，完成小灯固件、配网认领与参数回读的可操作步骤，区分断网、本地输出、账号移除和实体清理。
可维护设备 · 2 张图阅读图文
多个无线传感器汇总到 MQTT：做一个 ESP-NOW 网关
三块固定S3板、两个SHT40节点与自有MQTT接收端；让MAC/boot/seq贯穿重试、独立缓存与SQLite应用ACK，明确失联和broker恢复的边界。
无线与续航 · 2 张图阅读图文
两块ESP32不连路由器通信：先追踪第一条按钮命令
固定两块S3，用16字节单播把按钮变成绝对SET；分清API、MAC回调、GPIO请求与真实灯态。
无线与续航 · 2 张图阅读图文
ESP-NOW发出去了为什么灯没亮：确认、重试和同会话去重
为ESP-NOW增加双方启动标识、应用ACK、四次重试和RAM去重；明确丢ACK与重启后的不确定边界。
无线与续航 · 2 张图阅读图文
ESP-NOW一接Wi-Fi就失联：节点跟随网关的实际信道
网关连接受控AP，节点在许可子集中发现信道；处理信标新鲜度、同信道重连与新会话，避免旧命令自动重放。
无线与续航 · 2 张图阅读图文
用真实 SHT40 读数做 BLE 广播：版本、单位和手机解析
从真实SHT40读取到31字节自定义广播，说明signed温度、无效标志、随机地址与接收端陈旧；提供手机HEX解析流程。
无线与续航 · 2 张图阅读图文
BLE GATT 配置：让 read、write、notify 和安全门各司其职
用实体维护开关、Secure Connections与认证密钥保护四字节配置，分别处理读取、写响应、通知订阅和重连。
无线与续航 · 2 张图阅读图文
ESP32-S3 原生 USB HID 按钮：实体使能、单键按下与释放
固定TinyUSB版本实现F13单键，处理启动按住、去抖、忙端点、重连先释放与原生USB占用；主机效果明确待测。
无线与续航 · 2 张图阅读图文故障排查
连接、声音与屏幕，按现象定位。ESP32 连不上电脑？从 USB 数据线查到下载模式
开发板亮灯却没有串口、浏览器能选端口却连接超时，是不同层的问题。按数据线、USB 接口、端口占用与 ESP32-S3 下载模式逐层排查。
现成固件与排错 · 2 张图阅读图文
小智怎么换 Wi-Fi？重新配网与找不到热点的排查
路由器改密码或带设备换地方后，先确认固件怎样进入配网。对照旧教程与 v2.5.2 的按键差异，重新连接 Xiaozhi 热点并配置 2.4 GHz 网络。
现成固件与排错 · 2 张图阅读图文
小智喇叭没声音或有杂音？按音量、功放和接线排查
屏幕有反应而喇叭不响，不一定是模型或网络问题。从是否有提示音开始，检查音量、扬声器连接、功放型号和供电，避免把旧版 GAIN 接法套给所有模块。
现成固件与排错 · 2 张图阅读图文
小智听不到你？麦克风、唤醒词与按键输入排查
“你好，小智”没有反应时，先分清没有唤醒与没有采到声音。按固件支持、按键对照、麦克风丝印、I2S 输入线和声道选择逐步缩小问题。
现成固件与排错 · 2 张图阅读图文
小智 OLED 屏幕不亮？从驱动、分辨率查到 I2C 接线
128×32 和 128×64 不能只按外观挑固件。以 S3 面包板 OLED 方案为例，检查 SSD1306、屏幕包、SDA / SCL 与排针顺序，区分屏幕故障和整机没有启动。
现成固件与排错 · 2 张图阅读图文
小智六位验证码在哪里？没有码、加不上设备怎么查
把设备联网、取得六位码和控制台关联拆成三个检查点。区分设备验证码与手机短信码，处理听不到播报、页面加不上设备和已经关联等情况。
现成固件与排错 · 3 张图阅读图文
ESP32 一联网就重启？从 Brownout 日志查供电
用固定版本诊断程序保存复位分类与联网时刻，做USB线材、负载和板端电压对照。给出测量模板与恢复流程，不靠关闭欠压检测掩盖问题。
基础闭环 · 2 张图阅读图文
ESP32 旧教程编译不过？先查 Arduino 2.x 和 3.x 的接口变化
用一份旧LEDC程序真实复现删除API的错误，再迁到Arduino-ESP32 3.3.12。核对通道与GPIO参数、返回值和驱动读回，附完整前后代码、构建记录与恢复方法。
家庭与桌面作品 · 2 张图阅读图文
ESP32 屏幕刷新实验：比较局部更新、单缓冲和双缓冲
固定BOX-3与LVGL9组合，记录渲染周期、提交字节、等待和内部堆，再用独立录像检查实际触摸响应；附两套缓冲固件与空实验表。
可维护设备 · 2 张图阅读图文
ESP32 死机怎么看？从 backtrace 到 watchdog 和栈溢出
保留同次ELF与原日志，用安全默认、显式故障开关和合成地址夹具练习离线解析；区分abort、任务看门狗与栈问题，真实panic与恢复仍待实板。
语音与视觉 · 2 张图阅读图文
PSRAM 开了为什么还是内存不足？分别看堆、DMA 和碎片
在指定S3 N8R8上按capability记录内部堆、外部堆与最大连续块；用受限私有池和实际S3 QEMU复现分配失败，同源工具按字节分析，物理PSRAM与DMA仍待测。
语音与视觉 · 2 张图阅读图文
ESP32 HTTPS 失败：时间、证书、域名和内存按顺序排查
完整IDF客户端保留证书和名称验证，以私有CA和真实本机TLS端点区分正确、错CA、错域名与有效期异常；私钥留在包外，板上无线、SNTP和TLS结果单列待测。
可维护设备 · 2 张图阅读图文
ESP32 日志不够用了：用 GDB 和板载 JTAG 看程序停在哪里
用有意等待的调试任务和原生USB/JTAG脚本练习断点、变量、调用栈与复位；区分本机ELF检查和真实连接证据。
语音与视觉 · 2 张图阅读图文
ESP32 OTA 升级怎么回退？模拟坏包、断网和新固件自检失败
用factory基线、A/B槽与显式自检故障练习恢复；实际构建、本机TLS和S3 QEMU分别留证，真实无线下载、断电与板上恢复待验证。
可维护设备 · 2 张图阅读图文
从能运行到能放一周：给 ESP32 项目做故障注入清单
用合成参考负载记录boot、序号缺口、连接恢复与heap趋势；实际构建、同源输入和本机broker/SQLite通过，24小时与7天运行仍待实测。
可维护设备 · 2 张图阅读图文
分享 ESP32 项目时怎样处理 Wi-Fi 和令牌？把配置与代码分开
每设备私有配置、原生Security1令牌端点与逻辑清除恢复；真实构建、官方客户端本机HTTP和导出规则可复跑，实板配网/重启仍待验证。
可维护设备 · 2 张图阅读图文
Secure Boot 和 Flash 加密分别解决什么？先用虚拟 eFuse 理解流程
在私有QEMU文件中实际区分签名、加密和两者组合，保留首次就地加密失败，用受控文件副本继续观察四状态与签名负例。
前沿实验 · 2 张图阅读图文AI 硬件
理解语音链路，再学习调用工具。小智 AI 怎么工作？把一次语音对话拆开看
已经完成首次对话后，再理解麦克风、固件、语音服务、智能体和扬声器的分工，知道联网、唤醒和双向交互分别意味着什么。
现成固件与排错 · 6 张图阅读图文小智 MCP 是什么？从语音聊天到调用工具，先分清两条路
解释小智设备端工具与智能体 MCP 接入点的区别。用查状态、调音量和计算等例子理解工具发现、调用与结果验证，明确哪些功能取决于固件和实际服务。
现成固件与排错 · 2 张图阅读图文
ESP32 视觉分拣实验：先过自检，再接受一次有限动作
完整双S3纸卡分拣工程：模型自检、ROI、低差值拒动、限时串口桥、ARM与独立舵机供电；50连续实物记录留空，目标参考失败保持STOP。
前沿实验 · 2 张图阅读图文
AI语音为什么反应慢？给采音、上传、首字和播放分段计时
完整客户端单调时钟探针、串口采集和分位数分析，区分首字幕、LLM首token、发送调用与声学起音；20次实物记录待测。
语音与视觉 · 2 张图阅读图文
做一个有屏幕的语音桌面助手：状态、按键、对话和故障反馈
完整N16R8/OLED语音设备，主循环管理联网、采音、等待、播放和工具故障，软确认与GPIO维修分离；30轮实物对话待测。
语音与视觉 · 2 张图阅读图文
ESP32 小模型部署实验：合成数据、PTQ与目标自检
完整训练圆方小模型、隔开校准与测试并核模型身份；桌面量化通过，S3 QEMU参考失败如实保留，目标正确性和实板资源待验证。
前沿实验 · 2 张图阅读图文
ESP32 接 HA Assist：按一下说话，等一句回答播放完
完整ESPHome按钮语音终端：指定I2S麦克风/功放、HA本地或云处理、取消与断线可见；保留声音和HA实机待测。
语音与视觉 · 2 张图阅读图文
第一次编译小智：固定源码、显式兼容补丁，只改一条日志
完整固定v2.4.0源码与IDF5.5.5显式兼容补丁，原样失败如实留存，三次真实构建验证基线、单日志修改与恢复。
语音与视觉 · 2 张图阅读图文
给小智加 MCP 灯工具：参数、去重、错误与数字回读
完整设备侧MCP实验灯工程，严格parsed参数、16项本地去重、查询与故障锁存，区分工具返回、数字pad和可见光。
语音与视觉 · 2 张图阅读图文