UnderAutomation.Yaskawa 3.0.1

dotnet add package UnderAutomation.Yaskawa --version 3.0.1
                    
NuGet\Install-Package UnderAutomation.Yaskawa -Version 3.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="UnderAutomation.Yaskawa" Version="3.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="UnderAutomation.Yaskawa" Version="3.0.1" />
                    
Directory.Packages.props
<PackageReference Include="UnderAutomation.Yaskawa" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add UnderAutomation.Yaskawa --version 3.0.1
                    
#r "nuget: UnderAutomation.Yaskawa, 3.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package UnderAutomation.Yaskawa@3.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=UnderAutomation.Yaskawa&version=3.0.1
                    
Install as a Cake Addin
#tool nuget:?package=UnderAutomation.Yaskawa&version=3.0.1
                    
Install as a Cake Tool

Yaskawa Robot Communication SDK for .NET

UnderAutomation Yaskawa communication SDK

NuGet NuGet downloads .NET Framework .NET Standard .NET License

UnderAutomation.Yaskawa is a fully managed .NET SDK that communicates with Yaskawa Motoman robot controllers (YRC1000 (micro), MOTOMAN NEXT, DX100 / DX200, FS100, ERC / XRC / MRC) through the High Speed Ethernet Server (HSES) of the controller, over UDP, and through the Ethernet Server (TCP), the web server (HTTP) and the FTP server of the controller. Nothing is installed on the controller.

Use it to read the status, the alarms and the positions, move the robot, select and start jobs, read and write variables and I/O, transfer files, and compute the forward and inverse kinematics of 169 robot models, from a normal .NET application.

What you can do

  • Status and alarms: read the status of the controller (mode, servo, hold, alarm), read the last alarms, reset the alarms.
  • Positions: read the Cartesian position, the joint position in pulses, the position error and the torque of each axis.
  • Motion: servo on and off, Cartesian moves and joint moves, with a speed and a coordinate system.
  • Jobs: select and start a job, read the executing job and the job stack.
  • Variables: read and write registers, byte, integer, double integer, real and string variables, position variables, base and external axis positions.
  • Inputs / Outputs: read and write the I/O signals by address or by type and group.
  • Files: list, download, upload and delete files, with a progress callback.
  • System: system information, management times (operating, servo and playback time), system parameters, message on the pendant.
  • Ethernet Server: the same kind of functions over TCP, with alarm texts, positions in a user or tool frame, encoder temperatures, and a call that waits for the end of a job.
  • FTP and HTTP: download, upload and delete files over FTP, read files through the web server.
  • Offline kinematics: forward kinematics and every inverse kinematics solution of 169 Motoman arms and cobots, on the PC, with DH parameters from a catalog or from the ALL.PRM file of the controller.
Protocol Property of YaskawaRobot Port Enabled by default
High Speed Ethernet Server HighSpeedEServer UDP 10040 and 10041 Yes
Ethernet Server EServer TCP 80 No
HTTP Http TCP 80 No
FTP Ftp TCP 21 No

Example application

A Windows Forms application shows the features of the SDK. Its source code is in this repository, in UnderAutomation.Yaskawa.Showcase.Forms.

Download: UnderAutomation.Yaskawa.Showcase.Forms.exe (all releases)

Installation

dotnet add package UnderAutomation.Yaskawa

Or with the NuGet Package Manager console:

Install-Package UnderAutomation.Yaskawa

You can also download UnderAutomation.Yaskawa.zip from the releases page. It contains one folder per target framework. On Windows, unblock the zip file before you extract it (right-click, "Properties", "Unblock"), then reference the DLL of your framework.

Getting started

using UnderAutomation.Yaskawa;
using UnderAutomation.Yaskawa.HighSpeedEServer;

// The SDK runs in trial mode for 30 days. Register your key to remove the trial limit.
YaskawaRobot.RegisterLicense("Your Company", "your-license-key");

var robot = new YaskawaRobot();
robot.Connect("192.168.0.1");

RobotStatusData status = robot.HighSpeedEServer.GetStatusInformation();
Console.WriteLine($"Servo on: {status.ServoOn}, alarm: {status.Alarming}");

robot.Disconnect();

To change the ports or the timeouts, use ConnectParameters:

var parameters = new ConnectParameters("192.168.0.1");
parameters.PingBeforeConnect = true;                         // default
parameters.HighSpeedEServer.DataPort = 10040;                // default
parameters.HighSpeedEServer.DataTimeoutMilliseconds = 1500;  // default
robot.Connect(parameters);

Features

The sections below use the High Speed Ethernet Server, through robot.HighSpeedEServer. The other protocols and the kinematics follow.

Status and alarms

RobotStatusData status = robot.HighSpeedEServer.GetStatusInformation();
Console.WriteLine($"Teach: {status.Teach}, Play: {status.Play}, Running: {status.Running}");

RobotAlarmData alarm = robot.HighSpeedEServer.GetAlarm(RobotRecentAlarm.Latest);
Console.WriteLine($"{alarm.Code} {alarm.Text} ({alarm.OccurringTime})");

robot.HighSpeedEServer.AlarmReset(AlarmResetType.Reset);

Positions

RobotPositionCartesianData position = robot.HighSpeedEServer.GetRobotCartesianPosition();
Console.WriteLine($"X={position.X} Y={position.Y} Z={position.Z} Rx={position.Rx} Ry={position.Ry} Rz={position.Rz}");

// Pulses of each axis
RobotPositionIntData joints = robot.HighSpeedEServer.GetRobotJointPosition();
Console.WriteLine(string.Join(", ", joints.Axes));

RobotAxisIntData error = robot.HighSpeedEServer.GetPositionError();
RobotAxisIntData torque = robot.HighSpeedEServer.GetTorque();

Motion

The robot must be in remote mode, see "Configure the robot" below.

robot.HighSpeedEServer.SetServo(true);

// Cartesian move: mm and degrees, speed in mm/s, in the robot coordinate system
robot.HighSpeedEServer.MoveCartesian(
    x: 1000, y: 10, z: 0, rx: 0, ry: 0, rz: 0,
    PositionCommandClassification.Cartesian_MM_S,
    speed: 10,
    PositionCommandOperationCoordinate.Robot);

// Joint move: pulses of each axis, speed in % of the maximum speed
robot.HighSpeedEServer.MoveJoints(new int[] { 1000, 0, 0, 0, 0, 0 }, PositionCommandClassification.LinkPercent, 10);

Optional parameters of MoveCartesian and MoveJoints: command type (LinkAbsolute, StraightAbsolute, StraightIncrement), posture, control groups, tool and user coordinate numbers.

Jobs

robot.HighSpeedEServer.SelectJob("PROGRAM", line: 0);
robot.HighSpeedEServer.StartJob();

RobotJobData job = robot.HighSpeedEServer.GetExecutingJobInformation();
Console.WriteLine($"{job.Name} line {job.Line}, step {job.Step}");

Variables

Each read method takes the first index and the number of values, and returns an object with a Value array. Each write method takes the first index and an array.

RobotRegisterData registers = robot.HighSpeedEServer.ReadRegister(firstIndex: 0, count: 5);
robot.HighSpeedEServer.WriteRegister(0, new short[] { 100, 200 });

RobotByteVariableData bytes = robot.HighSpeedEServer.ReadByte(0, 4);
RobotIntegerVariableData integers = robot.HighSpeedEServer.ReadInteger(0, 4);
RobotDoubleIntegerVariableData doubleIntegers = robot.HighSpeedEServer.ReadDoubleInteger(0, 4);
RobotRealVariableData reals = robot.HighSpeedEServer.ReadReal(0, 4);
RobotStringVariableData strings = robot.HighSpeedEServer.Read16BytesChar(0, 2);
RobotStringVariableData longStrings = robot.HighSpeedEServer.Read32BytesChar(0, 2);

RobotPositionVariableData positions = robot.HighSpeedEServer.ReadPositionVariable(1, 4);
RobotBasePositionVariableData basePositions = robot.HighSpeedEServer.ReadBasePosition(0, 1);
RobotExternalAxisVariableData externalPositions = robot.HighSpeedEServer.ReadExternalPosition(0, 1);

Inputs / Outputs

The first index selects the signal area, for example 1 to 512 for the robot user inputs, 1001 to 1512 for the robot user outputs, 2701 to 2956 for the network inputs. Each index is one byte of 8 signals. The number of bytes is even: ReadIO rounds it up, WriteIO needs an even length.

RobotIOData outputs = robot.HighSpeedEServer.ReadIO(firstIndex: 1001, count: 4);
Console.WriteLine(BitConverter.ToString(outputs.Value));

robot.HighSpeedEServer.WriteIO(2701, new byte[] { 1, 0 });

// Or by type and group
RobotIOData inputs = robot.HighSpeedEServer.ReadIO(IOType.GeneralInput, 1, 2);

Files

string[] files = robot.HighSpeedEServer.GetFileList("*.JBI").Files;

robot.HighSpeedEServer.LoadFile("PROGRAM.JBI", File.ReadAllText("PROGRAM.JBI"),
    progress => Console.WriteLine($"{progress.LoadedBytes} / {progress.TotalBytes}"));

RobotFileContentData file = robot.HighSpeedEServer.GetFile("PROGRAM.JBI");
Console.WriteLine(file.Content);

robot.HighSpeedEServer.DeleteFile("PROGRAM.JBI");

System

RobotSystemInformation system = robot.HighSpeedEServer.GetSystemInformation();
Console.WriteLine($"{system.Name} {system.SoftwareVersion}");

RobotManagementTimeData servoTime = robot.HighSpeedEServer.GetManagementTime(ManagementTimeType.ServoPowerOnTimeTotal);

robot.HighSpeedEServer.Display("Hello from .NET");

Ethernet Server

Enable it with EServer.Enable. Commands refused by the controller throw a HostControlException.

var parameters = new ConnectParameters("192.168.0.1");
parameters.EServer.Enable = true;
robot.Connect(parameters);

HostControlStatusData status = robot.EServer.GetStatusInformation();
HostControlAlarmStringData alarms = robot.EServer.GetAlarmWithMessages();
HostControlCartesianPositionData tcp = robot.EServer.GetRobotCartesianPosition(HostControlCoordinateSystem.User1);

robot.EServer.SelectJob("PICK", 0);
robot.EServer.SetServo(true);
robot.EServer.StartJob();
bool completed = robot.EServer.WaitForJobCompletion(60); // blocks until the end of the job, 60 s at most

FTP

Enable it with Ftp.Enable. The anonymous account (default) can only download: use ftp to upload and delete. Every method also has an async version.

var parameters = new ConnectParameters("192.168.0.1");
parameters.Ftp.Enable = true;
parameters.Ftp.FtpUser = "ftp";
robot.Connect(parameters);

FtpListItem[] jobs = robot.Ftp.GetListing("/JOB");
robot.Ftp.DownloadFilesToLocal(new[] { "/JOB/TEST.JBI", "/DAT/VAR.DAT" }, @"C:\Backup");

// The controller does not overwrite a job by FTP: delete it first
if (robot.Ftp.FileExists("/JOB/PICK.JBI")) robot.Ftp.DeleteFile("PICK.JBI");
robot.Ftp.UploadFileFromLocal(@"C:\Jobs\PICK.JBI");

HTTP

Enable it with Http.Enable. It reads files in any mode, without an account.

foreach (FileDescription file in robot.Http.GetFileList(FileExtension.DAT))
    Console.WriteLine($"{file.Name}: {file.Description}");

string job = robot.Http.GetFile("TEST.JBI");

Offline kinematics

using UnderAutomation.Yaskawa.Common;
using UnderAutomation.Yaskawa.Kinematics;

DhParameters dh = DhParameters.FromArmKinematicModel(ArmKinematicModels.GP7); // or DhParameters.FromPrmFile("ALL.PRM")

// Joint angles in degrees (S, L, U, R, B, T) to flange position in mm and degrees
CartesianPosition flange = KinematicsUtils.ForwardKinematics(new JointsAngles(0, 0, 0, 0, -90, 0), dh);

// Every joint solution for a flange position: up to 8, or 16 for the HC10 cobots
JointsAngles[] solutions = KinematicsUtils.InverseKinematics(new CartesianPosition(400, 100, 300, 180, 0, 0), dh);

Configure the robot

The read methods work in any mode. The commands (servo, motion, job start, file write) need these settings on the controller.

Enable the remote commands

  • Set the management mode to Security mode.
  • Select IN/OUT > PSEUDO INPUT SIGNAL.
  • Move the cursor to #82015 CMD REMOTE SEL and press INTER LOCK + SELECT.

Enable remote command

Put the key in the remote position

The commands need the key of the pendant in the remote position.

Pendant remote key

To use the key for the remote control, copy #80011 (key in the remote position) to #40042 (remote control enabled) with the ladder editor:

  • Set the management mode to Security mode.
  • Select IN/OUT > LADDER EDITOR.
  • Check that no other rung writes #40042, then add this rung:

Ladder remote key

Allow the job selection

  • Set the management mode to Security mode.
  • Select SETUP > FUNCTION ENABLE.
  • Set JOB SELECT WHEN REMOTE AND PLAY to PERMIT. On the Smart Pendant, set SC2 224 to 0.

Job select when remote and play

Allow the file overwrite

To send a file that already exists on the controller:

  • Set the management mode to Security mode.
  • Select PARAMETER > RS.
  • Set RS029 to 1 and RS214 to 1.

Shell sources

The folder UnderAutomation.Yaskawa.ObfuscatedSources contains every public type and member of the SDK, with its XML documentation. The bodies of the methods are replaced by "Source is hidden". Use it to:

  • browse the public API and its documentation on GitHub;
  • jump to a definition from your code editor;
  • see the structure of the code that is delivered with a source license.

The source license gives the complete source code of the library, with the Visual Studio solution. See the license page of the documentation.

Compatibility

Target framework Supported
.NET 10.0 / 9.0 / 8.0 / 6.0 / 5.0 yes
.NET Core 3.0 yes
.NET Standard 2.1 / 2.0 yes
.NET Framework 4.0 to 4.8 yes
.NET Framework 3.5 yes
  • Operating systems: Windows, Linux, macOS.
  • No native dependency. The netstandard2.0 build uses the NuGet package System.Text.Encoding.CodePages.
  • Controllers: Yaskawa YRC1000 (micro), MOTOMAN NEXT, DX100 / DX200, FS100, ERC / XRC / MRC, with the High Speed Ethernet Server.

License

This SDK needs a commercial license. A 30-day trial starts at the first use, no key needed.

Support

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 is compatible.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net35 is compatible.  net40 is compatible.  net403 was computed.  net45 is compatible.  net451 is compatible.  net452 is compatible.  net46 is compatible.  net461 is compatible.  net462 is compatible.  net463 was computed.  net47 is compatible.  net471 is compatible.  net472 is compatible.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETCoreApp 3.0

    • No dependencies.
  • .NETFramework 3.5

    • No dependencies.
  • .NETFramework 4.0

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETFramework 4.5.1

    • No dependencies.
  • .NETFramework 4.5.2

    • No dependencies.
  • .NETFramework 4.6

    • No dependencies.
  • .NETFramework 4.6.1

    • No dependencies.
  • .NETFramework 4.6.2

    • No dependencies.
  • .NETFramework 4.7

    • No dependencies.
  • .NETFramework 4.7.1

    • No dependencies.
  • .NETFramework 4.7.2

    • No dependencies.
  • .NETFramework 4.8

    • No dependencies.
  • .NETStandard 2.0

  • .NETStandard 2.1

    • No dependencies.
  • net10.0

    • No dependencies.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.1 277 10/5/2026
2.2.0 1,254 3/26/2026
2.1.0 150 3/14/2026
2.0.0 159 3/13/2026
1.7.0 709 12/1/2025
1.6.1 252 11/27/2025
1.5.0 276 11/25/2025
1.4.0 266 11/25/2025
1.3.0 458 9/22/2025
1.2.0 281 6/16/2025
1.1.0 334 3/12/2025
1.0.0 253 2/10/2025