/FreeJoy

STM32F103 USB HID game device controller with flexible configuration

Primary LanguageCGNU General Public License v3.0GPL-3.0

FreeJoy

FreeJoy is widely configurable game device controller based on cheap STM32F103C8 microcontroller board. It allows you to create your own HOTAS, pedals, steering wheel device or customize a purchased one.

Getting started

Welcome to our wiki pages to get instuctions how to flash firmware to your board and how to configure device for your application.

Features

FreeJoy supports the following external periphery:

  • 8 analog inputs (12 bit output resolution)
  • axis to buttons function (up to 12 buttons per axis)
  • buttons/encoders to axis functions
  • 128 digital inputs (buttons, toggle switches, hat povs, encoders)
  • 5 shift modificators
  • 4 hat povs
  • 16 incremental encoders
  • shift registers 74HC165 and CD4021
  • digital sensors TLE5010/5011, AS5600, MLX90393 (SPI interface only)
  • external ADCs ADS1115 and MCP3201/02/04/08
  • 3 PWM channels for lighting
  • 24 LEDs (single or matrix) bindable to button's states
  • device name and other USB settings

Axes

FreeJoy supports up to 8 analog inputs at pins A0-A7 and digital sensors as axes sources. Every axis has its own settings as:

  • Source/destination (X, Y, Z, Rx, Ry, Rz, Slider1, Slider2)
  • Output enabling/disabling
  • Resolution
  • Calibration (manual or auto)
  • Smoothing (7 levels of filtration)
  • Inversion
  • Deadband (dynamic or center)
  • Axis offset option (magnet offset)
  • Curve shaping
  • Functions for combined axes
  • Buttons from axes
  • Axes from buttons/encoders

Buttons

FreeJoy allows you to connect up to 128 digital inputs as single inputs (tied to VCC or GND), matrix of buttons, shift register inputs and axes to buttons inputs. Inputs can be configured as:

  • Regular push button
  • Inverted push button
  • Toggle switch ON/OFF
  • Toggle switch ON
  • Toggle switch OFF
  • POV hat button
  • Incremental encoder input
  • Radio buttons
  • Sequential buttons
  • 5 shifts

FreeJoy Configurator utility

FreeJoy configuration is possible using external utility.