CanKit.Adapter.PCAN
0.4.0
dotnet add package CanKit.Adapter.PCAN --version 0.4.0
NuGet\Install-Package CanKit.Adapter.PCAN -Version 0.4.0
<PackageReference Include="CanKit.Adapter.PCAN" Version="0.4.0" />
<PackageVersion Include="CanKit.Adapter.PCAN" Version="0.4.0" />
<PackageReference Include="CanKit.Adapter.PCAN" />
paket add CanKit.Adapter.PCAN --version 0.4.0
#r "nuget: CanKit.Adapter.PCAN, 0.4.0"
#:package CanKit.Adapter.PCAN@0.4.0
#addin nuget:?package=CanKit.Adapter.PCAN&version=0.4.0
#tool nuget:?package=CanKit.Adapter.PCAN&version=0.4.0
CanKit.Adapter.PCAN
PEAK PCAN-Basic adapter for CanKit. Provides a unified .NET API to PCAN hardware on Windows via PCAN-Basic.
- Repository: https://github.com/pkuyo/CanKit
- Package:
CanKit.Adapter.PCAN - Depends on:
CanKit.Core
Requirements
- Install PEAK PCAN-Basic runtime/drivers.
- Ensure
PCANBasic.dllcan be loaded (installed in system or alongside your app).
简体中文
- 需要安装 PEAK PCAN-Basic 驱动/运行库。
- 请确认运行时可加载
PCANBasic.dll(系统已安装或放到程序目录)。
Install
# Core + PCAN adapter
dotnet add package CanKit.Core
dotnet add package CanKit.Adapter.PCAN
Endpoint Formats
pcan://PCAN_USBBUS1pcan://?ch=PCAN_PCIBUS1pcan:PCAN_USBBUS2
Quick Start
using CanKit.Core;
using CanKit.Core.Definitions;
// Open a PCAN channel by name (see PCAN-Basic docs), 500 kbps
using var bus = CanBus.Open("pcan://PCAN_USBBUS1", cfg => cfg.Baud(500_000));
var tx = new CanClassicFrame(0x700, new byte[] { 0x01 });
bus.Transmit(tx);
foreach (var rx in bus.Receive(1, 100))
{
var f = rx.CanFrame;
Console.WriteLine($"RX 0x{f.ID:X} dlc={f.Dlc}");
}
Discover Endpoints
using CanKit.Core.Endpoints;
foreach (var ep in BusEndpointEntry.Enumerate("pcan"))
{
Console.WriteLine($"{ep.Title}: {ep.Endpoint}");
}
Notes
- Classical and FD support depend on hardware and PCAN-Basic capabilities.
| 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 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. net8.0-windows7.0 is compatible. 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. |
| .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
- CanKit.Core (>= 0.4.0)
- Peak.PCANBasic.NET (>= 4.10.1.968)
-
net8.0
- CanKit.Core (>= 0.4.0)
- Peak.PCANBasic.NET (>= 4.10.1.968)
-
net8.0-windows7.0
- CanKit.Core (>= 0.4.0)
- Peak.PCANBasic.NET (>= 4.10.1.968)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
0.4.0
**Added**
- **New adapters:** `Vector` and `ControlCAN` adapters are now supported.
- **ZLG safety:** Automatic detection of the hardware **auto-send/throughput limit** to prevent oversend scenarios.
**Improved**
- **CanBus async reads:** Reworked the background async read task for better efficiency and stability.
- **Lower overhead:** Reduced value-copy costs for several method parameters to cut unnecessary allocations and CPU usage.
**Fixed**
- **Race on start/stop:** Eliminated a race condition when **starting** and **stopping** the background read task during initialization/shutdown.
*No breaking API changes are expected in this release.*