Quick start

From an empty account to a working device

Five steps, about twenty minutes, and nothing to install on your computer. Everything below happens in a browser — or in the mobile app, if you would rather start from your phone.

What you need

  • Any ESP32 board — a plain dev kit is enough
  • A USB cable that carries data, not only power
  • A browser: Chrome, Edge or Opera, which can talk to a USB port
  1. 1

    Create an account

    Open cloud.r1bbit.com. Fill in a name, an email and a password — or skip all of that and sign in with Google or Apple in one click. There is nothing to confirm by post and no card to enter.

    The mobile app uses the same account, so you can register there instead and everything will already be in place when you open the browser.

    cloud.r1bbit.com — the Sign Up tab
    cloud.r1bbit.com — the Sign Up tab
  2. 2

    Add the board and flash it

    Plug the board into a USB port and add it in the cloud. The browser writes the firmware itself — no toolchain to install and no drivers to hunt for. Once it restarts, the board finds the cloud on its own and appears in your list.

    This is the only step that needs a cable. Everything after it travels over the air.

    Adding the first board
    Adding the first board
  3. 3

    Take a ready example

    Open the editor and press Load Template. Each template is a whole working program with its own CONFIG block, so you start from something that already runs instead of from an empty file. Take the ADC example under GPIO & Peripherals: it reads an analog pin and prints the value, and it needs nothing wired to the board.

    Do not look for a template that matches your board — look for one that matches your wiring. The CONFIG block describes the peripherals, not the model.

    The gallery filtered to GPIO — the ADC example is the one we take
    The gallery filtered to GPIO — the ADC example is the one we take
  4. 4

    Send it to the board

    The template leaves the pin as a placeholder, so put in a real GPIO number for your board. Then, marked 1 on the picture, choose the board in the Device list and press Connect; marked 2, press Upload to Device and then Script Start. The script reaches the board in a couple of seconds over an encrypted link — nothing is compiled, so nothing can fail to compile.

    A wrong line stops the script and says why in the terminal. Fix it and send again — the board stays online the whole time.

    1 — choose the board and connect, 2 — send the script and start it
    1 — choose the board and connect, 2 — send the script and start it
  5. 5

    Watch the result

    The terminal on the right starts filling up: a new pair of lines twice a second, straight from the board. Nothing is plugged into your computer — the board is talking to you through the cloud, and it would do the same from another building.

    Printing is only the simplest output. Publish a value with VARS_PUBLISH and it also becomes a tile on the dashboard and in the mobile app.

    The terminal with live output from the board
    The terminal with live output from the board