mikroSDK Reference Manual
gd32f2xx_eth_driver.h
Go to the documentation of this file.
1
31#ifndef _GD32F2XX_ETH_DRIVER_H
32#define _GD32F2XX_ETH_DRIVER_H
33
34//Dependencies
35#include "core/nic.h"
36
37//Number of TX buffers
38#ifndef GD32F2XX_ETH_TX_BUFFER_COUNT
39 #define GD32F2XX_ETH_TX_BUFFER_COUNT 3
40#elif (GD32F2XX_ETH_TX_BUFFER_COUNT < 1)
41 #error GD32F2XX_ETH_TX_BUFFER_COUNT parameter is not valid
42#endif
43
44//TX buffer size
45#ifndef GD32F2XX_ETH_TX_BUFFER_SIZE
46 #define GD32F2XX_ETH_TX_BUFFER_SIZE 1536
47#elif (GD32F2XX_ETH_TX_BUFFER_SIZE != 1536)
48 #error GD32F2XX_ETH_TX_BUFFER_SIZE parameter is not valid
49#endif
50
51//Number of RX buffers
52#ifndef GD32F2XX_ETH_RX_BUFFER_COUNT
53 #define GD32F2XX_ETH_RX_BUFFER_COUNT 6
54#elif (GD32F2XX_ETH_RX_BUFFER_COUNT < 1)
55 #error GD32F2XX_ETH_RX_BUFFER_COUNT parameter is not valid
56#endif
57
58//RX buffer size
59#ifndef GD32F2XX_ETH_RX_BUFFER_SIZE
60 #define GD32F2XX_ETH_RX_BUFFER_SIZE 1536
61#elif (GD32F2XX_ETH_RX_BUFFER_SIZE != 1536)
62 #error GD32F2XX_ETH_RX_BUFFER_SIZE parameter is not valid
63#endif
64
65//Interrupt priority grouping
66#ifndef GD32F2XX_ETH_IRQ_PRIORITY_GROUPING
67 #define GD32F2XX_ETH_IRQ_PRIORITY_GROUPING 3
68#elif (GD32F2XX_ETH_IRQ_PRIORITY_GROUPING < 0)
69 #error GD32F2XX_ETH_IRQ_PRIORITY_GROUPING parameter is not valid
70#endif
71
72//Ethernet interrupt group priority
73#ifndef GD32F2XX_ETH_IRQ_GROUP_PRIORITY
74 #define GD32F2XX_ETH_IRQ_GROUP_PRIORITY 12
75#elif (GD32F2XX_ETH_IRQ_GROUP_PRIORITY < 0)
76 #error GD32F2XX_ETH_IRQ_GROUP_PRIORITY parameter is not valid
77#endif
78
79//Ethernet interrupt subpriority
80#ifndef GD32F2XX_ETH_IRQ_SUB_PRIORITY
81 #define GD32F2XX_ETH_IRQ_SUB_PRIORITY 0
82#elif (GD32F2XX_ETH_IRQ_SUB_PRIORITY < 0)
83 #error GD32F2XX_ETH_IRQ_SUB_PRIORITY parameter is not valid
84#endif
85
86//C++ guard
87#ifdef __cplusplus
88extern "C" {
89#endif
90
91
96typedef struct
97{
98 uint32_t tdes0;
99 uint32_t tdes1;
100 uint32_t tdes2;
101 uint32_t tdes3;
103
104
109typedef struct
110{
111 uint32_t rdes0;
112 uint32_t rdes1;
113 uint32_t rdes2;
114 uint32_t rdes3;
116
117
118//GD32F2XX Ethernet MAC driver
119extern const NicDriver gd32f2xxEthDriver;
120
121//GD32F2XX Ethernet MAC related functions
122error_t gd32f2xxEthInit(NetInterface *interface);
123void gd32f2xxEthInitGpio(NetInterface *interface);
124void gd32f2xxEthInitDmaDesc(NetInterface *interface);
125
126void gd32f2xxEthTick(NetInterface *interface);
127
128void gd32f2xxEthEnableIrq(NetInterface *interface);
129void gd32f2xxEthDisableIrq(NetInterface *interface);
130void gd32f2xxEthEventHandler(NetInterface *interface);
131
132error_t gd32f2xxEthSendPacket(NetInterface *interface,
133 const NetBuffer *buffer, size_t offset, NetTxAncillary *ancillary);
134
135error_t gd32f2xxEthReceivePacket(NetInterface *interface);
136
137error_t gd32f2xxEthUpdateMacAddrFilter(NetInterface *interface);
138error_t gd32f2xxEthUpdateMacConfig(NetInterface *interface);
139
140void gd32f2xxEthWritePhyReg(uint8_t opcode, uint8_t phyAddr,
141 uint8_t regAddr, uint16_t data);
142
143uint16_t gd32f2xxEthReadPhyReg(uint8_t opcode, uint8_t phyAddr,
144 uint8_t regAddr);
145
146uint32_t gd32f2xxEthCalcCrc(const void *data, size_t length);
147
148//C++ guard
149#ifdef __cplusplus
150}
151#endif
152
153#endif
error_t
Error codes.
Definition error.h:43
Network interface controller abstraction layer.
Enhanced RX DMA descriptor.
Definition gd32f2xx_eth_driver.h:110
Enhanced TX DMA descriptor.
Definition gd32f2xx_eth_driver.h:97
Structure describing a buffer that spans multiple chunks.
Definition net_mem.h:89
NIC driver.
Definition nic.h:283