Skip to content

Commit d04d23e

Browse files
committed
C4 beta support
1 parent f6b9630 commit d04d23e

1 file changed

Lines changed: 25 additions & 30 deletions

File tree

README.md

Lines changed: 25 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -262,22 +262,11 @@ If your car is not listed above, then there has been no documented information o
262262
# Setup Guide
263263

264264
> [!WARNING]
265-
> **This guide has not been updated or tested for the comma four.**
265+
> **comma four (C4) support is in beta.**
266266
>
267-
> The [comma four](https://comma.ai/shop/comma-four) is a new device released on November 8, 2025. Community contributors do not yet have access to it for testing and development.
268-
>
269-
> **Known issues and limitations:**
270-
> * **SSH instructions** - [Works, but there's a reason to use TSK Manager instead. You like GUIs don't you?](https://community.sunnypilot.ai/t/toyota-2021-rav4-prime-w-c4-working/1776)
271-
> * **GUI tools** - Need to be adjusted for the new UI and form factor. calvinspark has a TSKM build but it'll be on calvinspark to update this doc when he feels he is ready.
272-
> * **Fork support** - Popular forks such as sunnypilot and frogpilot do not yet support the comma four and it may take some time for them to merge in comma four support
273-
> * frogpilot: Their maintainer and codebase has drifted away from comma.ai's mainline openpilot significantly and has not kept up. Their maintainer has expressed no plans to add comma four support.
274-
> * sunnypilot: Their codebase keeps up with comma.ai's mainline openpilot more closely, so sunnypilot support has come a lot sooner, abeit a lot of work is still needed.
275-
> * **For comma four sunnypilot updates:** Visit the [sunnypilot community forum](https://community.sunnypilot.ai/t/regarding-comma-4-support-on-sunnypilot/870) for the latest information on comma four support.
276-
> * Recommended Branches: https://community.sunnypilot.ai/t/recommended-branch-installations/235
277-
> * **Official support** - The `nightly-dev` branch from comma.ai will likely work, but it has not yet been released or tested.
278-
>
279-
> **Please be patient.** Developing and testing support for new hardware takes considerable time and resources. New users with the comma four with a low pain tolerance should wait for official announcements before attempting to use this guide. On the other hand, if you are a new user with the comma four and have a high technical pain tolerance, please consult [comma Discord](https://discord.comma.ai)'s #toyota-security channel.
267+
> Several people reported success, but Calvin hasn't received his C4 yet, so there are no photos or an official seal of quality.
280268
>
269+
> ETA 2026-01
281270
282271

283272
* [Key Extraction](#key-extraction) if you don't know the key.
@@ -290,11 +279,13 @@ Follow this guide to run a [hardware exploit](https://icanhack.nl/blog/secoc-key
290279

291280
### Step 1. Install `TSK Manager`
292281

293-
At home, sitting next to your router, turn on C3X with your phone charger. Ignore the low voltage warning.
282+
At home, sitting next to your router, turn on Comma with a phone charger. Ignore the low voltage warning.
294283

295-
Choose `Custom Software` and enter the URL `optskug/tskm`
284+
Choose `Custom Software` and enter the URL:
296285

297-
If you have C3 (predecessor to C3X), enter `https://smiskol.com/fork/optskug/tskm-c3`
286+
* C4: `calvinpark/tskm-c4`
287+
* C3X: `optskug/tskm`
288+
* C3: `https://smiskol.com/fork/optskug/tskm-c3`
298289

299290
![](img/v4.install.1.jpg)
300291

@@ -310,23 +301,23 @@ Unplug the power to turn off the device.
310301
1. Sometimes the installer won't proceed or gets stuck around 10% and restarts. Instead of Custom Software, install comma openpilot, uninstall it through the Settings menu, and then try again.
311302
1. The installation takes about 2 minutes, or ~20 minutes if an OS update is needed. OS update downloads a ton of stuff so don't be too far away from the router.
312303
1. Prefetching may fail if you're in China. The extraction will still work, but you'll have to install `commaai/nightly-dev` manually instead of using TSK Manager.
313-
1. In some cases the installation gets stuck in "registering device" screen. If this happens, unplug the device to power off, plug it back in, and then tap-tap-tap on the screen as it boots to reset the device. Afterward, install `optskug/tskm`
304+
1. In some cases the installation gets stuck in "registering device" screen. If this happens, unplug the device to power off, plug it back in, and then tap-tap-tap on the screen as it boots to reset the device. Afterward, install using the URL for your device.
314305
</details>
315306

316307
### Step 2. Install the hardware
317308

318309
Go to your car and connect everything including Comma Power (OBD2 connector + long cable).
319310

320-
Official Setup Guide: https://comma.ai/setup/comma-3x
311+
Official Setup Guide: https://comma.ai/setup
321312

322-
Turn the car on and off - C3X should remain powered on.
313+
Turn the car on and off - Comma should remain powered on.
323314

324315
![](img/v3.tsk-manager.incar.jpg)
325316

326317
<details><summary>Troubleshooting</summary>
327318

328-
1. The car harness sends a 12V signal instead of the usual 5V. Do not plug in anything other than C3X.
329-
2. For connecting C3X to the harness, always use the right-angled OBD-C cable that came with the C3X. comma.ai sells it if you need more: https://comma.ai/shop/obd-c-cable. If you must buy your own, USB-C 3.1 Gen 2 is required.
319+
1. The car harness sends a 12V signal instead of the usual 5V. Do not plug in anything other than Comma.
320+
2. For connecting Comma to the harness, always use the official OBD-C cable that came with Comma. comma.ai sells it if you need more: https://comma.ai/shop/obd-c-cable. If you must buy your own, USB-C 3.1 Gen 2 is required.
330321
3. You can remove Comma Power later but connect it for now.
331322
</details>
332323

@@ -388,11 +379,15 @@ Sometimes `TSK Extractor` can't talk to the car. Try again.
388379

389380
Start your car's engine.
390381

391-
Go to the `Reboot Menu` and `Install commaai/nightly-dev`.
382+
Go to the `Reboot Menu`.
383+
384+
* C4: `Install commaai/nightly-dev`
385+
* C3X: `Install commaai/nightly-dev`
386+
* C3: `Install sunnypilot/staging-tici`
392387

393388
`commaai/nightly-dev` is the only branch from comma.ai with TSK support (C3X only).
394389

395-
If you have C3, install `sunnypilot/staging-tici`. There are no branches from comma.ai with C3+TSK support, so SunnyPilot is your best option. If you have no idea what this means, come talk to us in [comma Discord](https://discord.comma.ai) at #toyota-security channel.
390+
For C3, there are no branches from comma.ai with C3+TSK support, so SunnyPilot is your best option. If you have no idea what this means, come talk to us in [comma Discord](https://discord.comma.ai) at #toyota-security channel.
396391

397392
![](img/v4.reboot.jpg)
398393

@@ -405,31 +400,31 @@ If you have C3, install `sunnypilot/staging-tici`. There are no branches from co
405400

406401
### Step 6. Calibrate & Validate
407402

408-
C3X should show the 15mph calibration screen.
403+
Comma should show the 15mph calibration screen.
409404

410405
![](img/v3.calibrate.jpg)
411406

412407
If you're able to calibrate and use openpilot to use the steering wheel (aka "lat support"), it's working!
413408

414-
`commaai/nightly-dev` can't use the gas and brake pedals (aka "long support") on TSK vehicles. The [pull request for longitudinal support has been merged into `opendbc`](https://github.com/commaai/opendbc/pull/1385), but openpilot has not yet updated its copy of the repository to include it. Experimental mode is also not supported because experimental mode requires long support.
409+
`commaai/nightly-dev` can use both the gas and brake pedals (aka "long support") and also the steering wheel (aka "lat support") on TSK vehicles. In other words, it can do all the normal things that an openpilot can do including Experimental Mode.
415410

416411
<details><summary>Troubleshooting</summary>
417412

418413
1. If you get an `LKAS` error, either the key was not installed or you're running a fork/branch without TSK support.
419-
2. If C3x says `Car unrecognized` or `Dashcam mode for unsupported car`, you need to do [Fingerprinting](https://github.com/optskug/docs/blob/19c61098eac496ded2fb1cacb732be6671c38c69/README.md#step-5-fingerprinting-if-the-car-is-not-recognized). However, this shouldn't happen anymore. If it does, please talk to us in #toyota-security.
414+
2. If Comma says `Car unrecognized` or `Dashcam mode for unsupported car`, you need to do [Fingerprinting](https://github.com/optskug/docs/blob/19c61098eac496ded2fb1cacb732be6671c38c69/README.md#step-5-fingerprinting-if-the-car-is-not-recognized). However, this shouldn't happen anymore. If it does, please talk to us in #toyota-security.
420415
3. The key will change if you get a new bumper because the bumper has distance sensors that use the security key. Instead of applying the existing key to the bumper, they replace the key on all parts of the car. The same goes for many other parts with SecOC components. Even if you never get into an accident, the key can still change if a Toyota service technician presses a wrong button.
421416
</details>
422417

423418
### Step 7. Clean up
424419

425420
Put the covers back on, and you're done. Congratulations!
426421

427-
Comma Power (OBD2 connector + long cable) is optional. It's not necessary for using C3X, but keeping it allows C3X to stay powered on when you turn off the car.
422+
Comma Power (OBD2 connector + long cable) is optional. It's not necessary for using Comma, but keeping it allows Comma to stay powered on when you turn off the car.
428423

429424
<details><summary>Comma Power</summary>
430425

431426
__Pros__
432-
* Don't need to wait for C3X to boot up on a car start.
427+
* Don't need to wait for Comma to boot up on a car start.
433428
* Auto-update to get the latest and greatest.
434429
* Upload logs and videos to [comma connect](https://connect.comma.ai/) automatically. [If you do this, you'll be in the training set and your specific driving will improve faster than others.](https://discord.com/channels/469524606043160576/954493346250887168/1328801037578145802)
435430
* Easier to SSH in to debug.
@@ -441,7 +436,7 @@ __Cons__
441436

442437
I (@calvinspark) don't use it because I hate even a remote possibility of a 12V battery issue.
443438

444-
If you decide not to use it, bring C3X into your home to get updates. Note that an auto-update to v0.10.0 broke C3 users, so check Discord for compatilibity issues before a major version update.
439+
If you decide not to use it, bring Comma into your home to get updates. Note that an auto-update to v0.10.0 broke C3 users, so check Discord for compatibility issues before a major version update.
445440
</details>
446441

447442
### Step 8. What's next?

0 commit comments

Comments
 (0)