Skip to content

Latest commit

 

History

History
71 lines (47 loc) · 4.12 KB

out-of-box-guide.md

File metadata and controls

71 lines (47 loc) · 4.12 KB

Insight on Things Desktop Application

Out of Box Guide

Required Tools and Applications

Downloading the installer

The first step to running the Insight on Things desktop application is to downoad the current install for your OS. The installers can be found here.

We have build and tested the Insight on Things Desktop Application on the following OS's:

OS Version
OS X & macOS 10.11.x or greater
Windows Windows 7 (64 bit) and Windows 10 (64 bit)

NOTE: If you have installed a previous version of the Insight on Things desktop application then you will need to remove the old data file as the format has changed. Use these instructions to remove the .insight file from your computer.

Required AWS Account

To run this demo you will need to have, or have access to, an Amazon Web Service (AWS) account. To learn more about AWS, click here. You should also check with your company's HR and/or IT for policies on using cloud based accounts, or to see if you have a corporate AWS account that should be used.

Access to this account with admin level is preferred but not required. To lean how to setup and admin user in AWS see this tutorial.

NOTE: If you are a Microchip Employee we have a corporate AWS account that must be used. To setup your AWS IoT device please email [email protected] for more information.

Running the Demo

Setting up AWS IoT and configuring the board

  1. Connect the target demo board to the computer via USB and power on the board

  • Make sure you have firmware version 2.0.0 or greater on the target board.

  • Open the Insight on Things desktop application

    • The first time that you run the you should see the following setup screen

    Insight on Things Setup Screen

  • Select the comm port that belongs to your target device

    • You should see the MAC address of the board automatically fill the second line when you hit the OPEN button

    Insight on Things MAC Address

  • Enter the AWS Access Key ID and AWS Secret Access Key for your AWS account.

  • Select what region you would like to setup the board to work in and then click the SETUP BOARD action button

    • You will see a progress bar as the AWS account is setup and the board is loaded with the required authentication information (All of this is being done over a TLS connection)

  • When this is done you can hit the SHADOWS button to interact with your target demo

    Insight on Things Setup Done

Interacting with the target board

  1. Once setup has been run on the target board, you now have a fully connect and secure connection to AWS IoT

  • Changing the potentiometer on the target board will cause the bar graph on the Insigt on Things desktop application to change
  • Pressing buttons on the board will cause the corresponding indicator on the Insight on Things desktop application to light up blue
  • Changing an LED on the Insight on Things desktop application will turn on the corresponding LED on the board

Troubleshooting

If you are having trouble connecting with AWS IoT and your thing, check to make sure that each of the issues bellow are resolved.

Connection Issue

  • Check that you have a valid internet connection on your network/access point.
  • Ensure that port 443 is open on your network/access point.

Target board LED codes