Skip to content

Troubleshooting Guide

Charlie Powell edited this page Feb 1, 2021 · 11 revisions

This is going to be an ever-evolving page, as I learn of common issues people identify when setting up the plugin.

Got something you think should be on my list here? Ping me on the OctoPrint Discord @cp2004 or open an issue and I'll look into adding it. It helps both myself & other users, since people may come across the same issues you have.

LEDs flicker and change colour loads

Check you have a common ground between an external power supply, and the Pi. See more (including an example video) in the ticket here

The colours of my LEDs are wrong

Make sure you have the correct order of RGB strip selected in the strip settings. You can use the LED Strip test to help debug this issue quickly.

Can't find the plugin after installed

Make sure you restart the OctoPrint server, and reload the web interface. You should see the wizard pop up, or the light/torch icon in the navbar.

Initial report

I restored an OctoPrint backup to a new install, but the LEDs no longer work?

It is likely that the OS level config is incorrect. To fix this, please head to the OS Configuration Test section (under 'Utilities') to run a test and fix the configuration. Setting up SPI page

Unable to initialize SPI

If you get the error:

ws2811_init failed with code -13 (Unable to initialize SPI)

From the plugin_ws281x_led_status_debug.log then it likely means that you have some extra peripherals attached to your Pi, that are taking up the SPI channels, therefore conflicting with the plugin's use of SPI.

No LED output on a Raspberry Pi 4B (rev 1.4), and the log says 'Unsupported board'

The dependency that this plugin relies on was not updated to add support for these boards as of the last release of the plugin. Please see this issue for instructions of how to fix it.

Little/no LED output when not using a level shifter

Some strips do not like 3.3V signals, and if you do use 3.3v (without level shifter) then please keep the wires to the LEDs fairly short to avoid voltage drop.

User reported that SPI failed to initialise with the above screen, however commenting out the lines the guide asked you to enter meant that both the screen and LEDs could work at the same time.

Heads up! This documentation has migrated to Gitbook! Find it here: https://cp2004.gitbook.io/ws281x-led-status/

Clone this wiki locally