Water and Wastewater
​Use the Button Below to Schedule a Free Demo!

 

 API

About the accQlink API

Teledyne ISCO provides access to your accQlink's information using a simple and secure REST or SOAP based web services API, To use the REST API or SOAP API, you need basic familiarity with software development, REST or SOAP web services, and the accQlink's user interface.

Using the accQlink REST API

Account and organization owners, as well as account and organization administrators, can access the Teledyne ISCO REST API.

Gaining Access to accQlink Data via the REST API

The process of gaining access to accQlink data via the REST API includes the following steps:

 

 Step 1 - Creating an API Client

To create an API Client:

  1. Click API in the sidebar
  2. Click + Generate API Client
  3. In the Generate API Client window that appears:
    1. In Type, select the type of API client you with to generate: REST API.
    2. Optionally enter a Comment.
    3. Click Generate.
  4. In the API Client Key and Secret window that appears, your API client key and secret are displayed.
    1. Make sure to store the key and secret in a secure location. After you close the window, you will not be able to retrieve the secret.
    2. Click Close.
  5. The API Clients window refreshes to display the newly generated API client in the table.

Deleting, Deactivating, or Activating an API Client

You can delete, deactivate, or activate an API client. To do so:

  1. Access the API Clients table by clicking API in the side bar.
  2. Hover over the line corresponding to the API Client you wish to delete, deactivate, or activate. Several icons appear.
  3. Select the icon corresponding to the action you wish to take:
    1. Deactivate the API client. A deactivated API client cannot be used to access Teledyne ISCO data, but is not deleted from the database.
    2. Reactivate an API client that was previously deactivated.
    3. Delete the API client from the database.

 

Step 2 - Getting an Access Token for a REST API Call

To get an access token for a REST API call:

Follow the instructions in the Using the REST API window of the UI.

To access the page, click API in the sidebar, then select API Documentation > Using the REST API.

Specifically, see the section Step 2: Getting an Access Token.

 

Step 3 - Authentication with the REST API using the Access Token

To authenticate the REST API using the access token:

Follow the instructions in the Using the REST API window of the UI.

To access the page, click API in the sidebar, then select API Documentation > Using the REST API.

Specifically, see the section Step 3: Authentication with Access Token.

 

Using the REST API Methods

The methods available for RESTful access to accQlink data are listed and explained in the REST API Reference window of the Teledyne ISCO UI.

To access the Page, click API in the sidebar, then select API Documentation > REST API Reference.

 

Gaining Access to accQlink Data via SOAP API

The process of gaining access to accQlink data via the SOAP API includes the following steps:

Step 1 - Creating an API Client

To create an API client:

  1. Click API in the sidebar.
  2. Click + Generate API Client.
  3. In the Generate API Client window that appears:
    1. In Type, select the type of API client you wish to generate: SOAP API.
    2. Optionally enter a Comment.
    3. Click Generate.
  4. In the API Client Key and Secret window that appears, your API client key and secret are displayed.
    1. Make sure to store the key and secret in a secure location. After you close the window, you will not be able to retrieve the secret.
    2. Click Close.
  5. The API Clients window refreshes to display the newly generated API client in the table.

Deleting, Deactivating, or Activating an API Client

You can delete, deactivate, or activate an API client. To do so:

  1. Access the API Clients table by clicking API in the sidebar.
  2. Hover over the line corresponding to the API Client you wish to delete, deactivate, or activate. Several icons appear.
  3. Select the icon corresponding to the action you wish to take:
    1. Deactivate the API client. A deactivated API client cannot be used to access Teledyne ISCO data, but is not deleted from the database.
    2. Reactivate an API client that was previously deactivated.
    3. Delete the API client from database.

 

Step 2 - Getting an Auth Token for SOAP API Authentication

To get an auth token for SOAP API authentication:

Follow the instructions in the Using the SOAP API window of the UI.

To access the page, click API in the sidebar, then select API Documentation > Using the SOAP API.

 

Using the SOAP API Methods

The methods available for SOAP API access to accQlink data are listed and explained in the SOAP API Reference window of the UI.

To access the page, click API in the sidebar, then select API Documentation > SOAP API Reference

 Documents

  
  
  
accQlink Quick Start Guide.pdfaccQlink Quick Start GuideQuick Start Guide
accQlink User Manual.pdfaccQlink User ManualUser Manual
accQlink Ultrasonic Quick Start Guide.pdfaccQlink Ultrasonic Quick Start GuideQuick Start Guide
accQlink Datasheet.pdfaccQlink DatasheetDatasheet

 FAQ

Frequently Asked Questions

 Data Display

Yes, you can compare the readings obtained from multiple data streams.
One method is displaying them in the Visualization window in the same chart. You can display up to five data streams of up to two different types in the same chart.
Another method is to generate a report displaying the history of multiple streams.

Hiding samples in the Samples table - The hidden samples will appear neither in the Visualization window nor in reports.
Discarding bad samples of raw data - You can set the minimum and maximum values for raw data. Raw data that is outside this range will be discarded. This is useful in cases where you know that values outside this range are not real values, caused for example by the sensor being disconnected from the accQlink device.

 Warranty

Teledyne ISCO provides a standard 1-year limited warranty covering the accQlink and all other hardware furnished as part of an accQlink. Teledyne ISCO also offers extended warranties.

Battery and Power

There are several factors that determine how long the accQlink battery lasts in the field, including, but not limited to:

  • Which sensor(s) are being used
  • Sampling frequency and sensor wake-up time
  • Data transmission interval and session length
  • Cellular signal strength
  • Ambient temperature

 

Yes, the accQlink device can be powered by a fixed power supply or solar panel. Each accQlink device is supplied with an external power connector for this purpose.

The accQlink can be configured with an SD card supporting up to 32 GB of data. Data is stored in the accQlink device in non-volatile memory, so that data is not lost in the event that the battery is spent and an external power source goes out.
Note:for installations using an external power source, the internal battery provides backup power if the external power supply fails.

Data is stored in the accQlink device in non-volatile memory, so that data is not lost in the event that the battery is spent and an external power source goes out.
Note: installations using an external power source, the internal battery provides backup power if the external power supply fails.

 Transmission of Data

Yes, for each sensor, you can set the transmission interval for when sensor readings fall within a certain threshold band.

First, view or set your device's transmission intervals.
Then, for each sensor (data stream), you can specify thresholds.
Finally, for each threshold, you can specify the transmission interval when stream data is within the threshold band.

The device transmission interval defines how often the device transmits the data gathered by its sensors.
For every device, you can set three (3) transmission intervals: Normal, Event, and Emergency. Transmission interval Normal is the default interval. Transmission intervals Event and Emergency are two alternate intervals. Data is always transmitted at the Normal rate, unless you specify a different rate - either Event or Emergency - when readings within a certain threshold band.

Sampling

Internal storage on the accQlink device is 8 gigabytes (GB). For a typical application, 8GB will store data for more than a year. An optional upgrade with an SD card provides up to 32GB.

Data from each stream is collected at a configurable sampling interval.

 Roles and Permissions

The Visualization window provides quick and easy-to-use tools for locating your accQlink devices and visualizing their data streams.

The map view in the Visualization window displays sites and corresponding data streams. Data streams are automatically grouped into clusters, which separate into individual sites as you zoom in.

The Sites tree pane, which is collapsible, provides a searchable list of all sites. The different streams of data are listed under each site, with the last value and a corresponding time stamp for each stream. Clicking on a site name will zoom in the map view to that site.

Clicking one of the data streams in the task pane will zoom the map view to the site and create a split-screen view with a chart visualizing the data.

Yes, user permissions are controlled using Roles.

Hibernate Mode

The Hibernate command puts the accQlink device into an ultra-low-power mode. The device will neither take samples nor transmit data.

To execute the Hibernate command, navigate to the Devices tab and click on the relevant accQlink device. Click on Commands and select Hibernate. The user interface will prompt you with a request to confirm.

One the Hibernate command is executed, the accQlink can be brought out of Hibernate mode only by physically placing the magnetic activator on the device. The magnet activator initiates a 10-minute calibration process, after which the accQlink device returns to its standard configuration and normal working mode.

 Firmware

The firmware version running on each accQlink device can be viewed in the Teledyne ISCO user interface via the Devices tab. The firmware version is displayed by clicking on the device name in the Sites Tree pane on the left-hand side.

Data Export

Teledyne ISCO's user interface can generate the following pre-defined reports. Reports are generated as CSV (commas separated values) files.

  • Stream History Reports - data from one or more data streams of a particular type, for a user-defined date range.
  • Aggregation Reports - statistical analysis of the readings obtained in one or more data streams of a specific type (sum, average, min/max, standard deviation), for a user-defined data range and aggregation interval.
  • Flow Reports - sum of daily sums, for a user-defined date range.
  • Custom Stream History Reports - enables customizing the display of any data streams' history for a user-defined date range. This customization option is very useful if you need to export data into a system that supports a specific data structure only.

 

Username and Password

Users with administrative permissions can update usernames and passwords via the Teledyne ISCO user interface or API.

Alerts

SMS and email alerts are configured within the user interface. Please verify that the user contact details were properly entered into the system, the user was added to the appropriate alert user group, and the alert user group is configured to receive SMS notifications.

Each individual input-stream can be configured up to four (4) alert configurations.

Sensors

With the multiple input type, Teledyne ISCO's accQlink device can be used with a variety of sensors. If there is a specific sensor you would like to use, please contact us at isco.info@teledyne.com so we can customize an accQlink to meet your needs.

 SCADA

Teledyne ISCO's accQlink collects and transmits data to cloud storage or an on-premises server. Using the drivers, code, and API developed by Teledyne ISCO's engineers, the data is seamlessly and securely integrated to populate SCADA databases. Teledyne ISCO supports OPC UA, DNP3, and proprietary communication protocols.

The Modbus input option is a master. Fifteen (15) objects/registers can be read and addressed.

Cyber-Security

Teledyne ISCO's accQlink is embedded with cutting-edge cyber-security technology built from the ground up. Cyber-security features include AES-256 protocol data encryption, authentication, one-time passwords (OTP) and secured connectivity.

Yes. Teledyne ISCO takes data security and privacy very seriously. We have implemented cutting-edge cyber-security features from the inception of the technology. Since many of our customers prefer to bypass cloud storage, we have developed capabilities to transmit the data directly to an on-premises or private cloud server.

Choosing an accQlink

The accQlink can have up to three (3) sensor ports - analog, serial, or discrete. They can be made available in any combination. Multiple sensors can be interfaced to each port. In addition to sensor ports, the accQlink has an external power connector, which is designed for either a fixed power supply or a solar panel. The accQlink also has an external antenna port.

Teledyne ISCO's accQlink is an ideal solution for smart cities. Modular and seamless by design, an accQlink is a plug-and-play acquisition node that can be installed across urban environments to create new or extend existing smart networks. These accQlink applications include environmental, water and wastewater, and stormwater monitoring.

It depends on the service and the location. It is simple enough that a salesman can set one up as a demo using a cup of hot water. In actual process environments, all facility installation guidelines should be followed by the appropriate personnel.

Teledyne ISCO's accQlink is a plug-and-play device, and therefore no special training is required to install. The accQlink is furnished with a Quick State Guide that offers straightforward, illustrated installation instructions. Field technicians and other operations employees typically perform the installation, but any personnel familiar with the required safety guidelines, procedures of implementing field instrumentation, and remote telemetry can complete the installation.

When the device reports new GPS coordinates to the server, it takes the server several minutes to complete the processing. Usually, however, the issue is the time it takes for the GPS coordinates to be detected in the field. Keep in mind that:

  • The internal GPS antenna is located at the top of the device, opposite the connectors panel. That side of the accQlink device needs clear view of a patch of sky for about 5-10 minutes in order to pick up a GPS signal.
  • Trees, buildings, roofs, etc. interfere with the GPS signal.

 

accQlink Hardware

The accQlink Activator is a magnet, and is identical for all accQlink devices.

Cellular Signal

The recommended range is -89dBm and above. More specifically:

Signal Value in dBmResultant Signal Quality
≤ -100Very Weak
Between -99 and -90Weak
Between -89 and -80Fair
Between -79 and -65Good
≥ -64Excellent

Teledyne ISCO supplies the accQlink with a global SIM card offering multi-network support, including Verizon, AT&T, and T-Mobile in the US, and supports connectivity in more than 140 countries worldwide. End users of the accQlink neither have to select a network carrier nor sign contracts with any cellular network providers. The Teledyne ISCO service plan includes a cellular data plan. The accQlink device automatically detects and executes each transmission session on the network with the strongest signal, which results in extended battery lifetime and more reliable connectivity.

Changes to sampling configurations are sent over-the-air via the user interface and are executed during the next communication session between the server and the accQlink device.

If the accQlink fails to connect to a cellular network, the device will continue to collect and store data. The transmission frequency is automatically reduced to conserve power until communications can be successfully re-established, at which point the device returns to its normal transmission frequency.

Note: data is stored in the accQlink device in non-volatile memory, so that data is not lost in the event of the battery or external power loss.

Device Configuration

All device configuration changes are relayed to the device as commands when the device next communicates with the server. The time of communication is determined by the defined transmission interval.

In addition, most of the advanced settings available through Configuration > Advanced Device Configuration require a device reboot in order to take effect. The reboot command, together with all other commands accumulated since the last transmission, will be relayed to the device when the device next communicates with the server.

The Reboot command is used for implementing configuration changes on the physical device made via the user interface. THe physciall ON/OFF switch inside the accQlink disconnects the power inside the unit and is used when changing the battery. To properly shut down an accQlink, remove the cover and use the physical ON/OFF switch inside of the unit.

If you must change the address of the server to which the accQlink device transmits its data, perform the following:

  1. Click Devices in the sidebar.
  2. In the Sites Tree pane, select the device.
  3. In the right pane, select the Configuration tab.
  4. Click Advanced Device Configuration.
  5. In the configuration tree, expand the GSM node.
  6. Select the server_addr node.
  7. To the right of the configuration tree, select the drop-down arrow adjacent to the current value, and select Set Setting.
  8. In the Send New Value window that appears, eneter the new server IP address or DNS name in the New Value field, and click Submit.

 

 Support

When you purchase instruments from Teledyne ISCO, you not only receive innovative, high quality products, you also receive excellent customer service and product support. Your initial purchase is only the beginning of Teledyne ISCO's ongoing commitment to their customers.

Find Your Representative

Contact Support

Software and Firmware Updates

 Specifications

​accQlink

 

​Data Hosting:​ISCO Private Cloud and/or On-Premises Server
Cyber Security:​TLS Protocol (including AES-256 Encryption)
Software Integration:

​REST API, SOAP API

SCADA Integration:OPC-UA, DNP3, CSV
​ISCO User Interface:​Web-Based from Desktop, Tablet, Mobile

Data Export Options:

CSV
​Device Memory:8 GB
​Data Communication:

Bidirectional

​Alarm Notification:​SMS, Email, Voice
​Alarm Threshold:​Up to 4 per Data Types
​System Health Check:​Included

Datasheet

 Overview

accQlink

The accQlink is an Industrial Internet-Of-Things (IIoT) system for the Water and Wastewater Industries. It provides a modular and flexible remote data acquisition solution.

 

The accQlink can accept inputs from sensors that have RS232, RS485, SDI-12, Analog, and/or Contact output. The accQlink is a robust device that autonomously operates in the field using battery, solar, or permanent power sources. It collects data from different types of sensors, transmits securely, and stores the cloud server and/or customer server. Data can also be integrated into SCADA system, modeling software, business intelligence platform, ISCO Flowlink Pro, or other software.

With ISCO cloud server, the Data can be viewed and managed from anywhere using internet with graphical data management Web User Interface. SMS/Email alerts can be generated based on preprogrammed thresholds to take corrective actions and avoid any breakdown.

While transmitting the data from the accQlink, the built in Global SIM card picks the strongest available cell signal, from the multiple available cell networks, ensuring maximum uptime. The yearly service includes cell phone charges, data hosting, and web user interface. The accQlink also offers communication options such as LPWAN (Low Power Wide Area Network), Bluetooth, and Satellite.

Applications:

  • Overflow monitoring (CSO and SSO)
  • I&I, cMOM, ad other collection system monitoring
  • Wet well monitoring in Pump stations
  • Stormwater runoff monitoring
  • Weather monitoring
  • Water quality monitoring

Standard Features:

  • Rugged Design with IP 68 Enclosure
  • Data encrytion for cyber security
  • Cloud data hosting and intuitive Web UI
  • Automatic alerts via SMS and email