Skip to main content
Netilion Help & Learning

Get Started With the FieldEdge SGC200

Updated

SGC200 Key Data

box.png

Use the powerful Netilion API to integrate your sensor’s measuring data into your system. 

The FieldEdge SGC200 enables you to collect measured values by Endress+Hauser Instruments and integrate it into your system.

The FieldEdge SGC200 collects the following values from Endress+Hauser Instruments:

  • Primary value (PV) incl. measuring unit and timestamp
  • Secondary value (SV) incl. measuring unit and timestamp
  • NE107 status incl. timestamp 

The FieldEdge SGC200 supports the following technologies to connect to Endress+Hauser Instruments:

  • Bluetooth (max. 15 per FieldEdge) 

The FieldEdge SGC200 comes with a provided SIM card that supports the following technologies to transfer collected values to the Netilion Cloud:

  • 3G/4G

connect_sgc200.png

 

SGC200 Configuration

1_sensor_edge_cloud.png

Set up the data collection and data transmission intervals in the Edge Devices configuration page according to your application needs: 

profile.png

The Edge Device configuration can to be done in Netilion ID Application as described here.
Please be aware it may take some time until the configuration is applied to the Edge Device. 

settings.png

Please note the minimum Data send interval is 15 minutes.

 

Accessing the data stored in the Netilion Cloud

3_cloud_apidoc.png

As soon as the previous steps are done and the connection is set up, a unique digital twin of your asset is created within Netilion Cloud.

The newly created asset is identified by its serial number. 
You will be able to access this information including measurement values transmitted by the FieldEdge SGC200 through the Netilion API.  

In the following examples, measuring values from a sensor will be accessed through the interactive Netilion API Documentation.  Alternatively, API tools such as e.g. Postman may be used as well.

Search your asset

Open the Netilion API Documentation and enter the following information:

  • The API Key you created earlier
  • Your Netilion username and password 

api_getassets.png

Using the method GET /assets to get a list of all the assets your Netilion user has access to. 
Select GET /assets, and click on Try it out.

tryitout.png

Many filter possibilities can optionally be used.

Select Execute to run the request:

execute.png

You will get a response with its http status code (1), a unique asset ID (2) and other information about this specific asset:

response.png

Remember the returned asset ID (2) for a further API request to access the measuring data attached. 

Separate Netilion API endpoints exist to enable an efficient and aggregated access to your asset's measurement values:

assetvalues.png

 

Access the measuring data with the method GET /assets/[your asset ID]/values:

Enter the unique asset ID of your asset you retrieved earlier as shown in the figure (1).

SGC200APIAssetValues.png

The response returns you the latest stored values (2), comprising :

  • a key corresponding to a certain measurement type
  • measurements respective unit
  • measurements timestamp in format YYYY-MM-DDThh:mm:ssTZD in UTC time
  • the value itself 

The FieldEdge SGC200 provides the following values:

  • Primary measuring value (PV)
  • Secondary measuring value (SV)

Access the measurement values per key with the method GET /assets/[your asset ID]/values/[key]:

Several additional filters enables you to request values from a certain key (1), optionally filtered for a specific interval (2), directly converted in a certain unit (3) or aggregated (4).

value_2.png

The response returns you the values as in the following example:

{
  "unit": {
    "id": 8815,
    "href": "https://api.netilion.endress.com/v1/units/8815"
  },
  "latest": 29.4531459808,
  "min": 28.9790496826,
  "max": 31.1914844513,
  "mean": 30.1711741054,
  "data": [
    {
      "timestamp": "2019-07-15T12:00:00Z",
      "value": 29.8721154841
    },
    {
      "timestamp": "2019-07-15T16:00:00Z",
      "value": 30.2796625991
    },
    {
      "timestamp": "2019-07-15T20:00:00Z",
      "value": 30.3031754891
    },
    {
      "timestamp": "2019-07-16T00:00:00Z",
      "value": 29.9560499031
    },
    {
      "timestamp": "2019-07-16T04:00:00Z",
      "value": 29.9975790998
    },
    {
      "timestamp": "2019-07-16T08:00:00Z",
      "value": 30.8338032252
    },
    {
      "timestamp": "2019-07-16T12:00:00Z",
      "value": 30.070282386
    }
  ],
  "pagination": {
    "total_count": 7,
    "page_count": 1,
    "per_page": 500,
    "page": 1
  }
}

 

Available units can be resolved with the method GET /v1/units.

Important Note

For security purposes, we limit the amount of requests that can be made against the Netilion API:

  • per user, requests are limited to 500 per minute
  • per API Key, requests are limited to 1000 per minute
  • per IP address, requests are limited to 2000 per minute

 

Related articles