Pocket s

Pocket-S — Open-Source ESP32-S3 Multi-Tool

A fully open-source, modular multi-tool platform built on ESP32-S3. Sub-1GHz RF • NFC • 125kHz RFID • IR • BLE • WiFi • Expandable Modules

Getting Started • Hardware • Firmware • KiCad • Docs • Contributing

Features

MCU: ESP32-S3-WROOM-1 (Dual-core LX7 @ 240MHz, 8MB Flash, 8MB PSRAM) Display: 1.54" IPS LCD, 240×240, ST7789V Battery: 3.7V 1200mAh LiPo, USB-C charging Dimensions: 85 × 55 × 12 mm

Quick Start

git clone --recursive https://github.com/ridhinva/pocket-s.git
cd pocket-s/firmware/os
idf.py set-target esp32s3
idf.py build flash monitor

Hardware

KiCad Files

Full KiCad 8.0 project in hardware/kicad/:

• pocket-s.kicad_pro — Project settings, net classes, design rules
• pocket-s.kicad_sch — Hierarchical schematic (11 sheets)
• pocket-s.kicad_pcb — 4-layer PCB (85×55mm) with placements, zones, silkscreen

Schematic Sheets

1. Top Level — ESP32-S3 module, pin assignments
2. Power Management — TP4056 charger, TPS62740 buck, battery protection
3. USB + UART — USB-C connector, CH340C bridge
4. Display — ST7789V LCD with backlight control
5. SD Card — MicroSD socket, 1-bit SDMMC
6. CC1101 Sub-1GHz — Transceiver + RF matching network
7. PN5180 NFC — Controller + antenna matching
8. IR + 125kHz RFID — IR TX/RX, RFID reader
9. Buttons + UI — D-pad, buzzer, RGB LED
10. Expansion Port — 20-pin FPC connector
11. Debug Header — SWD programming header

PCB Specs

• Layers: 4 (F.Cu, GND plane, Power plane, B.Cu)
• Thickness: 1.6mm FR4, ENIG finish
• Min trace: 0.15mm, Min clearance: 0.15mm
• Impedance: 90Ω USB diff, 50Ω RF single-ended
• RF keepouts: CC1101, NFC antenna, RFID coil zones

BOM

See docs/BOM.md — ~85 components, $32-52/unit

Firmware (PocketOS)

Built on ESP-IDF v5.2. Architecture:

PocketOS
├── Bootloader (Secure Boot, OTA A/B)
├── HAL (SPI, I2C, UART, GPIO, ADC, PWM, Display, SD, IR, LED, Power)
├── Radio Drivers (CC1101, PN5180, RFID, IR, BLE, WiFi)
├── Core Services (App Manager, Event Bus, Storage, Settings, Modules, CLI, OTA, Crypto)
├── Applications (Sub-GHz, NFC, RFID, IR, BLE, WiFi, GPIO, Scripts, Settings)
└── UI Framework (Core, Menu, Widgets, Status Bar, Popups, Animations)

Building

cd firmware/os
idf.py set-target esp32s3
idf.py menuconfig    # optional: configure options
idf.py build flash monitor

CLI Commands

PocketOS> help              # Show all commands
PocketOS> cc1101 freq 433920000  # Set Sub-GHz frequency
PocketOS> nfc read          # Read NFC card
PocketOS> ir tx nec 0x1234  # Send IR signal
PocketOS> module list       # List expansion modules

Pin Assignment

Module System

20-pin FPC expansion port supports plug-and-play modules with auto-detection via I2C EEPROM.

See docs/MODULE_DESIGN.md for module development guide.

Module Connector Pinout

Pin  │ Function     │ Dir
─────┼──────────────┼─────
1    │ 3.3V OUT     │ PWR
2    │ 5V OUT       │ PWR
3    │ GND          │ PWR
4    │ GND          │ PWR
5    │ SPI MOSI     │ OUT
6    │ SPI MISO     │ IN
7    │ SPI CLK      │ OUT
8    │ SPI CS0      │ OUT
9    │ I2C SDA      │ BID
10   │ I2C SCL      │ OUT
11   │ UART TX      │ OUT
12   │ UART RX      │ IN
13   │ GPIO 1       │ BID
14   │ GPIO 2       │ BID
15   │ ADC          │ IN
16   │ PWM          │ OUT
17   │ Interrupt    │ IN
18   │ Reset        │ OUT
19   │ 3.3V OUT     │ PWR
20   │ GND          │ PWR

Documentation

• Architecture — System architecture and design decisions
• BOM — Complete bill of materials with costs
• Module Design — Expansion module developer guide
• Hardware Build — Step-by-step assembly guide

Contributing

See CONTRIBUTING.md. In short:

1. Fork → Branch → Code → Test → PR
2. Follow conventional commits (feat:, fix:, docs:)
3. C code follows Linux kernel style

Roadmap

v1.0 ✅

• KiCad schematic + PCB
• PocketOS firmware core
• CC1101, PN5180, IR, RFID drivers
• BLE/WiFi stack
• Module expansion system
• Lua scripting, CLI, OTA

v1.1 (Next)

• BadUSB (USB HID)
• GPS/LoRa module drivers
• Signal recording to SD
• Universal remote DB

v2.0 (Future)

• Larger display option
• Companion mobile app
• Community module marketplace

License

Firmware: MIT License Hardware: CERN-OHL-P-2.0 (Open Hardware)

Made with ❤️ by the open-source hardware community

⬆ Back to Top