Legal notice and acknowledgements
Legal notice and acknowledgements for UnderAutomation.Robotics: publisher, trademarks of the five robot makers, interfaces, responsible use, third-party components and their licenses, references.
Legal notice and acknowledgements for UnderAutomation.Robotics.
Publisher
UnderAutomation.Robotics is developed, published and distributed by UnderAutomation. Copyright (c) UnderAutomation. All rights not expressly granted are reserved.
The library contains the UnderAutomation SDKs for Fanuc, Yaskawa, Universal Robots, ABB and Stäubli, and a common API for these five brands.
The publisher and the host of this website are given on the legal information page.
Trademarks
FANUC, ROBOGUIDE, KAREL and CRX are trademarks or registered trademarks of FANUC Corporation or its affiliates. YASKAWA, MOTOMAN, MOTOMAN NEXT, DX100, DX200, YRC1000, YRC1000micro, FS100, ERC, XRC, MRC, INFORM, MotoPlus and MotoSim are trademarks or registered trademarks of YASKAWA Electric Corporation or its affiliates. Universal Robots, PolyScope, URScript, URCap and e-Series are trademarks or registered trademarks of Universal Robots A/S or its affiliates. ABB, IRC5, OmniCore, RobotWare, RAPID and RobotStudio are trademarks or registered trademarks of ABB Ltd. or its affiliates. Stäubli, CS8, CS9, VAL 3 and Stäubli Robotics Suite are trademarks or registered trademarks of Stäubli International AG or its affiliates. Other product names, company names and brands in this documentation belong to their owners. They are used only to say which equipment the library communicates with.
UnderAutomation is an independent software publisher. It is not affiliated with, endorsed by or sponsored by FANUC Corporation, YASKAWA Electric Corporation, Universal Robots A/S, ABB Ltd., Stäubli International AG or their affiliates. This library is not a product of these companies. They do not certify, review or support it. UnderAutomation provides the support of the library.
Protocols and interoperability
The library communicates with the robot controllers through their network interfaces, with the SDK of each brand:
| Brand | Interfaces |
|---|---|
| Fanuc | SNPX, the web server of the controller, the Remote Motion Interface, Stream Motion, FTP and Telnet |
| Yaskawa | The High Speed Ethernet Server, the Ethernet Server, the web server and the FTP server of the controller |
| Universal Robots | The interfaces that Universal Robots documents: RTDE, the Primary Interface, the Dashboard Server, XML-RPC, the Interpreter Mode, the REST API of PolyScope X, sockets, and SSH and SFTP |
| ABB | Robot Web Services, the HTTP interface of the IRC5 and OmniCore controllers |
| Stäubli | The SOAP server and the FTP server of the CS8 and CS9 controllers |
For each method of the common API, the library chooses one of these interfaces at the connection: see Routing.
The library contains no source code and no binary of these robot makers. Some features need a software option, a setting, a mode or a program on the controller, for example a controller option for the Fanuc moves or the RAPID module UnderAutomationMotion.mod, published by UnderAutomation, that you load in the motion task for the ABB moves: see Which protocol for which task. Your controllers must have the options and the settings that the features you use need.
The robot models of the offline kinematics of the brand SDKs compute positions on a PC. They do not replace the data of the robot manufacturer.
Responsible use
The library can change the state of an industrial robot: it can switch the servo power, start and stop programs, write signals, variables and files, and move the arm. A robot is dangerous machinery.
The safety of people and machines is the responsibility of the integrator. The library does not replace a safety system. You are responsible for the risk assessment of your application and for its compliance with the machinery regulations that apply to you. Test your application with the simulator of the robot maker when there is one (see Work without a robot), then at reduced speed, in a cell with its safety functions active, before you use it in production.
Third-party components
The SDKs in the library contain code from the projects below. UnderAutomation modified this code (namespaces renamed, types made internal, code reduced and adapted) and the DLL is obfuscated. These components stay under their own licenses. The copyright notices and the full license texts are in the file THIRD-PARTY-NOTICES.txt, delivered with the DLL, the NuGet package, the Python package and the source code package.
FluentFTP is used by the Fanuc, Yaskawa and Stäubli SDKs: the DLL contains one copy of it. The other components come from the Universal Robots SDK. The ABB SDK contains no third-party code.
| Component | Version | Copyright | License | Used in the DLL for |
|---|---|---|---|---|
| FluentFTP | 39.4.0 | Robin Rodricks and FluentFTP Contributors | MIT | FTP client |
| SSH.NET | Unknown | Renci, Oleg Kapeljushnik, Gert Driesen and contributors | MIT | SSH and SFTP client |
| Bouncy Castle | Unknown | The Legion of the Bouncy Castle Inc. | Bouncy Castle License (MIT) | Elliptic curve cryptography of the SSH client |
| Chaos.NaCl | Unknown | Christian Winnerlein, Andrew Moon, Daniel J. Bernstein | Public domain | Ed25519 and Curve25519 of the SSH client |
| Mono (BigInteger, DataConverter) | Unknown | Novell, Inc., Xamarin Inc. | MIT | Big integers, binary conversions |
| Dynamic Language Runtime (part of the Mono BigInteger) | Unknown | Microsoft Corporation | Ms-PL | Big integers |
| PipeStream | 1.0 | James Kolpack | MIT | SSH client |
| BCrypt | Unknown | Damien Miller, Ryan D. Emerle | ISC | Private key files of the SSH client |
| Serpent S-boxes | Unknown | Brian Gladman, Sam Simpson | Free use with acknowledgement | Serpent cipher of the SSH client |
| Ulib (bit count routine) | Unknown | Zilong Tan | MIT | Big integers |
| .NET runtime (ArrayPool, HashAlgorithm) | Unknown | .NET Foundation and Contributors | MIT | Buffers, hash algorithms |
| SharpCompress | Unknown | Adam Hathcock | MIT | Archives and compression |
| DotNetZip (zlib port, through SharpCompress) | Unknown | Dino Chiesa and Microsoft Corporation | Ms-PL | Deflate, GZip and Zlib streams |
| jzlib | Unknown | ymnk, JCraft, Inc. | BSD 3-clause | Base of the zlib port |
| zlib | 1.2.3 (1.1.3 for jzlib) | Jean-loup Gailly and Mark Adler | zlib License | Base of the zlib port |
"Unknown": the version that the code was taken from is not known. In the source code package, the files of these components keep their original headers. The DotNetZip files stay under the Ms-PL, with the full text of the license next to them.
These packages are installed by NuGet or pip from their publishers. UnderAutomation does not redistribute them:
| Component | Copyright | License | Used by |
|---|---|---|---|
| System.Text.Encoding.CodePages | .NET Foundation and Contributors | MIT | netstandard2.0 and netstandard2.1 builds |
| pythonnet | the contributors of the Python.NET project | MIT | Python package only |
References
The inverse kinematics solvers of the brand SDKs are analytical implementations of the models described in these publications:
- Robots with an ortho-parallel basis and a spherical wrist (Fanuc and Yaskawa SDKs): Brandstötter, M., Angerer, A. and Hofbaur, M. "An Analytical Solution of the Inverse Kinematics Problem of Industrial Serial Manipulators with an Ortho-parallel Basis and a Spherical Wrist". Austrian Institute of Technology and UMIT, 2014. ResearchGate.
- Fanuc CRX collaborative robots, and Yaskawa robots with a wrist offset along the B axis (HC10, HC10DT, HC20SDT...), with an adaptation to the Yaskawa structure: Abbes, M. and Poisson, G. "Geometric Approach for Inverse Kinematics of the FANUC CRX Collaborative Robot". PRISME Laboratory, University of Orléans. Robotics 2024, 13(6), 91. doi:10.3390/robotics13060091.
- Universal Robots arms (Universal Robots SDK): Chen et al., IEEE ICASI 2017. IEEE Xplore.
We thank GitHub user Palatis, whose public work on the GE SRTP protocol was a technical reference for the SNPX implementation of the Fanuc SDK:
- Fanuc.RobotInterface, used as a reference for the SRTP protocol and its error handling.
- Wireshark GE SRTP dissector, used for validation and debugging.
The ABB SDK is based on the public ABB documentation of Robot Web Services.
License of the library
The use of the library is governed by its end user license agreement. Robotics has no license of its own: each brand in the library is licensed with the license of its brand SDK. See Licensing.