{"id":48232582,"url":"https://github.com/hypery11/flipper-tesla-fsd","last_synced_at":"2026-04-16T09:05:59.179Z","repository":{"id":348655717,"uuid":"1197477912","full_name":"hypery11/flipper-tesla-fsd","owner":"hypery11","description":"Tesla FSD unlock for Flipper Zero — HW3/HW4 auto-detect, CAN bus injection via MCP2515","archived":false,"fork":false,"pushed_at":"2026-04-05T06:56:53.000Z","size":87,"stargazers_count":20,"open_issues_count":2,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-05T20:02:26.834Z","etag":null,"topics":["automotive","can-bus","flipper-zero","flipper-zero-app","fsd","mcp2515","obd2","tesla","tesla-model-3","tesla-model-y"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hypery11.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-31T16:01:10.000Z","updated_at":"2026-04-05T18:45:06.000Z","dependencies_parsed_at":"2026-04-06T21:00:30.727Z","dependency_job_id":null,"html_url":"https://github.com/hypery11/flipper-tesla-fsd","commit_stats":null,"previous_names":["hypery11/flipper-tesla-fsd"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/hypery11/flipper-tesla-fsd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypery11%2Fflipper-tesla-fsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypery11%2Fflipper-tesla-fsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypery11%2Fflipper-tesla-fsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypery11%2Fflipper-tesla-fsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypery11","download_url":"https://codeload.github.com/hypery11/flipper-tesla-fsd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypery11%2Fflipper-tesla-fsd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31489427,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automotive","can-bus","flipper-zero","flipper-zero-app","fsd","mcp2515","obd2","tesla","tesla-model-3","tesla-model-y"],"created_at":"2026-04-04T19:43:59.495Z","updated_at":"2026-04-16T09:05:59.173Z","avatar_url":"https://github.com/hypery11.png","language":"C","funding_links":[],"categories":["Applications"],"sub_categories":["Episodes"],"readme":"[English](README.md) | [繁體中文](README_zh-TW.md) | [简体中文](README_zh-CN.md)\n\n# Tesla Mod for Flipper Zero\n\n[![GitHub stars](https://img.shields.io/github/stars/hypery11/flipper-tesla-fsd?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/hypery11/flipper-tesla-fsd?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/network)\n[![GitHub release](https://img.shields.io/github/v/release/hypery11/flipper-tesla-fsd?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/releases)\n[![Downloads](https://img.shields.io/github/downloads/hypery11/flipper-tesla-fsd/total?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/releases)\n[![Last commit](https://img.shields.io/github/last-commit/hypery11/flipper-tesla-fsd?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/commits/main)\n[![Open issues](https://img.shields.io/github/issues/hypery11/flipper-tesla-fsd?style=flat-square\u0026logo=github)](https://github.com/hypery11/flipper-tesla-fsd/issues)\n[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](CONTRIBUTING.md)\n[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue?style=flat-square)](LICENSE)\n[![Build](https://img.shields.io/badge/build-ufbt-brightgreen?style=flat-square)](https://github.com/flipperdevices/flipperzero-ufbt)\n[![Flipper target](https://img.shields.io/badge/Flipper%20target-7%20%2F%20API%2087.1-orange?style=flat-square)](https://github.com/flipperdevices/flipperzero-firmware)\n[![Tracked on FSD CAN Mod Hub](https://img.shields.io/badge/tracked%20on-FSD%20CAN%20Mod%20Hub-orange?style=flat-square)](https://fsdcanmod.com/project/hypery11-flipper-zero)\n\n\u003e **Tesla FSD region-gate bypass for Flipper Zero.** Enables the FSD UI toggle for users who **already have an active FSD subscription or purchase** but are in a region where the \"Traffic Light and Stop Sign Control\" option is not exposed in the vehicle menu. HW3, HW4, Legacy HW1/HW2. FSD v14 ready. Also includes nag killer, ISA speed chime suppression, OTA guard, battery preconditioning trigger, and a live BMS dashboard — these work independently of FSD entitlement. Total hardware cost: Flipper Zero + Electronic Cats CAN Bus Add-On + OBD-II cable — or build the [$14 ESP32 port](https://github.com/hypery11/flipper-tesla-fsd/tree/main/esp32) instead.\n\n\u003e [!IMPORTANT]\n\u003e **An active FSD package is required for FSD features** — either purchased or subscribed. This tool enables the FSD functionality at the CAN bus level, but the vehicle still needs a valid FSD entitlement from Tesla. It is NOT a purchase bypass.\n\n\u003e [!CAUTION]\n\u003e **Tesla has begun issuing VIN-level bans** (April 2026). Affected vehicles lose the TLSSC toggle silently — no OTA, no warning, persists across account transfers and re-subscriptions. CAN injection cannot override a VIN ban. See [SECURITY.md](SECURITY.md) and [issue #18](https://github.com/hypery11/flipper-tesla-fsd/issues/18) for details. Non-FSD features (nag killer, BMS dashboard, diagnostics) are not affected.\n\u003e\n\u003e If FSD subscriptions are not available in your region, the upstream community documents a workaround: create a Tesla account in a region where FSD subscriptions are offered (e.g. Canada), transfer the vehicle to that account, and subscribe. See the [upstream documentation](https://gitlab.com/slxslx/tesla-open-can-mod-slx-repo) for details.\n\u003e\n\u003e Features like the Nag Killer, ISA Speed Chime Suppression, BMS Dashboard, and battery preconditioning work **without** FSD and do not require any subscription.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo.gif\" alt=\"Tesla FSD unlock running on Flipper Zero — main menu, HW detect, and live BMS dashboard\" width=\"600\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshots/main_menu.png\" alt=\"Flipper Zero Tesla FSD main menu\" width=\"256\"\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"screenshots/fsd_running.png\" alt=\"Tesla FSD unlock running on Flipper Zero\" width=\"256\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#hypery11/flipper-tesla-fsd\u0026Date\"\u003e\n    \u003cimg src=\"https://api.star-history.com/svg?repos=hypery11/flipper-tesla-fsd\u0026type=Date\" alt=\"Star history\" width=\"600\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hypery11/flipper-tesla-fsd/graphs/contributors\"\u003e\n    \u003cimg src=\"https://contrib.rocks/image?repo=hypery11/flipper-tesla-fsd\" alt=\"Contributors\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Features\n\n- Auto-detect HW3/HW4 from `GTW_carConfig` (`0x398` on legacy / `0x7FF` on Ethernet), or force manually — **note:** on 2020+ Model 3/Y HW3/HW4, `0x398` is on the Ethernet bus and may not appear on the CAN bus tap; use Force HW3 or Force HW4 if auto-detect doesn't find it\n- **Legacy mode** for HW1/HW2 (Model S/X 2016-2019)\n- FSD unlock via bit manipulation on `UI_autopilotControl` (`0x3FD` / `0x3EE`)\n- Nag suppression (hands-on-wheel reminder)\n- Speed profile defaults to fastest, syncs from follow-distance stalk\n- Live status on Flipper screen\n\n### Settings (runtime toggles)\n\n| Setting | Description |\n|---------|-------------|\n| **Mode** | `Active` / `Listen-Only` / `Service`. Listen-Only is the **first-boot default** as of v2.4 — the MCP2515 is put into hardware listen-only mode and physically cannot TX. Switch to Active when you're ready. |\n| **Force FSD** | Bypass the `isFSDSelectedInUI` CAN-level check so frames are modified even if the car's Traffic Light toggle is absent. **This does not bypass Tesla's server-side entitlement verification** — it only affects the local CAN frame flow. Useful when the toggle exists in the car but is hidden by the region UI gating. |\n| **Suppress Chime** | Kill the ISA speed warning chime (HW4 only, CAN ID `0x399`) |\n| **Emerg. Vehicle** | Enable emergency vehicle detection flag (HW4 only, bit59) |\n| **Nag Killer** | EPAS counter+1 echo on `0x370` (CAN 880 method, ported from upstream MR !44) |\n| **Precondition** | Periodic `0x082 byte[0] = 0x05` inject to trigger BMS battery preheat. Same trick Tesla uses for Supercharger preconditioning. |\n\n### HW Support\n\n| Tesla HW | Bits Modified | Speed Profile |\n|----------|---------------|---------------|\n| Legacy (HW1/HW2) | bit46 | 3 levels (0-2) |\n| HW3 | bit46 | 3 levels (0-2) |\n| HW4 (FSD V14+) | bit46 + bit60, bit47 | 5 levels (0-4) |\n\n\u003e **Firmware warning:** 2026.2.9.x and 2026.8.6 — FSD is **not working on HW4**. Use HW3 mode on these versions even if your car has HW4 hardware. See [Compatibility](#compatibility).\n\n---\n\n## Hardware Requirements\n\n| Component | Description | Price |\n|-----------|-------------|-------|\n| [Flipper Zero](https://flipper.net/) | The multi-tool device | ~$170 |\n| [Electronic Cats CAN Bus Add-On](https://electroniccats.com/store/flipper-addon-canbus/) | MCP2515-based CAN transceiver | ~$30 |\n| OBD-II cable or tap | Connect to Tesla's Party CAN bus | ~$10 |\n\n### Wiring\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/wiring_diagram.png\" alt=\"Wiring Diagram\" width=\"700\"\u003e\n\u003c/p\u003e\n\n\u003e **Termination resistor:** Electronic Cats ships two revisions of this Add-On. v0.1 has the 120 Ω terminator enabled by default and you need to open the `J1 / TERM` solder jumper on the bottom of the board. v0.2+ ships with it already open. To check without opening anything, measure the resistance between the CAN-H and CAN-L screw terminals **before** plugging into the car: ~120 Ω = good (terminator off), ~60 Ω = open the jumper, open circuit = also fine. Full breakdown in [`HARDWARE.md`](HARDWARE.md#termination-resistor--important-detail).\n\nAlternative connection point: **X179 diagnostic connector** in the rear center console (Pin 13 CAN-H, Pin 14 CAN-L on 20-pin; Pin 18/19 on 26-pin).\n\n### Other supported hardware\n\nDon't have or don't want a Flipper Zero? An ESP32 port (PR [#6](https://github.com/hypery11/flipper-tesla-fsd/pull/6)) brings the total cost down to **~$14 / ¥100** with a built-in WiFi web dashboard. Generic MCP2515 modules from Aliexpress also work with the Flipper Zero if you wire them by hand. See [`HARDWARE.md`](HARDWARE.md) for the full comparison + pin maps.\n\n---\n\n## Installation\n\n### Option 1: Download Pre-built FAP\n\n1. Go to [Releases](https://github.com/hypery11/flipper-tesla-fsd/releases)\n2. Download `tesla_fsd.fap`\n3. Copy to your Flipper's SD card: `SD Card/apps/GPIO/tesla_fsd.fap`\n\n### Option 2: Build from Source\n\n```bash\n# Clone the Flipper Zero firmware\ngit clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git\ncd flipperzero-firmware\n\n# Clone this app into the applications_user directory\ngit clone https://github.com/hypery11/flipper-tesla-fsd.git applications_user/tesla_fsd\n\n# Build\n./fbt fap_tesla_fsd\n\n# Flash to Flipper\n./fbt launch app=tesla_fsd\n```\n\n---\n\n## Usage\n\n1. Plug the CAN Add-On into your Flipper Zero\n2. Connect CAN-H/CAN-L to the vehicle's OBD-II port\n3. Open the app: `Apps \u003e GPIO \u003e Tesla FSD`\n4. Select **\"Auto Detect \u0026 Start\"** (or force HW3/HW4)\n5. Wait for detection (up to 8 seconds)\n6. The app starts modifying frames automatically\n\n### Screen Display\n\n```\n  Tesla FSD Active\n  HW: HW4    Profile: 4/4\n  FSD: ON    Nag: OFF\n  Frames modified: 12345\n       [BACK] to stop\n```\n\n### Activation Trigger\n\nFSD activates when **\"Traffic Light and Stop Sign Control\"** is enabled in your vehicle's Autopilot settings. The app watches for this flag in the CAN frame and only modifies frames when it's set.\n\n---\n\n## Compatibility\n\n| Vehicle | HW | Firmware | Mode | Status |\n|---------|----|----------|------|--------|\n| Model 3 / Y (2019-2023) | HW3 | Any | Auto | Supported |\n| Model 3 / Y (2023+) | HW4 | `\u003c 2026.2.3` | Force HW3 | Supported |\n| Model 3 / Y (2023+) | HW4 | `2026.2.3` ↔ `2026.2.8` | Auto | Supported |\n| Model 3 / Y (2023+) | HW4 | `2026.2.9.x` (FSD v14) | Auto | Supported |\n| Model 3 / Y (2023+) | HW4 | `2026.2.10` ↔ `2026.4.x` | Auto | Supported |\n| Model 3 / Y (2023+) | HW4 | `2026.8.6` | **Force HW3** | Use HW3 mode (HW4 path broken on this build) |\n| Model 3 Highland (2024+) | HW4 | `2026.2.x` | Auto | Reported working — needs more confirmations |\n| Model 3 / Y (China, MIC) | HW3 / HW4 | `2026.2.11` | Auto + Force FSD | Reported working — see issues #1, #4, #7 |\n| Model S / X (2021+) | HW4 | `\u003e= 2026.2.3` (excl. 2026.8.6) | Auto | Supported |\n| Model S / X (2016-2019) | HW1 / HW2 | Any | Legacy | Implemented in v2.0, **needs on-car confirmation** |\n\n### Tested by community\n\nReports from real cars (file your own via the [Car compatibility report](https://github.com/hypery11/flipper-tesla-fsd/issues/new?template=car_compatibility.yml) issue template):\n\n| Reporter | Car | HW | Firmware | Region | Mode | Result |\n|----------|-----|----|----------|--------|------|--------|\n| @vbarrier | Model 3 | HW4 | 2026.4.x | EU | Auto | Working |\n| @kwangseok73-sudo | Model 3 | HW4 | 2026.2.x | KR | Force FSD | Working |\n| @andreiboestean | Model 3 | HW4 | 2026.2.9.3 (FSD v14) | EU | Auto | Working |\n| Marow | Model Y Juniper | HW4 | 2026.8.6 | EU | (Force HW3 not yet tested) | \"Region not available\" → use Force FSD + Force HW3 |\n\nIf your car is listed and you've tested, please leave a thumbs-up on the relevant issue so we can confirm.\n\n### HW1/HW2 Legacy Support — Volunteers Needed\n\nOlder Model S/X vehicles (2016-2019) use a Mobileye-based architecture with different CAN IDs. The autopilot control frame is on `0x3EE` (1006) instead of `0x3FD` (1021), and the bit layout differs.\n\nThe logic is documented in the [Karolynaz/waymo-fsd-can-mod](https://github.com/Karolynaz/waymo-fsd-can-mod) CanFeather mirror (the original `Starmixcraft/tesla-fsd-can-mod` GitLab upstream has since been removed). We need someone with a HW1/HW2 car to validate it before we ship.\n\n**If you have a 2016-2019 Model S/X with FSD and want to help:**\n\n1. Hook up Flipper + CAN Add-On to OBD-II\n2. Open the stock CAN sniffer app\n3. Confirm CAN ID `0x3EE` (1006) appears on the bus\n4. Capture a few frames and post them in [issue #1](https://github.com/hypery11/flipper-tesla-fsd/issues/1)\n\nOnce verified, Legacy support is a quick add.\n\n---\n\n## How It Works\n\nSingle-bus read-modify-retransmit on Party CAN (Bus 0). No MITM, no second bus tap.\n\n1. ECU sends `UI_autopilotControl` (`0x3FD`) on Bus 0\n2. Flipper catches it, flips the FSD enable bits\n3. Flipper retransmits — receiver uses the latest frame\n\n### CAN IDs Used\n\n| CAN ID | Name | Role |\n|--------|------|------|\n| `0x398` | `GTW_carConfig` | HW detection (`GTW_dasHw` byte0 bit6-7) |\n| `0x3F8` | Follow Distance | Speed profile (byte5 bit5-7) |\n| `0x3FD` | `UI_autopilotControl` | FSD unlock target (mux 0/1/2) |\n\n---\n\n## FAQ\n\n**Does FSD stay unlocked after I unplug?**\nNo. It's real-time frame modification. Unplug = back to stock.\n\n**Can this brick my car?**\nOnly UI config frames are touched. No writes to brakes, steering, or powertrain. Still — your car, your risk.\n\n**Do I need the CAN Add-On?**\nYes. Flipper has no built-in CAN. You need the Electronic Cats board or any MCP2515-based module on the GPIO header.\n\n---\n\n## Related projects\n\n| Project | What it is | Hardware |\n|---------|------------|----------|\n| [ev-open-can-tools/ev-open-can-tools](https://github.com/ev-open-can-tools/ev-open-can-tools) | The upstream project, now on GitHub as a vehicle-agnostic CAN mod toolkit. Formerly `Tesla-OPEN-CAN-MOD` on GitLab (taken down) → `slxslx/tesla-open-can-mod-slx-repo` (archiving) → now here. | Adafruit RP2040 CAN, Feather M4, ESP32, M5Stack ATOMIC CAN |\n| ESP32 port — PR [#6](https://github.com/hypery11/flipper-tesla-fsd/pull/6) by @elonleo | Full ESP32 port of this project's CAN logic with a built-in WiFi web dashboard. ~$14 alternative to Flipper Zero + Add-On. | M5Stack ATOM Lite + ATOMIC CAN, Waveshare ESP32-S3-RS485-CAN |\n| [tumik/S3XY-candump](https://github.com/tumik/S3XY-candump) | Python tool to dump Tesla CAN bus over WiFi using an enhauto S3XY Commander as a Panda-protocol bridge | Commander dongle |\n| [dzid26/ESP32-DualCAN](https://github.com/dzid26/ESP32-DualCAN) | \"Dorky Commander\" — open-source hardware alternative to the enhauto S3XY Commander | ESP32 + dual CAN |\n| [Karolynaz/waymo-fsd-can-mod](https://github.com/Karolynaz/waymo-fsd-can-mod) | Mirror of the original `Starmixcraft/tesla-fsd-can-mod` CanFeather research — the source we ported from. The original GitLab upstream was taken down; this is the currently-reachable copy. | Adafruit Feather M4 CAN |\n| [tuncasoftbildik/tesla-can-mod](https://github.com/tuncasoftbildik/tesla-can-mod) | Arduino reference implementation with working frame templates for several non-FSD features | Arduino + MCP2515 |\n\n## Credits\n\n- [commaai/opendbc](https://github.com/commaai/opendbc) — Tesla CAN signal database\n- [ElectronicCats/flipper-MCP2515-CANBUS](https://github.com/ElectronicCats/flipper-MCP2515-CANBUS) — MCP2515 driver for Flipper\n- `Starmixcraft/tesla-fsd-can-mod` — original CanFeather FSD research (the GitLab repo has since been removed; mirror at [Karolynaz/waymo-fsd-can-mod](https://github.com/Karolynaz/waymo-fsd-can-mod))\n- mikegapinski/tesla-can-explorer — 40k Tesla CAN signal dictionary extracted from `libQtCarVAPI.so`\n- talas9/tesla_can_signals — per-model wire format reference\n\n## License\n\nGPL-3.0\n\n## Disclaimer\n\nEducational and research use only. **FSD is a premium Tesla feature and must be properly purchased or subscribed to.** Modifying vehicle systems may void your warranty and may violate local laws. You are solely responsible for what you do with this. Full safety and responsible-use notes in [`SECURITY.md`](SECURITY.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypery11%2Fflipper-tesla-fsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypery11%2Fflipper-tesla-fsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypery11%2Fflipper-tesla-fsd/lists"}