flipper-tesla-fsd 中文教程：先从 Listen-Only 开始
flipper-tesla-fsd 是给 Flipper Zero 和 ESP32 使用的 Tesla CAN 研究固件。它既能只读抓包，也包含主动修改并重发 CAN 帧的实验功能。两类用途风险不同，不能把安装成功当成车型兼容或道路安全证明。
1. 先确认当前固件边界
官方置顶 FAQ 已给出明确结论：Tesla 2026.14.x、2026.20 和 2026.26.x 不能靠 CAN 激活 FSD。车内预检以及 CAN 之外的区域或权益校验会拦住激活。Nag Killer、TLSSC Restore、Summon EU 距离调整和抓包仍有各自范围，但要逐项核对车型、硬件代际和固件。
这意味着旧教程里笼统的“FSD 解锁”说法已经不准确。购买硬件前，先看 README 的兼容表和对应 release；如果你的目标只有只读研究，保持 Listen-Only 即可。
2. 选择 Flipper Zero 或 ESP32
Flipper 路径需要 Flipper Zero、MCP2515 CAN 扩展和车辆接线。ESP32 路径覆盖 M5Stack ATOM、Lilygo T-CAN485、Waveshare ESP32-S3-RS485-CAN 与通用 ESP32+MCP2515。官方 README 给出的 ESP32 入门成本更低，并带 Wi-Fi 控制页。
两条路径复用相近的 CAN 逻辑，但构建和驱动不同。Flipper 使用 FAP；ESP32 根据板卡选择 TWAI 或 MCP2515。不要用板卡价格代替兼容判断，接线位置和车型信号布局更关键。
3. 安装官方构建
Flipper 用户可以从 release 下载 tesla_mod.fap，复制到 SD Card/apps/GPIO/。ESP32 用户可用官方 Web Flasher；需要自行构建时再用 PlatformIO。
git clone https://github.com/hypery11/flipper-tesla-fsd.git cd flipper-tesla-fsd ufbt cd esp32 pio run -e m5stack-atom # 其他目标：esp32-lilygo、waveshare-s3-can、esp32-mcp2515
接线前阅读官方 HARDWARE.md。OBD-II 在部分 Model 3/Y 进入 Drive 后可能静默，X179 的针脚也随接口版本而异，不能照着一张非官方图片盲接。
4. 首次连接只做三项检查
保持 Listen-Only，先确认设备识别到的 HW 代际，再查看目标 CAN ID 是否稳定出现，最后检查 rx_missed 和 dropped。v2.16-beta.27 会区分单 ID 全速抓取与多 ID 抽样流；研究 counter 或 checksum 时，应按官方说明使用单 ID 硬件过滤。
如果 HW4 被识别成 HW3，当前版本提供手动硬件选择和 Signal Map。先记录车辆年份、硬件、Tesla 固件、接线点与观察结果，再改设置。不要直接打开 TX 试错。
5. 与 S3XY Commander 对比
S3XY Commander 是商业 OBD 设备，配套手机配置、仪表和 S3XY 配件；flipper-tesla-fsd 是开源研究固件，用户能检查代码并自行选择硬件。想做 CAN 研究、愿意维护固件的人更适合后者。希望按厂商安装资料使用成品硬件的人，应比较 Commander 的车型支持和售后。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
原教程未展开的系统信息
核心功能
硬件与信号映射手动选择
部分车辆不广播 0x398，自动识别可能把 HW4 当成 HW3。当前 beta 提供 Auto、Force HW4、Force HW3、Force Legacy 和 Flipper Signal Map 选项，让用户按实际总线布局调整。
架构与数据流
项目在 Party CAN 上采用单总线 read-modify-retransmit：读取车辆广播帧，只改目标字段，再重新发送。Flipper 端以 FAP 运行，通过 MCP2515 接入；ESP32 端按板卡选择内置 TWAI 或外接 MCP2515，并提供 Wi-Fi 控制页。抓包路径和主动发帧路径必须分开看：Listen-Only 适合先确认 CAN ID 与信号布局，写入功能则受车型、固件和总线位置影响。
技术栈和运行条件
语言
C（Flipper Zero）与 C++/Arduino（ESP32）
框架
Flipper FAP、ufbt、PlatformIO、ESP32 TWAI 或 MCP2515
关键依赖
- Flipper Zero + MCP2515 CAN 扩展，或受支持的 ESP32 CAN 板
- OBD-II 或 X179 接线
- 浏览器 flasher、ufbt 或 PlatformIO
运行环境
车载 CAN 环境；主动发帧只应在台架或封闭场地评估
常见问题
它还能在 Tesla 2026.14.x 以后激活 FSD 吗？
不能。官方 FAQ 说明，CAN 之外的预检和区域或权益校验会阻止 FSD 激活。
Flipper Zero 和 ESP32 应该选哪个？
已有 Flipper Zero 可使用 FAP。新购硬件时可比较 ESP32 的成本、Web Flasher 和 Wi-Fi 控制页，再按官方硬件表确认板型。
为什么要先用 Listen-Only？
它能先确认接线、信号布局和抓包质量，避免在信息不全时发送车辆控制帧。
v2.16-beta.27 可以直接用于日常道路吗？
不应这样使用。它是预发布版，官方把涉及 FSD 激活和车辆动作的实验限定在台架或封闭场地，部分能力仍需要车载测试者验证。