Skip to content

Home

Jump to bottom
X3n0m0rph59 edited this page Nov 14, 2020 · 3 revisions

Welcome to the Eruption wiki

Introduction

Here you will find some hopefully useful information on how to get your device supported by Eruption.

What is required to get your device supported by Eruption?

We need a pcapng trace of the following steps:

  • The initialization sequence of the device, as performed by the OEM driver software
  • The sequence that configures the device to accept RGB color values, e.g. AIMO mode on ROCCAT devices (only necessary if it is not the default mode)
  • A few trace samples of color setting operations, as performed by the OEM driver software

Which Software do I need to do this?

On Linux you will basically need Wireshark and a Windows 10 VM running the OEM software.

  • Loaded the usbmon kernel module
  • A Windows 10 VM with e.g. ROCCAT Swarm installed
  • Wireshark: Wireshark-qt works great
  • Fully updated device firmware and latest OEM software
  • A second mouse or other pointing device would be very helpful

Steps

Basically we need a pcapng file of the initialization sequence of the hardware device, as sent by the OEM software as well as a sample where it sets the colors.

Please perform the following steps in roughly that order

  • Load the usbmon Linux kernel module that creates a virtual network device which allows for capturing USB traffic using Wireshark
$ sudo modprobe usbmon

  • Start up Wireshark

  • Boot the Windows 10 VM

  • Start capturing the traffic on the correct USB bus, you may want to note what your keyboard device and mouse devices bus IDs are

  • Enable USB forwarding of the device to the Windows 10 VM

  • Start the OEM driver software, e.g.: ROCCAT Swarm: This will send the full initialization sequence to the forwarded device (please use factory settings. For ROCCAT, the LED mode has to be AIMO)

  • After the device has been initialized, you should see the OEM driver changing the colors on the device

  • Capture a few seconds of these 'color setting' packets

  • In Wireshark: Please save the capture as a *.pcapng file

With the captured data, we should be able to reverse engineer a subset of the protocol and get the device initialized and the LEDs up and running.

https://wiki.wireshark.org/CaptureSetup/USB

Clone this wiki locally