obniz Board is always connected to obniz Cloud through Wi-Fi.
Please see Spec for Wi-Fi specifications that can be used.
obniz Board cannot be connected to obniz Cloud under "VPN" and "Proxy" environment.
Wi-Fi on Startup
obniz Board tries to connect to Wi-Fi as soon as it is switched on. It will try below steps.
Last connected Wi-Fi
A Wi-Fi in scan result which have being configured.
When available Wi-Fi is not found, Wi-Fi configuration screen appears on the display.
On Wi-Fi configuration screen, first you will see animation that shows where the switch is, after which SSID list will appear. You can configure Wi-Fi with below methods.
Using obniz Board switch and display
Connect and configure by connecting obniz Board via Wi-Fi (obnizOS 2.1.0 and later)
1. Using obniz Board switch and display
Password must be typed in using the switch after selecting SSID. See further details on Quick Start.
2. Connect and configure by connecting obniz Board via Wi-Fi (obnizOS 2.1.0 and later)
obniz Board is available as Wi-Fi access point at this time. By connecting it Wi-Fi, choosing SSID and typeing password is done on a smartphone.
2-1 Connect to obniz Board Wi-Fi
It SSID is obniz-XXXXXXXX. Connect to that SSID.
On the same smartphone, Open the page on your browser 126.96.36.199or http://188.8.131.52. Then configration page will appeaer.
Choose SSID from pull down and type a password for that. Then press "Connect" Button. obniz Board start connection immidiately and your browser shows "can't open page". When success, your board will be online otherwise return to same state.
To configure static ip, Press "Option Setting".
You can configure
Static IP Address
Gateway IP Address
DNS Server IP Address
You need to fill all of these parameters.
Reset Wi-Fi configuration
obniz Board stores as many Wi-Fi configurations as its capacity allows. When it reaches the limit, the configurations will be deleted from the oldest one.
You can also manually delete all Wi-Fi configurations. Connect obniz Board to power while pressing the switch to display the menu. By choosing "Reset Wi-Fi", obniz Board will forget all Wi-Fi configurations.
Checking Mac address
Connect obniz Board to power while pressing the switch to display the menu. Choose "DisplayInfo" to show mac address.
Handshake and always-on connection
obniz Board tries as much as possible to maintain connection to obniz Cloud through configured Wi-Fi. The first step is "handshake". When connecting to the cloud, obniz will use obniz id and private key that are pre-installed in our factory (public key is already configured in obniz Cloud) to be certified by obniz Cloud.
The only protocol option is WebSocket(ws://). Also, the communication is not in JSON, but rather in the protocol unique to obniz Cloud.
You can configure "Region" for each obniz Board. By choosing the nearest region, you can reduce latency when using cloud API. By default, it is set as "East Asia".
Connection may get lost for various reasons (disconnection from Wi-Fi, trouble with ISP, obniz Cloud maintainance, etc.) When this happens, obniz Board will try to reconnect automatically. Also, when one of the entire region in obniz Cloud becomes unavailable, it will try to connect to the other region.
obniz Board will accept WebSocket connection after cloud connection is established. By using SDK, you can establish direct P2P connection to obniz Board automatically. This P2P communication gets managed by the cloud only if obniz and the client are on the same network, and obniz Board IP gets notified to SDK.
With the latest firmware(1.0.4), the only protocol option is WebSocket(ws://). Also, the communication is not in JSON, but rather in the protocol unique to obniz Board cloud.