mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-11-08 09:52:07 +01:00
157 lines
5.0 KiB
ReStructuredText
157 lines
5.0 KiB
ReStructuredText
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 <config-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 <faq-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 ``<HOSTNAME>.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
|
|
--------
|
|
|
|
- :doc:`network`
|
|
- :apiref:`ethernet/ethernet_component.h`
|
|
- `ESP32 Ethernet PHY connection info <https://pcbartists.com/design/embedded/esp32-ethernet-phy-schematic-design/>`__
|
|
- :ghedit:`Edit`
|