📦✨ socketcan-isotp

Socketcan IsoTP Rust crate

Docs

_{Built with 🦀}

SocketCAN ISO-TP crate. Based on socketcan-rs and isotp.h. The Linux kernel supports using CAN-devices through a [network-like API](https://www.kernel.org/doc/Documentation/networking/can.txt). This crate allows easy access to this functionality without having to wrestle libc calls. [ISO-TP](https://en.wikipedia.org/wiki/ISO_15765-2) or [ISO 15762-2](https://en.wikipedia.org/wiki/ISO_15765-2) allows sending data packets that exceed the eight byte of a default CAN frame. A common application of ISO-TP is for example [Unified Diagnostic Services (UDS)](https://en.wikipedia.org/wiki/Unified_Diagnostic_Services) used in automotive ECUs for diagnostics. [can-isotp](https://github.com/hartkopp/can-isotp) is an ISO-TP kernel module that takes care of handling the ISO-TP protocol. Instructions on how the can-isotp kernel module can be build and loaded can be found at [https://github.com/hartkopp/can-isotp](https://github.com/hartkopp/can-isotp). ```rust,no_run use socketcan_isotp::{self, IsoTpSocket, StandardId}; fn main() -> Result<(), socketcan_isotp::Error> { let mut tp_socket = IsoTpSocket::open( "vcan0", StandardId::new(0x123).expect("Invalid src id"), StandardId::new(0x321).expect("Invalid dst id"), )?; let buffer = tp_socket.read()?; println!("read {} bytes", buffer.len()); for x in buffer { print!("{:X?} ", x); } println!(""); Ok(()) } ``` # Dev Setup Setup Isotp Kernel Module: https://github.com/hartkopp/can-isotp Setup virtual can interface. ``` sudo modprobe vcan && \ sudo ip link add dev vcan0 type vcan && \ sudo ip link set up vcan0 ```