4 layers117.3 × 78.7 mm
OSMC Receiver
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
91 parts
2 layers34 × 41 mm
OSMC Module Generic Receiver
Koalaven/Open-Source-Modular-ControllerA modular controller that can be configure to how you want to use it
- Size
- 34 × 41 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 5
- Nets
- 15
- Pads
- 36
- Tracks, vias
- 54, 6
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 1 Sep 2025
- Updated
- 23 Apr 2026
Overview
OSMC Module Generic Receiver is an open-source printed circuit board by Koalaven, from the Koalaven/Open-Source-Modular-Controller repository on GitHub. It is a 2-layer board of 34 × 41 mm with 5 parts on 15 nets, routed with 54 tracks and 6 vias.
README
README.mdOpen Source Modular Controller
Using a modular, reconfigurable hardware architecture to create a customizable USB HID game controller.
Project Details
The Open Source Modular Controller project is a fully modular and customizable gaming input system. Users can freely rearrange joysticks, buttons, and future input modules on a set of interchangeable receiver boards to build a layout that fits their gameplay style, ergonomic needs, or accessibility requirements.
The controller connects over USB and is recognized as a standard Human Interface Device (HID) with no additional drivers required.
Current State
The current prototype includes:
- A functional ESP32‑S3‑based main controller
- Hot-swappable joystick and button modules
- Receiver boards that can be placed anywhere in the 3D‑printed shell
- USB HID communication via TinyUSB
The system operates as a recognized USB gamepad on Windows. Some hardware issues were identified and corrected in updated revisions.
Project Structure
The repository is organized as follows:
- Firmware – ESP32‑S3 code handling HID communication and module input processing.
Link: Firmware - Software – PC‑side utilities or test scripts (coming soon).
- Hardware – KiCad project files, schematics, PCBs, and 3D‑printed shell models.
Link: Hardware - Documentation – Assembly instructions, diagrams, semester report, and testing notes.
Link: Documentation
Features
- Modular input modules (buttons, joystick, future sensors)
- Repositionable input layout using multiple receiver boards
- ESP32‑S3 native USB HID support
- Open‑source hardware and firmware
- 3D‑printable ergonomic controller shell
System Architecture
Core system components include:
- Receiver boards distributing power, signals, and micro-controller
- Module boards for inputs (joystick/button)
- 3D‑printed enclosure with heat‑set inserts for secure mounting
USB HID enumeration and report handling are implemented using TinyUSB. Modules communicate through standardized connectors to the controller board.
Bill of Materials
A full BOM including the ESP32‑S3 boards, connector sets, resistors, capacitors, PCBs, wire, and 3D‑printed components is provided in the documentation.
BOM
Tools Used
Software
- Arduino IDE
- KiCad
- OnShape (frame design)
- GitHub Desktop
- Cura slicer
Hardware
- 3D printer
- Soldering iron
- Hot air station
- Multimeter
- Tweezers
Assembly Overview
- Gather materials (refer to BOM).
- Order PCBs (Gerber files included).
- 3D print shell and module housings.
- Clean and prepare boards.
- Solder components (headers, ESP32 module, connectors, buttons/joysticks).
- Upload firmware via Arduino IDE.
- Install modules into the shell.
- Test controller.
What the Project Could Use Next
- On‑board processing for more advanced input mapping
- PCB adjustment and testing
- Wireless mode using Bluetooth HID
- Additional module types (battery, gyroscope, sliders, touchpads)
Semester End Report
For the Enterprise Program at Michigan Tech there is a end of semester and project report for the project to summarize the progress of the project. Link
Acknowledgements
This project is supported by the Open Source Hardware Enterprise at Michigan Technological University.
Helpful Links
References
Parts
5| Qty | Value | Footprint | References |
|---|---|---|---|
| 3 | SolderJumper_3_Open | Jumper:SolderJumper-3_P1.3mm_Open_Pad1.0x1.5mm | JP9, JP10, JP11 |
| 1 | OSMC Module Board w/pins | Library:Module standard pin large | U1 |
The 4 most common of 5 parts.
Questions
How big is the OSMC Module Generic Receiver PCB?
It measures 34 × 41 mm and has 2 copper layers, 1.6 mm thick.
What parts does the OSMC Module Generic Receiver use?
5 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the OSMC Module Generic Receiver KiCad files?
From the Koalaven/Open-Source-Modular-Controller repository on GitHub, at the commit this page was made from: the board is Hardware/PCBs/module/OSMC_Module_Generic_Receiver/OSMC_Module_Generic_Receiver.kicad_pcb and its schematic Hardware/PCBs/OSMC_Receiver/Modules.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the OSMC Module Generic Receiver design in my own project?
Its repository states no licence, so its author keeps all rights: ask Koalaven before reusing the design.
More from Koalaven/Open-Source-Modular-Controller
11- 4 layers116.8 × 78.2 mm
OSMC Receiver Translators
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
67 parts - 2 layers234 × 136.1 mm
Modules
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
50 parts - 4 layers34 × 41 mm
OSMC Module Buttons Click
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
15 parts - 4 layers34 × 41 mm
OSMC Module Buttons Nav
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
15 parts - 4 layers34 × 41 mm
OSMC Module Master
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
13 parts - 4 layers34 × 41 mm
OSMC Module Buttons
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
11 parts - 4 layers34 × 41 mm
OSMC Module Bumpers
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
8 parts - 4 layers34 × 41 mm
OSMC Module Buttons Membrane
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
7 parts - 4 layers34 × 41 mm
OSMC Module Joystick V2
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
7 parts - 4 layers34 × 41 mm
OSMC Module Joystick
Koalaven/Open-Source-Modular-Controller
A modular controller that can be configure to how you want to use it
6 parts
Similar boards
- 2 layers98 × 27 mm
- 2 layers21 × 33 mm
24g2usb pico2w
joypad-ai/joypad-os
Universal controller firmware for building adapters, dongles, and custom controllers.
5 parts1.7kApache-2.0 - 2 layers53.2 × 59.6 mm
A10 OLinuXino Lime Rev B SHIELD TEMPLATE
OLIMEX/OLINUXINO
OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C
5 parts1.5k - 2 layers30 × 11 mm
Main control board servo tester
jamro/tiny-engineer
A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.
5 parts1.1k - 2 layers78.8 × 35.3 mm
KiCadTest
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
5 parts915 - 2 layers50 × 23 mm
- 2 layers43.2 × 28.5 mm
- 2 layers20.3 × 15.2 mm
L0 light sensor
Luos-io/luos_engine
Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.
5 parts546MIT