...
| Table of Contents |
|---|
Installation
While Although the hardware will often have our Edge ACM software preinstalled, sometimes you will find you need may already installed, it may be necessary to perform the initial installation or upgrade the existing installation on a piece of hardware. Follow the instructions in the Dealing with software packages page to get your configure the hardware configured.
Licensing
Before you can poll any devices, you will need devices can be polled, a License must exist on your the hardware.
With Edge Manager installed:
Go to http://{EdgeDeviceIP}:8080
Select App Manager on the left pane
Expand the node at the top of the Explorer pane
Right click Edge ACM
Select Properties
Download a License Request and send that file to your AUTOSOL contact.
When you receive a License file, return to Edge ACM properties
Use Choose File to select your License
Press the Submit button
...
Congratulations! Your hardware is now licensed and can be used to poll devices!
...
https://autosoln.atlassian.net/wiki/pages/resumedraft.action?draftId=298746247 is the the app polling engine that polls collects data from the field devices device using native protocols and provides that data to other apps for publication, eg. AUTOSOL MQTT, Azure.
In order to poll data from any devices, you will need a number of objects created within , the following objects must be created in Edge ACM:
One or more Folder objects to hold the other objects
Added Add by right clicking Edge ACM or a Folderfolder, selecting Add, then selecting Folder.
One or more Connection Settings object objects to establish the IP and port we are communicating with. .
Add by right clicking a folder, selecting Add, then selecting Connection Settings
| Info |
|---|
If multiple devices share an IP and port (eg. are all on the same master radio) |
...
, a single Connection Settings object can be shared by multiple Device objects |
Added by right clicking a Folder, selecting Add, then selecting Connection Settings
One or more Schedule objects to configure how often frequently Edge ACM will poll its associated Tag Groups
Added Add by right clicking a Folderfolder, selecting Add, then selecting Schedule
One or more Tag Group objects to identify the Tags to be polled
Added Add by right clicking a Folderfolder, selecting Add, then selecting Tag Group
One or more Tag objects in each Tag Group to establish which tags/registers are polled in the end device, and the rules by which it is published.
Added Add by right clicking a Tag Group, selecting Add, then selecting Tag
One or more Device objects (ControlLogix, Modbus, Roc, TotalFlow).
Added Add by right clicking a Folderfolder, selecting Add, then selecting the appropriate Device object.
At least one device object must be Enabled, linked to a Connection Settings object, and have a Tag Group that contains at least one Tag selected in order for communications to occur.
Right To start Edge ACM, right click Edge ACM, select Commands, and select Start. If the app is Licensed and the above steps have been taken, the indicator circle should will turn Green and you should see files will be generated in the Log Viewer
...
Priority Forward is the app that allows your Edge the App Manager to control access to an Edge Devicea device, allowing a primary connection to override all other communications.
In order to control communications, you will need a number of Objects the following objects must be configured in Priority Forward:
One or more Folder folder objects to hold the other objects
Added Add by right clicking Priority Forward or a Folder, selecting Add, then selecting Folder
One or more Advanced Channel Settings object to establish rules for the Channel
Added Add by right clicking a Folderfolder, selecting Add, then selecting Advanced Channel Settings
One or more Channel object to establish the IP and port of the end Device and the local ports used for Primary and Secondary connections
Added Add by right clicking a Folderfolder, selecting Add, then selecting Channel
Once these objects exist, you can right click Priority Forward, select Commands, and select Start
Azure
Azure is the app that publishes data from Edge ACM to your Azure IoT Hub
| Info |
|---|
Symmetric Key must be selected for the authentication type when creating the IoT Hub device in Azure IoT Hub |
In order to communicate with your Azure IoT Hubyou need to:
...
Right click the Azure app and select Properties
Set the Connection String to match the Primary or Secondary Connection String you have configured within Azure IoT Hub.
Each instance of Edge Manager should be configured to publish to a seperate separate Device in Azure IoT Hub
Once the Connection String is configured and the other settings match your preference, begin publishing to Azure IoT Hub by right clicking Azure, selecting established, right click Azure, select Commands, and slecting Start
...
select Start to begin publishing to Azure IoT Hub.
| Info |
|---|
Data will only publish to Azure when Edge ACM is running and |
...
retrieving data from its end |
...
devices. |
AUTOSOL MQTT
AUTOSOL MQTT is the app that publishes polled data from Edge ACM to your an MQTT Broker
In order to communicate with your an MQTT Broker you will need a number of objects the following objects must be configured within AUTOSOL MQTT:
One or more Folder folder objects to hold the other objects
Added Add by right clicking AUTOSOL MQTT or a Folderfolder, selecting Add, then selecting Folder
One or more Broker Connection objects to establish a connection within your MQTT Broker
Added Add by right clicking a Folderfolder, selecting Add, then selecting Broker Connection
One or more Publisher object (Standard Publisher, Sparkplug B Publisher) to establish how data from Edge ACM will be sent to your MQTT Broker through your Broker Connection
Added Add by right clicking a Folderfolder, selecting Add, then selecting the appropriate Publisher object
Once the objects have been created, you can begin publishg by right clicking click AUTOSOL MQTT, selecting select Commands and selecting select Start
...
| Info |
|---|
...
Data will only publish to an MQTT Broker Azure when Edge ACM is running and |
...
retrieving data from its end |
...
devices. |
Common Issues
If newly saved changes haven’t shown up in your client software, remember that each App needs to be verify that you have issued a Restart or a Stop then Start command before to apply the changes will be applied..