mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-12-28 23:19:47 -08:00
116 lines
3.2 KiB
Plaintext
116 lines
3.2 KiB
Plaintext
---
|
|
id: display
|
|
title: Display Configuration
|
|
slug: /settings/config/display
|
|
sidebar_label: Display
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
The display config options are: Screen On Duration, Auto Carousel Interval, Always Point North and GPS Format. Display config uses an admin message sending a `Config.Display` protobuf.
|
|
|
|
## Device Config Values
|
|
|
|
### Screen On Duration
|
|
How long the screen remains on after the user button is pressed or messages are received.
|
|
|
|
### Auto Carousel Interval
|
|
Automatically toggles to the next page on the screen like a carousel, based the specified interval.
|
|
|
|
### Always Point North
|
|
If this is set, the compass heading on the screen outside of the circle will always point north. This feature is off by default and the top of display represents your heading direction, the North indicator will move around the circle.
|
|
|
|
### GPS Format
|
|
The format used to display GPS coordinates on the device screen.
|
|
|
|
Acceptable values:
|
|
|
|
| Value | Description |
|
|
| :-------: | :--------------------------: |
|
|
| `DEC` | Decimal Degrees |
|
|
| `DMS` | Degrees Minutes Seconds |
|
|
| `UTM` | Universal Transverse Mercator |
|
|
| `MGRS` | Military Grid Reference System |
|
|
| `OLC` | Open Location Code (Plus Codes) |
|
|
| `OSGR` | Ordnance Survey Grid Reference |
|
|
|
|
### Prefered display units
|
|
switch between `METRIC` (default) and `IMPERIAL` units
|
|
|
|
### Flip Screen
|
|
If enabled, the screen will be rotated 180 degrees, for cases that mount the screen upside down
|
|
|
|
### OLED Defintion
|
|
The type of OLED Controller is auto-detected by default, but can be defined with this setting if the auto-detection fails.
|
|
|
|
Acceptable values:
|
|
|
|
| Value | Description |
|
|
| :-------: | :--------------------------: |
|
|
| `OLED_AUTO` | Auto detect display controller |
|
|
| `OLED_SSD1306` | Always use SSD1306 driver |
|
|
| `OLED_SH1106` | Always use SH1106 driver |
|
|
|
|
## Device Config Client Availability
|
|
|
|
<Tabs
|
|
groupId="settings"
|
|
defaultValue="apple"
|
|
values={[
|
|
{label: 'Android', value: 'android'},
|
|
{label: 'Apple', value: 'apple'},
|
|
{label: 'CLI', value: 'cli'},
|
|
{label: 'Flasher', value: 'flasher'},
|
|
{label: 'Web', value: 'web'},
|
|
]}>
|
|
<TabItem value="android">
|
|
|
|
:::info
|
|
Display config is not available for Android.
|
|
:::
|
|
|
|
</TabItem>
|
|
<TabItem value="apple">
|
|
|
|
:::info
|
|
All display config options are available on iOS, iPadOS and macOS at Settings > Radio Configuration > Display.
|
|
:::
|
|
|
|
</TabItem>
|
|
<TabItem value="cli">
|
|
|
|
All display config options are available in the python CLI. Example commands are below:
|
|
|
|
```shell title="Set Screen On Duration (Default of 0 is 10 minutes)"
|
|
meshtastic --set display.screen_on_secs 0
|
|
meshtastic --set display.screen_on_secs 120
|
|
```
|
|
|
|
```shell title="Set Auto Carousel Interval (Default of 0 is Off)"
|
|
meshtastic --set display.auto_screen_carousel_secs 0
|
|
// Set to 2 Minutes (120 Seconds)
|
|
meshtastic --set display.auto_screen_carousel_secs 120
|
|
```
|
|
|
|
```shell title="Specify GPS format on device screen"
|
|
meshtastic --set display.gps_format UTM
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="flasher">
|
|
|
|
:::info
|
|
No display config options are available in the Flasher.
|
|
:::
|
|
|
|
</TabItem>
|
|
<TabItem value="web">
|
|
|
|
:::info
|
|
All display config options are available in the Web UI.
|
|
:::
|
|
|
|
</TabItem>
|
|
</Tabs>
|