V1 Setting V2 Setting Description
Master enable Panel Enables the panel interface module. Panels provide a screen, an encoder wheel and/or a set of buttons, used to control your machine without requiring a computer connection. When enabled, the panel module initializes the LCD driver, configures input devices, and registers for system events to display machine status and accept user input. If disabled, the panel module is completely removed from memory.
Not in V2 Required reprap_discount_glcd, st7565_glcd, ssd1306_oled, viki2, mini_viki2, universal_adapter Specifies the type of panel connected to the Smoothieboard. Each panel has a specific interface and driver requirements, so the correct panel type must be specified. The value determines which panel driver will be loaded and initialized. Different panels have different pin requirements, button configurations, and display capabilities. RRD GLCD does not support SPI CS pin sharing
Not in V2 SPI 0 Selects which SPI channel to use for panel communication. The Smoothieboard has two SPI channels with different pin assignments. Channel selection affects which physical pins are used for MOSI, MISO, and SCLK signals. Most panels use channel 0 by default.
Pin nc Specifies the CS (Chip Select) pin used to select the panel device on the SPI bus. CS allows multiple devices to share the same SPI port by activating only the selected device. When CS is low (active), the panel responds to SPI commands; when high (inactive), the panel ignores SPI traffic. RRD GLCD does not support CS and requires being alone on its SPI port
Not in V2 SPI Speed SPI port frequency - some panels need it explicitly set. This setting controls the communication speed between the Smoothieboard and the panel.
Not in V2 Visual 9 Contrast value for panels that support it. Supported panels: viki2, mini_viki2, and st7565_glcd. Adjust this value if the display appears too faint or too dark.
Not in V2 Visual false If set to true, reverse the screen orientation. Use this if your panel is mounted upside down.
Not in V2 Visual 0 On some panels, this value must be set to 1. This is a number of lines to offset the menu lines by on screen. Adjust if menu items don't align properly on your display.
Not in V2 Pin Encoder A pin for the encoder wheel. Encoders have two pins: A and B. Set to nc if you use no encoder. The ^ modifier defines menu move direction. Use ! for pull-up/pull-down and ^ to invert.
Not in V2 Pin Encoder B pin for the encoder wheel. Encoders have two pins: A and B. Set to nc if you use no encoder. The ^ modifier defines menu move direction. Use ! for pull-up/pull-down and ^ to invert.
Not in V2 Encoder 2 The number of pulses the encoder emits per detent/click. Adjust this if the encoder is too sensitive or not sensitive enough for menu navigation.
Not in V2 Pin Button Pin for the click ("enter" or "select") button. This button is typically pressed to select menu items, confirm actions, and accept value changes. The ! modifier inverts the signal polarity (use for active-low buttons).
Not in V2 Pin Button Pin for the back ("escape" or "cancel") button. This button returns to the previous menu level or cancels the current operation. On Viki2 panels, this pin may be used for either back button or pause button functionality.
Not in V2 Pin Button Pin for the up button. Used for menu navigation when no encoder is present. The ! modifier inverts the signal polarity.
Not in V2 Pin Button Pin for the down button. Used for menu navigation when no encoder is present. The ! modifier inverts the signal polarity.
Not in V2 Pin Button Pin for the pause button. Allows immediate pause of the current operation. This is a convenience feature for quick access to pause functionality.
Not in V2 Button Delay Delay in milliseconds before a button press is considered a "long press". Long press actions may trigger different menu functions than short presses.
Not in V2 Pin Buzzer Pin for the buzzer. The buzzer provides audio feedback for button presses and alerts. Some panels have built-in buzzers that require this pin to be configured.
Not in V2 Pin LED Pin for the red LED on Viki2 panels. The red LED typically indicates heating status or errors. Only available on Viki2 and similar panels with status LEDs.
Not in V2 Pin LED Pin for the blue LED on Viki2 panels. The blue LED typically indicates cooling or idle status. Only available on Viki2 and similar panels with status LEDs.
Not in V2 Pin Control nc If using a Viki or SSD1306, this pin is needed to drive the C/D (Command/Data) pin on the display. This pin distinguishes between command and data bytes in the SPI communication.
Not in V2 Pin Control nc If using an SSD1306, this pin is sometimes required and connects to the reset pin on the display. The reset pin is used to initialize the display controller.
Not in V2 Pin nc If using the universal_adapter, this pin can be connected to the adapter to ask if it is busy or not. The universal adapter uses this for daisy-chaining multiple devices.
Not in V2 Jogging X/Alpha 6000 X (Alpha) axis jogging feedrate in millimeters/minute. This is used when jogging using the panel screen. Adjust based on your machine's capabilities and desired jogging speed.
Not in V2 Jogging Y/Beta 6000 Y (Beta) axis jogging feedrate in millimeters/minute. This is used when jogging using the panel screen. Adjust based on your machine's capabilities and desired jogging speed.
Not in V2 Jogging Z/Gamma 200 Z (Gamma) axis jogging feedrate in millimeters/minute. This is used when jogging using the panel screen. Typically slower than XY jogging for precision and safety.
Not in V2 Preset Hotend 185 Temperature to set the hotend to when using the pre-heating menu item on the panel. This provides a quick-access one-button preset for heating the hotend to a commonly used temperature. Set to match your most commonly used filament type.
Not in V2 Preset Heated bed 60 Temperature to set the bed to when using the pre-heating menu item on the panel. This provides a quick-access one-button preset for heating the bed to a commonly used temperature. Set to match your most commonly used filament type.
Not in V2 SD card false Set to true if your panel has an external SD card slot, or if you want to connect a second SD card slot to one of your Smoothieboard's SPI ports. Enables additional SD card interface beyond the onboard SD slot. External SD cards over SPI cables can be unreliable - NOT recommended for printing
Not in V2 SPI SD card 0 Set the SPI channel the external SD card is on. This must match the SPI channel used by the panel if they share the same SPI port, or can be a different channel if separate.
Not in V2 Pin SD card Set the CS (Chip Select) pin for the external SD card. This allows you to use multiple devices on the same SPI port, as long as they each have a unique CS pin.
Not in V2 Pin SD card nc SD card detect signal pin. Set to nc if you don't use an SD card detect signal. This pin detects when an SD card is inserted or removed.
Not in V2 Visual Multi-extruder Controls which extruder's temperature is displayed on panels. Useful for multi-extruder setups to show the currently active extruder's status.
Not in V2 Custom Required for custom menu When set to true, create a new custom menu entry for the panel with the name {name}. You can create any number of custom entries as long as they have different names. Replace {name} with your menu identifier. {name} is case sensitive
Not in V2 Custom The name that will be displayed in the panel's menus. Underscores (_) are converted to spaces when displayed. This is what the user sees when browsing the menu.
Not in V2 Custom Commands The command that will be executed when the menu entry is selected and clicked. The _ character gets converted to space in the menu and commands (and must be used instead of the space character), and the | character is used to separate multiple commands that should be executed in sequence. M80_S30|G1_X10 executes M80 S30 followed by G1 X10
This is a wiki! If you'd like to improve this page, you can edit it on GitHub.