QuickStart

Buy obniz

obniz is now available on multiple stores. See Products.
obniz official store accept worldwide shipping.

Connect Wi-Fi

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

Wi-Fi should have DHCP and 2Ghz band.

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

  1. Turn on the obniz by plugging in a micro-USB. (to shutdown, just unplug the cable)
    obniz will then show a image like below to show you where the switch is. Press the switch to proceed.
  2. obniz 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.

Remote Control obniz from the SDK

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) 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 is connected to the internet.

<!-- HTML Example -->
<html>
<head>
  <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.2.0/obniz.js"></script>
</head>
<body>

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

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

  $("#showtime").on("click", function(){
    obniz.display.clear();
    obniz.display.print($("#text").val());
  });

  obniz.switch.onchange = function(state) {
    $("#state").text("Swtich: " + state);
  }
};
</script>
</body>
</html>

By running with your obniz id, your browser will be connected to your obniz.
After establish, green bar will be displayed. It mean you can control your obniz 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 display.

And swtich state is printed on the browser.
Toggle the switch on your obniz. 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