Skip to content

HowTo Configure WiFi

Jump to bottom
miswired edited this page Feb 7, 2026 · 3 revisions

How To: Configure WiFi Connection

This guide explains how to configure Glitchy's WiFi settings, including switching between Access Point (AP) mode and Client mode.

Prerequisites

  • Glitchy board with firmware
  • Computer with WiFi
  • (For client mode) Your WiFi network credentials

WiFi Modes Explained

Mode Description Use Case
Access Point (AP) Glitchy creates its own network Default, standalone use
Client (Station) Glitchy joins your network Integration with existing network

Access Point Mode (Default)

How It Works

  • Glitchy creates a WiFi network named "Glitchy"
  • Default password: 123456789
  • Your computer connects directly to Glitchy
  • No internet access through this connection
  • IP address: 192.168.4.1

Connecting in AP Mode

  1. Power on Glitchy
  2. Wait a few seconds for WiFi to start
  3. On your computer, connect to "Glitchy" network (default password: 123456789)
  4. Open browser to http://192.168.4.1

Client Mode

How It Works

  • Glitchy connects to your existing WiFi network
  • Access Glitchy from any device on your network
  • IP address assigned by your router (DHCP)

Finding Glitchy's IP Address

In client mode, Glitchy gets a dynamic IP. To find it:

  1. Serial Monitor: IP is printed at boot
  2. Router Admin: Check connected devices list

Changing Settings

To change the network name, credentials, or mode:

  1. Open Code/Glitchy/src/main.cpp
  2. Find the WiFi configuration: 
    /* This section is for global compiled options */
#define HOST_ACCESS_POINT   //Uncomment to have Glitchy host its own wifi network, comment to tell it to connect to an existing network

const char* ssid = "YOUR_SSID_HERE";
const char* password = "YOUR_PASSWORD_HERE";

//Set SSID and Password here if hosting access point
const char* ap_ssid     = "Glitchy";
const char* ap_password = "123456789";
  3. Modify as needed
  4. Rebuild and upload firmware

Troubleshooting

Can't Find AP Network

  1. Wait a moment — WiFi starts within a few seconds of power-on
  2. Reset device — Press RST button
  3. Verify mode — May be in client mode instead of AP mode
  4. Check for interference — Move closer to Glitchy, reduce 2.4GHz congestion

Client Mode Won't Connect

  1. Verify credentials — Check SSID and password exactly
  2. Check network — Ensure 2.4GHz (not 5GHz only)
  3. Check signal — Move Glitchy closer to router
  4. Check router — Ensure MAC filtering isn't blocking

How to Reset to AP Mode

If you've configured client mode but can't connect:

  1. Re-flash firmware with default AP configuration

Security Considerations

AP Mode Security

  • Use a strong password
  • Default credentials should be changed
  • Anyone nearby can attempt connection

Client Mode Security

  • Network traffic passes through your network
  • Consider network segmentation for security

Future Enhancement

Note: A future firmware version may allow WiFi configuration directly through the web interface without code changes.

See Also

Clone this wiki locally