SPP API

结构体
struct	spp_create_socket_para_t
	创建SPP socket的参数。 更多...
struct	spp_callbacks_t
	SPP回调函数接口定义。 更多...

宏定义
#define	SPP_READ_SOCKET_CLOSED   (0)
	SPP连接已经断开。
#define	SPP_READ_FAILED   (-1)
	读取数据失败。
#define	SPP_WRITE_FAILED   (-1)
	写数据失败。
#define	SPP_INVALID_ID   (-1)
	非法SPP Server 或 Client ID。

类型定义
typedef void(*	spp_conn_state_changed_callback) (uint8_t client_id, profile_connect_state_t state)
	连接变化事件回调函数。
typedef void(*	spp_receive_data_callback) (uint8_t client_id, uint8_t *data, uint32_t data_len)
	接收到数据回调函数。

枚举
enum	spp_socket_type_t { SPP_SOCKET_RFCOMM = 0x0 }
	SPP socket类型定义枚举。 更多...

函数
int	spp_server_create (spp_create_socket_para_t *socket_para, const char *name, unsigned int len)
	创建SPP Server。
int	spp_server_accept (int server_id)
	等待远端设备来连接此Server。
int	spp_server_close (int server_id)
	关闭Server（同时释放相关资源）。
int	spp_connect (spp_create_socket_para_t *socket_para, const bd_addr_t *bd_addr)
	连接远端设备。
int	spp_disconnect (int client_id)
	断开连接（同时释放相关资源）。
bool	is_spp_connected (int client_id)
	获取指定SPP socket的连接状态。
int	spp_get_remote_addr (int client_id, bd_addr_t *remote_addr)
	获取SPP socket对应远端设备的地址。
int	spp_write (int client_id, const char *data, const unsigned int len)
	向SPP socket写入数据
int	spp_register_callbacks (spp_callbacks_t *func)
	注册PBAP回调函数。

详细描述

宏定义说明

SPP_INVALID_ID

#define SPP_INVALID_ID   (-1)

非法SPP Server 或 Client ID。

SPP_READ_FAILED

#define SPP_READ_FAILED   (-1)

读取数据失败。

SPP_READ_SOCKET_CLOSED

#define SPP_READ_SOCKET_CLOSED   (0)

SPP连接已经断开。

SPP_WRITE_FAILED

#define SPP_WRITE_FAILED   (-1)

写数据失败。

类型定义说明

spp_conn_state_changed_callback

typedef void(* spp_conn_state_changed_callback) (uint8_t client_id, profile_connect_state_t state)

连接变化事件回调函数。

spp_receive_data_callback

typedef void(* spp_receive_data_callback) (uint8_t client_id, uint8_t *data, uint32_t data_len)

接收到数据回调函数。

枚举类型说明

spp_socket_type_t

enum spp_socket_type_t

SPP socket类型定义枚举。

枚举值
SPP_SOCKET_RFCOMM	RFCOMM

函数说明

is_spp_connected()

bool is_spp_connected

(

int

client_id

)

获取指定SPP socket的连接状态。

spp_connect()

int spp_connect	(	spp_create_socket_para_t *	socket_para,
		const bd_addr_t *	bd_addr
	)

连接远端设备。

spp_disconnect()

int spp_disconnect

(

int

client_id

)

断开连接（同时释放相关资源）。

spp_get_remote_addr()

int spp_get_remote_addr	(	int	client_id,
		bd_addr_t *	remote_addr
	)

获取SPP socket对应远端设备的地址。

spp_register_callbacks()

int spp_register_callbacks

(

spp_callbacks_t *

func

)

注册PBAP回调函数。

spp_server_accept()

int spp_server_accept

(

int

server_id

)

等待远端设备来连接此Server。

spp_server_close()

int spp_server_close

(

int

server_id

)

关闭Server（同时释放相关资源）。

spp_server_create()

int spp_server_create	(	spp_create_socket_para_t *	socket_para,
		const char *	name,
		unsigned int	len
	)

创建SPP Server。

spp_write()

int spp_write	(	int	client_id,
		const char *	data,
		const unsigned int	len
	)

向SPP socket写入数据