libplctag.NativeImport
1.0.41
See the version list below for details.
dotnet add package libplctag.NativeImport --version 1.0.41
NuGet\Install-Package libplctag.NativeImport -Version 1.0.41
<PackageReference Include="libplctag.NativeImport" Version="1.0.41" />
paket add libplctag.NativeImport --version 1.0.41
#r "nuget: libplctag.NativeImport, 1.0.41"
// Install libplctag.NativeImport as a Cake Addin #addin nuget:?package=libplctag.NativeImport&version=1.0.41 // Install libplctag.NativeImport as a Cake Tool #tool nuget:?package=libplctag.NativeImport&version=1.0.41
libplctag.NativeImport
libplctag.NativeImport provides low-level (raw) access to the libplctag core library which is written in C. The purpose of this package is to expose the API for this library to .NET applications, and handle platform and configuration issues.
NOTE: Most application developers will not need to directly reference the Native Import library, it is primarily for use by other wrapper libraries.
Example
var tagHandle = plctag.plc_tag_create("protocol=ab_eip&gateway=10.10.10.10&path=1,0&plc=LGX&elem_size=4&elem_count=1&name=PROGRAM:SomeProgram.SomeDINT", 5000);
var statusAfterCreate = (STATUS_CODES)plctag.plc_tag_status(tagHandle);
if (statusAfterCreate != STATUS_CODES.PLCTAG_STATUS_OK)
{
throw new Exception($"Something went wrong: {statusAfterCreate}");
}
var statusAfterRead = (STATUS_CODES)plctag.plc_tag_read(tagHandle, 5000);
if (statusAfterRead != STATUS_CODES.PLCTAG_STATUS_OK)
{
throw new Exception($"Something went wrong: {statusAfterRead}");
}
var theValue = plctag.plc_tag_get_uint32(tagHandle, 0);
Console.WriteLine(theValue);
plctag.plc_tag_destroy(tagHandle);
Further examples can be found here.
How it works
During initialization, this package extracts to disk the appropriate (platform-specific) core library.
By default, it will overwrite files with the same filename (plctag.dll
, libplctag.so
, or libplctag.dylib
).
If you wish to disable this behaviour and use a different core library (e.g. one that you've compiled yourself, or a pre-release), you can disable the Force Extract feature.
// Before any calls to any libplctag methods
plctag.ForceExtractLibrary = false;
The libplctag core library can be compiled for many platforms, and not all supported platforms are shipped with this wrapper.
If you get a TypeLoadException
, chances are that you can still use this wrapper but you will need to supply the runtime yourself.
Developing for systems with immutable application directories
UWP, Xamarin.Forms and some other frameworks produce executables that, when installed, can not modify their own application directory. libplctag.NativeImport relies on the ability to extract the native library to this location, so on these platforms, libplctag will not work.
The workaround is to supply the appropriate binary(ies) yourself:
- Get the core library (e.g. plctag.dll) from Releases.
- Add this file to your project such that it is copied to the output directory.
- Set
plctag.ForceExtractLibrary = false
before any other calls to libplctag.
Watch out for x64/x86 mismatches between the native library you downloaded and your solution.
This bug is tracked in https://github.com/libplctag/libplctag.NET/issues/137
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. 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. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on libplctag.NativeImport:
Package | Downloads |
---|---|
libplctag
A library for PLC communication |
|
ABPlcRx
A Reactive Allen Bradley PLC library |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on libplctag.NativeImport:
Repository | Stars |
---|---|
libplctag/libplctag.NET
A .NET wrapper for libplctag.
|
Version | Downloads | Last updated |
---|---|---|
2.0.0-alpha.4 | 78 | 9/7/2024 |
2.0.0-alpha.3 | 88 | 8/22/2024 |
2.0.0-alpha.2 | 683 | 7/26/2024 |
2.0.0-alpha.1 | 59 | 7/17/2024 |
2.0.0-alpha.0 | 49 | 7/17/2024 |
1.0.41 | 5,174 | 7/13/2024 |
1.0.40 | 461 | 7/12/2024 |
1.0.39 | 1,902 | 6/15/2024 |
1.0.38 | 140 | 6/8/2024 |
1.0.37 | 71,901 | 12/1/2022 |
1.0.36 | 463 | 11/19/2022 |
1.0.35 | 511 | 11/4/2022 |
1.0.34 | 7,068 | 9/28/2022 |
1.0.33 | 11,479 | 7/5/2022 |
1.0.32 | 7,723 | 2/14/2022 |
1.0.31 | 1,020 | 1/27/2022 |
1.0.30 | 500 | 1/10/2022 |
1.0.29 | 433 | 12/31/2021 |
1.0.28 | 406 | 12/27/2021 |
1.0.25 | 2,029 | 12/16/2021 |
1.0.24 | 2,922 | 11/25/2021 |
1.0.23 | 395 | 11/14/2021 |
1.0.22 | 903 | 11/5/2021 |
1.0.21 | 472 | 10/28/2021 |
1.0.20 | 393 | 10/24/2021 |
1.0.19 | 3,066 | 10/15/2021 |
1.0.18 | 467 | 10/15/2021 |
1.0.17 | 12,425 | 9/24/2021 |
1.0.16 | 667 | 9/22/2021 |
1.0.15 | 708 | 9/18/2021 |
1.0.14 | 840 | 8/30/2021 |
1.0.13 | 3,267 | 3/20/2021 |
1.0.12 | 5,456 | 3/13/2021 |
1.0.11 | 456 | 3/13/2021 |
1.0.10 | 2,485 | 3/7/2021 |
1.0.9 | 739 | 2/24/2021 |
1.0.8 | 389 | 2/21/2021 |
1.0.8-beta.1 | 162 | 2/21/2021 |
1.0.7 | 442 | 2/16/2021 |
1.0.7-beta.0 | 161 | 2/16/2021 |
1.0.6 | 419 | 2/14/2021 |
1.0.5 | 388 | 2/13/2021 |
1.0.4 | 418 | 2/9/2021 |
1.0.3 | 394 | 2/4/2021 |
1.0.2 | 8,101 | 1/11/2021 |
1.0.1 | 1,814 | 10/28/2020 |
1.0.0 | 981 | 9/16/2020 |
0.0.14 | 761 | 9/9/2020 |
0.0.13 | 514 | 9/9/2020 |
0.0.12 | 487 | 9/1/2020 |
0.0.11-beta | 2,208 | 8/4/2020 |
0.0.11-alpha | 502 | 7/29/2020 |
0.0.10-alpha | 435 | 7/27/2020 |
0.0.9-alpha | 461 | 7/25/2020 |
0.0.8-alpha | 489 | 7/21/2020 |
0.0.7-alpha | 521 | 7/18/2020 |
0.0.6-alpha | 414 | 7/14/2020 |
0.0.5-alpha | 487 | 7/11/2020 |
0.0.4-alpha | 389 | 7/11/2020 |