-
-
Notifications
You must be signed in to change notification settings - Fork 26
Configuration options
WS281x LED Status offers plenty of customisable options so you can make the plugin fit your needs well. This pages will attempt to explain most of them, if they are not obvious.
LED Strip settings can be accessed from the settings page in a pop-up modal. Explained:
- Strip type: the kind of your strip. Currently only supporting WS2811/WS2812 types. For WS2811 there are options for different colour orders, use these if the colours aren't as you expect them.
- LED count: Number of LEDs you have on the strip. Please set this right as otherwise the effects will not scale right.
- LED Pin: GPIO pin that the LED Strip is connected to. Only pin 10 is allowed, as that is the only pin that can be used without root access
- Frequency: Frequency used to drive the LEDs. 800,000hz (800Khz) should be suitable for most strips, only change if you know your strip takes a different frequency.
- LED channel: unsure
- DMA channel: Raspberry Pi DMA channel to use. Changing this can have disastrous effects, for example DMA 5 can corrupt the file system.
- Invert: invert the signal, used with certain level shifters that invert the signal, so we can invert it too to balance things out.
The plugin can react to events fired by OctoPrint, and update the effect accordingly. Below are the events it currently reacts to:
- Connected (Also known as 'idle')
- Disconnected
- Print success
- Print paused
- Print failed (cancelled)
You can choose an effect for each event, or choose not to react at all. See the effects below.
The plugin can also track progress of heating and printing. Heating is configured to begin tracking when a blocking heating command such as M109
is sent to the printer, until something else is sent. Options for these effects include:
- Enabled
- Progress bar colour
- Base colour For heating, there is also:
- Enable tracking tool heating
- Which tool to track: If you have a multiple extruder printer, you can enter the index of the tool you wish to track, with the first being 0
- Enable tracking bed heating
Printing event effects can be configured to be one of the below effects (visualisation coming soon!)
You can select a colour (ignored for rainbow effects) and delay for each effect, where delay is how long to wait between effects. Different effects look better with different delay values, for example pulse looks best with a low value, and the wipes like a higher value.
- Solid colour - fairly obvious, sets all LEDs to a colour.
- Color Wipe - wipe colour across, then blank
- Color Wipe 2 - wipe colour across, then back again.
- Pulse - fade brightness up and down
- Bounce - bounce 3 LEDs from one side to the other
- Rainbow - fade through the colours of the rainbow.
- Rainbow cycle - cycle the rainbow along the LEDs
If you have any questions, please don't hesitate to get in touch! You can:
- Open an issue with the question template
- Get support on the OctoPrint Discord @cp2004
- Get support on the Community Forums @Charlie_Powell
I developed the plugin in my free time, so if you have enjoyed the plugin, you can sponsor its development here from as little as $1
The plugin is licensed under the terms of the AGPLv3 License. The author (Charlie Powell) assumes no liability for it's usage and the plugin comes with no warranty.