Module troubleshooting
Find the message the app shows you, or the thing you're seeing, and start there. Most module problems are a loose cable, and most fix themselves once the cable is back in.
Your project and its scripts are safe. A module that stops answering doesn't delete or change anything. When it comes back, everything carries on.
Nothing plugged in yet
The board hasn't found any modules. If the board itself shows offline, start with Board shows offline instead.
- Check the cable at both ends. Qwiic connectors are small and need a firm push until they click.
- Use the right port. The cable goes into a Qwiic port, a small 4-pin connector. Many boards have one built in. A Raspberry Pi needs a Qwiic adapter or HAT on its pins: check that it's pressed all the way down onto the pins. See Connect modules.
- Wait a few seconds. A newly plugged module usually appears within a few seconds.
- Try another cable. Qwiic cables do fail. If you have a spare, swap it.
- Restart the board. Unplug its power, wait 5 seconds, and plug it back in.
If it still doesn't appear, see I plugged it in and nothing appeared.
"…can't reach its modules"
The app shows "(your board's name) can't reach its modules", and the modules' dots turn red with the words Not answering (on the project map they say Needs attention). If it happens just as you press Run, the message is "(your project) started, but your board can't reach the things plugged into it".
The board is online, but its modules haven't answered for a while. The app waits a short time before saying so, so you'll see this within a couple of minutes of the problem starting.
This is almost always a loose or damaged cable.
- Reseat the cable at both ends, including any module in the middle of a chain.
- Shorten the chain. Plug the module straight into the board with a short cable. If it comes back, the problem is somewhere further along the chain.
- Swap the cable if you have a spare.
You don't need to press anything afterwards. The message clears by itself as soon as the modules answer again.
"…has stopped sensing"
The app shows "(module name) has stopped sensing", and the module's dot says Needs attention.
The module is still connected and still answering, but the numbers it sends don't make sense: they've stopped changing, or the module has lost its settings. Anything built on it has been running on those numbers.
- Unplug the module for a few seconds and plug it back in. This usually brings it back.
- If that doesn't help, restart the board (unplug its power, wait 5 seconds, plug it back in).
- If it keeps happening with the same module, the module itself may be faulty. Try it on another board, or get in touch.
"No readings yet"
The module appears in the list, but its dot says No readings yet.
The board found the module but hasn't heard a reading from it recently. For a module that only does something (a buzzer, a light, a motor) this is normal: there's nothing to read, and its dot stays green without any words. For a sensor you just plugged in, give it a minute. If it stays that way, follow the steps in Nothing plugged in yet.
"Which screen is plugged in?"
PAL asks this when it can see that a screen is connected but several screens look the same to the board. Pick the one you have from the list. If you're not sure, the model name is usually printed on the back of the screen or on its box.
"Unknown part"
The board found something it can't name: a card titled Unknown part appears on the board's page, with a Tell PAL what it is button.
- Tap Tell PAL what it is and say what you plugged in. PAL can often work out which module it is.
- Check that Palpable knows the module. Look for it in the module catalog (opens in a new tab). If it isn't there, Palpable doesn't support it yet: let us know which module it is.
I plugged it in and nothing appeared
If you plugged in a module and the list didn't change at all, the board isn't hearing it. The app has no message for this case.
- Check the cable and port as in Nothing plugged in yet.
- Check that Palpable knows the module. Look for it in the module catalog (opens in a new tab). If it isn't there, Palpable doesn't recognize it yet.
- Ask PAL. Open the project and ask "What's plugged into my board?" PAL lists every module the board can see, and how each one is doing.
- Still nothing? Get in touch and tell us which module it is. We add new modules regularly.
Two of the same module
With two identical modules on one board, often only one of them is found. The board can't tell two identical modules apart unless one has been set to a different identity.
Some modules have a small switch or solder pad for exactly this. Look at the module's page in the module catalog (opens in a new tab) or its maker's guide. If yours has one, change it on one of the two modules, then plug both back in.
Still stuck?
- Note which modules are connected and what the app shows for each one
- Reach out:
- Discord (opens in a new tab): quickest response from the community and team
- Email: [email protected]