How to use socketcan-rs with Tokio?

Enable the 'tokio' feature in Cargo.toml, then use the tokio submodule to create async CanSocket instances. The library includes example code for bridges, showing non-blocking frame reading and writing.

socketcan-rs vs can-utils: which is better for Rust?

socketcan-rs provides a Rust-native API for programmatic CAN access in applications, while can-utils are C-based command-line tools for scripting. Choose socketcan-rs for building Rust apps that need integrated CAN communication, and can-utils for quick diagnostics or shell scripts.

Does socketcan-rs support CAN FD?

Yes, it fully supports CAN FD with proper handling of FDF flags, frame padding, and DLC management. Use CanFdSocket and related types to send and receive CAN FD frames, as detailed in the release notes.

How to parse candump logs with socketcan-rs?

Use the dump module, which includes a Reader iterator that returns CanDumpRecord items. It parses text logs with proper flag handling and is compatible with candump format, as updated in version 3.5.

Is socketcan-rs cross-platform?

No, it's Linux-only because it relies on the SocketCAN subsystem in the Linux kernel. For other operating systems, you'd need to find alternative CAN libraries or use bindings to system-specific APIs.

What's the minimum Rust version for socketcan-rs?

The Minimum Supported Rust Version (MSRV) is Rust v1.70 for the current version targeting Edition 2021. Always check the README for updates, as this may change with new releases.

Open-Awesome

mbr/socketcan

MITRustv3.6.2

A Rust library for Linux SocketCAN communication, providing network socket access to CAN bus with async support.

Visit Website GitHub

205 stars95 forks0 contributors

What is mbr/socketcan?

socketcan-rs is a Rust library that provides access to Linux's SocketCAN subsystem, enabling CAN bus communication through network sockets. It solves the problem of interacting with CAN devices from Rust applications on Linux, offering both synchronous and asynchronous APIs. The library supports standard CAN and CAN FD frames, interface configuration via Netlink, and integration with popular async runtimes.

Target Audience

Rust developers working on Linux systems who need to communicate with CAN buses in embedded systems, automotive applications, or industrial automation. It's also suitable for those building tools for CAN network analysis or simulation.

Value Proposition

Developers choose socketcan-rs because it provides a native, idiomatic Rust API for SocketCAN with optional async support for multiple runtimes, eliminating the need for C bindings or separate crates. Its comprehensive feature set, including CAN FD and Netlink control, makes it a one-stop solution for CAN communication in Rust.

Overview

Linux SocketCAN access in Rust

Use Cases

Best For

Building automotive diagnostic tools or telemetry systems in Rust
Developing embedded Linux applications that interface with CAN buses
Creating CAN network bridges or gateways with async I/O
Parsing and analyzing candump log files in Rust applications
Simulating CAN traffic for testing embedded systems
Implementing CAN communication in robotics or industrial control systems

Not Ideal For

Cross-platform applications targeting Windows or macOS
Projects needing easy, out-of-the-box testing without root access or virtual CAN device setup
Systems requiring hardware timestamps or precise timing, as this feature is still in development (issue #22)

Pros & Cons

Pros

Comprehensive Async Support

Optional integration with multiple runtimes (Tokio, async-std, smol) via feature flags, enabling non-blocking CAN operations for high-performance applications, as shown in the example bridge code.

CAN FD and Frame Handling

Supports CAN FD with proper frame padding and DLC management, plus dedicated types like CanDataFrame and CanRemoteFrame for robust frame handling.

Netlink Configuration

Allows full control over CAN interfaces via Netlink, enabling bitrate setting, mode control, and parameter querying directly from Rust, as enhanced in versions 3.1 and 3.2.

Embedded HAL Compatibility

Implements embedded_hal traits for CanFdSocket, making it compatible with embedded Rust projects and easing integration into hardware-focused applications.

Cons

Linux-Only Limitation

Tied exclusively to Linux's SocketCAN subsystem, making it unsuitable for projects on other operating systems and limiting portability.

Complex Testing Setup

Requires root access and manual setup of virtual CAN devices (e.g., vcan0) for testing, which complicates CI/CD pipelines and development workflows.

Missing Timestamp Support

Hardware timestamps are not yet implemented, as noted in issue #22, which can be a drawback for time-sensitive applications like real-time diagnostics.

Frequently Asked Questions

Related Projects

can-dbc

Rust dbc parser

Stars107

Forks42

Last commit9 days ago

tokio-socketcan

Asynchronous Linux SocketCAN sockets with tokio

Stars37

Forks16

Last commit3 years ago

Sensirion/lin-bus

Rust LIN bus driver traits and protocol implementation

Stars18

Forks9

Last commit1 year ago

tokio-socketcan-bcm

Asynchronous Linux SocketCAN - Broadcast Manager support (BCM) with tokio

Stars8

Forks5

Last commit5 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub