physical.h File Reference

Layer 1 (Physical) — WiFi radio initialisation and link-state query. More...

#include <Arduino.h>

Go to the source code of this file.

Functions
bool	init_wifi_physical (const char *ssid, const char *password)
	Connect to a WiFi access point.
bool	wifi_ready ()
	Query whether the WiFi link is up.

Detailed Description

Layer 1 (Physical) — WiFi radio initialisation and link-state query.

Wraps the Arduino WiFi library into the OSI-layered interface used by this library. On ESP32, the "physical" link is the 802.11 radio managed by the Espressif WiFi stack (not a discrete PHY chip).

Author

Douglas Quigg (dstroy0)

Date

2026

Definition in file physical.h.

Function Documentation

init_wifi_physical()

bool init_wifi_physical	(	const char *	ssid,
		const char *	password
	)

Connect to a WiFi access point.

Calls WiFi.begin() and returns immediately; it does not block waiting for the association to complete. Poll wifi_ready() to check link status.

Parameters

ssid	Network SSID (null-terminated).
password	WPA2 passphrase (null-terminated).

Returns

Always returns true (WiFi.begin() is fire-and-forget).

Definition at line 17 of file physical.cpp.

wifi_ready()

bool wifi_ready

(

)

Query whether the WiFi link is up.

Returns

true if associated with an AP and an IP address is assigned.

Definition at line 23 of file physical.cpp.