TeslaLogger + ScanMyTesla深度集成教程：快速解锁108颗电芯电压、电池温度与真实电池容量
项目地址: https://gitcode.com/gh_mirrors/te/TeslaLogger TeslaLogger 是一款自托管的特斯拉数据记录器（支持 Model S/3/X/Y，可运行在树莓派、Docker 和群晖上）。通过集成 ScanMyTesla（SMT） 应用，TeslaLogger 可以突破官方 API 的数据限制，实时记录 108 颗电芯电压、31 个电池温度传感器 以及 真实电池容量（Nominal full pack） 等独家信号，让每一度电的健康状态都尽在掌握 ⚡
为什么需要 ScanMyTesla 集成？
特斯拉官方 API 只提供车辆级的汇总数据，比如总电压、总 SOC、预估续航。但对于想深入了解电池健康的车主来说，这些数据远远不够：
- 📉 哪颗电芯电压最低？是否出现不一致（Cell Imbalance）？
- 🌡️ 电池包内温度是否均匀？快充时最高温达到多少？
- 🔋 电池真实可用容量衰减了多少？而不是看"标称容量"
ScanMyTesla 是一款手机 App，通过车载 OBD2 接口 读取 CAN 总线信号，再把这些深度数据实时推送到你的 TeslaLogger 服务端。数据落地后自动进入 MySQL 数据库的 can 表，所有 Grafana 仪表板开箱即用。
四步完成 TeslaLogger + ScanMyTesla 集成
第 1 步：安装 OBD2 适配器 在 Model 3/Y 上，接口通常位于后排座椅前的中央扶手下方。需断开高压（Model 3/Y 的开关在后排座椅左下方），用 Y 型线缆将适配器串入数据总线。不确定的话建议找专业改装店安装。
第 2 步：配对手机 App 将 OBD2 适配器通过蓝牙与 ScanMyTesla App 配对，并在 App 的 Settings → Teslalogger 中填入你的 TeslaLogger 服务地址和 Token。
第 3 步：在 TeslaLogger 管理面板开启集成 打开 TeslaLogger 的 Web 管理界面（/admin），找到 ScanMyTesla integration 选项并勾选启用，同时复制 Tasker Token 填入手机 App 中（该设置位于 settings.php 对应的前端页面）。面板中会显示 "ScanMyTesla last received" 时间戳，用它确认数据链路已打通 ✅
第 4 步：上车开跑 App 保持运行（后台即可），每次行驶和充电时，选定的信号点会自动推送到 TeslaLogger。数据接收逻辑在 ScanMyTesla.cs 中实现，服务端每 5 秒轮询一次最新数据包并写入数据库，无需任何额外操作。
108颗电芯电压：逐颗监控仪表盘
这是 SMT 集成最"硬核"的能力——电池包里 每一颗电芯的电压（信号 ID 101–208）都会被独立记录。TeslaLogger 自带 5 个分段的电芯电压仪表板：
- Zellspannungen 01-20
- Zellspannungen 21-40
- Zellspannungen 41-60
- Zellspannungen 61-80
- Zellspannungen 81-99
对应的仪表板定义位于 Zellspannungen 01-20 - ScanMyTesla.json 等文件，安装时自动导入 Grafana，直接打开即可查看。
充电末期是电芯电压分化最明显的时刻：大部分电芯会整齐爬升到 4.1V 以上，而"掉队"的电芯电压明显偏低。持续观察最低电芯（信号 ID 5）的曲线，是判断电池一致性最直观的方法。
电池温度监控：31个温度传感器全覆盖
除整体温度外，SMT 还能读取电池包内 31 个温度传感器的独立读数（信号 ID 301–331），以及电池冷却液进出口温度、电池泵状态等热管理系统信号。TeslaLogger 提供 "Zelltemperaturen 1-20"、"Zelltemperaturen 21-40" 两个仪表板（定义见 Zelltemperaturen 1-20.json），帮助你发现局部过热点——这往往是电池热管理异常最早的信号。
真实电池容量：告别"标称衰减率"
SMT 推送的 Nominal full pack（信号 ID 71）由 BMS 根据实际充入电量计算，是判断电池真实容量的黄金指标。TeslaLogger 的 Degradation（衰减） 仪表板会将其与车队数据对比，绘制出你的电池衰减曲线和相对整车的健康度排名。此外还有 Cell Imbalance（信号 ID 27）、BMS 最大充/放电功率（ID 28/29）等辅助信号，让衰减分析更立体。
配合 Akku Trips（电池行程） 仪表板，还能看到每次行程中充入/放出能量的逐次变化，追踪长期容量趋势一目了然。
还能解锁什么？
信号远不止电池数据。完整的信号 ID 清单（含 HVAC 空调系统、前后电机扭矩/效率、踏板开度、车轮转速等 290+ 行文档）可查阅 signalIds.md。
| 数据类别 | 典型信号 | 信号 ID |
|---|---|---|
| 电芯电压 | 单颗电芯 1–108 | 101–208 |
| 电芯温度 | 温度传感器 1–31 | 301–331 |
| 电池容量 | Nominal full pack | 71 |
| 电芯一致性 | Cell imbalance | 27 |
| BMS 功率限制 | Max charge / discharge | 28 / 29 |
| 空调系统 | HVAC 状态、风速、温度 | 45–50 |
基于这些数据，TeslaLogger 还内置了 HVAC（空调） 和 Performance（性能） 等 ScanMyTesla 专属仪表板，可监控每次行程的空调能耗与电机效率：
常见问题
Q：不装 OBD2 能用这些功能吗？ 不能。SMT 数据来自 CAN 总线，必须通过 OBD2 适配器读取；TeslaLogger 本身的普通数据记录不受影响。
Q：数据是实时推送还是定时同步？ App 在车辆上电运行期间持续推送，服务端每 5 秒接收一次，仪表板延迟基本在秒级。
Q：数据存在哪里？ 所有 SMT 信号统一写入 MySQL 的 can 表（字段：id 信号编号、val 数值、datum 时间、CarId 车辆），可自行编写 SQL 扩展分析，仪表板查询即基于此表。
小结
只需一个 OBD2 适配器和 10 分钟配置，TeslaLogger 就能把你的特斯拉变成一台"电池体检仪"：108 颗电芯电压逐颗可见、31 个温度点实时监控、真实容量随时间可追溯。对于关注二手电池健康、喜欢深挖数据的车主来说，这是目前最完整的自托管解决方案。
📚 延伸阅读：
- 集成指南（德语）：scanmytesla.md
- 全部信号 ID 文档：signalIds.md
- 集成核心源码：ScanMyTesla.cs
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
