Network Configuration

Cassandra supports both Station (STA) mode, connecting to an existing Wi-Fi network, and Access Point (AP) mode, creating its own network for configuration.

Hostname

The hostname identifies the device on the network.

• Default: cassandra-dev (or similarly configured)
• Usage: Used for mDNS (e.g., cassandra-dev.local) if supported.

Station (STA) Mode

In this mode, Cassandra connects to your home or office router.

Setting	JSON Key	Description
SSID	sta_ssid	The name of the Wi-Fi network to connect to.
Password	sta_password	The password for the Wi-Fi network.
IP Address	sta_local_ip	Static IP address for the device (e.g., 192.168.1.250).
Gateway	sta_gateway	Network gateway (usually your router’s IP, e.g., 192.168.1.1).
Subnet Mask	sta_subnet	Subnet mask (e.g., 255.255.255.0).
Primary DNS	sta_primary_dns	Primary DNS server (e.g., 192.168.1.1 or 8.8.8.8).
Secondary DNS	sta_secondary_dns	Secondary DNS server.

Access Point (AP) Mode

If enabled, Cassandra creates its own restricted Wi-Fi network. This is useful for initial setup if no other network is available.

Setting	JSON Key	Description
SSID	ap_ssid	The name of the network Cassandra will create (e.g. PolyMechAP).
Password	ap_password	The password required to connect to this AP.
AP IP	ap_config_ip	The IP address of Cassandra itself within this network (e.g., 192.168.4.1).
Gateway	ap_config_gateway	Gateway address for the AP network.
Subnet	ap_config_subnet	Subnet mask for the AP network.

Network Configuration File

The network settings are stored in config/network.json.

{
  "sta_ssid": "StartNetwork",
  "sta_local_ip": "192.168.1.250",
  ...
}