Texas Instruments Sub-1 GHz Sensor-to-Cloud Linux E14 Kit User manual

1
SWRU533–October 2017
Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
Getting Started Guide
SWRU533–October 2017
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
This guide provides steps to run the out-of-box Sensor-to-Cloud example. This kit allows you to view and
control sensors on a Sub-1 GHz network from the cloud. All the devices in the kit are preprogrammed with
required software. The kit includes two methods of operation: a cloud-connected gateway and a local
gateway. The cloud-connected gateway lets you leverage cloud services such as Amazon Web
Services™ (AWS) and IBM Watson®Internet of Things (IoT). The local gateway lets you run a gateway
within a local IP network for privately managed networks that do not require external connectivity. It is
important to note that the design lets you quickly add any desired cloud service.
Kit Contents
• 5-V Power Supply
•BeagleBone Black
•BeagleBone Wireless Connectivity Cape
• FTDI Cable
• Preflashed MicroSD
• 2× TI SimpleLink™ CC1350 LaunchPad™
• 2× Micro-USB Type B Cable
Contents
1 Hardware Setup.............................................................................................................. 2
2 Running the Demo........................................................................................................... 2
3 Running Local Gateway..................................................................................................... 4
4 Running Cloud Gateway.................................................................................................... 5
5 Using Amazon Web Services (AWS) ..................................................................................... 7
6 Using IBM Quickstart........................................................................................................ 9
7 Using IBM Cloud Service.................................................................................................. 10
7.1 Download and Install Cloud Foundry CLI...................................................................... 10
7.2 Open IBM Bluemix Account...................................................................................... 10
7.3 Create a Service................................................................................................... 11
7.4 Upload the Provided Cloud Foundry Application.............................................................. 15
7.5 Launching the Demo.............................................................................................. 17
8 Troubleshooting ............................................................................................................ 19
8.1 Sensor Will Not Join the Network............................................................................... 19
8.2 How to Determine if the Sensor is Connected to a Network ................................................ 20
8.3 BeagleBone Black Will Not Connect to a Cloud Service..................................................... 20
8.4 Local Gateway Fails to Start..................................................................................... 20
9 Next Steps................................................................................................................... 21
9.1 Get More Details on the Software Design ..................................................................... 21
9.2 Sensor Examples.................................................................................................. 21
9.3 SimpleLink™ Sub-1 GHz Embedded Sensor-to-Cloud Gateway........................................... 21
9.4 Support ............................................................................................................. 21

USB connecting BBB &
LaunchPad
5 V Power Supply BBB + WiFi
Connectivity Cape
Hardware Setup www.ti.com
2SWRU533–October 2017
Submit Documentation Feedback
Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
Trademarks
SimpleLink, LaunchPad, Sitara, E2E are trademarks of Texas Instruments.
Amazon Web Services is a trademark of Amazon Web Services, Inc.
IBM Watson is a registered trademark of IBM Corporation.
Bluemix is a registered trademark of IBM.
Linux is a registered trademark of Linus Torvalds.
Wi-Fi is a registered trademark of Wi-Fi Alliance.
All other trademarks are the property of their respective owners.
1 Hardware Setup
The BeagleBone Black (BBB) comes equipped with a BeagleBone Wireless Connectivity Cape and a
preinserted microSD card with necessary software. Connect the BBB to the CC1350 LaunchPad labeled
MAC co-processor as shown in Figure 1. Connect the 5-V power supply to the BBB and an electrical
outlet. The CC1350 LaunchPad labeled Sensor in Figure 1 should be connected to any USB power
source using the provided USB cable.
Figure 1. Sensor-to-Cloud Hardware Setup
2 Running the Demo
The BBB operates out of the box as a Wi-Fi®access point with SSID: SitaraAP. Connect to the network
with a PC by using the password: sensor-to-cloud. Once connected, open a browser and type in the
address bar: http://192.168.43.1:1310. This opens the Sensor-to-Cloud welcome page hosted on the BBB
(see Figure 2).

www.ti.com Running the Demo
3
SWRU533–October 2017
Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
Figure 2. Sensor-to-Cloud Welcome Page
Select the method of operation for the demo:
• Cloud Gateway (see Section 3)
The Cloud Gateway allows you to monitor and control the Sub-1 GHz network using AWS or IBM
Cloud Service. The IBM Quickstart method is easy and requires no setup, while other methods require
additional steps.
• Local Gateway (see Section 8)
The Local Gateway is the best method to start with. This method allows you to monitor and control the
Sub-1 GHz network using a local IP network for privately managed networks that do not need external
connectivity.
Figure 3. Sensor-to-Cloud Main Portal

Running Local Gateway www.ti.com
4SWRU533–October 2017
Submit Documentation Feedback
Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
3 Running Local Gateway
Clicking Local Gateway automatically redirects to the TI 15.4-Stack Example Application - Collector
Application after a short delay (see Figure 4).
Figure 4. Selecting Local Gateway
1. Select open to allow the sensor to join the network.
2. Power on the sensor, if not done so already. The sensor will automatically join the network.
NOTE: If the sensor does not connect automatically, see Section 8.1.
Figure 5. TI 15.4-Stack Linux Gateway Example Application

www.ti.com Running Cloud Gateway
5
SWRU533–October 2017
Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
3. The sensor is now reporting data to the Sub-1 GHz gateway and allows you to control and visualize
data on a local cloud platform. Use the Red LED option to control the red LED on the CC1350
LaunchPad labeled Sensor.
NOTE: There may be a few seconds of delay with the Toggle command.
4 Running Cloud Gateway
To run a Cloud Gateway, the BBB must be connected to the Internet.
1. Click Cloud Gateway.
2. The BBB can be connected through ethernet or Wi-Fi.
a. If you are using a Wi-Fi connection, skip to Step 3.
b. For ethernet connections, attach an ethernet cable to the ethernet port on the BBB. You should
see Ethernet in the Network Connection Status as seen in Figure 6. Next, skip to Step 4.
Figure 6. BBB Ethernet Connection

Running Cloud Gateway www.ti.com
6SWRU533–October 2017
Submit Documentation Feedback
Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
3. To begin a 10-second network scan, select the drop-down menu adjacent to the SSID labeled Click
here to scan for available networks. Select from the list of available networks and provide the
Network Key. Selecting Remember Network causes the BBB to automatically connect to the selected
network when possible. This is true even after the device has been reset.
Figure 7. Internet Connection Configuration
4. After successfully connecting to the Internet, select the desired cloud service (see Figure 8). The Local
Gateway option may be selected even though it does not require an Internet connection. Amazon Web
Services is provided through stackArmor.
Figure 8. Cloud Service Selections

www.ti.com Using Amazon Web Services (AWS)
7
SWRU533–October 2017
Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
5 Using Amazon Web Services (AWS)
Use the following steps for Amazon Web Services:
1. Section 2 and Section 3 should be followed before continuing here (see Section 2 and Section 3,
respectively).
2. Request credentials from stackArmor.
If approved, stackArmor will provide the security credentials necessary for the steps that follow.
3. Use Choose File to select the security credentials received from stackArmor.
4. Click Submit to upload the selected files.
Figure 9. Uploading Security Credentials
5. After uploading the security files, select Start AWS Gateway. You will be prompted to enter the
username and password provided through email from stackArmor.

Using Amazon Web Services (AWS) www.ti.com
8SWRU533–October 2017
Submit Documentation Feedback
Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
6. You will automatically be redirected to the AWS IoT Dashboard through stackArmor, as shown in
Figure 10.
Figure 10. Internet-of-Things (IoT) Dashboard
6. Power-on the sensor, if this is not already done. The sensor automatically joins the network and
appears in the Network Chart and Sensor Nodes table, as shown in Figure 10.
NOTE: If sensor does not connect automatically, see Section 8.1.
7. The sensor is now reporting data to the Sub-1 GHz gateway and allows you to control and visualize
data through AWS. Use the Toggle option to control the red LED on the CC1350 LaunchPad labeled
Sensor.
NOTE: There may be a few seconds of delay with the Toggle command.

www.ti.com Using IBM Quickstart
9
SWRU533–October 2017
Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
6 Using IBM Quickstart
Section 2 and Section 3 should be followed before continuing here (see Section 2 and Section 3,
respectively).
Selecting IBM Quickstart launches the IBM Watson IoT Platform.
NOTE: Currently, IBM Quickstart does not support a way to send commands from the cloud to the
Sub-1 GHz gateway.
Figure 11. IBM Quickstart
1. Power on the sensor, if not done so already. The platform automatically detects the sensor, and the
web page updates with a list of sensor data.
NOTE: If sensor does not connect automatically, see Section 8.1.
2. From the list of sensor data, select a sensor data point to see its value graphed. In Figure 12,
smart_objects.temperature.0.sensorValue is selected.
Figure 12. IBM Quickstart Graph
3. The sensor is now reporting data to the Sub-1 GHz gateway and allows you to visualize data through
IBM Quickstart.

Using IBM Cloud Service www.ti.com
10 SWRU533–October 2017
Submit Documentation Feedback
Copyright © 2017, Texas Instruments Incorporated
Sub-1 GHz Sensor-to-Cloud Linux®E14 Kit
7 Using IBM Cloud Service
7.1 Download and Install Cloud Foundry CLI
Use the steps that follow to install the Cloud Foundry CLI tool on your PC.
1. On your PC, download and install the program from Cloud Foundry CLI.
2. Verify installation by typing the command cf on the command line terminal. You should see output
similar to that shown in Figure 13.
Figure 13. S2C IBM cfTool
7.2 Open IBM Bluemix Account
If you do not have an IBM Bluemix®account, you must open one and use the steps that follow.
1. Create an IBM Bluemix account and register for a 30-day trial account.
2. Confirm the Bluemix account using the link provided by IBM through email.
3. Log into the Bluemix account page that is shown in Figure 14.
Figure 14. Sensor-to-Cloud IBM Bluemix