HIDO - Arcade Multi-Mode Controller

Open source arcade controller with STM32F102RB microcontroller.

🎮 Features

• Triple Mode Support: NKRO Keyboard, Dual Joystick, or JVS/RS485
• Ultra-Low Latency: 1ms USB polling (1000Hz)
• Plug & Play: Standard USB HID device, no drivers needed
• Hardware Debouncing: 5ms configurable debounce time
• Dual Player Support: 2 independent joystick interfaces (34 inputs total)

📚 Documentation

Quick Links

• 📋 PINOUT.md - Complete pin mapping and silkscreen reference
• 🔧 Firmware Documentation - Detailed firmware guide
• 🔨 Build & Compilation - How to build the firmware (scripts and legacy method)
• ⚡ Quick Start Guide - Get started quickly
• 🔄 Mode Comparison - Keyboard vs Joystick vs JVS
• ⚙️ Hardware Configuration - Hardware setup
• 🕹️ JVS Protocol - JVS/RS485 arcade protocol
• 📝 Changelog - Version history
• 👥 Credits - Contributors and licenses

🚀 Quick Start

1. Connect your arcade controls - See PINOUT.md for connector pinout
2. Select operating mode - Edit firmware/Core/Inc/usbd_hid_custom.h
3. Compile and flash - See Quick Start Guide
4. Plug and play - Device recognized as USB HID

🛠️ Hardware

• MCU: STM32F102RB (Cortex-M3, 128KB Flash)
• USB: Full-Speed USB 2.0 (12 Mbps)
• Connectors: J6 (Player 1), J7 (Player 2) - 18 pins each
• Inputs: 34 digital inputs (17 per player) with pull-up resistors
• LEDs: Debug indicators (LED1=P1, LED2=P2)

📋 Pin Mapping Reference

Each connector has silkscreen labels (0-9, A-F, 10) for easy identification:

Silkscreen	Pin	Player 1 Key	Player 2 Key
COM	1	GND	GND
0	2	Z	A
1	3	X	S
2	4	C	D
...	...	...	...
10	18	↑	F1

See PINOUT.md for complete mapping.

🔌 Operating Modes

Keyboard Mode (6KRO)

Standard USB keyboard with 6-key rollover for arcade gaming.

Joystick Mode

Dual USB joystick with 13 logical buttons + 2 axes each (per player).

Note (recent fixes):

• Firmware expects 13 logical buttons per player (bits 0..12).
• Natural mapping restored: Report ID 1 -> Player 1, Report ID 2 -> Player 2.
• Removed blocking HAL_Delay(1) between HID reports to avoid USB freezes.
• Firmware now only sends HID reports when the report contents change (reduces USB traffic).
• If Player 2 feels slow, try reducing DEBOUNCE_TIME_MS in Core/Inc/arcade_joystick.h to 2-3 ms.

JVS Mode

RS485 arcade I/O board protocol for JAMMA/JVS cabinets.

See Mode Comparison for details.

📦 Repository Structure

hido/
├── README.md
├── doc/                   # Documentation
│   ├── CHANGELOG.md
│   ├── CORREZIONI_RS485_5V.md
│   ├── CREDITS.md
│   ├── DFU_UPDATE.md
│   ├── HARDWARE_CONFIG.md
│   ├── JVS_PROTOCOL.md
│   ├── MODE_COMPARISON.md
│   ├── PINOUT.md
│   ├── QUICK_START.md
│   └── README.md
├── fabrication/           # Gerber / manufacturing files
├── firmware/              # STM32 firmware source and tools
│   ├── build.ps1
│   ├── check_dfu_util.bat
│   ├── compile_direct.ps1
│   ├── config_tool.py
│   ├── dfu_update.bat
│   ├── dfu_update.py
│   ├── download_dfu_util.bat
│   ├── flash.ps1
│   ├── hido.ioc
│   ├── LICENSE
│   ├── Makefile
│   ├── STM32F102RBTX_FLASH.ld
│   ├── Core/
│   │   ├── Inc/
│   │   ├── Src/
│   │   └── Startup/
│   ├── Drivers/
│   │   └── STM32F1xx_HAL_Driver/
│   ├── Middlewares/
│   │   └── ST/STM32_USB_Device_Library/
│   ├── tools/
│   └── USB_DEVICE/
├── hardware/              # KiCad design & PCB files
│   ├── Jopen.kicad_pcb
│   ├── Jopen.kicad_sch
│   ├── mcu.kicad_sch
│   ├── rs485.kicad_sch
│   └── Jopen-backups/     # local backups (should be ignored)
└── tools/                 # helper scripts and utilities

📄 License

See CREDITS.md for license information.