System components configuration

Edge Data Store (EDS (Edge Data Store)) components are Modbus TCP EDS (Edge Data Store) adapter, OPC UA (Open Platform Communications - Unified Architecture) EDS (Edge Data Store) adapter, and the Storage component. These components are only active if they are configured for the system to use them. EDS (Edge Data Store) itself needs only a small amount of configuration - the list of components and the HTTP (Hypertext Transfer Protocol) Port used for REST (REpresentational State Transfer) calls.

The default System_Components.json file for the System component contains the following information:

[

{

"ComponentId": "Storage",

"ComponentType": "Storage"

}

]

The Storage component is required for EDS (Edge Data Store) to run and only one Storage component instance is supported. Each Modbus TCP device needs a separate Modbus TCP EDS (Edge Data Store) adapter component instance to connect to EDS (Edge Data Store), and each OPC UA (Open Platform Communications - Unified Architecture) device needs a separate OPC UA (Open Platform Communications - Unified Architecture) EDS (Edge Data Store) adapter component instance to connect to EDS (Edge Data Store). Multiple Modbus TCP EDS (Edge Data Store) adapter component instances and the OPC UA (Open Platform Communications - Unified Architecture) EDS (Edge Data Store) adapter component instances are supported.

Add system components

To add system components:

1. Using any text editor, create a JSON (JavaScript Object Notation) file with a ComponentId and ComponentType. The following example adds a Modbus TCP EDS (Edge Data Store) adapter instance.

   Definition: Modbus TCP, Transmission Control Protocol, is a Modbus variant used for communications over TCP/IP networks, connecting over port 502. It does not require a checksum calculation, as lower layers already provide checksum protection.

   {

   "ComponentId": "Modbus1",

   "ComponentType": "Modbus"

   }

   Note: The ComponentId must be a unique value. This example uses the ComponentId "Modbus1," since it is the first Modbus TCP EDS (Edge Data Store) adapter.

   Definition: Modbus TCP, Transmission Control Protocol, is a Modbus variant used for communications over TCP/IP networks, connecting over port 502. It does not require a checksum calculation, as lower layers already provide checksum protection.

2. Save the JSON (JavaScript Object Notation) file with the name AddComponent.json.

3. From the same directory where the file exists, run the following cURL (Client for URL) script or EdgeCmd utility:

   curl -d "@AddComponent.json" -H "Content-Type: application/json" http://localhost:5590/api/v1/configuration/system/components

   edgecmd add components -type Modbus -id Modbus1

   After the command completes successfully, the new component is available for configuration and use.

Parameters for system components

The following parameters are used to define system components.

System components example

[

{

"componentId": "OpcUa1",

"componentType": "OpcUa"

},

{

"componentId": "Modbus1",

"componentType": "Modbus"

},

{

"componentId": "Storage",

"componentType": "Storage"

}

]