| Section | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Workflow
The basic work flow consists of four steps.
| Tip | ||
|---|---|---|
| ||
Create Component Instance (CI) → Create Site Template from CI → Assign Site Template to Location → Customize Location |
Detailed Workflow
- Create a Component Instance, this is a "child" of the component template and holds individual model information
- Create a Site Template, this is derived from the component and holds custom configuration such as the device parameters (e.g. Modbus address, registers), automation rules, calibration or special thresholds. A best practice is to create one site template for each location that has similar hardware sensors/devices/components installed.
- Assign the Site Template to the location (remote site)
- Customize the Location Site Template for the Location, these settings (e..g specific IP address) override the basics of the site template and are specific to one location.
Create a Component Instance
An existing component is the base of a new instance. You can use the generic Modbus TCP component as a template to create your individual instance that matches the setup of the device, e.g. number of inputs and outputs and the register settings.
...
- Go to Config/Provisioning→ Comp. Instances.
- Click + Add button and a new view will be opened listing existing components.
- Select Generic Modbus TCP I/O Device and set the name, here ADAM-6050, for the New Instance.
- Click Add or Add and Edit button that will create new component instance and close the modal window or navigate to instance editor page.
Customize the Component Instance
Model (but not location specific) parameters such as the Modbus register for the inputs and outputs are defined in the component instance. These settings are always the same for this particular model.
Digital Inputs
- Go to Config/Provisioning→ Comp. Instances.
- Locate the instance ADAM-6050 and click Edit
- Select Toggle S/U Normal Mode to open the editable view as a super user.
- Navigate in the left hand component tree to Sensors → Digital_Input_1
- Open in the element tree (right hand) sensor → sensors_gateway → demux → keys → key
- Set the register to 101 in the Value row and click
| Tip |
|---|
Repeat this step for each input and set the proper Modbus registers. |
Digital Outputs / Actions
The digital outputs in our example can be switched on/off by writing a 0 (OFF) or a 1 (ON) into the coil register per output. This is a Modbus command (see step number 6).
...
| Tip |
|---|
Repeat this step for the ON and OFF command for each output (element {{action.commands.command.@command_id}}) and set the proper Modbus registers. |
Create a Site Template
The previously created component instance is the base for a new site template.
...
- Go to Config/Provisioning → Site Templates.
- Click + Add and when modal window opens set your Name, a good practice is to set this according to your location name, here Berlin-101 and save your changes.
- From Site Templates table, find your newly created Site Template and click on the Edit button.
- Select Toggle S/U Normal Mode to open the editable view as a super user.
- Click + Component button, a new view opens where the base component will be selected
- Select the Instances tab and choose ADAM-6050
- All included objects, such as sensors or actions, are now listed. Select the ones required and click add for every input (here 12) and output (here 6) of the device.
- Select and add the Actions for your digital outputs. There will allow you to remotely switch those outputs later on (e.g. in Admin Live Table)
The new sensors and action are now listed in the tree
Assign the Site Template
After the creation of the site template it needs to be assigned for your location. The assignment won't apply any changes to your locations sensor configuration yet.
...
- Go to My Organization and find your location by name
- Choose Edit from the right, this opens the location parameters view
- Choose your site template from the drop down menu ofSensor Config
- Click Save
Customize the Location (Site) Template
You can customize the parameters that are individual for particular sites through the Location Template, which is derived from the previously assigned Site Template. Settings like the IP address the Modbus TCP I/O module or sensor thresholds are examples for location specific settings you can configure.
...
| Tip | ||
|---|---|---|
| ||
Locations that have custom settings on top of their site template will show a differently colored location link.
|
Deploy the Sensor Configuration
After the configuration is done we need to deploy the configuration to our Berlin-101 location.
...
- Go to My Organization, navigate to Berlin-101 locationand click
on right hand side. - Click Actions → schedule which opens the deployment view
- Choose Deploy Sensor Config, and select Immediately
- Clicking Schedule will schedule an immediate deployment of the sensor configuration
- The deployment job will be shown in the bottom job overview
Best Practices
- Versions: Create new versions for each change if your components or site templates
- Keep Diversity Low: If possible, try to use the same ip addressing for each individual remote location, this will allow you to use one site template for many locations without any location specific customization
- Site Templates per Region: If thresholds and rules differ by region: create a new version of your base site template that holds region specific customizations, e.g. higher thresholds for temperature sensors for warmer country regions