You are on page 1of 13

Release Notes

IoT Gateway
1.2.1

Revision: E
The information in this manual is subject to change without notice and should not be construed as a
commitment by ABB. ABB assumes no responsibility for any errors that may appear in this manual.
Except as may be expressly stated anywhere in this manual, nothing herein shall be construed as any kind of
guarantee or warranty by ABB for losses, damages to persons or property, fitness for a specific purpose or the
like.
In no event shall ABB be liable for incidental or consequential damages arising from use of this manual and
products described herein.
This manual and parts thereof must not be reproduced or copied without ABB's written permission, and
contents thereof must not be imparted to a third party nor be used for any unauthorized purpose. Contravention
will be prosecuted.
Additional copies of this document may be obtained from ABB at its then current charge.

© Copyright 2022 ABB All rights reserved.


ABB AB
Robotics Products
SE-721 68 Västerås
Sweden
Table of Contents

Overview ............................................................................................................................................................. 4

Release Information ........................................................................................................................................... 5

New Features...................................................................................................................................................... 6

How to migrate from IRC5 OPC UA Server to IoT Gateway ........................................................................... 7

Corrections ......................................................................................................................................................... 9

Known Limitations ........................................................................................................................................... 10

Installation ........................................................................................................................................................ 11

Product Support .............................................................................................................................................. 13

© Copyright 2022 ABB All rights reserved 3


Release Notes
IoT Gateway v1.2.1

Overview
Description
This document provides information about the new features, corrected problems, and
installation of the latest IoT Gateway.

Product Overview
IoT Gateway is an extendable communication gateway that provide OPC UA Server
and MQTT publisher capabilities for the IRC5 and Omnicore generation of robot
controllers.
The product is implemented as a Windows service that runs the communication
gateway(s) and a Windows application used for configuration and commissioning. The
product is especially suitable for retrofit solutions as it in most cases does not require
an upgrade of RobotWare.
The OPC UA Server exposes information in the Robot controller to OPC UA clients.
The product consists of two components:
• A Windows service that runs in the background and transfers information to and
from the connected controllers.
• A user interface that lets the user configure which controllers that the server shall
connect to.
A 3rd party SCADA or other system with an in-built OPC UA client may be used to
connect with the OPC UA server in the IoT Gateway.
Note: The IoT Gateway does not include any OPC UA clients.

Please read the RobotWare Release Notes and documentation for general information
on your robot and networking the controller.

To get started, or to learn more, visit our Developer Center:


https://developercenter.robotstudio.com

Here you will also find the User Forum, where developers discuss software problems
and solutions online:
https://forums.robotstudio.com

More information about the OPC specification, related tools and libraries, can be found
at the OPC Foundation web site:
http://www.opcfoundation.org

© Copyright 2022 ABB All rights reserved 4


Release Notes
IoT Gateway v1.2.1

Release Information
Release Name
The release name is IoT Gateway v1.2.1 and the build number is
IoT.GateWay.1.2.1-194.It is available for download from
https://developercenter.robotstudio.com.

Release Date
The release date is July 25, 2022

Configuration
User interface for configuring the IoT Gateway.
It can be launched from the Windows Start Menu.
Programs > ABB > IoT Gateway Config
Server component
IoT Gateway runs as a Windows service in the background. It connects to configured
controllers and allows incoming connections from OPC UA clients.
It can be started and stopped using the IoT Gateway Config Tool.

Robot Communication Runtime


Component used by the server component for communication with controllers over a
network.

Documentation
IoT Gateway Help – Operating Manual.
It can be accessed from Help button in IoT Gateway Config Tool.

© Copyright 2022 ABB All rights reserved 5


Release Notes
IoT Gateway v1.2.1

New Features
Overview
This section contains a short description of new features in this release. For detailed
information, see the user manual.

None

© Copyright 2022 ABB All rights reserved 6


Release Notes
IoT Gateway v1.2.1

How to migrate from IRC5 OPC UA Server to IoT


Gateway

1. Stop the IRC5 OPC UA Server

2. Install IoT Gateway


3. Open the IoT Gateway config tool and verify that all alias definitions are imported. If not try
to restart the IoT Gateway and reverify
4. Import the trusted client certificates from Location ((%ProgramData%\ABB\IRC5 OPC
UA\CertificateStores\TrustedCertificates\certs) using IoT Gateway config tool
• Go to IoT Gateway config tool -> Client Certificates

© Copyright 2022 ABB All rights reserved 7


Release Notes
IoT Gateway v1.2.1

• Click on Import button to import the trusted client certificates of IRC5 OPC UA
Server from Location (%ProgramData%\ABB\IRC5 OPC
UA\CertificateStores\TrustedCertificates\certs). Select all the certificates.

• Click on Open in Import Certificate window. All the trusted client certificates of
IRC5 OPC UA Server imported to trusted client list of IoT Gateway

5. Uninstall IRC5 OPC UA Server

© Copyright 2022 ABB All rights reserved 8


Release Notes
IoT Gateway v1.2.1

Corrections
Overview
This section describes the corrections in this release of the IoT Gateway.
Defect Title Description
Number
PDD:14616 IOT Gateway - Adding alias, scan Adding valid IP address in the ‘Remote
list empty Controller IP Address’ field, remote controller
is successfully added in the scan list without
any error message. Other remote controllers
are not listed in scan list.
BUG:433089 Error messages related to I/O ‘I/O signal’ error messages are refactored
signals need to be refactored like like ‘persistent RAPID’ variable error
error messages related to messages.
persistent RAPID variable Name of the I/O signal is now always
included in the message together with the
alias name.
BUG:441289 Update IoT Gateway Application IoT Gateway application manual is
manual on subscription for "Motion updated with an improvement in subscription
Device" data for "Motion Device" data.
BUG:442568 IOT Gateway Application Manual- Option name for RobotWare 6 versions
Wrong name of RW Option 1582-1 starting from 6.12.03 is corrected as “1582-
1 IoT Data Gateway” in the IoT Gateway
application manual

PDD:14602 Username and password are Provided an option in User ID tab of IoT
available as clear text in User ID Gateway configuration tool to show / hide
tab of IoT Gateway configuration the password by enabling /disabling the
tool check box placed next to Password field

© Copyright 2022 ABB All rights reserved 9


Release Notes
IoT Gateway v1.2.1

Known Limitations
Overview
This section describes known limitations in IoT Gateway.

Feature 308167: IoT Gateway: Fast start-up by delayed on demand address space
creation
While start of IoT Gateway, it collects the data required for information model. IoT
Gateway communicate with Controller to fetch the information.
If controller has many signals and rapid variables data collection takes bit of time.
Example: If Configured controller has 1000 signals and 200 RAPID Persistence
variables then IoT Gateway may take nearly 2mins to connect and fetch the
information.
Workaround: This problem will not occur if configured controllers does not have very
many IO-Signals and RAPID Persistence variables. Otherwise, problem will not
have impact on startup.

Feature 440288: IoT Gateway: Use Information Stream for high performance (OPC UA)
subscription
Use Information Stream for high performance (OPC UA) subscription

Feature 462294: IOT Gateway Config Tool - Refactor Scan list and add alias for remote
controller through IP address

All remote controllers (which are in different subnet) are not listed in the scan list

Workaround: Adding valid IP address in the ‘Remote Controller IP Address’ field is


successfully added in the scan list without any error message. This step needs to be
repeated for each remote controller

Bug 440583: No access to robot controller data when adding new alias for virtual
controller
No access to robot controller data when adding new Alias for virtual controller if
'Address' is selected/ticketed in Connection Criteria box.

Bug 440663: Removing alias which is in system failure, saving the configuration and
restarting IoT gateway may results in Fatal error
After removing the alias (which is created for the controller which is “system failure”
state), saving the IoT gateway configuration and restarting IoT Gateway may result in
FTL error

Bug 441269: Controller name is disabled for alias connection criteria


IP address does not work as connection criteria for virtual controllers

© Copyright 2022 ABB All rights reserved 10


Release Notes
IoT Gateway v1.2.1

Installation
1.1 Prerequisites

Before you install…

• You must have the administrator rights for the computer in order to install and
configure IoT Gateway.

Licensing
IoT Gateway can be used free of charge, but certain RobotWare options are
required to enable communication with the robot controllers. See RobotWare
software requirements chapter below for details on required options.

1.1 System requirements

Hardware
Medium to high-performance industrial or desktop PC, with the following requirements

Part Requirement
CPU 2.0GHz or faster processor, multiple cores recommended
Memory 2 GB minimum. 4GB or more recommended
Disk 2+ GB free space, solid state drive (SSD) recommended.

PC software requirements

Operating System Edition Remark


Microsoft Windows 10 64-bit edition Recommended

RobotWare software requirements


IoT Gateway supports RobotWare 6 and RobotWare 7.2 and newer.

For all RobotWare 6 versions starting from version 6.12.03, both the “616-1 PC
Interface” and the “1582-1 IoT Data Gateway” RoboWare options are required.

Robotware version starting from 6.11 to 6.12.02, both the “616-1 PC Interface” and the
“1582-1 OPC UA Server” RoboWare options are required.
The IoT Gateway may also be used with RobotWare versions prior to 6.11. Please
contact ABB for information on licensing.

For Omnicore controllers from RobotWare 7.2 and newer “3154-1 IoT Data
Gateway” option is required.

© Copyright 2022 ABB All rights reserved 11


Release Notes
IoT Gateway v1.2.1

1.2 Installation instructions

Installing on a new PC
NOTE: It is recommended to uninstall the IRC5 OPC UA Server before installing the
IoT Gateway.
Action
1 Download the IoT Gateway to a folder on your computer from
https://developercenter.robotstudio.com

2 Double click setup.exe in the extracted folder to start the IoT Gateway installation
procedure

3 Proceed to install IoT Gateway.

4 IoT Gateway is installed

© Copyright 2022 ABB All rights reserved 12


Release Notes
IoT Gateway v1.2.1

Product Support
For product support please turn to your local ABB office.
https://new.abb.com/contact-centers

For help, advice and the latest updates visit the User Forum and Developer Center.
https://forums.robotstudio.com
https://developercenter.robotstudio.com

© Copyright 2022 ABB All rights reserved 13

You might also like