C# 统一工业 CAN 设备通信：跨平台、多厂商、高性能的通信库

DotNet技术匠 · 2026-4-17 10:08:50

前言

工业自动化、汽车电子、能源控制等嵌入式与实时通信场景中，CAN（Controller Area Network）总线因其高可靠性、强抗干扰能力和成熟的生态，长期占据核心地位。然而，开发在实际使用中常面临一个棘手问题：不同厂商的 CAN 接口卡（如 Vector、PEAK、Kvaser、周立功等）各自提供独立的 SDK 和 API，导致代码高度耦合于特定硬件。一旦更换设备，几乎需要重写整个通信层。

本文推荐一个统一的、跨平台的、支持多厂商的高性能 C# CAN 通信库。

项目介绍

面向 .NET 的开源 CAN 通信框架，目标是提供一套与硬件无关的统一接口，用同一套 C# 代码即可操作来自不同厂商的 CAN 设备。

项目采用模块化设计，核心库（CanKit.Core）定义通用抽象，各厂商适配器（如 CanKit.Adapter.PCAN、CanKit.Adapter.Kvaser 等）实现具体驱动对接。

目前支持 Windows 与 Linux 平台，覆盖主流工业与车载 CAN 硬件。

项目功能

安装包

需先安装核心包，再根据实际使用的硬件按需添加对应的适配器包：

# 核心库（必须）

dotnet add package CanKit.Core

# 适配器包（按需选择）

dotnet add package CanKit.Adapter.Vector

dotnet add package CanKit.Adapter.PCAN

dotnet add package CanKit.Adapter.Kvaser

dotnet add package CanKit.Adapter.SocketCAN

dotnet add package CanKit.Adapter.ZLG

dotnet add package CanKit.Adapter.ControlCAN

dotnet add package CanKit.Adapter.Virtual

注意：各厂商的底层驱动或运行库（如 PCAN-Basic、Kvaser CANlib、ZLGCAN.dll 等）需单独安装，并确保其版本与应用程序架构（x86/x64）匹配。具体要求请参考各适配器的官方说明。

项目特性

高性能与背压控制

高吞吐量流水线设计

背压友好的异步接口（基于 ValueTask 和 Channel<t>）

可配置接收/发送缓冲容量，有效防止过载与丢帧

统一 API

支持通过 Endpoint 字符串（如 pcan://PCAN_USBBUS1）或 强类型入口（如 Kvaser.Open(0)）打开总线

提供 BusEndpointEntry.Enumerate() 方法枚举可用设备

兼容 经典 CAN 2.0 与 CAN FD 帧类型

同步/异步双模式

Transmit() / Receive()

TransmitAsync() / ReceiveAsync()

.NET 8+ 支持 GetFramesAsync() 批量拉取

事件驱动支持

FrameReceived

ErrorFrameReceived

BackgroundExceptionOccurred

定时与工作模式

支持经典 CAN 与 CAN FD 的位时序参数配置（Tseg1、Tseg2、Brp、SJW 等）

工作模式可选：正常模式、只听模式（Listen Only）、回环模式（Loopback），具体取决于硬件能力

过滤器

提供统一的 掩码过滤 与 范围过滤 配置接口

当硬件不支持指定过滤类型时，自动启用 软件回退机制

周期发送

优先使用设备支持的 硬件周期发送（如 Kvaser、Vector）

若硬件不支持，则自动切换为 高精度软件周期发送

诊断与监控

实时获取 错误帧、总线状态（Active/Passive/BusOff）

支持读取 错误计数器（TEC/REC）

部分适配器可查询 总线利用率（依赖驱动实现）

运行时选项

可动态配置

异步接收缓冲区大小

接收循环延迟与停止策略

发送重试策略（单次发送 / 自动重试）

是否启用错误帧与诊断信息上报

项目使用

1、Endpoint 示例

CanKit 使用统一的 Endpoint 字符串标识不同厂商设备，常见格式如下：

Vector: vector://AppName/0

PCAN: pcan://PCAN_USBBUS1

Kvaser: kvaser://0 或 kvaser://?ch=0

SocketCAN (Linux): socketcan://can0netlink

ZLG: zlg://USBCANFD-200U?index=0ch1

ControlCAN: controlcan://USBCAN2?index=0ch1

Virtual（虚拟总线）: virtual://alpha/0

2、发送与接收（基础用法）

using CanKit.Core;

using CanKit.Core.Definitions;

// 打开总线并配置经典 CAN 比特率（500 kbps）

usingvar bus = CanBus.Open(

"socketcan://can0netlink",

cfg => cfg.TimingClassic(500_000)

);

// 创建一帧经典 CAN 数据

var frame = CanFrame.Classic(0x123, newbyte[] { 0x11, 0x22, 0x33 });

// 同步发送

var sentCount = bus.Transmit(frame);

// 异步发送

sentCount = await bus.TransmitAsync(frame);

// 同步接收（最多 2 帧，超时 100ms）

var items = bus.Receive(2, timeOut: 100);

// 异步批量接收（最多 10 帧，超时 500ms）

var list = await bus.ReceiveAsync(10, timeOut: 500);

3、事件驱动接收 + 批量发送

using CanKit.Core;

using CanKit.Core.Abstractions;

using CanKit.Core.Definitions;

using System;

// 打开总线

usingvar bus = CanBus.Open(

"socketcan://can0netlink",

cfg => cfg.TimingClassic(500_000)

);

// 订阅帧接收事件

bus.FrameReceived += (_, rec) =>

{

var f = rec.CanFrame;

Console.WriteLine($"RX {f.FrameKind} ID=0x{f.ID:X} DLC={f.Dlc}");

};

var frame = CanFrame.Classic(0x123, newbyte[] { 0x11, 0x22, 0x33 });

var frames = new[] { frame, frame, frame, frame };

// 批量同步发送

var sentCount = bus.Transmit(frames);

// 批量异步发送

sentCount = await bus.TransmitAsync(frames);

// 按需拉取数据（可选）

var one = bus.Receive(1, timeOut: 100);

var many = await bus.ReceiveAsync(10, timeOut: 500);

注：如需接收错误帧或状态帧，请在 CanBus.Open 的配置中启用对应选项。

4、强类型入口（可选）

若偏好强类型 API，可直接使用适配器类：

using CanKit.Adapter.Kvaser;

var bus = Kvaser.Open(0, cfg => cfg.TimingFd(1_000_000, 2_000_000)); // CAN FD 配置

5、枚举可用设备

using CanKit.Core.Endpoints;

// 枚举指定类型的可用 Endpoint

foreach (var ep in BusEndpointEntry.Enumerate("pcan", "kvaser", "socketcan", "virtual"))

{

Console.WriteLine($"{ep.Title ?? ep.Endpoint} -> {ep.Endpoint}");

}

6、查询设备能力

using CanKit.Core;

var capability = CanBus.QueryCapabilities("kvaser://0");

Console.WriteLine($"支持的功能: {capability.Features}");

适配器说明（驱动依赖）

厂商	平台	依赖说明
Vector	Windows/Linux	安装 XL Driver Library，并在 Vector Hardware Manager 中配置 App 映射
PCAN	Windows	安装 PCAN 驱动与 PCAN-Basic；确保 PCANBasic.dll 可加载（注意 x86/x64 匹配）
Kvaser	Windows/Linux	安装 Kvaser Driver + CANlib；确保通道可访问
SocketCAN	Linux	启用内核 SocketCAN 支持，通过 ip link 配置接口；建议安装 libsocketcan
ZLG	Windows	确保 zlgcan.dll 在程序路径中，且位数匹配。建议编译为 x86，部分老设备（如 USBCAN-1/2）在 x64 下无法正常开启
ControlCAN	Windows	确保 ControlCAN.dll 在加载路径，且与进程架构一致
Virtual	跨平台	无需驱动，纯内存模拟