Skip to content

Latest commit

 

History

History
78 lines (54 loc) · 3.82 KB

README.md

File metadata and controls

78 lines (54 loc) · 3.82 KB
Raw

Getting Started

Welcome to RIOT, the friendly Operating System for the Internet of Things!

RIOT is a free, open source, real-time capable operating system developed by a grassroots community gathering companies, academia, and hobbyists, distributed all around the world. It supports most low-power IoT devices, microcontroller architectures (32-bit, 16-bit, 8-bit), and external devices. RIOT aims to implement all relevant open standards supporting an Internet of Things that is connected, secure, durable & privacy-friendly.

Pretty cool, right?

But before getting started with coding and real hardware, let's understand what is inside the RIOT Kit in front of you.

Photo of closed RIOT Kit

RIOT Kit Content

When opening the RIOT Kit, you will find the following content:

  1. Raspberry Pi already completely setup to be used as development machine throughout these exercises.
  2. Power Adapter for the Raspberry Pi
  3. Adafruit Feather Sense (RFM98 @ 433 MHz): an IoT device featuring wireless connectivity and many on-board sensors
  4. USB Cable to connect the Feather Sense to the development machine
  5. Adafruit LoRa Radio FeatherWing: an extension board for kilometer-range wireless connectivity using LoRa
  6. Jumper Cables (12x) to connect external devices such as LEDs or buttons to the Feather Sense
  7. Breadboard to build semi-permanent prototypes of electronic circuits

Photo of open RIOT Kit with numbered content

Hardware Setup

  • Power the Raspberry Pi (1) using the power adapter (2).
  • Connect the Feather Sense (3) to the Raspberry Pi (1) using the USB cable (4).

Photo of the Raspberry Pi (right) connected to the Feather Sense (left)

Software Setup

  • With your own computer, connect to the locally provided WiFi network:

    • SSID: hack_n_ack
    • Password: ThefriendlyOSfortheIoT

  • Open https://riot-raspi-ffffff.local:8080 in your browser, replacing ffffff with the six-digit identifier on the back of your Raspberry Pi

    • Your browser might warn you about the self-signed certificate on the Raspberry Pi. If so, click on "Advanced" and then on "Accept the Risk and Continue" (Firefox) or "Proceed to riot-raspi-ffffff.local (unsafe)" (Chrome).

      Screenshot of Firefox certificate warning Screenshot of Chrome certificate warning

  • When asked, provide the following credentials:

    • User: pi
    • Password: riottutorial

  • Cloud9 IDE should show up in the browser

    Screenshot of cloud9 IDE

The tutorial files are already preloaded. Cloud9 IDE lets you browse through the files using the directory tree on the left, write code and preview Markdown (such as this document) on the right, and access the console of the Raspberry Pi on the lower right.

Working with the RIOT Kit at home

If you want to work with the RIOT Kit at home, the easiest option is to connect the Raspberry Pi via Ethernet to your home router. Alternatively, you may add the credentials of your home WiFi to the Raspberry Pi as explained here: https://weworkweplay.com/play/automatically-connect-a-raspberry-pi-to-a-wifi-network/

If you prefer to develop without the Raspberry Pi on your own Linux machine, you can find the general instructions to set up your RIOT development environment and the specific ones for the Feather Sense in the RIOT documentation.