はじめに
本書の目的
本書は、MicroPeckerX SocketCANドライバのユーザーズマニュアルです。
SocketCANでは、Linuxのソケット通信のAPIを拡張し、ソケットを介したインターネットプロトコルの使用と同様にCAN通信を行うことができます。
本書の使い方
各章では、本製品のインストールの仕方やサンプルスクリプトなどについて説明します。
疑問点がある場合は、FAQをご覧頂くか、弊社へお問い合わせください。
ただし、MicroPeckerX SocketCANドライバに関する技術的な問い合わせは、別途有償サポート契約が必要です。
用語説明
本書で使用する用語の説明を以下に記述します。
| 用語 | 説明 |
|---|---|
| CAN | Controller Area Networkの略称。 車載ネットワーク用に開発された通信プロトコル。ISO 11898で規定された国際標準規格。 |
| CAN FD | CAN with Flexible Data-rateの略称。 CANを拡張し、より高速・大容量のデータ送受信を可能にした通信プロトコル。 |
| BRS | Bit Rate Switchの略称。CAN FDでデータ部を高速なビットレートへ切り替える機能。 |
| SocketCAN | Linux標準のCAN通信フレームワーク。CANデバイスをネットワークインターフェースとして扱い、can-utilsなどと連携できます。 |
| Arbitration Baudrate | フレームの識別IDなどを送る区間の転送速度。CAN FDではデータ部より低速です。 |
| Data Baudrate | データ部の転送速度。CAN FDでのみ設定可能です。 |
| カーネルモジュール | Linuxカーネルに動的に追加できるドライバ。SocketCANドライバもこれに該当します。 |
| module parameter | ドライバ読み込み時に指定するパラメータ。既定ボーレート、終端、hardware timestampなどを指定します。 |
| hardware timestamp | デバイス側で付与される受信時刻情報。本ドライバでは受信timestampの読み出しに対応します。 |
| can-utils | LinuxでCAN通信を扱うための標準ユーティリティ集。cansend、candumpなどを含みます。 |
| mpdrv_run | MicroPeckerX SocketCANドライバ用の管理スクリプト。ドライバのロード、アンロード、チャンネル起動、停止、状態確認を行います。 |
| start-all | mpdrv_runのコマンド。can0 / can1を順に起動する通常利用向けの起動方法です。 |
| can0 / can1 | Linux上で認識されるCANインターフェース名の例。既に別のCANインターフェースが存在する環境では、異なる名前になる場合があります。 |
| termination | CANバス終端設定。本ドライバではmodule parameterでデバイス側終端の有効/無効を指定できます。 |
| SavvyCAN | オープンソースのCANログ解析・送受信ソフト。GUIでCANバス通信を可視化できます。 |
| Wireshark | ネットワーク解析ソフト。CANバスなど多様なプロトコルのパケット受信・解析に対応しています。 |
| chmod | ファイルやスクリプトに実行権限を付与するLinuxコマンド。 |
| AppImage | Linux向けのポータブルな実行形式ファイル。ソフトウェアのインストール不要で実行できます。 |
本書のご利用にあたって
- 本書の内容の一部または全部を、著作者の許可なく複製、改変、翻訳することは、著作権法で認められた場合を除き禁止されています。
- 本書に掲載されている情報や画像は、執筆時点のものであり、最新の製品や製品サイトの内容(文言やデザインなど)と異なる場合があります。
- 本書に記載されている社名および製品名は、各社の商標または登録商標です。
動作確認済み環境
MicroPeckerX SocketCANドライバは、LinuxのSocketCAN環境で使用します。
動作確認済み環境の例は以下のとおりです。
| 項目 | 内容 |
|---|---|
| OS | Ubuntu 24.04.4 LTS(64bit) |
| カーネル | 6.17.0-22-generic |
| コンパイラ | gcc 13.3.0 |
| 関連ツール | can-utils、iproute2 |
注記
本書では説明上 can0 / can1 を使用します。既に別のCANネットワークインターフェースが存在する環境では、実際のインターフェース名が can0 / can1 以外になる場合があります。実際に割り当てられた名前は ip link または ./mpdrv_run status で確認してください。