Ethernet Component ================== .. seo:: :description: Instructions for setting up the Ethernet configuration for your ESP32 node in ESPHome. :image: ethernet.svg :keywords: Ethernet, ESP32 This core ESPHome component sets up ethernet connections for ESP32s. Ethernet for ESP8266 is not supported. .. code-block:: yaml # Example configuration entry ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 clk_mode: GPIO0_IN phy_addr: 0 # Optional manual IP manual_ip: static_ip: 10.0.0.42 gateway: 10.0.0.1 subnet: 255.255.255.0 Configuration variables: ------------------------ - **type** (**Required**, string): The type of LAN chipset. Must be one of ``LAN8720`` or ``TLK110`` (see datasheet for more details). - **mdc_pin** (**Required**, :ref:`config-pin`): The MDC pin of the board. Usually this is ``GPIO23``. - **mdio_pin** (**Required**, :ref:`config-pin`): The MDIO pin of the board. Usually this is ``GPIO18``. - **clk_mode** (*Optional*, string): The clock mode of the data lines, this must be one of these values: (see datasheet of your board for more details) - ``GPIO0_IN`` (Default) - External clock - ``GPIO0_OUT`` - Internal clock - ``GPIO16_OUT`` - Internal clock - ``GPIO17_OUT`` - Internal clock - **phy_addr** (*Optional*, int): The PHY addr type of the ethernet controller. Defaults to 0. - **power_pin** (*Optional*, :ref:`Pin Schema `): The pin with which to control the power of the board. Leave unspecified for no power pin (default) - **manual_ip** (*Optional*): Manually configure the static IP of the node. - **static_ip** (**Required**, IPv4 address): The static IP of your node. - **gateway** (**Required**, IPv4 address): The gateway of the local network. - **subnet** (**Required**, IPv4 address): The subnet of the local network. - **dns1** (*Optional*, IPv4 address): The main DNS server to use. - **dns2** (*Optional*, IPv4 address): The backup DNS server to use. - **enable_mdns** (*Optional*, boolean): Controls if your node should advertise its presence and services using mDNS. When set to ``false`` you won't be able to access your node using its hostname which can break certain functionalities. Please see :ref:`notes on disabling mDNS `. Defaults to ``true``. - **use_address** (*Optional*, string): Manually override what address to use to connect to the ESP. Defaults to auto-generated value. For example, if you have changed your static IP and want to flash OTA to the previously configured IP address. - **domain** (*Optional*, string): Set the domain of the node hostname used for uploading. For example, if it's set to ``.local``, all uploads will be sent to ``.local``. Defaults to ``.local``. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. .. note:: If your ethernet board is not designed with an ESP32 built in, chances are that you are going to use flying leads, dupont wires, etc. to connect the ethernet to the ESP32. This is probably to fail as the ethernet interface uses a high frequency clock signal. For more information and wiring details refer to the the link in the *See also* section. Configuration for wESP32 board ------------------------------ .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO16 mdio_pin: GPIO17 clk_mode: GPIO0_IN phy_addr: 0 Configuration for Olimex ESP32-POE ---------------------------------- .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 clk_mode: GPIO17_OUT phy_addr: 0 power_pin: GPIO12 Configuration for Olimex ESP32-EVB ---------------------------------- .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 clk_mode: GPIO0_IN phy_addr: 0 Configuration for LILYGO TTGO T-Internet-POE ESP32-WROOM LAN8270A Chip ---------------------------------------------------------------------- .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 clk_mode: GPIO17_OUT phy_addr: 0 Configuration for OpenHacks LAN8720 ----------------------------------- .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 phy_addr: 1 Note: This board has an issue that might cause the ESP32 to boot in program mode. When testing, make sure you are monitoring the serial output and reboot the device several times to see if it boots into the program properly. Configuration for Wireless Tag WT32-ETH01 ----------------------------------------- .. code-block:: yaml ethernet: type: LAN8720 mdc_pin: GPIO23 mdio_pin: GPIO18 clk_mode: GPIO0_IN phy_addr: 1 power_pin: GPIO16 See Also -------- - :apiref:`ethernet/ethernet_component.h` - `ESP32 Ethernet PHY connection info `__ - :ghedit:`Edit`