Introduction
Purpose of This Manual
This manual is the user guide for the MicroPeckerX SocketCAN driver.
SocketCAN extends the Linux socket communication API and enables CAN communication in the same way Internet protocols are handled via sockets.
How to Use This Manual
Each chapter explains topics such as product installation and sample programs.
If you have questions, please check the FAQ or contact us.
Technical inquiries related to the MicroPeckerX SocketCAN driver require a separate paid support contract.
Terminology
The terms used in this manual are described below.
| Term | Description |
|---|---|
| CAN | Abbreviation of Controller Area Network. A communication protocol developed for in-vehicle networks. An international standard defined by ISO 11898. |
| CAN FD | Abbreviation of CAN with Flexible Data-rate. An extended CAN protocol that enables higher speed and larger-capacity data transmission and reception. Standardized as ISO 11898-1:2015. |
| SocketCAN | Linux standard CAN communication framework. CAN devices can be handled as network interfaces (such as can0 and can1) and used with standard commands and programs (such as can-utils). |
| Arbitration Baudrate | Transmission speed for the section that sends frame identifiers (ID), etc. In CAN FD, this is lower than the data section speed. |
| Data Baudrate | Transmission speed for the data section. Configurable only for CAN FD. |
| Kernel Module | A driver that can be dynamically added to the Linux kernel. The SocketCAN driver also falls into this category. |
| can-utils | Standard Linux utility set for CAN communication (including cansend, candump, etc.). |
| mpdrv_run | Management script for the MicroPeckerX SocketCAN driver. Controls driver load/unload and channel start/stop. |
| can0 / can1 | CAN interface names recognized on Linux. MicroPeckerX supports 2 channels. |
| SavvyCAN | Open-source CAN log analysis and send/receive software. CAN bus communication can be visualized via GUI. |
| Wireshark | Network analysis software. Supports packet capture and analysis for various protocols including CAN bus. |
| chmod | Linux command used to grant execution permission to files and scripts. |
| AppImage | Portable executable format for Linux. Software can be run immediately without installation. |
Notes on Using This Manual
- Reproducing, modifying, or translating part or all of this manual without the author's permission is prohibited except where permitted by copyright law.
- Information and images in this manual are current at the time of writing and may differ from the latest product or product website content (text, design, etc.).
- Company names and product names in this manual are trademarks or registered trademarks of their respective owners.
Verified Environment
The MicroPeckerX SocketCAN driver supports the following Linux environment.
| 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 |