Ciplink 0.3.2

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package Ciplink --version 0.3.2
                    


                    

                
NuGet\Install-Package Ciplink -Version 0.3.2
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="Ciplink" Version="0.3.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Ciplink" Version="0.3.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Ciplink" />
                    


                            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 Ciplink --version 0.3.2
                    


                    

                
#r "nuget: Ciplink, 0.3.2"
#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 Ciplink@0.3.2
#: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=Ciplink&version=0.3.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Ciplink&version=0.3.2
                    


                            Install as a Cake Tool

Read and write tags on Allen-Bradley PLCs over EtherNet/IP from .NET.

Ciplink is the .NET binding of ciplink, a fork of pycomm3 rebuilt on a shared Rust core. The native library ships inside this package for Windows x64, Linux x64 and macOS (Apple Silicon and Intel), so there is nothing else to install.

  • Controllers: ControlLogix, CompactLogix, GuardLogix and Micro800 (LogixDriver); SLC 500 and MicroLogix (SlcDriver); generic CIP messaging with any EtherNet/IP device (CipDriver).
  • Tags: atomic types, arrays, strings, UDTs (whole or by member), AOIs, bits and BOOL arrays. Many tags share each packet, and large values are fragmented automatically.
  • Online-edit safe: tags are addressed by instance ID and checked against the controller's tag-table version, so an online edit never silently returns the wrong tag.
  • Thread-safe drivers, released with Dispose (using).

Install

dotnet add package Ciplink

Requires .NET 8 or later.

Quick start

using Ciplink;

using var plc = new LogixDriver("192.0.2.10");   // IP, IP/slot, or a full route such as 192.0.2.10/bp/2
plc.Open();

Tag counter = plc.Read("Counter");
Console.WriteLine(counter.IsOk ? $"{counter.Name} = {counter.Value}" : $"{counter.ErrorKind}: {counter.Error}");

foreach (Tag tag in plc.Read("Tank.Level", "Recipe{10}", "Motor.Running"))
    Console.WriteLine($"{tag.Name} ({tag.DataType}) = {tag.Value}");

plc.Write("Counter", 0);
plc.Write(("Tank.Setpoint", 75.5), ("Motor.Start", true));

Every read and write returns one Tag per request. A failure is reported on that tag through Error and ErrorKind (NotFound, BadValue, Access and so on) instead of being thrown, so one bad tag never fails a whole batch.

Values map to .NET types as long / ulong / double / bool / string for atomic types, object?[] for arrays, and Dictionary<string, object?> for UDTs. ReadAsync and WriteAsync are also available.

More

Product Compatible and additional computed target framework versions.
.NET 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 was computed.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net8.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
0.3.2 0 10/21/2026
0.3.1 0 10/21/2026
0.3.0 47 10/20/2026