Quick Start Guide - Libelium · Quick Start Guide-2- ... Introduction AWS IoT is a managed cloud platform that lets connected devices easily and securely interact with cloud applications

Libelium-AWS Development KitQuick Start Guide

-2-

IoT Application Development Kit

INDEX

1. Identify the products ........................................................................................................................... 3

2. Open the box ........................................................................................................................................ 3

3. Identify Meshlium device and antennas ............................................................................................ 3

4. Antennas set up ................................................................................................................................... 4

5. Power set up ......................................................................................................................................... 4

6. Internet set up ..................................................................................................................................... 5

7. Checking data received at Meshlium ................................................................................................. 6

8. Now you can receive data ................................................................................................................... 7

9. Get Ready to send Data ....................................................................................................................... 7

10. Open the box ..................................................................................................................................... 7

11. Recharge Plug & Sense! ..................................................................................................................... 8

12. Antennas set up ................................................................................................................................. 8

13. Identify Plug & Sense! family ............................................................................................................ 9

14. Check connection diagram ............................................................................................................. 11

15. Sensors setup ................................................................................................................................... 11

16. Connect sensors ............................................................................................................................... 12

17. Connect Solar Panel ........................................................................................................................ 12

18. Turn ON Plug & Sense! ..................................................................................................................... 13

19. Checking if data is received ............................................................................................................ 14

20. Next Steps ........................................................................................................................................ 1420.1. Introduction .............................................................................................................................................................................1420.2. Obtaining a free trial ............................................................................................................................................................1520.3. AWS IoT Configuration ..........................................................................................................................................................16

-3-


1. Identify the products

2. Open the box

3. Identify Meshlium device and antennas

-4-


4. Antennas set upAntennas *

a) Dipole 5 dBi (Bluetooth, WiFi, XBee-PRO 802.15.4).

b) 4G / GPS (3 antennas for EU, US or BR models; 2 antennas for AU models).

c) Dipole 4.5 dBi (XBee 868LP, XBee-PRO 900HP).

(*) Number and type of antennas depend on the model purchased.

5. Power set up

-5-


6. Internet set up

Wifi Access:

• Connect to Meshlium Wifi AP - Meshlium_XXXX, - no password needed

• Access Meshlium IP 10.10.10.1/MeshliumManager using a Web Browser (IE, Chrome, Firefox) - User: admin - Password: libelium

Ethernet Access:

• Access Meshlium assigned IP/MeshliumManager using a Web Browser (IE, Chrome, Firefox) - User: admin - Password: libelium

• Meshlium will use DHCP to get the IP address from your router, check in your router the IP address given.

-6-


7. Checking data received at Meshlium

-7-


8. Now you can receive data

9. Get Ready to send Data

10. Open the box

-8-


11. Recharge Plug & Sense!

12. Antennas set up

-9-


13. Identify Plug & Sense! family

Smart Environment Ambient ControlSmart Environment PRO

Smart Agriculture Smart Cities PRO

-10-


Smart Water

Smart Security

Smart Parking Radiation Control

4-20 mA Current Loop

Smart Water Ions

-11-


14. Check connection diagram

15. Sensors setup

-12-


16. Connect sensors

17. Connect Solar Panel

-13-


18. Turn ON Plug & Sense!

-14-


19. Checking if data is received • Access to Meshlium as explained before in page 5-6. • To check that your Plug & Sense! is sending data, see the ID_Wasp. The ID_Wasp of each Plug & Sense! can be found in the

details sticker.

20. Next StepsCheck the following instructions for setting up Meshlium working with the AWS platform.

20.1. IntroductionAWS IoT is a managed cloud platform that lets connected devices easily and securely interact with cloud applications and other devices. AWS IoT can support billions of devices and trillions of messages, and can process and route those messages to AWS endpoints and to other devices reliably and securely. With AWS IoT, your applications can keep track of and communicate with all your devices, all the time, even when they aren’t connected.

AWS IoT makes it easy to use AWS services like AWS Lambda, Amazon Kinesis, Amazon S3, Amazon Machine Learning, Amazon DynamoDB, Amazon CloudWatch, AWS CloudTrail, and Amazon Elasticsearch Service with built-in Kibana integration, to build IoT applications that gather, process, analyze and act on data generated by connected devices, without having to manage any infrastructure.

For more information visit https://aws.amazon.com/iot

https://aws.amazon.com/iot

-15-


20.2. Obtaining a free trialThe Amazon Web Services (AWS) Free Tier is designed to enable you to get hands-on experience with AWS Cloud Services. The AWS Free Tier includes services with a free tier available for 12 months following your AWS sign-up date, as well as additional service offers that do not automatically expire at the end of your 12 month AWS Free Tier term.

Go to https://aws.amazon.com/free/ and select “Sign Up”.

Introduce your email, select new user and press “Sign in using secure server”.

Enter the information requested in the subsequent forms. You will have to enter your billing address and credit card information. You will not be charged unless your usage exceeds the free tier limits.

https://aws.amazon.com/free/

-16-


20.3. AWS IoT Configuration

20.3.1. Create a Thing

AWS IoT provides communication between Internet-connected things (such as sensors) and the AWS cloud. This enables you to collect telemetry data from multiple Waspmotes and store and analyze the data. A Thing is the entity created in the AWS dashboard for enabling the communication.

Sing in to your AWS Management Console

Select “AWS IoT”.

Press “Create a resource”.

-17-


Select “Create a thing”, enter a name to identify your Meshlium and press “Create”.

20.3.2. Connect a Device

When the “thing” is created you have to obtain the certificates and parameters necessary to communicate your thing using MQTT protocol.

Select “View Thing” and press “Connect a device”. Annotate the MQTT topic of your thing, you will need it later for connecting the MQTT client.

-18-


Select Embedded C, save the three credential files, and press “Confirm & start connecting”.

Annotate the parameters AWS_IOT_MQTT_HOST, AWS_IOT_MQTT_PORT and AWS_IOT_MQTT_CLIENT_ID and press the button “Return to Thing Detail”.

-19-


20.3.3. Amazon MQTT Client

You can use the AWS IoT MQTT client to check that your Meshlium is properly connected to your AWS IoT account. Your Meshlium publishes MQTT messages on topics. You can use the AWS IoT MQTT client to subscribe to these topics to see the content of these messages.

In the AWS IoT console, choose “MQTT Client”, type in the “client ID” your AWS_IOT_MQTT_CLIENT_ID, and then choose Connect.

Now you will subscribe to the topic on which your thing publishes. Choose “Subscribe to topic”, and in Subscription topic, type the previously annotated MQTT Topic, and then choose “Subscribe”.

-20-


Messages from your Meshlium will be displayed in the AWS IoT MQTT client.

20.3.4. Debugging

Change the log level in the configuration file:

/mnt/user/amazon/setup.ini

Change the parameter “log_level=0” to “log_level=4”.

Logs will be saved in the amazon log file:

/mnt/user/logs/amazon.log

Documents

Quick Start Guide - Libelium · Quick Start Guide-2- ... Introduction AWS IoT is a managed cloud platform that lets connected devices easily and securely interact with cloud applications