2,956
edits
Changes
Jump to navigation
Jump to search
Line 6:
Line 6: − These btm services with BLE only allow connecting to devices which have a [[#GattService]] with a certain custom UUID present.+ Line 40:
Line 40: − + Line 52:
Line 52: − + − + Line 134:
Line 134: − + − + − + − + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − + − + + + − + − + + + − + − + + + + + + + + + + + + + + + + + + + + + + + − + − + − + − + + + − + + + − + − + − + Line 202:
Line 276: − + − + − + − + − + − + − + − + − + + + + + + + − + − + + + + + Line 244:
Line 328: − + − + + + + + Line 255:
Line 343: − + + + + + + + Line 261:
Line 355: − + − + − + − + − + − + Line 292:
Line 386: − + − + − + − + − + − + − + − + Line 328:
Line 422: − + Line 337:
Line 431: − + Line 344:
Line 438: − + Line 351:
Line 445: − + Line 358:
Line 452: − + − + − + − + − + − + − + − + − − == Cmd60 == − − + − Takes a 0x44-byte input struct, no output.+ − This is used by [[HID_services|hid]] at some point when there's new hid connections, leaving "Change Grip/Order" in the [[Controller_Applet]] with new connections also triggers it via [[HID_services|hid]] at some point.+ + − * Goes through multiple arrays of [[#BdAddress|BdAddress]].+ − ** First array: − *** Validates the [[#BdAddress|BdAddress]] with state, skipping it if not found. − *** Calls the SetTsi wrapper func described below, with the above [[#BdAddress|BdAddress]] and tsi=0xFF (Exit). If this returns false, [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used with the [[#BdAddress|BdAddress]]. − ** Second array: − *** Validates the [[#BdAddress|BdAddress]] with state, skipping it if not found. − *** Uses [[Bluetooth_Driver_services#SetBleConnectionParameter|SetBleConnectionParameter]] with bool=true. Then the required EventInfo is loaded, {...}. − ** Then it goes through the first array again, except here it does the following: − *** Calls the same func for validating the [[#BdAddress|BdAddress]] with state, skipping it if not found. It is also skipped if the u32 at Address+0x8 is value 0x3. − *** Determines what Tsi value to use, on failure [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used and the loop is continued. − *** Calls the SetTsi wrapper func described below, with the [[#BdAddress|BdAddress]] and the above Tsi value. If this returns false, [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used with the [[#BdAddress|BdAddress]]. − ** It then goes through various arrays again for updating state. − ** {...} − The SetTsi wrapper func is implemented as follows:+ − * Uses [[Bluetooth_Driver_services#SetTsi|SetTsi]], on failure true is returned.+ − * Gets the required EventInfo, returning false if a match wasn't found / EventInfo status indicates failure. True is returned for success. − − − − + − + − + − + Line 442:
Line 518: − + Line 461:
Line 537: + + + + + + + + + + − + Line 475:
Line 561: − + − + + + − + − + − + − + − + − + − + − + Line 525:
Line 613: − + Line 546:
Line 634: − + Line 553:
Line 641: + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 565:
Line 681: − + Line 573:
Line 689: − + − + − + − + − + Line 600:
Line 716: − + Line 611:
Line 727: − + − + Line 645:
Line 761: − + − + Line 657:
Line 773: − + Line 675:
Line 791: − + − + − + − + Line 700:
Line 816: − + − + Line 715:
Line 831: − + Line 725:
Line 841: − + − + − + − + − + − + − + − + − + − + − + Line 782:
Line 898: − + − + − + Line 799:
Line 915: − + − + − + − + − + Line 826:
Line 942: − + − + − + Line 946:
Line 1,062: + + + + + + + + + + + + + + + + Line 960:
Line 1,092: + + Line 974:
Line 1,108: + + + + + + + + + + + + + + + + + + + + + + + + Line 992:
Line 1,150: + + − + Line 1,007:
Line 1,167: − + Line 1,024:
Line 1,184: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 1,050:
Line 1,262: + + + + Line 1,065:
Line 1,281: − + Line 1,096:
Line 1,312: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 1,195:
Line 1,443: + + + + + + + + + + + + + + + + + + + + + + + +
no edit summary
This has max_sessions 6. IPC is handled by 2 threads shared with all services.
This has max_sessions 6. IPC is handled by 2 threads shared with all services.
With BLE connections, the remote device may receive ATT_READ_BY_GROUP_TYPE_REQ before the BLE connection-complete HCI event. One workaround for this is manually sending the response with HCI, after the connection is ready.
The output bool from all of these btm* service get-event cmds indicates whether the Event was successfully returned, user-processes will Abort when this is 0.
The output bool from all of these btm* service get-event cmds indicates whether the Event was successfully returned, user-processes will Abort when this is 0.
| 12 || [[#IncreaseDeviceInfoOrder]]
| 12 || [[#IncreaseDeviceInfoOrder]]
|-
|-
| 13 || [[#LlrNotify]]
| 13 || [9.0.0+] TriggerConnection ([1.0.0-8.1.1] [[#LlrNotify]])
|-
|-
| 14 || [[#EnableRadio]]
| 14 || [[#EnableRadio]]
| 18 || [2.0.0+] [[#AcquireAwakeReqEvent]]
| 18 || [2.0.0+] [[#AcquireAwakeReqEvent]]
|-
|-
| 19 || [4.0.0+] [[#AcquireLlrStateEvent]]
| 19 || [9.0.0+] AcquireConnectionTriggerEvent ([4.0.0-8.1.1] [[#AcquireLlrStateEvent]])
|-
|-
| 20 || [4.0.0+] [[#IsLlrStarted]]
| 20 || [9.0.0+] IsConnectionTriggered ([4.0.0-8.1.1] [[#IsLlrStarted]])
|-
|-
| 21 || [4.0.0+] [[#EnableSlotSaving]]
| 21 || [4.0.0+] [[#EnableSlotSaving]]
| 59 ([5.0.0-5.0.2] 42) || [5.0.0+] [[#SetAppletResourceUserId]]
| 59 ([5.0.0-5.0.2] 42) || [5.0.0+] [[#SetAppletResourceUserId]]
|-
|-
| 60 || [8.0.0+]
| 60 || [8.0.0+] [[#AcquireBleConnectionParameterUpdateEvent]]
|-
|-
| 61 || [8.0.0+]
| 61 || [8.0.0+] [[#SetCeLength]]
|-
|-
| 62 || [9.0.0+]
| 62 || [9.0.0+] [[#EnsureSlotExpansion]]
|-
|-
| 63 || [9.0.0+]
| 63 || [9.0.0+] [[#IsSlotExpansionEnsured]]
|-
|-
| 64 || [10.0.0+]
| 64 || [10.0.0+] [[#CancelConnectionTrigger]]
|-
| 65 || [13.0.0+] GetConnectionCapacity
|-
| 66 || [13.0.0+] GetWlanMode
|-
| 67 || [13.0.0+] IsSlotSavingEnabled
|-
| 68 || [13.0.0+] IsSlotSavingForPairingEnabled
|-
| 69 || [13.0.0+] AcquireAudioDeviceConnectionEvent
|-
| 70 || [13.0.0+] GetConnectedAudioDevices
|-
| 71 || [13.0.0+] SetAudioSourceVolume
|-
| 72 || [13.0.0+] GetAudioSourceVolume
|-
| 73 || [13.0.0+] RequestAudioDeviceConnectionRejection
|-
| 74 || [13.0.0+] CancelAudioDeviceConnectionRejection
|-
| 75 || [13.0.0+] GetPairedAudioDevices
|-
| 76 || [13.1.0+] SetWlanModeWithOption
|-
| 100 || [13.0.0+] AcquireConnectionDisallowedEvent
|-
| 101 || [13.0.0+] GetUsecaseViolationFactor
|-
| 110 || [13.0.0+] GetShortenedDeviceInfo
|-
| 111 || [13.0.0+] AcquirePairingCountUpdateEvent
|-
| 112 || [14.0.0-14.1.2]
|-
| 113 || [14.0.0-14.1.2]
|-
| 114 || [14.0.0+] IsFirstAudioControlConnection
|-
| 115 || [14.0.0+] GetShortenedDeviceCondition
|-
| 116 || [15.0.0+] SetAudioSinkVolume
|-
| 117 || [15.0.0+] GetAudioSinkVolume
|}
|}
== GetState ==
== GetState ==
No input, returns an output [[#BtmState]].
No input. Returns an output [[#BtmState]].
== GetHostDeviceProperty ==
== GetHostDeviceProperty ==
No input, returns an output [[#HostDeviceProperty]].
No input. Returns an output [[#HostDeviceProperty]].
[13.0.0+] Takes a type-0x1A output buffer containing a [[#HostDeviceProperty]]. No output.
This gets the previously initialized [[#HostDeviceProperty]].
This gets the previously initialized [[#HostDeviceProperty]].
== AcquireDeviceConditionEvent ==
== AcquireDeviceConditionEvent ==
No input, returns an output Event handle with EventClearMode=1.
No input. Returns an output Event handle with EventClearMode=1.
[3.0.0+] Now returns an additional output bool.
[3.0.0+] Now returns an additional output bool.
== GetDeviceCondition ==
== GetDeviceCondition ==
Takes a type-0x1A output buffer containing a 0x368-byte struct.
Takes a type-0x1A output buffer containing a [[#DeviceConditionList]]. No output.
[13.0.0+] Takes an input u32 [[#Profile]], a type-0xA output buffer containing an array of [[#DeviceCondition]], returns a s32 for total output entries. When [[#Profile]] is non-zero, entries are only returned with a matching [[#Profile]].
== SetBurstMode ==
== SetBurstMode ==
Takes an input [[#BdAddress|BdAddress]] and a bool, no output.
Takes an input [[#BdAddress|BdAddress]] and a bool. No output.
== SetSlotMode ==
== SetSlotMode ==
Takes a type-0x19 input buffer containing a [[#DeviceSlotModeList]], no output.
Takes a type-0x19 input buffer containing a [[#DeviceSlotModeList]]. No output.
Sends a request which is then handled as follows:
* Calls a func for getting the data from [[#DeviceSlotModeList]] etc for passing to another func, that func then does the following:
* Goes through multiple arrays of [[#BdAddress|BdAddress]].
** First array:
*** Validates the [[#BdAddress|BdAddress]] with state, skipping it if not found.
*** Calls the SetTsi wrapper func described below, with the above [[#BdAddress|BdAddress]] and tsi=0xFF (Exit). If this returns false, [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used with the [[#BdAddress|BdAddress]].
** Second array:
*** Validates the [[#BdAddress|BdAddress]] with state, skipping it if not found.
*** Uses [[Bluetooth_Driver_services#SetBleConnectionParameter|SetBleConnectionParameter]] with bool=true. Then the required EventInfo is loaded, {...}.
** Then it goes through the first array again, except here it does the following:
*** Calls the same func for validating the [[#BdAddress|BdAddress]] with state, skipping it if not found. It is also skipped if the u32 at Address+0x8 is value 0x3.
*** Determines what Tsi value to use, on failure [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used and the loop is continued.
*** Calls the SetTsi wrapper func described below, with the [[#BdAddress|BdAddress]] and the above Tsi value. If this returns false, [[Bluetooth_Driver_services#CloseHidConnection|CloseHidConnection]] is used with the [[#BdAddress|BdAddress]].
** It then goes through various arrays again for updating state.
** {...}
Note that the above func is also called from various other funcs as well. An [[Bluetooth_Driver_services#HidEventType|event]] for opening a hid connection also triggers it in some cases.
The SetTsi wrapper func is implemented as follows:
* Uses [[Bluetooth_Driver_services#SetTsi|SetTsi]], on failure true is returned.
* Gets the required EventInfo, returning false if a match wasn't found / EventInfo status indicates failure. True is returned for success.
== SetBluetoothMode ==
== SetBluetoothMode ==
Takes an input [[#BluetoothMode]], no output.
Takes an input [[#BluetoothMode]]. No output.
== SetWlanMode ==
== SetWlanMode ==
Takes an input [[#WlanMode]], no output.
Takes an input [[#WlanMode]]. No output.
== AcquireDeviceInfoEvent ==
== AcquireDeviceInfoEvent ==
No input, returns an output Event handle with EventClearMode=1.
No input. Returns an output Event handle with EventClearMode=1.
[3.0.0+] Now returns an additional output bool.
[3.0.0+] Now returns an additional output bool.
== GetDeviceInfo ==
== GetDeviceInfo ==
Takes a type-0x1A output buffer containing a [[#DeviceInfoList]].
Takes a type-0x1A output buffer containing a [[#DeviceInfoList]]. No output.
[13.0.0+] Takes an input u32 [[#Profile]], a type-0xA output buffer containing an array of [[#DeviceInfo]], returns a s32 for total output entries. When [[#Profile]] is non-zero, entries are only returned with a matching [[#Profile]].
== AddDeviceInfo ==
== AddDeviceInfo ==
Takes an input [[#DeviceInfo]], no output.
Takes an input [[#DeviceInfo]]. No output.
[13.0.0+] Takes a type-0x19 input buffer containing a [[#DeviceInfo]], no output.
== RemoveDeviceInfo ==
== RemoveDeviceInfo ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
== IncreaseDeviceInfoOrder ==
== IncreaseDeviceInfoOrder ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
== LlrNotify ==
== LlrNotify ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
[9.0.0+] Takes an input [[#BdAddress|BdAddress]] and a s32, no output.
[9.0.0+] Takes an input [[#BdAddress|BdAddress]] and a s32, no output.
== HidDisconnect ==
== HidDisconnect ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
== HidSetRetransmissionMode ==
== HidSetRetransmissionMode ==
Takes an input [[#BdAddress|BdAddress]] and a type-0x19 input buffer containing a [[#ZeroRetransmissionList]], no output.
Takes an input [[#BdAddress|BdAddress]] and a type-0x19 input buffer containing a [[#ZeroRetransmissionList]]. No output.
== AcquireAwakeReqEvent ==
== AcquireAwakeReqEvent ==
No input, returns an output Event handle with EventClearMode=1.
No input. Returns an output Event handle with EventClearMode=1.
[3.0.0+] Now returns an additional output bool.
[3.0.0+] Now returns an additional output bool.
== AcquireLlrStateEvent ==
== AcquireLlrStateEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== IsLlrStarted ==
== IsLlrStarted ==
No input, returns an output bool.
No input. Returns an output bool.
== EnableSlotSaving ==
== EnableSlotSaving ==
Takes an input bool, no output.
Takes an input bool. No output.
== ProtectDeviceInfo ==
== ProtectDeviceInfo ==
Takes an input [[#BdAddress|BdAddress]] and a bool, no output.
Takes an input [[#BdAddress|BdAddress]] and a bool. No output.
== AcquireBleScanEvent ==
== AcquireBleScanEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== GetBleScanParameterGeneral ==
== GetBleScanParameterGeneral ==
Takes an input u16 ParameterId, returns a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]].
Takes an input u16 ParameterId. Returns a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]].
The u16 must be value 0x1 or 0xFFFF.
The u16 must be value 0x1 or 0xFFFF.
[[HID_services|hid]] uses value 0x1 for Palma.
The output BleAdvertisePacketParameter starting at +0x2 contains (CompanyId is 0x0553 for Nintendo for both of these):
* ParameterId 0x1: <code>000100000100</code>
* ParameterId 0xFFFF: <code>ADDE00EFBE00</code>
== GetBleScanParameterSmartDevice ==
== GetBleScanParameterSmartDevice ==
Takes an input u16 ParameterId, returns a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]].
Takes an input u16 ParameterId. Returns a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]].
The u16 must be value 0x2. The first 4-bytes of output is always 0 since it's not set.
The u16 must be value 0x2. The first 4-bytes of output is always 0 since it's not set.
== StartBleScanForGeneral ==
== StartBleScanForGeneral ==
Takes a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], no output.
Takes a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. No output.
This eventually uses [[Bluetooth_Driver_services#AddBleScanFilterCondition|AddBleScanFilterCondition]], where the the passed BleAdvertiseFilter is generated from the input BleAdvertisePacketParameter.
This also uses [[Bluetooth_Driver_services#SetBleScanParameter|SetBleScanParameter]].
== StopBleScanForGeneral ==
== StopBleScanForGeneral ==
== GetBleScanResultsForGeneral ==
== GetBleScanResultsForGeneral ==
Takes a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], returns an output u8 total_out.
Takes a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]]. Returns an output u8 total_out.
The max array entries is 10.
The max array entries is 10.
== StartBleScanForPaired ==
== StartBleScanForPaired ==
Takes a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], no output.
Takes a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. No output.
This eventually uses [[Bluetooth_Driver_services#AddBleScanFilterCondition|AddBleScanFilterCondition]], where the the passed BleAdvertiseFilter is generated from the input BleAdvertisePacketParameter.
This also uses [[Bluetooth_Driver_services#SetBleScanParameter|SetBleScanParameter]].
== StopBleScanForPaired ==
== StopBleScanForPaired ==
== StartBleScanForSmartDevice ==
== StartBleScanForSmartDevice ==
Takes a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], no output.
Takes a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]]. No output.
This eventually uses [[Bluetooth_Driver_services#AddBleScanFilterCondition|AddBleScanFilterCondition]], where the the passed BleAdvertiseFilter is generated from the input GattAttributeUuid.
This also uses [[Bluetooth_Driver_services#SetBleScanParameter|SetBleScanParameter]].
The [[Bluetooth_Driver_services#BleAdvertiseFilter|BleAdvertiseFilter]] is generated as follows: CondType = 7(ServiceUuid128), CondDataSize = 0x11. CondData: {128bit UUID copied from the [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]] (size field ignored), then an u8 with value 0x0 (unused)}. MaskSize = 0x10, Mask = {all 0xFF}.
== StopBleScanForSmartDevice ==
== StopBleScanForSmartDevice ==
== GetBleScanResultsForSmartDevice ==
== GetBleScanResultsForSmartDevice ==
Takes a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], returns an output u8 total_out.
Takes a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]]. Returns an output u8 total_out.
The max array entries is 10.
The max array entries is 10.
== AcquireBleConnectionEvent ==
== AcquireBleConnectionEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== BleConnect ==
== BleConnect ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
An error is thrown if the [[#BdAddress|BdAddress]] is already connected (listed in the [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]] from [[#BleGetConnectionState]]). An error is thrown if 4 [[#BleGetConnectionState|devices]] are already connected.
An error is thrown if the [[#BdAddress|BdAddress]] is already connected (listed in the [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]] from [[#BleGetConnectionState]]). An error is thrown if 4 [[#BleGetConnectionState|devices]] are already connected.
== BleOverrideConnection ==
== BleOverrideConnection ==
Takes an input u32, no output.
Takes an input u32 ConnectionHandle. No output.
The u32 is the same as the param for [[#BleDisconnect]].
The u32 is the same as the param for [[#BleDisconnect]].
== BleDisconnect ==
== BleDisconnect ==
Takes an input u32 ConnectionHandle, no output.
Takes an input u32 ConnectionHandle. No output.
The u32 must match a ConnectionHandle in a [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]] from [[#BleGetConnectionState]]. [5.1.0+] 0xFFFFFFFF is invalid.
The u32 must match a ConnectionHandle in a [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]] from [[#BleGetConnectionState]]. [5.1.0+] 0xFFFFFFFF is invalid.
== BleGetConnectionState ==
== BleGetConnectionState ==
Takes a type-0xA output buffer containing an array of [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]], returns an output u8 total_out.
Takes a type-0xA output buffer containing an array of [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]]. Returns an output u8 total_out.
Other cmds which use this internally use arraycount=4.
Other cmds which use this internally use arraycount=4.
== AcquireBlePairingEvent ==
== AcquireBlePairingEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== BlePairDevice ==
== BlePairDevice ==
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32, no output.
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an input u32 ConnectionHandle. No output.
The u32 is the same as the param for [[#BleDisconnect]].
The u32 is the same as the param for [[#BleDisconnect]].
== BleUnpairDeviceOnBoth ==
== BleUnpairDeviceOnBoth ==
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32, no output.
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] an input u32 ConnectionHandle. No output.
The u32 is the same as the param for [[#BleDisconnect]].
The u32 is the same as the param for [[#BleDisconnect]].
== BleUnpairDevice ==
== BleUnpairDevice ==
Takes an input [[#BdAddress|BdAddress]] and a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], no output.
Takes an input [[#BdAddress|BdAddress]] and a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. No output.
== BleGetPairedAddresses ==
== BleGetPairedAddresses ==
Takes a type-0xA output buffer containing an array of [[#BdAddress|BdAddress]], a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], returns an output u8 total_out.
Takes a type-0xA output buffer containing an array of [[#BdAddress|BdAddress]], a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. Returns an output u8 total_out.
The max array entries is 10.
The max array entries is 10.
== AcquireBleServiceDiscoveryEvent ==
== AcquireBleServiceDiscoveryEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== GetGattServices ==
== GetGattServices ==
Takes a type-0x6 output buffer containing an array of [[#GattService]], an u32, returns an output u8 total_out.
Takes a type-0x6 output buffer containing an array of [[#GattService]] and an input u32 ConnectionHandle. Returns an output u8 total_out.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
== GetGattService ==
== GetGattService ==
Takes a type-0x1A output buffer containing a [[#GattService]], an u32, a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], returns an output bool.
Takes a type-0x1A output buffer containing a [[#GattService]], an input u32 ConnectionHandle and a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]]. Returns an output bool.
The u32 is the same as the param for [[#BleDisconnect]]. The output bool indicates whether a [[#GattService]] was returned.
The u32 is the same as the param for [[#BleDisconnect]]. The output bool indicates whether a [[#GattService]] was returned.
== GetGattIncludedServices ==
== GetGattIncludedServices ==
Takes a type-0x6 output buffer containing an array of [[#GattService]], an u16 ServiceHandle, an u32, returns an output u8.
Takes a type-0x6 output buffer containing an array of [[#GattService]], an u16 ServiceHandle and an input u32 ConnectionHandle. Returns an output u8.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
== GetBelongingService ==
== GetBelongingService ==
Takes a type-0x1A output buffer containing a [[#GattService]], an u16 AttributeHandle, an u32, returns an output bool.
Takes a type-0x1A output buffer containing a [[#GattService]], an u16 AttributeHandle and an input u32 ConnectionHandle. Returns an output bool.
The u32 is the same as the param for [[#BleDisconnect]]. The output bool indicates whether a [[#GattService]] was returned.
The u32 is the same as the param for [[#BleDisconnect]]. The output bool indicates whether a [[#GattService]] was returned.
== GetGattCharacteristics ==
== GetGattCharacteristics ==
Takes a type-0x6 output buffer containing an array of [[#GattCharacteristic]], an u16 ServiceHandle, an u32, returns an output u8 total_out.
Takes a type-0x6 output buffer containing an array of [[#GattCharacteristic]], an u16 ServiceHandle and an input u32 ConnectionHandle. Returns an output u8 total_out.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
== GetGattDescriptors ==
== GetGattDescriptors ==
Takes a type-0x6 output buffer containing an array of [[#GattDescriptor]], an u16 CharHandle, an u32, returns an output u8 total_out.
Takes a type-0x6 output buffer containing an array of [[#GattDescriptor]], an u16 CharHandle and an input u32 ConnectionHandle. Returns an output u8 total_out.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
The u32 is the same as the param for [[#BleDisconnect]]. The max array entries is 100.
== AcquireBleMtuConfigEvent ==
== AcquireBleMtuConfigEvent ==
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
== ConfigureBleMtu ==
== ConfigureBleMtu ==
Takes an u16 mtu, an u32, no output.
Takes an u16 mtu and an input u32 ConnectionHandle. No output.
The u32 is the same as the param for [[#BleDisconnect]].
The u32 is the same as the param for [[#BleDisconnect]].
== GetBleMtu ==
== GetBleMtu ==
Takes an u32, returns an output u16 mtu.
Takes an input u32 ConnectionHandle. Returns an output u16 mtu.
The u32 is the same as the param for [[#BleDisconnect]].
The u32 is the same as the param for [[#BleDisconnect]].
== RegisterBleGattDataPath ==
== RegisterBleGattDataPath ==
Takes a [[#BleDataPath]], no output.
Takes a [[#BleDataPath]]. No output.
== UnregisterBleGattDataPath ==
== UnregisterBleGattDataPath ==
Takes a [[#BleDataPath]], no output.
Takes a [[#BleDataPath]]. No output.
== RegisterAppletResourceUserId ==
== RegisterAppletResourceUserId ==
Takes an input u32 and an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes an input u32 and an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
== UnregisterAppletResourceUserId ==
== UnregisterAppletResourceUserId ==
Takes an input [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes an input [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
== SetAppletResourceUserId ==
== SetAppletResourceUserId ==
Takes an input [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes an input [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
No input, returns an output Event handle with EventClearMode=1.
== Cmd61 ==
== AcquireBleConnectionParameterUpdateEvent ==
No input. Returns an output Event handle with EventClearMode=1.
== SetCeLength ==
Takes an input [[#DeviceCeLengthList|DeviceCeLengthList]]. No output.
Sends a request which is then handled as follows:
Sends a request which is then handled as follows:
* Calls a func for getting the data from the input struct etc for passing to another func, that func is the same one called by [[#SetSlotMode]].
== EnsureSlotExpansion ==
Takes an input bool. No output.
== Cmd62 ==
Takes an input bool, no output.
Sends a request which is handled as follows: writes the flag into state if needed.
Sends a request which is handled as follows: writes the flag into state if needed.
== Cmd63 ==
== IsSlotExpansionEnsured ==
No input, returns an output bool.
No input. Returns an output bool.
This gets the flag used by [[#Cmd62]].
This gets the flag used by [[#EnsureSlotExpansion]].
== Cmd64 ==
== CancelConnectionTrigger ==
No input/output.
No input/output.
| 2 || [[#CancelDiscovery]]
| 2 || [[#CancelDiscovery]]
|-
|-
| 3 || [[#GetDeviceProperty]]
| 3 || [12.0.0+] IsDiscoveryEnabled ([1.0.0-11.0.1] [[#GetDeviceProperty]])
|-
|-
| 4 || [[#CreateBond]]
| 4 || [[#CreateBond]]
|-
|-
| 12 || [5.1.0+] [[#GetBleConnectionParameterRequest]]
| 12 || [5.1.0+] [[#GetBleConnectionParameterRequest]]
|-
| 13 || [12.0.0+] GetDiscoveredDevice
|-
| 14 || [15.0.0+] SleepAwakeLoopTest
|-
| 15 || [15.0.0+] SleepTest
|-
| 16 || [15.0.0+] MinimumAwakeTest
|-
| 17 || [15.0.0+] ForceEnableBtm
|}
|}
== AcquireDiscoveryEvent ==
== AcquireDiscoveryEvent ==
No input, returns output an Event handle with EventClearMode=1.
No input. Returns output an Event handle with EventClearMode=1.
[3.0.0+] Now returns an additional output bool.
[3.0.0+] Now returns an additional output bool.
== GetDeviceProperty ==
== GetDeviceProperty ==
Takes a type-0x1A output buffer containing a [[#DevicePropertyList]].
Takes a type-0x1A output buffer containing a [[#DevicePropertyList]]. No output.
== CreateBond ==
== CreateBond ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
[13.0.0+] Now takes a type-0xA output buffer, returns a total of 4-bytes of output.
== CancelBond ==
== CancelBond ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
== SetTsiMode ==
== SetTsiMode ==
Takes an input [[#BdAddress|BdAddress]] and a [[#TsiMode]], no output.
Takes an input [[#BdAddress|BdAddress]] and a [[#TsiMode]]. No output.
Sends a request which is handled as follows: uses [[Bluetooth_Driver_services#SetTsi|SetTsi]] directly with the specified params.
Sends a request which is handled as follows: uses [[Bluetooth_Driver_services#SetTsi|SetTsi]] directly with the specified params.
== GeneralTest ==
== GeneralTest ==
Takes an input s32, no output.
Takes an input s32. No output.
== HidConnect ==
== HidConnect ==
Takes an input [[#BdAddress|BdAddress]], no output.
Takes an input [[#BdAddress|BdAddress]]. No output.
== GeneralGet ==
== GeneralGet ==
Takes an input u32 and a type-0x1A output buffer containing a 0x11-byte struct.
Takes an input u32 and a type-0x1A output buffer containing a 0x11-byte struct. No output.
== GetGattClientDisconnectionReason ==
== GetGattClientDisconnectionReason ==
Takes an input [[#BdAddress|BdAddress]] and an u32, returns an output bool and u16.
Takes an input [[#BdAddress|BdAddress]] and an u32. Returns an output bool and u16.
The bool indicates whether the cmd is successful.
The bool indicates whether the cmd is successful.
== GetBleConnectionParameter ==
== GetBleConnectionParameter ==
Takes an input u32, returns an output bool and 3 u16s.
Takes an input u32. Returns an output bool and 3 u16s.
The bool indicates whether the cmd is successful, the output u16s are only set when this bool is set.
The bool indicates whether the cmd is successful, the output u16s are only set when this bool is set.
== GetBleConnectionParameterRequest ==
== GetBleConnectionParameterRequest ==
Takes an input u32, returns an output bool and 4 u16s.
Takes an input u32. Returns an output bool and 4 u16s.
The bool indicates whether the cmd is successful, the output u16s are only set when this bool is set.
The bool indicates whether the cmd is successful, the output u16s are only set when this bool is set.
== GetCore ==
== GetCore ==
No input, returns an output [[#IBtmSystemCore]].
No input. Returns an output [[#IBtmSystemCore]].
== IBtmSystemCore ==
== IBtmSystemCore ==
| 5 || [[#DisableRadio]]
| 5 || [[#DisableRadio]]
|-
|-
| 6 || [[#GetRadioOnOff]]
| 6 || [[#IsRadioEnabled]]
|-
|-
| 7 || [3.0.0+] [[#AcquireRadioEvent]]
| 7 || [3.0.0+] [[#AcquireRadioEvent]]
|-
|-
| 9 || [3.0.0+] [[#IsGamepadPairingStarted]]
| 9 || [3.0.0+] [[#IsGamepadPairingStarted]]
|-
| 10 || [13.0.0+] StartAudioDeviceDiscovery
|-
| 11 || [13.0.0+] StopAudioDeviceDiscovery
|-
| 12 || [13.0.0+] IsDiscoveryingAudioDevice
|-
| 13 || [13.0.0+] GetDiscoveredAudioDevice
|-
| 14 || [13.0.0+] AcquireAudioDeviceConnectionEvent
|-
| 15 || [13.0.0+] ConnectAudioDevice
|-
| 16 || [13.0.0+] IsConnectingAudioDevice
|-
| 17 || [13.0.0+] GetConnectedAudioDevices
|-
| 18 || [13.0.0+] DisconnectAudioDevice
|-
| 19 || [13.0.0+] AcquirePairedAudioDeviceInfoChangedEvent
|-
| 20 || [13.0.0+] GetPairedAudioDevices
|-
| 21 || [13.0.0+] RemoveAudioDevicePairing
|-
| 22 || [13.0.0+] RequestAudioDeviceConnectionRejection
|-
| 23 || [13.0.0+] CancelAudioDeviceConnectionRejection
|}
|}
=== GetPairedGamepadCount ===
=== GetPairedGamepadCount ===
No input, returns an output u8.
No input. Returns an output u8.
=== EnableRadio ===
=== EnableRadio ===
No input/output.
No input/output.
=== GetRadioOnOff ===
=== IsRadioEnabled ===
No input, returns an output bool.
No input. Returns an output bool.
=== AcquireRadioEvent ===
=== AcquireRadioEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
=== AcquireGamepadPairingEvent ===
=== AcquireGamepadPairingEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
=== IsGamepadPairingStarted ===
=== IsGamepadPairingStarted ===
No input, returns an output bool.
No input. Returns an output bool.
= btm:u =
= btm:u =
== GetCore ==
== GetCore ==
No input, returns an output [[#IBtmUserCore]].
No input. Returns an output [[#IBtmUserCore]].
== IBtmUserCore ==
== IBtmUserCore ==
| 0 || [[#AcquireBleScanEvent_2|AcquireBleScanEvent]]
| 0 || [[#AcquireBleScanEvent_2|AcquireBleScanEvent]]
|-
|-
| 1 || [[#GetBleScanFilterParameter]]
| 1 || [[#GetBleScanFilterParameter|GetBleScanFilterParameter]]
|-
|-
| 2 || [[#GetBleScanFilterParameter2]]
| 2 || [[#GetBleScanFilterParameter2|GetBleScanFilterParameter2]]
|-
|-
| 3 || [[#StartBleScanForGeneral_2|StartBleScanForGeneral]]
| 3 || [[#StartBleScanForGeneral_2|StartBleScanForGeneral]]
| 23 || [[#BleUnPairDevice_2|BleUnPairDevice]]
| 23 || [[#BleUnPairDevice_2|BleUnPairDevice]]
|-
|-
| 24 || [[#BleUnPairDevice2]]
| 24 || [[#BleUnPairDevice2|BleUnPairDevice2]]
|-
|-
| 25 || [[#BleGetPairedDevices]]
| 25 || [[#BleGetPairedDevices|BleGetPairedDevices]]
|-
|-
| 26 || [[#AcquireBleServiceDiscoveryEvent_2|AcquireBleServiceDiscoveryEvent]]
| 26 || [[#AcquireBleServiceDiscoveryEvent_2|AcquireBleServiceDiscoveryEvent]]
| 29 || [[#GetGattIncludedServices_2|GetGattIncludedServices]]
| 29 || [[#GetGattIncludedServices_2|GetGattIncludedServices]]
|-
|-
| 30 || [[#GetBelongingGattService]]
| 30 || [[#GetBelongingGattService|GetBelongingGattService]]
|-
|-
| 31 || [[#GetGattCharacteristics_2|GetGattCharacteristics]]
| 31 || [[#GetGattCharacteristics_2|GetGattCharacteristics]]
=== AcquireBleScanEvent ===
=== AcquireBleScanEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
This is similar to the [[#AcquireBleScanEvent|btm]] cmd.
This is similar to the [[#AcquireBleScanEvent|btm]] cmd.
=== GetBleScanFilterParameter ===
=== GetBleScanFilterParameter ===
Takes an input u16, returns a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]].
Takes an input u16. Returns a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]].
This is the same as [[#GetBleScanParameterGeneral]].
This is the same as [[#GetBleScanParameterGeneral]].
=== GetBleScanFilterParameter2 ===
=== GetBleScanFilterParameter2 ===
Takes an input u16, returns a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]].
Takes an input u16. Returns a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]].
This is the same as [[#GetBleScanParameterSmartDevice]].
This is the same as [[#GetBleScanParameterSmartDevice]].
=== StartBleScanForGeneral ===
=== StartBleScanForGeneral ===
Takes a PID, a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#StartBleScanForGeneral|btm]] cmd.
This is similar to the [[#StartBleScanForGeneral|btm]] cmd.
=== GetBleScanResultsForGeneral ===
=== GetBleScanResultsForGeneral ===
Takes a PID, a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#GetBleScanResultsForGeneral|btm]] cmd.
This is similar to the [[#GetBleScanResultsForGeneral|btm]] cmd.
=== StartBleScanForPaired ===
=== StartBleScanForPaired ===
Takes a PID, a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#StartBleScanForPaired|btm]] cmd.
This is similar to the [[#StartBleScanForPaired|btm]] cmd.
=== StartBleScanForSmartDevice ===
=== StartBleScanForSmartDevice ===
Takes a PID, a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#StartBleScanForSmartDevice|btm]] cmd.
This is similar to the [[#StartBleScanForSmartDevice|btm]] cmd.
=== GetBleScanResultsForSmartDevice ===
=== GetBleScanResultsForSmartDevice ===
Takes a PID, a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0x6 output buffer containing an array of [[Bluetooth_Driver_services#BleScanResult|BleScanResult]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#GetBleScanResultsForSmartDevice|btm]] cmd.
This is similar to the [[#GetBleScanResultsForSmartDevice|btm]] cmd.
=== AcquireBleConnectionEvent ===
=== AcquireBleConnectionEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
This is similar to the [[#AcquireBleConnectionEvent|btm]] cmd.
This is similar to the [[#AcquireBleConnectionEvent|btm]] cmd.
=== BleConnect ===
=== BleConnect ===
Takes a PID, an [[#BdAddress|BdAddress]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, an [[#BdAddress|BdAddress]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#BleConnect|btm]] cmd.
This is similar to the [[#BleConnect|btm]] cmd.
=== BleDisconnect ===
=== BleDisconnect ===
Takes an input u32, no output.
Takes an input u32. No output.
This is similar to the [[#BleDisconnect|btm]] cmd.
This is similar to the [[#BleDisconnect|btm]] cmd.
=== BleGetConnectionState ===
=== BleGetConnectionState ===
Takes a PID, a type-0xA output buffer containing an array of [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0xA output buffer containing an array of [[Bluetooth_Driver_services#BleConnectionInfo|BleConnectionInfo]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#BleGetConnectionState|btm]] cmd.
This is similar to the [[#BleGetConnectionState|btm]] cmd.
=== AcquireBlePairingEvent ===
=== AcquireBlePairingEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
This is similar to the [[#AcquireBlePairingEvent|btm]] cmd.
This is similar to the [[#AcquireBlePairingEvent|btm]] cmd.
=== BlePairDevice ===
=== BlePairDevice ===
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32, no output.
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32. No output.
This is similar to the [[#BlePairDevice|btm]] cmd.
This is similar to the [[#BlePairDevice|btm]] cmd.
=== BleUnPairDevice ===
=== BleUnPairDevice ===
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32, no output.
Takes an input [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]] and an u32. No output.
This is similar to the [[#BleUnpairDeviceOnBoth|btm]] cmd.
This is similar to the [[#BleUnpairDeviceOnBoth|btm]] cmd.
=== BleUnPairDevice2 ===
=== BleUnPairDevice2 ===
Takes an input [[#BdAddress|BdAddress]] and a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], no output.
Takes an input [[#BdAddress|BdAddress]] and a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. No output.
This is similar to the [[#BleUnPairDevice|btm]] cmd.
This is similar to the [[#BleUnPairDevice|btm]] cmd.
=== BleGetPairedDevices ===
=== BleGetPairedDevices ===
Takes a type-0xA output buffer containing an array of [[#BdAddress|BdAddress]], a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]], returns an output u8 total_out.
Takes a type-0xA output buffer containing an array of [[#BdAddress|BdAddress]], a [[Bluetooth_Driver_services#BleAdvertisePacketParameter|BleAdvertisePacketParameter]]. Returns an output u8 total_out.
This is the same as the [[#BleGetPairedAddresses|btm]] cmd.
This is the same as the [[#BleGetPairedAddresses|btm]] cmd.
=== AcquireBleServiceDiscoveryEvent ===
=== AcquireBleServiceDiscoveryEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
This is similar to the [[#AcquireBleServiceDiscoveryEvent|btm]] cmd.
This is similar to the [[#AcquireBleServiceDiscoveryEvent|btm]] cmd.
=== GetGattServices ===
=== GetGattServices ===
Takes a PID, a type-0x6 output buffer containing an array of [[#GattService]], an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0x6 output buffer containing an array of [[#GattService]], an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#GetGattServices|btm]] cmd.
This is similar to the [[#GetGattServices|btm]] cmd.
=== GetGattService ===
=== GetGattService ===
Takes a PID, a type-0x1A output buffer containing a [[#GattService]], an u32, a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output bool.
Takes a PID, a type-0x1A output buffer containing a [[#GattService]], an u32, a [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output bool.
This is similar to the [[#GetGattService|btm]] cmd.
This is similar to the [[#GetGattService|btm]] cmd.
=== GetGattIncludedServices ===
=== GetGattIncludedServices ===
Takes a PID, a type-0x6 output buffer containing an array of [[#GattService]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8.
Takes a PID, a type-0x6 output buffer containing an array of [[#GattService]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8.
This is similar to the [[#GetGattIncludedServices|btm]] cmd.
This is similar to the [[#GetGattIncludedServices|btm]] cmd.
=== GetBelongingGattService ===
=== GetBelongingGattService ===
Takes a PID, a type-0x1A output buffer containing a [[#GattService]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output bool.
Takes a PID, a type-0x1A output buffer containing a [[#GattService]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output bool.
This is similar to the [[#GetBelongingService|btm]] cmd.
This is similar to the [[#GetBelongingService|btm]] cmd.
=== GetGattCharacteristics ===
=== GetGattCharacteristics ===
Takes a PID, a type-0x6 output buffer containing an array of [[#GattCharacteristic]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0x6 output buffer containing an array of [[#GattCharacteristic]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#GetGattCharacteristics|btm]] cmd.
This is similar to the [[#GetGattCharacteristics|btm]] cmd.
=== GetGattDescriptors ===
=== GetGattDescriptors ===
Takes a PID, a type-0x6 output buffer containing an array of [[#GattDescriptor]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u8 total_out.
Takes a PID, a type-0x6 output buffer containing an array of [[#GattDescriptor]], an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u8 total_out.
This is similar to the [[#GetGattDescriptors|btm]] cmd.
This is similar to the [[#GetGattDescriptors|btm]] cmd.
=== AcquireBleMtuConfigEvent ===
=== AcquireBleMtuConfigEvent ===
No input, returns an output bool and an Event handle with EventClearMode=1.
No input. Returns an output bool and an Event handle with EventClearMode=1.
This is similar to the [[#AcquireBleMtuConfigEvent|btm]] cmd.
This is similar to the [[#AcquireBleMtuConfigEvent|btm]] cmd.
=== ConfigureBleMtu ===
=== ConfigureBleMtu ===
Takes a PID, an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, an u16, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#ConfigureBleMtu|btm]] cmd.
This is similar to the [[#ConfigureBleMtu|btm]] cmd.
=== GetBleMtu ===
=== GetBleMtu ===
Takes a PID, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], returns an output u16.
Takes a PID, an u32, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. Returns an output u16.
This is similar to the [[#GetBleMtu|btm]] cmd.
This is similar to the [[#GetBleMtu|btm]] cmd.
=== RegisterBleGattDataPath ===
=== RegisterBleGattDataPath ===
Takes a PID, a [[#BleDataPath]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, a [[#BleDataPath]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#RegisterBleGattDataPath|btm]] cmd.
This is similar to the [[#RegisterBleGattDataPath|btm]] cmd.
=== UnregisterBleGattDataPath ===
=== UnregisterBleGattDataPath ===
Takes a PID, a [[#BleDataPath]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output.
Takes a PID, a [[#BleDataPath]], an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]]. No output.
This is similar to the [[#UnregisterBleGattDataPath|btm]] cmd.
This is similar to the [[#UnregisterBleGattDataPath|btm]] cmd.
|-
|-
| 2 || 6
| 2 || 6
|-
| 3 || Active
|}
= SniffMode =
This is "nn::btm::SniffMode".
{| class="wikitable" border="1"
|-
! Value || Description
|-
| 0 || 5ms
|-
| 1 || 10ms
|-
| 2 || 15ms
|-
|-
| 3 || Active
| 3 || Active
|-
|-
| 1 || Hid
| 1 || Hid
|-
| 2 || [13.0.0+] Audio
|}
|}
|-
|-
| 0x2 || 0x2 || Pid
| 0x2 || 0x2 || Pid
|}
= HidDeviceCondition =
This is "nn::btm::HidDeviceCondition".
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x4 || [[#SniffMode|SniffMode]]
|-
| 0x4 || 0x4 || [[#SlotMode|SlotMode]]
|-
| 0x8 || 0x1 || IsBurstMode
|-
| 0x9 || 0x11 || [[#ZeroRetransmissionList|ZeroRetransmissionList]]
|-
| 0x1A || 0x2 || Vid
|-
| 0x1C || 0x2 || Pid
|}
|}
= HostDeviceProperty =
= HostDeviceProperty =
This is "nn::btm::HostDeviceProperty". This is a 0x2A-byte struct.
This is "nn::btm::HostDeviceProperty". This is a 0x2A-byte struct.
[13.0.0+] This is a 0x103-byte struct.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x29 || 0x1 || FeatureSet
| 0x29 || 0x1 || FeatureSet
|-
| 0x2A || 0xD9 || [13.0.0+]
|}
|}
= DeviceSlotMode =
= DeviceSlotMode =
This is "nn::btm::DeviceSlotMode". This is a 0xC-byte struct.
This is "nn::btm::DeviceSlotMode".
{| class="wikitable" border="1"
{| class="wikitable" border="1"
| 0x6 || 0x2 || Reserved
| 0x6 || 0x2 || Reserved
|-
|-
| 0x8 || 0xC || [[#SlotMode|SlotMode]]
| 0x8 || 0x4 || [[#SlotMode|SlotMode]]
|}
|}
|-
|-
| 0x4 || 0xC * 8 || Array of [[#DeviceSlotMode|DeviceSlotMode]]
| 0x4 || 0xC * 8 || Array of [[#DeviceSlotMode|DeviceSlotMode]]
|}
= DeviceCondition =
This is "nn::btm::DeviceCondition". This is a 0x6C-byte struct.
[13.0.0+] This is a 0x148-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x6 || [[#BdAddress|BdAddress]]
|-
| 0x6 || 0x2 || Reserved
|-
| 0x8 || 0x4 || [[#Profile|Profile]]
|-
| 0xC || 0x20 || [[#BdName|BdName]]
|-
| 0x2C || 0x20 || Empty (Profile = None) or [[#HidDeviceCondition|HidDeviceCondition]] (Profile = Hid)
|-
| 0x4C || 0x20 || Reserved
|-
| 0x6C || 0xDC || [13.0.0+]
|}
= DeviceConditionList =
This is "nn::btm::DeviceConditionList". This is a 0x36C-byte struct.
[13.0.0+] This is a 0xA4C-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x4 || [[#BluetoothMode|BluetoothMode]]
|-
| 0x4 || 0x4 || [[#WlanMode|WlanMode]]
|-
| 0x8 || 0x1 || IsSlotSavingForPairing
|-
| 0x9 || 0x1 || DeviceCount
|-
| 0xA || 0x2 || Reserved
|-
| 0xC || 0x148 * 8 ([1.0.0-12.1.0] 0x6C * 8) || Array of [[#DeviceCondition|DeviceCondition]]
|}
|}
= DeviceInfo =
= DeviceInfo =
This is "nn::btm::DeviceInfo". This is a 0x60-byte struct.
This is "nn::btm::DeviceInfo". This is a 0x60-byte struct.
[13.0.0+] This is a 0x13C-byte struct.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x44 || 0x1C || Reserved
| 0x44 || 0x1C || Reserved
|-
| 0x60 || 0xDC || [13.0.0+]
|}
|}
= DeviceInfoList =
= DeviceInfoList =
This is "nn::btm::DeviceInfoList". This is a 0x3C4-byte struct.
This is "nn::btm::DeviceInfoList". This is a 0x3C4-byte struct.
[13.0.0+] This is a 0xC5C-byte struct.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
| 0x1 || 0x3 || Reserved
| 0x1 || 0x3 || Reserved
|-
|-
| 0x4 || 0xA * 60 || Array of [[#DeviceInfo|DeviceInfo]]
| 0x4 || 0x13C * 10 ([1.0.0-12.1.0] 0x60 * 10) || Array of [[#DeviceInfo|DeviceInfo]]
|}
|}
|-
|-
| 0x1 || 0x29 * 15 || Array of [[#DeviceProperty|DeviceProperty]]
| 0x1 || 0x29 * 15 || Array of [[#DeviceProperty|DeviceProperty]]
|}
= DeviceCeLength =
This is "nn::btm::DeviceCeLength". This is a 0x10-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x6 || [[#BdAddress|BdAddress]]
|-
| 0x6 || 0x6 || Reserved
|-
| 0xC || 0x1 || CeLength (used for [[Bluetooth_Driver_services#BleConnectionParameter|BleConnectionParameter]])
|-
| 0xD || 0x3 || Reserved
|}
= DeviceCeLengthList =
This is "nn::btm::DeviceCeLengthList". This is a 0x44-byte struct.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0 || 0x10 * 4 || Array of [[#DeviceCeLength|DeviceCeLength]]
|-
| 0x40 || 0x4 || DeviceCount
|}
|}
| 0x4 || 0x14 || [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]]
| 0x4 || 0x14 || [[Bluetooth_Driver_services#GattAttributeUuid|GattAttributeUuid]]
|}
|}
= Logging =
A func which uses [[PSC_services|srepo]] is called in certain conditions (access to srepo:u was added to btm with [7.0.0+]). This is implemented as follows (as of 11.0.0):
* Loads the data for the below fields.
* Creates the report with EventId "bluetooth_crash". The ApplicationId is set to {btm ProgramId}.
* The following fields are added to the report:
** "reason": Set to an input param for this func.
** "radio"
** "gamepad_pairing"
** "llr_notify"
** "ble_scan"
** "bluetooth_mode": Set to hard-coded value 0.
** "wlan_mode"
** "classic_device_count"
** "slot_mode_active_count"
** "slot_mode_4_count"
** "slot_mode_6_count"
** "sniff_mode"
** "ble_device_count"
** "ce_length_2_count"
** "ce_length_4_count"
** "ce_length_8_count"
* Saves the report and returns.
[[Category:Services]]
[[Category:Services]]