]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
wifi: rtw89: usb: add serial_number and uuid sysfs attributes for 0x28de:0x2432
authorJohnson Tsai <wenjie.tsai@realtek.com>
Fri, 29 May 2026 07:50:32 +0000 (15:50 +0800)
committerPing-Ke Shih <pkshih@realtek.com>
Wed, 3 Jun 2026 06:48:22 +0000 (14:48 +0800)
commit384cc80f30977d2ff095615f2241b21904499255
tree5126b76f007d12f9f1540396aeeaf046bc4f15bd
parent7554f6602a80471549df2c4e7b90b4d095b1d816
wifi: rtw89: usb: add serial_number and uuid sysfs attributes for 0x28de:0x2432

Expose the device's Serial Number (SN) and UUID from EFUSE via two
read-only sysfs attributes, `serial_number` and `uuid`, on the ieee80211
phy device under the `rtw89_usb` attribute group.

This hardware identification information is essential for user-space
applications to uniquely identify, track, and manage specific Wi-Fi
adapters. For example, in automated factory provisioning or device
management systems, user-space tools rely on the EFUSE serial number and
UUID to bind configurations to specific physical adapters. Currently,
standard wireless APIs do not expose this low-level hardware
information, making these sysfs nodes the only viable solution for
user space to extract this data.

The attributes are gated behind a new RTW89_QUIRK_HW_INFO_SYSFS quirk,
enabled only for the VID 0x28de / PID 0x2432 device via the
dev_id_quirks field in rtw89_driver_info.

Example usage from user-space:
  $ cat /sys/class/ieee80211/phy0/rtw89_usb/serial_number
  3642000123
  $ cat /sys/class/ieee80211/phy0/rtw89_usb/uuid
  aaec2b7c-0a55-4727-8de0-b30febccbbaa

Cc: Elliot Saba <sabae@valvesoftware.com>
Cc: Charles Lohr <charlesl@valvesoftware.com>
Signed-off-by: Johnson Tsai <wenjie.tsai@realtek.com>
Signed-off-by: Ping-Ke Shih <pkshih@realtek.com>
Link: https://patch.msgid.link/20260529075032.16807-3-pkshih@realtek.com
Documentation/ABI/testing/sysfs-class-ieee80211-rtw89 [new file with mode: 0644]
drivers/net/wireless/realtek/rtw89/core.h
drivers/net/wireless/realtek/rtw89/rtw8852c.c
drivers/net/wireless/realtek/rtw89/rtw8852c.h
drivers/net/wireless/realtek/rtw89/rtw8852cu.c
drivers/net/wireless/realtek/rtw89/usb.c