Build your own gate.
One board, one cable, and an afternoon. No accounts, and nothing to sign into.
Bill of materials
| Board | CrowPanel ESP32‑S3 2.13″ e-Paper — ESP32‑S3, 2.13″ B/W SSD1680 panel, 5‑way dial, USB‑C |
|---|---|
| Firmware | tarot-aura-keychain — PlatformIO project, Arduino framework |
| Artwork | 1909 Rider–Waite–Smith plates by Pamela Colman Smith, public domain, drawn down to black and white for the paper screen |
| Enclosure | Optional. A 3D printed keychain shell, a lanyard loop, or nothing at all — the board is 40 mm square. |
| Power | USB‑C, 5 V. A 400 mAh LiPo rides along fine. |
Pin map
| EPD SPI | SCK GPIO 12 · MOSI GPIO 11 · CS GPIO 14 · DC GPIO 13 · RST GPIO 10 · BUSY GPIO 9 |
|---|---|
| Screen power | GPIO 7 |
| Status LED | GPIO 19 |
| Dial | HOME GPIO 2 · EXIT GPIO 1 · LEFT GPIO 6 · RIGHT GPIO 4 · PUSH GPIO 5 |
All five inputs are pulled up internally and read active-low, so a pressed button is a zero.
Flashing
Clone the project, point it at the board, flash it:
git clone <your-fork>/tarot-aura-keychain
cd tarot-aura-keychain
# edit platformio.ini if your board is not on /dev/ttyUSB0
pio run -t upload
pio device monitor
The target is defined in platformio.ini:
[env:esp32s3]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.flash_size = 8MB
board_build.partitions = default_8MB.csv
Project layout
tarot-aura-keychain/
├── platformio.ini
├── include/
│ ├── EPD.h drawing API
│ ├── EPD_Init.h panel geometry, waveforms, GPIO map
│ ├── EPDfont.h 6x12 / 8x16 / 12x24 / 16x32 / 24x48 fonts
│ ├── spi.h panel SPI bus
│ └── tarot_cards.h 22 major arcana bitmaps + keywords
└── src/
├── main.cpp scan, casting rules, screen layout
├── EPD.cpp framebuffer drawing primitives
├── EPD_Init.cpp SSD1680 init, LUT waveforms, sleep
└── spi.cpp bit-banged panel SPI
The field picks the card.
The gate does not shuffle. It reads the quantum wave field where you are standing, names an aura from how thick that field is, names an element from where it leans, and settles on one of the twenty-two. Same place, same card, until the field changes. The source is in the firmware if you want to read the mechanism. This page is for building the object.
Put one on your own keyring.
The firmware is ready to flash today. If you would rather have a finished board with a case and a charge cycle, leave your address and we will write when the next run opens.