ESPHome  2024.10.2
ethernet_component.h
Go to the documentation of this file.
1 #pragma once
2 
4 #include "esphome/core/defines.h"
5 #include "esphome/core/hal.h"
7 
8 #ifdef USE_ESP32
9 
10 #include "esp_eth.h"
11 #include "esp_eth_mac.h"
12 #include "esp_netif.h"
13 #include "esp_mac.h"
14 
15 namespace esphome {
16 namespace ethernet {
17 
29 };
30 
31 struct ManualIP {
37 };
38 
39 struct PHYRegister {
40  uint32_t address;
41  uint32_t value;
42  uint32_t page;
43 };
44 
46  STOPPED,
47  CONNECTING,
48  CONNECTED,
49 };
50 
51 class EthernetComponent : public Component {
52  public:
54  void setup() override;
55  void loop() override;
56  void dump_config() override;
57  float get_setup_priority() const override;
58  bool can_proceed() override;
59  void on_shutdown() override { powerdown(); }
60  bool is_connected();
61 
62 #ifdef USE_ETHERNET_SPI
63  void set_clk_pin(uint8_t clk_pin);
64  void set_miso_pin(uint8_t miso_pin);
65  void set_mosi_pin(uint8_t mosi_pin);
66  void set_cs_pin(uint8_t cs_pin);
67  void set_interrupt_pin(uint8_t interrupt_pin);
68  void set_reset_pin(uint8_t reset_pin);
69  void set_clock_speed(int clock_speed);
70 #else
71  void set_phy_addr(uint8_t phy_addr);
72  void set_power_pin(int power_pin);
73  void set_mdc_pin(uint8_t mdc_pin);
74  void set_mdio_pin(uint8_t mdio_pin);
75  void set_clk_mode(emac_rmii_clock_mode_t clk_mode, emac_rmii_clock_gpio_t clk_gpio);
76  void add_phy_register(PHYRegister register_value);
77 #endif
78  void set_type(EthernetType type);
79  void set_manual_ip(const ManualIP &manual_ip);
80 
82  network::IPAddress get_dns_address(uint8_t num);
83  std::string get_use_address() const;
84  void set_use_address(const std::string &use_address);
85  void get_eth_mac_address_raw(uint8_t *mac);
86  std::string get_eth_mac_address_pretty();
87  eth_duplex_t get_duplex_mode();
88  eth_speed_t get_link_speed();
89  bool powerdown();
90 
91  protected:
92  static void eth_event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data);
93  static void got_ip_event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data);
94 #if LWIP_IPV6
95  static void got_ip6_event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data);
96 #endif /* LWIP_IPV6 */
97 
98  void start_connect_();
99  void dump_connect_params_();
101  void ksz8081_set_clock_reference_(esp_eth_mac_t *mac);
103  void write_phy_register_(esp_eth_mac_t *mac, PHYRegister register_data);
104 
105  std::string use_address_;
106 #ifdef USE_ETHERNET_SPI
107  uint8_t clk_pin_;
108  uint8_t miso_pin_;
109  uint8_t mosi_pin_;
110  uint8_t cs_pin_;
111  uint8_t interrupt_pin_;
112  int reset_pin_{-1};
113  int phy_addr_spi_{-1};
115 #else
116  uint8_t phy_addr_{0};
117  int power_pin_{-1};
118  uint8_t mdc_pin_{23};
119  uint8_t mdio_pin_{18};
120  emac_rmii_clock_mode_t clk_mode_{EMAC_CLK_EXT_IN};
121  emac_rmii_clock_gpio_t clk_gpio_{EMAC_CLK_IN_GPIO};
122  std::vector<PHYRegister> phy_registers_{};
123 #endif
125  optional<ManualIP> manual_ip_{};
126 
127  bool started_{false};
128  bool connected_{false};
129  bool got_ipv4_address_{false};
130 #if LWIP_IPV6
131  uint8_t ipv6_count_{0};
132 #endif /* LWIP_IPV6 */
134  uint32_t connect_begin_;
135  esp_netif_t *eth_netif_{nullptr};
136  esp_eth_handle_t eth_handle_;
137  esp_eth_phy_t *phy_{nullptr};
138 };
139 
140 // NOLINTNEXTLINE(cppcoreguidelines-avoid-non-const-global-variables)
142 extern "C" esp_eth_phy_t *esp_eth_phy_new_jl1101(const eth_phy_config_t *config);
143 
144 } // namespace ethernet
145 } // namespace esphome
146 
147 #endif // USE_ESP32
void setup()
void loop()
network::IPAddress dns1
The first DNS server. 0.0.0.0 for default.
esp_eth_phy_t * esp_eth_phy_new_jl1101(const eth_phy_config_t *config)
std::string get_use_address()
Get the active network hostname.
Definition: util.cpp:52
bool is_connected()
Return whether the node is connected to the network (through wifi, eth, ...)
Definition: util.cpp:15
EthernetComponent * global_eth_component
network::IPAddresses get_ip_addresses()
Definition: util.cpp:40
network::IPAddress dns2
The second DNS server. 0.0.0.0 for default.
uint8_t type
std::array< IPAddress, 5 > IPAddresses
Definition: ip_address.h:141
Implementation of SPI Controller mode.
Definition: a01nyub.cpp:7
uint8_t event_id
Definition: tt21100.cpp:15