lldp.h

Go to the documentation of this file.

 
#ifndef _LLDP_H
#define _LLDP_H
 
//Forward declaration of LldpDataUnit structure
struct _LldpDataUnit;
#define LldpDataUnit struct _LldpDataUnit
 
//Forward declaration of LldpAgentContext structure
struct _LldpAgentContext;
#define LldpAgentContext struct _LldpAgentContext
 
//Forward declaration of LldpPortEntry structure
struct _LldpPortEntry;
#define LldpPortEntry struct _LldpPortEntry
 
//Dependencies
#include "core/net.h"
#include "lldp/lldp_rx_fsm.h"
#include "lldp/lldp_tx_fsm.h"
#include "lldp/lldp_tlv.h"
 
//LLDP agent support
#ifndef LLDP_SUPPORT
   #define LLDP_SUPPORT DISABLED
#elif (LLDP_SUPPORT != ENABLED && LLDP_SUPPORT != DISABLED)
   #error LLDP_SUPPORT parameter is not valid
#endif
 
//LLDP TX mode support
#ifndef LLDP_TX_MODE_SUPPORT
   #define LLDP_TX_MODE_SUPPORT ENABLED
#elif (LLDP_TX_MODE_SUPPORT != ENABLED && LLDP_TX_MODE_SUPPORT != DISABLED)
   #error LLDP_TX_MODE_SUPPORT parameter is not valid
#endif
 
//LLDP RX mode support
#ifndef LLDP_RX_MODE_SUPPORT
   #define LLDP_RX_MODE_SUPPORT ENABLED
#elif (LLDP_RX_MODE_SUPPORT != ENABLED && LLDP_RX_MODE_SUPPORT != DISABLED)
   #error LLDP_RX_MODE_SUPPORT parameter is not valid
#endif
 
//Stack size required to run the LLDP agent
#ifndef LLDP_TASK_STACK_SIZE
   #define LLDP_TASK_STACK_SIZE 500
#elif (LLDP_TASK_STACK_SIZE < 1)
   #error LLDP_TASK_STACK_SIZE parameter is not valid
#endif
 
//Priority at which the LLDP agent should run
#ifndef LLDP_TASK_PRIORITY
   #define LLDP_TASK_PRIORITY OS_TASK_PRIORITY_NORMAL
#endif
 
//LLDP tick interval (in milliseconds)
#ifndef LLDP_TICK_INTERVAL
   #define LLDP_TICK_INTERVAL 1000
#elif (LLDP_TICK_INTERVAL < 10)
   #error LLDP_TICK_INTERVAL parameter is not valid
#endif
 
//Maximum LLDP data unit size
#ifndef LLDP_MAX_LLDPDU_SIZE
   #define LLDP_MAX_LLDPDU_SIZE 500
#elif (LLDP_MAX_LLDPDU_SIZE < 100 || LLDP_MAX_LLDPDU_SIZE > 1500)
   #error LLDP_MAX_LLDPDU_SIZE parameter is not valid
#endif
 
//Maximum number of management addresses
#ifndef LLDP_MAX_MGMT_ADDRS
   #define LLDP_MAX_MGMT_ADDRS 10
#elif (LLDP_MAX_MGMT_ADDRS < 1 || LLDP_MAX_MGMT_ADDRS > 32)
   #error LLDP_MAX_MGMT_ADDRS parameter is not valid
#endif
 
//Minimum msgTxInterval value
#define LLDP_MIN_MSG_TX_INTERVAL 1
//Default msgTxInterval value
#define LLDP_DEFAULT_MSG_TX_INTERVAL 30
//Maximum msgTxInterval value
#define LLDP_MAX_MSG_TX_INTERVAL 3600
 
//Minimum msgTxHold value
#define LLDP_MIN_MSG_TX_HOLD 1
//Default msgTxHold value
#define LLDP_DEFAULT_MSG_TX_HOLD 4
//Maximum msgTxHold value
#define LLDP_MAX_MSG_TX_HOLD 100
 
//Minimum reinitDelay value
#define LLDP_MIN_REINIT_DELAY 1
//Default reinitDelay value
#define LLDP_DEFAULT_REINIT_DELAY 2
//Maximum reinitDelay value
#define LLDP_MAX_REINIT_DELAY 10
 
//Minimum txDelay value
#define LLDP_MIN_TX_DELAY 1
//Default txDelay value
#define LLDP_DEFAULT_TX_DELAY 2
//Maximum txDelay value
#define LLDP_MAX_TX_DELAY 900
 
//Minimum notification interval
#define LLDP_MIN_NOTIFICATION_INTERVAL 5
//Default notification interval
#define LLDP_DEFAULT_NOTIFICATION_INTERVAL 5
//Maximum notification interval
#define LLDP_MAX_NOTIFICATION_INTERVAL 3600
 
//Management address filter
#define LLDP_MGMT_ADDR_FILTER_0   0x00000001
#define LLDP_MGMT_ADDR_FILTER_1   0x00000002
#define LLDP_MGMT_ADDR_FILTER_2   0x00000004
#define LLDP_MGMT_ADDR_FILTER_3   0x00000008
#define LLDP_MGMT_ADDR_FILTER_4   0x00000010
#define LLDP_MGMT_ADDR_FILTER_5   0x00000020
#define LLDP_MGMT_ADDR_FILTER_6   0x00000040
#define LLDP_MGMT_ADDR_FILTER_7   0x00000080
#define LLDP_MGMT_ADDR_FILTER_8   0x00000100
#define LLDP_MGMT_ADDR_FILTER_9   0x00000200
#define LLDP_MGMT_ADDR_FILTER_10  0x00000400
#define LLDP_MGMT_ADDR_FILTER_11  0x00000800
#define LLDP_MGMT_ADDR_FILTER_12  0x00001000
#define LLDP_MGMT_ADDR_FILTER_13  0x00002000
#define LLDP_MGMT_ADDR_FILTER_14  0x00004000
#define LLDP_MGMT_ADDR_FILTER_15  0x00008000
#define LLDP_MGMT_ADDR_FILTER_16  0x00010000
#define LLDP_MGMT_ADDR_FILTER_17  0x00020000
#define LLDP_MGMT_ADDR_FILTER_18  0x00040000
#define LLDP_MGMT_ADDR_FILTER_19  0x00080000
#define LLDP_MGMT_ADDR_FILTER_20  0x00100000
#define LLDP_MGMT_ADDR_FILTER_21  0x00200000
#define LLDP_MGMT_ADDR_FILTER_22  0x00400000
#define LLDP_MGMT_ADDR_FILTER_23  0x00800000
#define LLDP_MGMT_ADDR_FILTER_24  0x01000000
#define LLDP_MGMT_ADDR_FILTER_25  0x02000000
#define LLDP_MGMT_ADDR_FILTER_26  0x04000000
#define LLDP_MGMT_ADDR_FILTER_27  0x08000000
#define LLDP_MGMT_ADDR_FILTER_28  0x10000000
#define LLDP_MGMT_ADDR_FILTER_29  0x20000000
#define LLDP_MGMT_ADDR_FILTER_30  0x40000000
#define LLDP_MGMT_ADDR_FILTER_31  0x80000000
#define LLDP_MGMT_ADDR_FILTER_ALL 0xFFFFFFFF
 
//C++ guard
#ifdef __cplusplus
extern "C" {
#endif
 
 
typedef enum
{
   LLDP_ADMIN_STATUS_DISABLED        = 0, 
   LLDP_ADMIN_STATUS_ENABLED_TX_ONLY = 1, 
   LLDP_ADMIN_STATUS_ENABLED_RX_ONLY = 2, 
   LLDP_ADMIN_STATUS_ENABLED_TX_RX   = 3, 
} LldpAdminStatus;
 
 
typedef enum
{
   LLDP_BASIC_TLV_FILTER_PORT_DESC = 0x01, 
   LLDP_BASIC_TLV_FILTER_SYS_NAME  = 0x02, 
   LLDP_BASIC_TLV_FILTER_SYS_DESC  = 0x04, 
   LLDP_BASIC_TLV_FILTER_SYS_CAP   = 0x08, 
   LLDP_BASIC_TLV_FILTER_ALL       = 0x0F  
} LldpBasicTlvFilter;
 
 
typedef void (*LldpSendCallback)(LldpPortEntry *port, LldpDataUnit *lldpdu);
 
 
typedef void (*LldpReceiveCallback)(LldpPortEntry *port, LldpDataUnit *lldpdu);
 
 
typedef void (*LldpTickCallback)(LldpAgentContext *context);
 
 
struct _LldpDataUnit
{
   uint8_t data[LLDP_MAX_LLDPDU_SIZE];
   size_t length;
   size_t pos;
};
 
 
typedef struct
{
   const uint8_t *chassisId; 
   size_t chassisIdLen;      
   const uint8_t *portId;    
   size_t portIdLen;         
} LldpMsapId;
 
 
typedef struct
{
   uint32_t index;      
   uint32_t timeMark;   
   uint_t portIndex;    
   uint_t rxInfoTTL;    
   LldpDataUnit rxInfo; 
} LldpNeighborEntry;
 
 
struct _LldpPortEntry
{
   LldpAgentContext *context;           
   uint8_t portIndex;                   
   LldpAdminStatus adminStatus;         
   bool_t portEnabled;                  
 
#if (LLDP_TX_MODE_SUPPORT == ENABLED)
   MacAddr macAddr;                     
   LldpDataUnit txInfo;                 
   uint8_t basicTlvFilter;              
   uint32_t mgmtAddrFilter;             
   LldpTxState txState;                 
   uint_t txShutdownWhile;              
   uint_t txDelayWhile;                 
   uint_t txTTR;                        
   bool_t somethingChangedLocal;        
   uint_t txTTL;                        
   uint32_t statsFramesOutTotal;        
   uint32_t lldpduLengthErrors;         
#endif
 
#if (LLDP_RX_MODE_SUPPORT == ENABLED)
   LldpRxState rxState;                 
   bool_t notificationEnable;           
   bool_t rcvFrame;                     
   uint_t rxInfoAge;                    
   uint32_t statsFramesDiscardedTotal;  
   uint32_t statsFramesInErrorsTotal;   
   uint32_t statsFramesInTotal;         
   uint32_t statsTLVsDiscardedTotal;    
   uint32_t statsTLVsUnrecognizedTotal; 
   uint32_t statsAgeoutsTotal;          
#endif
};
 
 
typedef struct
{
   NetInterface *interface;             
   uint_t numPorts;                     
   LldpPortEntry *ports;                
   uint_t numNeighbors;                 
   LldpNeighborEntry *neighbors;        
   LldpSendCallback sendCallback;       
   LldpReceiveCallback receiveCallback; 
   LldpTickCallback tickCallback;       
} LldpAgentSettings;
 
 
struct _LldpAgentContext
{
   NetInterface *interface;                     
   uint_t numPorts;                             
   LldpPortEntry *ports;                        
   uint_t numNeighbors;                         
   LldpNeighborEntry *neighbors;                
   LldpSendCallback sendCallback;               
   LldpReceiveCallback receiveCallback;         
   LldpTickCallback tickCallback;               
 
   bool_t running;                              
   bool_t stop;                                 
   OsMutex mutex;                               
   OsEvent event;                               
   OsTaskId taskId;                             
#if (OS_STATIC_TASK_SUPPORT == ENABLED)
   OsTaskTcb taskTcb;                           
   OsStackType taskStack[LLDP_TASK_STACK_SIZE]; 
#endif
   Socket *socket;                              
   systime_t timestamp;                         
   LldpDataUnit lldpdu;                         
 
#if (LLDP_TX_MODE_SUPPORT == ENABLED)
   LldpDataUnit txInfo;                         
   uint_t msgTxInterval;                        
   uint_t msgTxHold;                            
   uint_t reinitDelay;                          
   uint_t txDelay;                              
   uint32_t mgmtAddrMap;                        
#endif
 
#if (LLDP_RX_MODE_SUPPORT == ENABLED)
   uint32_t index;                              
   uint_t notificationInterval;                 
   uint_t tooManyNeighborsTimer;                
   bool_t badFrame;                             
   bool_t rxChanges;                            
   uint_t rxTTL;                                
   bool_t somethingChangedRemote;               
   bool_t tooManyNeighbors;                     
   uint32_t statsRemTablesLastChangeTime;
   uint32_t statsRemTablesInserts;
   uint32_t statsRemTablesDeletes;
   uint32_t statsRemTablesDrops;
   uint32_t statsRemTablesAgeouts;
#endif
 
   bool_t busy;                                 
};
 
 
//LLDP agent related functions
void lldpGetDefaultSettings(LldpAgentSettings *settings);
 
error_t lldpInit(LldpAgentContext *context,
   const LldpAgentSettings *settings);
 
error_t lldpStart(LldpAgentContext *context);
error_t lldpStop(LldpAgentContext *context);
 
error_t lldpSetPortAddr(LldpAgentContext *context, uint_t portIndex,
   const MacAddr *macAddr);
 
error_t lldpSetAdminStatus(LldpAgentContext *context, uint_t portIndex,
   LldpAdminStatus adminStatus);
 
error_t lldpSetBasicTlvFilter(LldpAgentContext *context, uint_t portIndex,
   uint8_t mask);
 
error_t lldpSetMgmtAddrFilter(LldpAgentContext *context, uint_t portIndex,
   uint32_t mask);
 
error_t lldpSetMsgTxInterval(LldpAgentContext *context, uint_t msgTxInterval);
error_t lldpSetMsgTxHold(LldpAgentContext *context, uint_t msgTxHold);
error_t lldpSetReinitDelay(LldpAgentContext *context, uint_t reinitDelay);
error_t lldpSetTxDelay(LldpAgentContext *context, uint_t txDelay);
 
error_t lldpSetLocalChassisId(LldpAgentContext *context,
   LldpChassisIdSubtype chassisIdSubtype, const void *chassisId,
   size_t chassisIdLen);
 
error_t lldpSetLocalPortId(LldpAgentContext *context, uint_t portIndex,
   LldpPortIdSubtype portIdSubtype, const void *portId, size_t portIdLen);
 
error_t lldpSetLocalPortDesc(LldpAgentContext *context, uint_t portIndex,
   const char_t *portDesc);
 
error_t lldpSetLocalSysName(LldpAgentContext *context, const char_t *sysName);
error_t lldpSetLocalSysDesc(LldpAgentContext *context, const char_t *sysDesc);
 
error_t lldpSetLocalSysCap(LldpAgentContext *context, uint16_t supportedCap,
   uint16_t enabledCap);
 
error_t lldpSetLocalMgmtAddr(LldpAgentContext *context, uint_t index,
   LldpMgmtAddrSubtype mgmtAddrSubtype, const void *mgmtAddr,
   size_t mgmtAddrLen, LldpIfNumSubtype ifNumSubtype, uint32_t ifNum,
   const uint8_t *oid, size_t oidLen);
 
error_t lldpDeleteLocalTlv(LldpAgentContext *context, LldpTlvType type);
 
void lldpTask(LldpAgentContext *context);
 
void lldpDeinit(LldpAgentContext *context);
 
//C++ guard
#ifdef __cplusplus
}
#endif
 
#endif