v2x 0.2.0

CLI tool and library to control the Creative Katana V2X
Documentation

v2x

This is a Rust library and binary for communicating with the Creative Sound Blaster Katana V2X soundbar from Linux.

Most, but not all functionality is implemented. Most of it has been implemented passively; that is, by sniffing USB traffic while using the Creative App on Windows, and analyzing the packets. This was done on FW version 1.3.230619.1820 - it may not work properly or at all on older versions.

The challenge-response auth was reimplemented by reverse engineering CTCDC.dll, which ships with the Creative App.

Before installing

If you'd like to run this as a regular user, you will likely have to create udev rules to allow accessing the serial device that it creates. For example, in /etc/udev/rules.d/99-katana-v2x.rules:

SUBSYSTEM=="tty", ATTRS{idVendor}=="041e", ATTRS{idProduct}=="3283", MODE="0666"

After adding the rules, reload udev rules and trigger them:

sudo udevadm control --reload-rules && sudo udevadm trigger

Installation

cargo install --locked v2x

Usage

Ensure the program runs and detects your device:

v2x-ctl status

See v2x-ctl --help for the usage - most of it is very self-explanatory.

License

MIT