l2cap.h

Go to the documentation of this file.

/******************************************************************************

 Group: WCS, BTS
 $Target Device: DEVICES $

 ******************************************************************************
 $License: TI_TEXT 2009 $
 ******************************************************************************
 $Release Name: PACKAGE NAME $
 $Release Date: PACKAGE RELEASE DATE $
 *****************************************************************************/

#ifndef L2CAP_H
#define L2CAP_H

#ifdef __cplusplus
extern "C"
{
#endif

/*********************************************************************
 * INCLUDES
 */
#include "ti/ble/stack_util/bcomdef.h"
#include "ti/ble/stack_util/osal/osal.h"

/*********************************************************************
 * CONSTANTS
 */

#define L2CAP_MTU_SIZE                   23 

#define L2CAP_SDU_SIZE                   65527 

#define L2CAP_NUM_PSM_DEFAULT            3 

#define L2CAP_NUM_CO_CHANNELS_DEFAULT    3 

#define L2CAP_SIG_MTU_SIZE               23U 

#define L2CAP_HDR_SIZE                   4 

#define L2CAP_MAX_NOF_CREDITS            0xFFFF 

#define L2CAP_LEN_FIELD_SIZE             2 


#define L2CAP_INVALID_PSM                0x0000 

#define L2CAP_FIXED_PSM_MIN              0x0001 
#define L2CAP_FIXED_PSM_MAX              0x007F 

#define L2CAP_DYNAMIC_PSM_MIN            0x0080 
#define L2CAP_DYNAMIC_PSM_MAX            0x00FF 


#define L2CAP_CID_NULL                   0x0000 

#define L2CAP_CID_ATT                    0x0004 
#define L2CAP_CID_SIG                    0x0005 
#define L2CAP_CID_SMP                    0x0006 
#define L2CAP_CID_GENERIC                0x0007 

#define L2CAP_DYNAMIC_CID_MIN            0x0040 
#define L2CAP_DYNAMIC_CID_MAX            0x007F 

#define L2CAP_NUM_FIXED_CHANNELS         4 

#define L2CAP_NUM_SIG_COMMANDS           1 


#define L2CAP_RTX_TIMEOUT                30

// Supported
#define L2CAP_CMD_REJECT                      0x01 
#define L2CAP_DISCONNECT_REQ                  0x06 
#define L2CAP_DISCONNECT_RSP                  0x07 
#define L2CAP_CONNECTION_PARAMETER_UPDATE_REQ 0x12 
#define L2CAP_PARAM_UPDATE_RSP                0x13 
#define L2CAP_CONNECT_IND                     0x14 
#define L2CAP_CONNECT_RSP                     0x15 
#define L2CAP_FLOW_CTRL_CREDIT                0x16 

// Not supported
#define L2CAP_CONNECTION_REQ               0x02 
#define L2CAP_CONNECTION_RSP               0x03 
#define L2CAP_CONFIGURATION_REQ            0x04 
#define L2CAP_CONFIGURATION_RSP            0x05 
#define L2CAP_ECHO_REQ                     0x08 
#define L2CAP_ECHO_RSP                     0x09 
#define L2CAP_INFO_REQ                     0x0a 
#define L2CAP_INFO_RSP                     0x0b 
#define L2CAP_CREDIT_BASED_CONNECTION_REQ  0x17 
#define L2CAP_CREDIT_BASED_CONNECTION_RSP  0x18 
#define L2CAP_CREDIT_BASED_RECONFIGURE_REQ 0x19 
#define L2CAP_CREDIT_BASED_RECONFIGURE_RSP 0x1A 


#define L2CAP_CHANNEL_ESTABLISHED_EVT    0x60 
#define L2CAP_CHANNEL_TERMINATED_EVT     0x61 
#define L2CAP_OUT_OF_CREDIT_EVT          0x62 
#define L2CAP_PEER_CREDIT_THRESHOLD_EVT  0x63 
#define L2CAP_SEND_SDU_DONE_EVT          0x64 
#define L2CAP_NUM_CTRL_DATA_PKT_EVT      0x65 
#define L2CAP_PEER_CREDIT_RECEIVED_EVT   0x66 


#define L2CAP_REJECT_CMD_NOT_UNDERSTOOD  0x0000 
#define L2CAP_REJECT_SIGNAL_MTU_EXCEED   0x0001 
#define L2CAP_REJECT_INVALID_CID         0x0002 


#define L2CAP_CONN_SUCCESS               0x0000 
#define L2CAP_CONN_PSM_NOT_SUPPORTED     0x0002 
#define L2CAP_CONN_NO_RESOURCES          0x0004 
#define L2CAP_CONN_INSUFFICIENT_AUTHEN   0x0005 
#define L2CAP_CONN_INSUFFICIENT_AUTHOR   0x0006 
#define L2CAP_CONN_INSUFFICIENT_KEY_SIZE 0x0007 
#define L2CAP_CONN_INSUFFICIENT_ENCRYPT  0x0008 
#define L2CAP_CONN_INVALID_SRC_CID       0x0009 
#define L2CAP_CONN_SRC_CID_ALREADY_ALLOC 0x000A 
#define L2CAP_CONN_UNACCEPTABLE_PARAMS   0x000B 

#define L2CAP_CONN_PENDING_SEC_VERIFY    0xFFFF 


#define L2CAP_CONN_PARAMS_ACCEPTED       0x0000 
#define L2CAP_CONN_PARAMS_REJECTED       0x0001 


#define L2CAP_TERM_LINK_DOWN             0x0000 
#define L2CAP_TERM_BY_PSM                0x0001 
#define L2CAP_TERM_BY_PEER_PSM           0x0002 
#define L2CAP_TERM_MAX_CREDIT_EXCEED     0x0003 
#define L2CAP_TERM_SDU_LEN_EXCEED        0x0004 
#define L2CAP_TERM_PSM_MTU_EXCEED        0x0005 
#define L2CAP_TERM_RX_PKT_NO_CREDIT      0x0006 
#define L2CAP_TERM_RX_ERROR              0x0007 
#define L2CAP_TERM_TX_ERROR              0x0008 
#define L2CAP_TERM_MEM_ALLOC_ERROR       0x0009 


#define L2CAP_CLOSED                     0x00U 
#define L2CAP_OPEN                       0x01U 
#define L2CAP_PENDING_CONN_RSP           0x02U 
#define L2CAP_PENDING_DISCONN_RSP        0x03U 
#define L2CAP_PENDING_PARAM_UPDATE_RSP   0x04U 
#define L2CAP_PENDING_INFO_RSP           0x05U 
#define L2CAP_PENDING_SEC_VERIFY         0x06U 


#define L2CAP_INFO_CONNLESS_MTU          0x0001 
#define L2CAP_INFO_EXTENDED_FEATURES     0x0002 
#define L2CAP_INFO_FIXED_CHANNELS        0x0003 


/*********************************************************************
 * Information Response: Extended Features Mask Values
 */
#define L2CAP_FIXED_CHANNELS             0x00000080 

#define L2CAP_EXTENDED_FEATURES_SIZE     4 

/*********************************************************************
 * Information Response: Fixed Channels Mask Values
 */
#define L2CAP_FIXED_CHANNELS_ATT         0x10 

#define L2CAP_FIXED_CHANNELS_SIG         0x20 

#define L2CAP_FIXED_CHANNELS_SMP         0x40 

#define L2CAP_FIXED_CHANNELS_SIZE        8 

/*********************************************************************
 * Information Response: Result Values
 */
#define L2CAP_INFO_SUCCESS               0x0000 

#define L2CAP_INFO_NOT_SUPPORTED         0x0001 


/*********************************************************************
 * L2CAP Test Modes: Test code values
 */
#if defined ( TESTMODES )
  // Test modes 0 through 10 are reserved for L2CAP Connection Request.
  #define L2CAP_TESTMODE_OFF                   0  
  #define L2CAP_TESTMODE_PSM_NOT_SUPPORTED     2  
  #define L2CAP_TESTMODE_NO_RESOURCES          4  
  #define L2CAP_TESTMODE_INSUFF_AUTHEN         5  
  #define L2CAP_TESTMODE_INSUFF_AUTHOR         6  
  #define L2CAP_TESTMODE_INSUFF_KEY_SIZE       7  
  #define L2CAP_TESTMODE_INSUFF_ENCRYPT        8  
  #define L2CAP_TESTMODE_INVALID_SRC_CID       9  
  #define L2CAP_TESTMODE_SRC_CID_ALREADY_ALLOC 10 
  #define L2CAP_TESTMODE_OUT_OF_RANGE_CREDITS  11 
  #define L2CAP_TESTMODE_SDU_LEN_EXCEED        12 
  #define L2CAP_TESTMODE_TX_PKT_NO_CREDIT      13 
  #define L2CAP_TESTMODE_BLOCK_DATA_TX         14 
#endif


/*********************************************************************
 * MACROS
 */

/*********************************************************************
 * TYPEDEFS
 */
typedef enum
{
     L2CAPCOC_INITIATOR = 0x00,  
     L2CAPCOC_RESPONDER = 0x01
}l2capConEstablishRole_t;
typedef struct
{
  uint8 maxNumPSM;        
  uint8 maxNumCoChannels; 
} l2capUserCfg_t;

typedef struct
{
  uint16 localCID;  
  uint16 remoteCID; 
} l2capInvalidCID_t;

typedef union
{
  uint16 signalMTU;             
  l2capInvalidCID_t invalidCID; 
} l2capReasonData_t;

typedef struct
{
  uint16 reason;                
  l2capReasonData_t reasonData; 

  // Shorthand access for union members
  #define maxSignalMTU     reasonData.signalMTU             
  #define invalidLocalCID  reasonData.invalidCID.localCID   
  #define invalidRemoteCID reasonData.invalidCID.remoteCID  
} l2capCmdReject_t;

typedef struct
{
  uint16 intervalMin;       
  uint16 intervalMax;       
  uint16 peripheralLatency;      
  uint16 timeoutMultiplier; 
} l2capParamUpdateReq_t;

typedef struct
{
  uint16 result; 
} l2capParamUpdateRsp_t;

typedef struct
{
  uint16 infoType; 
} l2capInfoReq_t;

typedef union
{
  uint16 connectionlessMTU;                       
  uint32 extendedFeatures;                        
  uint8 fixedChannels[L2CAP_FIXED_CHANNELS_SIZE]; 
} l2capInfo_t;

typedef struct
{
  uint16 result;    
  uint16 infoType;  
  l2capInfo_t info; 
} l2capInfoRsp_t;

typedef struct
{
  uint16 psm;         
  uint16 srcCID;      
  uint16 mtu;         
  uint16 mps;         
  uint16 initCredits; 
} l2capConnectReq_t;

typedef struct
{
  uint16 dstCID;      
  uint16 mtu;         
  uint16 mps;         
  uint16 initCredits; 
  uint16 result;      
} l2capConnectRsp_t;

typedef struct
{
  uint16 dstCID; 
  uint16 srcCID; 
} l2capDisconnectReq_t;

typedef struct
{
  uint16 dstCID; 
  uint16 srcCID; 
} l2capDisconnectRsp_t;

typedef struct
{
  uint16 CID;     
  uint16 credits; 
} l2capFlowCtrlCredit_t;

typedef struct
{
  uint16 mtu;                 
  uint16 mps;                 
  uint16 initPeerCredits;     
  uint16 peerCreditThreshold; 
  uint8 maxNumChannels;       
  uint8 numActiveChannels;    
} l2capPsmInfo_t;

typedef struct
{
  uint16 connHandle;          
  uint16 psm;                 
  uint16 mtu;                 
  uint16 mps;                 
  uint16 credits;             
  uint16 peerCID;             
  uint16 peerMtu;             
  uint16 peerMps;             
  uint16 peerCredits;         
  uint16 peerCreditThreshold; 
} l2capCoCInfo_t;

typedef struct
{
  uint8 state;         
  l2capCoCInfo_t info; 
} l2capChannelInfo_t;

typedef struct
{
  uint16 connHandle;   
  uint16 CID;          
} l2capLocalChannelInfo_t;

typedef struct
{
  uint16 result;       
  uint16 CID;          
  l2capCoCInfo_t info; 
} l2capChannelEstEvt_t;

typedef struct
{
  uint16 CID;     
  uint16 peerCID; 
  uint16 reason;  
} l2capChannelTermEvt_t;

typedef struct
{
  uint16 CID;     
  uint16 peerCID; 
  uint16 credits; 
} l2capCreditEvt_t;

typedef struct
{
  uint16 CID;         
  uint16 credits;     
  uint16 peerCID;     
  uint16 peerCredits; 
  uint16 totalLen;    
  uint16 txLen;       
} l2capSendSduDoneEvt_t;

typedef struct
{
  uint8 numDataPkt;   
} l2capNumCtrlDataPktEvt_t;

typedef union
{
  // Requests
  l2capParamUpdateReq_t updateReq;              
  l2capInfoReq_t infoReq;                       
  l2capConnectReq_t connectReq;                 
  l2capDisconnectReq_t disconnectReq;           
  l2capFlowCtrlCredit_t credit;                 

  // Responses
  l2capParamUpdateRsp_t updateRsp;              
  l2capInfoRsp_t infoRsp;                       
  l2capCmdReject_t cmdReject;                   
  l2capConnectRsp_t connectRsp;                 
  l2capDisconnectRsp_t disconnectRsp;           

  // Proprietary local events
  l2capChannelEstEvt_t channelEstEvt;           
  l2capChannelTermEvt_t channelTermEvt;         
  l2capCreditEvt_t creditEvt;                   
  l2capSendSduDoneEvt_t sendSduDoneEvt;         
  l2capNumCtrlDataPktEvt_t numCtrlDataPktEvt;       
} l2capSignalCmd_t;

typedef struct
{
  osal_event_hdr_t hdr; 
  uint16 connHandle;    
  uint8 id;             
  uint8 opcode;         
  l2capSignalCmd_t cmd; 
} l2capSignalEvent_t;

typedef struct
{
  uint16 connHandle; 
  uint16 CID;        
  uint8 *pPayload;   
  uint16 len;        
} l2capPacket_t;

typedef struct
{
  osal_event_hdr_t hdr; 
  l2capPacket_t pkt;    
} l2capDataEvent_t;

typedef uint16 (*pfnVerifySecCB_t)( uint16 connHandle, uint8 id, l2capConnectReq_t *pReq );

typedef struct
{
  uint16 psm;                      
  uint16 mtu;                      
  uint16 mps;                      
  uint16 initPeerCredits;          
  uint16 peerCreditThreshold;      
  uint8 maxNumChannels;            
  uint8 taskId;                    
  pfnVerifySecCB_t pfnVerifySecCB; 
} l2capPsm_t;
 // end of L2CAP_Structs

/*********************************************************************
 * GLOBAL VARIABLES
 */

/*********************************************************************
 * FUNCTIONS
 */

extern bStatus_t L2CAP_RegisterApp( uint8 taskId, uint16 CID );

extern void L2CAP_RegisterFlowCtrlTask( uint8 taskId );

extern bStatus_t L2CAP_SendData( l2capPacket_t *pPkt );

extern bStatus_t L2CAP_RegisterPsm( l2capPsm_t *pPsm );

extern bStatus_t L2CAP_DeregisterPsm( uint8 taskId, uint16 psm );

extern bStatus_t L2CAP_PsmInfo( uint16 psm, l2capPsmInfo_t *pInfo );

extern bStatus_t L2CAP_PsmChannels( uint16 psm, uint8 numCIDs, l2capLocalChannelInfo_t *pCIDs );

extern bStatus_t L2CAP_ChannelInfo( uint16 connHandle, uint16 CID, l2capChannelInfo_t *pInfo );

extern bStatus_t L2CAP_ConnectReq( uint16 connHandle, uint16 psm, uint16 peerPsm );

extern bStatus_t L2CAP_ConnectRsp( uint16 connHandle, uint8 id, uint16 result );

extern bStatus_t L2CAP_DisconnectReq( uint16 connHandle, uint16 CID );

extern bStatus_t L2CAP_FlowCtrlCredit( uint16 connHandle, uint16 CID, uint16 peerCredits );

extern bStatus_t L2CAP_SendSDU( l2capPacket_t *pPkt );

extern bStatus_t L2CAP_CmdReject( uint16 connHandle, uint8 id, l2capCmdReject_t *pCmdReject );

extern bStatus_t L2CAP_InfoReq( uint16 connHandle, l2capInfoReq_t *pInfoReq, uint8 taskId );

extern bStatus_t L2CAP_ConnParamUpdateReq( uint16 connHandle, l2capParamUpdateReq_t *pUpdateReq, uint8 taskId );

extern bStatus_t L2CAP_ConnParamUpdateRsp( uint16 connHandle, uint8 id, l2capParamUpdateRsp_t *pUpdateRsp );

extern void L2CAP_SetUserConfig( l2capUserCfg_t *pUserCfg );

extern void L2CAP_GetUserConfig( l2capUserCfg_t *pL2capCfg );

extern void L2CAP_SetBufSize( uint16 dataPktLen, uint8 numDataPkts );

extern uint16 L2CAP_GetMTU( void );

extern void *L2CAP_bm_alloc( uint16 size );

extern uint16 L2CAP_BuildConnectReq( uint8 *pBuf, uint8 *pData );

extern bStatus_t L2CAP_ParseConnectReq( l2capSignalCmd_t *pCmd, uint8 *pData, uint16 len );

extern bStatus_t L2CAP_ParseFlowCtrlCredit( l2capSignalCmd_t *pCmd, uint8 *pData, uint16 len );

extern uint16 L2CAP_BuildCmdReject( uint8 *pBuf, uint8 *pCmd );

extern bStatus_t L2CAP_ParseInfoReq( l2capSignalCmd_t *pCmd, uint8 *pData, uint16 len );

extern bStatus_t L2CAP_ParseParamUpdateReq( l2capSignalCmd_t *pCmd, uint8 *pData, uint16 len );

extern uint16 L2CAP_BuildParamUpdateRsp( uint8 *pBuf, uint8 *pData );

extern uint16 L2CAP_BuildInfoRsp( uint8 *pBuf, uint8 *pData );

extern void L2CAP_SetControllerToHostFlowCtrl( uint16 hostBuffSize, uint8 flowCtrlMode );

extern void L2CAP_HostNumCompletedPkts( uint16 connHandle, uint16 numCompletedPkts );

extern void L2CAP_SetParamValue( uint16 value );

extern uint16 L2CAP_GetParamValue( void );

/*-------------------------------------------------------------------
 * TASK API - These functions must only be called by OSAL.
 */


extern void L2CAP_Init( uint8 taskId );

extern uint32 L2CAP_ProcessEvent( uint8 taskId, uint32 events );


/*********************************************************************
*********************************************************************/

#ifdef __cplusplus
}
#endif

#endif /* L2CAP_H */