tesla_api 3.0.7 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91569b9fd79eae85eb5d719cace95d97c7b52b553af21650fbe0dcc54bfb0587
-  data.tar.gz: b4f045ab6be58dd83aea509685168ec9a9d6acbf23971d86602bf2febbb007d9
+  metadata.gz: 5b774bab2f43b76262fa9c4ab04ae250f9f325955f028d3c8bd44416f5a015f5
+  data.tar.gz: 157c7c913712cd7bc3e7412aead4225c5502b26399f7dcf2243a3f522c72cec9
 SHA512:
-  metadata.gz: 273c9639d6ab5976b544e689dba5884d1449b93d1edd9c15125db5ae43f3a45df14c22333de78cc3cd34b577bff5519345a0b01ad8a4da50d77324ba7c520c10
-  data.tar.gz: b706b047d6f1137956c16d6a58cd4c7627b21a4fa5bf9c45148b84ac45e0caa03d18f0885e538dd5b491d67d4b6d7d3e3110fb0139322f9843c265b3079bd89d
+  metadata.gz: 1354ad7bf60037cf9e09541d7122aed4448946262177e0c6a535f303fde5e5a479f15b2bda193102e305ec2f0743e9d4499aff27cbc2a452add543d64ee1157c
+  data.tar.gz: 980f1b1d752b674ab29ab82982c4ff687f3f22b62dc0c1d5aa138ef5fdd458393a7cea7177f67ae15ae64635154cd45eb7b70cf1bab12affa2c33ad9e622b32e

data/.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    name: Test Suite
+    runs-on: ubuntu-latest
+
+    env:
+      TESLA_EMAIL: elon.musk@teslamotors.com
+      TESLA_PASS: oilLOL
+      TESLA_CLIENT_ID: 1
+      TESLA_CLIENT_SECRET: 2
+      TESLA_ACCESS_TOKEN: 3
+      TESLA_REFRESH_TOKEN: 4
+
+    strategy:
+      matrix:
+        ruby-version: ['2.7', '3.0']
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run test suite
+        run: bundle exec rake

data/docs/api-basics/authentication.md

@@ -4,9 +4,129 @@ description: The authentication process for the Tesla API
 
 # Authentication
 
-## POST `/oauth/token?grant_type=password`
+> ## ⚠ This is a work in progress ⚠
+>
+> Tesla has deprecated the `/oauth/token` endpoint in favor of using `auth.tesla.com`. I'm working on updating the documentation as soon as possible. This documentation is still missing handling for MFA users. Feel free to discuss this in [issue #260](https://github.com/timdorr/tesla-api/issues/260).
 
-The initial authentication process is via [an OAuth 2.0 Password Grant](https://oauth.net/2/grant-types/password/) with the same credentials used for tesla.com and the mobile apps.
+Tesla uses a separate SSO service (auth.tesla.com) for authentication across their app and website. This service is designed around a browser-based flow using OAuth 2.0, but also appears to have support for Open ID Connect. This supports both obtaining an access token and refreshing it as it expires.
+
+## Logging in
+
+### Step 1: Obtain the login page
+
+Subsequent requests to the SSO service will require a "code challenge" and "code verifier". These are just a random 86-character string and its SHA-256 hash. Both must be encoded in base64 with url-safe encoding (base64url). Here is an example of generating them in Ruby, but you can apply this same process to other languages.
+
+```ruby
+code_verifier = random_string(86)
+code_challenge = Base64.urlsafe_encode64(Digest::SHA256.hexdigest(code_verifier))
+code_verifier = Base64.urlsafe_encode64(code_verifier)
+```
+
+You will also need a stable `state` value for requests, which is a random string of any length.
+
+#### GET `https://auth.tesla.com/oauth2/v3/authorize`
+
+The first request returns HTML intended for display in the browser. You will need to parse this HTML for hidden input fields.
+
+The request is made with a `redirect_url` of "https://auth.tesla.com/void/callback", which is a non-existent page. The Tesla app intercepts the request to this page to capture the authorization code.
+
+##### Request parameters
+
+| Field                   | Type             | Example                                | Description                                                     |
+| :---------------------- | :--------------- | :------------------------------------- | :-------------------------------------------------------------- |
+| `client_id`             | String, required | `ownerapi`                             | The OAuth client ID. Always "ownerapi"                          |
+| `code_challenge`        | String, required | `123`                                  | The "code challenge"                                            |
+| `code_challenge_method` | String, required | `S256`                                 | The code challenge hash method. Always "S256" (SHA-256)         |
+| `redirect_uri`          | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "https://auth.tesla.com/void/callback" |
+| `response_type`         | String, required | `code`                                 | The type of expected response. Always "code"                    |
+| `scope`                 | String, required | `openid email offline_access`          | The authentication scope. Always "openid email offline_access"  |
+| `state`                 | String, required | `123`                                  | The OAuth state value. Any random string.                       |
+
+##### Response
+
+This returns an HTML response body. There will be a `<form>` with hidden `<input>` elements that contain session-based information to prevent CSRF attacks. At the moment, they appear to be `_csrf`, `_phase`, `_process`, `transaction_id`, and `cancel`, but they may change due to server-side changes by Tesla. These must be provided in the POST body to validate the following request.
+
+The response will also include a `set-cookie` header that includes a session ID cookie. This should be provided to the following request as a `Cookie` header so that the SSO service can match up your request with private data it has in that session.
+
+### Step 2: Obtain an authorization code
+
+This will simulate a user submitting the form from the previous request in their browser. Ensure that the hidden `<input>`s are provided as POST body parameters and the `Cookie` header is set.
+
+#### POST `https://auth.tesla.com/oauth2/v3/authorize`
+
+```http
+Cookie: {cookie value from set-cookie header}
+```
+
+##### Request parameters
+
+> Note: These are query parameters, not part of the POST body
+
+| Field                   | Type             | Example                                | Description                                                     |
+| :---------------------- | :--------------- | :------------------------------------- | :-------------------------------------------------------------- |
+| `client_id`             | String, required | `ownerapi`                             | The OAuth client ID. Always "ownerapi"                          |
+| `code_challenge`        | String, required | `123`                                  | The "code challenge"                                            |
+| `code_challenge_method` | String, required | `S256`                                 | The code challenge hash method. Always "S256" (SHA-256)         |
+| `redirect_uri`          | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "https://auth.tesla.com/void/callback" |
+| `response_type`         | String, required | `code`                                 | The type of expected response. Always "code"                    |
+| `scope`                 | String, required | `openid email offline_access`          | The authentication scope. Always "openid email offline_access"  |
+| `state`                 | String, required | `123`                                  | The OAuth state value. Any random string.                       |
+
+> Note: This is the contents of the POST body. These should be form encoded (`application/x-www-form-urlencoded`).
+
+| Field              | Type               | Example             | Description                                       |
+| :----------------- | :----------------- | :------------------ | :------------------------------------------------ |
+| hidden input names | String[], required | hidden input values | The fields from the HTML's hidden `<input>`s      |
+| `identity`         | String, required   | `elon@tesla.com`    | The email for the authenticating Tesla account    |
+| `credential`       | String, required   | `brbgoingtomars`    | The password for the authenticating Tesla account |
+
+##### Response
+
+This will respond with a 302 HTTP response code, which will attempt to redirect to the redirect_uri with additional query parameters added. This new URL is located in the `location` header. You should not follow it, as it is non-existent. Instead, you should parse this URL and extract the `code` query parameter, which is your authorization code.
+
+### Step 3: Exchange authorization code for bearer token
+
+#### POST `https://auth.tesla.com/oauth2/v3/token`
+
+This is a standard [OAuth 2.0 Authorization Code exchange](https://oauth.net/2/grant-types/authorization-code/). This endpoint uses JSON for the request and response bodies.
+
+##### Request parameters
+
+| Field           | Type             | Example                                | Description                                                     |
+| :-------------- | :--------------- | :------------------------------------- | :-------------------------------------------------------------- |
+| `grant_type`    | String, required | `authorization_code`                   | TThe type of OAuth grant. Always "authorization_code"           |
+| `client_id`     | String, required | `ownerapi`                             | The OAuth client ID. Always "ownerapi"                          |
+| `code`          | String, required | `123`                                  | The authorization code from the last request.                   |
+| `code_verifier` | String, required | `123`                                  | The code verifier string generated previously.                  |
+| `redirect_uri`  | String, required | `https://auth.tesla.com/void/callback` | The redirect URL. Always "https://auth.tesla.com/void/callback" |
+
+```json
+{
+  "grant_type": "authorization_code",
+  "client_id": "ownerapi",
+  "code": "123",
+  "code_verifier": "123",
+  "redirect_uri": "https://auth.tesla.com/void/callback"
+}
+```
+
+##### Response
+
+```json
+{
+  "access_token": "eyJaccess",
+  "refresh_token": "eyJrefresh",
+  "expires_in": 300,
+  "state": "of the union",
+  "token_type": "Bearer"
+}
+```
+
+### Step 4: Exchange bearer token for access token
+
+#### POST `https://owner-api.teslamotors.com/oauth/token`
+
+This endpoint follows [RFC 7523](https://tools.ietf.org/html/rfc7523) to exchange a JWT access token from the SSO service for an access token usable by the Owner API.
 
 The current client ID and secret are [available here](https://pastebin.com/pS7Z6yyP).
 
@@ -18,29 +138,30 @@ Authorization: Bearer {access_token}
 
 The access token has a 45 day expiration.
 
-### Request parameters
+##### Request parameters
 
-| Field           | Type             | Example                | Description                                       |
-| :-------------- | :--------------- | :--------------------- | :------------------------------------------------ |
-| `grant_type`    | String, required | `password`             | The type of OAuth grant. Always "password"        |
-| `client_id`     | String, required | `abc`                  | The OAuth client ID                               |
-| `client_secret` | String, required | `123`                  | The OAuth client secret                           |
-| `email`         | String, required | `elon@teslamotors.com` | The email for the authenticating Tesla account    |
-| `password`      | String, required | `edisonsux`            | The password for the authenticating Tesla account |
+> Important: Ensure you are using the `access_token` from the SSO service here. The returned access_token is for all other requests to the Owner API.
 
-### Request
+```http
+Authorization: Bearer {access_token}
+```
+
+| Field           | Type             | Example                                       | Description                                                                   |
+| :-------------- | :--------------- | :-------------------------------------------- | :---------------------------------------------------------------------------- |
+| `grant_type`    | String, required | `urn:ietf:params:oauth:grant-type:jwt-bearer` | The type of OAuth grant. Always "urn:ietf:params:oauth:grant-type:jwt-bearer" |
+| `client_id`     | String, required | `abc`                                         | The OAuth client ID                                                           |
+| `client_secret` | String, required | `123`                                         | The OAuth client secret                                                       |
+
+##### Request
 
 ```json
 {
-  "grant_type": "password",
+  "grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
   "client_id": "abc",
-  "client_secret": "123",
-  "email": "elon@teslamotors.com",
-  "password": "edisonsux"
-}
+  "client_secret": "123"
 ```
 
-### Response
+##### Response
 
 ```json
 {
@@ -52,38 +173,44 @@ The access token has a 45 day expiration.
 }
 ```
 
-## POST `/oauth/token?grant_type=refresh_token`
+## Refreshing an access token
+
+#### POST `https://auth.tesla.com/oauth2/v3/token`
 
-You can use the `refresh_token` from the Password Grant to do [an OAuth 2.0 Refresh Token Grant](https://oauth.net/2/grant-types/refresh-token/) and obtain a new access token. Note: This will invalidate the previous access token.
+This uses the SSO `refresh_token` from Step 3 above to do an [OAuth 2.0 Refresh Token Grant](https://oauth.net/2/grant-types/refresh-token/). _This does not work with the `refresh_token` provided by the Owner API._ Those have no use currently and should be discarded.
 
-### Request parameters
+This refreshed access token can be used with the Owner API to obtain a new access token for that service using the exact same request as Step 4 above.
 
-| Field           | Type             | Example         | Description                                               |
-| :-------------- | :--------------- | :-------------- | :-------------------------------------------------------- |
-| `grant_type`    | String, required | `refresh_token` | The type of OAuth grant. Always "refresh_token"           |
-| `client_id`     | String, required | `abc`           | The OAuth client ID                                       |
-| `client_secret` | String, required | `123`           | The OAuth client secret                                   |
-| `refresh_token` | String, required | `cba321`        | The refresh token returned from a previous token request. |
+This endpoint uses JSON for the request and response bodies.
 
-### Request
+##### Request parameters
+
+| Field           | Type             | Example                       | Description                                                    |
+| :-------------- | :--------------- | :---------------------------- | :------------------------------------------------------------- |
+| `grant_type`    | String, required | `refresh_token`               | TThe type of OAuth grant. Always "refresh_token"               |
+| `client_id`     | String, required | `ownerapi`                    | The OAuth client ID. Always "ownerapi"                         |
+| `client_secret` | String, required | `123`                         | The OAuth client ID.                                           |
+| `refresh_token` | String, required | `123`                         | The refresh token from a prior authentication.                 |
+| `scope`         | String, required | `openid email offline_access` | The authentication scope. Always "openid email offline_access" |
 
 ```json
 {
-  "grant_type": "refresh_token",
-  "client_id": "abc",
+  "grant_type": "authorization_code",
+  "client_id": "ownerapi",
   "client_secret": "123",
-  "refresh_token": "cba321"
+  "refresh_token": "eyJrefresh",
+  "scope": "openid email offline_access"
 }
 ```
 
-### Response
+##### Response
 
 ```json
 {
-  "access_token": "abc123",
-  "token_type": "bearer",
-  "expires_in": 3888000,
-  "refresh_token": "cba321",
-  "created_at": 1538359034
+  "access_token": "eyJaccess",
+  "refresh_token": "eyJrefresh",
+  "id_token": "id",
+  "expires_in": 300,
+  "token_type": "Bearer"
 }
 ```

data/docs/vehicle/optioncodes.md

@@ -24,6 +24,7 @@ return a generic set of codes related to a Model 3.
 | RENA | Region: North America | | 
 | RENC | Region: Canada | | 
 | REEU | Region: Europe | | 
+| ACL1 | Ludicrous Mode | Model X | 
 | AD02 | NEMA 14-50 | | 
 | AD04 | European 3-Phase | | 
 | AD05 | European 3-Phase, IT | | 
@@ -68,7 +69,7 @@ return a generic set of codes related to a Model 3.
 | BG32 | Performance AWD Badge | Model 3 |
 | BP00 | No Ludicrous | | 
 | BP01 | Ludicrous Speed Upgrade | | 
-| BP02 | Non-Performance Uncorked Acceleration | | 
+| BP02 | Uncorked Acceleration | Non-Performance  | 
 | BR00 | No Battery Firmware Limit | | 
 | BR03 | Battery Firmware Limit (60kWh) | | 
 | BR05 | Battery Firmware Limit (75kWh) | | 
@@ -86,6 +87,7 @@ return a generic set of codes related to a Model 3.
 | BTX8 | 85 kWh | | 
 | CC01 | Five Seat Interior | |
 | CC02 | Six Seat Interior | |
+| CC03 | Seven Seat Interior | | 
 | CC04 | Seven Seat Interior | | 
 | CC12 | Six Seat Interior with Center Console | |
 | CDM0 | No CHAdeMO Charging Adaptor | | 
@@ -109,7 +111,7 @@ return a generic set of codes related to a Model 3.
 | CPF0 | Standard Connectivity | |
 | CPF1 | Premium Connectivity | |
 | CPW1 | 20" Performance Wheels | |
-| CW00 | Weather Package | No Cold Weather Package | 
+| CW00 | No Weather Package | No Cold Weather Package | 
 | CW02 | Weather Package | Subzero Weather Package | 
 | DA00 | No Autopilot | | 
 | DA01 | Active Safety (ACC,LDW,SA) | Drivers Assistance Package | 
@@ -129,9 +131,10 @@ return a generic set of codes related to a Model 3.
 | FG00 | No Exterior Lighting Package | | 
 | FG01 | Fog Lamps | Exterior Lighting Package | 
 | FG02 | Fog Lamps | Fog Lamps |
-| FG31 | Fog Lamps | Premium Fog Lights (Model 3) |
-| FM3B | Performance Package (Model 3) | |
-| FMP6 | FMP6 | | 
+| FG31 | Fog Lamps | Premium Fog Lights | Model 3
+| FM3B | Performance Package | Model 3 |
+| FM3U | Acceleration Boost | Model 3 Long Range All-Wheel Drive |
+| FMP6 | Performance Firmware | | 
 | FR01 | Base Front Row | | 
 | FR02 | Ventilated Front Seats | |
 | FR03 | FR03 | | 
@@ -140,10 +143,10 @@ return a generic set of codes related to a Model 3.
 | HC00 | No Home Charging installation | | 
 | HC01 | Home Charging Installation | | 
 | HM31 | Teck Package - Homelink | Homelink |
-| HL31 | Head Lamp (Model 3) | Uplevel Headlamps | 
+| HL31 | Head Lamp | Model 3 Uplevel Headlamps | 
 | HP00 | No HPWC Ordered | | 
 | HP01 | HPWC Ordered | | 
-| ID3W | (Model 3) Wood Decor | | 
+| ID3W | Wood Decor | Model 3 | 
 | IDBA | Dark Ash Wood Decor | | 
 | IDBO | Figured Ash Wood Decor | | 
 | IDCF | Carbon Fiber Decor | | 
@@ -154,24 +157,27 @@ return a generic set of codes related to a Model 3.
 | IDLW | Lacewood Decor | | 
 | IDPB | Piano Black Decor | |
 | IN3BB | All Black Partial Premium Interior | | 
+| IN3BW | Black and White Interior | Model 3 Interior | 
 | IN3PB | All Black Premium Interior | Model 3 Interior | 
 | IN3PW | All White Premium Interior | Model 3 Interior | 
-| INBBW | White | | 
-| INBFP | Classic Black | | 
-| INBPP | Black | | 
-| INBPW | White Seats | |
-| INBTB | Multi-Pattern Black | | 
-| INFBP | Black Premium | | 
-| INLPC | Cream | | 
-| INLPP | Black / Light Headliner | | 
+| INBBW | White Interior | | 
+| INB3C | Premium beige interior with oak wood finishes | Model X |
+| INBC3W | Premium black and white interior with Carbon Fiber decor | Model X |
+| INBFP | Classic Black Interior | | 
+| INBPP | Black Interior | | 
+| INBPW | White Seats Interior | |
+| INBTB | Multi-Pattern Black Interior | | 
+| INFBP | Black Premium Interior | | 
+| INLPC | Cream Interior | | 
+| INLPP | Black / Light Headliner Interior  | | 
 | INWPT | Tan Interior | | 
 | INYPB | All Black Premium Interior | |
 | INYPW | Black and White Premium Interior | |
-| IL31 | Interior Ambient Lighting | |
+| IL31 | Interior Ambient Lighting Interior | |
 | IVBPP | All Black Interior | | 
 | IVBSW | Ultra White Interior | | 
 | IVBTB | All Black Interior | | 
-| IVLPC | Vegan Cream | | 
+| IVLPC | Vegan Cream Interior | | 
 | IX00 | No Extended Nappa Leather Trim | | 
 | IX01 | Extended Nappa Leather Trim | | 
 | LLP1 | LLP1 | | 
@@ -193,23 +199,52 @@ return a generic set of codes related to a Model 3.
 | LTPW | Lower Trim PUR White | |
 | ME01 | Memory Seats | |
 | ME02 | Seat Memory | Seat Memory LHD Driver | 
-| MI00 | 2015 Production Refresh | | 
-| MI01 | 2016 Production Refresh | | 
-| MI02 | 2017 Production Refresh | | 
-| MI03 | 201? Production Refresh | Found on Model X ordered 11/2018 delivered 3/2019 | 
+| MI00 | 1st Generation Production| Model 3 (2019), Model S (Nosecone), Model X (2016) | 
+| MI01 | 2nd Generation Production | Model 3 (2020), Model S (2016 Facelit), Model X (2017) | 
+| MI02 | 3rd Generation Production | Model 3 (2021), Model X (2017) | 
+| MI03 | 4th Generation Production | Model S (2018), Model X (2018) |
+| MI04 | 5th Generation Production | Model S (2019/2020), Model X (2020/2021) |
 | MR31 | Tech Package - Mirror -YES	| Uplevel Mirrors |
-| MT300 | Standard Range Rear-Wheel Drive | |
-| MT301 | Standard Range Plus Rear-Wheel Drive | |
-| MT320 | Standard Range Plus Rear-Wheel Drive | Late 2020 Refresh |
-| MT302 | Long Range Rear-Wheel Drive | |
-| MT303 | Long Range All-Wheel Drive | |
-| MT315 | Long Range All-Wheel Drive | Late 2020 Refresh |
-| MT304 | Long Range All-Wheel Drive Performance | |
-| MT317 | Long Range All-Wheel Drive Performance | Late 2020 Refresh |
-| MT305 | Mid Range Rear-Wheel Drive | | 
-| MTY02 | Long Range Rear-Wheel Drive | |
-| MTY03 | Long Range All-Wheel Drive | |
-| MTY04 | Long Range All-Wheel Drive Performance | |
+| MT300 | Standard Range Rear-Wheel Drive | Model 3 |
+| MT301 | Standard Range Plus Rear-Wheel Drive | Model 3 |
+| MT302 | Long Range Rear-Wheel Drive | Model 3 |
+| MT303 | Long Range All-Wheel Drive | Model 3 |
+| MT304 | Long Range All-Wheel Drive Performance | Model 3 |
+| MT305 | Mid Range Rear-Wheel Drive | Model 3 | 
+| MT307 | Mid Range Rear-Wheel Drive | Model 3 | 
+| MT308 | Standard Range Plus Rear-Wheel Drive | Model 3 2019 Refresh |
+| MT309 | Standard Range Plus Rear-Wheel Drive | Model 3 2019 Refresh |
+| MT314 | Standard Range Plus Rear-Wheel Drive | Model 3 2021 Refresh |
+| MT320 | Standard Range Plus Rear-Wheel Drive | Model 3 2021 Refresh |
+| MT336 | Standard Range Plus Rear-Wheel Drive | Model 3 2020 Refresh |
+| MT337 | Standard Range Plus Rear-Wheel Drive | Model 3 2021 Refresh |
+| MT310 | Long Range All-Wheel Drive | Model 3 |
+| MT311 | Long Range All-Wheel Drive Performance | Model 3 |
+| MT315 | Long Range All-Wheel Drive | Model 3 2021 Refresh |
+| MT316 | Long Range All-Wheel Drive | Model 3 2021 Refresh |
+| MT317 | Long Range All-Wheel Drive Performance | Model 3 2021 Refresh |
+| MTS01 | Standard Range | Model S |
+| MTS03 | Long Range | Model S |
+| MTS04 | Performance | Model S |
+| MTS05 | Long Range | Model S |
+| MTS06 | Performance | Model S |
+| MTS07 | Long Range Plus | Model S |
+| MTS08 | Performance | Model S |
+| MTS09 | Plaid+ | Model S Refresh 2021 |
+| MTS10 | Long Range | Model S Refresh 2021 |
+| MTS11 | Plaid | Model S Refresh 2021 |
+| MTX01 | Standard Range | Model X | 
+| MTX03 | Long Range | Model X | 
+| MTX04 | Performance | Model X | 
+| MTX05 | Long Range Plus | Model X | 
+| MTX06 | Performance | Model X | 
+| MTX07 | Long Range Plus | Model X | 
+| MTX08 | Performance | Model X | 
+| MTX10 | Long Range | Model X Refresh 2021 | 
+| MTX11 | Plaid | Model X Refresh 2021 | 
+| MTY02 | Long Range Rear-Wheel Drive | Model Y |
+| MTY03 | Long Range All-Wheel Drive | Model Y |
+| MTY04 | Long Range All-Wheel Drive Performance | Model Y |
 | OSSB | Safety CA Black | |
 | OSSW | Safety CA White | |
 | PA00 | No Paint Armor | | 
@@ -276,13 +311,13 @@ return a generic set of codes related to a Model 3.
 | QXMB | Black Leather Seat | |
 | RCX0 | No Rear Console | | 
 | RCX1 | Rear Console | |
-| RF3G | Model 3 Glass Roof | | 
-| RFBK | Black Roof | | 
-| RFBC | Body Color Roof | Roof | 
-| RFFG | Glass Roof | 2017 Production Refresh | 
-| RFPO | All Glass Panoramic Roof | 2015 Production Refresh | 
-| RFP2 | Sunroof | 2016 Production Refresh | 
-| RFPX | Model X Roof | |
+| RF3G | Glass Roof | Model 3 | 
+| RFBK | Black Roof | Model S | 
+| RFBC | Body Color Roof | Model S | 
+| RFFG | Glass Roof | Model S 2017 Production Refresh | 
+| RFPO | All Glass Panoramic Roof | Model S 2015 Production Refresh | 
+| RFP2 | Sunroof | Model S 2016 Production Refresh | 
+| RFPX | Glass Roof | Model X |
 | RSF1 | Rear Heated Seats | |
 | RU00 | No Range Upgrade | |
 | S01B | Black Textile Seats | |
@@ -316,7 +351,7 @@ return a generic set of codes related to a Model 3.
 | SU00 | Standard Suspension | | 
 | SU01 | Smart Air Suspension | |
 | SU03 | Suspension	Update | Model X 2020 |
-| SU3C | Suspension | Coil spring suspension |
+| SU3C | Coil Spring Suspension |  |
 | T3MA | Tires M3 | 18 Michelin All Season, Square |
 | TIC4 | Tires | All-Season Tires | 
 | TIG2 | Summer Tires | |
@@ -355,7 +390,9 @@ return a generic set of codes related to a Model 3.
 | W38B | 18" Aero Wheels | For the Model 3 and Model Y |
 | W39B | 19" Sport Wheels | | 
 | WR00 | No Wrap | |
+| WS90 | 19" Tempest Wheels | Model S Refresh 2021 |
 | WT19 | 19" Wheels | |
+| WS10 | 21" Arachnid Wheels | Model S Refresh 2021 |
 | WT20 | 20" Silver Slipstream Wheels | | 
 | WT22 | 22" Silver Turbine Wheels | |
 | WTAB | 21" Black Arachnid Wheels | |
@@ -365,6 +402,7 @@ return a generic set of codes related to a Model 3.
 | WTNS | 20" Nokian Winter Tires (studded) | |
 | WTP2 | 20" Pirelli Winter Tires | |
 | WTSC | 20" Sonic Carbon Wheels | |
+| WTSD | 20" Two-Tone Slipstream Wheels | |
 | WTSG | 21" Turbine Wheels | | 
 | WTSP | 21" Turbine Wheels | | 
 | WTSS | 21" Turbine Wheels | | 
@@ -381,6 +419,8 @@ return a generic set of codes related to a Model 3.
 | WTW7 | 19" Nokian Winter Tires (non-studded) | |
 | WTW8 | 19" Pirelli Winter Tires | |
 | WTX1 | 19" Michelin Primacy Tire Upgrade | | 
+| WX00 | 20" Cyberstream Wheels | Model X Refresh 2021 |
+| WX20 | 22" Turbine Wheels | Model X Refresh 2021 |
 | WXNN | No 20" Nokian Winter Tires (non-studded) | |
 | WXNS | No 20" Nokian Winter Tires (studded) | |
 | WXP2 | No 20" Pirelli Winter Tires | |
@@ -408,7 +448,7 @@ return a generic set of codes related to a Model 3.
 | X020 | No Performance Exterior | | 
 | X021 | No Rear Carbon Fiber Spoiler | |
 | X024 | Performance Package | | 
-| X025 | Performance Powertrain | | 
+| X025 | No Performance Powertrain | | 
 | X026 | Door handle | No light handle |
 | X027 | Lighted Door Handles | Light handle | 
 | X028 | Battery Badge | Normal Badging |