WiFi and Updates
Configure WiFi connectivity and install over-the-air firmware updates on your OSSM
The OSSM supports WiFi connectivity for over-the-air (OTA) firmware updates. This guide explains how to connect your OSSM to your home network and check for updates.
WiFi setup
Starting WiFi setup
Navigate to WiFi Setup
From the main menu, scroll to WiFi Setup and press the encoder to select it.
View connection instructions
The display shows:
- "WiFi Setup" header
- Instructions to connect to 'OSSM Setup'
- A QR code for quick connection
The QR code encodes: WIFI:S:OSSM Setup;T:nopass;;
Connect to the OSSM access point
On your phone or computer:
- Open WiFi settings
- Look for a network named OSSM Setup
- Connect (no password required)
Scan the QR code with your phone's camera for one-tap connection on supported devices.
Configure your home network
After connecting to the OSSM access point:
- A captive portal should open automatically
- If not, open a browser and navigate to
192.168.4.1 - Select your home WiFi network from the list
- Enter your WiFi password
- Click Save
The OSSM will attempt to connect to your home network.
Exit WiFi setup
Press the encoder or select Restart to exit WiFi setup mode. The OSSM will restart and connect to your configured network.
Verifying connection
After restarting, the OSSM will attempt to connect to your configured WiFi network. You can verify the connection by:
- Selecting Update from the main menu
- If WiFi is connected, you'll see "Checking for update..."
- If WiFi is not connected, you'll be redirected to WiFi setup
The OSSM doesn't display its IP address on screen. For advanced networking, you can find it in your router's DHCP client list or use network scanning tools.
Clearing WiFi settings
To connect to a different network or troubleshoot connection issues:
- Select WiFi Setup from the menu
- The previous network configuration will be overwritten when you save new settings
- Alternatively, reflash the firmware to clear all settings
Over-the-air updates
The OSSM can download and install firmware updates directly over WiFi, without connecting to a computer.
Prerequisites
- Active WiFi connection (configured via WiFi Setup)
- Internet access from your network
- Sufficient battery/power during the update process
Checking for updates
Navigate to Update
From the main menu, scroll to Update and press the encoder.
Wait for version check
The display shows "Checking for update..." while the OSSM contacts the update server.
The firmware sends its current version (SW_VERSION) to the server, which responds with whether an update is available.
Review result
You'll see one of two screens:
No update available:
- "No Update Available" message
- Press the encoder to return to the menu
Update available:
- "Updating OSSM..." message
- Update begins automatically
During the update
Do not power off or disconnect your OSSM during an update. This can corrupt the firmware and require manual recovery.
The update process:
- Downloads the new firmware binary (~1-2 MB)
- Verifies the download integrity
- Writes the firmware to flash memory
- Restarts the device automatically
The display shows: "Update is in progress. This may take up to 60s."
After the update
The OSSM restarts automatically after a successful update. It will:
- Boot with the new firmware
- Perform the homing sequence
- Return to the main menu
Your settings and WiFi configuration are preserved across updates.
Update channels
The OSSM firmware supports multiple update channels:
| Channel | URL | Description |
|---|---|---|
| Production | d2g4f7zewm360.cloudfront.net | Stable releases for general use |
| Development | d2oq8yqnezqh3r.cloudfront.net | Pre-release versions for testing |
The update channel is determined at compile time. Production firmware checks the production server; development firmware checks the development server.
Troubleshooting
- Ensure you're in WiFi Setup mode (screen shows QR code)
- Move closer to the OSSM
- Try refreshing your device's WiFi list
- Restart the OSSM and try again
- Open a browser manually and navigate to
192.168.4.1 - Disable mobile data on your phone temporarily
- Try a different device
- Verify your WiFi password is correct
- Ensure your network is 2.4GHz (ESP32 doesn't support 5GHz)
- Check that your router allows new devices
- Try moving the OSSM closer to your router
- Verify WiFi is connected (try WiFi Setup first)
- Check your internet connection
- The update server may be temporarily unavailable
- Try again in a few minutes
- Ensure stable WiFi signal during update
- Move closer to your router if needed
- Verify your internet connection is working
- Try again with a fresh power connection
This is rare but can happen if the update was interrupted. Recovery options:
- Try power cycling (unplug and replug power)
- If the device doesn't boot, you'll need to reflash via USB using PlatformIO
Technical details
Update server communication
The OSSM sends a POST request to the update server with:
{
"ossmSwVersion": "x.y.z"
}The server responds with:
{
"response": {
"needUpdate": true
}
}If needUpdate is true, the firmware downloads the binary from the firmware distribution server.
Firmware binary locations
| Channel | Binary URL |
|---|---|
| Production | d2sy3zdr3r1gt5.cloudfront.net/firmware.bin |
| Development | d2sy3zdr3r1gt5.cloudfront.net/firmware-dev.bin |