The settings cannot be made at any time. You need to switch to a mode that allows you to do so. The way to switch depends on the configuration method.
Automatic Setup Mode
By default, obnizOS automatically enters Setup Mode for approximately 30 seconds if it fails to connect to a previously saved network.
Applicable to OS7 and later
Starting with obnizOS version 7, you can disable this automatic transition to Setup Mode via the configuration JSON file.
When this feature is disabled, the device will no longer enter Setup Mode automatically unless there are no existing network settings or Setup Mode is manually triggered by pressing the onboard button.
Benefits of Disabling Automatic Setup Mode
- Prevents unintended configuration changes: Avoids accidental access to settings by unauthorized users.
- Minimizes offline time: Reduces the duration the device stays in a non-functional setup state during network fluctuations.
Important Considerations
Please be cautious when disabling this feature if the device is installed in a hard-to-reach location.
In the default mode, if the device cannot connect to a network, it automatically launches its own Wi-Fi Access Point (Setup Mode). This allows you to reconfigure the network settings simply by being within Wi-Fi range of the device. If this feature is disabled, changing the network settings on-site will be significantly more difficult if you cannot physically reach the device's buttons.
Configuration from console
This configuration is done via serial communication (UART).
To enter the setting mode, you need to send a command. The characters of the command and the timing of sending it vary depending on the OS version.
| OS | How to change setting mode |
|---|---|
| < 3.5.0 | When sending a single s character at startup (or immediately after) |
| 3.5.0 <= | 4 letters of menu sent at any time after startup |
Starting with OS 3.5.0, you can switch to setting mode at any time by sending menu. In setting mode, all systems except settings will be stopped (e.g. network connection).
If you leave the device in configuration mode for too long, it will automatically reboot and return to normal operation.
Configure from browser
In this mode, the device itself outputs Wi-Fi, and you can connect to that Wi-Fi with your PC or smartphone and configure it from the browser.
| OS | How to change setting mode |
|---|---|
| All Version | - Press and hold the button at startup (or immediately after) - If you are unable to connect to any of the stored network settings. |
When in configuration mode, the obniz device will output a password-free Wi-Fi with the following SSID from itself
obniz-XXXXXXXX
(XXXXXXXXX is the obnizID of the device)
Connecting with a smartphone or PC will automatically launch a browser (OS 3.5.0 or later). If the browser does not open(OS3.5.0 or later).
Configure from the display
If your device has a display component, such as obniz board, it can accept settings from the display under the following conditions.
| OS | How to change setting mode |
|---|---|
| All versions | - Press and hold the button at startup (the startup option will be activated) - If you cannot connect to any of the stored network settings (obniz Board series only) |
In the case of the display only, holding down the button at startup will activate the startup option that allows you to perform a minimal reset process.
For obniz Board series, you can use "Simple Method" which allows you to select SSID and enter password from the screen.
Wi-Fi Settings with WPS
From OS3.5.0
- Set the device to the purple flashing setting mode.
- press and hold the button for 3 seconds. The purple light will blink faster.
- Press the WPS button on your Wi-Fi router or access point to complete the Wi-Fi setup.
- the device will reboot once completed, and the blue light will turn on when it connects to Wi-Fi and comes online successfully