UnderAutomation
Une question ?

[email protected]

Contactez-nous
UnderAutomation
⌘Q
Cette page est disponible uniquement en anglais.

Demo application

Windows demo application of UnderAutomation.Robotics: connect to a Fanuc, Yaskawa, Universal Robots, ABB or Stäubli controller, see the protocols and the route of each method, read the state, IO, variables, alarms and files. Read only. Download and sources.

  • Download
  • Connect
  • Panels
  • Command line
  • Read its source
  • What to read next

The demo application lets you try UnderAutomation.Robotics on your controller, or on a simulator, before you write any code. It is a Windows desktop application that connects to a Fanuc, Yaskawa, Universal Robots, ABB or Stäubli controller with RobotController, and shows what the library found: the result of each protocol, the route of each method of the common API, and the state, the signals, the variables, the alarms and the files of the controller.

The demo is read only. It connects and reads. It never moves the robot, never starts or stops a program, never switches the servo power, never resets an alarm and never writes a signal, a variable or a file of the controller. The only file it writes is the one you choose when you download a file, on your computer.

Download

Download RoboticsDemo.exe from the latest release of Robotics.NET.

There is no installer. The application is one self contained executable, built with .NET 8 for Windows: it runs on a PC without .NET. Copy it where you want, run it, delete it when you are done.

Windows can block a file downloaded from the internet. Right click the file, open Properties, check Unblock and click OK.

Connect

FieldContent
BrandOne of the five brands
AddressAddress of the controller or of the simulator
RoutingOptional routing settings as text, for example *=Snpx,Cgtp: see Routing settings
Licensee, License keyOptional. The key is registered with the SDK of the brand before the connection. Without a key, the trial of the brand applies: see Licensing
Dark themeSwitches between the light and the dark theme

The list on the left of the window has one page for the connection and one panel for each service. After Connect, the page Connection shows:

  • Protocols: for each protocol of the brand, the result of the connection (Open, NoAnswer, AuthenticationFailed, NotProbed...) and the detail given by the library.
  • Routes of the methods: for each method, read or write, available or not, the route and the protocol used, or the reason why the method is not available.

The connection runs in the background: the window stays usable while the protocols are tried. Without a controller at the address, the connection fails after the timeouts of the protocols, the message says so, and the protocols are listed as NoAnswer. The routes appear only once a protocol is open.

Panels

Each panel reads one service of RobotController, on the connection of the page Connection.

PanelServiceWhat it readsDocumentation
Staterobot.StateOperating mode, remote control, servo, program running, held, alarm presentState
Iorobot.IoA signal by its native name, the signals of a kindIo
Variablerobot.VariableA variable by its native name, the variables of a kindVariable
Alarmrobot.AlarmThe active alarms, and the last alarms of the historyAlarm
Filerobot.FileThe content of a directory, and the download of a fileFile

The panels show what the controller can do. After the connection, the demo calls IsAvailable for the main method of each panel (State.Read, Io.Read, Variable.Read, Alarm.ReadActive, File.List). When the method is not available on this controller, the panel is disabled, its first line gives the reason, and the list on the left says (not available). The buttons List and Read history follow the same rule with their own method. Before a connection, every panel is disabled.

The fields of the panels Io, Variable and File start with a name that exists on a standard controller of the brand. For a brand without a sample name, type one.

The download of a file asks where to save it, then shows the bytes received in a progress bar. Cancel stops the transfer, and nothing is written to your computer. When the controller gives no progress for this method, the bar moves without a value and Cancel is disabled.

An error of the controller or of the library is written in the panel, under the buttons, and the connection stays open. A list shows the first 500 items.

Command line

All the options are optional. They fill the fields, for example to show the same window again.

OptionContent
--brandfanuc, yaskawa, universalrobots, abb or staubli
--address or --ipAddress of the controller
--routingRouting settings as text
--themelight (default) or dark
--cultureLanguage of the messages, for example en-US. By default, the language of Windows
--connectConnects at once, without a click
--panelPage shown: connection, state, io, variable, alarm or file
--auto-readAfter the connection, runs the default read of the page chosen with --panel once. Nothing is written
RoboticsDemo.exe --brand fanuc --address 192.168.0.1 --connect --panel state --auto-read

An unknown brand or option is written in the status line, and the demo does not connect. The license key is not an option of the command line: type it in the window.

Read its source

The application is open source: folder Demo of github.com/underautomation/Robotics.NET. Its README gives the same information as this page.

It is a Windows Forms project for .NET 8. It uses the same RobotController as your code: there is nothing specific to the demo in the way it calls the library. Each panel is one C# file (StatePanel.cs, IoPanel.cs, VariablePanel.cs, AlarmPanel.cs, FilePanel.cs). To build it, you need the .NET 8 SDK on Windows, then run dotnet run in the folder. The folder Examples of the same repository holds console examples, one per topic.

What to read next

  • Connect to your robot: the connection parameters of each brand, in code.
  • Work without a robot: the simulators of the robot makers.
  • Routing: what the routes of the page Connection mean.
  • Get started with .NET: add the library to your project.