Wi-Fi

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.

  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

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, Open the page on your browser 1.2.3.4or http://1.2.3.4. 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
  • SubnetMask
  • 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".

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.

You will Get in Few Days

Circuit for Starter “obniz Board” is available on Amazon and other online stores.
You can get it at below

Our products and resellers

Forum

Visit our developer’s forum to discuss and discover technologies.

Forum

Contact

Feel free to contact out support and technical team.

Contact us