ALSA: usb: Add support for Reloop Jockey 3 DJ controllers
cover ALSA: usb: Add support for Reloop Jockey 3 DJ controllers
Hi Takashi, Hello ALSA community,
After being away from active ALSA development for some 25 years or so, I am happy to submit this patch to introduce a dedicated driver supporting the Jockey 3 series of DJ Controllers made by Reloop (specifically covering the Master Edition and the Remix variants).
I initially evaluated the feasibility of integrating the required logic to handle the non-standard proprietary Ploytec framing protocol into the standard USB-audio driver via quirks. However, doing so would require introducing numerous hardware-specific exceptions throughout the core layout, adding significant complexity. A clean, isolated driver subdirectory provides much better long-term maintainability without cluttering the existing class-compliant architecture.
I have successfully validated and stress-tested this driver across three distinct hardware architectures to ensure robustness regarding DMA, timing, and memory alignment:
- x86_64 (Standard PC desktop environment)
- armhf (32-bit legacy environment on a Raspberry Pi 1B)
- arm64 (64-bit modern SoC environment on a Raspberry Pi 4)
I look forward to your review and feedback, and I am more than happy to make architectural adjustments as required.
Best regards,
Frank van de Pol
Frank van de Pol (1):
ALSA: usb: Add support for Reloop Jockey 3 DJ controllers
MAINTAINERS | 7 + sound/usb/Kconfig | 1 + sound/usb/Makefile | 1 + sound/usb/jockey3/Kconfig | 19 + sound/usb/jockey3/Makefile | 3 + sound/usb/jockey3/jockey3.c | 841 ++++++++++++++++++++++++++++++ sound/usb/jockey3/ploytec_codec.c | 116 +++++ sound/usb/jockey3/ploytec_codec.h | 34 ++ 8 files changed, 1022 insertions(+) create mode 100644 sound/usb/jockey3/Kconfig create mode 100644 sound/usb/jockey3/Makefile create mode 100644 sound/usb/jockey3/jockey3.c create mode 100644 sound/usb/jockey3/ploytec_codec.c create mode 100644 sound/usb/jockey3/ploytec_codec.h
Signature · 1 line
2.47.3
PATCH 1/1 ALSA: usb: Add support for Reloop Jockey 3 DJ controllers
Introduce a dedicated repository subdirectory and driver for the Reloop Jockey 3 Master Edition and Reloop Jockey 3 Remix USB DJ controllers.
Because these devices utilize a non-standard, proprietary Ploytec USB framing protocol instead of standard USB Audio Class (UAC) mechanisms, they require specialized handling outside of standard quirks.
This driver provides:
- 24-bit multi-channel (6x4) audio capture and playback.
- Support for 44.1, 48, 88.2, and 96 kHz sample rates.
- ALSA RawMIDI input and output mapping for the integrated control surface.
The custom Ploytec encapsulation and streaming format was successfully reverse-engineered via USB protocol analysis and is isolated cleanly into a local hardware-independent codec abstraction.
--- MAINTAINERS | 7 + sound/usb/Kconfig | 1 + sound/usb/Makefile | 1 + sound/usb/jockey3/Kconfig | 19 + sound/usb/jockey3/Makefile | 3 + sound/usb/jockey3/jockey3.c | 841 ++++++++++++++++++++++++++++++ sound/usb/jockey3/ploytec_codec.c | 116 +++++ sound/usb/jockey3/ploytec_codec.h | 34 ++ 8 files changed, 1022 insertions(+) create mode 100644 sound/usb/jockey3/Kconfig create mode 100644 sound/usb/jockey3/Makefile create mode 100644 sound/usb/jockey3/jockey3.c create mode 100644 sound/usb/jockey3/ploytec_codec.c create mode 100644 sound/usb/jockey3/ploytec_codec.h
MAINTAINERS +7 -0
@@ -22530,6 +22530,13 @@ F: Documentation/filesystems/relay.rst F: include/linux/relay.h F: kernel/relay.c +RELOOP JOCKEY 3 DJ CONTROLLER DRIVER +M: Frank van de Pol <[email protected]> +L: [email protected] +S: Maintained +T: git git://git.kernel.org/pub/scm/linux/kernel/git/tiwai/sound.git +F: sound/usb/jockey3/ + REGISTER MAP ABSTRACTION M: Mark Brown <[email protected]> L: [email protected]
sound/usb/Kconfig +1 -0
@@ -205,6 +205,7 @@ config SND_USB_AUDIO_QMI will be called snd-usb-audio-qmi. source "sound/usb/line6/Kconfig" +source "sound/usb/jockey3/Kconfig" endif # SND_USB
sound/usb/Makefile +1 -0
@@ -37,3 +37,4 @@ obj-$(CONFIG_SND_USB_US122L) += snd-usbmidi-lib.o obj-$(CONFIG_SND) += misc/ usx2y/ caiaq/ 6fire/ hiface/ bcd2000/ qcom/ obj-$(CONFIG_SND_USB_LINE6) += line6/ +obj-$(CONFIG_SND_USB_JOCKEY3) += jockey3/
sound/usb/jockey3/Kconfig new file +19 -0
@@ -0,0 +1,19 @@ +# SPDX-License-Identifier: GPL-2.0-only +config SND_USB_JOCKEY3 + tristate "Reloop Jockey 3 support" + default m + depends on SND_USB && USB + select SND_PCM + select SND_RAWMIDI + help + Say Y here to include support for the Reloop Jockey 3 DJ controllers. + These devices utilize a non-standard, proprietary Ploytec USB + protocol. + + Supported devices: + + * Reloop Jockey 3 Master Edition + * Reloop Jockey 3 Remix + + To compile this driver as a module, choose M here: the module + will be called snd-usb-jockey3.
sound/usb/jockey3/Makefile new file +3 -0
@@ -0,0 +1,3 @@ +# SPDX-License-Identifier: GPL-2.0 +obj-$(CONFIG_SND_USB_JOCKEY3) += snd-reloop-jockey3.o +snd-reloop-jockey3-objs := jockey3.o ploytec_codec.o
sound/usb/jockey3/jockey3.c new file +841 -0
841 lines not on this page · raw message
sound/usb/jockey3/ploytec_codec.c new file +116 -0
116 lines not on this page · raw message
sound/usb/jockey3/ploytec_codec.h new file +34 -0
@@ -0,0 +1,34 @@ +/* SPDX-License-Identifier: GPL-2.0-or-later */ +/* +* ALSA driver for Reloop Jockey 3 devices +* +* Copyright (c) 2026 by Frank van de Pol <[email protected]> +*/ + +#ifndef PLOYTEC_CODEC_H +#define PLOYTEC_CODEC_H + +#include <linux/types.h> + +/* Ploytec Protocol Constants */ +#define PLOYTEC_PKT_SIZE 512 +#define PLOYTEC_MIDI_IDLE_BYTE 0xFD + +/* Playback (EP 0x05) */ +#define PLOYTEC_EP_PCM_OUT 0x05 +#define PLOYTEC_PLAYBACK_FRAMES 10 +#define PLOYTEC_PLAYBACK_FRAME_SIZE 48 + +/* Capture (EP 0x86) */ +#define PLOYTEC_EP_PCM_IN 0x86 +#define PLOYTEC_CAPTURE_FRAMES 8 +#define PLOYTEC_CAPTURE_FRAME_SIZE 64 + +/* MIDI (EP 0x83) */ +#define PLOYTEC_EP_MIDI_IN 0x83 + +/* Bit-shuffling codec for S24_3LE (3 bytes per sample) */ +void ploytec_encode_s24_3le (u8 *dest,const u8 *src); +void ploytec_decode_s24_3le (u8 *dest,const u8 *src); + +#endif /* PLOYTEC_CODEC_H */
Signature · 1 line
2.47.3
Quoted 24 lines · Frank van de Pol
Hi Takashi, Hello ALSA community,
After being away from active ALSA development for some 25 years or so, I am happy to submit this patch to introduce a dedicated driver supporting the Jockey 3 series of DJ Controllers made by Reloop (specifically covering the Master Edition and the Remix variants).
I initially evaluated the feasibility of integrating the required logic to handle the non-standard proprietary Ploytec framing protocol into the standard USB-audio driver via quirks. However, doing so would require introducing numerous hardware-specific exceptions throughout the core layout, adding significant complexity. A clean, isolated driver subdirectory provides much better long-term maintainability without cluttering the existing class-compliant architecture.
I have successfully validated and stress-tested this driver across three distinct hardware architectures to ensure robustness regarding DMA, timing, and memory alignment:
-x86_64(Standard PC desktop environment)
- armhf (32-bit legacy environment on a Raspberry Pi 1B)
- arm64 (64-bit modern SoC environment on a Raspberry Pi 4)
Quoted 5 lines
I look forward to your review and feedback, and I am more than happy to make architectural adjustments as required.
Best regards,
Frank van de Pol
Hi Frank, nice to hear you again!
Through a quick glance, the driver design looks good and most of the code are fine, but there can be small details that matter. Could you take a look at Sashiko review?
https://sashiko.dev/#/patchset/20260609221643.3439698-2-fvdpol%40gmail.com
Not all items pointed there are useful, but the playback/capture stream spinlock should be taken, and the use of the devres-memory for URB buffer needs the re-consideration, too.
Last but not least, for the resubmission, please send to [email protected] (and Cc to [email protected]). Recently we use alsa-devel ML only for user-space stuff, and the kernel patches go to vger.
thanks,
Takashi
Quoted 10 lines · Takashi Iwai
Hi Frank, nice to hear you again!
Through a quick glance, the driver design looks good and most of the code are fine, but there can be small details that matter. Could you take a look at Sashiko review?
https://sashiko.dev/#/patchset/20260609221643.3439698-2-fvdpol%40gmail.comNot all items pointed there are useful, but the playback/capture stream spinlock should be taken, and the use of the devres-memory for URB buffer needs the re-consideration, too.
Hi Takashi,
Thank you for your review.
Great to hear that the architectural decision to make an isolated driver over shoehorning this into the standard driver is accepted.
I will have a look at the Sashiko review and pay extra attention to the points you've highlighted.
Hopefully I'll be able to submit version 2 of the patch by next week (after completing the multi-platform validation).
Quoted 5 lines
Last but not least, for the resubmission, please send to [email protected] (and Cc to [email protected]). Recently we use alsa-devel ML only for user-space stuff, and the kernel patches go to vger.
Thank you for pointing this out; I clearly missed that subtle yet important detail. Will keep learning :-)
Thanks,
Frank.