版本：1.0（面向 ESP-IDF v6.0.1 / ESP32-S3）
为什么写这本书
这本书想做的只有一件事：让一个完全零基础的人，只看这一本书，
就建立起使用 ESP-IDF（Espressif IoT Development Framework，乐鑫官方的物联网开发框架，
简单说就是"官方给你配好的一整套写代码、编译、烧录的工具和现成库"）开发 ESP32 应用
所需的完整知识框架——不是背 API，
而是真正理解：电是什么、芯片怎么工作、代码怎么变成硬件动作、
出错了怎么找到原因。
主线是"控制一台直流电机"。它足够简单（人人都能理解"转、停、换向"），
又足够完整（会用到 GPIO、PWM、中断、定时器、内存、优化、调试、架构），
是一条能覆盖嵌入式开发核心知识的完美主线。
上面这一串词（GPIO、PWM、中断……）现在一个都不认识完全没关系。
每一个都会在用到它的那一章里从零解释清楚，你不需要提前记住它们。
这本书适合谁
- 完全没接触过单片机的人（包括中小学生）：从第 0 章开始，无需任何前置知识；
- 会一点编程、想进入嵌入式的人：跳过第 1 章前半，重点看第 7~18 章；
- 用过 Arduino（另一套更简单、适合快速上手的开源硬件平台）、想学 IDF 的人：
第 2、3 章帮你建立 IDF 的心智模型； - 做项目遇到瓶颈的人：附录 C 的错误索引 + 第 11 章调试方法论
是最快的"急救包"。
你需要什么
- 一块 ESP32-S3 开发板（N16R8：16MB Flash（掉电不丢的"课本"，存固件）+ 8MB PSRAM
（断电就清空的"草稿纸"，运行时临时用），本书以此为准）； - 一个 L298N 电机驱动板、一个直流电机、若干杜邦线、一个独立电机电源；
- 一台 Windows 电脑（本书环境以 Windows 为例；macOS/Linux 命令略有差异，
思路完全一致）； - 耐心。嵌入式不是"看会的"，是"做会的"。
这本书怎么用
结构
全书分三个部分：
| 部分 | 章节 | 内容 | 学完你能 |
|---|---|---|---|
| 第一部分 基础 | 0~6 章 | 电与芯片、C++、环境、工程、GPIO、构建、日志 | 看懂工程、点灯、看日志 |
| 第二部分 电机项目 | 7~12 章 | PWM、L298N、刹车、内存、调试、综合实战 | 完整控制一台电机 |
| 第三部分 进阶掌握 | 13~18 章 | FreeRTOS、外设、中断、WiFi、组件化、发布 | 独立做自己的项目 |
每章的读法
每章都按"本章要解决什么问题 → 底层原理（含时序图/推导）→
代码逐行 → 常见问题速查 → 想一想 + 小测验"来组织：
- "想一想"是给大脑的练习，请先自己答，再对照附录 A；
- "小测验"的答案全部在附录 A，且都能从正文直接推出；
- 每章末尾都有一张"常见错误／新手高频坑"速查表（各章小节名略有不同，
如"常见问题速查"“常见错误速查”“新手高频错误”），正文里用 ⚠️ 标出的，
都是作者真实踩过的坑，请重点标记； - 代码都是完整、可抄写的：第 3、8、12 章会给出工程文件的全文；
电机主线的代码经过真实编译运行验证，第三部分的示例是完整可编译的教学程序。
动手原则
- 每章的动手环节必做：不做实验，等于没读；
- 报错先看日志：芯片会用日志告诉你 90% 的答案；
- 别跳过推导：公式和时序图是"为什么"，比代码本身更重要；
- 看不懂就回到上一章：本书所有概念都是层层递进的。
关于准确性
- 所有 API 名称、头文件路径都对照ESP-IDF v6.0.1 的本地源码
（C:\esp\v6.0.1\esp-idf\components\...）逐一核实； - 所有固件体积（发布版
l298n.bin= 0x2a150（十六进制写法，第 1 章教你怎么换算）
= 172368 B）、日志、崩溃回溯
均为本书项目的真实记录； - 不同 IDF 版本 API 可能不同——遇到差异，以你本地源码为准（第 2 章教方法）。
版本与勘误
| 项目 | 说明 |
|---|---|
| IDF 版本 | v6.0.1（本书全部代码基于此版本验证） |
| 芯片 | ESP32-S3（N16R8：16MB Flash / 8MB Octal PSRAM） |
| 配套代码 | 本书项目l298n（main/ 目录，随书源码包） |
| 勘误 | 请通过出版社/作者渠道提交，再版修订 |
致谢
感谢乐鑫的开源生态；感谢每一位在社区留下问题与答案的开发者——
嵌入式学习从来不是一个人的旅程。
现在，从第 0 章开始。你要做的第一件事，是认识那颗会听你话的"小石头"。
：RISC-V assembly (easy))
