Skip to the content
PCBKitNew board
4 layers34 × 41 mmOSMC Module Master, the printed circuit board in 3D

A modular controller that can be configure to how you want to use it

Size
34 × 41 mm
Copper layers
4
Thickness
1.6 mm
Parts
13
Nets
22
Pads
73
Tracks, vias
127, 27
Pours
2
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
1 Sep 2025
Updated
23 Apr 2026

Overview

OSMC Module Master is an open-source printed circuit board by Koalaven, from the Koalaven/Open-Source-Modular-Controller repository on GitHub. It is a 4-layer board of 34 × 41 mm with 13 parts on 22 nets, routed with 127 tracks and 27 vias.

It is built around the PCF8574DWR and 24LC02BT-I/OT. Its parts include 4 diodes, 3 ICs, 3 connectors and 3 switches.

Main components

2

README

README.md

Open 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:

  1. Firmware – ESP32‑S3 code handling HID communication and module input processing.
    Link: Firmware
  2. Software – PC‑side utilities or test scripts (coming soon).
  3. Hardware – KiCad project files, schematics, PCBs, and 3D‑printed shell models.
    Link: Hardware
  4. 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

  1. Gather materials (refer to BOM).
  2. Order PCBs (Gerber files included).
  3. 3D print shell and module housings.
  4. Clean and prepare boards.
  5. Solder components (headers, ESP32 module, connectors, buttons/joysticks).
  6. Upload firmware via Arduino IDE.
  7. Install modules into the shell.
  8. Test controller.

Full assembly guide

What the Project Could Use Next

  1. On‑board processing for more advanced input mapping
  2. PCB adjustment and testing
  3. Wireless mode using Bluetooth HID
  4. 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

GitHub Doc

Alpakka conroller

Proteus ControllerTM kit

Thrustmaster

Adafruit ADS1X15 Library

Parts

13
QtyValueFootprintReferences
4LEDLED_SMD:LED_0603_1608Metric_Pad1.05x0.95mm_HandSolderD1, D2, D3, D4
3SW_PushButton_Switch_THT:SW_PUSH_6mmSW1, SW2, SW3
3SolderJumper_2_BridgedJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJ1, J2, J3
124LC02BT-I/OTLibrary:SOT-23-5_MC_MCHU2
1OSMC Module Board w/pinsLibrary:Module standard pin largeU1
1PCF8574DWRLibrary:DW16U3

Questions

How big is the OSMC Module Master PCB?

It measures 34 × 41 mm and has 4 copper layers, 1.6 mm thick.

What parts does the OSMC Module Master use?

13 parts, built around the PCF8574DWR and 24LC02BT-I/OT. 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 Master 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_Master/OSMC_Module_Master.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 Master 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 layers117.3 × 78.7 mmOSMC Receiver, the printed circuit board in 3D

    OSMC Receiver

    Koalaven/Open-Source-Modular-Controller

    A modular controller that can be configure to how you want to use it

    91 parts
  • 4 layers116.8 × 78.2 mmOSMC Receiver Translators, the printed circuit board in 3D

    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 mmModules, the printed circuit board in 3D

    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 mmOSMC Module Buttons Click, the printed circuit board in 3D

    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 mmOSMC Module Buttons Nav, the printed circuit board in 3D

    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 mmOSMC Module Buttons, the printed circuit board in 3D

    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 mmOSMC Module Bumpers, the printed circuit board in 3D

    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 mmOSMC Module Buttons Membrane, the printed circuit board in 3D

    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 mmOSMC Module Joystick V2, the printed circuit board in 3D

    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 mmOSMC Module Joystick, the printed circuit board in 3D

    OSMC Module Joystick

    Koalaven/Open-Source-Modular-Controller

    A modular controller that can be configure to how you want to use it

    6 parts
  • 2 layers34 × 41 mmOSMC Module Generic Receiver, the printed circuit board in 3D

    OSMC Module Generic Receiver

    Koalaven/Open-Source-Modular-Controller

    A modular controller that can be configure to how you want to use it

    5 parts

Similar boards

  • 2 layers50 × 100 mmLumaDIY, the printed circuit board in 3D

    LumaDIY

    nekaas/LumaDIY

    ESP32-C3 SuperMini educational development board — learn electronics, programming, sensors & robotics

    42 parts
  • 4 layers56.5 × 48.1 mmDisplay driver, the printed circuit board in 3D

    Display driver

    tangles-0/cyberdeck-scout

    // #ifndef PINPA0 // #define PINPA0 11 // #endif // #ifndef PINPA1 // #define PINPA1 8 // #endif // #ifndef PINPA2 // #define PINPA2 9 // #endif // #ifndef PINPA3 // #define PINPA3 10 // #endif // #ifndef PINPA4 //…

    62 parts6
  • 4 layers31.6 × 84.1 mmMCL68, the printed circuit board in 3D

    MCL68

    MicroCoreLabs/Projects

    Ted Fried's MicroCore Labs Projects - FPGA CPU cores and emulators for the 8088, 8086, 8051, 6502, 68000, Z80, Risc-V, and also Typewriter and EPROM Emulator projects.

    13 parts534
  • 4 layers33 × 32 mmDoorman slot programmer, the printed circuit board in 3D

    Doorman slot programmer

    AzonInc/Doorman

    ESP32-S3 based Intercom Gateway (TCS / Koch / Niko / Scantron / Analogue Systems)

    13 parts252GPL-3.0
  • 4 layers25 × 20.5 mmRefclk breakout, the printed circuit board in 3D

    Refclk breakout

    loxodes/vna

    Under development open hardware microwave vector network analyzer

    13 parts205
  • 4 layers59 × 20 mmPmod mmcx, the printed circuit board in 3D

    Pmod mmcx

    azonenberg/starshipraider

    Open hardware test equipment

    13 parts193BSD-3-Clause