Line 215: |
Line 215: |
| |- | | |- |
| | 100 || [12.0.0+] [[#IsBluetoothEnabled]] | | | 100 || [12.0.0+] [[#IsBluetoothEnabled]] |
| + | |- |
| + | | 101 || [15.0.0+] ForceEnableBluetooth |
| + | |- |
| + | | 102 || [15.0.0+] EnableBluetoothStub |
| |- | | |- |
| | 128 || [12.0.0+] [[#AcquireAudioEvent]] | | | 128 || [12.0.0+] [[#AcquireAudioEvent]] |
Line 248: |
Line 252: |
| | 143 || [12.0.0+] [[#GetAudioControlInputState]] | | | 143 || [12.0.0+] [[#GetAudioControlInputState]] |
| |- | | |- |
− | | 144 || [12.0.0+] [[#AcquireAudioConnectionStateChangedEvent]] | + | | 144 || [12.0.0-13.2.1] [[#AcquireAudioConnectionStateChangedEvent]] |
| |- | | |- |
− | | 145 || [12.0.0+] [[#GetConnectedAudioDevice]] | + | | 145 || [12.0.0-13.2.1] [[#GetConnectedAudioDevice]] |
| |- | | |- |
| | 146 || [13.0.0+] [[#CloseAudioControlInput]] | | | 146 || [13.0.0+] [[#CloseAudioControlInput]] |
Line 259: |
Line 263: |
| |- | | |- |
| | 149 || [13.0.0+] [[#SendAudioControlSetAbsoluteVolumeCommand]] | | | 149 || [13.0.0+] [[#SendAudioControlSetAbsoluteVolumeCommand]] |
| + | |- |
| + | | 150 || [14.0.0+] AcquireAudioSinkVolumeLocallyChangedEvent |
| + | |- |
| + | | 151 || [14.0.0+] AcquireAudioSinkVolumeUpdateRequestCompletedEvent |
| + | |- |
| + | | 152 || [14.0.0+] GetAudioSinkVolume |
| + | |- |
| + | | 153 || [14.0.0+] RequestUpdateAudioSinkVolume |
| + | |- |
| + | | 154 || [14.0.0+] IsAudioSinkVolumeSupported |
| + | |- |
| + | | 155 || [15.0.0+] IsAudioSinkVolumeSupported2 |
| |- | | |- |
| | 256 || [5.0.0+] [[#IsManufacturingMode]] | | | 256 || [5.0.0+] [[#IsManufacturingMode]] |
Line 329: |
Line 345: |
| [12.0.0+] The Enable vfunc called above for Audio does the following: | | [12.0.0+] The Enable vfunc called above for Audio does the following: |
| * Calls a func which does the following: | | * Calls a func which does the following: |
− | ** Uses BSA to enable AV. Besides the callback, the only field in the passed struct which is set is <code>features</code>. This is ORRed to set bit0 for "remote control target", which with [13.0.0+] is only done if [[System_Settings|system-setting]] <code>bluetooth_debug!is_av_rc_tg</code> is set to true. | + | ** Uses BSA to enable AV. Besides the callback, the only field in the passed struct which is set is <code>features</code>. This is ORRed to set bit0 for "remote control target", which with [13.0.0+] is only done if [[System_Settings|system-setting]] <code>bluetooth_debug!is_av_rc_tg</code> is set to true. With [14.0.0+] this is also ORRed with value 0xA (bit1/bit3) when [[System_Settings|system-setting]] <code>bluetooth_debug!is_av_rc_ct</code> is set to true (which is the case for [14.0.0+]). |
| ** Error handling + state setup is done. | | ** Error handling + state setup is done. |
| ** Uses BSA to register AV twice, with the default input struct. | | ** Uses BSA to register AV twice, with the default input struct. |
Line 795: |
Line 811: |
| | | |
| == ConnectGattServer == | | == ConnectGattServer == |
− | Takes an input u8, an [[#Address]], a bool, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output. | + | Takes an input u8 client_if, an [[#Address]], a bool, an [[Applet_Manager_services#AppletResourceUserId|AppletResourceUserId]], no output. |
| | | |
| This is used by [[BTM_services|btm]]. | | This is used by [[BTM_services|btm]]. |
| + | |
| + | The input bool and AppletResourceUserId are unused. |
| + | |
| + | The is_direct field passed to BSA is value 1. |
| | | |
| == CancelConnectGattServer == | | == CancelConnectGattServer == |
Line 948: |
Line 968: |
| == SetBleScanParameter == | | == SetBleScanParameter == |
| Takes two input u16s, no output. | | Takes two input u16s, no output. |
| + | |
| + | The first u16 is scan_interval, the second u16 is scan_window. |
| | | |
| This is used by [[BTM_services|btm]]. | | This is used by [[BTM_services|btm]]. |
Line 1,839: |
Line 1,861: |
| = BleAdvertiseFilter = | | = BleAdvertiseFilter = |
| This is "nn::bluetooth::BleAdvertiseFilter". This is a 0x3E-byte struct. | | This is "nn::bluetooth::BleAdvertiseFilter". This is a 0x3E-byte struct. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x1 || FilterId |
| + | |- |
| + | | 0x1 || 0x1 || CondDataSize. Only used with CondType Manu. |
| + | |- |
| + | | 0x2 || 0x1 || CondType |
| + | |- |
| + | | 0x3 || 0x1D || CondData, content depends on CondType. |
| + | |- |
| + | | 0x20 || 0x1D || Mask. Only used with CondType Manu. +0 = u16 CompanyIdMask, then {pattern mask}. |
| + | |- |
| + | | 0x3D || 0x1 || MaskSize. Only used with CondType Manu. |
| + | |} |
| + | |
| + | CondType: |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Value |
| + | ! Name |
| + | ! Description |
| + | |- |
| + | | 2-3 || || ServiceUuid16. CondData = 16bit UUID which is byteswapped. |
| + | |- |
| + | | 4-5 || || ServiceUuid32. CondData = 32bit UUID which is byteswapped. |
| + | |- |
| + | | 6-7 || || ServiceUuid128. CondData = 128bit UUID which is copied raw into the param struct. |
| + | |- |
| + | | 255 || || Manu. CondData: u16 CompanyId, then {pattern data}. |
| + | |} |
| + | |
| + | To pass filtering, the BLE advert data should be: data & Mask == CondData (following the type field in the advert entry with the matching type). |
| | | |
| = BleAdvertisePacketParameter = | | = BleAdvertisePacketParameter = |
| This is "nn::bluetooth::BleAdvertisePacketParameter". This is a 8-byte struct with 1-byte alignment. | | This is "nn::bluetooth::BleAdvertisePacketParameter". This is a 8-byte struct with 1-byte alignment. |
| + | |
| + | [[BTM_services#StartBleScanForGeneral|StartBleScanForGeneral]] generates a [[#BleAdvertiseFilter]] from this. CondType = Manu, CondDataSize = 0xA. CondData: +0 = u16 CompanyId, u8 +2 = 0x1, +3 = {data copied from PatternData, then an u8 with value 0x0}. MaskSize = 0x9, Mask = {all 0xFF}. |
| + | |
| + | [[BTM_services#StartBleScanForPaired|StartBleScanForPaired]] generates a [[#BleAdvertiseFilter]] from this, similar to the above. CondType = Manu, CondDataSize = 0x11. CondData: +0 = u16 CompanyId, u8 +2 = 0x1, +3 = {data copied from PatternData, then an u8 with value 0x0, then {6-byte system btaddr}}. MaskSize = 0x10, Mask = {all 0xFF except u8 +0x9 which is 0x0}. |
| + | |
| + | {| class="wikitable" border="1" |
| + | |- |
| + | ! Offset |
| + | ! Size |
| + | ! Description |
| + | |- |
| + | | 0x0 || 0x2 || CompanyId |
| + | |- |
| + | | 0x2 || 0x6 || PatternData |
| + | |} |
| | | |
| = BleScanResult = | | = BleScanResult = |
Line 1,856: |
Line 1,930: |
| | 0x1 || 0x6 || [[#Address]] | | | 0x1 || 0x6 || [[#Address]] |
| |- | | |- |
− | | 0x8 || || Array of entries where each entry is 0x1F-bytes. hid compares +0 with 0xFF and +0x1 with the cached output from [[#BTM_services#GetBleScanParameterGeneral|GetBleScanParameterGeneral]] (entry+0x3 is skipped over). | + | | 0x7 || || Array of entries where each entry is 0x1F-bytes. hid compares +1 with 0xFF and +0x2 with the cached output from [[#BTM_services#GetBleScanParameterGeneral|GetBleScanParameterGeneral]] (entry+0x4 is skipped over). |
| |- | | |- |
| | 0x140 || 0x4 || s32 Total entries in the array at 0x8. | | | 0x140 || 0x4 || s32 Total entries in the array at 0x8. |
Line 1,889: |
Line 1,963: |
| ! Description | | ! Description |
| |- | | |- |
− | | 0x0 || 0x4 || UUID size, must be 0x2, 0x4, or 0x10. | + | | 0x0 || 0x4 || [[#BleGattUuid]] size. Must be 0x2, 0x4, or 0x10. |
| |- | | |- |
− | | 0x4 || 0x10 || UUID with the above size. | + | | 0x4 || 0x10 || [[#BleGattUuid]] with the above size. |
| |} | | |} |
| | | |
Line 1,910: |
Line 1,984: |
| |} | | |} |
| | | |
− | = LeEventType = | + | = BleGattUuid = |
− | This is an u32 enum. | + | This is an enum of u16, u32 and u128 values. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
| |- | | |- |
| ! Value | | ! Value |
− | ! Name
| |
| ! Description | | ! Description |
| |- | | |- |
− | | 0 || || | + | | 0x2902 || ClientConfigUuid16 |
| |- | | |- |
− | | 4 || || | + | | 0x2908 || ReportReferenceUuid16 |
| |- | | |- |
− | | 5 || || | + | | 0x1B666C080A578E83994EA7F7BF50DDA3 || PalmaOtafuControlPointUuid128 |
| |- | | |- |
− | | 6 || || | + | | 0x26FE2EE709244FB7914061D97A6CE8A2 || PalmaOtafuDataUuid128 |
| |- | | |- |
− | | 7 || || | + | | 0x45CEF889AF8E0784664404737C7FBE2B || NbatUuid128 |
| |- | | |- |
− | | 9 || || | + | | 0x46CEF889AF8E0784664404737C7FBE2B || BatteryLevelUuid128 |
| |- | | |- |
− | | 13 || || | + | | 0x47CEF889AF8E0784664404737C7FBE2B || BatteryStateUuid128 |
| |- | | |- |
− | | 16 || || | + | | 0xD88B7646729DBDA17A4425F4101126C7 || PalmaOtafuUuid128 |
| |- | | |- |
− | | 21 || || | + | | 0xE5237AE2516B55BB67456DF36CE17566 || NhogUuid128 |
| |- | | |- |
− | | 25 || || | + | | 0xE6237AE2516B55BB67456DF36CE17566 || InputReportUuid128 |
| |- | | |- |
− | | 35 || || | + | | 0xE7237AE2516B55BB67456DF36CE17566 || OutputCommandUuid128 |
| |- | | |- |
− | | 50 || || | + | | 0xE8237AE2516B55BB67456DF36CE17566 || CommandResponseUuid128 |
− | |-
| |
− | | 52 || ||
| |
− | |-
| |
− | | 55 || ||
| |
| |} | | |} |
| | | |
− | = BleClientGattOperationType = | + | = BleClientGattOperationStatus = |
− | This is an u8 enum. This is converted from [[#LeEventType]]. | + | This is an u8 enum. This is converted from the [[#LeEventInfo]] status field. |
| | | |
| {| class="wikitable" border="1" | | {| class="wikitable" border="1" |
Line 1,957: |
Line 2,026: |
| ! Description | | ! Description |
| |- | | |- |
− | | 0 || || Same as [[#LeEventType]] 0. | + | | 0 || || Same as [[#LeEventInfo]] status 0. |
| |- | | |- |
− | | 1 || || Same as [[#LeEventType]] 55. | + | | 1 || || Same as [[#LeEventInfo]] status 55. |
| |- | | |- |
− | | 2 || || Same as [[#LeEventType]] 25, 52. | + | | 2 || || Same as [[#LeEventInfo]] status 25, 52. |
| |- | | |- |
− | | 3 || || Same as [[#LeEventType]] 4, 16, 21, 50. | + | | 3 || || Same as [[#LeEventInfo]] status 4, 16, 21, 50. |
| |- | | |- |
− | | 4 || || Same as [[#LeEventType]] 5. | + | | 4 || || Same as [[#LeEventInfo]] status 5. |
| |- | | |- |
− | | 5 || || Same as [[#LeEventType]] 6. | + | | 5 || || Same as [[#LeEventInfo]] status 6. |
| |- | | |- |
− | | 6 || || Same as [[#LeEventType]] 7. | + | | 6 || || Same as [[#LeEventInfo]] status 7. |
| |- | | |- |
− | | 7 || || Same as [[#LeEventType]] 9. | + | | 7 || || Same as [[#LeEventInfo]] status 9. |
| |- | | |- |
− | | 8 || || Same as [[#LeEventType]] 13. | + | | 8 || || Same as [[#LeEventInfo]] status 13. |
| |- | | |- |
− | | 9 || || Used as the default case when the [[#LeEventType]] is unrecognized. | + | | 9 || || Used as the default case when the [[#LeEventInfo]] status is unrecognized. |
| |- | | |- |
− | | 10 || || Same as [[#LeEventType]] 35. | + | | 10 || || Same as [[#LeEventInfo]] status 35. |
| |} | | |} |
| | | |
Line 1,989: |
Line 2,058: |
| ! Description | | ! Description |
| |- | | |- |
− | | 0x0 || 0x4 || [[#LeEventType]] | + | | 0x0 || 0x4 || Status. 0 = success, non-zero = error. |
| |- | | |- |
− | | 0x4 || 0x4 || | + | | 0x4 || 0x4 || ConnectionId |
| |- | | |- |
− | | 0x8 || 0x1 || | + | | 0x8 || 0x1 || Flags. Bit0 = IsWrite, bit1 = IsDescriptor, bit2 = IsNotify. |
| + | When bit2 is set, bit0 = IsIndication. |
| |- | | |- |
| | 0x9 || 0x3 || Padding | | | 0x9 || 0x3 || Padding |
| |- | | |- |
− | | 0xC || 0x14 || [[#GattAttributeUuid]] | + | | 0xC || 0x14 || Service [[#GattAttributeUuid]] |
| |- | | |- |
− | | 0x20 || 0x14 || [[#GattAttributeUuid]] | + | | 0x20 || 0x14 || Characteristic [[#GattAttributeUuid]] |
| |- | | |- |
− | | 0x34 || 0x14 || [[#GattAttributeUuid]] | + | | 0x34 || 0x14 || Descriptor [[#GattAttributeUuid]] |
| |- | | |- |
| | 0x48 || 0x2 || Size of the below data. | | | 0x48 || 0x2 || Size of the below data. |
| |- | | |- |
− | | 0x4A || {above size} || Data. | + | | 0x4A || 0x200 || Data with the above size. |
| |} | | |} |
| | | |
Line 2,017: |
Line 2,087: |
| ! Description | | ! Description |
| |- | | |- |
− | | 0x0 || 0x1 || [[#BleClientGattOperationType]] | + | | 0x0 || 0x1 || [[#BleClientGattOperationStatus]] |
| |- | | |- |
| | 0x1 || 0x3 || Padding | | | 0x1 || 0x3 || Padding |
Line 2,222: |
Line 2,292: |
| | CYW4356A3_001.004.009.0092.0095 | | | CYW4356A3_001.004.009.0092.0095 |
| |- | | |- |
− | | [12.0.0-13.1.0] | + | | [12.0.0-14.1.2] |
| | BSA0106_01.60.00_ | | | BSA0106_01.60.00_ |
| | Hayward_T3_RC_20210224 | | | Hayward_T3_RC_20210224 |
| | CYW4356A3_001.004.009.0092.0095 | | | CYW4356A3_001.004.009.0092.0095 |
| + | |- |
| + | | [15.0.0-18.0.0] |
| + | | BSA0106_01.60.00_ |
| + | | Hayward_T3_RC_20210224 |
| + | | BCM4356A3 UART 37.4 MHz wlbga_bu |
| |} | | |} |
| | | |
| <code>bsa_sv_tm_read_version_excback</code> copies bsa_version_string and concats with bsa_version_info_string to generate <code>tBSA_TM_READ_VERSION.bsa_server_version</code>. | | <code>bsa_sv_tm_read_version_excback</code> copies bsa_version_string and concats with bsa_version_info_string to generate <code>tBSA_TM_READ_VERSION.bsa_server_version</code>. |
| + | |
| + | * [15.0.0]: In the HCI memwrite data, only config data was changed, no code changes. |
| | | |
| [[Category:Services]] | | [[Category:Services]] |