Wi-Fi

obniz Board is always connected to obniz Cloud through Wi-Fi.
Please see Spec for Wi-Fi specifications that can be used.

Wi-Fi on Startup

obniz Board tries to connect to Wi-Fi as soon as it is switched on. It will try below steps.

  1. Last connected Wi-Fi
  2. 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.

Wi-Fi Setup

You will be asked which way you want to configure Wi-Fi.

(For version below 3.0.0 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.)

  1. Using obniz Board switch and display
  2. 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.

2-2 Passowrd

On the same smartphone, Type and open webpage in your browser. URL is different in some obnizOS version

OSURL
obnizOS 3.0.2 or olderhttp://1.2.3.4
obnizOS 3.0.3 or laterhttp://192.168.0.1

Choose SSID from pull down and type a password for that.

To configure static ip, Press “Option Setting”.

You can configure Static IP

  • Static IP Address
  • SubnetMask
  • Gateway IP Address
  • DNS Server IP Address

You need to fill all of these parameters.

When you need to configure proxy server, fill belows

  • IP address of proxy server (obnizOS3.1.0 or later)
  • Port number of proxy server (obnizOS3.1.0 or later)

Then press “Connect” Button.
obniz Board start connection immidiately.

OSBrowser
obnizOS 3.0.2 or olderyour browser shows “can’t open page”.
obnizOS 3.1.0 or lateryour browser shows web page like below

When success, your board will be online and showing QR code on it’s display otherwise return to same state.

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.
See more at setting screen.

Checking Mac address

Connect obniz Board to power while pressing the switch to display the menu.
See more at setting screen.

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.

Protocol used by obnizOS are below

OSProtocol
obnizOS 3.0.2 or olderws://
obnizOS 3.1.0 or laterws:// or wss:// depends on Plan

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 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.

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.