nic.c

Go to the documentation of this file.

/**
 * @file nic.c
 * @brief Network interface controller abstraction layer
 *
 * @section License
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 *
 * Copyright (C) 2010-2026 Oryx Embedded SARL. All rights reserved.
 *
 * This file is part of CycloneTCP Open.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 * @author Oryx Embedded SARL (www.oryx-embedded.com)
 * @version 2.6.0
 **/
 
//Switch to the appropriate trace level
#define TRACE_LEVEL NIC_TRACE_LEVEL
 
//Dependencies
#include "core/net.h"
#include "core/nic.h"
#include "core/ethernet.h"
#include "ipv4/ipv4_multicast.h"
#include "ipv4/ipv4_misc.h"
#include "ipv6/ipv6_multicast.h"
#include "ipv6/ipv6_misc.h"
#include "debug.h"
 
 
/**
 * @brief Retrieve logical interface
 * @param[in] interface Pointer to the network interface
 * @return Pointer to the physical interface
 **/
 
NetInterface *nicGetLogicalInterface(NetInterface *interface)
{
#if (ETH_VLAN_SUPPORT == ENABLED)
   uint_t i;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //A virtual interface can inherit from multiple parent interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Check whether a valid MAC address has been assigned to the interface
      if(!macCompAddr(&interface->macAddr, &MAC_UNSPECIFIED_ADDR))
         break;
 
      //Last interface in the list?
      if(interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
#endif
 
   //Return a pointer to the logical interface
   return interface;
}
 
 
/**
 * @brief Retrieve physical interface
 * @param[in] interface Pointer to the network interface
 * @return Pointer to the physical interface
 **/
 
NetInterface *nicGetPhysicalInterface(NetInterface *interface)
{
#if (ETH_VIRTUAL_IF_SUPPORT == ENABLED || ETH_VLAN_SUPPORT == ENABLED || \
   ETH_PORT_TAGGING_SUPPORT == ENABLED)
   uint_t i;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //A virtual interface can inherit from multiple parent interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Physical interface?
      if(interface->nicDriver != NULL || interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
#endif
 
   //Return a pointer to the physical interface
   return interface;
}
 
 
/**
 * @brief Retrieve switch port identifier
 * @param[in] interface Pointer to the network interface
 * @return Switch port identifier
 **/
 
uint8_t nicGetSwitchPort(NetInterface *interface)
{
#if (ETH_PORT_TAGGING_SUPPORT == ENABLED)
   uint_t i;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //A virtual interface can inherit from multiple parent interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Valid switch port identifier?
      if(interface->port != 0 || interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
 
   //Return switch port identifier
   return interface->port;
#else
   //Ethernet port multiplication (VLAN or tail tagging) is not supported
   return 0;
#endif
}
 
 
/**
 * @brief Retrieve VLAN identifier
 * @param[in] interface Pointer to the network interface
 * @return VLAN identifier
 **/
 
uint16_t nicGetVlanId(NetInterface *interface)
{
#if (ETH_VLAN_SUPPORT == ENABLED)
   uint_t i;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //A virtual interface can inherit from multiple parent interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Valid VLAN identifier?
      if(interface->vlanId != 0 || interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
 
   //Return VLAN identifier
   return interface->vlanId;
#else
   //VLAN is not supported
   return 0;
#endif
}
 
 
/**
 * @brief Retrieve VMAN identifier
 * @param[in] interface Pointer to the network interface
 * @return VMAN identifier
 **/
 
uint16_t nicGetVmanId(NetInterface *interface)
{
#if (ETH_VMAN_SUPPORT == ENABLED)
   uint_t i;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //A virtual interface can inherit from multiple parent interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Valid VMAN identifier?
      if(interface->vmanId != 0 || interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
 
   //Return VMAN identifier
   return interface->vmanId;
#else
   //VMAN is not supported
   return 0;
#endif
}
 
 
/**
 * @brief Test parent/child relationship between 2 interfaces
 * @param[in] interface Pointer to the child interface
 * @param[in] parent Pointer to the parent interface
 * @return TRUE is an existing parent/child relationship is found, else FALSE
 **/
 
bool_t nicIsParentInterface(NetInterface *interface, NetInterface *parent)
{
#if (ETH_VIRTUAL_IF_SUPPORT == ENABLED || ETH_VLAN_SUPPORT == ENABLED || \
   ETH_PORT_TAGGING_SUPPORT == ENABLED)
   uint_t i;
   bool_t flag;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //Iterate through the parent interfaces
   for(flag = FALSE, i = 0; i < context->numInterfaces; i++)
   {
      //Any parent/child relationship?
      if(interface == parent)
      {
         flag = TRUE;
         break;
      }
 
      //Last interface in the list?
      if(interface->parent == NULL)
         break;
 
      //Point to the interface on top of which the virtual interface runs
      interface = interface->parent;
   }
 
   //Return TRUE is an existing parent/child relationship is found
   return flag;
#else
   //Virtual interfaces are not supported
   return (interface == parent) ? TRUE : FALSE;
#endif
}
 
 
/**
 * @brief Network controller timer handler
 *
 * This routine is periodically called by the TCP/IP stack to
 * handle periodic operations such as polling the link state
 *
 * @param[in] interface Underlying network interface
 **/
 
void nicTick(NetInterface *interface)
{
   //Valid NIC driver?
   if(interface->nicDriver != NULL)
   {
      //Disable interrupts
      interface->nicDriver->disableIrq(interface);
 
      //Handle periodic operations
      interface->nicDriver->tick(interface);
 
      //Re-enable interrupts if necessary
      if(interface->configured)
      {
         interface->nicDriver->enableIrq(interface);
      }
   }
}
 
 
/**
 * @brief Send a packet to the network controller
 * @param[in] interface Underlying network interface
 * @param[in] buffer Multi-part buffer containing the data to send
 * @param[in] offset Offset to the first data byte
 * @param[in] ancillary Additional options passed to the stack along with
 *   the packet
 * @return Error code
 **/
 
error_t nicSendPacket(NetInterface *interface, const NetBuffer *buffer,
   size_t offset, NetTxAncillary *ancillary)
{
   error_t error;
   bool_t status;
   NetContext *context;
 
#if (TRACE_LEVEL >= TRACE_LEVEL_DEBUG)
   //Retrieve the length of the packet
   size_t length = netBufferGetLength(buffer) - offset;
 
   //Debug message
   TRACE_DEBUG("Sending packet (%" PRIuSIZE " bytes)...\r\n", length);
   TRACE_DEBUG_NET_BUFFER("  ", buffer, offset, length);
#endif
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //Gather entropy
   context->entropy += netGetSystemTickCount();
 
   //Check whether the interface is enabled for operation
   if(interface->configured && interface->nicDriver != NULL)
   {
      //Loopback interface?
      if(interface->nicDriver->type == NIC_TYPE_LOOPBACK)
      {
         //The loopback interface is always available
         status = TRUE;
      }
      else
      {
         //Wait for the transmitter to be ready to send
         status = osWaitForEvent(&interface->nicTxEvent, NIC_MAX_BLOCKING_TIME);
      }
 
      //Check whether the specified event is in signaled state
      if(status)
      {
         //Disable interrupts
         interface->nicDriver->disableIrq(interface);
 
         //Send the packet
         error = interface->nicDriver->sendPacket(interface, buffer, offset,
            ancillary);
 
         //Re-enable interrupts if necessary
         if(interface->configured)
         {
            interface->nicDriver->enableIrq(interface);
         }
      }
      else
      {
         //If the transmitter is busy, then drop the packet
         error = NO_ERROR;
      }
   }
   else
   {
      //Report an error
      error = ERROR_INVALID_INTERFACE;
   }
 
   //Return status code
   return error;
}
 
 
/**
 * @brief Configure MAC address filtering
 * @param[in] interface Underlying network interface
 * @return Error code
 **/
 
error_t nicUpdateMacAddrFilter(NetInterface *interface)
{
   error_t error;
 
   //Valid NIC driver?
   if(interface->nicDriver != NULL)
   {
      //Disable interrupts
      interface->nicDriver->disableIrq(interface);
 
      //Update MAC filter table
      error = interface->nicDriver->updateMacAddrFilter(interface);
 
      //Re-enable interrupts if necessary
      if(interface->configured)
      {
         interface->nicDriver->enableIrq(interface);
      }
   }
   else
   {
      //Report an error
      error = ERROR_INVALID_INTERFACE;
   }
 
   //Return status code
   return error;
}
 
 
/**
 * @brief Handle a packet received by the network controller
 * @param[in] interface Underlying network interface
 * @param[in] packet Incoming packet to process
 * @param[in] length Total packet length
 * @param[in] ancillary Additional options passed to the stack along with
 *   the packet
 **/
 
void nicProcessPacket(NetInterface *interface, uint8_t *packet, size_t length,
   NetRxAncillary *ancillary)
{
   NicType type;
   NetContext *context;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //Gather entropy
   context->entropy += netGetSystemTickCount();
 
   //Check whether the interface is enabled for operation
   if(interface->configured)
   {
      //Re-enable interrupts
      interface->nicDriver->enableIrq(interface);
 
      //Debug message
      TRACE_DEBUG("Packet received (%" PRIuSIZE " bytes)...\r\n", length);
      TRACE_DEBUG_ARRAY("  ", packet, length);
 
      //Retrieve network interface type
      type = interface->nicDriver->type;
 
#if (ETH_SUPPORT == ENABLED)
      //Ethernet interface?
      if(type == NIC_TYPE_ETHERNET)
      {
         //Process incoming Ethernet frame
         ethProcessFrame(interface, packet, length, ancillary);
      }
      else
#endif
#if (PPP_SUPPORT == ENABLED)
      //PPP interface?
      if(type == NIC_TYPE_PPP)
      {
         //Process incoming PPP frame
         pppProcessFrame(interface, packet, length, ancillary);
      }
      else
#endif
#if (IPV4_SUPPORT == ENABLED)
      //IPv4 interface?
      if(type == NIC_TYPE_IPV4)
      {
         //Process incoming IPv4 packet
         ipv4ProcessPacket(interface, (Ipv4Header *) packet, length,
            ancillary);
      }
      else
#endif
#if (IPV6_SUPPORT == ENABLED)
      //6LoWPAN interface?
      if(type == NIC_TYPE_6LOWPAN)
      {
         NetBuffer1 buffer;
 
         //The incoming packet fits in a single chunk
         buffer.chunkCount = 1;
         buffer.maxChunkCount = 1;
         buffer.chunk[0].address = packet;
         buffer.chunk[0].length = (uint16_t) length;
         buffer.chunk[0].size = 0;
 
         //Process incoming IPv6 packet
         ipv6ProcessPacket(interface, (NetBuffer *) &buffer, 0, ancillary);
      }
      else
#endif
#if (NET_LOOPBACK_IF_SUPPORT == ENABLED)
      //Loopback interface?
      if(type == NIC_TYPE_LOOPBACK)
      {
#if (IPV4_SUPPORT == ENABLED)
         //IPv4 packet received?
         if(length >= sizeof(Ipv4Header) && (packet[0] >> 4) == 4)
         {
            error_t error;
            uint_t i;
            Ipv4Header *header;
 
            //Point to the IPv4 header
            header = (Ipv4Header *) packet;
 
            //Loop through network interfaces
            for(i = 0; i < context->numInterfaces; i++)
            {
               //Multicast packet?
               if(ipv4IsMulticastAddr(header->destAddr))
               {
                  //Multicast address filtering
                  error = ipv4MulticastFilter(&context->interfaces[i],
                     header->destAddr, header->srcAddr);
               }
               else
               {
                  //Unicast address filtering
                  error = ipv4CheckDestAddr(&context->interfaces[i],
                     header->destAddr);
               }
 
               //Valid destination address?
               if(!error)
               {
                  //Process incoming IPv4 packet
                  ipv4ProcessPacket(&context->interfaces[i],
                     (Ipv4Header *) packet, length, ancillary);
               }
            }
         }
         else
#endif
#if (IPV6_SUPPORT == ENABLED)
         //IPv6 packet received?
         if(length >= sizeof(Ipv6Header) && (packet[0] >> 4) == 6)
         {
            error_t error;
            uint_t i;
            NetBuffer1 buffer;
            Ipv6Header *header;
 
            //Point to the IPv6 header
            header = (Ipv6Header *) packet;
 
            //Loop through network interfaces
            for(i = 0; i < context->numInterfaces; i++)
            {
               //Multicast packet?
               if(ipv6IsMulticastAddr(&header->destAddr))
               {
                  //Multicast address filtering
                  error = ipv6MulticastFilter(&context->interfaces[i],
                     &header->destAddr, &header->srcAddr);
               }
               else
               {
                  //Unicast address filtering
                  error = ipv6CheckDestAddr(&context->interfaces[i],
                     &header->destAddr);
               }
 
               //Valid destination address?
               if(!error)
               {
                  //The incoming packet fits in a single chunk
                  buffer.chunkCount = 1;
                  buffer.maxChunkCount = 1;
                  buffer.chunk[0].address = packet;
                  buffer.chunk[0].length = (uint16_t) length;
                  buffer.chunk[0].size = 0;
 
                  //Process incoming IPv6 packet
                  ipv6ProcessPacket(&context->interfaces[i],
                     (NetBuffer *) &buffer, 0, ancillary);
               }
            }
         }
         else
#endif
         {
            //Invalid version number
         }
      }
      else
#endif
      //Unknown interface type?
      {
         //Silently discard the received packet
      }
 
      //Disable interrupts
      interface->nicDriver->disableIrq(interface);
   }
}
 
 
/**
 * @brief Process link state change notification
 * @param[in] interface Underlying network interface
 **/
 
void nicNotifyLinkChange(NetInterface *interface)
{
   uint_t i;
   NetContext *context;
   NetInterface *physicalInterface;
   NetInterface *virtualInterface;
 
   //Point to the TCP/IP stack context
   context = interface->netContext;
 
   //Gather entropy
   context->entropy += netGetSystemTickCount();
 
   //Point to the physical interface
   physicalInterface = nicGetPhysicalInterface(interface);
 
   //Re-enable interrupts if necessary
   if(physicalInterface->configured)
   {
      physicalInterface->nicDriver->enableIrq(physicalInterface);
   }
 
   //Loop through network interfaces
   for(i = 0; i < context->numInterfaces; i++)
   {
      //Point to the current interface
      virtualInterface = &context->interfaces[i];
 
      //Check whether the current virtual interface is attached to the physical
      //interface
      if(nicIsParentInterface(virtualInterface, interface) &&
         nicGetSwitchPort(virtualInterface) == nicGetSwitchPort(interface))
      {
         //Set operation mode
         virtualInterface->linkSpeed = interface->linkSpeed;
         virtualInterface->duplexMode = interface->duplexMode;
 
         //Update link state
         virtualInterface->linkState = interface->linkState;
 
         //Process link state change event
         netProcessLinkChange(virtualInterface);
      }
   }
 
   //Disable interrupts
   physicalInterface->nicDriver->disableIrq(physicalInterface);
}