最后一章把全书串成一条完整的信号链并完成①从代码到电机动作的每一环②完整演示程序逐行真实 main.cpp 全文③接线清单④排查流程⑤双电机挑战fade 服务实例计数的实际演练附完整可抄跑程序⑥毕业自检。12.1 完整信号链代码到电机动作的每一环main.cpp剧本 │ setSpeed(80) ▼ DCMotor::setSpeed ├─ std::clamp(80, -100, 100) → 80 ├─ 方向setDirection(true) → IN11, IN20GPIO16/17 输出高/低 └─ 速度speedToDuty(80) → 818 → applyDuty(818) └─ ledc_set_duty_and_update(LEDC_LOW_SPEED_MODE, LEDC_CHANNEL_0, 818, 0) 第 4 参是 hpoint0立即生效不是渐变时间 ▼ LEDC 硬件计数器与比较值 818 比较 → 占空比 80% 方波20kHz ▼ GPIO18 输出方波 → L298N 的 ENA ▼ L298NIN1/IN2 选通 S1、S4ENA 的占空比决定平均电压 ▼ 电机平均电压 80% → 80% 转速正转每个环节失败症状不同——排查时按这个链条逐环检查12.4。12.2 演示程序逐行真实 main.cpp 全文77 行下面就是仓库里main/main.cpp的逐字全文包括所有注释——注释也是正文的一部分它们解释为什么这么接、为什么这么写#includeesp_err.h#includeesp_log.h#includefreertos/FreeRTOS.h#includefreertos/task.h#includemotor_control.hstaticconstexprconstchar*TAGl298n;// L298N 一路 H 桥的接线请与实际硬件保持一致。//// 当前模组是 ESP32-S3-WROOM-1-N16R816MB Quad Flash 8MB Octal PSRAM// 有一批 GPIO 被封装内的存储器占用不能当普通 IO 用// - GPIO 26~32Quad Flash任何 S3 模组都一样// - GPIO 33~37Octal PSRAM仅 NxR8 / NxR16 这类八线模组// 所以真正可用的只有 0~25 和 38~48再扣掉 USB-JTAG 的 19/20// 以及 strapping 脚 0/3/45/46。这里选的 16/17/18 不受影响。staticconstexprgpio_num_t MOTOR_IN1GPIO_NUM_16;staticconstexprgpio_num_t MOTOR_IN2GPIO_NUM_17;staticconstexprgpio_num_t MOTOR_ENAGPIO_NUM_18;// 演示节奏每档 5%每档间隔 150 msstaticconstexprintkStepPercent5;staticconstexprTickType_t kStepDelayMs150;externCvoidapp_main(void){ESP_LOGI(TAG,L298N 直流电机演示启动);// 在 app_main 中构造并初始化。请不要把它改成全局对象// C 全局构造发生在 app_main 之前那时外设驱动尚未就绪// 且构造函数无法把错误码返回给调用方。DCMotormotor({.in1MOTOR_IN1,.in2MOTOR_IN2,.enaMOTOR_ENA,.channelLEDC_CHANNEL_0,.timerLEDC_TIMER_0,.freq_hz20000,// 20 kHz高于人耳听感范围可消除电机啸叫.resolution10,// 1024 级约 0.1% 的速度分辨率});// 若要驱动 L298N 的第二路 H 桥务必换用另一个定时器// 否则两路电机会共享频率与分辨率改一处会影响另一处// DCMotor motor_b({.in1 GPIO_NUM_4, .in2 GPIO_NUM_5, .ena GPIO_NUM_6,// .channel LEDC_CHANNEL_1, .timer LEDC_TIMER_1});// motor_b.init();constesp_err_t errmotor.init();if(err!ESP_OK){ESP_LOGE(TAG,电机初始化失败: %s程序终止,esp_err_to_name(err));return;}while(true){ESP_LOGI(TAG,正转加速 0%% - 100%%);for(intspeed0;speed100;speedkStepPercent){ESP_ERROR_CHECK(motor.setSpeed(speed));vTaskDelay(pdMS_TO_TICKS(kStepDelayMs));}vTaskDelay(pdMS_TO_TICKS(1000));ESP_LOGI(TAG,反转加速 0%% - -100%%);for(intspeed0;speed-100;speed-kStepPercent){ESP_ERROR_CHECK(motor.setSpeed(speed));vTaskDelay(pdMS_TO_TICKS(kStepDelayMs));}vTaskDelay(pdMS_TO_TICKS(1000));// 两种停止方式的区别很直观制动会立刻停住滑行则靠惯性慢慢停下ESP_LOGI(TAG,能耗制动短接绕组快速停住);ESP_ERROR_CHECK(motor.stop(DCMotor::StopMode::Brake));vTaskDelay(pdMS_TO_TICKS(2000));ESP_LOGI(TAG,自由滑行关断输出靠惯性停下);ESP_ERROR_CHECK(motor.stop(DCMotor::StopMode::Coast));vTaskDelay(pdMS_TO_TICKS(2000));}}逐段讲第 7~23 行常量与引脚。TAG是日志标签第 6 章。引脚常量块上方的注释值得反复读这块 N16R8 模组上GPIO 26~32 被 Quad Flash占用、33~37 被 Octal PSRAM 占用19/20 是 USB-JTAG0/3/45/46 是strapping 脚这两类脚是什么、为什么占不得2.5 和 4.6 都讲过——可用池里挑了干净的 16/17/18 给 IN1/IN2/ENA。kStepPercent 5、kStepDelayMs 150定下演示节奏每档 5%、每档停 150ms。第 28~39 行构造对象。注释把为什么不能在 app_main 之前构造全局对象讲死了构造函数只存配置不碰硬件硬件动作全在init()这样错误才能用返回值交给你处理。初始化用了 C 的指定初始化器.字段 值1.9 讲过的写法把引脚、通道、定时器逐个显式传入——Config的默认引脚是GPIO_NUM_NC没接不存在默认就是 16/17/18的好事。频率 20kHz 避开人耳消啸叫、分辨率 10bit1024 档、约 0.1% 调速精度对应第 7 章的两个旋钮。第 41~45 行第二路电机的注释。这是 12.5 双电机的伏笔两路电机必须用不同的 LEDC 定时器否则共享频率与分辨率、改一处影响另一处。第 47~51 行init 的错误处理。注意这里不是ESP_ERROR_CHECK(motor.init())初始化失败通常是接线/配置问题属于可以体面退出的场合——打一条ESP_LOGE带esp_err_to_name(err)翻译好的错误名然后returnapp_main 返回即主任务结束不炸。而循环里的setSpeed失败意味着运行中硬件出问题才用ESP_ERROR_CHECK宁可 abort。同一本书里两种策略并存是刻意的示范第 6 章讲过的取舍。第 53~76 行while(true) 剧本。一轮的节奏是正转 0→100每档 5%、150ms约 3.15s→ 停 1s 反转 0→-100约 3.15s→ 停 1s Brake 停住观察 2s → Coast 停下观察 2s → 循环日志格式串里的%%是转义打出来是单个%。几个值得咂摸的机制点每个加速循环的第一档都是setSpeed(0)——按 9.5它固定执行stop(Brake)脚本开头先抱死一下再起步顺带验证刹车分支从正转 100% 切到反转时剧本先经过setSpeed(0)这一档短接绕组刹住之后speed_已是 0再进负速档就不触发换向保护死区了。也就是说这个剧本是用过零自然完成了换向保护想做的事最后一组 Brake vs Coast 各停 2s就是第 9 章 9.6 对比实验的自动化版一个立刻定住一个靠惯性慢慢溜肉眼可辨。变体剧本一次性演示完整可编译如果你想要一个跑一遍就收工的教学版正转 30% → 80% → 刹车 →反转 50% → 滑行下面是完整可抄跑的写法——引脚等参数同样必须显式传入不依赖任何默认值#includeesp_err.h#includeesp_log.h#includefreertos/FreeRTOS.h#includefreertos/task.h#includemotor_control.hstaticconstexprconstchar*TAGl298n;externCvoidapp_main(void){ESP_LOGI(TAG,L298N 一次性演示);DCMotormotor({.in1GPIO_NUM_16,.in2GPIO_NUM_17,.enaGPIO_NUM_18,.channelLEDC_CHANNEL_0,.timerLEDC_TIMER_0,.freq_hz20000,.resolution10,});constesp_err_t errmotor.init();if(err!ESP_OK){ESP_LOGE(TAG,电机初始化失败: %s程序终止,esp_err_to_name(err));return;}ESP_ERROR_CHECK(motor.setSpeed(30));// 慢速正转vTaskDelay(pdMS_TO_TICKS(1500));ESP_ERROR_CHECK(motor.setSpeed(80));// 快速正转vTaskDelay(pdMS_TO_TICKS(1500));ESP_ERROR_CHECK(motor.setSpeed(0));// 0 → 固定能耗制动9.5vTaskDelay(pdMS_TO_TICKS(1000));ESP_ERROR_CHECK(motor.setSpeed(-50));// 反转 50%vTaskDelay(pdMS_TO_TICKS(1500));ESP_ERROR_CHECK(motor.stop(DCMotor::StopMode::Coast));// 这次滑行}这个剧本里80 → setSpeed(0) → -50是先刹到零再换向speed_已归 0换向保护死区不会触发。但如果你偷懒把setSpeed(80)后面直接写成setSpeed(-50)——setSpeed会检测到目标方向与当前speed_相反先stop(Brake)短接绕组并esp_rom_delay_us(5000)停 5ms然后才反向通电占空比还没加上去先经历 5ms 的换向制动死区。这层保护就是为遥控车突然倒车这类场景兜底的物理原因见 9.4。类比一句手动挡车换挡前要先踩离合断开动力这 5ms 就是电机的那一脚离合。预期日志序列真实剧本第一轮烧录成功、接线无误的话monitor 里第一轮长这样节选到第一轮结束之后每约 12 秒原样循环I (1095) l298n: L298N 直流电机演示启动 I (1103) DCMotor: 就绪: IN116 IN217 ENA18 | ch0 timer0 | 20000 Hz / 10 bit I (1104) l298n: 正转加速 0% - 100% I (5254) l298n: 反转加速 0% - -100% I (9404) l298n: 能耗制动短接绕组快速停住 I (11404) l298n: 自由滑行关断输出靠惯性停下逐行对质每一行都能在第 8/12 章的代码里找到出处第 1 行是main.cpp开场白TAG 是l298n第 2 行来自motor_control.cpp的init()末尾TAG 是DCMotor——两个文件各署各的名第 6 章讲过第 2 行的20000 Hz是ledc_get_freq的回读值受时钟分频取整影响可能与请求值差一点7.7 第 8 步本例恰好整除加速循环中间没有每档日志——5%、10%……只有阶段标题各一条%%打出来就是单个%时间戳能对上节奏正转到反转间隔 ≈ 21 档×150ms 1s 停顿≈ 4.15s往后依次 4.15s、2s、2s一整轮约 12s 后从头循环你的数值会略有出入间距对了就行。日志到此为止都在正常说话电机若还不动按 12.3 的清单回头查硬件。12.3 实物接线清单十步全程断电操作最后一步才通电先立三个硬件事实与 8.5 同一口径接线前必须心里有数跳线帽多数 L298N 模块的 ENA/ENB 排针出厂带着跳线帽短接到5V——等于把使能端硬接常开。不拔掉它、不把杜邦线插到 ENA 排针PWM 调速完全无效电机常全速丝印接线柱丝印常为12V / GND / 5V其中12V就是 Vs电机电源入口也有板子写作Bat5V多是模块稳压的输出不是给 ESP32 供电的入口两地供电电机用独立电池盒 6~12VESP32 用 USB 供电——两个地方之间必须共一条地线且电机电流不走芯片。十步检查表一步都别跳① 先断电拔掉 ESP32 的 USB、撤下电池盒与驱动板的连接第一件事就是拔掉 ENA以及 ENB的跳线帽——头号坑最先排② 电机电源电池盒 6~12V→ 接线柱12V即 Vs/Bat 电源入口− → “GND”电机电流走这条路不经过芯片③ 共地开发板 GND → 驱动板 GND共地双方同一个 0V 基准不共地时 IN1/IN2/ENA 的电平全是悬空的一切逻辑都不可信④ GPIO16 → IN1方向信号推挽输出 0/1⑤ GPIO17 → IN2⑥ GPIO18 → ENA 排针PWM 方波——正好取代第①步跳线帽让出的位置⑦ 电机两根线 → OUT1 / OUT2转向若与预期相反对调两根线或改代码里的速度符号即可见 8.5⑧ 断电三查·其一接线柱上有没有散落的铜丝可能碰到12V与GND这俩直接短路电池盒会发烫⑨ 断电三查·其二、其三有没有把5V孔的线误接到 ESP32 的 GPIO或 5V 脚共地线接没接IN1/IN2/ENA 三个位置对不对⑩ 最后才通电先接上电机电池盒再插 ESP32 的 USB开 monitor 对照 12.2 末尾的预期日志【运行期安全框】摸温度运行中时不时摸一下 L298N 的散热片和电机外壳——温热正常烫得不敢摸不正常第一怀疑对象是堵转或短路立即断电排查每轮约 12s剧本是正转→反转→刹车 2s→滑行 2s约 12 秒一轮连续循环别让人走开电机还空转半小时观察完随时拔 USB 断电随时断电闻到异味、听到怪响、摸到发烫——先拔电源再谈别的。12.4 排查流程按信号链逐环查症状先查环节再查没日志、不烧录烧录链第 2 章线/端口/驱动有日志、电机不动电源 共地接线清单电机只震不转ENA 的 PWM占空比/频率配置只朝一个方向方向逻辑IN1/IN2 接线与真值表刹车刹不住ENA 占空比是否拉满 100%9.5 核心坑初始化失败fade 服务顺序 timer→channel→fade一转就重启电源电流不足换大电流电源崩溃第 11 章流程类型→地址→调用链12.5 双电机挑战实例计数的实战资源分配S3 的账本资源数量双电机怎么分LEDC 定时器4同频同分辨率可共享 1 个想各自独立就各 1 个LEDC 通道8电机 A 用通道 0电机 B 用通道 1fade 服务全芯片 1 个只装一次最后实例才卸载GPIO每个电机 3 个A:16/17/18B:4/5/619/20 是 USB-JTAG、26~37 被 Flash/PSRAM 占用都别碰第二路的引脚方案不用我们自己发明——main.cpp第 41~45 行的注释就是官方答案GPIO4/5/6 LEDC_CHANNEL_1 LEDC_TIMER_1并且告诫务必换用另一个定时器挂在同一定时器上的通道共享频率和分辨率改一路的setFrequency()/setResolution()会连带把另一路也改了。把 B 路落到实物板上沿用 12.3 的断电流程电源和共地两路共用、不必新接GPIO4 → IN3、GPIO5 → IN4B 路方向线GPIO6 → ENB 排针ENB 的跳线帽也要拔道理同 ENA12.3 第①步B 电机两根线 → OUT3 / OUT4DCMotor::Config本来就有channel/timer/speed_mode这些字段第 8 章双电机不需要扩展任何代码显式传参就行。完整示例程序真实类可抄跑#includeesp_err.h#includeesp_log.h#includefreertos/FreeRTOS.h#includefreertos/task.h#includemotor_control.hstaticconstexprconstchar*TAGdual;externCvoidapp_main(void){ESP_LOGI(TAG,L298N 双电机演示启动);// A 路IN116 IN217 ENA18通道 0 定时器 0DCMotormotor_a({.in1GPIO_NUM_16,.in2GPIO_NUM_17,.enaGPIO_NUM_18,.channelLEDC_CHANNEL_0,.timerLEDC_TIMER_0,});// B 路IN14 IN25 ENA6通道 1 定时器 1// 必须换定时器同一定时器上的通道共享频率与分辨率DCMotormotor_b({.in1GPIO_NUM_4,.in2GPIO_NUM_5,.enaGPIO_NUM_6,.channelLEDC_CHANNEL_1,.timerLEDC_TIMER_1,});ESP_ERROR_CHECK(motor_a.init());// 实例计数1装 fade 服务ESP_ERROR_CHECK(motor_b.init());// 实例计数2服务已装不重装while(true){ESP_LOGI(TAG,A 正转加速B 反转加速);for(ints0;s100;s10){ESP_ERROR_CHECK(motor_a.setSpeed(s));ESP_ERROR_CHECK(motor_b.setSpeed(-s));vTaskDelay(pdMS_TO_TICKS(150));}vTaskDelay(pdMS_TO_TICKS(1000));ESP_LOGI(TAG,A 刹车停B 滑行停);ESP_ERROR_CHECK(motor_a.stop(DCMotor::StopMode::Brake));ESP_ERROR_CHECK(motor_b.stop(DCMotor::StopMode::Coast));vTaskDelay(pdMS_TO_TICKS(2000));}}freq_hz/resolution没写用Config里的默认值 20000Hz/10bit引脚没有默认值所以必须传。这个程序还自带一帧同框对比每轮末尾 A 用 Brake、B 用 Coast——A 短接绕组立刻定住B 关断输出、引脚高阻靠惯性溜一会儿才停9.6 的活版。两台电机同板同电源并排跑两种停法的差别一眼分明。为什么这个顺序对底层逻辑回顾fade 服务是全局单例7.6装两次报已存在每个 DCMotor 实例的 init/deinit 只负责给s_active_instances加一/减一只有计数归零的那个实例才真正卸载deinit()里的if (--s_active_instances 0 s_ledc_fade_installed)——保证另一个实例还能用这就是s_ledc_fade_installeds_active_instances的完整意义。两个电机独立控制后自然想让它们各跑各的剧本——把每个电机的控制放进独立 FreeRTOS 任务就是第 13 章的多任务应用。12.6 六个升级实验速度曲线改真实剧本的kStepPercent/kStepDelayMs比如 10%/500ms 对比 2%/80ms观察加速曲线想体验硬件级PWM 渐变要另用ledc_set_fade_with_time()ledc_fade_start()——applyDuty走的是ledc_set_duty_and_updatehpoint0立即生效没有渐变时间这回事9.5停法对比motor.stop(DCMotor::StopMode::Coast);vsmotor.stop(DCMotor::StopMode::Brake);第 9 章双电机交替跑 12.5 的完整程序A 正转时 B 反转验证实例计数 通道/定时器分配遥控小车WiFi 收指令 → 队列 → 电机任务执行第 16 章组件化重构把 DCMotor 移进components/第 17 章OTA 升级给小车配网络升级第 18 章。12.7 毕业自检表能说出烧录成功 vs 程序报错的判断依据Calling app_main()能用公式解释 PWM 平均电压、频率与分辨率的关系能画出 H 桥四开关与正转/反转/刹车的对应能解释 fade 服务为什么配置后装、为什么最后实例卸载能独立完成接线 → 编译 → 烧录 → 看日志 → 排查 → 修改 → 再烧崩溃时会用 类型 EXCVADDR addr2line 定位能说出固件各段text/data/bss与 Flash/SRAM 的对应12.8 想一想 小测验想一想双电机共享定时器的前提条件是什么共享之后会有什么副作用若 B 电机先 deinit 而 A 还在转fade 服务会怎样为什么安全信号链中只震不转最可能断在哪一环小测验真实演示剧本的第一个动作A. 反转 B. 正转从 0% 到 100% 每档 5% 加速 C. 刹车setSpeed(80)的占空比档位约是A. 818 B. 80 C. 1023谁负责卸载 fade 服务A. 先退出者 B. 最后退出者 C. 谁都不双电机示例里 B 路的 ENA 引脚是A. GPIO6 B. GPIO16 C. GPIO33B 路完整三脚IN1/IN2/ENA GPIO4/5/612.9 本章总结信号链代码 → clamp → 方向占空比 → LEDC → ENA → L298N → 电机排查 沿链逐环电源/共地 → 烧录 → 日志 → fade → 崩溃双电机Config显式传 GPIO4/5/6 通道 1 定时器 1加 fade 实例计数是组件化设计的活例子动手 看日志是嵌入式成长唯一的捷径。恭喜完成下一步建议book/README.md的进阶路线或把 DCMotor 扩展成组件放进components/复用。进阶路线第三部分第 13 章 FreeRTOS → 第 14 章外设 → 第 15 章中断 →第 16 章 WiFi → 第 17 章组件化 → 第 18 章 OTA一路走到能交付产品。
