ReliaGATE 15A-14

Document Revision History

Applicable operating systems for this guide

To configure the ReliaGATE 15A-14 you need any PC with an operating system that features a modern web browser (Chrome recommended) and a SSH client to perform troubleshooting (i.e. Putty for Windows OS or ssh command line on Linux Shell or Windows Powershell)

Overview

The ReliaGate 15A-14 is purpose-built for industrial environments with its powerful processing ARM Quad-Core CPU and the ability to seamlessly connect to global networks and 5G Ready

The ReliaGATE 15A-14 supports internal modularity, to conveniently enable deep personalization options. Drawing feature sets from a library of standard modules, it is possible to add as many extra capabilities as needed; examples of modules include a LoRa Concentrator, a LoRa Node, Digital and Analog I/O expansions, extra Ethernet ports (SFP, RJ-45, SPE), a RedCap 5G cellular module, a precision GNSS module, and much more. For customers that require even more specific capabilities, Eurotech offers customization services that can meet any demand.

The ReliaGATE 15A-14 takes a novel approach at helping developers, devops and Infosec Officers in creating, securing, and administrating projects and fleets of devices throughout the entire lifecycle:

• Hardware developers can leverage on a platform that is feature rich, with a wide range of radio and wired interfaces, deeply certified and fully hardened against physical cyber-attacks. An additional benefits is the internal modularity of the product, which enables a high degree of configurations that can be created by combining a library of standard and custom modules at a fraction of the cost and time usually needed for a custom design.
• Application developers can accelerate dramatically the creation of their applications by leveraging the APIs and services provided by Everyware Software Framework (ESF), Eurotech’s Java/OSGi middleware for IoT Edge Gateways. ESF supports ready-to-use field protocols (including Modbus, OPC-UA, S7), MQTT connectivity, and web-based visual data flow programming.
• Developers of containerized solutions can leverage the native Docker support.
• CISOs find the best-in-class Cybersecurity: a secure platform that has been certified to ISASecure/IEC 62443-4-2 SL2 and PSA Level 1 with an always-on physical antitampering monitor/logger that is active even when the system is removed from power. Eurotech cybersecurity services provide updates that are timely delivered and easily applied to ensure constant protection throughout the product’s lifecycle.
• Cloud developers benefit from native connectors to Eurotech Everyware Cloud, AWS and other third-party Cloud services.
• Devops can speed up and simplify most tasks thanks to advanced diagnostics, Zero Touch Provisioning, full remote device access and management.

Hardware Description

Datasheet

• ReliaGATE 15A-14 Datasheet

Standard Kit Contents

Depending on the order code, you will receive the ReliaGATE 15A-14 ready to be powered on with no additional hardware. By ordering a DevKit with ESF, you may also order a Power Supply for your region, and the required accessories to start operating with your device.

Visit the product page for info on ordering codes.

• ReliaGATE 15A-14 Web page

User provided items

A PC (Windows, Linux or Mac OS) with an Ethernet port and an Ethernet cable or, where applicable, Wi-Fi(TM) to connect to the device.

3rd Party purchasable items

If not included in the DevKit, an AC-DC Power adapter, 24V, 24W is required.

Example items:

• Eurotech - 24W power supply accessory kit

Set up Your Development Environment

Operating System

Your ReliaGATE 15A-14 runs Eurotech Everyware Linux, an optimized version of Ubuntu Linux OS specifically aimed at supporting industrial environment.

Tools Installation

The ReliaGATE 15A-14 is distributed with the latest version of ESF already installed and ready to start.

In order to develop and deploy applications on ESF, you can follow the dedicated guides here.

If you need to build your native applications on this target hardware, please contact us to receive the latest toolchain.

Additional References

Detailed documentation on the features provided by the available services running on the ReliaGATE 15A-14 can be found in the ESF official documentation, here.

Set up Your Hardware

Front Side Overview

Antenna connector Side Overview

Setup Your AWS Account

Refer to the online AWS documentation at Set up your AWS Account. Follow the steps outlined in the sections below to create your account and a user and get started:

• Sign up for an AWS account and
• Create a user and grant permissions
• Open the AWS IoT console

Pay special attention to the Notes.

Create Resources in AWS IoT

Refer to the online AWS documentation at Create AWS IoT Resources.

Follow the steps outlined in these sections to provision resources for your device:

• Create an AWS IoT Policy
• Create a thing object

Pay special attention to the Notes.

Install the AWS CLI

To install the AWS CLI on your host machine, refer to the instructions at Installing the AWS CLI v2. Installing the CLI is needed to complete the instructions in this guide.

Once you have installed AWS CLI, configure it as per the instructions in this online guide. Set the appropriate values for Access key ID, Secret access key, and AWS Region. You can set Output format to "json" if you prefer.

Alternatively, you can use the AWS CloudShell to send the same AWS CLI commands directly from your browser.

AWS IoT Core Connection

This section provides a guide on connecting an ESF device to the Amazon Web Services (AWS) IoT platform. This guide covers the usage of the ESF Cloud Connector for AWS IoT Core and other integrations with AWS IoT services like AWS Greengrass.

Prerequisites

In order to connect a device to AWS IoT Core, the following prerequisites are needed:

• An AWS IoT account
• A device with ESF version 3.3 or greater installed

Provision the Device with credentials

AWS IoT Core supports three types of provisioning:

• Single Thing Provisioning
• Just In Time Provisioning (JITP)
• Bulk Provisioning

You can find detailed instructions on Single Thing Provisioning in the ESF documentation website, here. JITP, Just In Time Registration and Bulk Provisioning require custom setup, usually involving a discussion with one of our Solution Architects. Please feel free to contact us if you need to enable JITP, JITR or Zero-Touch Provisioning on your Eurotech device.

Connectors Available

Two alternative ways can be used to connect to AWS IoT Core from ESF:

• Using the ESF Cloud Connector for AWS IoT Core (Requires ESF 6.1.0+)
• Configuring the Generic ESF MQTT Connector (Requires ESF 3.3.0+)

Both ESF Connectors support all three provisioning techniques.

Completing device provisioning is a prerequisite before an IoT device can successfully connect to AWS IoT Core.

Running the demo

ESF Wires can be leveraged to create a simple demo flow to test the connection to AWS IoT Core.

• Open the ESF Web Console, by accessing ESF from your browser.
• Login with your credentials (default credentials can be found in the ESF documentation)
• Navigate to the Cloud Connections section of ESF

Once your Eurotech device is connected to IoT Core, the relevant ESF Cloud Connector will look as follows:

• Click on "New Pub/Sub" and select a new AwsThingPublisher from the list. Assign it a name (e.g. demo.publisher)

A new Thing Publisher will be associated to this Cloud Connection. Select the newly created publisher and configure it with a unique topic (e.g. demo.topic)

• Navigate to the Wires section
• Add to the Canvas a Timer component and a Publisher component
• Link the components together
• Configure the Publisher component to link to the previously created AWSThingPublisher

• Apply the changes

Verify messages in AWS IoT Core

AWS IoT Core will receive periodic timer events directly from the ESF Wire Graph.

• Go to IoT Core in the AWS Console
• Activate the MQTT test client
• subscribe to the topic configured in the AWSThingPublisher (e.g. demo.topic)

Debugging

The Eurotech device default development configuration is meant to ease access and debugging.

• Ethernet Port ETH0 is configured as DCHP Server with a IPv4 address of 172.16.0.1.
• Ethernet Port ETH1 is configured as DHCP Client.

SSH protocol is enabled on standard port TCP 22 with, with guest user access. Password is the serial number of the unit, which you can find on the product label. To access the system, run:

ssh guest@<IP Address>

You can use the eth_journalctl command to access the aggregated logs of the system:

eth_journalctl -help

Use these links for detailed information on log management and debugging.

Depending on the order code used for your Eurotech device, the system might already be set up for production environments. Refer to the ESF Security introduction to know more about framework execution modalities.

Troubleshooting

For any issue you might face when working with ESF, feel free to contact the awesome Eclipse Kura community here. Chances are the issue you are facing has already been solved!

For detailed documentation, browse the ESF documentation.

If you need support for IoT Core, here it's a link to the FAQs.

And finally, should you need even more support, feel free to open a ticket on our ticketing system.