RFCOMM

RFCOMM. More...

Data Structures
struct	bt_rfcomm_dlc_ops
	RFCOMM DLC operations structure. More...
struct	bt_rfcomm_dlc
	RFCOMM DLC structure. More...
struct	bt_rfcomm_server
struct	bt_rfcomm_rpn
	RFCOMM Remote Port Negotiation (RPN) structure. More...

Macros
#define	BT_RFCOMM_HDR_MAX_SIZE   4
	RFCOMM Maximum Header Size.
#define	BT_RFCOMM_FCS_SIZE   1
	RFCOMM FCS Size.
#define	BT_RFCOMM_CREDITS_SIZE   1
	RFCOMM Credits Size.
#define	BT_RFCOMM_OVERHEAD_SIZE   (BT_RFCOMM_HDR_MAX_SIZE + BT_RFCOMM_FCS_SIZE + BT_RFCOMM_CREDITS_SIZE)
	RFCOMM Overhead Size.
#define	BT_RFCOMM_BUF_SIZE(mtu)
	Helper to calculate needed buffer size for RFCOMM PDUs.
#define	BT_RFCOMM_SET_LINE_SETTINGS(data, stop, parity)
	Combine data bits, stop bits and parity into a single line settings byte.
#define	BT_RFCOMM_RPN_FLOW_NONE   0x00
#define	BT_RFCOMM_RPN_XON_CHAR   0x11
#define	BT_RFCOMM_RPN_XOFF_CHAR   0x13
#define	BT_RFCOMM_RPN_PARAM_MASK_ALL   0x3f7f

Typedefs
typedef enum bt_rfcomm_role	bt_rfcomm_role_t
	Role of RFCOMM session and dlc.

Enumerations
enum	{   BT_RFCOMM_CHAN_HFP_HF = 1 , BT_RFCOMM_CHAN_HFP_AG , BT_RFCOMM_CHAN_HSP_AG , BT_RFCOMM_CHAN_HSP_HS ,   BT_RFCOMM_CHAN_SPP , BT_RFCOMM_CHAN_DYNAMIC_START }
enum	bt_rfcomm_role { BT_RFCOMM_ROLE_ACCEPTOR , BT_RFCOMM_ROLE_INITIATOR }
	Role of RFCOMM session and dlc. More...
enum	{   BT_RFCOMM_RPN_BAUD_RATE_2400 = 0x0 , BT_RFCOMM_RPN_BAUD_RATE_4800 = 0x1 , BT_RFCOMM_RPN_BAUD_RATE_7200 = 0x2 , BT_RFCOMM_RPN_BAUD_RATE_9600 = 0x3 ,   BT_RFCOMM_RPN_BAUD_RATE_19200 = 0x4 , BT_RFCOMM_RPN_BAUD_RATE_38400 = 0x5 , BT_RFCOMM_RPN_BAUD_RATE_57600 = 0x6 , BT_RFCOMM_RPN_BAUD_RATE_115200 = 0x7 ,   BT_RFCOMM_RPN_BAUD_RATE_230400 = 0x8 }
	RFCOMM RPN baud rate values. More...
enum	{ BT_RFCOMM_RPN_DATA_BITS_5 = 0x0 , BT_RFCOMM_RPN_DATA_BITS_6 = 0x1 , BT_RFCOMM_RPN_DATA_BITS_7 = 0x2 , BT_RFCOMM_RPN_DATA_BITS_8 = 0x3 }
	RFCOMM RPN data bit values. More...
enum	{ BT_RFCOMM_RPN_STOP_BITS_1 = 0 , BT_RFCOMM_RPN_STOP_BITS_1_5 = 1 }
	RFCOMM RPN stop bit values. More...
enum	{   BT_RFCOMM_RPN_PARITY_NONE = 0x0 , BT_RFCOMM_RPN_PARITY_ODD = 0x1 , BT_RFCOMM_RPN_PARITY_EVEN = 0x3 , BT_RFCOMM_RPN_PARITY_MARK = 0x5 ,   BT_RFCOMM_RPN_PARITY_SPACE = 0x7 }
	RFCOMM RPN parity bit values. More...

Functions
int	bt_rfcomm_server_register (struct bt_rfcomm_server *server)
	Register RFCOMM server.
int	bt_rfcomm_server_unregister (struct bt_rfcomm_server *server)
	Unregister RFCOMM server.
int	bt_rfcomm_dlc_connect (struct bt_conn *conn, struct bt_rfcomm_dlc *dlc, uint8_t channel)
	Connect RFCOMM channel.
int	bt_rfcomm_dlc_send (struct bt_rfcomm_dlc *dlc, struct net_buf *buf)
	Send data to RFCOMM.
int	bt_rfcomm_dlc_disconnect (struct bt_rfcomm_dlc *dlc)
	Disconnect RFCOMM dlc.
struct net_buf *	bt_rfcomm_create_pdu (struct net_buf_pool *pool)
	Allocate the buffer from pool after reserving head room for RFCOMM, L2CAP and ACL headers.
int	bt_rfcomm_send_rpn_cmd (struct bt_rfcomm_dlc *dlc, struct bt_rfcomm_rpn *rpn)
	Send Remote Port Negotiation command.

Detailed Description

RFCOMM.

Macro Definition Documentation

BT_RFCOMM_BUF_SIZE

#define BT_RFCOMM_BUF_SIZE

(

mtu

)

#include <rfcomm.h>

Value:

BT_L2CAP_BUF_SIZE(BT_RFCOMM_OVERHEAD_SIZE + (mtu))

Helper to calculate needed buffer size for RFCOMM PDUs.

Useful for creating buffer pools.

Parameters

mtu	Needed RFCOMM PDU MTU.

Returns

Needed buffer size to match the requested RFCOMM PDU MTU.

BT_RFCOMM_CREDITS_SIZE

#define BT_RFCOMM_CREDITS_SIZE   1

#include <rfcomm.h>

RFCOMM Credits Size.

BT_RFCOMM_FCS_SIZE

#define BT_RFCOMM_FCS_SIZE   1

#include <rfcomm.h>

RFCOMM FCS Size.

BT_RFCOMM_HDR_MAX_SIZE

#define BT_RFCOMM_HDR_MAX_SIZE   4

#include <rfcomm.h>

RFCOMM Maximum Header Size.

The length could be 2 bytes, it depends on information length.

BT_RFCOMM_OVERHEAD_SIZE

#define BT_RFCOMM_OVERHEAD_SIZE   (BT_RFCOMM_HDR_MAX_SIZE + BT_RFCOMM_FCS_SIZE + BT_RFCOMM_CREDITS_SIZE)

#include <rfcomm.h>

RFCOMM Overhead Size.

The overhead size of RFCOMM includes the maximum header size, FCS size, and credits size.

For the field credits size, in the CFC supported case, the space of credits should be discounted from the maximum frame size. It is used to avoid the SDU length exceeding the maximum frame size if the credits field is included.

BT_RFCOMM_RPN_FLOW_NONE

#define BT_RFCOMM_RPN_FLOW_NONE   0x00

#include <rfcomm.h>

BT_RFCOMM_RPN_PARAM_MASK_ALL

#define BT_RFCOMM_RPN_PARAM_MASK_ALL   0x3f7f

#include <rfcomm.h>

BT_RFCOMM_RPN_XOFF_CHAR

#define BT_RFCOMM_RPN_XOFF_CHAR   0x13

#include <rfcomm.h>

BT_RFCOMM_RPN_XON_CHAR

#define BT_RFCOMM_RPN_XON_CHAR   0x11

#include <rfcomm.h>

BT_RFCOMM_SET_LINE_SETTINGS

#define BT_RFCOMM_SET_LINE_SETTINGS	(		data,
			stop,
			parity )

#include <rfcomm.h>

Value:

((data & 0x3) | \
((stop & 0x1) << 2) | \
((parity & 0x7) << 3))

Combine data bits, stop bits and parity into a single line settings byte.

Parameters

data	Data bits value (0-3)
stop	Stop bits value (0-1)
parity	Parity value (0-7)

Returns

Combined line settings byte

Typedef Documentation

bt_rfcomm_role_t

typedef enum bt_rfcomm_role bt_rfcomm_role_t

#include <rfcomm.h>

Role of RFCOMM session and dlc.

Used only by internal APIs

Enumeration Type Documentation

anonymous enum

anonymous enum

#include <rfcomm.h>

RFCOMM RPN parity bit values.

Enumerator
BT_RFCOMM_RPN_PARITY_NONE
BT_RFCOMM_RPN_PARITY_ODD
BT_RFCOMM_RPN_PARITY_EVEN
BT_RFCOMM_RPN_PARITY_MARK
BT_RFCOMM_RPN_PARITY_SPACE

anonymous enum

anonymous enum

#include <rfcomm.h>

Enumerator
BT_RFCOMM_CHAN_HFP_HF
BT_RFCOMM_CHAN_HFP_AG
BT_RFCOMM_CHAN_HSP_AG
BT_RFCOMM_CHAN_HSP_HS
BT_RFCOMM_CHAN_SPP
BT_RFCOMM_CHAN_DYNAMIC_START

anonymous enum

anonymous enum

#include <rfcomm.h>

RFCOMM RPN data bit values.

Enumerator
BT_RFCOMM_RPN_DATA_BITS_5
BT_RFCOMM_RPN_DATA_BITS_6
BT_RFCOMM_RPN_DATA_BITS_7
BT_RFCOMM_RPN_DATA_BITS_8

anonymous enum

anonymous enum

#include <rfcomm.h>

RFCOMM RPN stop bit values.

Enumerator
BT_RFCOMM_RPN_STOP_BITS_1
BT_RFCOMM_RPN_STOP_BITS_1_5

anonymous enum

anonymous enum

#include <rfcomm.h>

RFCOMM RPN baud rate values.

Enumerator
BT_RFCOMM_RPN_BAUD_RATE_2400
BT_RFCOMM_RPN_BAUD_RATE_4800
BT_RFCOMM_RPN_BAUD_RATE_7200
BT_RFCOMM_RPN_BAUD_RATE_9600
BT_RFCOMM_RPN_BAUD_RATE_19200
BT_RFCOMM_RPN_BAUD_RATE_38400
BT_RFCOMM_RPN_BAUD_RATE_57600
BT_RFCOMM_RPN_BAUD_RATE_115200
BT_RFCOMM_RPN_BAUD_RATE_230400

bt_rfcomm_role

enum bt_rfcomm_role

#include <rfcomm.h>

Role of RFCOMM session and dlc.

Used only by internal APIs

Enumerator
BT_RFCOMM_ROLE_ACCEPTOR
BT_RFCOMM_ROLE_INITIATOR

Function Documentation

bt_rfcomm_create_pdu()

struct net_buf * bt_rfcomm_create_pdu

(

struct net_buf_pool *

pool

)

#include <rfcomm.h>

Allocate the buffer from pool after reserving head room for RFCOMM, L2CAP and ACL headers.

Parameters

pool	Which pool to take the buffer from.

Returns

New buffer.

bt_rfcomm_dlc_connect()

int bt_rfcomm_dlc_connect	(	struct bt_conn *	conn,
		struct bt_rfcomm_dlc *	dlc,
		uint8_t	channel )

#include <rfcomm.h>

Connect RFCOMM channel.

Connect RFCOMM dlc by channel, once the connection is completed dlc connected() callback will be called. If the connection is rejected disconnected() callback is called instead.

Parameters

conn	Connection object.
dlc	Dlc object.
channel	Server channel to connect to.

Returns

0 in case of success or negative value in case of error.

bt_rfcomm_dlc_disconnect()

int bt_rfcomm_dlc_disconnect

(

struct bt_rfcomm_dlc *

dlc

)

#include <rfcomm.h>

Disconnect RFCOMM dlc.

Disconnect RFCOMM dlc, if the connection is pending it will be canceled and as a result the dlc disconnected() callback is called.

Parameters

dlc	Dlc object.

Returns

0 in case of success or negative value in case of error.

bt_rfcomm_dlc_send()

int bt_rfcomm_dlc_send	(	struct bt_rfcomm_dlc *	dlc,
		struct net_buf *	buf )

#include <rfcomm.h>

Send data to RFCOMM.

Send data from buffer to the dlc. Length should be less than or equal to mtu.

Parameters

dlc	Dlc object.
buf	Data buffer.

Returns

Bytes sent in case of success or negative value in case of error.

bt_rfcomm_send_rpn_cmd()

int bt_rfcomm_send_rpn_cmd	(	struct bt_rfcomm_dlc *	dlc,
		struct bt_rfcomm_rpn *	rpn )

#include <rfcomm.h>

Send Remote Port Negotiation command.

Parameters

dlc	Pointer to the RFCOMM DLC
rpn	Pointer to the RPN parameters to send

Returns

0 on success, negative error code on failure

bt_rfcomm_server_register()

int bt_rfcomm_server_register

(

struct bt_rfcomm_server *

server

)

#include <rfcomm.h>

Register RFCOMM server.

Register RFCOMM server for a channel, each new connection is authorized using the accept() callback which in case of success shall allocate the dlc structure to be used by the new connection.

Parameters

server

Server structure.

Returns

0 in case of success or negative value in case of error.

bt_rfcomm_server_unregister()

int bt_rfcomm_server_unregister

(

struct bt_rfcomm_server *

server

)

#include <rfcomm.h>

Unregister RFCOMM server.

Unregister RFCOMM server for a channel.

Parameters

server

Server structure.

Returns

0 in case of success or negative value in case of error.