Roccat Koneplus mouse obsolete ABI

Profile 선택과 device 정보

BASE=/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>

$BASE/actual_profile
$BASE/startup_profile
$BASE/firmware_version
$BASE/info

actual_profile을 읽으면 현재 profile 번호를 반환한다. persistent 값이므로 mouse power를 다음에 켤 때 활성화될 profile과 같다. 값을 쓰면 startup profile을 저장하고 mouse가 그 profile을 즉시 활성화한다.

startup_profile도 0-4 범위에서 정확히 같은 동작을 한다. 중복 interface이므로 actual_profile을 사용해야 한다.

firmware_version은 mouse가 보고한 firmware version을 raw integer로 반환한다. 다른 program에서 다루기 쉽게 integer를 사용하며 실제 version은 decimal point를 왼쪽으로 두 자리 옮겨 구한다. 예를 들어 121은 1.21이다. 이 file 대신 firmware version이 포함된 binary info attribute를 읽는 것이 권장된다.

info를 읽으면 firmware version 같은 일반 data 8 byte를 반환한다. 8-byte data를 쓰면 device를 reset할 수 있다.

Macro와 profile button layout

$BASE/macro
$BASE/profile_buttons
$BASE/profile[1-5]_buttons

mouse는 최대 500번의 key 또는 button stroke로 이루어진 macro를 내부에 저장할 수 있다. macro에 쓰면 특정 profile의 특정 button sequence를 설정한다. 2082-byte payload에 button 번호와 profile 번호가 포함되어야 한다.

mouse는 button press로 전환할 수 있는 profile 다섯 개를 저장한다. 각 profile은 settings와 buttons 두 부분으로 나뉘며 profile_buttons는 button layout을 담는다.

profile_buttons에 77 byte를 쓰면 payload 내부 profile 번호가 지정하는 profile의 button data를 mouse에 기록한다. mouse는 잘못된 data를 거부한다. 읽기 전에는 control에 써서 읽을 profile을 선택해야 한다.

profile1_buttons부터 profile5_buttons까지의 file은 각 profile button data 77 byte를 직접 읽는 기존 read-only interface다. 이제 control로 profile을 선택하고 profile_buttons를 읽는 방식을 사용해야 한다.

Profile settings

$BASE/profile_settings
$BASE/profile[1-5]_settings

profile_settings는 resolution, sensitivity, light effect 같은 profile 설정을 담는다. 43-byte payload를 쓰면 payload의 profile 번호가 지정한 settings를 mouse에 기록하며 invalid data는 mouse가 거부한다. 읽기 전에는 control에 써서 profile을 선택해야 한다.

profile1_settings부터 profile5_settings까지는 각 profile settings 43 byte를 직접 반환하는 기존 read-only interface다. control로 profile을 선택한 뒤 profile_settings를 읽는 방식으로 대체되었다.

Sensor, Talk와 TCU calibration

$BASE/sensor
$BASE/talk
$BASE/tcu
$BASE/tcu_image

mouse에는 tracking control unit와 distance control unit가 있다. sensor에 6 byte를 쓰면 두 unit을 활성화하거나 비활성화하고 lift-off distance를 설정할 수 있다.

talk에 16 byte를 쓰면 mouse의 일부 easy* 기능을 외부 host에서 활성화한다.

tcu에 4 byte를 쓰면 tracking control unit calibration을 시작하거나 취소할 수 있다. 같은 attribute로 sensor register를 읽고 쓸 수도 있다.

tcu_image를 읽으면 mouse가 sample한 아래 표면의 30×30 pixel image를 반환한다. tcu로 시작한 calibration 과정 중에만 동작하며 반환 data 크기는 1028 byte다.