Bluetooth driver (btdrv) service IPC wrapper. More...

#include "../types.h"
#include "../kernel/event.h"
#include "../services/btdrv_types.h"
#include "../services/set.h"
#include "../sf/service.h"

Data Structures
struct	BtdrvEventInfo
	Data for btdrvGetEventInfo. The data stored here depends on the BtdrvEventType. More...

struct	BtdrvHidEventInfo
	Data for btdrvGetHidEventInfo. The data stored here depends on the BtdrvHidEventType. More...

struct	BtdrvHidReportEventInfo
	Data for btdrvGetHidReportEventInfo. The data stored here depends on the BtdrvHidEventType. More...

struct	BtdrvHidReportEventInfoBufferData
	The raw sharedmem data for HidReportEventInfo. More...

union	BtdrvAudioEventInfo
	Data for btdrvGetAudioEventInfo. The data stored here depends on the BtdrvAudioEventType. More...

struct	BtdrvCircularBuffer
	CircularBuffer. More...

struct	BtdrvBleEventInfo
	Data for btdrvGetBleManagedEventInfo and btdrvGetLeHidEventInfo. The data stored here depends on the BtdrvBleEventType. More...

Functions
Result	btdrvInitialize (void)
	Initialize btdrv.

void	btdrvExit (void)
	Exit btdrv.

Service *	btdrvGetServiceSession (void)
	Gets the Service object for the actual btdrv service session.

Result	btdrvInitializeBluetooth (Event *out_event)
	InitializeBluetooth.

Result	btdrvEnableBluetooth (void)
	EnableBluetooth.

Result	btdrvDisableBluetooth (void)
	DisableBluetooth.

Result	btdrvFinalizeBluetooth (void)
	FinalizeBluetooth.

Result	btdrvLegacyGetAdapterProperties (BtdrvAdapterPropertyOld *properties)
	GetAdapterProperties [1.0.0-11.0.1].

Result	btdrvGetAdapterProperties (BtdrvAdapterPropertySet *properties)
	GetAdapterProperties [12.0.0+].

Result	btdrvLegacyGetAdapterProperty (BtdrvBluetoothPropertyType type, void *buffer, size_t size)
	GetAdapterProperty [1.0.0-11.0.1].

Result	btdrvGetAdapterProperty (BtdrvAdapterPropertyType type, BtdrvAdapterProperty *property)
	GetAdapterProperty [12.0.0+].

Result	btdrvLegacySetAdapterProperty (BtdrvBluetoothPropertyType type, const void *buffer, size_t size)
	SetAdapterProperty [1.0.0-11.0.1].

Result	btdrvSetAdapterProperty (BtdrvAdapterPropertyType type, const BtdrvAdapterProperty *property)
	SetAdapterProperty [12.0.0+].

Result	btdrvLegacyStartInquiry (void)
	StartInquiry [1.0.0-11.0.1].

Result	btdrvStartInquiry (u32 services, s64 duration)
	StartInquiry [12.0.0+].

Result	btdrvStopInquiry (void)
	This stops Inquiry which was started by btdrvStartInquiry, if it's still active.

Result	btdrvCreateBond (BtdrvAddress addr, u32 type)
	CreateBond.

Result	btdrvRemoveBond (BtdrvAddress addr)
	RemoveBond.

Result	btdrvCancelBond (BtdrvAddress addr)
	CancelBond.

Result	btdrvLegacyRespondToPinRequest (BtdrvAddress addr, bool flag, const BtdrvBluetoothPinCode *pin_code, u8 length)
	RespondToPinRequest [1.0.0-11.0.1].

Result	btdrvRespondToPinRequest (BtdrvAddress addr, const BtdrvPinCode *pin_code)
	RespondToPinRequest [12.0.0+].

Result	btdrvRespondToSspRequest (BtdrvAddress addr, u32 variant, bool accept, u32 passkey)
	RespondToSspRequest.

Result	btdrvGetEventInfo (void buffer, size_t size, BtdrvEventType type)
	GetEventInfo.

Result	btdrvInitializeHid (Event *out_event)
	InitializeHid.

Result	btdrvOpenHidConnection (BtdrvAddress addr)
	OpenHidConnection.

Result	btdrvCloseHidConnection (BtdrvAddress addr)
	CloseHidConnection.

Result	btdrvWriteHidData (BtdrvAddress addr, const BtdrvHidReport *buffer)
	This sends a HID DATA transaction packet with report-type Output.

Result	btdrvWriteHidData2 (BtdrvAddress addr, const void *buffer, size_t size)
	WriteHidData2.

Result	btdrvSetHidReport (BtdrvAddress addr, BtdrvBluetoothHhReportType type, const BtdrvHidReport *buffer)
	This sends a HID SET_REPORT transaction packet.

Result	btdrvGetHidReport (BtdrvAddress addr, u8 report_id, BtdrvBluetoothHhReportType type)
	This sends a HID GET_REPORT transaction packet.

Result	btdrvTriggerConnection (BtdrvAddress addr, u16 timeout)
	TriggerConnection.

Result	btdrvAddPairedDeviceInfo (const SetSysBluetoothDevicesSettings *settings)
	AddPairedDeviceInfo.

Result	btdrvGetPairedDeviceInfo (BtdrvAddress addr, SetSysBluetoothDevicesSettings *settings)
	GetPairedDeviceInfo.

Result	btdrvFinalizeHid (void)
	FinalizeHid.

Result	btdrvGetHidEventInfo (void buffer, size_t size, BtdrvHidEventType type)
	GetHidEventInfo.

Result	btdrvSetTsi (BtdrvAddress addr, u8 tsi)
	SetTsi.

Result	btdrvEnableBurstMode (BtdrvAddress addr, bool flag)
	EnableBurstMode.

Result	btdrvSetZeroRetransmission (BtdrvAddress addr, u8 *report_ids, u8 count)
	SetZeroRetransmission.

Result	btdrvEnableMcMode (bool flag)
	EnableMcMode.

Result	btdrvEnableLlrScan (void)
	EnableLlrScan.

Result	btdrvDisableLlrScan (void)
	DisableLlrScan.

Result	btdrvEnableRadio (bool flag)
	EnableRadio.

Result	btdrvSetVisibility (bool inquiry_scan, bool page_scan)
	SetVisibility.

Result	btdrvEnableTbfcScan (bool flag)
	EnableTbfcScan.

Result	btdrvRegisterHidReportEvent (Event *out_event)
	RegisterHidReportEvent.

Result	btdrvGetHidReportEventInfo (void buffer, size_t size, BtdrvHidEventType type)
	GetHidReportEventInfo.

void *	btdrvGetHidReportEventInfoSharedmemAddr (void)
	Gets the SharedMemory addr for HidReportEventInfo (BtdrvCircularBuffer), only valid when btdrvRegisterHidReportEvent was previously used, on [7.0.0+].

Result	btdrvGetLatestPlr (BtdrvPlrList *out)
	GetLatestPlr.

Result	btdrvGetPendingConnections (void)
	GetPendingConnections.

Result	btdrvGetChannelMap (BtdrvChannelMapList *out)
	GetChannelMap.

Result	btdrvEnableTxPowerBoostSetting (bool flag)
	EnableTxPowerBoostSetting.

Result	btdrvIsTxPowerBoostSettingEnabled (bool *out)
	IsTxPowerBoostSettingEnabled.

Result	btdrvEnableAfhSetting (bool flag)
	EnableAfhSetting.

Result	btdrvIsAfhSettingEnabled (bool *out)
	IsAfhSettingEnabled.

Result	btdrvInitializeBle (Event *out_event)
	InitializeBle.

Result	btdrvEnableBle (void)
	EnableBle.

Result	btdrvDisableBle (void)
	DisableBle.

Result	btdrvFinalizeBle (void)
	FinalizeBle.

Result	btdrvSetBleVisibility (bool discoverable, bool connectable)
	SetBleVisibility.

Result	btdrvSetLeConnectionParameter (const BtdrvLeConnectionParams *param)
	SetLeConnectionParameter.

Result	btdrvSetBleConnectionParameter (BtdrvAddress addr, const BtdrvBleConnectionParameter *param, bool preference)
	SetBleConnectionParameter.

Result	btdrvSetLeDefaultConnectionParameter (const BtdrvLeConnectionParams *param)
	SetLeDefaultConnectionParameter.

Result	btdrvSetBleDefaultConnectionParameter (const BtdrvBleConnectionParameter *param)
	SetBleDefaultConnectionParameter.

Result	btdrvSetBleAdvertiseData (const BtdrvBleAdvertisePacketData *data)
	SetBleAdvertiseData.

Result	btdrvSetBleAdvertiseParameter (BtdrvAddress addr, u16 min_interval, u16 max_interval)
	SetBleAdvertiseParameter.

Result	btdrvStartBleScan (void)
	StartBleScan.

Result	btdrvStopBleScan (void)
	StopBleScan.

Result	btdrvAddBleScanFilterCondition (const BtdrvBleAdvertiseFilter *filter)
	AddBleScanFilterCondition.

Result	btdrvDeleteBleScanFilterCondition (const BtdrvBleAdvertiseFilter *filter)
	DeleteBleScanFilterCondition.

Result	btdrvDeleteBleScanFilter (u8 index)
	DeleteBleScanFilter.

Result	btdrvClearBleScanFilters (void)
	ClearBleScanFilters.

Result	btdrvEnableBleScanFilter (bool flag)
	EnableBleScanFilter.

Result	btdrvRegisterGattClient (const BtdrvGattAttributeUuid *uuid)
	RegisterGattClient.

Result	btdrvUnregisterGattClient (u8 client_if)
	UnregisterGattClient.

Result	btdrvUnregisterAllGattClients (void)
	UnregisterAllGattClients.

Result	btdrvConnectGattServer (u8 client_if, BtdrvAddress addr, bool is_direct, u64 AppletResourceUserId)
	ConnectGattServer.

Result	btdrvCancelConnectGattServer (u8 client_if, BtdrvAddress addr, bool is_direct)
	CancelConnectGattServer.

Result	btdrvDisconnectGattServer (u32 conn_id)
	DisconnectGattServer.

Result	btdrvGetGattAttribute (BtdrvAddress addr, u32 conn_id)
	GetGattAttribute.

Result	btdrvGetGattService (u32 conn_id, const BtdrvGattAttributeUuid *uuid)
	GetGattService.

Result	btdrvConfigureAttMtu (u32 conn_id, u16 mtu)
	ConfigureAttMtu.

Result	btdrvRegisterGattServer (const BtdrvGattAttributeUuid *uuid)
	RegisterGattServer.

Result	btdrvUnregisterGattServer (u8 server_if)
	UnregisterGattServer.

Result	btdrvConnectGattClient (u8 server_if, BtdrvAddress addr, bool is_direct)
	ConnectGattClient.

Result	btdrvDisconnectGattClient (u8 conn_id, BtdrvAddress addr)
	DisconnectGattClient.

Result	btdrvAddGattService (u8 server_if, const BtdrvGattAttributeUuid *uuid, u8 num_handle, bool is_primary)
	AddGattService.

Result	btdrvEnableGattService (u8 server_if, const BtdrvGattAttributeUuid *uuid)
	EnableGattService.

Result	btdrvAddGattCharacteristic (u8 server_if, const BtdrvGattAttributeUuid serv_uuid, const BtdrvGattAttributeUuid char_uuid, u16 permissions, u8 property)
	AddGattCharacteristic.

Result	btdrvAddGattDescriptor (u8 server_if, const BtdrvGattAttributeUuid serv_uuid, const BtdrvGattAttributeUuid desc_uuid, u16 permissions)
	AddGattDescriptor.

Result	btdrvGetBleManagedEventInfo (void buffer, size_t size, BtdrvBleEventType type)
	GetBleManagedEventInfo.

Result	btdrvGetGattFirstCharacteristic (u32 conn_id, const BtdrvGattId serv_id, bool is_primary, const BtdrvGattAttributeUuid filter_uuid, u8 out_property, BtdrvGattId out_char_id)
	GetGattFirstCharacteristic.

Result	btdrvGetGattNextCharacteristic (u32 conn_id, const BtdrvGattId serv_id, bool is_primary, const BtdrvGattId char_id, const BtdrvGattAttributeUuid filter_uuid, u8 out_property, BtdrvGattId *out_char_id)
	GetGattNextCharacteristic.

Result	btdrvGetGattFirstDescriptor (u32 conn_id, const BtdrvGattId serv_id, bool is_primary, const BtdrvGattId char_id, const BtdrvGattAttributeUuid filter_uuid, BtdrvGattId out_desc_id)
	GetGattFirstDescriptor.

Result	btdrvGetGattNextDescriptor (u32 conn_id, const BtdrvGattId serv_id, bool is_primary, const BtdrvGattId char_id, const BtdrvGattId desc_id, const BtdrvGattAttributeUuid filter_uuid, BtdrvGattId *out_desc_id)
	GetGattNextDescriptor.

Result	btdrvRegisterGattManagedDataPath (const BtdrvGattAttributeUuid *uuid)
	RegisterGattManagedDataPath.

Result	btdrvUnregisterGattManagedDataPath (const BtdrvGattAttributeUuid *uuid)
	UnregisterGattManagedDataPath.

Result	btdrvRegisterGattHidDataPath (const BtdrvGattAttributeUuid *uuid)
	RegisterGattHidDataPath.

Result	btdrvUnregisterGattHidDataPath (const BtdrvGattAttributeUuid *uuid)
	UnregisterGattHidDataPath.

Result	btdrvRegisterGattDataPath (const BtdrvGattAttributeUuid *uuid)
	RegisterGattDataPath.

Result	btdrvUnregisterGattDataPath (const BtdrvGattAttributeUuid *uuid)
	UnregisterGattDataPath.

Result	btdrvReadGattCharacteristic (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id, u8 auth_req)
	ReadGattCharacteristic.

Result	btdrvReadGattDescriptor (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id, const BtdrvGattId *desc_id, u8 auth_req)
	ReadGattDescriptor.

Result	btdrvWriteGattCharacteristic (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id, const void *buffer, size_t size, u8 auth_req, bool with_response)
	WriteGattCharacteristic.

Result	btdrvWriteGattDescriptor (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id, const BtdrvGattId desc_id, const void buffer, size_t size, u8 auth_req)
	WriteGattDescriptor.

Result	btdrvRegisterGattNotification (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id)
	RegisterGattNotification.

Result	btdrvUnregisterGattNotification (u32 connection_handle, bool is_primary, const BtdrvGattId serv_id, const BtdrvGattId char_id)
	UnregisterGattNotification.

Result	btdrvGetLeHidEventInfo (void buffer, size_t size, BtdrvBleEventType type)
	GetLeHidEventInfo.

Result	btdrvRegisterBleHidEvent (Event *out_event)
	RegisterBleHidEvent.

Result	btdrvSetBleScanParameter (u16 scan_interval, u16 scan_window)
	SetBleScanParameter.

Result	btdrvMoveToSecondaryPiconet (BtdrvAddress addr)
	MoveToSecondaryPiconet.

Result	btdrvIsBluetoothEnabled (bool *out)
	IsBluetoothEnabled.

Result	btdrvAcquireAudioEvent (Event *out_event, bool autoclear)
	AcquireAudioEvent.

Result	btdrvGetAudioEventInfo (void buffer, size_t size, BtdrvAudioEventType type)
	GetAudioEventInfo.

Result	btdrvOpenAudioConnection (BtdrvAddress addr)
	OpenAudioConnection.

Result	btdrvCloseAudioConnection (BtdrvAddress addr)
	CloseAudioConnection.

Result	btdrvOpenAudioOut (BtdrvAddress addr, u32 *audio_handle)
	OpenAudioOut.

Result	btdrvCloseAudioOut (u32 audio_handle)
	CloseAudioOut.

Result	btdrvStartAudioOut (u32 audio_handle, const BtdrvPcmParameter pcm_param, s64 in_latency, s64 out_latency, u64 *out1)
	StartAudioOut.

Result	btdrvStopAudioOut (u32 audio_handle)
	StopAudioOut.

Result	btdrvGetAudioOutState (u32 audio_handle, BtdrvAudioOutState *out)
	GetAudioOutState.

Result	btdrvGetAudioOutFeedingCodec (u32 audio_handle, BtdrvAudioCodec *out)
	GetAudioOutFeedingCodec.

Result	btdrvGetAudioOutFeedingParameter (u32 audio_handle, BtdrvPcmParameter *out)
	GetAudioOutFeedingParameter.

Result	btdrvAcquireAudioOutStateChangedEvent (u32 audio_handle, Event *out_event, bool autoclear)
	AcquireAudioOutStateChangedEvent.

Result	btdrvAcquireAudioOutBufferAvailableEvent (u32 audio_handle, Event *out_event, bool autoclear)
	AcquireAudioOutBufferAvailableEvent.

Result	btdrvSendAudioData (u32 audio_handle, const void buffer, size_t size, u64 transferred_size)
	SendAudioData.

Result	btdrvAcquireAudioControlInputStateChangedEvent (Event *out_event, bool autoclear)
	AcquireAudioControlInputStateChangedEvent.

Result	btdrvGetAudioControlInputState (BtdrvAudioControlButtonState states, s32 count, s32 total_out)
	GetAudioControlInputState.

Result	btdrvAcquireAudioConnectionStateChangedEvent (Event *out_event, bool autoclear)
	AcquireAudioConnectionStateChangedEvent.

Result	btdrvGetConnectedAudioDevice (BtdrvAddress addrs, s32 count, s32 total_out)
	GetConnectedAudioDevice.

Result	btdrvCloseAudioControlInput (BtdrvAddress addr)
	CloseAudioControlInput.

Result	btdrvRegisterAudioControlNotification (BtdrvAddress addr, u32 event_type)
	RegisterAudioControlNotification.

Result	btdrvSendAudioControlPassthroughCommand (BtdrvAddress addr, u32 op_id, u32 state_type)
	SendAudioControlPassthroughCommand.

Result	btdrvSendAudioControlSetAbsoluteVolumeCommand (BtdrvAddress addr, s32 val)
	SendAudioControlSetAbsoluteVolumeCommand.

Result	btdrvIsManufacturingMode (bool *out)
	IsManufacturingMode.

Result	btdrvEmulateBluetoothCrash (BtdrvFatalReason reason)
	EmulateBluetoothCrash.

Result	btdrvGetBleChannelMap (BtdrvChannelMapList *out)
	GetBleChannelMap.

CircularBuffer
void *	btdrvCircularBufferRead (BtdrvCircularBuffer *c)
	Read.

bool	btdrvCircularBufferFree (BtdrvCircularBuffer *c)
	Free.

Detailed Description

Bluetooth driver (btdrv) service IPC wrapper.

Author: yellows8, ndeadly

Copyright: libnx Authors

Function Documentation

◆ btdrvAcquireAudioConnectionStateChangedEvent()

Result btdrvAcquireAudioConnectionStateChangedEvent	(	Event *	out_event,
		bool	autoclear
	)

AcquireAudioConnectionStateChangedEvent.

Note: Only available on [12.0.0-13.2.1].

Parameters

[out]	out_event	Output Event.
[in]	autoclear	Event autoclear.

◆ btdrvAcquireAudioControlInputStateChangedEvent()

Result btdrvAcquireAudioControlInputStateChangedEvent	(	Event *	out_event,
		bool	autoclear
	)

AcquireAudioControlInputStateChangedEvent.

Note: Only available on [12.0.0+].

Parameters

[out]	out_event	Output Event.
[in]	autoclear	Event autoclear.

◆ btdrvAcquireAudioEvent()

Result btdrvAcquireAudioEvent	(	Event *	out_event,
		bool	autoclear
	)

AcquireAudioEvent.

Note: Only available on [12.0.0+].

Parameters

[out]	out_event	Output Event.
[in]	autoclear	Event autoclear.

◆ btdrvAcquireAudioOutBufferAvailableEvent()

Result btdrvAcquireAudioOutBufferAvailableEvent	(	u32	audio_handle,
		Event *	out_event,
		bool	autoclear
	)

AcquireAudioOutBufferAvailableEvent.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[out]	out_event	Output Event.
[in]	autoclear	Event autoclear.

◆ btdrvAcquireAudioOutStateChangedEvent()

Result btdrvAcquireAudioOutStateChangedEvent	(	u32	audio_handle,
		Event *	out_event,
		bool	autoclear
	)

AcquireAudioOutStateChangedEvent.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[out]	out_event	Output Event.
[in]	autoclear	Event autoclear.

◆ btdrvAddBleScanFilterCondition()

Result btdrvAddBleScanFilterCondition ( const BtdrvBleAdvertiseFilter * filter )

AddBleScanFilterCondition.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] filter BtdrvBleAdvertiseFilter

◆ btdrvAddGattCharacteristic()

Result btdrvAddGattCharacteristic	(	u8	server_if,
		const BtdrvGattAttributeUuid *	serv_uuid,
		const BtdrvGattAttributeUuid *	char_uuid,
		u16	permissions,
		u8	property
	)

AddGattCharacteristic.

Note: Only available on [5.0.0+].; Broken behaviour due to internal bugs.

Parameters

[in]	server_if	Server interface ID
[in]	serv_uuid	Service UUID BtdrvGattAttributeUuid
[in]	char_uuid	Characteristic UUID BtdrvGattAttributeUuid
[in]	permissions	BtdrvGattAttributePermission
[in]	property	BtdrvGattCharacteristicProperty

◆ btdrvAddGattDescriptor()

Result btdrvAddGattDescriptor	(	u8	server_if,
		const BtdrvGattAttributeUuid *	serv_uuid,
		const BtdrvGattAttributeUuid *	desc_uuid,
		u16	permissions
	)

AddGattDescriptor.

Note: Only available on [5.0.0+].; Broken behaviour due to internal bugs.

Parameters

[in]	server_if	Server interface ID
[in]	serv_uuid	Service UUID BtdrvGattAttributeUuid
[in]	desc_uuid	Descriptor UUID BtdrvGattAttributeUuid
[in]	permissions	BtdrvGattAttributePermission

◆ btdrvAddGattService()

Result btdrvAddGattService	(	u8	server_if,
		const BtdrvGattAttributeUuid *	uuid,
		u8	num_handle,
		bool	is_primary
	)

AddGattService.

Note: Only available on [5.0.0+].; Broken behaviour due to internal bugs.

Parameters

[in]	server_if	Server interface ID
[in]	uuid	BtdrvGattAttributeUuid
[in]	num_handle	Number of handles
[in]	is_primary	Is a primary service or not

◆ btdrvAddPairedDeviceInfo()

Result btdrvAddPairedDeviceInfo ( const SetSysBluetoothDevicesSettings * settings )

AddPairedDeviceInfo.

Note: This is used by btm-sysmodule.

Parameters

[in] settings SetSysBluetoothDevicesSettings

◆ btdrvCancelBond()

Result btdrvCancelBond ( BtdrvAddress addr )

CancelBond.

Note: This is used by btm-sysmodule.

Parameters

[in] addr BtdrvAddress

◆ btdrvCancelConnectGattServer()

Result btdrvCancelConnectGattServer	(	u8	client_if,
		BtdrvAddress	addr,
		bool	is_direct
	)

CancelConnectGattServer.

Note: Only available on [5.1.0+].; This is used by btm-sysmodule.

Parameters

[in]	client_if	Client interface ID
[in]	addr	BtdrvAddress
[in]	is_direct	Whether a direct connection or a background auto connection

◆ btdrvCircularBufferFree()

bool btdrvCircularBufferFree ( BtdrvCircularBuffer * c )

Free.

Note: Used by btdrvGetHidReportEventInfo on [7.0.0+].

Parameters

c	BtdrvCircularBuffer

◆ btdrvCircularBufferRead()

void * btdrvCircularBufferRead ( BtdrvCircularBuffer * c )

Read.

Note: Used by btdrvGetHidReportEventInfo on [7.0.0+].

Parameters

c	BtdrvCircularBuffer

◆ btdrvClearBleScanFilters()

Result btdrvClearBleScanFilters ( void )

ClearBleScanFilters.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

◆ btdrvCloseAudioConnection()

Result btdrvCloseAudioConnection ( BtdrvAddress addr )

CloseAudioConnection.

Note: Only available on [12.0.0+].

Parameters

[in] addr BtdrvAddress

◆ btdrvCloseAudioControlInput()

Result btdrvCloseAudioControlInput ( BtdrvAddress addr )

CloseAudioControlInput.

Note: Only available on [13.0.0+].

Parameters

[in] addr BtdrvAddress

◆ btdrvCloseAudioOut()

Result btdrvCloseAudioOut ( u32 audio_handle )

CloseAudioOut.

Note: Only available on [12.0.0+].

Parameters

[in] audio_handle Audio handle from btdrvOpenAudioOut.

◆ btdrvCloseHidConnection()

Result btdrvCloseHidConnection ( BtdrvAddress addr )

CloseHidConnection.

Note: This is used by btm-sysmodule.

Parameters

[in] addr BtdrvAddress

◆ btdrvConfigureAttMtu()

Result btdrvConfigureAttMtu	(	u32	conn_id,
		u16	mtu
	)

ConfigureAttMtu.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in]	conn_id	Connection ID
[in]	mtu	MTU

◆ btdrvConnectGattClient()

Result btdrvConnectGattClient	(	u8	server_if,
		BtdrvAddress	addr,
		bool	is_direct
	)

ConnectGattClient.

Note: Only available on [5.0.0+].

Parameters

[in]	server_if	Server interface ID
[in]	addr	BtdrvAddress
[in]	is_direct	Whether a direct connection or a background auto connection

◆ btdrvConnectGattServer()

Result btdrvConnectGattServer	(	u8	client_if,
		BtdrvAddress	addr,
		bool	is_direct,
		u64	AppletResourceUserId
	)

ConnectGattServer.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in]	client_if	Client interface ID
[in]	addr	BtdrvAddress
[in]	is_direct	Whether a direct connection or a background auto connection
[in]	AppletResourceUserId	AppletResourceUserId

◆ btdrvCreateBond()

Result btdrvCreateBond	(	BtdrvAddress	addr,
		u32	type
	)

CreateBond.

Note: This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	type	TransportType

◆ btdrvDeleteBleScanFilter()

Result btdrvDeleteBleScanFilter ( u8 index )

DeleteBleScanFilter.

Note: Only available on [5.0.0+].

Parameters

[in] index Filter index

◆ btdrvDeleteBleScanFilterCondition()

Result btdrvDeleteBleScanFilterCondition ( const BtdrvBleAdvertiseFilter * filter )

DeleteBleScanFilterCondition.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] filter BtdrvBleAdvertiseFilter

◆ btdrvDisableBle()

Result btdrvDisableBle ( void )

DisableBle.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

◆ btdrvDisableBluetooth()

Result btdrvDisableBluetooth ( void )

DisableBluetooth.

Note: This is used by btm-sysmodule.

◆ btdrvDisableLlrScan()

Result btdrvDisableLlrScan ( void )

DisableLlrScan.

Note: This is used by btm-sysmodule.

◆ btdrvDisconnectGattClient()

Result btdrvDisconnectGattClient	(	u8	conn_id,
		BtdrvAddress	addr
	)

DisconnectGattClient.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	addr	BtdrvAddress, only used on pre-9.0.0.

◆ btdrvDisconnectGattServer()

Result btdrvDisconnectGattServer ( u32 conn_id )

DisconnectGattServer.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] conn_id Connection ID

◆ btdrvEmulateBluetoothCrash()

Result btdrvEmulateBluetoothCrash ( BtdrvFatalReason reason )

EmulateBluetoothCrash.

Note: Only available on [7.0.0+].

Parameters

[in] reason BtdrvFatalReason

◆ btdrvEnableAfhSetting()

Result btdrvEnableAfhSetting ( bool flag )

EnableAfhSetting.

Note: Only available on [3.0.0+].

Parameters

[in] flag Input flag.

◆ btdrvEnableBle()

Result btdrvEnableBle ( void )

EnableBle.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

◆ btdrvEnableBleScanFilter()

Result btdrvEnableBleScanFilter ( bool flag )

EnableBleScanFilter.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] flag Flag

◆ btdrvEnableBluetooth()

Result btdrvEnableBluetooth ( void )

EnableBluetooth.

Note: This is used by btm-sysmodule.

◆ btdrvEnableBurstMode()

Result btdrvEnableBurstMode	(	BtdrvAddress	addr,
		bool	flag
	)

EnableBurstMode.

Note: The response will be available via btdrvGetHidEventInfo ([12.0.0+] btdrvGetEventInfo).; This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	flag	Flag: true = Set, false = Exit.

◆ btdrvEnableGattService()

Result btdrvEnableGattService	(	u8	server_if,
		const BtdrvGattAttributeUuid *	uuid
	)

EnableGattService.

Note: Only available on [5.0.0+].; Broken behaviour due to internal bugs.

Parameters

[in]	server_if	Server interface ID
[in]	uuid	BtdrvGattAttributeUuid

◆ btdrvEnableLlrScan()

Result btdrvEnableLlrScan ( void )

EnableLlrScan.

Note: This is used by btm-sysmodule.

◆ btdrvEnableMcMode()

Result btdrvEnableMcMode ( bool flag )

EnableMcMode.

Note: This is used by btm-sysmodule.

Parameters

[in] flag Flag

◆ btdrvEnableRadio()

Result btdrvEnableRadio ( bool flag )

EnableRadio.

Note: This is used by btm-sysmodule.

Parameters

[in] flag Flag

◆ btdrvEnableTbfcScan()

Result btdrvEnableTbfcScan ( bool flag )

EnableTbfcScan.

Note: Only available on [4.0.0+].; This is used by btm-sysmodule.

Parameters

[in] flag Flag

◆ btdrvEnableTxPowerBoostSetting()

Result btdrvEnableTxPowerBoostSetting ( bool flag )

EnableTxPowerBoostSetting.

Note: Only available on [3.0.0+].

Parameters

[in] flag Input flag.

◆ btdrvFinalizeBle()

Result btdrvFinalizeBle ( void )

FinalizeBle.

Note: Only available on [5.0.0+].

◆ btdrvFinalizeBluetooth()

Result btdrvFinalizeBluetooth ( void )

FinalizeBluetooth.

Note: This is not used by btm-sysmodule, this should not be used by other processes.

◆ btdrvFinalizeHid()

Result btdrvFinalizeHid ( void )

FinalizeHid.

Note: This is not used by btm-sysmodule, this should not be used by other processes.

◆ btdrvGetAdapterProperties()

Result btdrvGetAdapterProperties ( BtdrvAdapterPropertySet * properties )

GetAdapterProperties [12.0.0+].

Parameters

[out] properties BtdrvAdapterPropertySet

◆ btdrvGetAdapterProperty()

Result btdrvGetAdapterProperty	(	BtdrvAdapterPropertyType	type,
		BtdrvAdapterProperty *	property
	)

GetAdapterProperty [12.0.0+].

Parameters

[in]	type	BtdrvAdapterPropertyType
[in]	property	BtdrvAdapterProperty

◆ btdrvGetAudioControlInputState()

Result btdrvGetAudioControlInputState	(	BtdrvAudioControlButtonState *	states,
		s32	count,
		s32 *	total_out
	)

GetAudioControlInputState.

Note: Only available on [12.0.0+].

Parameters

[out]	states	Output array of BtdrvAudioControlButtonState.
[in]	count	Size of the states array in entries, the maximum is 0xF.
[out]	total_out	Total output entries.

◆ btdrvGetAudioEventInfo()

Result btdrvGetAudioEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvAudioEventType *	type
	)

GetAudioEventInfo.

Note: Only available on [12.0.0+].

Parameters

[out]	buffer	Output buffer, see BtdrvAudioEventInfo.
[in]	size	Output buffer size.
[out]	type	BtdrvAudioEventType.

◆ btdrvGetAudioOutFeedingCodec()

Result btdrvGetAudioOutFeedingCodec	(	u32	audio_handle,
		BtdrvAudioCodec *	out
	)

GetAudioOutFeedingCodec.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[out]	out	BtdrvAudioCodec

◆ btdrvGetAudioOutFeedingParameter()

Result btdrvGetAudioOutFeedingParameter	(	u32	audio_handle,
		BtdrvPcmParameter *	out
	)

GetAudioOutFeedingParameter.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[out]	out	BtdrvPcmParameter

◆ btdrvGetAudioOutState()

Result btdrvGetAudioOutState	(	u32	audio_handle,
		BtdrvAudioOutState *	out
	)

GetAudioOutState.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[out]	out	BtdrvAudioOutState

◆ btdrvGetBleChannelMap()

Result btdrvGetBleChannelMap ( BtdrvChannelMapList * out )

GetBleChannelMap.

Note: Only available on [9.0.0+].

Parameters

[out] out BtdrvChannelMapList

◆ btdrvGetBleManagedEventInfo()

Result btdrvGetBleManagedEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvBleEventType *	type
	)

GetBleManagedEventInfo.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[out]	buffer	Output buffer. 0x400-bytes from state is written here. See BtdrvBleEventInfo.
[in]	size	Output buffer size.
[out]	type	Output BtdrvBleEventType.

◆ btdrvGetChannelMap()

Result btdrvGetChannelMap ( BtdrvChannelMapList * out )

GetChannelMap.

Note: Only available on [3.0.0+].

Parameters

[out] out BtdrvChannelMapList

◆ btdrvGetConnectedAudioDevice()

Result btdrvGetConnectedAudioDevice	(	BtdrvAddress *	addrs,
		s32	count,
		s32 *	total_out
	)

GetConnectedAudioDevice.

Note: Only available on [12.0.0-13.2.1].

Parameters

[out]	addrs	Output array of BtdrvAddress.
[in]	count	Size of the addrs array in entries, the maximum is 0x8.
[out]	total_out	Total output entries.

◆ btdrvGetEventInfo()

Result btdrvGetEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvEventType *	type
	)

GetEventInfo.

Note: This is used by btm-sysmodule.

Parameters

[out]	buffer	Output buffer, see BtdrvEventInfo.
[in]	size	Output buffer size.
[out]	type	Output BtdrvEventType.

◆ btdrvGetGattAttribute()

Result btdrvGetGattAttribute	(	BtdrvAddress	addr,
		u32	conn_id
	)

GetGattAttribute.

Note: Only available on [5.0.0+].

Parameters

[in]	addr	BtdrvAddress, only used on pre-9.0.0.
[in]	conn_id	Connection ID

◆ btdrvGetGattFirstCharacteristic()

Result btdrvGetGattFirstCharacteristic	(	u32	conn_id,
		const BtdrvGattId *	serv_id,
		bool	is_primary,
		const BtdrvGattAttributeUuid *	filter_uuid,
		u8 *	out_property,
		BtdrvGattId *	out_char_id
	)

GetGattFirstCharacteristic.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	is_primary	Is a primary service or not
[in]	filter_uuid	Characteristic filter UUID BtdrvGattAttributeUuid
[out]	out_property	Output property BtdrvGattCharacteristicProperty
[out]	out_char_id	Output characteristic GATT ID BtdrvGattId

◆ btdrvGetGattFirstDescriptor()

Result btdrvGetGattFirstDescriptor	(	u32	conn_id,
		const BtdrvGattId *	serv_id,
		bool	is_primary,
		const BtdrvGattId *	char_id,
		const BtdrvGattAttributeUuid *	filter_uuid,
		BtdrvGattId *	out_desc_id
	)

GetGattFirstDescriptor.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	is_primary	Is a primary service or not
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	filter_uuid	Descriptor filter UUID BtdrvGattAttributeUuid
[out]	out_desc_id	Output descriptor GATT ID BtdrvGattId

◆ btdrvGetGattNextCharacteristic()

Result btdrvGetGattNextCharacteristic	(	u32	conn_id,
		const BtdrvGattId *	serv_id,
		bool	is_primary,
		const BtdrvGattId *	char_id,
		const BtdrvGattAttributeUuid *	filter_uuid,
		u8 *	out_property,
		BtdrvGattId *	out_char_id
	)

GetGattNextCharacteristic.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	serv_id	Service ID BtdrvGattId
[in]	is_primary	Is a primary service or not
[in]	char_id	Previous characteristic GATT ID BtdrvGattId
[in]	filter_uuid	Characteristic filter UUID BtdrvGattAttributeUuid
[out]	out_property	Output property BtdrvGattCharacteristicProperty
[out]	out_char_id	Output characteristic GATT ID BtdrvGattId

◆ btdrvGetGattNextDescriptor()

Result btdrvGetGattNextDescriptor	(	u32	conn_id,
		const BtdrvGattId *	serv_id,
		bool	is_primary,
		const BtdrvGattId *	char_id,
		const BtdrvGattId *	desc_id,
		const BtdrvGattAttributeUuid *	filter_uuid,
		BtdrvGattId *	out_desc_id
	)

GetGattNextDescriptor.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	is_primary	Is a primary service or not
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	desc_id	Previous descriptor GATT ID BtdrvGattId
[in]	filter_uuid	Descriptor filter UUID BtdrvGattAttributeUuid
[out]	out_desc_id	Output descriptor GATT ID BtdrvGattId

◆ btdrvGetGattService()

Result btdrvGetGattService	(	u32	conn_id,
		const BtdrvGattAttributeUuid *	uuid
	)

GetGattService.

Note: Only available on [5.0.0+].

Parameters

[in]	conn_id	Connection ID
[in]	uuid	BtdrvGattAttributeUuid

◆ btdrvGetHidEventInfo()

Result btdrvGetHidEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvHidEventType *	type
	)

GetHidEventInfo.

Note: This is used by btm-sysmodule.

Parameters

[out]	buffer	Output buffer, see BtdrvHidEventInfo.
[in]	size	Output buffer size.
[out]	type	BtdrvHidEventType, always BtdrvHidEventType_Connection or ::BtdrvHidEventType_Ext.

◆ btdrvGetHidReport()

Result btdrvGetHidReport	(	BtdrvAddress	addr,
		u8	report_id,
		BtdrvBluetoothHhReportType	type
	)

This sends a HID GET_REPORT transaction packet.

Parameters

[in]	addr	BtdrvAddress
[in]	report_id	This is sent in the packet for the Report Id, when non-zero.
[in]	type	BtdrvBluetoothHhReportType

◆ btdrvGetHidReportEventInfo()

Result btdrvGetHidReportEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvHidEventType *	type
	)

GetHidReportEventInfo.

Note: btdrvRegisterHidReportEvent must be used before this, on [7.0.0+].; This is used by hid-sysmodule. When used by other processes, hid/user-process will conflict. No events will be received by that user-process, or it will be corrupted, etc.; [7.0.0+] When data isn't available, the type is set to BtdrvHidEventType_Data, with the buffer cleared to all-zero.

Parameters

[out]	buffer	Output buffer, see BtdrvHidReportEventInfo.
[in]	size	Output buffer size.
[out]	type	BtdrvHidEventType

◆ btdrvGetLatestPlr()

Result btdrvGetLatestPlr ( BtdrvPlrList * out )

GetLatestPlr.

Parameters

[out] out Output BtdrvPlrList, on pre-9.0.0 this is BtdrvPlrStatistics.

◆ btdrvGetLeHidEventInfo()

Result btdrvGetLeHidEventInfo	(	void *	buffer,
		size_t	size,
		BtdrvBleEventType *	type
	)

GetLeHidEventInfo.

Note: Only available on [5.0.0+].; The state used by this is reset after writing the data to output.

Parameters

[out]	buffer	Output buffer. 0x400-bytes from state is written here. See BtdrvBleEventInfo.
[in]	size	Output buffer size.
[out]	type	BtdrvBleEventType.

◆ btdrvGetPairedDeviceInfo()

Result btdrvGetPairedDeviceInfo	(	BtdrvAddress	addr,
		SetSysBluetoothDevicesSettings *	settings
	)

GetPairedDeviceInfo.

Note: This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[out]	settings	SetSysBluetoothDevicesSettings

◆ btdrvGetPendingConnections()

Result btdrvGetPendingConnections ( void )

GetPendingConnections.

Note: The output data will be available via btdrvGetHidEventInfo ([12.0.0+] btdrvGetEventInfo).; This is used by btm-sysmodule.; Only available on [3.0.0+].

◆ btdrvInitializeBle()

Result btdrvInitializeBle ( Event * out_event )

InitializeBle.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.; The Event must be closed by the user once finished with it.

Parameters

[out] out_event Output Event with autoclear=true.

◆ btdrvInitializeBluetooth()

Result btdrvInitializeBluetooth ( Event * out_event )

InitializeBluetooth.

Note: This is used by btm-sysmodule, this should not be used by other processes.; The Event must be closed by the user once finished with it.

Parameters

[out] out_event Output Event with autoclear=true.

◆ btdrvInitializeHid()

Result btdrvInitializeHid ( Event * out_event )

InitializeHid.

Note: This is used by btm-sysmodule, this should not be used by other processes.; The Event must be closed by the user once finished with it.

Parameters

[out] out_event Output Event with autoclear=true.

◆ btdrvIsAfhSettingEnabled()

Result btdrvIsAfhSettingEnabled ( bool * out )

IsAfhSettingEnabled.

Note: Only available on [3.0.0+].

Parameters

[out] out Output flag.

◆ btdrvIsBluetoothEnabled()

Result btdrvIsBluetoothEnabled ( bool * out )

IsBluetoothEnabled.

Note: Only available on [12.0.0+].

Parameters

[out] out Output flag.

◆ btdrvIsManufacturingMode()

Result btdrvIsManufacturingMode ( bool * out )

IsManufacturingMode.

Note: Only available on [5.0.0+].

Parameters

[out] out Output flag.

◆ btdrvIsTxPowerBoostSettingEnabled()

Result btdrvIsTxPowerBoostSettingEnabled ( bool * out )

IsTxPowerBoostSettingEnabled.

Note: Only available on [3.0.0+].

Parameters

[out] out Output flag.

◆ btdrvLegacyGetAdapterProperties()

Result btdrvLegacyGetAdapterProperties ( BtdrvAdapterPropertyOld * properties )

GetAdapterProperties [1.0.0-11.0.1].

Parameters

[out] properties BtdrvAdapterPropertyOld

◆ btdrvLegacyGetAdapterProperty()

Result btdrvLegacyGetAdapterProperty	(	BtdrvBluetoothPropertyType	type,
		void *	buffer,
		size_t	size
	)

GetAdapterProperty [1.0.0-11.0.1].

Parameters

[in]	type	BtdrvBluetoothPropertyType
[out]	buffer	Output buffer, see BtdrvBluetoothPropertyType for the contents.
[in]	size	Output buffer size.

◆ btdrvLegacyRespondToPinRequest()

Result btdrvLegacyRespondToPinRequest	(	BtdrvAddress	addr,
		bool	flag,
		const BtdrvBluetoothPinCode *	pin_code,
		u8	length
	)

RespondToPinRequest [1.0.0-11.0.1].

Note: The official sysmodule only uses the input BtdrvAddress.

Parameters

[in]	addr	BtdrvAddress
[in]	flag	Flag
[in]	pin_code	BtdrvBluetoothPinCode
[in]	length	Length of pin_code

◆ btdrvLegacySetAdapterProperty()

Result btdrvLegacySetAdapterProperty	(	BtdrvBluetoothPropertyType	type,
		const void *	buffer,
		size_t	size
	)

SetAdapterProperty [1.0.0-11.0.1].

Parameters

[in]	type	BtdrvBluetoothPropertyType
[in]	buffer	Input buffer, see BtdrvBluetoothPropertyType for the contents.
[in]	size	Input buffer size.

◆ btdrvLegacyStartInquiry()

Result btdrvLegacyStartInquiry ( void )

StartInquiry [1.0.0-11.0.1].

This starts Inquiry, the output data will be available via btdrvGetEventInfo. Inquiry will automatically stop in 10.24 seconds.

Note: This is used by btm-sysmodule.

◆ btdrvMoveToSecondaryPiconet()

Result btdrvMoveToSecondaryPiconet ( BtdrvAddress addr )

MoveToSecondaryPiconet.

Note: The response will be available via btdrvGetHidEventInfo ([12.0.0+] btdrvGetEventInfo).; Only available on [10.0.0+].

Parameters

[in] addr BtdrvAddress

◆ btdrvOpenAudioConnection()

Result btdrvOpenAudioConnection ( BtdrvAddress addr )

OpenAudioConnection.

Note: Only available on [12.0.0+].

Parameters

[in] addr BtdrvAddress

◆ btdrvOpenAudioOut()

Result btdrvOpenAudioOut	(	BtdrvAddress	addr,
		u32 *	audio_handle
	)

OpenAudioOut.

Note: Only available on [12.0.0+].

Parameters

[in]	addr	BtdrvAddress
[out]	audio_handle	Audio handle.

◆ btdrvOpenHidConnection()

Result btdrvOpenHidConnection ( BtdrvAddress addr )

OpenHidConnection.

Note: This is used by btm-sysmodule.

Parameters

[in] addr BtdrvAddress

◆ btdrvReadGattCharacteristic()

Result btdrvReadGattCharacteristic	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id,
		u8	auth_req
	)

ReadGattCharacteristic.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	auth_req	BtdrvGattAuthReqType

◆ btdrvReadGattDescriptor()

Result btdrvReadGattDescriptor	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id,
		const BtdrvGattId *	desc_id,
		u8	auth_req
	)

ReadGattDescriptor.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	desc_id	Descriptor GATT ID BtdrvGattId
[in]	auth_req	BtdrvGattAuthReqType

◆ btdrvRegisterAudioControlNotification()

Result btdrvRegisterAudioControlNotification	(	BtdrvAddress	addr,
		u32	event_type
	)

RegisterAudioControlNotification.

Note: Only available on [13.0.0+].

Parameters

[in]	addr	BtdrvAddress
[in]	event_type	AvrcEventType

◆ btdrvRegisterBleHidEvent()

Result btdrvRegisterBleHidEvent ( Event * out_event )

RegisterBleHidEvent.

Note: Only available on [5.0.0+].; The Event must be closed by the user once finished with it.

Parameters

[out] out_event Output Event with autoclear=true.

◆ btdrvRegisterGattClient()

Result btdrvRegisterGattClient ( const BtdrvGattAttributeUuid * uuid )

RegisterGattClient.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvRegisterGattDataPath()

Result btdrvRegisterGattDataPath ( const BtdrvGattAttributeUuid * uuid )

RegisterGattDataPath.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvRegisterGattHidDataPath()

Result btdrvRegisterGattHidDataPath ( const BtdrvGattAttributeUuid * uuid )

RegisterGattHidDataPath.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvRegisterGattManagedDataPath()

Result btdrvRegisterGattManagedDataPath ( const BtdrvGattAttributeUuid * uuid )

RegisterGattManagedDataPath.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvRegisterGattNotification()

Result btdrvRegisterGattNotification	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id
	)

RegisterGattNotification.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId

◆ btdrvRegisterGattServer()

Result btdrvRegisterGattServer ( const BtdrvGattAttributeUuid * uuid )

RegisterGattServer.

Note: Only available on [5.0.0+].; Event data generated by this call contains uninitialized junk instead of the server_if value received internally.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvRegisterHidReportEvent()

Result btdrvRegisterHidReportEvent ( Event * out_event )

RegisterHidReportEvent.

Note: This also does sharedmem init/handling if needed, on [7.0.0+].; The Event must be closed by the user once finished with it.

Parameters

[out] out_event Output Event with autoclear=true. This is signaled when data is available with btdrvGetHidReportEventInfo.

◆ btdrvRemoveBond()

Result btdrvRemoveBond ( BtdrvAddress addr )

RemoveBond.

Note: This is used by btm-sysmodule.

Parameters

[in] addr BtdrvAddress

◆ btdrvRespondToPinRequest()

Result btdrvRespondToPinRequest	(	BtdrvAddress	addr,
		const BtdrvPinCode *	pin_code
	)

RespondToPinRequest [12.0.0+].

Parameters

[in]	addr	BtdrvAddress
[in]	pin_code	BtdrvPinCode

◆ btdrvRespondToSspRequest()

Result btdrvRespondToSspRequest	(	BtdrvAddress	addr,
		u32	variant,
		bool	accept,
		u32	passkey
	)

RespondToSspRequest.

Note: The official sysmodule only uses the input BtdrvAddress and the flag.; This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	variant	BluetoothSspVariant
[in]	accept	Whether the request is accepted.
[in]	passkey	Passkey.

◆ btdrvSendAudioControlPassthroughCommand()

Result btdrvSendAudioControlPassthroughCommand	(	BtdrvAddress	addr,
		u32	op_id,
		u32	state_type
	)

SendAudioControlPassthroughCommand.

Note: Only available on [13.0.0+].

Parameters

[in]	addr	BtdrvAddress
[in]	op_id	AvrcOperationId
[in]	state_type	AvrcStateType

◆ btdrvSendAudioControlSetAbsoluteVolumeCommand()

Result btdrvSendAudioControlSetAbsoluteVolumeCommand	(	BtdrvAddress	addr,
		s32	val
	)

SendAudioControlSetAbsoluteVolumeCommand.

Note: Only available on [13.0.0+].

Parameters

[in]	addr	BtdrvAddress
[in]	val	Input value

◆ btdrvSendAudioData()

Result btdrvSendAudioData	(	u32	audio_handle,
		const void *	buffer,
		size_t	size,
		u64 *	transferred_size
	)

SendAudioData.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[in]	buffer	Input buffer.
[in]	size	Input buffer size.
[out]	Output	transferred size. This is always either 0 (error occured) or the buffer size.

◆ btdrvSetAdapterProperty()

Result btdrvSetAdapterProperty	(	BtdrvAdapterPropertyType	type,
		const BtdrvAdapterProperty *	property
	)

SetAdapterProperty [12.0.0+].

Parameters

[in]	type	BtdrvAdapterPropertyType
[in]	property	BtdrvAdapterProperty

◆ btdrvSetBleAdvertiseData()

Result btdrvSetBleAdvertiseData ( const BtdrvBleAdvertisePacketData * data )

SetBleAdvertiseData.

Note: Only available on [5.0.0+].

Parameters

[in] data BtdrvBleAdvertisePacketData

◆ btdrvSetBleAdvertiseParameter()

Result btdrvSetBleAdvertiseParameter	(	BtdrvAddress	addr,
		u16	min_interval,
		u16	max_interval
	)

SetBleAdvertiseParameter.

Note: Only available on [5.0.0+].

Parameters

[in]	addr	BtdrvAddress
[in]	min_interval	Minimum advertisement interval
[in]	max_interval	Maximum advertisement interval

◆ btdrvSetBleConnectionParameter()

Result btdrvSetBleConnectionParameter	(	BtdrvAddress	addr,
		const BtdrvBleConnectionParameter *	param,
		bool	preference
	)

SetBleConnectionParameter.

Note: Only available on [9.0.0+]. This is the newer version of btdrvSetLeConnectionParameter.

Parameters

[in]	addr	BtdrvAddress
[in]	param	BtdrvBleConnectionParameter
[in]	preference	Unused

◆ btdrvSetBleDefaultConnectionParameter()

Result btdrvSetBleDefaultConnectionParameter ( const BtdrvBleConnectionParameter * param )

SetBleDefaultConnectionParameter.

Note: Only available on [9.0.0+]. This is the newer version of btdrvSetLeDefaultConnectionParameter.

Parameters

[in] param BtdrvBleConnectionParameter

◆ btdrvSetBleScanParameter()

Result btdrvSetBleScanParameter	(	u16	scan_interval,
		u16	scan_window
	)

SetBleScanParameter.

Note: Only available on [5.1.0+].; This is used by btm-sysmodule.

Parameters

[in]	scan_interval	Scan interval
[in]	scan_window	Scan window

◆ btdrvSetBleVisibility()

Result btdrvSetBleVisibility	(	bool	discoverable,
		bool	connectable
	)

SetBleVisibility.

Note: Only available on [5.0.0+].

Parameters

[in]	discoverable	Whether the BLE device is discoverable.
[in]	connectable	Whether the BLE device is connectable.

◆ btdrvSetHidReport()

Result btdrvSetHidReport	(	BtdrvAddress	addr,
		BtdrvBluetoothHhReportType	type,
		const BtdrvHidReport *	buffer
	)

This sends a HID SET_REPORT transaction packet.

Parameters

[in]	addr	BtdrvAddress
[in]	type	BtdrvBluetoothHhReportType
[in]	buffer	Input BtdrvHidReport, on pre-9.0.0 this is BtdrvHidData.

◆ btdrvSetLeConnectionParameter()

Result btdrvSetLeConnectionParameter ( const BtdrvLeConnectionParams * param )

SetLeConnectionParameter.

Note: Only available on [5.0.0-8.1.1]. This is the older version of btdrvSetBleConnectionParameter.

Parameters

[in] param BtdrvLeConnectionParams

◆ btdrvSetLeDefaultConnectionParameter()

Result btdrvSetLeDefaultConnectionParameter ( const BtdrvLeConnectionParams * param )

SetLeDefaultConnectionParameter.

Note: Only available on [5.0.0-8.1.1]. This is the older version of btdrvSetBleDefaultConnectionParameter.

Parameters

[in] param BtdrvLeConnectionParams

◆ btdrvSetTsi()

Result btdrvSetTsi	(	BtdrvAddress	addr,
		u8	tsi
	)

SetTsi.

Note: The response will be available via btdrvGetHidEventInfo ([12.0.0+] btdrvGetEventInfo).; This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	tsi	Tsi: non-value-0xFF to Set, value 0xFF to Exit. See also BtmTsiMode.

◆ btdrvSetVisibility()

Result btdrvSetVisibility	(	bool	inquiry_scan,
		bool	page_scan
	)

SetVisibility.

Note: This is used by btm-sysmodule.

Parameters

[in]	inquiry_scan	Controls Inquiry Scan, whether the device can be discovered during Inquiry.
[in]	page_scan	Controls Page Scan, whether the device accepts connections.

◆ btdrvSetZeroRetransmission()

Result btdrvSetZeroRetransmission	(	BtdrvAddress	addr,
		u8 *	report_ids,
		u8	count
	)

SetZeroRetransmission.

Note: The response will be available via btdrvGetHidEventInfo ([12.0.0+] btdrvGetEventInfo).; This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	report_ids	Input buffer containing an array of u8s.
[in]	count	Total u8s in the input buffer. This can be 0, the max is 5.

◆ btdrvStartAudioOut()

Result btdrvStartAudioOut	(	u32	audio_handle,
		const BtdrvPcmParameter *	pcm_param,
		s64	in_latency,
		s64 *	out_latency,
		u64 *	out1
	)

StartAudioOut.

Note: Only available on [12.0.0+].

Parameters

[in]	audio_handle	Audio handle from btdrvOpenAudioOut.
[in]	pcm_param	BtdrvPcmParameter
[in]	in_latency	Input latency in nanoseconds.
[out]	out_latency	Output latency in nanoseconds.
[out]	out1	Unknown output.

◆ btdrvStartBleScan()

Result btdrvStartBleScan ( void )

StartBleScan.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

◆ btdrvStartInquiry()

Result btdrvStartInquiry	(	u32	services,
		s64	duration
	)

StartInquiry [12.0.0+].

This starts Inquiry, the output data will be available via btdrvGetEventInfo.

Parameters

[in]	services	Bitfield of allowed services. When -1 the original defaults from pre-12.0.0 are used.
[in]	duration	Inquiry duration in nanoseconds.

Note: This is used by btm-sysmodule.

◆ btdrvStopAudioOut()

Result btdrvStopAudioOut ( u32 audio_handle )

StopAudioOut.

Note: Only available on [12.0.0+].

Parameters

[in] audio_handle Audio handle from btdrvOpenAudioOut.

◆ btdrvStopBleScan()

Result btdrvStopBleScan ( void )

StopBleScan.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

◆ btdrvStopInquiry()

Result btdrvStopInquiry ( void )

This stops Inquiry which was started by btdrvStartInquiry, if it's still active.

Note: This is used by btm-sysmodule.

◆ btdrvTriggerConnection()

Result btdrvTriggerConnection	(	BtdrvAddress	addr,
		u16	timeout
	)

TriggerConnection.

Note: This is used by btm-sysmodule.

Parameters

[in]	addr	BtdrvAddress
[in]	timeout	[9.0.0+] Host trigger timeout

◆ btdrvUnregisterAllGattClients()

Result btdrvUnregisterAllGattClients ( void )

UnregisterAllGattClients.

Note: Only available on [5.0.0+].

◆ btdrvUnregisterGattClient()

Result btdrvUnregisterGattClient ( u8 client_if )

UnregisterGattClient.

Note: Only available on [5.0.0+].

Parameters

[in] client_if Client interface ID

◆ btdrvUnregisterGattDataPath()

Result btdrvUnregisterGattDataPath ( const BtdrvGattAttributeUuid * uuid )

UnregisterGattDataPath.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvUnregisterGattHidDataPath()

Result btdrvUnregisterGattHidDataPath ( const BtdrvGattAttributeUuid * uuid )

UnregisterGattHidDataPath.

Note: Only available on [5.0.0+].; This is used by btm-sysmodule.

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvUnregisterGattManagedDataPath()

Result btdrvUnregisterGattManagedDataPath ( const BtdrvGattAttributeUuid * uuid )

UnregisterGattManagedDataPath.

Note: Only available on [5.0.0+].

Parameters

[in] uuid BtdrvGattAttributeUuid

◆ btdrvUnregisterGattNotification()

Result btdrvUnregisterGattNotification	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id
	)

UnregisterGattNotification.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId

◆ btdrvUnregisterGattServer()

Result btdrvUnregisterGattServer ( u8 server_if )

UnregisterGattServer.

Note: Only available on [5.0.0+].

Parameters

[in] server_if Server interface ID

◆ btdrvWriteGattCharacteristic()

Result btdrvWriteGattCharacteristic	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id,
		const void *	buffer,
		size_t	size,
		u8	auth_req,
		bool	with_response
	)

WriteGattCharacteristic.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	buffer	Input buffer.
[in]	size	Input buffer size, must be <=0x258.
[in]	auth_req	BtdrvGattAuthReqType
[in]	with_response	Whether to use Write-With-Response write type or not

◆ btdrvWriteGattDescriptor()

Result btdrvWriteGattDescriptor	(	u32	connection_handle,
		bool	is_primary,
		const BtdrvGattId *	serv_id,
		const BtdrvGattId *	char_id,
		const BtdrvGattId *	desc_id,
		const void *	buffer,
		size_t	size,
		u8	auth_req
	)

WriteGattDescriptor.

Note: Only available on [5.0.0+].

Parameters

[in]	connection_handle	ConnectionHandle
[in]	is_primary	Is a primary service or not
[in]	serv_id	Service GATT ID BtdrvGattId
[in]	char_id	Characteristic GATT ID BtdrvGattId
[in]	desc_id	Descriptor GATT ID BtdrvGattId
[in]	buffer	Input buffer.
[in]	size	Input buffer size, must be <=0x258.
[in]	auth_req	BtdrvGattAuthReqType

◆ btdrvWriteHidData()

Result btdrvWriteHidData	(	BtdrvAddress	addr,
		const BtdrvHidReport *	buffer
	)

This sends a HID DATA transaction packet with report-type Output.

Parameters

[in]	addr	BtdrvAddress
[in]	buffer	Input BtdrvHidReport, on pre-9.0.0 this is BtdrvHidData.

◆ btdrvWriteHidData2()

Result btdrvWriteHidData2	(	BtdrvAddress	addr,
		const void *	buffer,
		size_t	size
	)

WriteHidData2.

Parameters

[in]	addr	BtdrvAddress
[in]	buffer	Input buffer, same as the buffer for btdrvWriteHidData.
[in]	size	Input buffer size.

Data Structures

Functions

Detailed Description

Function Documentation

◆ btdrvAcquireAudioConnectionStateChangedEvent()

◆ btdrvAcquireAudioControlInputStateChangedEvent()

◆ btdrvAcquireAudioEvent()

◆ btdrvAcquireAudioOutBufferAvailableEvent()

◆ btdrvAcquireAudioOutStateChangedEvent()

◆ btdrvAddBleScanFilterCondition()

◆ btdrvAddGattCharacteristic()

◆ btdrvAddGattDescriptor()

◆ btdrvAddGattService()

◆ btdrvAddPairedDeviceInfo()

◆ btdrvCancelBond()

◆ btdrvCancelConnectGattServer()

◆ btdrvCircularBufferFree()

◆ btdrvCircularBufferRead()

◆ btdrvClearBleScanFilters()

◆ btdrvCloseAudioConnection()

◆ btdrvCloseAudioControlInput()

◆ btdrvCloseAudioOut()

◆ btdrvCloseHidConnection()

◆ btdrvConfigureAttMtu()

◆ btdrvConnectGattClient()

◆ btdrvConnectGattServer()

◆ btdrvCreateBond()

◆ btdrvDeleteBleScanFilter()

◆ btdrvDeleteBleScanFilterCondition()

◆ btdrvDisableBle()

◆ btdrvDisableBluetooth()

◆ btdrvDisableLlrScan()

◆ btdrvDisconnectGattClient()

◆ btdrvDisconnectGattServer()

◆ btdrvEmulateBluetoothCrash()

◆ btdrvEnableAfhSetting()

◆ btdrvEnableBle()

◆ btdrvEnableBleScanFilter()

◆ btdrvEnableBluetooth()

◆ btdrvEnableBurstMode()

◆ btdrvEnableGattService()

◆ btdrvEnableLlrScan()

◆ btdrvEnableMcMode()

◆ btdrvEnableRadio()

◆ btdrvEnableTbfcScan()

◆ btdrvEnableTxPowerBoostSetting()

◆ btdrvFinalizeBle()

◆ btdrvFinalizeBluetooth()

◆ btdrvFinalizeHid()

◆ btdrvGetAdapterProperties()

◆ btdrvGetAdapterProperty()

◆ btdrvGetAudioControlInputState()

◆ btdrvGetAudioEventInfo()

◆ btdrvGetAudioOutFeedingCodec()

◆ btdrvGetAudioOutFeedingParameter()

◆ btdrvGetAudioOutState()

◆ btdrvGetBleChannelMap()

◆ btdrvGetBleManagedEventInfo()

◆ btdrvGetChannelMap()

◆ btdrvGetConnectedAudioDevice()

◆ btdrvGetEventInfo()

◆ btdrvGetGattAttribute()

◆ btdrvGetGattFirstCharacteristic()

◆ btdrvGetGattFirstDescriptor()

◆ btdrvGetGattNextCharacteristic()

◆ btdrvGetGattNextDescriptor()

◆ btdrvGetGattService()

◆ btdrvGetHidEventInfo()

◆ btdrvGetHidReport()

◆ btdrvGetHidReportEventInfo()

◆ btdrvGetLatestPlr()

◆ btdrvGetLeHidEventInfo()

◆ btdrvGetPairedDeviceInfo()

◆ btdrvGetPendingConnections()

◆ btdrvInitializeBle()

◆ btdrvInitializeBluetooth()

◆ btdrvInitializeHid()

◆ btdrvIsAfhSettingEnabled()

◆ btdrvIsBluetoothEnabled()

◆ btdrvIsManufacturingMode()