Introduction
Purpose of This Document
This document is the user's manual for the MicroPeckerX SocketCAN driver.
SocketCAN extends the Linux socket communication APIs so that CAN communication can be performed through sockets just like using internet protocols.
How to Use This Document
Each chapter explains how to install the product and how to use the sample programs. If you have any questions, refer to the FAQ or contact us. Please note that technical inquiries about the MicroPeckerX SocketCAN driver require a separate paid support agreement.
Terminology
The following table explains the terminology used in this document.
| Term | Description |
|---|---|
| CAN | Abbreviation of Controller Area Network. A communication protocol developed for in-vehicle networks and standardized as ISO 11898. |
| CAN FD | Abbreviation of CAN with Flexible Data-rate. An extension of CAN that enables faster transmission and larger payloads. Standardized as ISO 11898-1:2015. |
| SocketCAN | Linux's standard CAN communication framework. Treats CAN devices as network interfaces (such as can0 and can1) and works with standard commands and programs such as can-utils. |
| Arbitration Baudrate | Transfer speed of the section that sends frame identifiers (IDs) and other arbitration information. In CAN FD, this is slower than the data section. |
| Data Baudrate | Transfer speed of the data section. Configurable only for CAN FD. |
| Kernel Module | A driver that can be added dynamically to the Linux kernel. The SocketCAN driver falls into this category. |
| can-utils | A standard utility suite for working with CAN communication on Linux (includes cansend, candump, etc.). |
| mpdrv_run | Management script for the MicroPeckerX SocketCAN driver. Controls loading and unloading the driver and starting/stopping channels. |
| can0 / can1 | CAN interface names recognized on Linux. MicroPeckerX supports two channels. |
| SavvyCAN | Open-source software for CAN log analysis and transmission/reception. Visualizes CAN bus communication via a GUI. |
| Wireshark | Network analysis software that can capture and analyze packets for various protocols including CAN bus. |
| chmod | Linux command used to grant execution permissions to files and scripts. |
| AppImage | Portable executable format for Linux. Allows running software immediately without installation. |
Notes on Using This Document
- Reproduction, modification, or translation of any part of this document without the author's permission is prohibited unless permitted under copyright law.
- The information and images in this document reflect the status at the time of writing and may differ from the latest products or product website content (text, design, etc.).
- Company and product names mentioned in this document are trademarks or registered trademarks of their respective companies.
Verified Operating Environments
The MicroPeckerX SocketCAN driver supports the following Linux environments.
| Item | Details |
|---|---|
| Supported kernel | Ver. 4.xx to Ver. 5.xx |
| Verified environment | Ubuntu 18.04 (64-bit) x86 |
| Limitations | Fixed bit rate and sampling rate, hardware timestamp not used |