eh-fifty is a Python library for configuring the Astro A50 wireless headset and base station (generation 4).

Use at your own risk. eh-fifty was developed using reverse engineering. If you get into trouble, re-plug your base station and reset your headset by holding down the "game" and "Dolby" buttons together for 15 seconds.

eh-fifty has only been tested on Linux, although it may work on other platforms supported by PyUSB.

• get/set microphone level
• get/set side tone volume
• get/set noise gate mode
• get/set alert volume
• get/set active EQ preset
• get/set game/voice balance
• save configuration values
• get charging status and battery level
• get headset status
• get EQ preset name
• modify EQ presets
• update firmware
• get/set volume (may not be possible)
• get/set Dolby status (may not be possible)

Retrieve the current battery change:

from eh_fifty import Device
device = Device()
charge_status = device.get_charge_status()
print(f"Battery: {charge_status.charge_percent}%")

Create a udev rule to allow non-root users to access the USB device:

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="9886", ATTR{idProduct}=="002c", MODE="0666"' | \
    sudo tee /etc/udev/rules.d/50-astro-a50.rules

Re-plug your base station to apply the new rule.

The first byte of a request is 0x02.

The second byte of a request is a request type (see below).

A variable number of request arguments may follow.

The first byte of a response is 0x02.

The second byte of a response is 0x02 for "success" or 0x01 for "error".

The third byte of a response is the remaining length of the response measured in bytes, not including this byte.

Sending request type 0x61 will save the active configuration. Saved values can be queried separately from active values. This can be used by applications to implement an operation to revert to a saved configuration. Changes to the active configuration effect immediately; saving changes is not required.