Document

obniz Hardware and cloud specifications.


Wifi

obniz board is always connected to obniz cloud through Wifi.

Please see Spec for Wifi specifications that can be used.

obniz board cannot be connected to obniz cloud under "VPN", "Proxy", and "Without DHCP" environment.

Wifi configuration procedure

obniz board tries to connect to Wifi as soon as it is switched on.
When available Wifi is not found, Wifi configuration screen appears on the display.

Wifi configuration

On Wifi configuration screen, first you will see animation that shows where the switch is, after which SSID list will appear. Password must be typed in using the switch after selecting SSID. See further details on Quick Start.

Reset Wifi configuration

obniz board stores as many Wifi 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 Wifi configurations.
Connect obniz board to power while pressing the switch to display the menu.
By choosing "Reset Wifi", obniz board will forget all Wifi 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 Wifi.
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".

See more details on cloud console.

Connection may get lost for various reasons (disconnection from Wifi, 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.

Local connection

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.