Infrastructure Setup

From this section of the Platform, you have the possibility to specify the physical infrastructure of your system. These steps are necessary to register your infrastructure inside the Platform, so that all development and deployment operations can be performed without accessing the physical hardware. The Platform differentiate three categories of nodes that can be registered using the menu on the upper part of the screen:

infrastructure setup buttons
  1. cloud: virtual machines deployed inside Azure cloud

  2. local: edge nodes that handle connection from sensor devices. Work as gateways and are able to perform part of the computation locally.

  3. sensor: are equipped with sensors and run a RTOS. They connect to the respective father local node and are able to perform computation locally.

For each node creation, the status of the device will transition between three status:

  1. preparing: the platform is creating its internal resources and interfacing to your cloud resources to handle the device;

  2. wait first connection: resources are ready and the platform is waiting for the device to connect for the first time to the Platform.

  3. ready: device is ready to be used inside the Platform. From this moment on, all the operations on this devices are handled inside the Platform.

Local nodes setup

Local nodes can be created using the specific button on the upper part of the page.

local node setup

You are requested to specify a device name - from which the platform automatically generates a Device Id - and a hostname that is required to the children of the local node to identify it. Finally, you need to specify the Local node type among the supported ones.

Note

The hostname must be reachable by the local node where its children are connected.

local node setup

Once the details are specified you can confirm the creation of the node, and the Platform will start creating the device. The local node will be registered in your cloud account as an edge device, and its status on the Platform transitions to preparing. After the Platform concludes its internal processing, it is ready to accept the first connection:

local node setup

The local nodes needs to go through two setup steps to automatically connect to the Platform

  1. Install the base OS with required software (this operation needs to be performed once per device)

  2. Execute an installation script to setup credentials and configurations of the device (this operation needs to be performed every time the device is connected to a new project in the platform)

Both steps are described - for each supported device - by clicking on SETUP INSTRUCTION.

local node setup instruction

Note

The provided installation script is specific for each local node that is created

After the final setup command has been executed on the node, it automatically reboot and connects to the Platform. Once the device is connected you will see its status updated.

local node ready

You can also force the Platform to check for new connections by using the top button RUN CONNECTIVITY CHECK

Sensor nodes setup

Sensor nodes can be created only after creating a first Local node, and needs to have a Local node as parent. The process to create a Sensor node, is similar to the one for creating a Local node.

create sensor board

For your convenience, the platform already provides a MAC Address for the device. Specify the name and the parent of the sensor board, and click CREATE to register it to the Platform.

The Platform automatically generates a Base Firmware that you will need to flash on the device to connect it to the Platform.

sensor board setup instructions

The setup instructions contains all the steps on how to download the base firmware and install it to the sensor board.

Note

The provided Base Firmware is specific for each sensor node that is created.

Once the sensor board is flashed, it can automatically connect to the Platform.

Cloud nodes setup

Cloud nodes are the easiest to create.

cloud node install

Specify the Device Name, and the Platform will automatically create a virtual machine in your cloud resources and launch the installation script to register it to the Platform.