Rename the "Arduino Micro" game controller in Windows & Linux - necroware/gameport-adapter GitHub Wiki

This step is completely optional and only a beauty correction for connected gameport adapters.

When you plug in an adapter, it always registers as "Arduino Micro" by default. If you have several adapters plugged in at the same time, you no longer know which joystick is which. You can avoid this by changing the name of the adapter when flashing the firmware. This is only permitted for private purposes.

The result would look like this:

ncware

(The first two entries are separate Necroware gameport adapters, the third entry is actually a real "SideWinder Precision 2" USB-Joystick)

To rename the "Adruino Micro" default name, follow these steps:

1. Open the boards.txt file in path:

replace the placeholders <username> and <version> accordingly

  • Windows: C:\Users\<username>\AppData\Local\Arduino15\packages\arduino\hardware\avr\<version>\
  • Linux: /home/<username>/.arduino15/packages/arduino/hardware/avr/<version>/

2. Add the following text at the very bottom(!) of the file and save the changes:

micro.build.usb_product="Necroware Gameport Adapter #1"
micro.build.vid=0x2341
micro.build.pid=0x8036

3. Open the Adruino IDE and flash the connected Arduino Micro as you normally would

4. Now the connected device will show up as Necroware Gameport Adapter #1 in the game controller devices list (see screenshot above)

If it still shows up as "Adruino Micro" in Windows, open REGEDIT.EXE and delete the key HKEY_CURRENT_USER\System\CurrentControlSet\Control\MediaProperties\PrivateProperties\Joystick\OEM\VID_2341&PID_8036 which will reset the USB device name. (Sorry, I don't know how to reset USB device names in Linux, but it seems you could try using the command line tool usbreset.)

5. If you have several gameport adapter at hand, repeat the above steps for the 2nd, 3rd, etc. gameport adapter.

However, add the following entries to the boards.txt file, i.e. always increment the ".pid" value by 1 for each device and change the product name accordingly. The .pid value "0x8036" becomes "0x8037" and so on. Always keep the .vid value as it is!

micro.build.usb_product="Necroware Gameport Adapter #1"
micro.build.vid=0x2341
micro.build.pid=0x8036

micro.build.usb_product="Necroware Gameport Adapter #2"
micro.build.vid=0x2341
micro.build.pid=0x8037
⚠️ **GitHub.com Fallback** ⚠️