Troubleshooting
The first thing to try for most boot or reboot issues is a clean power cycle. This can get the QT Py out of a stuck state. It's easy, so we'll try it first.
Disconnect power immediately if you notice excessive heat, a burning smell, smoke, sparks, or damaged wiring. Don't reconnect it until the cause has been identified and corrected.
Start with a clean power cycle
If the power supply beeps and shuts off, disconnect power and check for a short before restarting.
If a USB cable is connected to the QT Py, unplug the other end from your computer, USB hub, or power supply. The cable can stay plugged into the QT Py, as long as it isn't connected to a power source.
Unplug the barrel connector between the power brick and the light.
Wait at least 10 seconds, then reconnect the barrel connector. Leave USB power disconnected.
The main LED should flash briefly and turn off. Wait a moment, then press the power button.
Check carriage tightness
Loose carriage wheels are one of the most common causes of power issues. If the carriage isn't snug against both rails, its pins may not make good contact with the power tracks. This can keep the light from turning on or cause it to cut out as you move it.
With power disconnected, check for rattle or play against both rails. If either feels loose, follow Check carriage tightness, then test the light again. The rails should still move easily; if there's no play, you don't need to keep tightening.
Common issues
Start with the issue you're seeing:
No light after assembly: Follow the power from the base to the LED.
Lamp won't turn back on: The lamp worked before but no longer responds to the power button.
Power supply beeps and shuts off: Check for a short before reconnecting power.
Intermittent power dropouts: The light cuts out as you move it.
Movement feels stiff or uneven: A rail feels stiff, the arm feels unbalanced, or the counterweight gets stuck.
Still need help?
Let me know in the Open Task Light Discord, and we'll try to figure it out together 🙂
Just let me know which troubleshooting steps you've already tried, and we'll go from there.
Last updated
