hal_ethernet.h

Go to the documentation of this file.

/*
 *  ethernet_hal.h
 *
 *  Copyright 2013, 2014 Michael Zillgith
 *
 *  This file is part of libIEC61850.
 *
 *  libIEC61850 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 3 of the License, or
 *  (at your option) any later version.
 *
 *  libIEC61850 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 libIEC61850.  If not, see <http://www.gnu.org/licenses/>.
 *
 *  See COPYING file for the complete license text.
 */

#ifndef ETHERNET_HAL_H_
#define ETHERNET_HAL_H_

#include <stdint.h>
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct sEthernetSocket* EthernetSocket;

typedef struct sEthernetHandleSet* EthernetHandleSet;

EthernetHandleSet
EthernetHandleSet_new(void);

void
EthernetHandleSet_addSocket(EthernetHandleSet self, const EthernetSocket sock);

void
EthernetHandleSet_removeSocket(EthernetHandleSet self, const EthernetSocket sock);

int
EthernetHandleSet_waitReady(EthernetHandleSet self, unsigned int timeoutMs);

void
EthernetHandleSet_destroy(EthernetHandleSet self);

void
Ethernet_getInterfaceMACAddress(const char* interfaceId, uint8_t* addr);

EthernetSocket
Ethernet_createSocket(const char* interfaceId, uint8_t* destAddress);

void
Ethernet_destroySocket(EthernetSocket ethSocket);

void
Ethernet_sendPacket(EthernetSocket ethSocket, uint8_t* buffer, int packetSize);

/*
 * \brief set a protocol filter for the specified etherType
 *
 * \param ethSocket the ethernet socket handle
 * \param etherType the ether type of messages to accept
 */
void
Ethernet_setProtocolFilter(EthernetSocket ethSocket, uint16_t etherType);

int
Ethernet_receivePacket(EthernetSocket ethSocket, uint8_t* buffer, int bufferSize);

bool
Ethernet_isSupported(void);

#ifdef __cplusplus
}
#endif

#endif /* ETHERNET_HAL_H_ */