mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-10-30 20:51:41 +00:00 
			
		
		
		
	 84dc42c4b0
			
		
	
	84dc42c4b0
	
	
	
		
			
			When `DIS_USB_JTAG` eFuse is NOT burned (`False`), it is not possible to set pins 18 and 19 as GPIOs. This commit solves this by manually disabling USB JTAG when using pins 18 or 19. The functions shall use `gpio_hal_iomux_func_sel` instead of `PIN_FUNC_SELELECT`.
		
			
				
	
	
		
			688 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			688 lines
		
	
	
		
			26 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| // Copyright 2019 Espressif Systems (Shanghai) PTE LTD
 | |
| //
 | |
| // Licensed under the Apache License, Version 2.0 (the "License");
 | |
| // you may not use this file except in compliance with the License.
 | |
| // You may obtain a copy of the License at
 | |
| //
 | |
| //     http://www.apache.org/licenses/LICENSE-2.0
 | |
| //
 | |
| // Unless required by applicable law or agreed to in writing, software
 | |
| // distributed under the License is distributed on an "AS IS" BASIS,
 | |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | |
| // See the License for the specific language governing permissions and
 | |
| // limitations under the License.
 | |
| #include <string.h>
 | |
| #include "sdkconfig.h"
 | |
| #include "esp_attr.h"
 | |
| #include "soc/gpio_periph.h"
 | |
| #include "soc/rtc.h"
 | |
| #include "hal/emac.h"
 | |
| #include "hal/gpio_hal.h"
 | |
| 
 | |
| #define ETH_CRC_LENGTH (4)
 | |
| 
 | |
| #if CONFIG_ETH_RMII_CLK_OUTPUT
 | |
| static void emac_config_apll_clock(void)
 | |
| {
 | |
|     /* apll_freq = xtal_freq * (4 + sdm2 + sdm1/256 + sdm0/65536)/((o_div + 2) * 2) */
 | |
|     rtc_xtal_freq_t rtc_xtal_freq = rtc_clk_xtal_freq_get();
 | |
|     switch (rtc_xtal_freq) {
 | |
|     case RTC_XTAL_FREQ_40M: // Recommended
 | |
|         /* 50 MHz = 40MHz * (4 + 6) / (2 * (2 + 2) = 50.000 */
 | |
|         /* sdm0 = 0, sdm1 = 0, sdm2 = 6, o_div = 2 */
 | |
|         rtc_clk_apll_enable(true, 0, 0, 6, 2);
 | |
|         break;
 | |
|     case RTC_XTAL_FREQ_26M:
 | |
|         /* 50 MHz = 26MHz * (4 + 15 + 118 / 256 + 39/65536) / ((3 + 2) * 2) = 49.999992 */
 | |
|         /* sdm0 = 39, sdm1 = 118, sdm2 = 15, o_div = 3 */
 | |
|         rtc_clk_apll_enable(true, 39, 118, 15, 3);
 | |
|         break;
 | |
|     case RTC_XTAL_FREQ_24M:
 | |
|         /* 50 MHz = 24MHz * (4 + 12 + 255 / 256 + 255/65536) / ((2 + 2) * 2) = 49.499977 */
 | |
|         /* sdm0 = 255, sdm1 = 255, sdm2 = 12, o_div = 2 */
 | |
|         rtc_clk_apll_enable(true, 255, 255, 12, 2);
 | |
|         break;
 | |
|     default: // Assume we have a 40M xtal
 | |
|         rtc_clk_apll_enable(true, 0, 0, 6, 2);
 | |
|         break;
 | |
|     }
 | |
| }
 | |
| #endif
 | |
| 
 | |
| void emac_hal_init(emac_hal_context_t *hal, void *descriptors,
 | |
|                    uint8_t **rx_buf, uint8_t **tx_buf)
 | |
| {
 | |
|     hal->dma_regs = &EMAC_DMA;
 | |
|     hal->mac_regs = &EMAC_MAC;
 | |
|     hal->ext_regs = &EMAC_EXT;
 | |
|     hal->descriptors = descriptors;
 | |
|     hal->rx_buf = rx_buf;
 | |
|     hal->tx_buf = tx_buf;
 | |
| }
 | |
| 
 | |
| void emac_hal_lowlevel_init(emac_hal_context_t *hal)
 | |
| {
 | |
|     /* GPIO configuration */
 | |
|     /* TX_EN to GPIO21 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO21_U, FUNC_GPIO21_EMAC_TX_EN);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[21]);
 | |
|     /* TXD0 to GPIO19 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO19_U, FUNC_GPIO19_EMAC_TXD0);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[19]);
 | |
|     /* TXD1 to GPIO22 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO22_U, FUNC_GPIO22_EMAC_TXD1);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[22]);
 | |
|     /* RXD0 to GPIO25 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO25_U, FUNC_GPIO25_EMAC_RXD0);
 | |
|     PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[25]);
 | |
|     /* RXD1 to GPIO26 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO26_U, FUNC_GPIO26_EMAC_RXD1);
 | |
|     PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[26]);
 | |
|     /* CRS_DV to GPIO27 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO27_U, FUNC_GPIO27_EMAC_RX_DV);
 | |
|     PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[27]);
 | |
| #if CONFIG_ETH_RMII_CLK_INPUT
 | |
| #if CONFIG_ETH_RMII_CLK_IN_GPIO == 0
 | |
|     /* RMII clock (50MHz) input to GPIO0 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO0_U, FUNC_GPIO0_EMAC_TX_CLK);
 | |
|     PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[0]);
 | |
| #else
 | |
| #error "ESP32 EMAC only support input RMII clock to GPIO0"
 | |
| #endif
 | |
| #endif
 | |
| #if CONFIG_ETH_RMII_CLK_OUTPUT
 | |
| #if CONFIG_ETH_RMII_CLK_OUTPUT_GPIO0
 | |
|     /* APLL clock output to GPIO0 (must be configured to 50MHz!) */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO0_U, FUNC_GPIO0_CLK_OUT1);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[0]);
 | |
| #elif CONFIG_ETH_RMII_CLK_OUT_GPIO == 16
 | |
|     /* RMII CLK (50MHz) output to GPIO16 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO16_U, FUNC_GPIO16_EMAC_CLK_OUT);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[16]);
 | |
| #elif CONFIG_ETH_RMII_CLK_OUT_GPIO == 17
 | |
|     /* RMII CLK (50MHz) output to GPIO17 */
 | |
|     gpio_hal_iomux_func_sel(PERIPHS_IO_MUX_GPIO17_U, FUNC_GPIO17_EMAC_CLK_OUT_180);
 | |
|     PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[17]);
 | |
| #endif
 | |
| #endif // CONFIG_ETH_RMII_CLK_OUTPUT
 | |
|     /* Clock configuration */
 | |
| #if CONFIG_ETH_PHY_INTERFACE_MII
 | |
|     hal->ext_regs->ex_phyinf_conf.phy_intf_sel = 0;
 | |
|     hal->ext_regs->ex_clk_ctrl.mii_clk_rx_en = 1;
 | |
|     hal->ext_regs->ex_clk_ctrl.mii_clk_tx_en = 1;
 | |
| #elif CONFIG_ETH_PHY_INTERFACE_RMII
 | |
|     hal->ext_regs->ex_phyinf_conf.phy_intf_sel = 4;
 | |
| #if CONFIG_ETH_RMII_CLK_INPUT
 | |
|     hal->ext_regs->ex_clk_ctrl.ext_en = 1;
 | |
|     hal->ext_regs->ex_clk_ctrl.int_en = 0;
 | |
|     hal->ext_regs->ex_oscclk_conf.clk_sel = 1;
 | |
| #elif CONFIG_ETH_RMII_CLK_OUTPUT
 | |
|     hal->ext_regs->ex_clk_ctrl.ext_en = 0;
 | |
|     hal->ext_regs->ex_clk_ctrl.int_en = 1;
 | |
|     hal->ext_regs->ex_oscclk_conf.clk_sel = 0;
 | |
|     emac_config_apll_clock();
 | |
|     hal->ext_regs->ex_clkout_conf.div_num = 0;
 | |
|     hal->ext_regs->ex_clkout_conf.h_div_num = 0;
 | |
| #if CONFIG_ETH_RMII_CLK_OUTPUT_GPIO0
 | |
|     /* Choose the APLL clock to output on GPIO */
 | |
|     REG_WRITE(PIN_CTRL, 6);
 | |
| #endif // CONFIG_RMII_CLK_OUTPUT_GPIO0
 | |
| #endif // CONFIG_ETH_RMII_CLK_INPUT
 | |
| #endif // CONFIG_ETH_PHY_INTERFACE_MII
 | |
| }
 | |
| 
 | |
| void emac_hal_reset(emac_hal_context_t *hal)
 | |
| {
 | |
|     hal->dma_regs->dmabusmode.sw_rst = 1;
 | |
| }
 | |
| 
 | |
| bool emac_hal_is_reset_done(emac_hal_context_t *hal)
 | |
| {
 | |
|     return hal->dma_regs->dmabusmode.sw_rst ? false : true;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_csr_clock_range(emac_hal_context_t *hal)
 | |
| {
 | |
|     /* Tell MAC system clock Frequency, which will determin the frequency range of MDC(1MHz~2.5MHz) */
 | |
|     if (CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ >= 20 && CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ < 35) {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 2;
 | |
|     } else if (CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ >= 35 && CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ < 60) {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 3;
 | |
|     } else if (CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ >= 60 && CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ < 100) {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 0;
 | |
|     } else if (CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ >= 100 && CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ < 150) {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 1;
 | |
|     } else if (CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ > 150 && CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ < 250) {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 4;
 | |
|     } else {
 | |
|         hal->mac_regs->emacgmiiaddr.miicsrclk = 5;
 | |
|     }
 | |
| }
 | |
| 
 | |
| void emac_hal_reset_desc_chain(emac_hal_context_t *hal)
 | |
| {
 | |
|     /* reset DMA descriptors */
 | |
|     hal->rx_desc = (eth_dma_rx_descriptor_t *)(hal->descriptors);
 | |
|     hal->tx_desc = (eth_dma_tx_descriptor_t *)(hal->descriptors +
 | |
|                    sizeof(eth_dma_rx_descriptor_t) * CONFIG_ETH_DMA_RX_BUFFER_NUM);
 | |
|     /* init rx chain */
 | |
|     for (int i = 0; i < CONFIG_ETH_DMA_RX_BUFFER_NUM; i++) {
 | |
|         /* Set Own bit of the Rx descriptor Status: DMA */
 | |
|         hal->rx_desc[i].RDES0.Own = 1;
 | |
|         /* Set Buffer1 size and Second Address Chained bit */
 | |
|         hal->rx_desc[i].RDES1.SecondAddressChained = 1;
 | |
|         hal->rx_desc[i].RDES1.ReceiveBuffer1Size = CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|         /* Enable Ethernet DMA Rx Descriptor interrupt */
 | |
|         hal->rx_desc[i].RDES1.DisableInterruptOnComplete = 0;
 | |
|         /* point to the buffer */
 | |
|         hal->rx_desc[i].Buffer1Addr = (uint32_t)(hal->rx_buf[i]);
 | |
|         /* point to next descriptor */
 | |
|         hal->rx_desc[i].Buffer2NextDescAddr = (uint32_t)(hal->rx_desc + i + 1);
 | |
|     }
 | |
|     /* For last descriptor, set next descriptor address register equal to the first descriptor base address */
 | |
|     hal->rx_desc[CONFIG_ETH_DMA_RX_BUFFER_NUM - 1].Buffer2NextDescAddr = (uint32_t)(hal->rx_desc);
 | |
| 
 | |
|     /* init tx chain */
 | |
|     for (int i = 0; i < CONFIG_ETH_DMA_TX_BUFFER_NUM; i++) {
 | |
|         /* Set Second Address Chained bit */
 | |
|         hal->tx_desc[i].TDES0.SecondAddressChained = 1;
 | |
|         hal->tx_desc[i].TDES1.TransmitBuffer1Size = CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|         /* Enable Ethernet DMA Tx Descriptor interrupt */
 | |
|         hal->tx_desc[1].TDES0.InterruptOnComplete = 1;
 | |
|         /* Enable Transmit Timestamp */
 | |
|         hal->tx_desc[i].TDES0.TransmitTimestampEnable = 1;
 | |
|         /* point to the buffer */
 | |
|         hal->tx_desc[i].Buffer1Addr = (uint32_t)(hal->tx_buf[i]);
 | |
|         /* point to next descriptor */
 | |
|         hal->tx_desc[i].Buffer2NextDescAddr = (uint32_t)(hal->tx_desc + i + 1);
 | |
|     }
 | |
|     /* For last descriptor, set next descriptor address register equal to the first descriptor base address */
 | |
|     hal->tx_desc[CONFIG_ETH_DMA_TX_BUFFER_NUM - 1].Buffer2NextDescAddr = (uint32_t)(hal->tx_desc);
 | |
| 
 | |
|     /* set base address of the first descriptor */
 | |
|     hal->dma_regs->dmarxbaseaddr = (uint32_t)hal->rx_desc;
 | |
|     hal->dma_regs->dmatxbaseaddr = (uint32_t)hal->tx_desc;
 | |
| }
 | |
| 
 | |
| void emac_hal_init_mac_default(emac_hal_context_t *hal)
 | |
| {
 | |
|     /* MACCR Configuration */
 | |
|     typeof(hal->mac_regs->gmacconfig) maccr = hal->mac_regs->gmacconfig;
 | |
|     /* Enable the watchdog on the receiver, frame longer than 2048 Bytes is not allowed */
 | |
|     maccr.watchdog = EMAC_WATCHDOG_ENABLE;
 | |
|     /* Enable the jabber timer on the transmitter, frame longer than 2048 Bytes is not allowed */
 | |
|     maccr.jabber = EMAC_JABBER_ENABLE;
 | |
|     /* minimum IFG between frames during transmission is 96 bit times */
 | |
|     maccr.interframegap = EMAC_INTERFRAME_GAP_96BIT;
 | |
|     /* Enable Carrier Sense During Transmission */
 | |
|     maccr.disablecrs = EMAC_CARRIERSENSE_ENABLE;
 | |
|     /* Select port: 10/100 Mbps */
 | |
|     maccr.mii = EMAC_PORT_10_100MBPS;
 | |
|     /* Select speed: here set default 100M, afterwards, will reset by auto-negotiation */
 | |
|     maccr.fespeed = EMAC_SPEED_100M;
 | |
|     /* Allow the reception of frames when the TX_EN signal is asserted in Half-Duplex mode */
 | |
|     maccr.rxown = EMAC_RECEIVE_OWN_ENABLE;
 | |
|     /* Disable internal loopback mode */
 | |
|     maccr.loopback = EMAC_LOOPBACK_DISABLE;
 | |
|     /* Select duplex mode: here set default full duplex, afterwards, will reset by auto-negotiation */
 | |
|     maccr.duplex = EMAC_DUPLEX_FULL;
 | |
|     /* Select the checksum mode for received frame payload's TCP/UDP/ICMP headers */
 | |
|     maccr.rxipcoffload = EMAC_CHECKSUM_HW;
 | |
|     /* Enable MAC retry transmission when a colision occurs in half duplex mode */
 | |
|     maccr.retry = EMAC_RETRY_TRANSMISSION_ENABLE;
 | |
|     /* MAC passes all incoming frames to host, without modifying them */
 | |
|     maccr.padcrcstrip = EMAC_AUTO_PAD_CRC_STRIP_DISABLE;
 | |
|     /* Set Back-Off limit time before retry a transmittion after a collision */
 | |
|     maccr.backofflimit = EMAC_BACKOFF_LIMIT_10;
 | |
|     /* Disable deferral check, MAC defers until the CRS signal goes inactive */
 | |
|     maccr.deferralcheck = EMAC_DEFERRAL_CHECK_DISABLE;
 | |
|     /* Set preamble length 7 Bytes */
 | |
|     maccr.pltf = EMAC_PREAMBLE_LENGTH_7;
 | |
|     hal->mac_regs->gmacconfig = maccr;
 | |
| 
 | |
|     /* MACFFR Configuration */
 | |
|     typeof(hal->mac_regs->gmacff) macffr = hal->mac_regs->gmacff;
 | |
|     /* Receiver module passes only those frames to the Application that pass the SA or DA address filter */
 | |
|     macffr.receive_all = EMAC_RECEIVE_ALL_DISABLE;
 | |
|     /* Disable source address filter */
 | |
|     macffr.safe = EMAC_SOURCE_ADDR_FILTER_DISABLE;
 | |
|     macffr.saif = 0;
 | |
|     /* MAC blocks all control frames */
 | |
|     macffr.pcf = EMAC_CONTROL_FRAME_BLOCKALL;
 | |
|     /* AFM module passes all received broadcast frames and multicast frames */
 | |
|     macffr.dbf = EMAC_RECEPT_BROADCAST_ENABLE;
 | |
|     macffr.pam = 1;
 | |
|     /* Address Check block operates in normal filtering mode for the DA address */
 | |
|     macffr.daif = EMAC_DEST_ADDR_FILTER_NORMAL;
 | |
|     /* Disable Promiscuous Mode */
 | |
|     macffr.pmode = EMAC_PROMISCUOUS_DISABLE;
 | |
|     hal->mac_regs->gmacff = macffr;
 | |
| }
 | |
| 
 | |
| void emac_hal_enable_flow_ctrl(emac_hal_context_t *hal, bool enable)
 | |
| {
 | |
|     /* MACFCR Configuration */
 | |
|     typeof(hal->mac_regs->gmacfc) macfcr = hal->mac_regs->gmacfc;
 | |
|     if (enable) {
 | |
|         /* Pause time */
 | |
|         macfcr.pause_time = EMAC_PAUSE_TIME;
 | |
|         /* Enable generation of Zero-Quanta Pause Control frames */
 | |
|         macfcr.dzpq = EMAC_ZERO_QUANTA_PAUSE_ENABLE;
 | |
|         /* Threshold of the PAUSE to be checked for automatic retransmission of PAUSE Frame */
 | |
|         macfcr.plt = EMAC_PAUSE_LOW_THRESHOLD_MINUS_28;
 | |
|         /* Don't allow MAC detect Pause frames with MAC address0 unicast address and unique multicast address */
 | |
|         macfcr.upfd = EMAC_UNICAST_PAUSE_DETECT_DISABLE;
 | |
|         /* Enable MAC to decode the received Pause frame and disable its transmitter for a specific time */
 | |
|         macfcr.rfce = EMAC_RECEIVE_FLOW_CONTROL_ENABLE;
 | |
|         /* Enable MAC to transmit Pause frames in full duplex mode or the MAC back-pressure operation in half duplex mode */
 | |
|         macfcr.tfce = EMAC_TRANSMIT_FLOW_CONTROL_ENABLE;
 | |
|     } else {
 | |
|         macfcr.val = 0;
 | |
|     }
 | |
|     hal->mac_regs->gmacfc = macfcr;
 | |
| }
 | |
| 
 | |
| void emac_hal_init_dma_default(emac_hal_context_t *hal)
 | |
| {
 | |
|     /* DMAOMR Configuration */
 | |
|     typeof(hal->dma_regs->dmaoperation_mode) dmaomr = hal->dma_regs->dmaoperation_mode;
 | |
|     /* Enable Dropping of TCP/IP Checksum Error Frames */
 | |
|     dmaomr.dis_drop_tcpip_err_fram = EMAC_DROP_TCPIP_CHECKSUM_ERROR_ENABLE;
 | |
|     /* Enable Receive Store Forward */
 | |
|     dmaomr.rx_store_forward = EMAC_RECEIVE_STORE_FORWARD_ENABLE;
 | |
|     /* Enable Flushing of Received Frames because of the unavailability of receive descriptors or buffers */
 | |
|     dmaomr.dis_flush_recv_frames = EMAC_FLUSH_RECEIVED_FRAME_ENABLE;
 | |
|     /* Enable Transmit Store Forward */
 | |
|     dmaomr.tx_str_fwd = EMAC_TRANSMIT_STORE_FORWARD_ENABLE;
 | |
|     /* Flush Transmit FIFO */
 | |
|     dmaomr.flush_tx_fifo = 1;
 | |
|     /* Transmit Threshold Control */
 | |
|     dmaomr.tx_thresh_ctrl = EMAC_TRANSMIT_THRESHOLD_CONTROL_64;
 | |
|     /* Disable Forward Error Frame */
 | |
|     dmaomr.fwd_err_frame = EMAC_FORWARD_ERROR_FRAME_DISABLE;
 | |
|     /* Disable forward undersized good frame */
 | |
|     dmaomr.fwd_under_gf = EMAC_FORWARD_UNDERSIZED_GOOD_FRAME_DISABLE;
 | |
|     /* Receive Threshold Control */
 | |
|     dmaomr.rx_thresh_ctrl = EMAC_RECEIVE_THRESHOLD_CONTROL_64;
 | |
|     /* Allow the DMA to process a second frame of Transmit data even before obtaining the status for the first frame */
 | |
|     dmaomr.opt_second_frame = EMAC_OPERATE_SECOND_FRAME_ENABLE;
 | |
|     hal->dma_regs->dmaoperation_mode = dmaomr;
 | |
| 
 | |
|     /* DMABMR Configuration */
 | |
|     typeof(hal->dma_regs->dmabusmode) dmabmr = hal->dma_regs->dmabusmode;
 | |
|     /* Enable Mixed Burst */
 | |
|     dmabmr.dmamixedburst = EMAC_MIXED_BURST_ENABLE;
 | |
|     /* Enable Address Aligned Beates */
 | |
|     dmabmr.dmaaddralibea = EMAC_ADDR_ALIGN_BEATS_ENABLE;
 | |
|     /* Use Separate PBL */
 | |
|     dmabmr.use_sep_pbl = EMAC_USE_SEPARATE_PBL;
 | |
|     /* Set Rx/Tx DMA Burst Length */
 | |
|     dmabmr.rx_dma_pbl = EMAC_DMA_BURST_LENGTH_32BEAT;
 | |
|     dmabmr.prog_burst_len = EMAC_DMA_BURST_LENGTH_32BEAT;
 | |
|     /* Enable Enhanced Descriptor,8 Words(32 Bytes) */
 | |
|     dmabmr.alt_desc_size = EMAC_ENHANCED_DESCRIPTOR_ENABLE;
 | |
|     /* Specifies the number of word to skip between two unchained descriptors (Ring mode) */
 | |
|     dmabmr.desc_skip_len = 0;
 | |
|     /* DMA Arbitration Scheme */
 | |
|     dmabmr.dma_arb_sch = EMAC_DMA_ARBITRATION_SCHEME_ROUNDROBIN;
 | |
|     /* Set priority ratio in the weighted round-robin arbitration between Rx DMA and Tx DMA */
 | |
|     dmabmr.pri_ratio = EMAC_DMA_ARBITRATION_ROUNDROBIN_RXTX_1_1;
 | |
|     hal->dma_regs->dmabusmode = dmabmr;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_speed(emac_hal_context_t *hal, uint32_t speed)
 | |
| {
 | |
|     hal->mac_regs->gmacconfig.fespeed = speed;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_duplex(emac_hal_context_t *hal, uint32_t duplex)
 | |
| {
 | |
|     hal->mac_regs->gmacconfig.duplex = duplex;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_promiscuous(emac_hal_context_t *hal, bool enable)
 | |
| {
 | |
|     if (enable) {
 | |
|         hal->mac_regs->gmacff.pmode = 1;
 | |
|     } else {
 | |
|         hal->mac_regs->gmacff.pmode = 0;
 | |
|     }
 | |
| }
 | |
| 
 | |
| void emac_hal_send_pause_frame(emac_hal_context_t *hal, bool enable)
 | |
| {
 | |
|     if (enable) {
 | |
|         hal->ext_regs->ex_phyinf_conf.sbd_flowctrl = 1;
 | |
|     } else {
 | |
|         hal->ext_regs->ex_phyinf_conf.sbd_flowctrl = 0;
 | |
|     }
 | |
| }
 | |
| 
 | |
| bool emac_hal_is_mii_busy(emac_hal_context_t *hal)
 | |
| {
 | |
|     return hal->mac_regs->emacgmiiaddr.miibusy ? true : false;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_phy_cmd(emac_hal_context_t *hal, uint32_t phy_addr, uint32_t phy_reg, bool write)
 | |
| {
 | |
|     typeof(hal->mac_regs->emacgmiiaddr) macmiiar = hal->mac_regs->emacgmiiaddr;
 | |
|     macmiiar.miidev = phy_addr;
 | |
|     /* Set the PHY register address */
 | |
|     macmiiar.miireg = phy_reg;
 | |
|     if (write) {
 | |
|         /* Set write mode */
 | |
|         macmiiar.miiwrite = 1;
 | |
|     } else {
 | |
|         /* Set read mode */
 | |
|         macmiiar.miiwrite = 0;
 | |
|     }
 | |
|     /* Set MII busy bit */
 | |
|     macmiiar.miibusy = 1;
 | |
|     /* Write the result value into the MII Address register */
 | |
|     hal->mac_regs->emacgmiiaddr = macmiiar;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_phy_data(emac_hal_context_t *hal, uint32_t reg_value)
 | |
| {
 | |
|     hal->mac_regs->emacmiidata.mii_data = reg_value;
 | |
| }
 | |
| 
 | |
| uint32_t emac_hal_get_phy_data(emac_hal_context_t *hal)
 | |
| {
 | |
|     return hal->mac_regs->emacmiidata.mii_data;
 | |
| }
 | |
| 
 | |
| void emac_hal_set_address(emac_hal_context_t *hal, uint8_t *mac_addr)
 | |
| {
 | |
|     /* Make sure mac address is unicast type */
 | |
|     if (!(mac_addr[0] & 0x01)) {
 | |
|         hal->mac_regs->emacaddr0high.address0_hi = (mac_addr[5] << 8) | mac_addr[4];
 | |
|         hal->mac_regs->emacaddr0low = (mac_addr[3] << 24) | (mac_addr[2] << 16) | (mac_addr[1] << 8) | (mac_addr[0]);
 | |
|     }
 | |
| }
 | |
| 
 | |
| void emac_hal_start(emac_hal_context_t *hal)
 | |
| {
 | |
|     typeof(hal->dma_regs->dmaoperation_mode) opm = hal->dma_regs->dmaoperation_mode;
 | |
|     typeof(hal->mac_regs->gmacconfig) cfg = hal->mac_regs->gmacconfig;
 | |
| 
 | |
|     /* Enable Ethernet MAC and DMA Interrupt */
 | |
|     hal->dma_regs->dmain_en.val = 0xFFFFFFFF;
 | |
| 
 | |
|     /* Flush Transmit FIFO */
 | |
|     opm.flush_tx_fifo = 1;
 | |
|     /* Start DMA transmission */
 | |
|     opm.start_stop_transmission_command = 1;
 | |
|     /* Start DMA reception */
 | |
|     opm.start_stop_rx = 1;
 | |
|     /* Enable transmit state machine of the MAC for transmission on the MII */
 | |
|     cfg.tx = 1;
 | |
|     /* Enable receive state machine of the MAC for reception from the MII */
 | |
|     cfg.rx = 1;
 | |
| 
 | |
|     hal->dma_regs->dmaoperation_mode = opm;
 | |
|     hal->mac_regs->gmacconfig = cfg;
 | |
| 
 | |
|     /* Clear all pending interrupts */
 | |
|     hal->dma_regs->dmastatus.val = 0xFFFFFFFF;
 | |
| }
 | |
| 
 | |
| void emac_hal_stop(emac_hal_context_t *hal)
 | |
| {
 | |
|     typeof(hal->dma_regs->dmaoperation_mode) opm = hal->dma_regs->dmaoperation_mode;
 | |
|     typeof(hal->mac_regs->gmacconfig) cfg = hal->mac_regs->gmacconfig;
 | |
| 
 | |
|     /* Flush Transmit FIFO */
 | |
|     opm.flush_tx_fifo = 1;
 | |
|     /* Stop DMA transmission */
 | |
|     opm.start_stop_transmission_command = 0;
 | |
|     /* Stop DMA reception */
 | |
|     opm.start_stop_rx = 0;
 | |
|     /* Disable receive state machine of the MAC for reception from the MII */
 | |
|     cfg.rx = 0;
 | |
|     /* Disable transmit state machine of the MAC for transmission on the MII */
 | |
|     cfg.tx = 0;
 | |
| 
 | |
|     hal->dma_regs->dmaoperation_mode = opm;
 | |
|     hal->mac_regs->gmacconfig = cfg;
 | |
| 
 | |
|     /* Disable Ethernet MAC and DMA Interrupt */
 | |
|     hal->dma_regs->dmain_en.val = 0x0;
 | |
| }
 | |
| 
 | |
| uint32_t emac_hal_get_tx_desc_owner(emac_hal_context_t *hal)
 | |
| {
 | |
|     return hal->tx_desc->TDES0.Own;
 | |
| }
 | |
| 
 | |
| uint32_t emac_hal_transmit_frame(emac_hal_context_t *hal, uint8_t *buf, uint32_t length)
 | |
| {
 | |
|     /* Get the number of Tx buffers to use for the frame */
 | |
|     uint32_t bufcount = 0;
 | |
|     uint32_t lastlen = length;
 | |
|     uint32_t sentout = 0;
 | |
|     while (lastlen > CONFIG_ETH_DMA_BUFFER_SIZE) {
 | |
|         lastlen -= CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|         bufcount++;
 | |
|     }
 | |
|     if (lastlen) {
 | |
|         bufcount++;
 | |
|     }
 | |
|     if (bufcount > CONFIG_ETH_DMA_TX_BUFFER_NUM) {
 | |
|         goto err;
 | |
|     }
 | |
| 
 | |
|     eth_dma_tx_descriptor_t *desc_iter = hal->tx_desc;
 | |
|     /* A frame is transmitted in multiple descriptor */
 | |
|     for (size_t i = 0; i < bufcount; i++) {
 | |
|         /* Check if the descriptor is owned by the Ethernet DMA (when 1) or CPU (when 0) */
 | |
|         if (desc_iter->TDES0.Own != EMAC_DMADESC_OWNER_CPU) {
 | |
|             goto err;
 | |
|         }
 | |
|         /* Clear FIRST and LAST segment bits */
 | |
|         desc_iter->TDES0.FirstSegment = 0;
 | |
|         desc_iter->TDES0.LastSegment = 0;
 | |
|         desc_iter->TDES0.InterruptOnComplete = 0;
 | |
|         if (i == 0) {
 | |
|             /* Setting the first segment bit */
 | |
|             desc_iter->TDES0.FirstSegment = 1;
 | |
|         }
 | |
|         if (i == (bufcount - 1)) {
 | |
|             /* Setting the last segment bit */
 | |
|             desc_iter->TDES0.LastSegment = 1;
 | |
|             /* Enable transmit interrupt */
 | |
|             desc_iter->TDES0.InterruptOnComplete = 1;
 | |
|             /* Program size */
 | |
|             desc_iter->TDES1.TransmitBuffer1Size = lastlen;
 | |
|             /* copy data from uplayer stack buffer */
 | |
|             memcpy((void *)(desc_iter->Buffer1Addr), buf + i * CONFIG_ETH_DMA_BUFFER_SIZE, lastlen);
 | |
|             sentout += lastlen;
 | |
|         } else {
 | |
|             /* Program size */
 | |
|             desc_iter->TDES1.TransmitBuffer1Size = CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|             /* copy data from uplayer stack buffer */
 | |
|             memcpy((void *)(desc_iter->Buffer1Addr), buf + i * CONFIG_ETH_DMA_BUFFER_SIZE, CONFIG_ETH_DMA_BUFFER_SIZE);
 | |
|             sentout += CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|         }
 | |
|         /* Point to next descriptor */
 | |
|         desc_iter = (eth_dma_tx_descriptor_t *)(desc_iter->Buffer2NextDescAddr);
 | |
|     }
 | |
| 
 | |
|     /* Set Own bit of the Tx descriptor Status: gives the buffer back to ETHERNET DMA */
 | |
|     for (size_t i = 0; i < bufcount; i++) {
 | |
|         hal->tx_desc->TDES0.Own = EMAC_DMADESC_OWNER_DMA;
 | |
|         hal->tx_desc = (eth_dma_tx_descriptor_t *)(hal->tx_desc->Buffer2NextDescAddr);
 | |
|     }
 | |
|     hal->dma_regs->dmatxpolldemand = 0;
 | |
|     return sentout;
 | |
| err:
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| uint32_t emac_hal_receive_frame(emac_hal_context_t *hal, uint8_t *buf, uint32_t size, uint32_t *frames_remain, uint32_t *free_desc)
 | |
| {
 | |
|     eth_dma_rx_descriptor_t *desc_iter = NULL;
 | |
|     eth_dma_rx_descriptor_t *first_desc = NULL;
 | |
|     uint32_t used_descs = 0;
 | |
|     uint32_t seg_count = 0;
 | |
|     uint32_t ret_len = 0;
 | |
|     uint32_t copy_len = 0;
 | |
|     uint32_t write_len = 0;
 | |
|     uint32_t frame_count = 0;
 | |
| 
 | |
|     first_desc = hal->rx_desc;
 | |
|     desc_iter = hal->rx_desc;
 | |
|     /* Traverse descriptors owned by CPU */
 | |
|     while ((desc_iter->RDES0.Own != EMAC_DMADESC_OWNER_DMA) && (used_descs < CONFIG_ETH_DMA_RX_BUFFER_NUM) && !frame_count) {
 | |
|         used_descs++;
 | |
|         seg_count++;
 | |
|         /* Last segment in frame */
 | |
|         if (desc_iter->RDES0.LastDescriptor) {
 | |
|             /* Get the Frame Length of the received packet: substruct 4 bytes of the CRC */
 | |
|             ret_len = desc_iter->RDES0.FrameLength - ETH_CRC_LENGTH;
 | |
|             /* packets larger than expected will be truncated */
 | |
|             copy_len = ret_len > size ? size : ret_len;
 | |
|             /* update unhandled frame count */
 | |
|             frame_count++;
 | |
|         }
 | |
|         /* First segment in frame */
 | |
|         if (desc_iter->RDES0.FirstDescriptor) {
 | |
|             first_desc = desc_iter;
 | |
|         }
 | |
|         /* point to next descriptor */
 | |
|         desc_iter = (eth_dma_rx_descriptor_t *)(desc_iter->Buffer2NextDescAddr);
 | |
|     }
 | |
|     /* there's at least one frame to process */
 | |
|     if (frame_count) {
 | |
|         /* check how many frames left to handle */
 | |
|         while ((desc_iter->RDES0.Own != EMAC_DMADESC_OWNER_DMA) && (used_descs < CONFIG_ETH_DMA_RX_BUFFER_NUM)) {
 | |
|             used_descs++;
 | |
|             if (desc_iter->RDES0.LastDescriptor) {
 | |
|                 frame_count++;
 | |
|             }
 | |
|             /* point to next descriptor */
 | |
|             desc_iter = (eth_dma_rx_descriptor_t *)(desc_iter->Buffer2NextDescAddr);
 | |
|         }
 | |
|         desc_iter = first_desc;
 | |
|         for (size_t i = 0; i < seg_count - 1; i++) {
 | |
|             used_descs--;
 | |
|             write_len = copy_len < CONFIG_ETH_DMA_BUFFER_SIZE ? copy_len : CONFIG_ETH_DMA_BUFFER_SIZE;
 | |
|             /* copy data to buffer */
 | |
|             memcpy(buf, (void *)(desc_iter->Buffer1Addr), write_len);
 | |
|             buf += write_len;
 | |
|             copy_len -= write_len;
 | |
|             /* Set Own bit in Rx descriptors: gives the buffers back to DMA */
 | |
|             desc_iter->RDES0.Own = EMAC_DMADESC_OWNER_DMA;
 | |
|             desc_iter = (eth_dma_rx_descriptor_t *)(desc_iter->Buffer2NextDescAddr);
 | |
|         }
 | |
|         memcpy(buf, (void *)(desc_iter->Buffer1Addr), copy_len);
 | |
|         desc_iter->RDES0.Own = EMAC_DMADESC_OWNER_DMA;
 | |
|         /* update rxdesc */
 | |
|         hal->rx_desc = (eth_dma_rx_descriptor_t *)(desc_iter->Buffer2NextDescAddr);
 | |
|         /* poll rx demand */
 | |
|         hal->dma_regs->dmarxpolldemand = 0;
 | |
|         frame_count--;
 | |
|         used_descs--;
 | |
|     }
 | |
|     *frames_remain = frame_count;
 | |
|     *free_desc = CONFIG_ETH_DMA_RX_BUFFER_NUM - used_descs;
 | |
|     return ret_len;
 | |
| }
 | |
| 
 | |
| IRAM_ATTR void emac_hal_isr(void *arg)
 | |
| {
 | |
|     emac_hal_context_t *hal = (emac_hal_context_t *)arg;
 | |
|     typeof(hal->dma_regs->dmastatus) dma_status = hal->dma_regs->dmastatus;
 | |
|     hal->dma_regs->dmastatus.val = dma_status.val;
 | |
|     /* DMA Normal Interrupt */
 | |
|     if (dma_status.norm_int_summ) {
 | |
|         /* Transmit Interrupt */
 | |
|         if (dma_status.trans_int) {
 | |
|             emac_hal_tx_complete_cb(arg);
 | |
|         }
 | |
|         /* Transmit Buffer Unavailable */
 | |
|         if (dma_status.trans_buf_unavail) {
 | |
|             emac_hal_tx_unavail_cb(arg);
 | |
|         }
 | |
|         /* Receive Interrupt */
 | |
|         if (dma_status.recv_int) {
 | |
|             emac_hal_rx_complete_cb(arg);
 | |
|         }
 | |
|         /* Early Receive Interrupt */
 | |
|         if (dma_status.early_recv_int) {
 | |
|             emac_hal_rx_early_cb(arg);
 | |
|         }
 | |
|     }
 | |
|     /* DMA Abnormal Interrupt */
 | |
|     if (dma_status.abn_int_summ) {
 | |
|         /* Transmit Process Stopped */
 | |
|         if (dma_status.trans_proc_stop) {
 | |
|         }
 | |
|         /* Transmit Jabber Timeout */
 | |
|         if (dma_status.trans_jabber_to) {
 | |
|         }
 | |
|         /* Receive FIFO Overflow */
 | |
|         if (dma_status.recv_ovflow) {
 | |
|         }
 | |
|         /* Transmit Underflow */
 | |
|         if (dma_status.trans_undflow) {
 | |
|         }
 | |
|         /* Receive Buffer Unavailable */
 | |
|         if (dma_status.recv_buf_unavail) {
 | |
|             emac_hal_rx_unavail_cb(arg);
 | |
|         }
 | |
|         /* Receive Process Stopped */
 | |
|         if (dma_status.recv_proc_stop) {
 | |
|         }
 | |
|         /* Receive Watchdog Timeout */
 | |
|         if (dma_status.recv_wdt_to) {
 | |
|         }
 | |
|         /* Early Transmit Interrupt */
 | |
|         if (dma_status.early_trans_int) {
 | |
|         }
 | |
|         /* Fatal Bus Error */
 | |
|         if (dma_status.fatal_bus_err_int) {
 | |
|         }
 | |
|     }
 | |
| }
 | |
| 
 | |
| IRAM_ATTR __attribute__((weak)) void emac_hal_tx_complete_cb(void *arg)
 | |
| {
 | |
|     // This is a weak function, do nothing by default
 | |
|     // Upper code can rewrite this function
 | |
|     // Note: you're in the interrupt context
 | |
|     return;
 | |
| }
 | |
| 
 | |
| IRAM_ATTR __attribute__((weak)) void emac_hal_tx_unavail_cb(void *arg)
 | |
| {
 | |
|     // This is a weak function, do nothing by default
 | |
|     // Upper code can rewrite this function
 | |
|     // Note: you're in the interrupt context
 | |
|     return;
 | |
| }
 | |
| 
 | |
| IRAM_ATTR __attribute__((weak)) void emac_hal_rx_complete_cb(void *arg)
 | |
| {
 | |
|     // This is a weak function, do nothing by default
 | |
|     // Upper code can rewrite this function
 | |
|     // Note: you're in the interrupt context
 | |
|     return;
 | |
| }
 | |
| 
 | |
| IRAM_ATTR __attribute__((weak)) void emac_hal_rx_early_cb(void *arg)
 | |
| {
 | |
|     // This is a weak function, do nothing by default
 | |
|     // Upper code can rewrite this function
 | |
|     // Note: you're in the interrupt context
 | |
|     return;
 | |
| }
 | |
| 
 | |
| IRAM_ATTR __attribute__((weak)) void emac_hal_rx_unavail_cb(void *arg)
 | |
| {
 | |
|     // This is a weak function, do nothing by default
 | |
|     // Upper code can rewrite this function
 | |
|     // Note: you're in the interrupt context
 | |
|     return;
 | |
| }
 |