<< Click to Display Table of Contents >> Navigation:  Live > Agents > Web API Agents > Web API Vendor > Live Eleven-X Agent

The Eleven-X Agent is a data loading agent available in EQuIS Live for obtaining data from Eleven-X.

 

Adding Device

 

Before using the Eleven-X Agent, add one or more devices to the DT_LOGGER table:

1.Execute the equis.get_ids stored procedure to get a new LOGGER_ID or add the station (DT_LOGGER row) in EQuIS Professional.

2.Set LIVE_DATA_SOURCE to eleven-x.

3.Set LOGGER_CODE to a DEVEUI (DEVice Extended Unique Identifier, e.g., 70-B3-B5-14-90-0E-00-7A; sign in to https://lora.eleven-x.com to get a list of devices and their descriptions).

4.Set CUSTOM_FIELD_1 to an encrypted username and password. Please contact EarthSoft to encrypt your username and password.

5.If the device is a Decentlab Ultrasonic Distance / Level Sensor for LoRaWAN, then set CUSTOM_FIELD_2 to 'DL-MBX'. (See Decentlab in Third Party Components for more information.)

6.Set STATUS_FLAG to 'A' to activate the logger.

 

 

Loading Data

 

The Eleven-X Agent or Historical Data Loader can be run as a scheduled EQuIS Information Agent (EIA), at the desired frequency, to automatically load data as often as needed.

 

The Eleven-X Agent or Historical Data Loader can also be run in EQuIS Professional or Enterprise (using the EZView widget) to load the data manually, without having to schedule an EIA.

 

The Eleven-X Agent will load data for all loggers with LIVE_DATA_SOURCE set to eleven-x. The agent will request data from the logger's most recent date (in DT_LOGGER_DATUM.DATUM_UTC_DT) until today's date. If a logger does not have any values, it gets values for the past month (or whatever data is available).

 

The Eleven-X Historical Data Loader allows for the selection of the loggers, date range, and whether or not to update existing values.

 

The Eleven-X Agent and Historical Data Loader adds a DT_LOGGER_SERIES for each of a device's parameters (e.g., SERIES_NAME = Pressure, SERIES_UNIT = Pa). A series can then be activated or deactivated, by setting its STATUS_FLAG = "A" or "R", to start or stop (respectively) obtaining data for it. A series' SERIES_DESC may be changed, but not the SERIES_NAME and SERIES_UNIT; they uniquely identify the series using the sensor codes from the Eleven-X API.