soracom hands-on series: soracom harvest

Hands-on Series SORACOM Harvest

Introduction

SORACOM Harvest (Harvest) is a service to collect and accumulate data from IoT devices. By using mobile communication provided by SORACOM Air, sensor data, position information, etc. can be easily accumulated on the "SORACOM" platform on the cloud without troubles through mobile communication. Received time and SIM ID are automatically added to the saved data and it can be graphed and browsed in the user console of "SORACOM" or acquired via the API. The uploaded data will be saved for 40 days.

Reading materials for BEAM: •  Service Overview •  Getting Started – Harvest

Resources

Laptop

Wi-Fi Hotspot/ Personal Hotspot

AIR SIM Global SETUP used

• Putty • Packet Sender • Command Prompt •  Internet browser

IoT Platform

Visualization Simulation of IoT Device (*)

Cellular Network

* This setup is for demonstration & testing purpose only. The SIM should reside in the IoT device to secure communication.

Pre-requisite Hands-on Series: •  Getting Started •  SORACOM AIR

Now log on to https://console.soracom.io/

1.  Open the SORACOM console at https://console.soracom.io/ . 2.  Check the Air SIM you want to communicate with SORACOM Harvest. 3.  Select [Change group] from the [Action] button.

Create a group (via Actions menu)

Create a group (via Actions menu)

1.  Select [Create…] 2.  Enter the group name, e.g. “hello soracom” and click [Create]

Choose a group (via side bar)

1.  From the console side menu bar 2.  Select [Groups] 3.  From the group list, choose “hello soracom”.

1.  Click the switch in the [SORACOM Harvest setting] group, change it to ON, and click the Save button.

Turn on Harvest

Send data via HTTP

1.  Open the terminal in your laptop 2.  Send an HTTP POST request to the Harvest entry point. You need to

specify the data type with content-type. ----------------------------------

curl -v -X POST -H 'content-type:application/json' -d '{"temperature":20}' http://harvest.soracom.io

Visualize data accumulated in Harvest

1.  Open the Air SIM management screen and check the air SIM that communicated by SORACOM Harvest. Next, select [Harvest data] from the [Action] button.


1.  The screen showed up, the data is not loaded yet. 2.  Press the [Search] button, the saved data will be displayed.


1.  Send other sets of data in the terminal, for example, “temperature”:22, “temperature”:21, etc; curl -v -X POST -H 'content-type:application/json' -d '{"temperature":22}' http://harvest.soracom.io

curl -v -X POST -H 'content-type:application/json' -d '{"temperature":21}' http://harvest.soracom.io 2.  Press the [Refresh] button, the saved data will be updated.


1.  The saved data are also shown in the table under the graph.


1.  Press [Auto refresh] button, your chart will be updated every 5 minutes.

Disable Harvest

1.  Click the switch in the [SORACOM Harvest setting] group, change it to OFF, and click the Save button.

soracom hands-on series: soracom harvest

Technology