Configure your OSSM's WiFi connection for over-the-air updates and remote features
Connecting your OSSM to WiFi enables over-the-air firmware updates and other network-based features.
Your OSSM only supports 2.4GHz WiFi networks. This is a hardware limitation of the ESP32 microcontroller. 5GHz networks will not appear in the network list.
Pairing your OSSM to the dashboard for the first time? Use Automatic Pairing via Bluetooth instead — it pairs your account and provisions WiFi in one step, directly from the dashboard.
This guide covers standalone WiFi configuration — useful if you need to change networks, reset credentials, or set up WiFi outside of the pairing flow.
Prerequisites
Before you begin, ensure you have:
- Your WiFi network name (SSID)
- Your WiFi password
- A 2.4GHz WiFi network (5GHz is not supported)
Choose your setup method
Option 1: Web BLE Controller
Configure wirelessly using a web browser—no wired remote required.
Option 2: Wired Remote
Use the OSSM's built-in display and encoder to set up WiFi.
Option 1: Web BLE Controller
The Web BLE Controller provides a browser-based interface for configuring your OSSM wirelessly. This method works best for users without a wired remote or who prefer a graphical interface.
The Web BLE Controller requires a browser with Web Bluetooth support, such as Google Chrome or Microsoft Edge. Safari does not currently support Web Bluetooth.
Open the Web Controller
Navigate to the Web BLE Controller in a compatible browser (Chrome or Edge).
Connect to your OSSM
Click the Connect button and select your OSSM from the Bluetooth pairing dialog. Your OSSM will appear in the list with its Bluetooth name.
If your OSSM doesn't appear, ensure it's powered on and within Bluetooth range (typically 10 meters).
Navigate to WiFi Settings
Once connected, click the WiFi Settings tab at the top of the controller interface.
Enter your WiFi credentials
Fill in the WiFi configuration form:
- Network Name (SSID): Enter your WiFi network name (maximum 32 characters)
- Password: Enter your WiFi password (8-63 characters required)
The password must be between 8 and 63 characters. Passwords shorter than 8 characters will not be accepted.
Save and connect
Click the Save & Connect button. The OSSM will attempt to connect to your WiFi network.
The status indicator will display:
- ✓ Connected — Successfully connected to WiFi
- ○ Not Connected — Connection failed or still attempting
If connected, you'll see your network SSID, IP address, and signal strength (RSSI).
Option 2: Wired Remote (Captive Portal)
If you have the wired remote with the OLED display, you can configure WiFi directly from the device using the built-in captive portal system.
Access WiFi Setup from the menu
From the main menu on your OSSM's display:
- Use the encoder to scroll to WiFi Setup
- Press the encoder button to select it
The display will show WiFi setup information and a QR code for easy connection.
Connect to OSSM Setup network
On your phone or computer, open your WiFi settings and connect to the network named:
OSSM Setup
This network has no password. The QR code displayed on the OSSM's screen can be scanned to connect automatically on supported devices.
Configure via captive portal
After connecting to the OSSM Setup network, a configuration page should open automatically. If it doesn't, manually navigate to:
http://192.168.4.1On the configuration page:
- Select your home WiFi network from the list (only 2.4GHz networks appear)
- Enter your WiFi password
- Click Save or Submit
Verify connection
The OSSM will save your credentials and attempt to connect. If successful, the display will show:
- Your network SSID
- Your OSSM's IP address on the network
The captive portal will automatically close, and you'll be disconnected from the OSSM Setup network.
Resetting WiFi credentials
If you need to clear saved WiFi credentials or connect to a different network:
- Navigate to WiFi Setup in the main menu
- Long press the encoder button (hold for 3 seconds)
- The stored credentials will be erased
- The OSSM will restart, allowing you to configure WiFi again
Troubleshooting
The ESP32 microcontroller only supports 2.4GHz WiFi networks. 5GHz networks will not appear in the network list. Ensure your router broadcasts a 2.4GHz network, or use a dual-band network name that supports both frequencies.
If the captive portal configuration page doesn't open after connecting to the OSSM Setup network, manually open a web browser and navigate to:
http://192.168.4.1This is the direct IP address of the OSSM's configuration server.
If your OSSM repeatedly fails to connect:
- Verify your WiFi password is correct (passwords are case-sensitive)
- Ensure your router supports 2.4GHz
- Check that your router allows new device connections (some routers have device limits)
- Try moving your OSSM closer to your router to improve signal strength
- Reset WiFi credentials (long press on WiFi Setup) and try again
If your OSSM successfully connects to WiFi, you can verify by:
- Using the Web BLE Controller's WiFi Settings tab—click Refresh to see current connection status
- Checking the wired remote display when entering WiFi Setup—it will show "Connected to: [your network]" if online
- Testing the Update feature from the main menu—firmware updates require WiFi connectivity
Next steps
Once your OSSM is connected to WiFi, you can: