Bluetooth Driver services: Difference between revisions

From Nintendo Switch Brew
Jump to navigation Jump to search
← Older editNewer edit →
No edit summary
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= btdrv =
= btdrv =
This is "nn::bluetooth::IBluetoothDriver".
The bluetooth driver implements the bluetooth protocol over h4/uart.
The bluetooth driver implements the bluetooth protocol over h4/uart.


Line 10: Line 12:
! Cmd || Name
! Cmd || Name
|-
|-
| 0 ||  
| 0 || InitializeBluetoothDriver
|-
| 1 || InitializeBluetooth
|-
| 2 || EnableBluetooth
|-
| 3 || DisableBluetooth
|-
| 4 || CleanupBluetooth
|-
| 5 || GetAdapterProperties
|-
| 6 || GetAdapterProperty
|-
| 7 || SetAdapterProperty
|-
| 8 || StartDiscovery
|-
| 9 || CancelDiscovery
|-
| 10 || [[#CreateBond]]
|-
| 11 || RemoveBond
|-
| 12 || CancelBond
|-
| 13 || PinReply
|-
| 14 || SspReply
|-
| 15 || GetEventInfo
|-
| 16 || InitializeHid
|-
| 17 || HidConnect
|-
| 18 || HidDisconnect
|-
| 19 || HidSendData
|-
| 20 || HidSendData2
|-
| 21 || HidSetReport
|-
| 22 || HidGetReport
|-
| 23 || [[#HidWakeController]]
|-
| 24 || HidAddPairedDevice
|-
| 25 || HidGetPairedDevice
|-
| 26 || CleanupHid
|-
| 27 || HidGetEventInfo
|-
| 28 || ExtSetTsi
|-
| 29 || ExtSetBurstMode
|-
| 30 || ExtSetZeroRetran
|-
| 31 || ExtSetMcMode
|-
| 32 || ExtStartLlrMode
|-
| 33 || ExtExitLlrMode
|-
| 34 || ExtSetRadio
|-
| 35 || ExtSetVisibility
|-
| 36 || ExtSetTbfcScan
|-
| 37 || RegisterHidReportEvent
|-
| 38 || [[#HidGetReportEventInfo]]
|-
| 39 || GetLatestPlr
|-
| 40 || [3.0.0+] ExtGetPendingConnections
|-
| 41 || [3.0.0+] GetChannelMap
|-
| 42 || [3.0.0+] EnableBluetoothBoostSetting
|-
| 43 || [3.0.0+] IsBluetoothBoostSettingEnabled
|-
| 44 || [3.0.0+] EnableBluetoothAfhSetting
|-
| 45 || IsBluetoothAfhSettingEnabled
|-
| 46 || [5.0.0+] InitializeBluetoothLe
|-
| 47 || [5.0.0+] EnableBluetoothLe
|-
| 48 || [5.0.0+] DisableBluetoothLe
|-
| 49 || [5.0.0+] CleanupBluetoothLe
|-
| 50 || [5.0.0+] SetLeVisibility
|-
| 51 || [5.0.0+] SetLeConnectionParameter
|-
| 52 || [5.0.0+] [[#SetLeDefaultConnectionParameter]]
|-
| 53 || [5.0.0+] SetLeAdvertiseData
|-
| 54 || [5.0.0+] SetLeAdvertiseParameter
|-
| 55 || [5.0.0+] StartLeScan
|-
| 56 || [5.0.0+] StopLeScan
|-
| 57 || [5.0.0+] AddLeScanFilterCondition
|-
| 58 || [5.0.0+] DeleteLeScanFilterCondition
|-
| 59 || [5.0.0+] DeleteLeScanFilter
|-
| 60 || [5.0.0+] ClearLeScanFilters
|-
| 61 || [5.0.0+] EnableLeScanFilter
|-
| 62 || [5.0.0+] RegisterLeClient
|-
|-
| 1 ||  
| 63 || [5.0.0+] UnregisterLeClient
|-
|-
| 2 ||  
| 64 || [5.0.0+] UnregisterLeClientAll
|-
|-
| 3 ||  
| 65 || [5.0.0+] LeClientConnect
|-
|-
| 4 ||  
| 66 || [5.1.0+]
|-
|-
| 5 ||  
| 67 ([5.0.0-5.0.2] 66) || LeClientCancelConnection
|-
|-
| 6 ||  
| 68 ([5.0.0-5.0.2] 67) || [5.0.0+] [[#LeClientDisconnect]]
|-
|-
| 7 ||  
| 69 ([5.0.0-5.0.2] 68) || [5.0.0+] LeClientGetAttributes
|-
|-
| 8 ||  
| 70 ([5.0.0-5.0.2] 69) || [5.0.0+] LeClientDiscoverService
|-
|-
| 9 ||  
| 71 ([5.0.0-5.0.2] 70) || [5.0.0+] LeClientConfigureMtu
|-
|-
| 10 ||  
| 72 ([5.0.0-5.0.2] 71) || [5.0.0+] RegisterLeServer
|-
|-
| 11 ||  
| 73 ([5.0.0-5.0.2] 72) || [5.0.0+] UnregisterLeServer
|-
|-
| 12 ||  
| 74 ([5.0.0-5.0.2] 73) || [5.0.0+] [[#LeServerConnect]]
|-
|-
| 13 ||  
| 75 || [5.0.0+] CreateLeService
|-
|-
| 14 ||  
| 76 ([5.0.0-5.0.2] 74) || [5.0.0+] LeServerDisconnect
|-
|-
| 15 ||  
| 77 || [5.0.0+] AddLeCharacteristic
|-
|-
| 16 ||  
| 78 ([5.0.0-5.0.2] 76) || [5.0.0+] StartLeService
|-
|-
| 17 ||  
| 79 ([5.0.0-5.0.2] 78) || [5.0.0+] AddLeDescriptor
|-
|-
| 18 ||  
| 80 ([5.0.0-5.0.2] 79) || [5.0.0+] GetLeCoreEventInfo
|-
|-
| 19 || SendData
| 81 ([5.0.0-5.0.2] 80) || [5.0.0+] LeGetFirstCharacteristic
|-
|-
| 20 ||  
| 82 ([5.0.0-5.0.2] 81) || [5.0.0+] LeGetNextCharacteristic
|-
|-
| 21 || SetReport
| 83 ([5.0.0-5.0.2] 82) || [5.0.0+] LeGetFirstDescriptor
|-
|-
| 22 || GetReport
| 84 || [5.0.0+] RegisterLeCoreDataPath
|-
|-
| 23 ||  
| 85 || [5.0.0+] UnregisterLeCoreDataPath
|-
|-
| 24 ||  
| 86 || [5.0.0+] RegisterLeHidDataPath
|-
|-
| 25 ||  
| 87 || [5.0.0+] UnregisterLeHidDataPath
|-
|-
| 26 ||  
| 88 || [5.0.0+] RegisterLeDataPath
|-
|-
| 27 ||  
| 89 ([5.0.0-5.0.2] 83) || [5.0.0+] LeGetNextDescriptor
|-
|-
| 28 ||  
| 90 ([5.0.0-5.0.2] 89) || [5.0.0+] UnregisterLeDataPath
|-
|-
| 29 ||  
| 91 ([5.0.0-5.0.2] 90) || [5.0.0+] LeClientReadCharacteristic
|-
|-
| 30 ||  
| 92 ([5.0.0-5.0.2] 91) || [5.0.0+] LeClientReadDescriptor
|-
|-
| 31 ||  
| 93 ([5.0.0-5.0.2] 92) || [5.0.0+] LeClientWriteCharacteristic
|-
|-
| 32 ||  
| 94 || [5.0.0+] LeClientRegisterNotification
|-
|-
| 33 ||  
| 95 ([5.0.0-5.0.2] 93) || [5.0.0+] LeClientWriteDescriptor
|-
|-
| 34 ||  
| 96 ([5.0.0-5.0.2] 95) || [5.0.0+] LeClientDeregisterNotification
|-
|-
| 35 ||  
| 97 ([5.0.0-5.0.2] 96) || [5.0.0+] GetLeHidEventInfo
|-
|-
| 36 ||  
| 97 || [5.0.0-5.0.2] RegisterBleHidEvent
|-
|-
| 37 ||  
| 98 || [5.1.0+] SetLeScanParameter
|-
|-
| 38 ||  
| 256 || [5.0.0+] GetIsManufacturingMode
|-
|-
| 39 ||  
| 257 || [7.0.0+] EmulateBluetoothCrash
|-
| 258 || [9.0.0+] GetBleChannelMap
|}
|}
Various cmdids were moved with [4.0.0+] and [5.0.0+].
== CreateBond ==
Takes a total of 0x6-bytes of input and a type-0x19 input buffer, no output.
[9.0.0+] Now only takes a total of 0xC-bytes of input without a buffer, no output.
== HidWakeController ==
Takes a total of 0x6-bytes of input, no output.
[9.0.0+] Now takes a total of 0x8-bytes of input, no output.
== HidGetReportEventInfo ==
No input, takes a type-0xA output buffer and returns 4-bytes of output.
[7.0.0+] No longer takes a buffer or returns output, now returns an output handle.
== SetLeDefaultConnectionParameter ==
Takes a total of 0x14-bytes of input, no output.
[9.0.0+] Now takes a total of 0xC-bytes of input, no output.
== LeClientDisconnect ==
Takes a total of 0xC-bytes of input, no output.
[9.0.0+] Now takes a total of 0x4-bytes of input, no output.
== LeServerConnect ==
Takes a total of 0x7-bytes of input, no output.
[9.0.0+] Now takes a total of 1-byte of input, no output.
= bt =
This is "nn::bluetooth::IBluetoothUser".
{| class="wikitable" border="1"
|-
! Cmd || Name
|-
| 0 || LeClientReadCharacteristic
|-
| 1 || LeClientReadDescriptor
|-
| 2 || LeClientWriteCharacteristic
|-
| 3 || LeClientWriteDescriptor
|-
| 4 || LeClientRegisterNotification
|-
| 5 || LeClientDeregisterNotification
|-
| 6 || SetLeResponse
|-
| 7 || LeSendIndication
|-
| 8 || GetLeEventInfo
|-
| 9 || RegisterBleEvent
|}
[[Category:Services]]

Revision as of 03:10, 11 September 2019

btdrv

This is "nn::bluetooth::IBluetoothDriver".

The bluetooth driver implements the bluetooth protocol over h4/uart.

It interfaces with the uart service to actually talk with the bluetooth hardware.

The code seems to be derived from a broadcom stack. A good starting point for similar source code can be found in the MICO project: https://github.com/yinhongxing/mico/tree/ea67ff3659f12d730d4dc3b8d547b093bd2ee2ee/MICO/bluetooth_bte Note that the library files contain many (symbolized) functions which match btdrv.

Cmd Name
0 InitializeBluetoothDriver
1 InitializeBluetooth
2 EnableBluetooth
3 DisableBluetooth
4 CleanupBluetooth
5 GetAdapterProperties
6 GetAdapterProperty
7 SetAdapterProperty
8 StartDiscovery
9 CancelDiscovery
10 #CreateBond
11 RemoveBond
12 CancelBond
13 PinReply
14 SspReply
15 GetEventInfo
16 InitializeHid
17 HidConnect
18 HidDisconnect
19 HidSendData
20 HidSendData2
21 HidSetReport
22 HidGetReport
23 #HidWakeController
24 HidAddPairedDevice
25 HidGetPairedDevice
26 CleanupHid
27 HidGetEventInfo
28 ExtSetTsi
29 ExtSetBurstMode
30 ExtSetZeroRetran
31 ExtSetMcMode
32 ExtStartLlrMode
33 ExtExitLlrMode
34 ExtSetRadio
35 ExtSetVisibility
36 ExtSetTbfcScan
37 RegisterHidReportEvent
38 #HidGetReportEventInfo
39 GetLatestPlr
40 [3.0.0+] ExtGetPendingConnections
41 [3.0.0+] GetChannelMap
42 [3.0.0+] EnableBluetoothBoostSetting
43 [3.0.0+] IsBluetoothBoostSettingEnabled
44 [3.0.0+] EnableBluetoothAfhSetting
45 IsBluetoothAfhSettingEnabled
46 [5.0.0+] InitializeBluetoothLe
47 [5.0.0+] EnableBluetoothLe
48 [5.0.0+] DisableBluetoothLe
49 [5.0.0+] CleanupBluetoothLe
50 [5.0.0+] SetLeVisibility
51 [5.0.0+] SetLeConnectionParameter
52 [5.0.0+] #SetLeDefaultConnectionParameter
53 [5.0.0+] SetLeAdvertiseData
54 [5.0.0+] SetLeAdvertiseParameter
55 [5.0.0+] StartLeScan
56 [5.0.0+] StopLeScan
57 [5.0.0+] AddLeScanFilterCondition
58 [5.0.0+] DeleteLeScanFilterCondition
59 [5.0.0+] DeleteLeScanFilter
60 [5.0.0+] ClearLeScanFilters
61 [5.0.0+] EnableLeScanFilter
62 [5.0.0+] RegisterLeClient
63 [5.0.0+] UnregisterLeClient
64 [5.0.0+] UnregisterLeClientAll
65 [5.0.0+] LeClientConnect
66 [5.1.0+]
67 ([5.0.0-5.0.2] 66) LeClientCancelConnection
68 ([5.0.0-5.0.2] 67) [5.0.0+] #LeClientDisconnect
69 ([5.0.0-5.0.2] 68) [5.0.0+] LeClientGetAttributes
70 ([5.0.0-5.0.2] 69) [5.0.0+] LeClientDiscoverService
71 ([5.0.0-5.0.2] 70) [5.0.0+] LeClientConfigureMtu
72 ([5.0.0-5.0.2] 71) [5.0.0+] RegisterLeServer
73 ([5.0.0-5.0.2] 72) [5.0.0+] UnregisterLeServer
74 ([5.0.0-5.0.2] 73) [5.0.0+] #LeServerConnect
75 [5.0.0+] CreateLeService
76 ([5.0.0-5.0.2] 74) [5.0.0+] LeServerDisconnect
77 [5.0.0+] AddLeCharacteristic
78 ([5.0.0-5.0.2] 76) [5.0.0+] StartLeService
79 ([5.0.0-5.0.2] 78) [5.0.0+] AddLeDescriptor
80 ([5.0.0-5.0.2] 79) [5.0.0+] GetLeCoreEventInfo
81 ([5.0.0-5.0.2] 80) [5.0.0+] LeGetFirstCharacteristic
82 ([5.0.0-5.0.2] 81) [5.0.0+] LeGetNextCharacteristic
83 ([5.0.0-5.0.2] 82) [5.0.0+] LeGetFirstDescriptor
84 [5.0.0+] RegisterLeCoreDataPath
85 [5.0.0+] UnregisterLeCoreDataPath
86 [5.0.0+] RegisterLeHidDataPath
87 [5.0.0+] UnregisterLeHidDataPath
88 [5.0.0+] RegisterLeDataPath
89 ([5.0.0-5.0.2] 83) [5.0.0+] LeGetNextDescriptor
90 ([5.0.0-5.0.2] 89) [5.0.0+] UnregisterLeDataPath
91 ([5.0.0-5.0.2] 90) [5.0.0+] LeClientReadCharacteristic
92 ([5.0.0-5.0.2] 91) [5.0.0+] LeClientReadDescriptor
93 ([5.0.0-5.0.2] 92) [5.0.0+] LeClientWriteCharacteristic
94 [5.0.0+] LeClientRegisterNotification
95 ([5.0.0-5.0.2] 93) [5.0.0+] LeClientWriteDescriptor
96 ([5.0.0-5.0.2] 95) [5.0.0+] LeClientDeregisterNotification
97 ([5.0.0-5.0.2] 96) [5.0.0+] GetLeHidEventInfo
97 [5.0.0-5.0.2] RegisterBleHidEvent
98 [5.1.0+] SetLeScanParameter
256 [5.0.0+] GetIsManufacturingMode
257 [7.0.0+] EmulateBluetoothCrash
258 [9.0.0+] GetBleChannelMap

Various cmdids were moved with [4.0.0+] and [5.0.0+].

CreateBond

Takes a total of 0x6-bytes of input and a type-0x19 input buffer, no output.

[9.0.0+] Now only takes a total of 0xC-bytes of input without a buffer, no output.

HidWakeController

Takes a total of 0x6-bytes of input, no output.

[9.0.0+] Now takes a total of 0x8-bytes of input, no output.

HidGetReportEventInfo

No input, takes a type-0xA output buffer and returns 4-bytes of output.

[7.0.0+] No longer takes a buffer or returns output, now returns an output handle.

SetLeDefaultConnectionParameter

Takes a total of 0x14-bytes of input, no output.

[9.0.0+] Now takes a total of 0xC-bytes of input, no output.

LeClientDisconnect

Takes a total of 0xC-bytes of input, no output.

[9.0.0+] Now takes a total of 0x4-bytes of input, no output.

LeServerConnect

Takes a total of 0x7-bytes of input, no output.

[9.0.0+] Now takes a total of 1-byte of input, no output.

bt

This is "nn::bluetooth::IBluetoothUser".

Cmd Name
0 LeClientReadCharacteristic
1 LeClientReadDescriptor
2 LeClientWriteCharacteristic
3 LeClientWriteDescriptor
4 LeClientRegisterNotification
5 LeClientDeregisterNotification
6 SetLeResponse
7 LeSendIndication
8 GetLeEventInfo
9 RegisterBleEvent
Retrieved from "https://switchbrew.org/w/index.php?title=Bluetooth_Driver_services&oldid=7811"