Project Guide

Tesla Pack Monitor

DIY standalone diagnostic tool for Classic Tesla Model S / X battery packs. Built to diagnose cell imbalance and pack health without relying on expensive commercial tools.

1 Mission

Create a portable, self-contained tool that plugs into a Tesla battery pack, reads live brick voltages and temperatures, and clearly shows imbalance and health — all without needing a laptop on site.

Short-term (v1 – working device)

Longer-term potential

Better diagnostics

Per-brick CAC estimates, historical trends, clearer fault interpretation

Web dashboard

SoftAP mode so you can view live data on a phone browser when desired

Multi-platform

Support newer Tesla packs (Model 3/Y, Raven) with profile switching

Reporting

Generate TPM-style reports for records or resale documentation

2 Current Status

Overall progress to first working device ~48%

Completed

  • Done   Hardware selected and ordered
  • Done   Core data model (Pack → Modules → Bricks)
  • Done   0x6F2 decoder for brick voltages + temperatures
  • Done   Full CLI tool with multiple modes
  • Done   GitHub repo + local development setup
  • Done   Project guide site

CLI capabilities now available

Option Description
./tpmDemo mode with synthetic data
--log FILEDecode candump-style log files
--can IFACELive SocketCAN listener (ready for hardware)
--jsonMachine-readable JSON output
--weak NControl number of weakest bricks shown
--report FILESave human-readable text report

3 Roadmap to a Working Device

High-level sequence from today to a fully usable standalone tool.

4 Near-term Focus

Software foundation is in good shape. Next priority is hardware.

  1. Wait for / receive remaining parts
  2. Assemble the enclosure (display, buttons, Radxa + CAN HAT, BMS pigtail)
  3. Bring up the Radxa Zero 3W and confirm SocketCAN works
  4. Capture first real 0x6F2 frames from the pack
  5. Begin the on-device display + button UI
Offline software development can continue in parallel (display UI skeleton, better report formatting, etc.), but the critical path is now hardware assembly and first live CAN capture.

5 Quick Reference

Repo

github.com/mikesudyk/tesla-pack-monitor

Run the CLI

./tpm  ·  ./tpm --json  ·  ./tpm --report scan.txt

Key CAN message

0x6F2 — 96 brick voltages + 32 temperatures

Target pack

2015 Tesla Model S 85D (Classic architecture, 16 modules)