From nobody Sat Apr 4 01:32:59 2026 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 05B7C2ED17B for ; Sat, 21 Mar 2026 12:52:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.171 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774097580; cv=none; b=js65BzGHR3OLlSMM+4jnBVtKhwaspIFQ5lACNyefGF057tRhtqIDJHTM8DuWvsFa1jPqqanCWK2ls9cnLU2P1R0GBTY/ci6ulkqx+LGJ4BBUdRBa6KZDwrtk5M19gf7oEGE/sTmcNQvxeCrcnB0obZlLzc8VN/RQLdMs1Hb7LP8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774097580; c=relaxed/simple; bh=sGREo2lCnMvgHUNpx+aa4USCEqKuOLpnkIbOEyl36D8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=StflWntNtXmitA5JbxomSQcdng7nRTEyuAk2AOAUZqWO1xcdXe56lo4LR8guHhssNWv9h1VXXzJjifgIVpuWprTABT2jnQuvih8dT8wYs8bC/RpbwI8YdrX2cW3TyUypcmYJGb+bow4XgiMT+urTDFKMreKpHSg82zr2/cGCyn8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=PSWT431/; arc=none smtp.client-ip=209.85.214.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="PSWT431/" Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-2aae4816912so9404225ad.2 for ; Sat, 21 Mar 2026 05:52:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1774097578; x=1774702378; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=RMzDWQMEvY2hUXHfVPDP28vF18R5tNL2pT9Gw8m7UTo=; b=PSWT431/ilk0jaR1V8KYxGy8QezHerx5cKMu96SZBhG/wi40p7SXIorvQsPsexvbWH A6/vV9lOm3oajN45SznnzMB4rw4JT5Tz3i5UTpSfMD6/KfH5r61G0l+4O/Vyl3OVhrsZ zhwy/Mga7gEy1WTKJ2DuwM9Ddfns21CIXI38on5yZpxODDc5R63MmNivU82nlTNVuxaz MYvFtk3JJlzgWVnBr5SY/2s8m6D6ttJmzMKz6ROFOuBcLHhagXDXbU6WuAmJEK810vSD +g0svt3BSJe4PfhfzoBTjCxedh10ozqsNwgC2x8SUF0EWQBIojWyw/xHUHtHmvEdX1RY xjVA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1774097578; x=1774702378; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=RMzDWQMEvY2hUXHfVPDP28vF18R5tNL2pT9Gw8m7UTo=; b=lLcw8R8lBeMxo3li8aCiO6znv6cCgPHpNBvoTaBAeScTcKdE/xW8NbSP4+RoC9tz1W 80coXArv4nfh7N/TZiaE+uN3L0a3Ty+73sNm2JF3z06LtjkPs3pZki0FI0sqdfRyJ0sd T2AAsGbZUpwk5BuYP4nGHDMjWOUu4pk63a92UIkcCf9mQUDCv6dhQoaepLlTejtQxsui qDmiPKRFRwd7b6esdCnwScDvxgSD9nTzVe4A0jzIcO+pA4iV54zh7S+4YkAWjkzEF7nt 9dUv7167BdjBvwKlgXbj9TB0i9KPOLPnJtcXQ8YC4MN2wX+e7C05PFPa/zGsFkuxcE9g bFFA== X-Forwarded-Encrypted: i=1; AJvYcCV0fCwvFjwCYnG9jVK3w9DV5lcphKbYhvBXintJSrkVUja0bOWMxwZsAQ9LYzyk268lXTLylsAwlgusyKc=@vger.kernel.org X-Gm-Message-State: AOJu0YzammyAPtvaK0/J5438raDtjPiWMkazVL2OZAMur5gjT7ixfzHV JD3cARgBUEyCwOcIneWGAB7tbf6IKTGJBJ9eUgvW+LexKDoYqAuNGDTh X-Gm-Gg: ATEYQzxto79TMo0Va953N092SGWjjzjfTEvI8OwAUDfV5x/JMJquFQ+2hkSA05+ag0P 4Fo0Fw56SHvLvzLUlTO1JbzLkIWiAahBn9hTU6IP/9NVM9m/g8cKhH2tj+nsAncdsTdwjm6sow2 rTRA9iQqa7+0NCHcg3gYdyXPrw/S2MYIOYy8wgVTMC8bbi3Kz3J5Zob+0bpPu9EyxsutLErsq3Y 2akpJS6Blt2jFuD2GPeDvg4V5YQ52XxP83PKg0WnZmmqP6kASbw4WQu5OLgEaAD5BqmWqSRwgrT B4T/LvYpBNts/5Mvt7n/JZy5T7rPAACntm4luLTmr3UAqFBvuNGExazP33d013IIOcZ/z/t/oQ5 udSlsoOREHkprgIE7sqScn1aFpowQ9aPJlp8UEe4d/xOdvJDLCYgGcAd7I3c8XHIA4bop7xg0KB aiyo/gZX48inr4M3B/LKPM/XMHGfESCKWVgAS7/R7gE871zfFdqmVXRBpZrWMZ6Vl9MXcQujK9d QqY5bpcZUVbvDoaZel36I69xuLILuRgOKBklNc00CqxR7Y= X-Received: by 2002:a17:903:124f:b0:2b0:659e:97bb with SMTP id d9443c01a7336-2b0827cf462mr64016495ad.46.1774097578025; Sat, 21 Mar 2026 05:52:58 -0700 (PDT) Received: from Slifer ([2001:4454:704:ab00:6b46:1f77:2fd9:fc56]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b08354772fsm51833785ad.28.2026.03.21.05.52.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Mar 2026 05:52:57 -0700 (PDT) From: Karl Cayme To: jikos@kernel.org, bentiss@kernel.org Cc: linux-input@vger.kernel.org, linux-kernel@vger.kernel.org, linuxhid@cosmicgizmosystems.com, Karl Cayme Subject: [PATCH v2] HID: rakk: add support for Rakk Dasig X side buttons Date: Sat, 21 Mar 2026 20:42:49 +0800 Message-ID: <20260321124759.608492-1-kcayme@gmail.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <3284f00a-bea0-4141-a009-b367f527c466@cosmicgizmosystems.com> References: <3284f00a-bea0-4141-a009-b367f527c466@cosmicgizmosystems.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The Rakk Dasig X gaming mouse has a faulty HID report descriptor that declares USAGE_MAXIMUM=3D3 (buttons 1-3) while actually sending 5 button bits (REPORT_COUNT=3D5). This causes the kernel to ignore side buttons (buttons 4 and 5). Fix by patching the descriptor to set USAGE_MAXIMUM=3D5 in the report_fixup callback. The mouse uses Telink vendor ID 0x248a with three product IDs for USB direct (0xfb01), wireless dongle (0xfa02), and Bluetooth (0x8266) connection modes. All three variants have the same bug at byte offset 17. Suggested-by: Terry Junge =20 Signed-off-by: Karl Cayme --- Hi, Thanks for the feedback. I updated the patch with your suggestion to check PIDs. Best, Karl v2 Changes: - included PID checking alongside descriptor size in report_fixup drivers/hid/Kconfig | 9 +++++ drivers/hid/Makefile | 1 + drivers/hid/hid-ids.h | 5 +++ drivers/hid/hid-rakk.c | 75 ++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 90 insertions(+) create mode 100644 drivers/hid/hid-rakk.c diff --git a/drivers/hid/Kconfig b/drivers/hid/Kconfig index c1d9f7c6a5f2..11c48cb1c6a6 100644 --- a/drivers/hid/Kconfig +++ b/drivers/hid/Kconfig @@ -755,6 +755,15 @@ config HID_MEGAWORLD_FF Say Y here if you have a Mega World based game controller and want to have force feedback support for it. =20 +config HID_RAKK + tristate "Rakk support" + help + Support for Rakk gaming peripherals. + + Fixes the HID report descriptor of the Rakk Dasig X mouse, + which declares USAGE_MAXIMUM=3D3 (buttons 1-3) while actually + sending 5 button bits. This causes side buttons to be ignored. + config HID_REDRAGON tristate "Redragon keyboards" default !EXPERT diff --git a/drivers/hid/Makefile b/drivers/hid/Makefile index e01838239ae6..7800613f5b2b 100644 --- a/drivers/hid/Makefile +++ b/drivers/hid/Makefile @@ -113,6 +113,7 @@ obj-$(CONFIG_HID_PLANTRONICS) +=3D hid-plantronics.o obj-$(CONFIG_HID_PLAYSTATION) +=3D hid-playstation.o obj-$(CONFIG_HID_PRIMAX) +=3D hid-primax.o obj-$(CONFIG_HID_PXRC) +=3D hid-pxrc.o +obj-$(CONFIG_HID_RAKK) +=3D hid-rakk.o obj-$(CONFIG_HID_RAPOO) +=3D hid-rapoo.o obj-$(CONFIG_HID_RAZER) +=3D hid-razer.o obj-$(CONFIG_HID_REDRAGON) +=3D hid-redragon.o diff --git a/drivers/hid/hid-ids.h b/drivers/hid/hid-ids.h index 3e299a30dcde..68fab837e8b3 100644 --- a/drivers/hid/hid-ids.h +++ b/drivers/hid/hid-ids.h @@ -1369,6 +1369,11 @@ #define USB_DEVICE_ID_SYNAPTICS_ACER_SWITCH5_017 0x73f6 #define USB_DEVICE_ID_SYNAPTICS_ACER_SWITCH5 0x81a7 =20 +#define USB_VENDOR_ID_TELINK 0x248a +#define USB_DEVICE_ID_TELINK_RAKK_DASIG_X 0xfb01 +#define USB_DEVICE_ID_TELINK_RAKK_DASIG_X_DONGLE 0xfa02 +#define USB_DEVICE_ID_TELINK_RAKK_DASIG_X_BT 0x8266 + #define USB_VENDOR_ID_TEXAS_INSTRUMENTS 0x2047 #define USB_DEVICE_ID_TEXAS_INSTRUMENTS_LENOVO_YOGA 0x0855 =20 diff --git a/drivers/hid/hid-rakk.c b/drivers/hid/hid-rakk.c new file mode 100644 index 000000000000..c59ea47b8996 --- /dev/null +++ b/drivers/hid/hid-rakk.c @@ -0,0 +1,75 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * HID driver for Rakk devices + * + * Copyright (c) 2026 Karl Cayme + * + * The Rakk Dasig X gaming mouse has a faulty HID report descriptor that + * declares USAGE_MAXIMUM =3D 3 (buttons 1-3) while actually sending 5 bu= tton + * bits (REPORT_COUNT =3D 5). This causes the kernel to ignore side butto= ns + * (buttons 4 and 5). This driver fixes the descriptor so all 5 buttons + * are properly recognized across 3 modes (wired, dongle, and Bluetooth). + */ + +#include +#include +#include +#include "hid-ids.h" + +/* + * The faulty byte is at offset 17 in the report descriptor for all three + * connection modes (USB direct, wireless dongle, and Bluetooth). + * + * Bytes 16-17 are: 0x29 0x03 (USAGE_MAXIMUM =3D 3) + * The fix changes byte 17 to 0x05 (USAGE_MAXIMUM =3D 5). + * + * Original descriptor bytes 0-17: + * 05 01 09 02 a1 01 85 01 09 01 a1 00 05 09 19 01 29 03 + * ^^ + * Should be 0x05 to declare 5 buttons instead of 3. + */ +#define RAKK_RDESC_USAGE_MAX_OFFSET 17 +#define RAKK_RDESC_USAGE_MAX_ORIG 0x03 +#define RAKK_RDESC_USAGE_MAX_FIXED 0x05 +#define RAKK_RDESC_USB_SIZE 193 +#define RAKK_RDESC_DONGLE_SIZE 150 +#define RAKK_RDESC_BT_SIZE 89 + +static const __u8 *rakk_report_fixup(struct hid_device *hdev, __u8 *rdesc, + unsigned int *rsize) +{ + if (((*rsize =3D=3D RAKK_RDESC_USB_SIZE && + hdev->product =3D=3D USB_DEVICE_ID_TELINK_RAKK_DASIG_X) || + (*rsize =3D=3D RAKK_RDESC_DONGLE_SIZE && + hdev->product =3D=3D USB_DEVICE_ID_TELINK_RAKK_DASIG_X_DONGLE) || + (*rsize =3D=3D RAKK_RDESC_BT_SIZE && + hdev->product =3D=3D USB_DEVICE_ID_TELINK_RAKK_DASIG_X_BT)) && + rdesc[RAKK_RDESC_USAGE_MAX_OFFSET] =3D=3D RAKK_RDESC_USAGE_MAX_ORIG) { + hid_info(hdev, "fixing Rakk Dasig X button count (3 -> 5)\n"); + rdesc[RAKK_RDESC_USAGE_MAX_OFFSET] =3D RAKK_RDESC_USAGE_MAX_FIXED; + } + + return rdesc; +} + +static const struct hid_device_id rakk_devices[] =3D { + { HID_USB_DEVICE(USB_VENDOR_ID_TELINK, + USB_DEVICE_ID_TELINK_RAKK_DASIG_X) }, + { HID_USB_DEVICE(USB_VENDOR_ID_TELINK, + USB_DEVICE_ID_TELINK_RAKK_DASIG_X_DONGLE) }, + { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_TELINK, + USB_DEVICE_ID_TELINK_RAKK_DASIG_X_BT) }, + { } +}; +MODULE_DEVICE_TABLE(hid, rakk_devices); + +static struct hid_driver rakk_driver =3D { + .name =3D "rakk", + .id_table =3D rakk_devices, + .report_fixup =3D rakk_report_fixup, +}; +module_hid_driver(rakk_driver); + +MODULE_DESCRIPTION("HID driver for Rakk Dasig X mouse - fix side button su= pport"); +MODULE_LICENSE("GPL"); +MODULE_AUTHOR("Karl Cayme"); --=20 2.53.0