Skip to contentSkip to conversation

ALSA: usb: Add support for Reloop Jockey 3 DJ controllers

PATCH Superseded Frank van de Pol 2 participants 4 messages Jun 9 – Jun 10 Sound

v1 of 5 Superseded Latest is v5 →

lore
Share & tools
lore
#0 lore raw

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
#1 lore raw

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
index 9ec290e38b44..c73a2bcec584 100644
@@ -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
index b4588915efa1..d7edfbaf099b 100644
@@ -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
index e62794a87e73..1f045c00dbc9 100644
@@ -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
new file mode 100644
index 000000000000..0e397a987a11
@@ -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
new file mode 100644
index 000000000000..833a5766985e
@@ -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
\ No newline at end of file
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
new file mode 100644
index 000000000000..e756f54d8ca8
@@ -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
#2 lore raw
In reply to Frank van de Pol
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

#3 lore raw
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.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.

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.