#dhcp-server #esp-hal #signal #target #ip #subnet #dns

esp-hal-dhcp-server

A simple DHCP server for embassy-net (main target is esp-hal)

2 releases

0.1.1 Sep 3, 2024
0.1.0 Aug 30, 2024

#480 in Hardware support

Download history 153/week @ 2024-08-26 143/week @ 2024-09-02

296 downloads per month

MIT license

14KB
293 lines

esp-hal-dhcp-server

Simple dhcp server for embassy tested on esp-hal (esp32-s3 - WiFiAP with android phone).

crates.io MIT license

Example

To see full example look inside ./example dir, you can cd into it and run it as normal crate

// ...
// spawn your dhcp_server task
spawner.spawn(dhcp_server(stack)).ok();

log::info!("Closing dhcp server after 2m...");
Timer::after(Duration::from_secs(120)).await;
log::info!("Closing dhcp server...");

// you can close your server using builtin SIGNAL
esp_hal_dhcp::dhcp_close();
// ...

// ...
#[embassy_executor::task]
async fn dhcp_server(stack: &'static Stack<WifiDevice<'static, WifiApDevice>>) {
    let config = DhcpServerConfig {
        ip: Ipv4Addr::new(192, 168, 2, 1),
        lease_time: Duration::from_secs(3600),
        gateways: &[],
        subnet: None,
        dns: &[],
    };

    let mut leaser = SimpleDhcpLeaser {
        start: Ipv4Addr::new(192, 168, 2, 50),
        end: Ipv4Addr::new(192, 168, 2, 200),
        leases: Default::default(),
    };
    esp_hal_dhcp::run_dhcp_server(stack, config, &mut leaser).await;
}

Dependencies

~5.5MB
~114K SLoC