---
title: "Demo application"
description: "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."
---

# Demo application

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](https://github.com/underautomation/Robotics.NET/releases/latest/download/RoboticsDemo.exe)** from the [latest release](https://github.com/underautomation/Robotics.NET/releases/latest) 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

| Field                 | Content                                                                                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Brand                 | One of the five brands                                                                                                                                                               |
| Address               | Address of the controller or of the simulator                                                                                                                                        |
| Routing               | Optional routing settings as text, for example `*=Snpx,Cgtp`: see [Routing settings](/robotics/documentation/routing-settings)                                                        |
| Licensee, License key | Optional. The key is registered with the SDK of the brand before the connection. Without a key, the trial of the brand applies: see [Licensing](/robotics/documentation/license)                  |
| Dark theme            | Switches 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.

| Panel    | Service          | What it reads                                                               | Documentation                              |
| -------- | ---------------- | --------------------------------------------------------------------------- | ------------------------------------------ |
| State    | `robot.State`    | Operating mode, remote control, servo, program running, held, alarm present | [State](/robotics/documentation/state)     |
| Io       | `robot.Io`       | A signal by its native name, the signals of a kind                          | [Io](/robotics/documentation/io)           |
| Variable | `robot.Variable` | A variable by its native name, the variables of a kind                      | [Variable](/robotics/documentation/variable) |
| Alarm    | `robot.Alarm`    | The active alarms, and the last alarms of the history                       | [Alarm](/robotics/documentation/alarm)     |
| File     | `robot.File`     | The content of a directory, and the download of a file                      | [File](/robotics/documentation/file)       |

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.

| Option                | Content                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `--brand`             | `fanuc`, `yaskawa`, `universalrobots`, `abb` or `staubli`                                                                       |
| `--address` or `--ip` | Address of the controller                                                                                                       |
| `--routing`           | Routing settings as text                                                                                                        |
| `--theme`             | `light` (default) or `dark`                                                                                                     |
| `--culture`           | Language of the messages, for example `en-US`. By default, the language of Windows                                              |
| `--connect`           | Connects at once, without a click                                                                                               |
| `--panel`             | Page shown: `connection`, `state`, `io`, `variable`, `alarm` or `file`                                                          |
| `--auto-read`         | After the connection, runs the default read of the page chosen with `--panel` once. Nothing is written                          |

```text
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](https://github.com/underautomation/Robotics.NET/tree/main/Demo) of [github.com/underautomation/Robotics.NET](https://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](https://github.com/underautomation/Robotics.NET/tree/main/Examples) of the same repository holds console examples, one per topic.

## What to read next

- [Connect to your robot](/robotics/documentation/connect): the connection parameters of each brand, in code.
- [Work without a robot](/robotics/documentation/simulator): the simulators of the robot makers.
- [Routing](/robotics/documentation/routing): what the routes of the page Connection mean.
- [Get started with .NET](/robotics/documentation/get-started-net): add the library to your project.