Claude Code 的 settings.json 里，allowedTools 到底在标记什么？——从阿里全员卸载说起
2026/9/27 12:06:06
适用对象：具备C语言基础，计划使用STM32制作机器人（如瓦力）或舵机控制类项目的开发者。
主控芯片：STM32F103C8T6（经典入门款）
核心工具：Keil/STM32CubeIDE、STM32CubeMX、万用表、3D打印机（可选）
第一章 核心驱动：PWM舵机控制与串口指令
1.1 舵机控制原理与定时器配置
常用航模舵机（如MG996R）采用PWM（脉宽调制）信号控制角度，标准参数如下：
信号周期：20ms（频率50Hz）
脉宽映射：0.5ms → 0°，1.5ms → 90°，2.5ms → 180°
工程实现时，利用STM32定时器产生6路PWM信号（控制6个关节）。以TIM2的4个通道 + TIM3的2个通道为例，CubeMX关键配置参数：
| 配置项 | 数值 | 计算依据 |
|---|---|---|
| 定时器时钟源 | 72MHz（内部高速时钟） | STM32F103系统时钟默认72MHz |
| 预分频系数（Prescaler） | 72-1 | 72MHz/72 = 1MHz，得到1μs的计数单位 |
| 自动重载值（Period） | 20000-1 | 20ms周期 = 20000个1μs |
| 通道比较值（Pulse） | 500~2500 | 对应0.5ms ~ 2.5ms脉宽 |
核心转换函数（将角度转为比较寄存器值）：
c
#define SERVO_MIN_PULSE 500 // 0°对应脉宽(us) #define SERVO_MAX_PULSE 2500 // 180°对应脉宽(us) uint16_t Angle_To_Pulse(uint16_t angle) { return SERVO_MIN_PULSE + (angle * (SERVO_MAX_PULSE - SERVO_MIN_PULSE) / 180); }1.2 多路舵机控制代码实现
初始化启动全部PWM通道后，通过如下函数设置任意舵机角度：
c
uint16_t servo_angles[6] = {90, 90, 90, 90, 90, 90}; // 默认中位 void Servo_SetAngle(uint8_t id, uint16_t angle) { if (id > 5 || angle > 180) return; servo_angles[id] = angle; uint16_t pulse = Angle_To_Pulse(angle); switch(id) { case 0: __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, pulse); break; case 1: __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_2, pulse); break; case 2: __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_3, pulse); break; case 3: __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_4, pulse); break; case 4: __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_3, pulse); break; case 5: __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_4, pulse); break; } }1.3 串口指令解析（上位机控制）
通过USART1（PA9 TX， PA10 RX）接收上位机指令，协议极简："关节ID 目标角度"，例如发送"0 90"将1号舵机转到90°。
c
void Parse_Command(char *cmd) { int id, angle; if (sscanf(cmd, "%d %d", &id, &angle) == 2 || sscanf(cmd, "%d,%d", &id, &angle) == 2) { if (id >= 0 && id <= 5 && angle >= 0 && angle <= 180) { Servo_SetAngle(id, angle); } } }接收逻辑：在串口中断回调中逐个字符接收，遇到换行符\n或回车符\r时截断并调用解析函数。
工程提醒：舵机电源必须独立外接5V（电流≥2A），切勿由STM32的3.3V或USB口直接供电，否则瞬时大电流会导致主控复位。
第二章 人机交互：OLED显示屏驱动（SSD1306）
为实时显示舵机角度、传感器数据或调试信息，推荐添加0.96寸OLED屏（I2C接口）。
2.1 硬件连接与I2C配置
| OLED引脚 | STM32引脚 | 说明 |
|---|---|---|
| VCC | 3.3V | 电源 |
| GND | GND | 地 |
| SCL | PB6 | I2C1时钟线（CubeMX配置为开漏输出） |
| SDA | PB7 | I2C1数据线 |
I2C速率配置为100kHz（标准模式）或400kHz（快速模式），SSD1306的7位设备地址通常为0x3C。
2.2 驱动初始化与显示接口
移植通用的ssd1306.c驱动库后，主函数调用流程：
c
#include "ssd1306.h" #include "ssd1306_fonts.h" int main(void) { HAL_Init(); SystemClock_Config(); MX_I2C1_Init(); ssd1306_Init(); // 初始化OLED ssd1306_Fill(Black); // 清屏（全黑） ssd1306_UpdateScreen(); // 将显存数据刷到屏幕 ssd1306_SetCursor(10, 20); // 设置光标（列，行） ssd1306_WriteString("Angle: 90", Font_11x18, White); ssd1306_UpdateScreen(); while (1) { // 循环更新显示角度值 } }显存操作要点：ssd1306_UpdateScreen()负责将内存数组全部通过I2C发送，频繁调用会占用总线时间，建议按需刷新（例如舵机角度变化时才刷新）。
第三章 硬件选型与电路图认知
3.1 机械臂/机器人硬件物料清单（以6轴瓦力为例）
| 部件 | 型号/规格 | 数量 | 作用 |
|---|---|---|---|
| 主控板 | STM32F103C8T6最小系统板 | 1 | 核心运算与控制 |
| 舵机 | MG996R（金属齿轮） | 6 | 关节运动执行 |
| 直流减速电机 | TT马达或N20 | 2 | 履带/轮式行走驱动 |
| 电机驱动模块 | L298N 或 TB6612FNG | 1 | 驱动直流电机（需提供大电流） |
| 舵机驱动扩展 | PCA9685（16路PWM） | （可选） | 当舵机数量超过6个时，解放CPU定时器资源 |
| 电源系统 | 2S/3S锂电池 + 降压模块（5V/5A） | 1套 | 为舵机和主控提供稳定电源 |
| 通信模块 | HC-05蓝牙串口模块 | （可选） | 实现手机APP无线遥控 |
3.2 如何快速看懂原理图（三步法）
拿到一块驱动板或扩展板的原理图时，不要被密密麻麻的走线吓倒，按以下顺序梳理：
找电源与地：先定位所有标
VCC、3.3V、5V的网络，再找所有标GND的符号（三条横线）。记住：所有GND在物理上必须相连（共地），否则信号无法回流。识别网络标签：原理图中标有相同英文字母（如
PA9、SERVO_PWM）的节点，在物理上是用导线直连的，哪怕在图纸上相隔很远。这是理解信号流向的关键。模块化切割：将原理图拆解为电源入口、MCU最小系统、电机驱动、传感器接口四个区域，逐个击破。
避坑重点：若原理图上存在两组地线（
PGND（功率地）和GND（信号地）），说明设计者做了隔离。焊接时不可随意短接，一般通过0欧电阻或磁珠在电源输入端单点相连，否则电机大电流干扰会通过地线窜入STM32导致死机。
第四章 工程调试：万用表实战速查手册
硬件组装完成后，调试是必不可少的环节。万用表是排查“烧板、不转、抖动”等故障的首选工具。
4.1 表笔插孔与档位准则（新手必看）
黑表笔：始终插入COM孔。
红表笔：
测电压、电阻、通断→ 插入VΩmA孔（严禁插入下方大电流孔，否则测电压会短路）。
测大电流（≥200mA）→ 插入10A孔（适用于测量舵机堵转电流或整机功耗）。
4.2 四大核心功能在机器人调试中的实战应用
| 档位 | 操作注意 | 瓦力项目实战场景 |
|---|---|---|
通断蜂鸣档（)))） | 必须断电测量 | 查舵机供电线是否断路：红笔点舵机红线（VCC），黑笔点主控5V输出焊盘。蜂鸣器响说明线路完好；不响则检查杜邦线或焊点虚焊。 |
直流电压档（V—选20V量程） | 带电并联测量（红笔接正，黑笔接负） | 排查舵机抖动：黑笔夹电池总负极，红笔点舵机供电端。手动憋住舵机（堵转），若电压瞬间从5V跌落至4.2V以下，说明电池内阻过大或供电线太细，必须更换动力型电池或加粗线径。 |
电阻档（Ω选200Ω档） | 必须断电，且断开被测元件一端 | 判断直流电机是否烧毁：测电机两根引线，正常值在几欧到几十欧。若显示无穷大（1），说明内部线圈断路；若显示接近0，说明短路（线圈烧穿）。 |
直流电流档（A—选10A档） | 必须串联进电路（断开电源正极，红表笔接电池正，黑表笔接板子VIN） | 评估电源余量：测整机峰值电流。若降压模块标称1A，实测开机瞬间冲到1.5A，则降压模块会过载保护或发热严重，需升级为2A以上模块。 |
4.3 三条绝对安全红线
严禁带电测电阻：使用Ω档时，电路板必须彻底断电。因为万用表欧姆档内部有电池，会向外输出测试电压，若板子带电，轻则测量值错误，重则烧毁STM32内部钳位二极管。
测量高压时严禁转动旋钮：若红表笔正顶着5V或12V电压，此时手滑将旋钮拧到电阻档，等同于将电源正负极通过万用表内部电阻短路，瞬间烧毁万用表保险管，甚至引发冒烟。
黑表笔固定接“总地”：测量多点电压时，黑表笔始终夹在电池总负极或主控板的GND总入口，避免随意更换接地点导致测量基准浮动，得出虚假数值。
第五章 认知提升：STM32在计算机体系结构中的映射
理解底层架构有助于写出更高效的代码。将经典的“计算机组成原理”框图与STM32内部结构对应：
| 原理图模块 | STM32内部对应实体 | 工程意义 |
|---|---|---|
| 运算器部件 + 指令寄存器（IR）+ 程序计数器（PC） | Cortex-M3/M4处理器内核（ALU、寄存器组） | 决定了算力（主频、是否带FPU浮点单元） |
| 控制信号产生电路 | NVIC嵌套向量中断控制器 + 时钟树（RCC） | 控制中断优先级与外设时钟开关，影响实时性 |
| 内存储器 | 片内Flash（程序存储） + SRAM（变量存储） | 决定最大程序体积和内存堆栈大小 |
| 地址总线/数据总线/控制总线 | AHB总线矩阵 + APB外设总线 | 决定了外设访问速度（如GPIO翻转频率上限） |
| 接口 | GPIO、USART、I2C、SPI、TIM等外设 | 实际连接舵机、传感器、屏幕的物理引脚 |
理解此映射关系后，配置寄存器便不再是“照着例程抄”，而是清楚知道自己在配置哪条总线上的哪个外设，这对后期移植RTOS或进行底层性能优化至关重要。