Documentation
Hardware & Modules

Hardware & Modules

Everything about the physical side of Palpable: the boards, the modules, and how they connect.


Boards

BoardSet up withScripts run
Raspberry Pi Zero 2 WA microSD card the app preparesOn the board, and keep running offline
Raspberry Pi 5A microSD card the app preparesOn the board, and keep running offline
Arduino UNO QA USB install from the appOn the board, and keep running offline
ESP32 boards (Espressif DevKits, M5Stack, Seeed XIAO, Adafruit, LilyGO and more)A USB install from the appThrough the cloud for now, so they need Wi-Fi

The app's Add a device list shows every board you can set up today. Boards marked "Coming soon" aren't ready yet.

Things to know

  • Wi-Fi: the Pi Zero 2 W and ESP32 boards only use 2.4 GHz networks.
  • Power, Pi Zero 2 W: a 5V, 2.5A micro USB supply in the port labeled PWR IN (the outer one). Avoid powering it from a laptop port.
  • Power, Pi 5: a USB-C supply.
  • Power, UNO Q and ESP32: the USB cable powers the board.
  • microSD card (Raspberry Pi): a new card usually works as it is. If you erase it, use FAT32 (on a Mac: MS-DOS (FAT) with Master Boot Record).

Connecting modules

Palpable modules use the Qwiic connector: tiny 4-pin cables that click into place. No soldering, no wiring diagrams, no pin counting.

How to connect

  1. Find the Qwiic port on your board. The UNO Q and some ESP32 boards have one built in; a Raspberry Pi needs a Qwiic adapter or HAT.
  2. Click a Qwiic cable into the port, and the other end into your first module.
  3. To add more modules: most modules have two Qwiic ports. Run a cable from the second port to the next module:

That's it. The board detects every module on the chain.

Good to know

  • Hot-swappable: add, remove or swap modules while the board is on. A new module shows up in the app within a few seconds.
  • Order doesn't matter: the board finds them all, wherever they sit in the chain.
  • Keep cables short: long chains and long cables are the most common cause of a module that comes and goes.
💡

Module not detected? Try these in order: reseat the cable at both ends, try a different cable, shorten the chain, then restart the board (unplug its power and plug it back in).


Popular modules

Here are some of the plug-and-play modules Palpable supports.

Sensors (they measure things)

ModuleWhat it measures
Modulino ThermoTemperature and humidity
BME280Temperature, humidity and air pressure
SCD41CO2, temperature and humidity
SGP40Air quality (volatile organic compounds)
Modulino DistanceDistance to the nearest object (up to about 1.2 m, less for dark objects)
Modulino LightBrightness, color and infrared light
Modulino MovementMotion and orientation
ICM-20948Motion and orientation
MAX30101Heart rate and blood oxygen
NAU7802Weight (with a load cell)
VEML7700Ambient light level

Inputs (you interact with them)

ModuleWhat it does
Modulino KnobA knob you turn to change a value, with a push button
Modulino Buttons3 push buttons, each with its own LED
Modulino JoystickA joystick with a push button
Qwiic ButtonA single button with a light
Qwiic KeypadA 12-key number pad

Outputs (they do things)

ModuleWhat it does
Modulino BuzzerPlays tones, melodies and alerts
Modulino Pixels8 individually addressable RGB LEDs
Modulino VibroVibrates
OLED DisplayA small black-and-white screen
Qwiic RelaySwitches higher-power things on and off (lights, fans, pumps)

Modules are available in the store inside the app. Want support for a new module? Request it on our feedback board (opens in a new tab).


Beyond Qwiic

  • Network MIDI: a board can send and receive MIDI over your network, so a project can play your music app or follow your MIDI controller.
  • LoRa and Thread: coming soon.

Changing Wi-Fi after setup

Open the board in the app and go to Wi-Fi. While the board is online, choose another saved network and it switches. Save networks under Settings → Wi-Fi.

If a board has lost its Wi-Fi (for example, you changed your router), the app says so on the board's page and offers Reconnect. It guides you through joining the board's own Wi-Fi hotspot and entering the new network there.


Updates

When an update is ready for a board, the app offers it on the board's Software page. Tap Update. The update installs over the air, alongside the version that is working now. The board goes offline briefly while it restarts into the new version. If the new version doesn't start, the board goes back to the version that worked.


Power tips

  • Use a dedicated power supply, not a laptop USB port, for a Raspberry Pi.
  • If a Pi keeps restarting or losing Wi-Fi, the power supply is probably too weak.
  • Modules with bright LEDs (like Modulino Pixels) draw more power. With many modules, use a stronger supply.