feat(examples): Add esp_netif examples demonstrating network interface configurations by abhik-roy85 · Pull Request #1013 · espressif/esp-protocols

abhik-roy85 · 2026-02-17T12:51:09Z

Description

This commit adds new examples showcasing different esp_netif network interface configurations and use cases.

Added examples:

eth_gateway: Ethernet Access Point example that runs a DHCP server on a single Ethernet interface, allowing connected devices to obtain IP addresses automatically
eth_gateway_wifi_ap: Dual AP configuration example that simultaneously operates both Ethernet and Wi-Fi interfaces as Access Points with DHCP servers, enabling the ESP to act as a multi-interface router providing both wired (192.168.5.x) and wireless (192.168.4.x) network access simultaneously. Includes configurable DHCP pools, DNS support, NAPT routing, and client management for both interfaces."
eth_gateway_wifi_sta: Hybrid configuration example that operates Ethernet as an Access Point with DHCP server while simultaneously running Wi-Fi as a Station connecting to an external access point, enabling network bridging between wired and wireless networks
eth_endpoint_wifi_sta: Dual interface example that simultaneously operates both Ethernet STA and Wi-Fi STA interfaces as DHCP clients
eth_endpoint_wifi_ap: Hybrid configuration example that operates Ethernet as a Station with DHCP client while simultaneously running Wi-Fi as an Access Point with DHCP server, enabling network bridging between wired upstream connection and local wireless network

Testing

Checklist

Before submitting a Pull Request, please ensure the following:

🚨 This PR does not introduce breaking changes.
All CI checks (GH Actions) pass.
Documentation is updated as needed.
Tests are updated or added as necessary.
Code is well-commented, especially in complex areas.
Git history is clean — commits are squashed to the minimum necessary.

Note

Low Risk
New code is isolated to examples and a .gitignore tweak, with no changes to production components or security-sensitive logic.

Overview
Adds two new esp_netif example projects under examples/esp_netif: EthAp configures a single Ethernet interface with a static IP and runs an on-device DHCP server (including configurable lease time, address pool, and optional DNS offers), and EthStaWifiSta brings up Ethernet STA and Wi‑Fi STA concurrently as DHCP clients while logging IP/DNS info and waiting for Wi‑Fi to obtain an address.

Also updates .gitignore to ignore clangd cache/index artifacts (.cache/, *.idx).

^{Written by Cursor Bugbot for commit bc8bb2d. This will update automatically on new commits. Configure here.}

alisitsyn · 2026-03-19T08:47:19Z

@@ -0,0 +1,7 @@
+dependencies:
+  idf:
+    version: '>=5.4.3,!=5.5.0,!=5.5.1'


Should the reason for constraints be clarified?

I presume this is due to Ethernet Init component. However, is it needed to be explicitly redefined for this example? Wouldn't be better to let it on version resolver based on Ethernet init?

Modified to
idf: "*"

kostaond · 2026-03-19T11:09:23Z

@@ -0,0 +1,7 @@
+dependencies:
+  idf:
+    version: '>=5.4.3,!=5.5.0,!=5.5.1'


I presume this is due to Ethernet Init component. However, is it needed to be explicitly redefined for this example? Wouldn't be better to let it on version resolver based on Ethernet init?

kostaond · 2026-03-19T11:33:45Z

+
+## Overview
+
+This example initializes **two network interfaces simultaneously**: an **Ethernet interface** operating as a **Station (STA)** with DHCP client, and a **Wi-Fi interface** operating as an **Access Point (AP)** with a DHCP server. The Ethernet Station connects to an external network via DHCP, while the Wi-Fi AP provides network access to connected devices via DHCP (e.g. in the `192.168.5.x` range). This hybrid configuration enables the ESP to bridge between a wired upstream connection and a local wireless network.


Is the only difference to EthAPWifiAP the fact that Ethernet is set as DHCP Client? If so, I would merge the examples where it makes sense together and rename them to something more common and make DHCP Server/Client as configurable option in the menuconfig. Otherwise, it will be nightmare to maintain.

david-cermak · 2026-03-19T11:27:31Z

@@ -0,0 +1,15 @@
+# This file was generated using idf.py save-defconfig. It can be edited manually.


Is this file necessary? Seems to me that all items are defaults from Kconfig.project

Using the skdconfig.defaults as a configuration file for easier parameter modification.

cursor · 2026-03-31T13:26:10Z

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

…e configurations This commit adds new examples showcasing different esp_netif network interface configurations and use cases. Added examples: - eth_gateway: Ethernet Access Point example that runs a DHCP server on a single Ethernet interface, allowing connected devices to obtain IP addresses automatically - eth_endpoint_wifi_sta: Dual interface example that simultaneously operates both Ethernet STA and Wi-Fi STA interfaces as DHCP clients - eth_gateway_wifi_sta: Hybrid configuration example that operates Ethernet as an Access Point with DHCP server while simultaneously running Wi-Fi as a Station connecting to an external access point, enabling network bridging between wired and wireless networks - eth_endpoint_wifi_ap: Hybrid configuration example that operates Ethernet as a Station with DHCP client while simultaneously running Wi-Fi as an Access Point with DHCP server, enabling network bridging between wired upstream connection and local wireless network - eth_gateway_wifi_ap: Dual AP configuration example that simultaneously operates both Ethernet and Wi-Fi interfaces as Access Points with DHCP servers, enabling the ESP to act as a multi-interface router providing both wired (192.168.5.x) and wireless (192.168.4.x) network access simultaneously. Includes configurable DHCP pools, DNS support, NAPT routing, and client management for both interfaces."

abhik-roy85 marked this pull request as draft February 17, 2026 12:51

abhik-roy85 self-assigned this Feb 17, 2026

This comment was marked as outdated.

Sign in to view

abhik-roy85 force-pushed the esp_netif_examples branch from bc8bb2d to 4cb7552 Compare February 17, 2026 12:58

abhik-roy85 changed the title ~~feat(examples): Add esp_netif examples demonstrating network interfac…~~ feat(examples): Add esp_netif examples demonstrating network interface Feb 18, 2026

abhik-roy85 changed the title ~~feat(examples): Add esp_netif examples demonstrating network interface~~ feat(examples): Add esp_netif examples demonstrating network interface configurations Feb 18, 2026

abhik-roy85 force-pushed the esp_netif_examples branch from 4cb7552 to d4e6b81 Compare February 19, 2026 01:59

abhik-roy85 force-pushed the esp_netif_examples branch 2 times, most recently from 6186ceb to b9cacf0 Compare February 27, 2026 13:10

abhik-roy85 marked this pull request as ready for review February 27, 2026 13:14

abhik-roy85 requested review from alisitsyn, bogdankolendovskyy, david-cermak, euripedesrocha, gabsuren, glmfe and kostaond February 27, 2026 13:14

alisitsyn reviewed Mar 19, 2026

View reviewed changes

alisitsyn self-requested a review March 19, 2026 09:28

kostaond reviewed Mar 19, 2026

View reviewed changes

david-cermak reviewed Mar 19, 2026

View reviewed changes

abhik-roy85 force-pushed the esp_netif_examples branch from b9cacf0 to aea02cc Compare March 31, 2026 13:26

abhik-roy85 force-pushed the esp_netif_examples branch 3 times, most recently from 9febe1e to 9c4dde0 Compare April 1, 2026 11:26

abhik-roy85 force-pushed the esp_netif_examples branch from 9c4dde0 to 7848a4a Compare April 1, 2026 12:44


		## Overview

		This example initializes two network interfaces simultaneously: an Ethernet interface operating as a Station (STA) with DHCP client, and a Wi-Fi interface operating as an Access Point (AP) with a DHCP server. The Ethernet Station connects to an external network via DHCP, while the Wi-Fi AP provides network access to connected devices via DHCP (e.g. in the `192.168.5.x` range). This hybrid configuration enables the ESP to bridge between a wired upstream connection and a local wireless network.

		@@ -0,0 +1,15 @@
		# This file was generated using idf.py save-defconfig. It can be edited manually.

Conversation

abhik-roy85 commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related

Testing

Checklist

Uh oh!

This comment was marked as outdated.

Uh oh!

alisitsyn Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

kostaond Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

abhik-roy85 Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kostaond Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kostaond Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

david-cermak Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

abhik-roy85 Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot commented Mar 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

abhik-roy85 commented Feb 17, 2026 •

edited

Loading