From a2d669c008485f504247cadf66824826b5daaf49 Mon Sep 17 00:00:00 2001
From: Ondrej Kosta <ondrej.kosta@espressif.com>
Date: Tue, 16 May 2023 16:45:41 +0200
Subject: [PATCH] Updated Ethernet README Common Troubleshooting to describe
 workaround when SPI issues are observed with internal EMAC connected

---
 examples/ethernet/README.md                   |   5 ++
 .../components/ethernet_init/ethernet_init.c  |  11 +++-
 examples/network/bridge/README.md             |   2 +-
 examples/network/bridge/docs/network.drawio   |  61 ------------------
 examples/network/bridge/docs/network.png      | Bin 17507 -> 0 bytes
 5 files changed, 15 insertions(+), 64 deletions(-)
 delete mode 100644 examples/network/bridge/docs/network.drawio
 delete mode 100644 examples/network/bridge/docs/network.png

diff --git a/examples/ethernet/README.md b/examples/ethernet/README.md
index 46aa134729..ffc8cdfd21 100644
--- a/examples/ethernet/README.md
+++ b/examples/ethernet/README.md
@@ -80,3 +80,8 @@ Please consult Espressif Technical reference manual along with datasheet for spe
 
 * The data panel between ESP32's MAC and PHY needs a fixed 50MHz clock to do synchronization, which also called RMII clock. It can either be provided by an external oscillator or generated from internal APLL. The signal integrity of RMII clock is strict, so keep the trace as short as possible!
 * If the RMII clock is generated from internal APLL, then APLL can't be used for other purpose (e.g. I2S).
+* If you observe undefined behavior (e.g. LCD glitches) of any **SPI device** which works normally when Ethernet is not connected over internal EMAC, you need to adjust EMAC DMA burst length (the DMA is shared resource between EMAC and the SPI). The same applies when you observe Ethernet frames corruption at the output of SPI Ethernet module and you use combination of internal EMAC and SPI Ethernet module as network interfaces. To configure the EMAC DMA burst length, modify internal Ethernet initialization as follows:
+
+```c
+esp32_emac_config.dma_burst_len = ETH_DMA_BURST_LEN_4; // or other appropriate value
+```
diff --git a/examples/ethernet/basic/components/ethernet_init/ethernet_init.c b/examples/ethernet/basic/components/ethernet_init/ethernet_init.c
index ffb4e3f837..f19cc4b99f 100644
--- a/examples/ethernet/basic/components/ethernet_init/ethernet_init.c
+++ b/examples/ethernet/basic/components/ethernet_init/ethernet_init.c
@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2022 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Unlicense OR CC0-1.0
  */
@@ -69,6 +69,11 @@ static esp_eth_handle_t eth_init_internal(esp_eth_mac_t **mac_out, esp_eth_phy_t
     // Update vendor specific MAC config based on board configuration
     esp32_emac_config.smi_mdc_gpio_num = CONFIG_EXAMPLE_ETH_MDC_GPIO;
     esp32_emac_config.smi_mdio_gpio_num = CONFIG_EXAMPLE_ETH_MDIO_GPIO;
+#if CONFIG_EXAMPLE_USE_SPI_ETHERNET
+    // The DMA is shared resource between EMAC and the SPI. Therefore, adjust
+    // EMAC DMA burst length when SPI Ethernet is used along with EMAC.
+    esp32_emac_config.dma_burst_len = ETH_DMA_BURST_LEN_4;
+#endif // CONFIG_EXAMPLE_USE_SPI_ETHERNET
     // Create new ESP32 Ethernet MAC instance
     esp_eth_mac_t *mac = esp_eth_mac_new_esp32(&esp32_emac_config, &mac_config);
     // Create new PHY instance based on board configuration
@@ -175,7 +180,9 @@ static esp_eth_handle_t eth_init_spi(spi_eth_module_config_t *spi_eth_module_con
         .mode = 0,
         .clock_speed_hz = CONFIG_EXAMPLE_ETH_SPI_CLOCK_MHZ * 1000 * 1000,
         .queue_size = 20,
-        .spics_io_num = spi_eth_module_config->spi_cs_gpio
+        .spics_io_num = spi_eth_module_config->spi_cs_gpio,
+        .input_delay_ns = 20
+
     };
     // Init vendor specific MAC config to default, and create new SPI Ethernet MAC instance
     // and new PHY instance based on board configuration
diff --git a/examples/network/bridge/README.md b/examples/network/bridge/README.md
index 23f88ea891..afedb06fbe 100644
--- a/examples/network/bridge/README.md
+++ b/examples/network/bridge/README.md
@@ -44,7 +44,7 @@ The work flow of the example is then as follows:
 
 ## Hardware Required
 
-To run this example, it's recommended that you have either an official ESP32 Ethernet development board - [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/en/latest/hw-reference/get-started-ethernet-kit.html), or 3rd party ESP32 board as long as it's integrated with a supported Ethernet PHY chips, connected with supported SPI Ethernet modules (for example `DM9051`, `W5500` or `KSZ8851SNL`). Or ESP32(S/C series) board without internal Ethernet interface but connected to multiple SPI Ethernet modules.
+To run this example, it's recommended that you have either an official ESP32 Ethernet development board - [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/en/latest/hw-reference/get-started-ethernet-kit.html), or 3rd party ESP32 board as long as it's integrated with a supported Ethernet PHY chips and connected with supported SPI Ethernet modules (for example `DM9051`, `W5500` or `KSZ8851SNL`). Or ESP32(S/C series) board without internal Ethernet interface but connected to multiple SPI Ethernet modules. Note that it is recommended to use multiple SPI Ethernet modules of the same type rather than combination of internal EMAC and SPI module since you don't need to take care of load balancing (internal EMAC has much higher bandwidth than SPI Ethernet modules).
 
 ### Pin Assignment
 
diff --git a/examples/network/bridge/docs/network.drawio b/examples/network/bridge/docs/network.drawio
deleted file mode 100644
index 8d846d467e..0000000000
--- a/examples/network/bridge/docs/network.drawio
+++ /dev/null
@@ -1,61 +0,0 @@
-<mxfile host="65bd71144e">
-    <diagram id="qvqIMWZhLYQI7_66ceEl" name="Page-1">
-        <mxGraphModel dx="1074" dy="527" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" background="#B8B8B8" math="0" shadow="0">
-            <root>
-                <mxCell id="0"/>
-                <mxCell id="1" parent="0"/>
-                <mxCell id="2" value="ESP32 w/ 2 bridged Eth ports&lt;br&gt;(DHCP Client)" style="rounded=0;whiteSpace=wrap;html=1;" parent="1" vertex="1">
-                    <mxGeometry x="280" y="160" width="120" height="60" as="geometry"/>
-                </mxCell>
-                <mxCell id="5" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.25;entryY=1;entryDx=0;entryDy=0;startArrow=classic;startFill=1;" parent="1" source="3" target="2" edge="1">
-                    <mxGeometry relative="1" as="geometry"/>
-                </mxCell>
-                <mxCell id="3" value="PC#1&lt;br&gt;(DHCP Server)" style="rounded=0;whiteSpace=wrap;html=1;" parent="1" vertex="1">
-                    <mxGeometry x="160" y="280" width="120" height="60" as="geometry"/>
-                </mxCell>
-                <mxCell id="6" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.75;entryY=1;entryDx=0;entryDy=0;startArrow=classic;startFill=1;" parent="1" source="4" target="2" edge="1">
-                    <mxGeometry relative="1" as="geometry"/>
-                </mxCell>
-                <mxCell id="4" value="PC#2&lt;br&gt;(DHCP Client)" style="rounded=0;whiteSpace=wrap;html=1;" parent="1" vertex="1">
-                    <mxGeometry x="400" y="280" width="120" height="60" as="geometry"/>
-                </mxCell>
-                <mxCell id="7" value="" style="endArrow=open;startArrow=open;html=1;startFill=0;endFill=0;dashed=1;dashPattern=1 1;" parent="1" edge="1">
-                    <mxGeometry width="50" height="50" relative="1" as="geometry">
-                        <mxPoint x="290" y="309.71" as="sourcePoint"/>
-                        <mxPoint x="390" y="309.71" as="targetPoint"/>
-                        <Array as="points">
-                            <mxPoint x="340" y="309.71"/>
-                        </Array>
-                    </mxGeometry>
-                </mxCell>
-                <mxCell id="8" value="" style="endArrow=open;startArrow=open;html=1;startFill=0;endFill=0;dashed=1;dashPattern=1 1;" parent="1" edge="1">
-                    <mxGeometry width="50" height="50" relative="1" as="geometry">
-                        <mxPoint x="180" y="270" as="sourcePoint"/>
-                        <mxPoint x="270" y="190" as="targetPoint"/>
-                        <Array as="points">
-                            <mxPoint x="210" y="210"/>
-                        </Array>
-                    </mxGeometry>
-                </mxCell>
-                <mxCell id="9" value="" style="endArrow=open;startArrow=open;html=1;startFill=0;endFill=0;dashed=1;dashPattern=1 1;" parent="1" edge="1">
-                    <mxGeometry width="50" height="50" relative="1" as="geometry">
-                        <mxPoint x="410" y="190" as="sourcePoint"/>
-                        <mxPoint x="500" y="270" as="targetPoint"/>
-                        <Array as="points">
-                            <mxPoint x="470" y="210"/>
-                        </Array>
-                    </mxGeometry>
-                </mxCell>
-                <mxCell id="11" value="ping" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;" parent="1" vertex="1">
-                    <mxGeometry x="160" y="190" width="60" height="30" as="geometry"/>
-                </mxCell>
-                <mxCell id="12" value="ping" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;" parent="1" vertex="1">
-                    <mxGeometry x="460" y="190" width="60" height="30" as="geometry"/>
-                </mxCell>
-                <mxCell id="13" value="ping" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;" parent="1" vertex="1">
-                    <mxGeometry x="310" y="280" width="60" height="30" as="geometry"/>
-                </mxCell>
-            </root>
-        </mxGraphModel>
-    </diagram>
-</mxfile>
diff --git a/examples/network/bridge/docs/network.png b/examples/network/bridge/docs/network.png
deleted file mode 100644
index 8d975df51b118a4272f749c7b1b5d052f7168131..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 17507
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
Aod5s;