The display configuration options include: Screen On Duration, Auto Carousel Interval, Always Point North, GPS Format, Preferred Display Units, Flip Screen, OLED Definition, Display Mode, Heading Bold, Wake on Tap or Motion, Compass Orientation, and Use 12-Hour Clock. Display configuration uses an admin message to send a Config.Display protobuf.
Display Configuration Values
-
Screen On Duration: Specifies how long the screen remains on after the user button is pressed or messages are received.
-
Auto Carousel Interval: Automatically switches to the next page on the screen like a carousel, based on the specified interval.
-
Always Point North: If enabled, the compass heading displayed outside the circle will always point north. By default, this feature is off, meaning the top of the display represents your heading direction, causing the North indicator to move around the circle.
-
GPS Format: The format used to show 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 |
-
Preferred Display Units: Switch between METRIC (default) and IMPERIAL units.
-
Flip Screen: If enabled, the screen is rotated 180 degrees for instances where the screen is mounted upside down.
-
OLED Definition: The type of OLED controller is auto-detected by default, but can be manually defined if the auto-detection fails. For the SH1107, we assume a square display with 128x128 pixels like the GME128128-1. Acceptable values:
| Value | Description |
| OLED_AUTO | Auto detect display controller |
| OLED_SSD1306 | Always use SSD1306 driver |
| OLED_SH1106 | Always use SH1106 driver |
| OLED_SH1107 | Always use SH1107 driver (Geometry 128x128) |
-
Display Mode: The display mode can be set to DEFAULT (default), TWOCOLOR, INVERTED, or COLOR. The TWOCOLOR mode is designed for OLED displays where the first line of output is a different color from the rest of the display. The INVERTED mode will invert that bicolor area, resulting in a white background for the headline on monochrome displays.
-
Heading Bold: The heading can be difficult to read when using the INVERTED or TWOCOLOR display modes. This setting will make the heading bold for easier readability.
-
Wake on Tap or Motion: This option allows the device screen to wake up when movement, such as a tap, is detected via an attached accelerometer or a capacitive touch button.
-
Compass Orientation: Indicates how to rotate or invert the compass orientation on the display.
-
Use 12-Hour Clock: If false, the device displays the time in a 24-hour format. If true, the time will be shown in a 12-hour format.
Display Configuration Client Availability
Android
Display Config is available for Android.
-
Open the Meshtastic App.
-
Navigate to: Vertical Ellipsis (three dots in the top right) > Radio Configuration > Display.
Apple
All display config options are available on iOS, iPadOS, and macOS at Settings > Device Configuration > Display.
CLI
All display config options are available in the Python CLI. Example commands are below:
| Setting | Acceptable Values | Default |
| display.auto_screen_carousel_secs | integer | Default of 0 is off. |
| display.compass_north_top | false, true | FALSE |
| display.flip_screen | false, true | FALSE |
| display.gps_format | DEC, DMS, UTM, MGRS, OLC, OSGR | DEC |
| display.oled | OLED_AUTO, OLED_SSD1306, OLED_SH1106, OLED_SH1107 | OLED_AUTO |
| display.screen_on_secs | integer | Default of 0 is 10 minutes. |
| display.units | METRIC, IMPERIAL | METRIC |
| display.displaymode | DEFAULT, TWOCOLOR, INVERTED, COLOR | DEFAULT |
| display.heading_bold | false, true | FALSE |
| display.wake_on_tap_or_motion | false, true | FALSE |
-
Set Screen On Duration (Default of 0 is 10 minutes)
| meshtastic --set display.screen_on_secs 0 meshtastic --set display.screen_on_secs 120 |
-
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 |
-
Specify GPS format on device screen
meshtastic --set display.gps_format UTM
|
NOTE: Because the device will reboot after each command is sent via CLI, it is recommended that commands be chained together as one when setting multiple values in a config section. Example:
meshtastic --set display.screen_on_secs 120 --set display.gps_format UTM
|
Web
All display config options are available in the Web UI.
