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 2 years 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 2 years 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 6 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 5 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.

lyricalpaws commented 1 month ago

still waiting for this tbh, having my headset disconnect and reconnect at a whisper of a volume constantly any time I boot something is very annoying

z3ntu commented 1 month ago

@lyricalpaws OpenRazer support wouldn't fix any of this, we don't touch the audio stack at all, just add some functionality on top like normally lights and some other misc. settings.

openrazer / openrazer