Documentation
Getting Started
Overview

Getting Started

Let's get your board up and running. By the end of these steps, your board will be online, your sensors will be live, and PAL will have built your first project.

Everything happens in the Palpable app at app.palpable.technology (opens in a new tab). The app walks you through each step; these pages explain what each step does.


Pick your board

These are the boards the app can set up today:

BoardHow it gets set upScripts keep running without internet?
Arduino
Arduino UNO Q
The app installs Palpable over a USB cableYes
ESP32 boards
Adafruit ESP32-S3 Feather, Adafruit ESP32-S3 Reverse TFT Feather, Adafruit QT Py ESP32-C3, ESP32, ESP32andmore GrowMore Display Hub, ESP32andmore GrowMore Hub Universal Controller, Espressif ESP32-C3-DevKitM-1 / DevKitC-02, Espressif ESP32-C6-DevKitC-1, Espressif ESP32-S3-DevKitC-1, Espressif ESP32-S31-Function-CoreBoard-1, LilyGO T-Display-S3, M5Stack ATOM Echo, M5Stack ATOM Lite, M5Stack ATOM Matrix, M5Stack AtomS3, M5Stack AtomS3 Lite, M5Stack AtomS3R, M5Stack Cardputer, M5Stack Core Basic, M5Stack Core2, M5Stack CoreS3, M5Stack CoreS3 SE, M5Stack Dial, M5Stack M5StickC PLUS2, M5Stack StickS3, Seeed Studio XIAO ESP32-C3, Seeed Studio XIAO ESP32-C6, Seeed Studio XIAO ESP32-S3
The app installs Palpable over a USB cableNot yet: an ESP32 needs its Wi-Fi connection for now
Raspberry Pi
Raspberry Pi 5, Raspberry Pi Zero 2 W
The app makes setup files that you copy onto a microSD cardYes

Coming soon: Radxa Zero 3W, Raspberry Pi 4 Model B. The app shows these but can't set them up yet.


What you'll need

ItemWhat it is
A boardOne of the boards above.
A computerSetup needs a desktop browser. For the UNO Q and ESP32 boards, use Chrome, Edge, Arc or Dia (Safari and Firefox can't talk to a board over USB).
For a Raspberry Pi: a microSD card and a way to plug it into your computerThis is where the software lives.
For a Raspberry Pi: a power supply5V, 2.5A. The Pi Zero 2 W uses micro USB; the Pi 5 uses USB-C.
For the UNO Q or an ESP32: a USB data cableIt powers the board and lets the app install Palpable.
Qwiic modules and cablesThe sensors and actuators you want to use. Tiny 4-pin cables that click into place.
Your Wi-Fi name and passwordThe board joins your network on its own.

No soldering. No breadboards. No wiring diagrams.

Everything connects with small click-in cables. If you can plug in a USB cable, you can set up Palpable.


The steps

StepWhat you'll do
Step 1: Add your boardChoose your board and Wi-Fi network in the app
Step 2a: Raspberry Pi: prepare the cardCopy the setup files onto a microSD card, put it in the Pi, power it on
Step 2b: UNO Q and ESP32: install over USBPlug the board into your computer and let the app install Palpable
Step 3: Connect modulesClick your sensors and actuators together
Step 4: First bootWait for the board to come online in the app
Step 5: Your first projectTell PAL what you want, then press Run

Ready? Start with Step 1: Add your board.