Here we'll present how to install a starter kit. At the end of this tutorial you'll have a stream of sensor data arriving at your PC/server ready to be processed by any of our open source software.
Select your starter kit and follow the instructions below:
You should have in front of you the following kit:
If you don't already have Node.js installed, be sure to do so first! Installation is easy on all platforms. We recommend you select the LTS version.
Take care to stick it in the right hole! Seriously, watch the video and read on...
Plug the reelceiver into the hub so that the Hub → arrow points towards the hub. Note that the reelceiver will still power on if it's connected in the wrong orientation, but it will not communicate with the hub.
Plug the other end of the hub into a free USB port on your PC or server. The reelceiver should power on as indicated by its blinking LED.
This tutorial assumes you have basic familiarity working from the console.
Create a new directory called reelyActive. Download server-usb.js to that directory.
Alternatively, create the server-usb.js file and paste in the following code:
var server = require('hlc-server'); // Import the package var app = new server(); // Fire up the server app.bind( { protocol: 'serial', path: 'auto' } ); // Listen on USB console.log('Browse to http://localhost:3001'); // Friendly reminder
The above code depends on our hlc-server package, as well as the serialport package in order to listen over USB. From the console, browse to the reelyActive directory you created. Then run the following two commands:
npm install hlc-server
npm install serialport
If you experience any problems with the latter, consult the serialport package documentation for specific instructions.
From the console, again from the reelyActive directory you created, run the following command:
node server-usb
Point your browser to http://localhost:3001 and you should be rewarded with a screen like this:
Click on the dashboard button for a visualisation of key system parameters.
Click on the bubblescape button for a visualisation of all devices detected by the reelceiver.
Click on the sensorscape button for a visualisation of the real-time sensor data from compatible devices (ex: Estimote Nearables) detected by the reelceiver.
Enter the 16-digit identifier of the reelceiver into the query box and then select from the pull-downs:
to discover what devices are detected by your reelceiver, in contextual and RTLS representations, respectively.
You should have in front of you the following kit:
If you don't already have Node.js installed, be sure to do so first! Installation is easy on all platforms. We recommend you select the LTS version.
Take care to stick it in the right hole! Seriously, read on...
Take the wall adapter provided with your kit and plug it into the mains. If you don't have access to a North American outlet, you'll need an adapter. Don't worry about the voltage, we've provided you with a kick-ass adapter with global compatibility and enough power to drive reely long reels with plenty of reelceivers.
Plug the barrel connector of the wall adapter into the receptacle on the hub's cable harness. You should hear a beeping sound. That's good!
Now we can connect the reelceivers in a daisy-chain configuration we call a reel. This is pure plug-n-play simplicity, just take into account the following:
Daisy chain all of your reelceivers to the hub (you'll need to supply the additional cables, any standard network cable will do). Each reelceiver's LED should blink if it is receiving power. Good job!
Connect one end of a network cable (not provided) to LAN2 on the hub, and the other end to a free port on your Ethernet switch. If the switch is DHCP-enabled, the hub will automatically obtain an IP address and be connected to your network.
That was easy! Next up: the joys of IP settings...
We'll now make two critical assumptions:
If that's not the case, please read this. Otherwise, open a browser window and log on to the hub by entering its IP address. The default login credentials are:
Select Serial - COM1 from the menu at left. Then specify the IP address of your PC/server as Destination IP Address 1. In the example below we selected 192.168.1.101.
Click Save & Apply. In a moment, packets will be routed to your PC/server via UDP.
This tutorial assumes you have basic familiarity working from the console.
Create a new directory called reelyActive. Download server-udp.js to that directory.
Alternatively, create the server-udp.js file and paste in the following code:
var server = require('hlc-server'); // Import the package var app = new server(); // Fire up the server app.bind( { protocol: 'udp', // Listen for UDP path: '192.168.1.101:50000' } ); // on this IP address console.log('Browse to http://localhost:3001'); // Friendly reminder
The above code depends on our hlc-server package. From the console, browse to the reelyActive directory you created. Then run the following command:
npm install hlc-server
From the console, again from the reelyActive directory you created, run the following command:
node server-udp
Point your browser to http://localhost:3001 (or to port 3001 on your server's IP address if not running locally) and you should be rewarded with a screen like this:
Click on the dashboard button for a visualisation of key system parameters.
Click on the bubblescape button for a visualisation of all devices detected by the reelceiver.
Click on the sensorscape button for a visualisation of the real-time sensor data from compatible devices (ex: Estimote Nearables) detected by the reelceiver.
Enter the 16-digit identifier of any reelceiver into the query box and then select from the pull-downs:
to discover what devices are detected by that reelceiver, in contextual and RTLS representations, respectively.
It is possible to directly connect your PC to the hub and receive the data stream. In this section we'll explain how.
Connect one end of a network cable (not provided) to LAN1 on the hub, and the other end to your PC. Now you'll need to change the IP address of your PC to 10.0.50.101. If you don't know how to do this, search the Internet for "How to change my IP address in OS" where OS is the name of your operating system.
Open a browser window and log on to the hub by entering its IP address: 10.0.50.100. The default login credentials are:
Select Serial - COM1 from the menu at left. Then specify the IP address of your PC as Destination IP Address 1: 10.0.50.101.
Click Save & Apply.
Select Network Settings from the menu at left. Then ensure that LAN1 is selected as Default Gateway.
Click Save & Apply. In a moment, packets will be routed to your PC via UDP. Now you can run server-udp.js taking care to specify 10.0.50.101:50000 as your path.
Our Pareto platform combines even more features and functionality with the convenience of SaaS.
With the hardware in place, you're ready to start exploring the capabilities of the reelyActive platform. Try reelyApp with the bubblescape and dashboard. See our Install an offline demo tutorial to facilitate demos even without Internet connectivity. Enjoy!