Gravio Getting Started Guide

Table of Contents

1. Introduction
2. Downloading and Installing Gravio Studio and Gravio HubKit
   • 2.1. What is Gravio Studio?
   • 2.2. What is Gravio HubKit?
   • 2.3. Installation Procedure
   • 2.4. Verifying Gravio HubKit Operation
3. Key Concepts of Gravio Studio and Gravio HubKit
   • 3.1. Main Features of Gravio Studio
   • 3.2. Main Features of Gravio HubKit
   • 3.3. Server Connection
4. Login Accounts
   • 4.1. Types of Accounts
   • 4.2. Login Methods Based on License Status
   • 4.3. Managing Login Accounts
5. Troubleshooting Connection Issues
6. Creating Your First Action: Setting Up Email Functionality
   • 6.1. What is an Action?
   • 6.2. Steps to Create an Action Using the Mail Send Component
   • 6.3. Setting Up Triggers

1. Introduction

Welcome to Gravio! This guide explains the steps from setting up Gravio to creating your first Action. Gravio is a platform that connects IoT devices and utilizes edge computing and artificial intelligence.

2. Downloading and Installing Gravio Studio and Gravio HubKit

To use Gravio, you need two main software components. Let’s explain the role and installation method of each.

2.1. What is Gravio Studio?

Gravio Studio is a client application for managing and configuring the Gravio infrastructure. This application is used to set up sensors, create actions, and display data.

2.2. What is Gravio HubKit?

Gravio HubKit is an edge server software. It connects various inputs (sensors, etc.) and outputs, and processes data. It can be installed on the same computer as Gravio Studio or on a different computer (Mac, Windows, Linux) within the network.

2.3. Installation Procedure

Installing Gravio Studio

1. Windows users can install from Microsoft Store, and Mac users can install from App Store by searching for “Gravio Studio”.
2. For Windows users, it is recommended to install Gravio Studio before installing Gravio HubKit.

Installing Gravio HubKit

1. Download the HubKit for your operating system from gravio.com/en/download.
2. For Mac: Drag the downloaded HubKit to the Applications folder and launch it. Administrator password is required for installation.
3. For Windows: Double-click the downloaded file and follow the wizard instructions to install.
4. For Linux: Please refer to the official documentation for detailed instructions.

2.4. Verifying Gravio HubKit Operation

• For Mac: The Gravio icon will appear in the menu bar. Click it to confirm it shows “Running”.
• For Windows: Launch GravioTools and verify that the service is running from the taskbar (bottom right).

3. Key Concepts of Gravio Studio and Gravio HubKit

3.1. Main Features of Gravio Studio

Gravio Studio provides the following features:

• Setup and management of physical sensor devices
• Setting and monitoring of physical sensor locations
• Creation and configuration of actions triggered by sensor networks
• Creation and editing of action flows
• Display of sensor data

3.2. Main Features of Gravio HubKit

Gravio HubKit functions as an edge computing server and performs the following roles:

• Data collection from sensors
• Action execution
• Data processing and storage
• Integration with other systems

3.3. Server Connection

1. Launch Gravio Studio.
2. The server running HubKit may be automatically displayed.
3. If HubKit is installed on the same machine, you can connect using IP address “127.0.0.1”.
4. If installed on a different machine, enter that machine’s IP address.
5. Gravio uses HTTPS (port 443) for communication. Make sure this port is open.

4. Login Accounts

4.1. Types of Accounts

When accessing Gravio HubKit Web UI or Gravio Studio, you can use the following two types of accounts:

1. Local Account: An account registered and stored within the HubKit
2. gravio.com Account: An account created during signup at gravio.com

4.2. Login Methods Based on License Status

Before License Setup

• gravio.cloud server
  • This state does not occur as the license is automatically granted.
• Self-installed HubKit
  • First login is done with the local account “gravio”, which will prompt for password change. Change the password.
  • After that, you can log in with this local account.

After License Setup

• gravio.cloud server
  • This is the initial state as the license is automatically granted.
  • Can only be used with the gravio.com account [email address] used during server creation request.
  • The local account named “gravio” cannot be used.
• Self-installed HubKit
  • Can log in with either the gravio.com account used for license setup or HubKit’s local account.

After License Removal

• gravio.cloud server
  • This state does not occur as license removal is not possible for automatically granted licenses.
• Self-installed HubKit
  • Can only log in with HubKit’s local account.

4.3. Managing Login Accounts

You can log in to Gravio Studio or Gravio HubKit Web UI using the above accounts. Create local accounts as needed in the HubKit’s account page for operation.

5. Troubleshooting Connection Issues

If you encounter connection problems, check the following:

• Port Opening: Gravio uses HTTPS (port 443) for communication. Ensure it’s open in your firewall.
• Network Settings: Make sure the Gravio server and Gravio Studio are on the same network segment. If they’re on different segments, you’ll need to manually add the IP address.
• Service Status: Verify that the GravioHubKit service is running properly.

6. Creating Your First Action: Setting Up Email Functionality

Here, we’ll explain how to create a simple action using the email send component.

6.1. What is an Action?

An Action is like a small program consisting of steps. It can be triggered by sensor data and execute various processes.

6.2. Steps to Create an Action Using the Mail Send Component

1. In Gravio Studio, click the “Action Editor” icon to open the Action Editor.
2. Click the “+” button to create a new Action.
3. Enter an appropriate name (e.g., “Email Notification”).
4. Select “Mail Send” from the component list to add to the action.
5. Configure the following items:
   • SMTP settings (server, port, authentication, etc.)
   • Sender email address
   • Recipient email address
   • Subject
   • Email body (you can also use input payload)
6. In the “Premapping” section, configure attachments or HTML format as needed.
7. Press the “Play” button to test the Action.

6.3. Setting Up Triggers

After creating an email sending Action, you can set conditions to trigger this Action:

1. Open the “Trigger” tab.
2. Click the “+” button to create a new trigger.
3. Set conditions for executing the Action, such as sensors or schedules.
4. Select the created Action.

Now, emails will be sent automatically when the set conditions are met.