Configure an Owl-in-One

Our step-by-step guide to configure the WiFi and/or program the software of an Owl-in-One.

Configure an Owl-in-One

The TL;DR (Too Long; Didn't Read)

Learn how to configure an Owl-in-One to connect to a wireless network and forward data to the right place.


What will this accomplish?
An Owl-in-One with network connectivity forwarding data to the target server(s).
Do I need to do this?
Only if you require a different configuration than the default.
Is there an easier way?
You can request custom WiFi and target settings when ordering these devices.

Prerequisites

A computer with Node.js, npm and the t2-cli utility installed.

Configuring the WiFi   Step 1 of 4

Connect the Owl-in-One to the WiFi network.


What are we programming?
The Owl-in-One is based on the Tessel 2 platform and is programmed as such.
Any prerequisites?
Yes. This step requires a computer with the t2-cli package (see above).
Configuring the WiFi of an Owl-in-One

Connect to the Owl-in-One via USB Part 1

From the computer with the installed prerequisites :

  1. Connect the USB cable of the Owl-in-One to the computer
  2. Wait approximately 30 seconds for the device to boot     30 sec

The Owl-in-One is now ready to accept commands.

Connect to the WiFi network Part 2

From the same computer , open a terminal and then:

  1. Configure the WiFi with the command t2 wifi -n "ssid" -p "password", replacing ssid and password with the appropriate credentials

If the command does not complete in a timely fashion, terminate with Ctrl+C and run the command again.

If the SSID or password includes a special character (ex: "exclamation!"), escape this with a forward slash (ex: "exclamation\!") for the command to be interpreted correctly.

Confirm the WiFi connection Part 3

From the same computer , and in the same terminal :

  1. Query the connection status with the command t2 wifi
  2. Observe from the terminal output the intended SSID and confirm that the Owl-in-One has received an IP address.
Owl-in-One t2 wifi

The Owl-in-One is now connected to the WiFi network.

Downloading the Owl-in-One software   Step 2 of 4

Clone the tessel-edge software repository from GitHub and install the dependencies.


What software?
The Owl-in-One runs lightweight Node.js software.
Any prerequisites?
Yes. This step requires git and npm.
Do I do this each time?
No. Complete this step just once to program as many Owl-in-Ones as required.
Cloning and installing tessel-edge

Has this step already been completed on the computer? If so, skip this step!

Clone the tessel-edge repository Part 1

From the computer satisfying the prerequisites, open a terminal and then:

  1. Browse to a folder where the software will be cloned
  2. Clone the tessel-edge repository with the command git clone https://github.com/reelyactive/tessel-edge.git

The tessel-edge software is now cloned to the computer.

Install package dependencies Part 2

From the same computer , and in the same terminal :

  1. Browse to the root of the tessel-edge repository
  2. Install dependencies with the command npm install

The tessel-edge software now has all package dependencies installed.

Configuring the Owl-in-One software   Step 3 of 4

Configure the software and flash it to the Owl-in-One.


Do I need to do this?
Complete this step only if a change to the Owl-in-One's configuration is required.
Any prerequisites?
Yes. This step requires a computer with the tessel-edge software downloaded (see previous step).
Configuring an Owl-in-One's tessel-edge software

Update targets Part 1

From the computer with the downloaded tessel-edge software, open a terminal and then:

  1. Browse to the root of the tessel-edge repository
  2. Open the file config.js for editing
  3. Update the RADDEC_TARGETS as below, changing the "xxx.xxx.xxx.xxx" to the target IP address or hostname
const RADDEC_TARGETS = [
    { host: "xxx.xxx.xxx.xxx", port: "50001", protocol: "udp" }
];

The Owl-in-One can send to multiple targets. Add as many as required to the array (ex: [ { }, { } ]).

The tessel-edge software is now configured to forward data to the target IP address(es). Let's program the Owl-in-One!

Flashing the software to the Owl-in-One   Step 4 of 4

Connect the Owl-in-One via USB and flash the configured software.


Do I need to do this?
Again, complete this step only if a change to the Owl-in-One's configuration is required.
Any prerequisites?
Yes. This step requires a computer with the t2-cli package (see above).
Flashing an Owl-in-One with tessel-edge

Connect to the Owl-in-One via USB Part 1

From the same computer :

  1. Connect the USB cable of the Owl-in-One to the computer
  2. Wait approximately 30 seconds for the device to boot     30 sec

The Owl-in-One is now ready to accept commands.

Push the software to the Owl-in-One Part 2

From the same computer , open a terminal and then:

  1. Browse to the local tessel-edge repository
  2. Push the software to the Owl-in-One with the command t2 push index.js     30 sec
Owl-in-One t2 push

If the command does not complete in a timely fashion, terminate with Ctrl+C and run the command again.

The software will begin to run, and will start automatically whenever the Owl-in-One is powered on.

Do you like this document template?

It's based on Bootstrap 4   MIT and Font Awesome 5 (Free)   MIT. Our Web Style Guide   MIT has all the details. Sharing and feedback are encouraged!

  reelyActive's Web Style Guide

Where to next?

Continue exploring our open architecture and all its applications.