ENV+ Evaluation Kit Quick Start Guide

Have more questions? Submit a request

 

Welcome to the Everactive Developer Community! We are excited to have you.

In this article, we will outline the simple steps required to set up your Everactive Evaluation Kit.

 

Before opening the box, take the following steps:

  • Confirm system requirements
  • A Windows computer with Intel processor (recommended: 4 cores / 8 GB RAM) & internet connectivity
    • Macs with Intel processors are likely to work using VMWare Fusion but have not been fully tested
  • 2.5 GB of available storage for the gateway software file and VMware Player software
  • An available USB-A 2.0 (5VDC, 1A) port on your computer for max Evernet range
    • If your computer does not have USB-A 2.0 (5VDC, 1A) then we recommend using a powered USB Hub (to get full range of Evernet capabilities: 200m LOS)

  • Locate your user account login and password

    • Check your email for a message from developers@everactive.com with the subject line "Developer Account Created and First Steps"

  • Download the gateway software file

      • Gateway software note: what is exciting about this file is that you are downloading a virtual machine running Ubuntu Core, an OS specializing in headless, remote Linux Appliances. This is the same OS we run on production gateways, and by running the virtual machine, you are getting the same the experience of running one of our physical gateways as part of our managed service. Of note, this virtual machine receives automatic updates from our snap store, so it’s always running the latest gateway software -- without having to do anything!

    • Ok, back to the process!

    • Login to to insights.everactive.com with the username and password you received via email.  Look for a message from developers@everactive.com with the Subject Line, "Developer Account Created and First Steps"

    • After logging in, click the gear menu in the upper-right and select "Management"

      mceclip0.png

    • Click the tile for Evergateway Management

      mceclip0.png
    • Click on your gateway in the table (there should only be one entry)

    • Click the download VM Image button in the upper right:
      mceclip1.png
    • A zipped VM file will save into your downloads folder:
      mceclip1.png

 

Note on Evergateway VMWare files

Gateway VMWare files build a trust relationship between the guest OS and Everactive data brokers.  As a result, re-downloading the VM file, or moving it between computers will introduce instability.

If you're planning on changing your host machine (the machine where you installed VMWare player), contact developers@everactive.com to request a new VM image.  One will be provisioned for you, and will appear as a new gateway with a discrete serial number.

 

Getting Started:

A video version of the unboxing and physical setup:

 

Installation steps:

  1. Open the box, confirm that you have all the contents (listed on the notecard).

  2. Remove the Evergateway dongle from the box

    • Locate and attach the longer antenna to the Evergateway dongle

  3. Place Evergateway dongle into open USB port

    • You should observe a green light flash three times on the Evergateway dongle when USB connection initializes.

  4. Begin Evergateway dongle virtual gateway set-up

    • Ensure internet is connected

    • Ensure file has already been downloaded from insights.everactive.com using your account information

    • Follow the steps below:

Extract the Sunrise VM zip file. Right click and select “extract all“. Follow the prompts to completion.mceclip4.pngmceclip5.png

Open the Sunrise-SERIAL.vmx file with VMWare by clicking on "Open a Virtual Machine"

mceclip0.png

Press "Play virtual machine" to start the VM

mceclip1.png

You may see this warning. The Sunrise VM functions correctly with side-channel mitigations enabled. Click “OK“

mceclip1.png

Share the “Sundance“ removable device

mceclip2.png

 

You may see a prompt like the one below, click OK.

mceclip3.png

 

Allow it to boot up, and self-configure. This process will take about 5-10 minutes

When boot up is complete, the console window will display the following:

mceclip4.png

 

5. With the virtual gateway installed, log into the Developer Console using any modern web browser at: http://insights.everactive.com

  • Using the account information provided to you by Everactive Developer Success.  Not seeing the account info?  Email developers@everactive.com.

  • Click the tile labelled Evergateway Management to see the gateway status
    mceclip0.png

  • If the virtual gateway installation was successful, Last Evergateway status should display the following status:

    mceclip2.png

     

    • If gateway status shows offline, proceed to walk through virtual gateway install and ensure gateway dongle LED indicator is green.

     

  • Gateway installation is complete! Now, you can move onto setting up your sensors.

Sensor Setup

  • Remove the 2 ENV+ Eversensors from the box
    • Locate and attach the two shorter antennas to the Eversensors

  • After the antennas are attached, place the Eversensors in a well-lit environment.

    1. Standard office lighting is sufficient.

    2. You can roughly measure light levels with a lux meter mobile application.

      • We recommend a lux level >150 lux although the sensor can power itself with as low as 100 lux.

  • Look for sensor wake-ups once a minute, or shake the sensor to send an unsolicited wake-up.
  • Navigate to the sensor details page to see the available data and sensor status.

Getting started with the API

If you would like to feed the data into your own application, navigate to the gear icon in the console, and click "Management." Of note, sensor data will be retained in developer's console and API for 7-days.

    • Click the tile for "API Credentials"mceclip1.png

Our full API documentation can be found here. Also see our GitHub for internally developed projects and other software modules we love.

 

Recommended Tests and Experiments

Now with sensor data flowing, we recommend testing out energy harvesting and run some fun experiments. Here are some experiments and tests to get you started.

 

Questions?  Check out the FAQs for this quick start guide:

Frequently Asked Questions / General Troubleshooting / Tips and Tricks

 

Provide us feedback and let us know how you have been using the Evaluation Kit

 

 

 

 

Articles in this section

Was this article helpful?
2 out of 2 found this helpful
Share

Comments

0 comments

Please sign in to leave a comment.