Serial Port Profile

The Bluetooth SPP API supports client and server functionality for one-to-one connections.

The built-in Bluetooth Serial Port Profile (SPP) supports one-to-one connections. The API enables you to connect two Bluetooth devices and the exchange data between them. When acting as a client, it can:

Scan for Bluetooth devices and connects to a designated server device.
Send and receive data to and from the connected server device.

When acting as a server, it can:

Accept/reject SPP clients - Send/receive data from a client

Limitation

The API only support one-to-one connections.

Group

Bluetooth

Functions

Function	Description
vm_bt_spp_accept	A server uses this function in order to accept a connection when it is notified by the VM_BT_SPP_EVENT_AUTHORIZE event.
vm_bt_spp_bind	Creates an SPP instance.
vm_bt_spp_close	This function destroys a SPP resource.
vm_bt_spp_connect	Connects to a server.
vm_bt_spp_disconnect	Disconnects an already opened SPP connection.
vm_bt_spp_get_device_address	Get the Bluetooth address with the connection ID.
vm_bt_spp_get_min_buffer_size	Gets the bt_spp minimum buffer, returns the minimum size for tx and rx buffer in vm_bt_spp_connect() It is recommended to malloc tx/rx buffer for SPP data transmission, the size is determined by the device.
vm_bt_spp_open	Opens bt_spp and returns the resource handle if it is successful.
vm_bt_spp_read	Read data over an established connection.
vm_bt_spp_reject	The server uses this function to reject when it is notified by the VM_BT_SPP_EVENT_AUTHORIZE event. PARAMETERS. connection_id : Connection ID.
vm_bt_spp_set_security_level	Set the security level for the handle.
vm_bt_spp_set_service_name	Sets an SPP resource name.
vm_bt_spp_write	Writes data over an established connection.

Structs, Records, Enums

Struct, Record, Enum	Description
VM_BT_SPP_EVENT	bt_spp srv for app event enum
vm_bt_spp_event_cntx_t	spp srv for app event structure
VM_BT_SPP_RESULT	bt_spp return error type
VM_BT_SPP_SECURITY_LEVEL	bt_spp security level

Types

Type	Description
VM_BT_SPP_CONNECTION_ID	bt SPP connection id
vm_bt_spp_event_callback	Callback function of bt_spp.
VM_BT_SPP_HANDLE	bt_spp open handle

Links

Topics, Functions, Structs, Records, Enums, Types

Created with a commercial version of

Doc-O-Matic. In order to make this message disappear you need to register this software. If you have problems registering this software please contact us at

support@toolsfactory.com.