QuickStart

Buy obniz

obniz is now available on Official Online Store.
It is also available on the websites and stores listed on List of Stores.
We accept worldwide shipping.

Connect Wifi

Upon receiving obniz, first connect it to Wifi.

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 Wifi 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 Wifi and obniz cloud.

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.0.2/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 pres 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 Wifi 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 pgraom

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



Next : First Program