Skip to content

Move Key Installation into Advanced Topics #71

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
calvinpark wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Move Key Installation into Advanced Topics #71

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 7 additions & 45 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,7 @@ This is an attempt to document some of the discussion and information about the
* [Unknown](#unknown)
* [Setup Guide](#setup-guide)
* [Key Extraction](#key-extraction)
* [Key Installation](#key-installation)
* [Advanced Topic: Run the exploit using SSH manually](#advanced-topic-run-the-exploit-using-ssh-manually)
* [Advanced Topics](#advanced-topics)
* [Forks](#forks)
* [Discords of Note](#discords-of-note)
* [Current History](#current-history)
Expand Down Expand Up @@ -270,9 +269,6 @@ If your car is not listed above, then there has been no documented information o
> If you are a new user, consider waiting for the official release, ETA 2026-01. Check this page for an update or find us at the [comma Discord](https://discord.comma.ai)'s #toyota-security channel.
>

* [Key Extraction](#key-extraction) if you don't know the key.
* [Key Installation](#key-installation) if you know the key.

## Key Extraction

Your car has a security key that Toyota doesn't want you to have. \
Expand Down Expand Up @@ -460,51 +456,17 @@ Please let us know! We've put in lots of effort into this doc, so even a simple

We're in [comma Discord](https://discord.comma.ai) in #toyota-security channel.

## Key Installation

### You shouldn't need to do this

Modern openpilot and its forks have an [auto-key-install process](https://github.com/commaai/openpilot/pull/34401/files) that runs on every car start.

This means that **uninstalling openpilot or resetting the comma device no longer uninstalls the security key.**

**🎉🎉🎉 Gone are the days of key installation. From now on, just install openpilot and go drive, just like non-TSK users! 🎉🎉🎉**

### When to do this

You may need to still reinstall the key if
1. your C3 died and you got a new C3X,
2. the key was never installed in `/cache/params/SecOCKey` because you did it the old SSH way and never ran `TSK Manager` / `TSK Keyboard`,
3. the installed key in `/cache/params/SecOCKey` was deleted, or
4. you're using an old fork without the auto-key-installer.

Follow this guide to reinstall the key.

### Method 1. Use the built-in `TSK Manager`/`TSK Keyboard`

Some forks/branches have `TSK Manager` or `TSK Keyboard` under Settings.

⚙ > `Device` > `TSK Manager`/`TSK Keyboard`

![](img/v2.settings-keyboard.jpg)

If it's there, use it to type in your key and install, and then reboot.

### Method 2. SSH and install the key to `/cache/params/SecOCKey` and `/data/params/d/SecOCKey` files

Redo [Step 4B-4. Install the security key & Reboot](https://github.com/optskug/docs/blob/19c61098eac496ded2fb1cacb732be6671c38c69/README.md#step-4b-4-install-the-security-key--reboot).

### Method 3. Uninstall openpilot, install the key using `TSK Manager`, and install openpilot
## Advanced Topics

Follow [Step 1. Install TSK Manager](#step-1-install-tsk-manager) to install `TSK Manager` via the URL `optskug/tskm`
### Install a known key

No need to go to the car. Run `TSK Keyboard`. Use it to type in your key and install.
In some cases it's possible to [type in a key that you already know](https://github.com/optskug/docs/blob/f582e47020c0aff210cbdf9d452c0f19e67bcad7/README.md#key-installation). This was made when the key extraction was just getting started.

![](img/v3.tsk-keyboard.jpg)
These days the key extraction is well-established, so re-extracting the key is just as easy as typing it in.

## Advanced Topic: Run the exploit using SSH manually
### Run the exploit using SSH manually

This is how to [extract the key manually](https://github.com/optskug/docs/blob/19c61098eac496ded2fb1cacb732be6671c38c69/README.md#step-4b-run-the-exploit-using-ssh-manually). Most people can skip this.
Is a GUI button too easy for your engineering spirit? Here is how to [extract the key manually](https://github.com/optskug/docs/blob/19c61098eac496ded2fb1cacb732be6671c38c69/README.md#step-4b-run-the-exploit-using-ssh-manually).



Expand Down