IEEE802_11.c

Go to the documentation of this file.

/************************************************************************************
* Copyright (C) 2021                                                                *
* TETCOS, Bangalore. India                                                          *
*                                                                                   *
* Tetcos owns the intellectual property rights in the Product and its content.      *
* The copying, redistribution, reselling or publication of any or all of the        *
* Product or its content without express prior written consent of Tetcos is         *
* prohibited. Ownership and / or any other right relating to the software and all   *
* intellectual property rights therein shall remain at all times with Tetcos.       *
*                                                                                   *
* This source code is licensed per the NetSim license agreement.                    *
*                                                                                   *
* No portion of this source code may be used as the basis for a derivative work,    *
* or used, for any purpose other than its intended use per the NetSim license       *
* agreement.                                                                        *
*                                                                                   *
* This source code and the algorithms contained within it are confidential trade    *
* secrets of TETCOS and may not be used as the basis for any other software,        *
* hardware, product or service.                                                     *
*                                                                                   *
* Author:    Shashi Kant Suman                                                      *
*                                                                                   *
* ----------------------------------------------------------------------------------*/
#include "main.h"
#include "IEEE802_11.h"
#include "IEEE802_11_Phy.h"
 
//Function prototype
int fn_NetSim_IEEE802_11_Configure_F(void** var);
int fn_NetSim_IEEE802_11_Init_F(struct stru_NetSim_Network *NETWORK_Formal,
    NetSim_EVENTDETAILS *pstruEventDetails_Formal,
    char *pszAppPath_Formal,
    char *pszWritePath_Formal,
    int nVersion_Type);
int fn_NetSim_IEEE802_11_Metrics_F(PMETRICSWRITER metricsWriter);
void print_minstrel_table(PMETRICSWRITER metricsWriter);
 
_declspec(dllexport) int fn_NetSim_IEEE802_11_Configure(void** var)
{
    return fn_NetSim_IEEE802_11_Configure_F(var);
}
 
_declspec(dllexport) int fn_NetSim_IEEE802_11_Init(struct stru_NetSim_Network *NETWORK_Formal,
    NetSim_EVENTDETAILS *pstruEventDetails_Formal,
    char *pszAppPath_Formal,
    char *pszWritePath_Formal,
    int nVersion_Type)
{
    return fn_NetSim_IEEE802_11_Init_F(NETWORK_Formal,
        pstruEventDetails_Formal,pszAppPath_Formal,
        pszWritePath_Formal,
        nVersion_Type);
}
 
_declspec(dllexport) int fn_NetSim_IEEE802_11_Run()
{
    switch(pstruEventDetails->nEventType)
    {
    case MAC_OUT_EVENT:
        fn_NetSim_IEEE802_11_MacOut();
        break;
    case MAC_IN_EVENT:
        fn_NetSim_IEEE802_11_MacIn();
        break;
    case PHYSICAL_OUT_EVENT:
        fn_NetSim_IEEE802_11_PhyOut();
        break;
    case PHYSICAL_IN_EVENT:
        fn_NetSim_IEEE802_11_PhyIn();
        break;
    case TIMER_EVENT:
        fn_NetSim_IEEE802_11_Timer();
        break;
    default:
        fnNetSimError("Unknown event type %d for IEEE802.11 protocol",pstruEventDetails->nEventType);
        break;
    }
    return 0;
}
 
/**
This function is called by NetworkStack.dll, while writing the event trace 
to get the sub event as a string.
*/
_declspec(dllexport) char* fn_NetSim_IEEE802_11_Trace(int nSubEvent)
{
    return GetStringIEEE802_11_Subevent(nSubEvent);
}
 
/**
This function is called by NetworkStack.dll, to free the WLAN protocol
pstruMacData->Packet_MACProtocol.
*/
_declspec(dllexport) int fn_NetSim_IEEE802_11_FreePacket(NetSim_PACKET* pstruPacket)
{
    ieee802_11_free_hdr(pstruPacket);
    free_ieee802_11_phy_header(pstruPacket);
    return 0;
}
 
/**
This function is called by NetworkStack.dll, to copy the WLAN protocol
pstruMacData->Packet_MACProtocol from source packet to destination.
*/
_declspec(dllexport) int fn_NetSim_IEEE802_11_CopyPacket(NetSim_PACKET* pstruDestPacket,NetSim_PACKET* pstruSrcPacket)
{
    ieee802_11_hdr_copy(pstruDestPacket,pstruSrcPacket);
    copy_ieee802_11_phy_header(pstruDestPacket, pstruSrcPacket);
    return 0;
}
 
/**
This function call WLAN Metrics function in lib file to write the Metrics in Metrics.txt    
*/
_declspec(dllexport) int fn_NetSim_IEEE802_11_Metrics(PMETRICSWRITER metricsWriter)
{
    fn_NetSim_IEEE802_11_Metrics_F(metricsWriter);                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    
    print_minstrel_table(metricsWriter);
    return 0;
}
 
/**
This function is to configure the WLAN protocol packet trace parameter. 
This function return a string which has the parameters separated by comma.
*/
_declspec(dllexport) char* fn_NetSim_IEEE802_11_ConfigPacketTrace(const void* xmlNetSimNode)
{
    xmlNetSimNode;
    return "";
}
 
/**
This function is called while writing the Packet trace for WLAN protocol. 
This function is called for every packet while writing the packet trace.
*/
_declspec(dllexport) int fn_NetSim_IEEE802_11_WritePacketTrace(NetSim_PACKET* pstruPacket, char** ppszTrace)
{
    pstruPacket;
    ppszTrace;
    return 1;
}
 
/**
This function is called by NetworkStack.dll, once simulation end to free the 
allocated memory for the network.   
*/
_declspec(dllexport) int fn_NetSim_IEEE802_11_Finish()
{
    return fn_NetSim_IEEE802_11_Finish_F();
}
 
void fn_NetSim_IEEE802_11_Timer()
{
    switch(pstruEventDetails->nSubEventType)
    {
    case ACK_TIMEOUT:
        fn_NetSim_IEEE802_11_CSMA_AckTimeOut();
        break;
    case CTS_TIMEOUT:
        fn_NetSim_IEEE802_11_RTS_CTS_CTSTimeOut();
        break;
    default:
        fnNetSimError("Unknown Timer event-%d subevent for IEEE802.11 protocol in %s\n",
            pstruEventDetails->nSubEventType,
            __FUNCTION__);
    }
}
 
bool isIEEE802_11_log()
{
#ifdef IEEE802_11_LOG
    return true;
#else
    return false;
#endif
}
 
bool isieee802_11_Backoff_log()
{
#ifdef IEEE802_11_BACKOFF_LOG
    return true;
#else
    return false;
#endif
}