The Open Guide to Cloud Interface for ABB AbilityTM Smart Sensors

Scope

• Open guide to learn how to use these Web APIs for ABB AbilityTM Smart Sensors.
• Provide customers with a simple Python class to communicate with the Smart Sensor Web API. This is a sample project as a starting point to build up the integration project(s).
• Create a community to share new developments, ask questions and propose suggestions for improvements based on real experience.
• For more details, please refer to the documentation.

Prerequisites

• Python 3 with pip and setuptools installed
• Test that you have access to the Smart Sensor Web API
• Obtain an API key from the Smart Sensor website
• Get to know the feature codes related to the commands to be used, available in the section "Commands", available in the documentation.

Quick Start

1. Install the complete package using pip by executing:

   python -m pip install .
   

   This will install the smart_sensor_client package along with its dependencies. You need to do this every time you fetch an update from this repository.

2. Copy settings.example.yaml to settings.yaml and change the values. You can adjust your proxy settings (leave empty if none). You can also optionally specify your API key or username, which the Smart Sensor Client will use automatically.

3. To run a simple use case, such as getting the latest measurements from all your assets, execute

   python use_cases/use_case_4_latest_asset_measurements.py
   

4. To authenticate, enter your API key or your email address and password. The API Key can be requested by the users under your profile in the ABB AbilityTM Smart Sensor Platform. Go to API Keys and select the function “add new”. You will receive the API Key via email from the e-mail address [email protected].

5. The sample program will display your assets in your Smart Sensor organization and their latest sensor measurements. You can check the measurements against those you see in the ABB AbilityTM Smart Sensor Platform.

6. Finally, you can look at the source code and SmartSensorClient to see how it uses the Cloud Interface and how you can adapt it for your integration project.

Use Cases

We provide code for some typical use cases of accessing the Smart Sensor Cloud Interface. You can run each script by executing

python use_cases/<use_case_file_name>

Name	Explanation	Links
use_case_1_list_of_assets.py	Show the information of all the assets	code, usage
use_case_2_plant_data.py	Show the information of all the plants	code, usage
use_case_3_detailed_asset_data.py	Show the detailed information of all the assets	code, usage
use_case_4_latest_asset_measurements.py	Show the latest measurements from all the assets	code, usage