镜像站点 · 本页由第三方 GitHub 只读镜像提供，非 GitHub 官方站点，不接受任何登录或凭据输入。前往 github.com
Skip to content

btm: update device condition/info structs and add ipc wrappers for retrieving shortened versions #740

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fincs merged 5 commits into from
Oct 1, 2026
Merged

btm: update device condition/info structs and add ipc wrappers for retrieving shortened versions #740

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
eadd2e0
btm: adjust device condition/info struct names to match wiki
ndeadly Sep 28, 2026
1c448ad
btm: add key type field to 13.0.0 device info struct
ndeadly Sep 28, 2026
f5ec363
btm: update device condition/info structures and fill missing fields
ndeadly Sep 28, 2026
8864c36
btm: simplify version specific struct naming
ndeadly Sep 28, 2026
51a7ce3
btm: add commands for retrieving shortened versions of device conditi…
ndeadly Sep 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 32 additions & 7 deletions nx/include/switch/services/btm.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,18 +41,18 @@ Result btmAcquireDeviceConditionEvent(Event* out_event);

/**
* @brief GetDeviceCondition [1.0.0-12.1.0]
* @param[out] out \ref BtmDeviceCondition
* @param[out] out \ref BtmDeviceConditionList
*/
Result btmLegacyGetDeviceCondition(BtmDeviceCondition *out);
Result btmLegacyGetDeviceCondition(BtmDeviceConditionList *out);

/**
* @brief GetDeviceCondition [13.0.0+]
* @param[in] profile \ref BtmProfile, when not ::BtmProfile_None entries are only returned which match this profile.
* @param[out] out \ref BtmConnectedDeviceV13
* @param[out] out \ref BtmDeviceCondition
* @param[in] count Size of the out array in entries.
* @param[out] total_out Total output entries.
*/
Result btmGetDeviceCondition(BtmProfile profile, BtmConnectedDeviceV13 *out, size_t count, s32 *total_out);
Result btmGetDeviceCondition(BtmProfile profile, BtmDeviceCondition *out, size_t count, s32 *total_out);

/**
* @brief SetBurstMode
Expand Down Expand Up @@ -96,14 +96,20 @@ Result btmLegacyGetDeviceInfo(BtmDeviceInfoList *out);
/**
* @brief GetDeviceInfo [13.0.0+]
* @param[in] profile \ref BtmProfile, when not ::BtmProfile_None entries are only returned which match this profile.
* @param[out] out \ref BtmDeviceInfoV13
* @param[out] out \ref BtmDeviceInfo
* @param[in] count Size of the out array in entries.
* @param[out] total_out Total output entries.
*/
Result btmGetDeviceInfo(BtmProfile profile, BtmDeviceInfoV13 *out, size_t count, s32 *total_out);
Result btmGetDeviceInfo(BtmProfile profile, BtmDeviceInfo *out, size_t count, s32 *total_out);

/**
* @brief AddDeviceInfo
* @brief AddDeviceInfo [1.0.0-12.1.0]
* @param[in] info \ref BtmDeviceInfo
*/
Result btmLegacyAddDeviceInfo(const BtmDeviceInfoLegacy *info);

/**
* @brief AddDeviceInfo [13.0.0+]
* @param[in] info \ref BtmDeviceInfo
*/
Result btmAddDeviceInfo(const BtmDeviceInfo *info);
Expand Down Expand Up @@ -489,3 +495,22 @@ Result btmUnregisterAppletResourceUserId(u64 AppletResourceUserId);
*/
Result btmSetAppletResourceUserId(u64 AppletResourceUserId);

/**
* @brief GetShortenedDeviceInfo
* @note Only available on [13.0.0+].
* @param[in] profile \ref BtmProfile, when not ::BtmProfile_None entries are only returned which match this profile.
* @param[out] out \ref BtmShortenedDeviceInfo
* @param[in] count Size of the out array in entries.
* @param[out] total_out Total output entries.
*/
Result btmGetShortenedDeviceInfo(BtmProfile profile, BtmShortenedDeviceInfo *out, size_t count, s32 *total_out);

/**
* @brief GetShortenedDeviceCondition
* @note Only available on [14.0.0+].
* @param[in] profile \ref BtmProfile, when not ::BtmProfile_None entries are only returned which match this profile.
* @param[out] out \ref BtmShortenedDeviceCondition
* @param[in] count Size of the out array in entries.
* @param[out] total_out Total output entries.
*/
Result btmGetShortenedDeviceCondition(BtmProfile profile, BtmShortenedDeviceCondition *out, size_t count, s32 *total_out);
256 changes: 166 additions & 90 deletions nx/include/switch/services/btm_types.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,13 @@ typedef enum {
BtmTsiMode_Active = 255, ///< Active
} BtmTsiMode;

typedef enum {
BtmSniffMode_5ms = 0, ///< 5ms
BtmSniffMode_10ms = 1, ///< 10ms
BtmSniffMode_15ms = 2, ///< 15ms
BtmSniffMode_Active = 3, ///< Active
} BtmSniffMode;

/// SlotMode
typedef enum {
BtmSlotMode_2 = 0, ///< 2
Expand Down Expand Up @@ -78,12 +85,55 @@ typedef struct {
u8 link_key[0x10]; ///< LinkKey
} BtmLinkKey;

/// ZeroRetransmissionList
typedef struct {
u8 enabled_report_id_count; ///< EnabledReportIdCount
u8 enabled_report_id[0x10]; ///< Array of EnabledReportId.
} BtmZeroRetransmissionList;

/// HidDeviceCondition
typedef struct {
u32 sniff_mode; ///< \ref BtmSniffMode
u32 slot_mode; ///< \ref BtmSlotMode
bool is_burst_mode; ///< IsBurstMode
BtmZeroRetransmissionList zero_retransmission_list; ///< \ref BtmZeroRetransmissionList
u16 vid; ///< Vid
u16 pid; ///< Pid
} BtmHidDeviceCondition;

/// AudioDeviceCondition [13.0.0+]
typedef struct {
u8 unk_x0; ///< Unknown
} BtmAudioDeviceCondition;

/// HidDeviceInfo
typedef struct {
u16 vid; ///< Vid
u16 pid; ///< Pid
u16 vid; ///< Vid
u16 pid; ///< Pid
} BtmHidDeviceInfo;

/// AudioDeviceInfo [13.0.0+]
typedef struct {
union {
struct {
u8 source_volume; ///< SourceVolume
} v13; ///< [13.0.0-13.2.1]

struct {
u8 source_volume; ///< SourceVolume
bool is_first_audio_control_connection; ///< IsFirstAudioControlConnection
u8 unk_0x2; ///< Unknown
} v14; ///< [14.0.0-14.1.2]

struct {
u8 source_volume; ///< SourceVolume
u8 sink_volume; ///< SinkVolume
bool is_first_audio_control_connection; ///< IsFirstAudioControlConnection
bool unk_0x3; ///< Unknown
} v15; ///< [15.0.0+]
};
} BtmAudioDeviceInfo;

/// HostDeviceProperty
typedef struct {
union {
Expand All @@ -103,80 +153,101 @@ typedef struct {
};
} BtmHostDeviceProperty;

/// BtmConnectedDevice [1.0.0-12.1.0]
/// DeviceCondition [1.0.0-12.1.0]
typedef struct {
BtdrvAddress address;
u8 pad[2];
u32 unk_x8;
char name[0x20];
u8 unk_x2C[0x1C];
u16 vid;
u16 pid;
u8 unk_x4C[0x20];
} BtmConnectedDeviceV1;

/// BtmConnectedDevice [13.0.0+]
BtdrvAddress address; ///< \ref BtdrvAddress
u8 pad[2]; ///< Padding
u32 profile; ///< \ref BtmProfile
char name[0x20]; ///< BdName
union {
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceCondition hid; ///< \ref BtmHidDeviceCondition (Profile = Hid)
} profile_condition;
u8 reserved[0x20]; ///< Reserved
} BtmDeviceConditionLegacy;

/// DeviceCondition [13.0.0+]
typedef struct {
BtdrvAddress address;
u8 pad[2];
BtdrvAddress address; ///< \ref BtdrvAddress
u8 pad[2]; ///< Padding
u32 profile; ///< \ref BtmProfile
u8 unk_xC[0x40];
char name[0x20];
u8 unk_x6C[0xD9];
u8 pad2[3];
} BtmConnectedDeviceV13;
union {
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceCondition hid; ///< \ref BtmHidDeviceCondition (Profile = Hid)
BtmAudioDeviceCondition audio; ///< \ref BtmAudioDeviceCondition (Profile = Audio)
} profile_condition;
u8 reserved[0x20]; ///< Reserved
char name[0xF9]; ///< Name
u8 pad2[3]; ///< Padding
} BtmDeviceCondition;

/// DeviceCondition [1.0.0-5.0.2]
/// ShortenedDeviceCondition [14.0.0+]
typedef struct {
u32 unk_x0;
u32 unk_x4;
u8 unk_x8;
u8 unk_x9;
u8 max_count;
u8 connected_count;
BtmConnectedDeviceV1 devices[8];
} BtmDeviceConditionV100;

/// DeviceCondition [5.1.0-7.0.1]
BtdrvAddress address; ///< \ref BtdrvAddress
u8 pad[2]; ///< Padding
u32 profile; ///< \ref BtmProfile
union {
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceCondition hid; ///< \ref BtmHidDeviceCondition (Profile = Hid)
BtmAudioDeviceCondition audio; ///< \ref BtmAudioDeviceCondition (Profile = Audio)
} profile_condition;
u8 reserved[0x20]; ///< Reserved
char name[0x15]; ///< Name
u8 pad2[3]; ///< Padding
} BtmShortenedDeviceCondition;

/// DeviceConditionList [1.0.0-5.0.2]
typedef struct {
u32 unk_x0;
u32 unk_x4;
u8 unk_x8;
u8 unk_x9[2];
u8 max_count;
u8 connected_count;
u8 pad[3];
BtmConnectedDeviceV1 devices[8];
} BtmDeviceConditionV510;

/// DeviceCondition [8.0.0-8.1.1]
u32 bluetooth_mode; ///< \ref BtmBluetoothMode
u32 wlan_mode; ///< \ref BtmWlanMode
bool is_slot_saving_for_pairing; ///< IsSlotSavingForPairing
bool is_slot_saving; ///< IsSlotSaving
u8 connection_capacity; ///< ConnectionCapacity
u8 device_count; ///< DeviceCount
BtmDeviceConditionLegacy devices[8]; ///< Array of \ref BtmDeviceConditionLegacy with the above count.
} BtmDeviceConditionListV100;

/// DeviceConditionList [5.1.0-7.0.1]
typedef struct {
u32 unk_x0;
u32 unk_x4;
u8 unk_x8;
u8 unk_x9;
u8 max_count;
u8 connected_count;
BtmConnectedDeviceV1 devices[8];
} BtmDeviceConditionV800;

/// DeviceCondition [9.0.0-12.1.0]
u32 bluetooth_mode; ///< \ref BtmBluetoothMode
u32 wlan_mode; ///< \ref BtmWlanMode
bool is_slot_saving_for_pairing; ///< IsSlotSavingForPairing
bool is_slot_saving; ///< IsSlotSaving
u8 unk_0xA; ///< Unknown
u8 connection_capacity; ///< ConnectionCapacity
u8 device_count; ///< DeviceCount
u8 pad[3]; ///< Padding
BtmDeviceConditionLegacy devices[8]; ///< Array of \ref BtmDeviceConditionLegacy with the above count.
} BtmDeviceConditionListV510;

/// DeviceConditionList [8.0.0-8.1.1]
typedef struct {
u32 unk_x0;
u8 unk_x4;
u8 unk_x5;
u8 max_count;
u8 connected_count;
BtmConnectedDeviceV1 devices[8];
} BtmDeviceConditionV900;

/// DeviceCondition [1.0.0-12.1.0]
u32 bluetooth_mode; ///< \ref BtmBluetoothMode
u32 wlan_mode; ///< \ref BtmWlanMode
bool is_slot_saving_for_pairing; ///< IsSlotSavingForPairing
bool is_slot_saving; ///< IsSlotSaving
u8 connection_capacity; ///< ConnectionCapacity
u8 device_count; ///< DeviceCount
BtmDeviceConditionLegacy devices[8]; ///< Array of \ref BtmDeviceConditionLegacy with the above count.
} BtmDeviceConditionListV800;

/// DeviceConditionList [9.0.0-12.1.0]
typedef struct {
u32 wlan_mode; ///< \ref BtmWlanMode
bool is_slot_saving_for_pairing; ///< IsSlotSavingForPairing
bool is_slot_saving; ///< IsSlotSaving
u8 connection_capacity; ///< ConnectionCapacity
u8 device_count; ///< DeviceCount
BtmDeviceConditionLegacy devices[8]; ///< Array of \ref BtmDeviceConditionLegacy with the above count.
} BtmDeviceConditionListV900;

/// DeviceConditionList [1.0.0-12.1.0]
typedef union {
BtmDeviceConditionV100 v100;
BtmDeviceConditionV510 v510;
BtmDeviceConditionV800 v800;
BtmDeviceConditionV900 v900;
} BtmDeviceCondition;
BtmDeviceConditionListV100 v100;
BtmDeviceConditionListV510 v510;
BtmDeviceConditionListV800 v800;
BtmDeviceConditionListV900 v900;
} BtmDeviceConditionList;

/// DeviceSlotMode
typedef struct {
Expand All @@ -201,39 +272,50 @@ typedef struct {
u8 reserved[3]; ///< Reserved
u32 profile; ///< \ref BtmProfile
union {
u8 data[0x4]; ///< Empty (Profile = None)
BtmHidDeviceInfo hid_device_info; ///< \ref BtmHidDeviceInfo (Profile = Hid)
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceInfo hid; ///< \ref BtmHidDeviceInfo (Profile = Hid)
} profile_info;
u8 reserved2[0x1C]; ///< Reserved
} BtmDeviceInfoV1;
} BtmDeviceInfoLegacy;

/// DeviceInfo [13.0.0+]
typedef struct {
BtdrvAddress addr; ///< \ref BtdrvAddress
BtmClassOfDevice class_of_device; ///< ClassOfDevice
BtmLinkKey link_key; ///< LinkKey
u8 reserved[3]; ///< Reserved
u8 key_type; ///< KeyType
u8 reserved[2]; ///< Reserved
u32 profile; ///< \ref BtmProfile
union {
u8 data[0x4]; ///< Empty (Profile = None)
BtmHidDeviceInfo hid_device_info; ///< \ref BtmHidDeviceInfo (Profile = Hid)
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceInfo hid; ///< \ref BtmHidDeviceInfo (Profile = Hid)
BtmAudioDeviceInfo audio; ///< \ref BtmAudioDeviceInfo (Profile = Audio)
} profile_info;
u8 reserved2[0x1C]; ///< Reserved
char name[0xF9]; ///< Name
u8 pad[3]; ///< Padding
} BtmDeviceInfoV13;

/// DeviceInfo [1.0.0-13.0.0]
typedef union {
BtmDeviceInfoV1 v1;
BtmDeviceInfoV13 v13;
} BtmDeviceInfo;

/// ShortenedDeviceInfo [13.0.0+]
typedef struct {
BtdrvAddress addr; ///< \ref BtdrvAddress
BtmClassOfDevice class_of_device; ///< ClassOfDevice
BtmLinkKey link_key; ///< LinkKey
u8 key_type; ///< KeyType
u8 reserved[2]; ///< Reserved
u32 profile; ///< \ref BtmProfile
union {
u8 data[0x20]; ///< Empty (Profile = None)
BtmHidDeviceInfo hid; ///< \ref BtmHidDeviceInfo (Profile = Hid)
BtmAudioDeviceInfo audio; ///< \ref BtmAudioDeviceInfo (Profile = Audio)
} profile_info;
char name[0x15]; ///< Name
u8 pad[2]; ///< Padding
} BtmShortenedDeviceInfo;

/// DeviceInfoList
typedef struct {
u8 device_count; ///< DeviceCount
u8 reserved[3]; ///< Reserved
BtmDeviceInfoV1 devices[10]; ///< Array of \ref BtmDeviceInfoV1 with the above count.
u8 device_count; ///< DeviceCount
u8 reserved[3]; ///< Reserved
BtmDeviceInfoLegacy devices[10]; ///< Array of \ref BtmDeviceInfoLegacy with the above count.
} BtmDeviceInfoList;

/// DeviceProperty
Expand All @@ -249,12 +331,6 @@ typedef struct {
BtmDeviceProperty devices[15]; ///< Array of \ref BtmDeviceProperty.
} BtmDevicePropertyList;

/// ZeroRetransmissionList
typedef struct {
u8 enabled_report_id_count; ///< EnabledReportIdCount
u8 enabled_report_id[0x10]; ///< Array of EnabledReportId.
} BtmZeroRetransmissionList;

/// GattClientConditionList
typedef struct {
u8 unk_x0[0x74]; ///< Unknown
Expand Down
Loading
Loading