examples - ebolzMagy/EMCFFBV2 GitHub Wiki

Examples

The EMCFFBV2 firmware comes with pre-configured examples to help you quickly set up various types of gaming controllers without needing to manually configure the hardware. These examples are designed to work out-of-the-box, so you can focus on building and enjoying your project.


Available Examples

Here are the pre-configured examples included with EMCFFBV2:

Example Name Description ESP32-S2 Config ESP32-S3 Config Use Case
Button Box Simple button panel with 128 buttons and 4 POV hats ButtonBox.json ButtonBox.json Sim racing, flight sims
Gamepad Standard game controller with analog sticks Gamepad.json Gamepad.json General gaming
Driving Simulator Steering wheel with force feedback Driving_S2_ABI_CS.json Driving_S3_ABI_CS.json Racing games like Assetto Corsa, iRacing, etc.

How to Load an Example

To load one of the pre-configured examples, follow these steps:

  1. Open the EMCFFBV2 Utility.

  2. Go to Settings by clicking the gear icon in the top-right corner.Settings Icon

  3. Select the System tab. System Tab

  4. Click Load From File.

  5. Choose the configuration file you want to load. Here are some examples:

    • ButtonBox.json: For a simple button box setup. ButtonBox

    • Gamepad.json: For a standard gamepad configuration. Gamepad

    • Driving_S2_ABI_CS.json: For a driving simulator setup with:

      • 1 FFB axis on Axis X.
      • ESP32-S2 chip type (S2).
      • ABI encoder for position feedback.
      • Current sensing (CS) for motor control.

      Driving

  6. Once the file is loaded, your device will automatically be configured according to the selected example. The device will restart to apply the new configuration.


Next Steps

After loading an example, you can proceed to test your device or customize it further using the EMCFFBV2 Utility.

➡️ Continue to Hardware Setup for instructions on connecting your hardware.


Need Help?

If you have any questions or need assistance, visit the Discussions section.


Happy building! 🚀