Pocket Gate
Build guide

Build your own gate.

One board, one cable, and an afternoon. No accounts, and nothing to sign into.

Bill of materials

One board does it all
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

Everything the firmware touches
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
Two rules for touching the driver. The panel RAM stores one bit per pixel where a set bit is white, so BLACK clears the bit. And USE_HORIZONTIAL in EPD_Init.h decides the panel orientation — 1 for the portrait panel the CrowPanel ships with.
The reading

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.

Next

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.