Crate v2x 

katana-v2x

Linux control library for the Creative Sound Blaster Katana V2X soundbar.

Reverse-engineered USB protocol implementation for controlling RGB lighting, 10-band equalizer, Scout Mode, and audio routing over the CDC ACM interface.

Quick start

use v2x::{KatanaV2X, Color, AnimationMode};

let mut dev = KatanaV2X::open_auto()?;

dev.set_lighting(true)?;
dev.set_color(Color::new(0xFF, 0x00, 0x80))?;
dev.set_brightness(200)?;

dev.set_mode(AnimationMode::Wave)?;
dev.set_colors(&[Color::RED, Color::GREEN, Color::BLUE])?;
dev.set_speed_bpm(20)?;

Device access

The Katana V2X exposes a CDC ACM serial port (typically /dev/ttyACM0). You may need to add your user to the dialout group or set up a udev rule:

# /etc/udev/rules.d/99-katana-v2x.rules
SUBSYSTEM=="tty", ATTRS{idVendor}=="041e", ATTRS{idProduct}=="3283", MODE="0666"

Modules

cmd

Low-level protocol command builders, for advanced use.

Structs

Color

An RGB color.

EqState

Current EQ state as reported by the device.

KatanaV2X

A connection to a Creative Sound Blaster Katana V2X.

LightingState

Current lighting state as reported by the device.

Enums

AnimationMode

LED animation mode.

EqBand

10-band equalizer frequency band.

EqPreset

Built-in EQ presets.

Error

Errors that can occur during Katana V2X communication.

Output

Audio output target.

WaveDirection

Wave animation direction.

Functions

find_device

Find the serial port path for a connected Katana V2X.

Type Aliases

Result