Adding Assets

Adding New Assets

This is an overview for adding and connecting devices to the device manager and configuring the machine adapter to get data streamed to the timeseries database. On a high level overview, adding an asset requires:

  1. Adding devices to the device manager
  2. Configuring machine adapters to send data to the cloud

 

Before You Begin

You will need the following:

 

Instructions

These steps are intended to walk you through the process. Please see the Field Agents User Guide for more detailed step-by-step instructions.

 

Adding devices to the device manager

  1. Set up the network configurations.
  2. Enroll field agent to device manager.
    • Go to device manager and add the field agent.
    • Go to “Predix Enrollment” page on the local technician console and enroll.
  3. Connect field agent to the timeseries.
    • Edit the com.ge.dspmicro.websocketriver.send-0.config file. Ensure the predix zone id is filled out.
    • Validate by using gateway validation through the web console.

 

Configuring machine adapters to send data to the timeseries

These steps are intended to walk you through the process. Please see the Field Agent Machine Adapters User Guide for more detailed step-by-step instructions.

  1. Configure controller data source.
  2. Configure machine adapter, use one option below:
    • Configure the machine adapter config and application files manually.
    • Use the Field Agent Configuration Tool. Only certain machine adapters are supported by the Field Agent Configuration Tool.

Note: the upper bound limit for the values of the tags are 1.0e+308 for a float and 1422671131000000000 for an integer. Attempting to store values larger than the ones defined will cause an internal error.

 

Machine Adapter file structure

These files will map your data source tags to Predix Time Series tags. Polling interval, time stamps and more are configured here.

MY EQI2018 PROJECT   
|
----APM
+---FA  
    +---MyAsset_Unit1_FA1_config.zip
    |   +---configuration  
    |   |   +---install
    |   |   |   |   install.sh
    |   |   +---machine
    |   |   |   |   com.ge.dspmicro.hoover.spillway-N.config
    |   |   |   |   com.ge.dspmicro.machineadapter.adaptername-N.config
    |   |   |   |   com.ge.dspmicro.machineadapter.adaptername-N.xml #Data Source to Time Series Tag Map
    |   |   |   |   com.ge.dspmicro.websocketriver.send-N.config #Time Series End Point definition
    |   |   |   |   ...
    |   |   +---yeti
    |   |   |   |   yeti.cfg
    ----MyAsset_Unit2_FA2_config.zip

Verify data is being received in the timeseries database

Ensure that data is getting to the timeseries database from Field Agent by using the Predix Toolkit. Be sure you have the following information:

  • UAA URL
  • Timeseries client ID
  • Timeseries client secret
  • Timeseries Zone ID

Using the Toolkit:
1. On the Security tab, click Client ID Login in the left navigation pane.
1. Complete requested details and click “Submit”.
1. On the API Explorer tab, click Time Series Query in the left navigation pane.
1. In the “Choose Request” field, select Get Tags.
1. In the predix-zone id field, enter the Zone id.
1. Click “Submit”.

 

Next Steps

Once you have configured your field agents, you are ready to manage your assets with APM.

 

References

  1. Field Agents Landing Page
  2. Field Agents User Guide
  3. Field Agent Machine Adapters Landing Page
  4. Field Agent Machine Adapters User Guide
  5. Field Agent Configuration Tool
  6. Predix Toolkit
  7. Managing Assets
  8. Troubleshooting & FAQs