This quick start shows how to start using obniz Board from HTML.

Buy obniz Board

obniz Board is now available on some stores in the World. See Products.
obniz official store accept worldwide shipping.

Connect Wi-Fi

Upon receiving obniz Board, first connect it to Wi-Fi.

Wi-Fi should have DHCP and 2Ghz band.

(If you need a mac address of your obniz Board, plug your obniz Board to power while pressing the switch to display the menu. "DisplayInfo" shows the mac address.)

  1. Turn on the obniz Board by plugging in a micro-USB. (to shutdown, just unplug the cable)
    obniz Board will then show a image like below to show you where the switch is. Press the switch to proceed.
  2. obniz Board will show a Wi-Fi SSID list on its OLED. Choose one by moving the switch towards left or right, and confirm selection by pressing the switch.
  3. Type the password one by one by using the switch. When you finish, choose "END" to connect.
  4. QR code will appear on its OLED when successfully connected to Wi-Fi and obniz Cloud.

Activate Trial License

When you are using obniz Board with Hobby License 90-Day Trial, activate and start using trial license.

First, create an account on obniz Cloud for free. Then registrate your obniz Board to your account.


How to registrate your device

Remote Control obniz Board from the SDK through obniz Cloud

An onlined obniz can be controlled from the SDK we provide for some programming languages.
obniz.js is javascript one. It's opensource on Github. It will be installed by script tag in HTML or npm in nodejs.

It's documet can be seen this website /doc/sdk/README。 IO and Peripheral usages.
Visit Support to see examples and FAQs.

This lessons explain integration hardwares with HTML UI on Online HTML Editor.

Let's try!

Let's use obniz from the Web.

Almost all the examples of programs on this website have obniz id (8 digit numbers shown on obniz Board) form and execution button ("Test Run" or "Test Open").
The sample program below also has one.
Type in your obniz id and press "Test Run" or "Test Open", then the program will run on your browser.

Let's try below to check if your obniz Board is connected to the internet.

<!-- HTML Example -->
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <script src="https://obniz.io/js/jquery-3.2.1.min.js"></script>
  <script src="https://unpkg.com/obniz@2.4.0/obniz.js"></script>

<div id="obniz-debug"></div>

<input type="text" id="text" value="Hello World"></input>
<button id="showtime">Print on obniz</button>
<h3 id="state">Switch: unknown</h3>

var obniz = new Obniz("OBNIZ_ID_HERE");
obniz.onconnect = async function () {

  $("#showtime").on("click", function(){

  obniz.switch.onchange = function(state) {
    $("#state").text("Swtich: " + state);

By running with your obniz id, your browser will be connected to your obniz Board.
After establish, green bar will be displayed. It mean you can control it from your program.

This program display text what you input at form.
Input text then press the button "Print on obniz". The text will be displayed on your obniz Board display.

And swtich state is printed on the browser.
Toggle the switch on your obniz Board. It is used at Wi-Fi Password typing.
The state will be printed at "Switch: unknown" area at realtime.

Program will be terminated by closing the page.

It's easy to integrate internet and electronics.

If you know about HTML, you may imagine more fun things. Not only this site. Copy this HTML into your local HTML file. Then open it on your browser. It works.

Start writing your program

Let's proceed to next Lesson First Program.
Use obniz from your program!

Next : First Program

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


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



Feel free to contact out support and technical team.

Contact us