mirror of
https://github.com/sunnypilot/sunnypilot.git
synced 2026-08-06 02:25:45 +08:00
cool
This commit is contained in:
Jason Wen
@@ -8,8 +8,8 @@ Configure adaptive cruise control behavior, including intelligent button managem
|
||||
|
||||
**Location**: `Settings -> Cruise`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Configure how sunnypilot responds to detected speed limits from maps, signs, and
|
||||
|
||||
**Location**: `Settings -> Cruise -> Speed Limit`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -6,8 +6,8 @@ title: Speed Limit Source
|
||||
|
||||
**Location**: `Settings -> Cruise -> Speed Limit -> Customize Source`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
Configure which data source sunnypilot uses to determine the current speed limit, and how multiple sources are prioritized.
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Advanced settings for developers and power users, including debug tools, connect
|
||||
|
||||
**Location**: `Settings -> Developer`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-check: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Available and configurable on all devices (comma 3X/3, comma four, sunnylink).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ View device information, manage calibration, configure power behavior, and acces
|
||||
|
||||
**Location**: `Settings -> Device`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-check: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Available and configurable on all devices (comma 3X/3, comma four, sunnylink).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Control screen brightness, timing, and UI behavior for the onroad display.
|
||||
|
||||
**Location**: `Settings -> Display`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Firehose Mode uploads training data from your drives to comma's servers, helping
|
||||
|
||||
**Location**: `Settings -> Firehose`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-check: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Available and configurable on all devices (comma 3X/3, comma four, sunnylink).
|
||||
|
||||
!!! info "First Fork with Official Support"
|
||||
sunnypilot is the first and currently only major fork to receive official Firehose Mode support.
|
||||
|
||||
@@ -7,7 +7,7 @@ title: Settings
|
||||
Complete reference for every configurable option in sunnypilot. The panels below are listed in the same order they appear on your device's settings sidebar.
|
||||
|
||||
!!! info "Not all settings appear on every device"
|
||||
comma four users see a simplified settings screen. See [Platform Differences](platform-differences.md) for details on what is available on each device. All settings can be accessed through sunnylink regardless of hardware.
|
||||
comma four users see a simplified settings screen. Most features still work on comma four -- you just configure the hidden ones through sunnylink. A few onroad visual features are not available on comma four at all. See [Platform Differences](platform-differences.md) for the full breakdown.
|
||||
|
||||
| Panel | Description |
|
||||
|-------|-------------|
|
||||
|
||||
@@ -8,8 +8,8 @@ Select and manage driving models, and configure model-related parameters.
|
||||
|
||||
**Location**: `Settings -> Models`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Manage Wi-Fi connections on your comma device.
|
||||
|
||||
**Location**: `Settings -> Network`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-check: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Available and configurable on all devices (comma 3X/3, comma four, sunnylink).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Download and manage OpenStreetMap (OSM) data used for speed limit lookups, curve
|
||||
|
||||
**Location**: `Settings -> OSM`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -4,25 +4,37 @@ title: Platform Differences
|
||||
|
||||
# Platform Differences
|
||||
|
||||
sunnypilot runs on different hardware platforms, each with its own settings interface. Not every setting is available on every device. This page explains the differences so you know what to expect.
|
||||
sunnypilot runs on different hardware platforms, each with its own settings interface. This page explains the differences so you know what to expect.
|
||||
|
||||
## Supported Platforms
|
||||
## Platforms
|
||||
|
||||
### comma 3X / comma 3 (TIZI/TICI)
|
||||
|
||||
The full-featured interface with a sidebar-based settings panel. All settings documented in this manual are available on these devices, giving you complete control over steering, cruise, visuals, display, models, maps, and vehicle-specific configuration.
|
||||
The full-featured interface with a sidebar-based settings panel. All settings and onroad visual features documented in this manual are available on these devices.
|
||||
|
||||
### comma four (MICI)
|
||||
|
||||
A simplified, touch-friendly interface designed for the comma four's compact form factor. Only essential settings are exposed through large buttons and toggles. Many advanced driving controls (steering tuning, cruise customization, visual overlays, model selection) are not available through this interface.
|
||||
A simplified, touch-friendly interface designed for the comma four's compact form factor. Only a subset of settings are exposed through the on-device screen. Most features still work on comma four -- you configure the hidden ones through sunnylink.
|
||||
|
||||
However, some onroad visual features require UI rendering code that does not exist on comma four. These features cannot be activated on comma four even through sunnylink. Each setting page notes which category it falls into.
|
||||
|
||||
### sunnylink (Web / App)
|
||||
|
||||
The sunnylink web interface shows all available settings regardless of which device you use. If a setting is missing from your comma four's on-device screen, you can still configure it through sunnylink.
|
||||
The sunnylink web interface provides access to all configurable settings regardless of which device you use. If a setting is not shown on your comma four's screen, you can configure it through sunnylink -- provided the feature is supported on your device.
|
||||
|
||||
## Settings Availability by Platform
|
||||
## Three Levels of Device Availability
|
||||
|
||||
The table below shows which settings panels are available on each platform.
|
||||
Throughout this manual, each setting includes a "Toggle & Device Availability" note using one of these three patterns:
|
||||
|
||||
| Level | Badge Text | What It Means |
|
||||
|-------|-----------|---------------|
|
||||
| **Full** | "Available and configurable on all devices (comma 3X/3, comma four, sunnylink)." | The setting appears on every device's screen and in sunnylink. |
|
||||
| **Config-Hidden** | "Supported on all devices. comma four users must use sunnylink to change this setting." | The feature works on comma four, but the toggle is hidden from the device screen. Use sunnylink to configure it. |
|
||||
| **Unsupported** | "Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink." | The feature requires onroad UI rendering code that does not exist on comma four. Forcing the param via sunnylink will not make it work. |
|
||||
|
||||
## On-Screen Settings Availability
|
||||
|
||||
The table below shows which settings panels have on-screen controls on each platform. A :material-close: means the panel is not shown on that device's screen.
|
||||
|
||||
| Panel | comma 3X/3 | comma four | sunnylink |
|
||||
|-------|:----------:|:----------:|:---------:|
|
||||
@@ -42,11 +54,26 @@ The table below shows which settings panels are available on each platform.
|
||||
| [Firehose](firehose.md) | :material-check: | :material-check: (condensed) | :material-check: |
|
||||
| [Developer](developer.md) | :material-check: | :material-check: | :material-check: |
|
||||
|
||||
## Onroad Visual Features Not Available on comma four
|
||||
|
||||
The following features from the [Visuals](visuals.md) panel rely on onroad UI rendering code that only exists on comma 3X/3. These cannot be enabled on comma four:
|
||||
|
||||
- Enable Standstill Timer
|
||||
- Display Road Name
|
||||
- Green Traffic Light Alert (Beta)
|
||||
- Lead Departure Alert (Beta)
|
||||
- Speedometer: Always Display True Speed
|
||||
- Speedometer: Hide from Onroad Screen
|
||||
- Display Turn Signals (always-on display; lane change alert icons still appear)
|
||||
- Real-time Acceleration Bar
|
||||
- Display Metrics Below Chevron
|
||||
- Developer UI (onroad overlay)
|
||||
|
||||
## What This Means for You
|
||||
|
||||
If you use a **comma four**, your on-device settings screen shows a simplified set of controls focused on essential device management and basic feature toggles. For the full range of settings, use **sunnylink** from your browser.
|
||||
If you use a **comma four**, your on-device screen shows a simplified set of controls. Most sunnypilot features still run on your device -- you configure the hidden ones through **sunnylink**. The exception is the onroad visual features listed above, which require rendering code that does not exist on comma four.
|
||||
|
||||
If you use a **comma 3X or comma 3**, all settings are directly accessible from the device sidebar.
|
||||
If you use a **comma 3X or comma 3**, all settings and onroad visual features are directly accessible from the device sidebar.
|
||||
|
||||
!!! tip
|
||||
Throughout this manual, each setting includes a "Supported Devices" note indicating which platforms can access it. Look for these callouts to quickly check if a setting is available on your device.
|
||||
Throughout this manual, each setting includes a "Toggle & Device Availability" note. Look for these callouts to quickly check whether a feature works on your device and where to configure it.
|
||||
|
||||
@@ -8,8 +8,8 @@ Manage software updates, view release notes, and switch branches.
|
||||
|
||||
**Location**: `Settings -> Software`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Configure lateral (steering) control behavior including MADS, lane changes, blin
|
||||
|
||||
**Location**: `Settings -> Steering`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Configure automatic lane change behavior and blind spot monitoring integration.
|
||||
|
||||
**Location**: `Settings -> Steering -> Customize Lane Change`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Fine-tune how the Modular Assistive Driving System (MADS) engages and disengages
|
||||
|
||||
**Location**: `Settings -> Steering -> Customize MADS`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
!!! info "Prerequisite"
|
||||
The main **Modular Assistive Driving System (MADS)** toggle must be enabled in [Steering Settings](index.md) to access this sub-panel.
|
||||
|
||||
@@ -8,8 +8,8 @@ Advanced tuning parameters for torque-based lateral (steering) control. These se
|
||||
|
||||
**Location**: `Settings -> Steering -> Customize Torque Params`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
!!! info "Prerequisite"
|
||||
**Enforce Torque Lateral Control** must be enabled in [Steering Settings](index.md) to access this sub-panel. Not available on vehicles with angle-based steering.
|
||||
|
||||
@@ -8,8 +8,8 @@ Configure the sunnylink cloud integration for secure backup, restore, sponsorshi
|
||||
|
||||
**Location**: `Settings -> sunnylink`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Core driving assist toggles that control fundamental sunnypilot behavior, drivin
|
||||
|
||||
**Location**: `Settings -> Toggles`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-check: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Available and configurable on all devices (comma 3X/3, comma four, sunnylink).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ View your cumulative and recent driving statistics.
|
||||
|
||||
**Location**: `Settings -> Trips`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Settings specific to Hyundai, Kia, and Genesis vehicles. These appear in the Veh
|
||||
|
||||
**Location**: `Settings -> Vehicle`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ View and manage vehicle-specific settings. The content of this panel changes bas
|
||||
|
||||
**Location**: `Settings -> Vehicle`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Settings specific to Subaru vehicles. These appear in the Vehicle panel when a S
|
||||
|
||||
**Location**: `Settings -> Vehicle`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Settings specific to Tesla vehicles. These appear in the Vehicle panel when a Te
|
||||
|
||||
**Location**: `Settings -> Vehicle`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Settings specific to Toyota and Lexus vehicles. These appear in the Vehicle pane
|
||||
|
||||
**Location**: `Settings -> Vehicle`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ Configure what information and visual elements appear on the driving screen.
|
||||
|
||||
**Location**: `Settings -> Visuals`
|
||||
|
||||
!!! device-support "Supported Devices"
|
||||
:material-check: comma 3X/3 :material-check: sunnylink :material-close: comma four
|
||||
!!! info "Toggle & Device Availability"
|
||||
This panel contains a mix of features. Some work on all devices, while others require onroad UI elements that only exist on comma 3X/3. Each item below includes its own availability note.
|
||||
|
||||
---
|
||||
|
||||
@@ -17,66 +17,99 @@ Configure what information and visual elements appear on the driving screen.
|
||||
|
||||
Displays visual warnings on the driving screen when a vehicle is detected in your blind spot. Only available on vehicles equipped with Blind Spot Monitoring (BSM) hardware.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
## Steering Arc
|
||||
|
||||
Shows the steering arc overlay on the driving screen when lateral (steering) control is active. This arc illustrates the path sunnypilot is steering toward.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting. Note: On comma four, the steering arc is always displayed and cannot be toggled off.
|
||||
|
||||
---
|
||||
|
||||
## Enable Tesla Rainbow Mode
|
||||
|
||||
Applies a rainbow color effect to the model's planned driving path displayed on screen. This is a cosmetic change only and does not affect driving behavior.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on all devices. comma four users must use sunnylink to change this setting.
|
||||
|
||||
---
|
||||
|
||||
## Enable Standstill Timer
|
||||
|
||||
Displays a timer on the HUD when the vehicle is stopped. The timer shows how long you have been at a standstill.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Display Road Name
|
||||
|
||||
Shows the name of the road you are currently driving on. Requires the OSM map database to be downloaded through the [OSM panel](osm.md).
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Green Traffic Light Alert (Beta)
|
||||
|
||||
Plays a chime and shows an on-screen alert when the traffic light ahead turns green while you are stopped with no lead vehicle in front. Helps you notice the light change.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Lead Departure Alert (Beta)
|
||||
|
||||
Plays a chime and shows an on-screen alert when you are stopped and the vehicle ahead begins moving. Useful for noticing when traffic starts flowing again.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Speedometer: Always Display True Speed
|
||||
|
||||
Forces the speedometer to always show the true vehicle speed from wheel speed sensors, rather than the GPS-based speed. Applicable to vehicles where wheel speed and GPS speed differ.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Speedometer: Hide from Onroad Screen
|
||||
|
||||
Hides the speedometer from the driving screen entirely. When enabled, no speed is displayed while driving.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Display Turn Signals
|
||||
|
||||
Draws visual turn signal indicators on the HUD when the turn signals are active.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink. Note: On comma four, turn signal icons appear during lane change alerts only, but the always-on display does not exist.
|
||||
|
||||
---
|
||||
|
||||
## Real-time Acceleration Bar
|
||||
|
||||
Shows a vertical bar on the left side of the driving screen that indicates real-time acceleration and deceleration. The bar moves up during acceleration and down during braking.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Display Metrics Below Chevron
|
||||
@@ -94,6 +127,9 @@ A row of five buttons that controls what information appears below the lead vehi
|
||||
!!! note "Availability"
|
||||
Requires sunnypilot longitudinal control.
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Developer UI
|
||||
@@ -107,6 +143,9 @@ A row of four buttons that controls the display of real-time developer metrics o
|
||||
| **Right** | Metrics displayed on the right side |
|
||||
| **Right & Bottom** | Metrics displayed on both the right side and bottom |
|
||||
|
||||
!!! info "Toggle & Device Availability"
|
||||
Supported on: comma 3X/3 only. This feature is currently not available on comma four and cannot be forced via sunnylink.
|
||||
|
||||
---
|
||||
|
||||
## Related Features
|
||||
|
||||
Reference in New Issue
Block a user