Support for Razer Kraken V3

LukeSerne commented 2 years ago

Device Info

Name: Razer Kraken V3
Product Number: RZ04-03770200
Model Number: RZ04-0377

Device Information

$ lsusb -d 1532: -v
Bus 001 Device 007: ID 1532:0549 Razer USA, Ltd Razer Kraken V3
Couldn't open device, some information will be missing
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               2.00
  bDeviceClass            0 
  bDeviceSubClass         0 
  bDeviceProtocol         0 
  bMaxPacketSize0        64
  idVendor           0x1532 Razer USA, Ltd
  idProduct          0x0549 
  bcdDevice            0.04
  iManufacturer           1 Razer
  iProduct                2 Razer Kraken V3
  iSerial                 3 000000000001
  bNumConfigurations      1
  Configuration Descriptor:
    bLength                 9
    bDescriptorType         2
    wTotalLength       0x00f7
    bNumInterfaces          4
    bConfigurationValue     1
    iConfiguration          4 
    bmAttributes         0xa0
      (Bus Powered)
      Remote Wakeup
    MaxPower              100mA
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        0
      bAlternateSetting       0
      bNumEndpoints           0
      bInterfaceClass         1 Audio
      bInterfaceSubClass      1 Control Device
      bInterfaceProtocol      0 
      iInterface              0 
      AudioControl Interface Descriptor:
        bLength                10
        bDescriptorType        36
        bDescriptorSubtype      1 (HEADER)
        bcdADC               1.00
        wTotalLength       0x004f
        bInCollection           2
        baInterfaceNr(0)        1
        baInterfaceNr(1)        2
      AudioControl Interface Descriptor:
        bLength                12
        bDescriptorType        36
        bDescriptorSubtype      2 (INPUT_TERMINAL)
        bTerminalID             1
        wTerminalType      0x0101 USB Streaming
        bAssocTerminal          0
        bNrChannels             2
        wChannelConfig     0x0003
          Left Front (L)
          Right Front (R)
        iChannelNames           0 
        iTerminal               0 
      AudioControl Interface Descriptor:
        bLength                10
        bDescriptorType        36
        bDescriptorSubtype      6 (FEATURE_UNIT)
        bUnitID                 2
        bSourceID               1
        bControlSize            1
        bmaControls(0)       0x01
          Mute Control
        bmaControls(1)       0x02
          Volume Control
        bmaControls(2)       0x02
          Volume Control
        iFeature                0 
      AudioControl Interface Descriptor:
        bLength                 9
        bDescriptorType        36
        bDescriptorSubtype      3 (OUTPUT_TERMINAL)
        bTerminalID             3
        wTerminalType      0x0301 Speaker
        bAssocTerminal          7
        bSourceID               2
        iTerminal               0 
      AudioControl Interface Descriptor:
        bLength                 9
        bDescriptorType        36
        bDescriptorSubtype      3 (OUTPUT_TERMINAL)
        bTerminalID             4
        wTerminalType      0x0101 USB Streaming
        bAssocTerminal          0
        bSourceID               5
        iTerminal               0 
      AudioControl Interface Descriptor:
        bLength                 7
        bDescriptorType        36
        bDescriptorSubtype      5 (SELECTOR_UNIT)
        bUnitID                 5
        bNrInPins               1
        baSourceID(0)           6
        iSelector               0 
      AudioControl Interface Descriptor:
        bLength                10
        bDescriptorType        36
        bDescriptorSubtype      6 (FEATURE_UNIT)
        bUnitID                 6
        bSourceID               7
        bControlSize            1
        bmaControls(0)       0x01
          Mute Control
        bmaControls(1)       0x02
          Volume Control
        bmaControls(2)       0x02
          Volume Control
        iFeature                0 
      AudioControl Interface Descriptor:
        bLength                12
        bDescriptorType        36
        bDescriptorSubtype      2 (INPUT_TERMINAL)
        bTerminalID             7
        wTerminalType      0x0201 Microphone
        bAssocTerminal          3
        bNrChannels             2
        wChannelConfig     0x0003
          Left Front (L)
          Right Front (R)
        iChannelNames           0 
        iTerminal               0 
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       0
      bNumEndpoints           0
      bInterfaceClass         1 Audio
      bInterfaceSubClass      2 Streaming
      bInterfaceProtocol      0 
      iInterface              0 
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       1
      bNumEndpoints           1
      bInterfaceClass         1 Audio
      bInterfaceSubClass      2 Streaming
      bInterfaceProtocol      0 
      iInterface              0 
      AudioStreaming Interface Descriptor:
        bLength                 7
        bDescriptorType        36
        bDescriptorSubtype      1 (AS_GENERAL)
        bTerminalLink           4
        bDelay                  3 frames
        wFormatTag         0x0001 PCM
      AudioStreaming Interface Descriptor:
        bLength                20
        bDescriptorType        36
        bDescriptorSubtype      2 (FORMAT_TYPE)
        bFormatType             1 (FORMAT_TYPE_I)
        bNrChannels             2
        bSubframeSize           2
        bBitResolution         16
        bSamFreqType            4 Discrete
        tSamFreq[ 0]        24000
        tSamFreq[ 1]        32000
        tSamFreq[ 2]        44100
        tSamFreq[ 3]        48000
      Endpoint Descriptor:
        bLength                 9
        bDescriptorType         5
        bEndpointAddress     0x81  EP 1 IN
        bmAttributes            9
          Transfer Type            Isochronous
          Synch Type               Adaptive
          Usage Type               Data
        wMaxPacketSize     0x00c4  1x 196 bytes
        bInterval               1
        bRefresh                0
        bSynchAddress           0
        AudioStreaming Endpoint Descriptor:
          bLength                 7
          bDescriptorType        37
          bDescriptorSubtype      1 (EP_GENERAL)
          bmAttributes         0x01
            Sampling Frequency
          bLockDelayUnits         1 Milliseconds
          wLockDelay         0x0004
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        2
      bAlternateSetting       0
      bNumEndpoints           0
      bInterfaceClass         1 Audio
      bInterfaceSubClass      2 Streaming
      bInterfaceProtocol      0 
      iInterface              0 
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        2
      bAlternateSetting       1
      bNumEndpoints           1
      bInterfaceClass         1 Audio
      bInterfaceSubClass      2 Streaming
      bInterfaceProtocol      0 
      iInterface              0 
      AudioStreaming Interface Descriptor:
        bLength                 7
        bDescriptorType        36
        bDescriptorSubtype      1 (AS_GENERAL)
        bTerminalLink           1
        bDelay                  3 frames
        wFormatTag         0x0001 PCM
      AudioStreaming Interface Descriptor:
        bLength                23
        bDescriptorType        36
        bDescriptorSubtype      2 (FORMAT_TYPE)
        bFormatType             1 (FORMAT_TYPE_I)
        bNrChannels             2
        bSubframeSize           2
        bBitResolution         16
        bSamFreqType            5 Discrete
        tSamFreq[ 0]        24000
        tSamFreq[ 1]        32000
        tSamFreq[ 2]        44100
        tSamFreq[ 3]        48000
        tSamFreq[ 4]        96000
      Endpoint Descriptor:
        bLength                 9
        bDescriptorType         5
        bEndpointAddress     0x01  EP 1 OUT
        bmAttributes            9
          Transfer Type            Isochronous
          Synch Type               Adaptive
          Usage Type               Data
        wMaxPacketSize     0x0180  1x 384 bytes
        bInterval               1
        bRefresh                0
        bSynchAddress           0
        AudioStreaming Endpoint Descriptor:
          bLength                 7
          bDescriptorType        37
          bDescriptorSubtype      1 (EP_GENERAL)
          bmAttributes         0x01
            Sampling Frequency
          bLockDelayUnits         1 Milliseconds
          wLockDelay         0x0004
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        3
      bAlternateSetting       0
      bNumEndpoints           1
      bInterfaceClass         3 Human Interface Device
      bInterfaceSubClass      0 
      bInterfaceProtocol      0 
      iInterface              0 
        HID Device Descriptor:
          bLength                 9
          bDescriptorType        33
          bcdHID               1.11
          bCountryCode            0 Not supported
          bNumDescriptors         1
          bDescriptorType        34 Report
          wDescriptorLength     205
         Report Descriptors: 
           ** UNAVAILABLE **
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x82  EP 2 IN
        bmAttributes            3
          Transfer Type            Interrupt
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0040  1x 64 bytes
        bInterval               1

$ ls -lah /dev/input/by-id/
total 0
drwxr-xr-x 2 root root 120 25 aug 13:29 .
drwxr-xr-x 4 root root 560 25 aug 13:29 ..
lrwxrwxrwx 1 root root  10 25 aug 13:29 usb-Razer_Razer_Kraken_V3_000000000001-event-if03 -> ../event17

Packet Captures / Synapse Screenshots

I don't have a windows environment to collect pcaps / screenshots from Razer Synapse.

z3ntu commented 1 year ago

Hi, does this device have any model number and product number like e.g. RZ04-0375? Might be printed on the packaging or somewhere else on the device.

LukeSerne commented 1 year ago

The model number appears to be RZ04-0377. This was printed on the packaging. I have updated my initial message to include the model number.

Dekomoro commented 1 year ago

I have a windows environment to capture pcaps and synapse screenshots, I'd need a guide on doing so, but I'd be up to contributing to get my headset working better on linux

z3ntu commented 1 year ago

@Dekomoro The first parts of https://github.com/openrazer/openrazer/wiki/Reverse-Engineering-USB-Protocol cover that.

TallGirlVanessa commented 1 year ago

Synapse screenshots

![image](https://github.com/openrazer/openrazer/assets/103690/7e595503-9f64-4cdf-b4e0-05bbc3d3e5b5) ![image](https://github.com/openrazer/openrazer/assets/103690/7f5602c2-c116-4abf-9957-6c21ca9c67cb) ![image](https://github.com/openrazer/openrazer/assets/103690/ccdae572-c54b-471a-a056-222ab5651da9) ![image](https://github.com/openrazer/openrazer/assets/103690/28ad190f-19d2-42aa-b0d7-6483c2d36ea8) ![image](https://github.com/openrazer/openrazer/assets/103690/ad43044f-efa9-42c4-8677-314d9192c766) ![image](https://github.com/openrazer/openrazer/assets/103690/a263c033-5bac-4e4c-adc2-d7e1db02e895) ![image](https://github.com/openrazer/openrazer/assets/103690/c9c162d9-b26c-4ad2-9e54-09eedfe9ef14) ![image](https://github.com/openrazer/openrazer/assets/103690/cc47ba0f-d237-435d-9679-62e9afe59f55) ![image](https://github.com/openrazer/openrazer/assets/103690/5782c31d-8e6f-4b9c-94af-d5c9d35e55cd) ![image](https://github.com/openrazer/openrazer/assets/103690/3bb4c2c4-bab0-4a3d-a55c-b9a772172adb) ![image](https://github.com/openrazer/openrazer/assets/103690/d67200e4-3e37-4a2c-9637-11ba58ed1ff9)

TallGirlVanessa commented 1 year ago

For pcap, I have a Windows 11 machine, can I use USBPcap, or do I need to do the VM dance? I think I'd need to upgrade to Pro to generate Windows VMs, now that the IE VMs are no longer provided by Microsoft.

z3ntu commented 1 year ago

@TallGirlVanessa Late answer, but wireshark should also work directly, but I've never tried it myself.

But you should be able to easily get a Windows 10 or 11 VM from Microsoft directly.

PTony commented 1 year ago

Hi there,

I've captured some packets for the Kraken V3. I hope i've done it well. :)

Kraken_v3_pcaps.zip

z3ntu commented 1 year ago

@PTony Thanks but my script doesn't appear to find any packets that matches the known packets.

Or alternatively you can look at https://github.com/openrazer/openrazer/blob/master/DEVELOPMENT.md and implement support for this device directly, should with trial & error also for some parameters, but probably guessing based on already supported devices is enough.

PTony commented 1 year ago

Thx @z3ntu . I take note of that.

Eventually I will have a look at it in few weeks, but it's not a promise at all.

If someone else want to give it a go don't wait after me.

Homelessguy42 commented 4 months ago

Hello! I created a fork of this project that attempts to add support for the Razer Kraken V3 headset. Here is the link to the fork:

https://github.com/Homelessguy42/openrazer

My project was able to be be built under a Debian virtual machine without any issues and here is my relevant dmesg output

[  991.103508] razeraccessory: loading out-of-tree module taints kernel.
[  991.103555] razeraccessory: module verification failed: signature and/or required key missing - tainting kernel

following that, here is the output of PYTHONPATH="pylib:daemon" python3 ./daemon/run_openrazer_daemon.py -Fv --config=$PWD/daemon/resources/razer.conf

Now here are my questions: How can I test this further? (e.g. controlling the LEDs on the headset)

and how can I add the associated image of the headset? If anyone has any questions / needs more information please let me know! I want to do everything I can to get this headset supported under GNU/Linux

z3ntu commented 3 months ago

@Homelessguy42 The simplest way is probably to install a UI like polychromatic or RazerGenie and click around and see if the different effects and everything works.

openrazer / openrazer