How It Works
You don't need to know any of this to use Palpable. It's here for the curious.
The big picture
Palpable has three parts:
Your board
Palpable's software on the board talks directly to your sensors and actuators and stays connected to the cloud.
What it does:
- Detects modules when you plug them in
- Reads sensors and sends the readings to the cloud, so you see them in the app
- Runs your project's script. On a Raspberry Pi or the UNO Q the script runs on the board, so it keeps working if the internet goes down. ESP32 boards run scripts through the cloud for now.
- Installs updates safely, and goes back to the working version if a new one fails
The cloud
- PAL lives here: you talk to it, and it writes your projects' scripts
- Readings travel from your board to the app
- Scripts go from your project down to the board
The app
The Palpable app is your window into everything:
- Live readings from your modules
- Conversations with PAL
- Projects, scripts and the display editor
- Board status and settings
How readings reach you
This happens continuously: values update in real time.
How projects run
On a Raspberry Pi or the UNO Q, the script runs on the board itself. If the internet drops, things the board does by itself (switching a relay, playing the buzzer) keep working. Anything that needs the internet, like a notification to your phone, needs the connection back.
How updates work
When an update is ready, the app offers it on the board's Software page. The new version installs over the air, alongside the one that is working now. If the new version doesn't start, the board goes back to the version that worked, so a bad update doesn't leave you with a dead board.
Security
- Connections between your board, the cloud and the app are encrypted
- A board's setup files carry a signed link to your account, so keep them to yourself
- API keys are stored only as a hash; the key itself is shown to you once and never stored
- An API key opens one project and nothing else
For developers: to build apps on a project's live data, see the Project Context API.