bt.h File Reference

Bluetooth user (bt) service IPC wrapper. More...

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

Go to the source code of this file.

Functions
Result	btInitialize (void)
	Initialize bt. Only available on [5.0.0+].
void	btExit (void)
	Exit bt.
Service *	btGetServiceSession (void)
	Gets the Service object for the actual bt service session.
Result	btLeClientReadCharacteristic (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1, u8 unk)
	LeClientReadCharacteristic. More...
Result	btLeClientReadDescriptor (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1, const BtdrvGattId *id2, u8 unk)
	LeClientReadDescriptor. More...
Result	btLeClientWriteCharacteristic (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1, const void *buffer, size_t size, u8 unk, bool flag)
	LeClientWriteCharacteristic. More...
Result	btLeClientWriteDescriptor (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1, const BtdrvGattId *id2, const void *buffer, size_t size, u8 unk)
	LeClientWriteDescriptor. More...
Result	btLeClientRegisterNotification (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1)
	LeClientRegisterNotification. More...
Result	btLeClientDeregisterNotification (u32 connection_handle, bool primary_service, const BtdrvGattId *id0, const BtdrvGattId *id1)
	LeClientDeregisterNotification. More...
Result	btSetLeResponse (u8 unk, const BtdrvGattAttributeUuid *uuid0, const BtdrvGattAttributeUuid *uuid1, const void *buffer, size_t size)
	SetLeResponse. More...
Result	btLeSendIndication (u8 unk, const BtdrvGattAttributeUuid *uuid0, const BtdrvGattAttributeUuid *uuid1, const void *buffer, size_t size, bool flag)
	LeSendIndication. More...
Result	btGetLeEventInfo (void *buffer, size_t size, u32 *type)
	GetLeEventInfo. More...
Result	btRegisterBleEvent (Event *out_event)
	RegisterBleEvent. More...

Detailed Description

Bluetooth user (bt) service IPC wrapper.

Note

See also btdev.

Author

yellows8

Copyright

libnx Authors

Function Documentation

btGetLeEventInfo()

Result btGetLeEventInfo	(	void *	buffer,
		size_t	size,
		u32 *	type
	)

GetLeEventInfo.

Note

This is identical to btdrvGetLeHidEventInfo except different state is used.

The state used by this is reset after writing the data to output.

Parameters

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

btLeClientDeregisterNotification()

Result btLeClientDeregisterNotification	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1
	)

LeClientDeregisterNotification.

Note

This is essentially the same as btdrvUnregisterGattNotification.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId

btLeClientReadCharacteristic()

Result btLeClientReadCharacteristic	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1,
		u8	unk
	)

LeClientReadCharacteristic.

Note

This is essentially the same as btdrvReadGattCharacteristic.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId
[in]	unk	Unknown

btLeClientReadDescriptor()

Result btLeClientReadDescriptor	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1,
		const BtdrvGattId *	id2,
		u8	unk
	)

LeClientReadDescriptor.

Note

This is essentially the same as btdrvReadGattDescriptor.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId
[in]	id2	BtdrvGattId
[in]	unk	Unknown

btLeClientRegisterNotification()

Result btLeClientRegisterNotification	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1
	)

LeClientRegisterNotification.

Note

This is essentially the same as btdrvRegisterGattNotification.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId

btLeClientWriteCharacteristic()

Result btLeClientWriteCharacteristic	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1,
		const void *	buffer,
		size_t	size,
		u8	unk,
		bool	flag
	)

LeClientWriteCharacteristic.

Note

This is essentially the same as btdrvWriteGattCharacteristic.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId
[in]	buffer	Input buffer.
[in]	size	Input buffer size, must be <=0x258.
[in]	unk	Unknown
[in]	flag	Flag

btLeClientWriteDescriptor()

Result btLeClientWriteDescriptor	(	u32	connection_handle,
		bool	primary_service,
		const BtdrvGattId *	id0,
		const BtdrvGattId *	id1,
		const BtdrvGattId *	id2,
		const void *	buffer,
		size_t	size,
		u8	unk
	)

LeClientWriteDescriptor.

Note

This is essentially the same as btdrvWriteGattDescriptor.

Parameters

[in]	connection_handle	ConnectionHandle
[in]	primary_service	PrimaryService
[in]	id0	BtdrvGattId
[in]	id1	BtdrvGattId
[in]	id2	BtdrvGattId
[in]	buffer	Input buffer.
[in]	size	Input buffer size, must be <=0x258.
[in]	unk	Unknown

btLeSendIndication()

Result btLeSendIndication	(	u8	unk,
		const BtdrvGattAttributeUuid *	uuid0,
		const BtdrvGattAttributeUuid *	uuid1,
		const void *	buffer,
		size_t	size,
		bool	flag
	)

LeSendIndication.

Parameters

[in]	unk	Unknown
[in]	uuid0	BtdrvGattAttributeUuid
[in]	uuid1	BtdrvGattAttributeUuid
[in]	buffer	Input buffer.
[in]	size	Input buffer size, clamped to max size 0x258.
[in]	flag	Flag

btRegisterBleEvent()

Result btRegisterBleEvent

(

Event *

out_event

)

RegisterBleEvent.

Note

This is identical to btdrvRegisterBleHidEvent except different state is used.

The Event must be closed by the user once finished with it.

Parameters

[out]

out_event

Output Event with autoclear=true.

btSetLeResponse()

Result btSetLeResponse	(	u8	unk,
		const BtdrvGattAttributeUuid *	uuid0,
		const BtdrvGattAttributeUuid *	uuid1,
		const void *	buffer,
		size_t	size
	)

SetLeResponse.

Parameters

[in]	unk	Unknown
[in]	uuid0	BtdrvGattAttributeUuid
[in]	uuid1	BtdrvGattAttributeUuid
[in]	buffer	Input buffer.
[in]	size	Input buffer size, must be <=0x258.