Toggle navigation

EdgeServer

Version 1.0.0

– Bridge all your devices to software applications

– Translate anything on the edge

– Deploy IoT solutions faster

– Scale with no limits

 

 

BACK TO DOCS CENTER                     DOMATICA WEBSITE

EdgeServer is a powerful IoT Middleware Platform for embedded systems. It enables edge translation and interoperability among different devices and technologies. EdgeServer delivers equalized data to the application layer enabling customized integrations and fast deployment of IoT solutions.

The Domatica EdgeServer provides ease of device connectivity, management and data collection activities.

With a high scalable deployment technology and business application integration, it adds unlimited resources and services to IoT solutions.

The Domatica EdgeServer Broker for Northbound connections and the Domatica EdgeServer Node for Southbound connections are the main components of the Domatica EdgeServer Platform.

EdgeServer Node

The Domatica EdgeServer Node is the lower layer component of the Domatica EdgeServer Platform.

It’s an ultra-lightweight IoT edge software that runs on any ARM, MIPS, X86_32 and X86_64 device, that provides Edge Computing capabilities to subsystems by adding intelligent local processing.

EdgeServer Broker

The Domatica EdgeServer Broker is the upper layer component of the Domatica EdgeServer Platform which enables connectivity to any IT ecosystem (PaaS, SaaS, APPs) through its Services interfaces subsystems.

Domatica Portal

Domatica Portal is an Administration portal for EdgeServer’s asset management.

Here you have full access to all your EdgeServer installed arround the world and wherever you are.

Domatica Portal

Systems

A System identifies your project, whether it is a zone, department, store, factory or a building. Give it a name so it can be easily identified.

In one system you can have endless EdgeServers associated and you can send configuration to all EdgeServers in a system, at the same time.

Connector Engines

Connector Engines are EdgeServer’s engines for southbound and northbound connectivity.

Southbound Connector Engines enable the connection with field standard protocols and I/O devices.

Northbound Connector Engines enable the connection with IoT services.

Examples of northbound Edge Server Connector Engines:

REST

MQTT

AMQT

CoaP

FTP

 

Examples of southbound Connector Engines:

Modbus

Profinet

BusPro HDL

KNX

DMX

 

Connectors

A Connector describes a specific operation of a connection based on a particular Connector Engine. Examples:

  • A REST Connector (i.e: Azure) for northbound connection to a specific cloud service;
  • A specific Energy Meter Connector (i.e.: ABB A41) for Southbound connection using Modbus protocol.

Shapers

Shapers is a feature that allows the data of the connected device to be handled in a way that the user understands.

Without shaper, data from the device will be in raw format.

Things

A Thing is any device, equipment or data source that provides a Tag.

Tags

A Tag is a single variable/register of a Thing (device), and that data depends on each device specifications. For instance a temperature probe can provide one tag, although a Modbus environmental sensor can provide more than 20 tags/registers.

Dataflow

The Dataflow is a powerful tool that allows you to create business rules using available Things and CodeBlocks in an user friendly environment.

Start using our portal with your EdgeServer in a quick and easy way following these steps:

1 - CREATE YOUR ACCOUNT

Register Your Account

Go to http://portal.domatica.io/register to create an account, by filling out the form.

2 - INSTALL EDGESERVER ON YOUR DEVICE

When you enter your account for the first time, you will be promped to add your first EdgeServer immediately. The same thing happens when you have no EdgeServer in your Entity.

Otherwise, to start Adding EdgeServer Process, click the Add EdgeServer button at the top right corner.

 

2.1 - Add a New EdgeServer

2.1.1 – Choose the device you will use from the list of certified devices. You can use the search bar to speed up things.

2.2 - Install EdgeServer

To get a valid Register Code you must install the EdgeServer Seed on your device.

2.2.1 – Execute, in your device, the command shown and the EdgeServer will install and registration process will start.

2.2.2 – Choose the directory or path where to install. If the directory does not exists, it will be created. If left blank, the EdgeServer will be installed in a folder named “EdgeServer” in current directory.

Also choose if you want to install EdgeServer as a service.

2.2.3 – After install, you’ll get a 6 digit registration code, and a counter of 15 minutes will start. This is the time you have to register your EdgeServer at the portal. After that, registration for your EdgeServer will be unavailable.

2.2.4 – Insert the Registration Code in the portal and the process will finish. You can check the terminal to ensure everything went well.

2.2.5 – After successful install, go back to the Portal to finish the process.

 

 

3. 1 - Deploy your first project

After you have done the Claim and Install EdgeServer steps, you are now ready to define and deploy your EdgeServer:

3.1.1 – On “Name”, select a name for the EdgeServer

3.1.2 – On “ Choose a Template”, you can choose one the of following template options to start your project right away as a:

  • “Blank Project” – start your own project from scratch.
  • “Raspberry Pi” – start from a Raspberry sample project.
  • “Linux PC” – start from a Linux PC sample project.
  • “DQN Gateway Pro3” – start from a DQN Gateway sample project.

If it’s your first time here, we recommend start using a sample project to get instant access to your device data. You can visualise sample project real-time data by following the next steps, or if using REST API see “REST API” in this document menu here.

3.1.3 – Then, on “System” associate the EdgeServer to a new system or to an existing system.

3.1.4 – Finally, on “Provider” choose your Broker provider and then select “Finish” to start deploying your project.

You are ready to start using your device, click on your System name to enter and click on “Deploy” button to send the configuration to your EdgeServer.

3.1.5 – Confirm the Deploy when resume form is shown, by clicking “Deploy” button, and deploy will start.

3.1.6 – To visualize real-time data go to “Things” on the left sidebar menu.

3.1.7 – In the List select the Things you want to visualize real-time data and click on “Info” option.

NOTE: If you choose a Template Project, you shortcut the following steps.

 

3.2 - Create a New System

3.2.1 – Create New Systems on the main menu, by clicking on “+” signal 

3.2.2 – Then define a name for the New System

 

Free Account Plan is limited to one System. To add more Systems you need to choose another subscription plan (see Pricing).”

3.3 - Connectors

Once created the System you can now configure which Connectors to use.

Connectors represent the southbound devices you want to connect to your EdgeServer.

 

3.3.1 – On the left bar menu select “Connectors”.

3.3.2 – Then, on the top left  click on “Add Connector” button.

3.3.3 – Select what type of Connector you want to configure, for instance, the Modbus connector.

 

3.4 - Modbus Connector

3.4.1 – From Modbus connector list select the equipment you want to connect to EdgeServer. For example ABB M2M modbus (Lite 3.0).

There are a lot of options to choose from. Use the search bar to speed up things.

3.4.2 – Define the Modbus communication parameters as well as which EdgeServer will use this connector.

3.4.3 – Each Modbus device has it own “Shaper” where you can select which Modbus registers (Tags/variables) to use. You can select all registers or just the ones you need.

 

3.4.4 – After selecting which “Tags” to use, confirm all device configurations and then click on “Finish” to proceed.

3.5 - Dataflow

3.5.1 – Select Dataflow option on the left side bar menu.

3.5.2 – The “Dataflow” will allow you to create business rules and define data forwarding rules. Dataflow business rules will be executed on the EdgeServer Node, using edge computing features.

3.6 - Deploy your Project

3.6.1 – Click on “Deploy” button on the top left menu to deploy the project.

The Deploy process will send all previously defined settings to all EdgeServer Nodes on your System. So you need to follow the steps described below:

3.6.2 – Check all configurations associated to EdgeServer and choose wich EdgeServers you want to deploy to.

3.6.2 – You may deploy the project by selecting the option “Pack and Send” or just to “Pack” to download the project to an offline EdgeServer.

3.6.3 – Then, select “Deploy”.

 

3.7 -  Real-Time Data Visualisation

3.7.1 – To visualise real-time data go to “Things” on the left sidebar menu.

 

3.7.2 – In the List select the Things you want to visualise real-time data and click on “Info” option.

3.7.3 – Then click refresh on the value you want to see. Values will update automatically on change .

 

 

Tutorials are project configurations that can be used to speed up your first interaction with Domatica’s EdgeServer.

Raspberry Pi 3 Tutorial

Tutorial: “EdgeServer on Raspberry Pi 3”

In this tutorial you will be able to use a push button to control a LED with your Raspberry Pi 3 using Domatica’s EdgeServer.

1 – What you will need:

  • Rasperry Pi 3
  • 4GB or larger microSD card
  • Ethernet cable
  • 2A micro USB power supply
  • Push button
  • LED light diode

2 – Setup:

  • Install a standard Debian version on the microSD card;
  • With no power on the board, connect the push button between a 5 Volts pin and the GPIO 16 (check the image on Connections menu);
  • Connect the light between a GND pin and the GPIO 20 (check the image on Connections menu);
  • Insert the ethernet cable. The Raspberry Pi 3 must be connected to the Internet;
  • Power the Raspberry Pi 3;
  • Enter on the Raspberry Pi 3 software using your or the default credentials

3 – Connections:

3.1 – The Push Button connection on Raspberry Pi is as follows:

3.2 – The LED light connection on Raspberry Pi is as follows:

4 – Add EdgeServer

4.1 – Go to http://portal.domaticasolutions.com/register and login. If you are not registered yet please sign up for an account.

4.2 – After login, click the button “Add EdgeServer”. 

4. 3 – Choose the Raspberry Pi 3 option and click “Next”.

 

4.4 – A Linux command is shown, that you can copy and run in your Raspberry, or download the seed binary to run in your device. This will generate the registration code. You will have 15 minutes to complete the registration process.

After that, you have to restart the claim process all over again.

 

4.5 – Insert the registration code generated on your device and click “Next”.

4.6 – When choosing a Project, select the Raspberry Pi 3 Template. Choose also the System Name and the Provider (Domatica EdgeServer as default selection).

 

4.7 – At this point you are ready to start using your device. Click on your System name to enter and click on “Deploy” button to send the configuration to your EdgeServer.

4.8 – Confirm the Deploy configurations when resume form is shown. By clicking on the “Deploy” button, the deploy process will start.

 

4.9 – As you can see, the Button +  Led and the Core Metrics connectors have been created automatically.

4.10 – Also, the dataflow that links the push button and the LED light have been created automatically.

 

4.11 – To visualize real-time data of your Raspberry Pi 3 go to “Things” tab on the left sidebar menu, and select the Things you want to visualize real-time data and click on “Info” option.

4.13 – On Properties tab, select the Tag you want to see by clicking on “Monitoring”.

Linux PC Tutorial

Template “EdgeServer on Linux PC”

In this guide you will be able to quickly create a simple configuration for your Linux PC using Domatica’s EdgeServer. In short, this is what you will do:

  • Use the PC keyboard to control the PC buzzer
  • Visualize the PC buzzer status
  • Visualize the PC keyboard key pressed (in ASCII)

1 – What you will need:

  • Linux PC
  • Ethernet cable

2 – Setup:

  • Insert the ethernet cable. The Linux PC must be connected to the internet;
  • Power the Linux PC;
  • Enter on the Linux PC software using your credentials

3 – Using a Template Project

When creating your system, you can choose to use a ready-to-use template for your Linux PC, so you can start using it right away. To do so, follow these instructions.

3.1 – Go to http://portal.domaticasolutions.com/register and login. If you are not registered yet please sign up for an account.

3.2 – After login, click the button “Claim Edge Server”. 

3. 3 – Choose the Linux PC option and click “Next”.

3.4 – Copy command to run on your Linux machine.

3.5 – On the Linux PC, run the copied curl command to generate the registration code.

3.6 – Insert the registration code generated on your device and click “Next”.

3.7 – When choosing a Project, select the “Linux PC Template”.

3.8 – Choose the System Name and the Provider (Domatica EdgeServer as default selection).

3.9 – At this point you are ready to start using your EdgeServer on your PC. Click on your System name to enter and click on “Deploy” button to send the configuration to your EdgeServer.

3.10 – Confirm the Deploy configurations when resume form is shown. By clicking on the “Deploy” button, the deploy process will start.

3.11 – The keyboard and buzzer connectors have been created automatically.

3.12 – Also, the dataflow that links the PC keyboard and the PC buzzer have been created automatically.

3.13 – To visualize real-time data of your Linux PC go to “Things” tab on the left sidebar menu.

3.14 – In the List double click the PC Keyboard thing  or chose “Info”.

3.15 – Hit your keyboard and you see the thing value changing with the key number you are pressing.

 

Domatica REST Connector API

Please contact us with your questions or suggestions trough a support ticket:
New Ticket

 

Frequently Asked Questions

Domatica EdgeServer is the Ultimate Technology for IoT Edge Enablement. It is an ultra lightweight middleware for the IoTspace that works as an Application Enablement Platform (AEP), which helps developers to build, integrate and manage their solutions extremely fast.
EdgeServer translates all your devices with really zero coding features and connect them into your software application delivering real-time and historical data. Scale and deploy your IoT projects extremely fast. Save time, resources and money and keep focused on your business.
Domatica’s EdgeServer is an ultra-lightweight software that runs on ARM, X86_32, X86_64, Windows or Linux and it is certified to run on the market major IoT Gateways.
EdgeServer footprint can be as low as 500Kb (MIPS) up to 6Mb (ARM)
If it is Linux based, try adding it as a “Standard Linux”. If this option does not suit you, send us an email to support@domatica.pt  with the datasheet of your gateway. As all IoT Gateways must be certified by us you should send the device so we could test it in our laboratory. 
You do not have to worry about scalability, since the EdgeServer is designed to enable an unlimited growth. You can manage hundreds of millions of things.
As many as you need. However, the Free edition is limited to one.
Up to 8000 Things, but it will depend on the selected gateway.
Data retention is one year. For larger periods please contact us (sales@domatica.pt)
It is always possible to add new devices to the Connectors list. Please send an email to sales@domatica.pt with datasheet and registers list.
You can add new IoT services using our REST API (find it here)
Yes, it’s possible. Please send an email to sales@domatica.pt with the description of your needs.
Free edition does not have support, however, you can consult all the technical documentation available at docs.domatica.io. For other editions, you can start from Standard Support or upgrade to Advanced Support. Please contact us at sales@domatica.pt.
Yes, it is completely free. Credit card is not required and there are no hidden costs. Just sign up and get started.

Have more questions?

Contact us!!!