インストールとドライバ起動
フォルダ構成
| フォルダ・ファイル名 | 内容 |
|---|---|
01_drv | SocketCANドライバ本体が含まれるディレクトリです。 |
02_sample | サンプルスクリプトが含まれるディレクトリです。 |
Readme.txt | 同梱説明ファイルです。 |
インストール方法
ドライバのビルド(初回のみ)
01_drvディレクトリをLinux PCにコピーします。- ターミナルで
01_drvに移動し、makeコマンドを実行します(GCC必須)。
cd 01_drv
make
実行中のカーネル用バイナリが生成されます。
MicroPeckerX SocketCANドライバの起動
ドライバの起動(簡易版)
mpdrv_runは、MicroPeckerX SocketCANドライバの起動手順をまとめたスクリプトです。
通常の通信確認では、start-allでcan0 / can1の両方を起動してください。
cd 01_drv
chmod +x mpdrv_run
./mpdrv_run load
./mpdrv_run start-all
起動状態は以下で確認できます。
./mpdrv_run status
上記の簡易起動では、環境変数やmodule parameterを指定しない場合、以下の設定でcan0 / can1を起動します。
| 項目 | 既定設定 |
|---|---|
| 通信プロトコル | Classical CAN |
| MTU | 16 |
| Arbitration bitrate | 500000 |
| Data bitrate | 使用しません |
| CAN FD | 無効(fd off) |
CAN FDで起動する場合は、MPX_CANFD、MPX_BITRATE、MPX_DBITRATEを指定してstart-allを実行してください。
MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=2000000 ./mpdrv_run start-all
MicroPeckerX firmwareの仕様により、通信を行う場合はcan0 / can1の両方を起動してください。片方のみを起動した状態では、SocketCAN上はUPに見えても送受信できない場合があります。
ドライバの起動(手順版)
mpdrv_runを使用せず、手動で起動する場合の手順です。
- SocketCANカーネルドライバを起動します。
sudo modprobe can
- デバイスドライバ用ライブラリを読み込みます。
sudo modprobe can_dev
- MicroPeckerXドライバを読み込みます。
sudo insmod ./MpxDrv.ko
- Classical CANとしてcan0 / can1を500 kbpsで起動します。
sudo ip link set can0 mtu 16
sudo ip link set can0 up type can bitrate 500000 fd off
sudo ip link set can1 mtu 16
sudo ip link set can1 up type can bitrate 500000 fd off
CAN FDとして起動する場合は、MTUを72に設定し、fd onとdbitrateを指定します。
sudo ip link set can0 mtu 72
sudo ip link set can0 up type can bitrate 500000 dbitrate 2000000 fd on
sudo ip link set can1 mtu 72
sudo ip link set can1 up type can bitrate 500000 dbitrate 2000000 fd on
設定値は以下のとおりです。
| プロトコル指定 | 設定値 |
|---|---|
| Classical CAN | mtu 16 |
| CAN FD | mtu 72 |
mpdrv_runの主なコマンド
| コマンド | 内容 |
|---|---|
./mpdrv_run load [params...] | ドライバをロードします。module parameterを指定できます。 |
./mpdrv_run start-all | can0 / can1を順に起動します。通常はこちらを使用します。 |
./mpdrv_run start can0 | can0のみを起動します。通信用途では通常start-allを使用してください。 |
./mpdrv_run start can1 | can1のみを起動します。通信用途では通常start-allを使用してください。 |
./mpdrv_run stop can0 | can0を停止します。 |
./mpdrv_run stop can1 | can1を停止します。 |
./mpdrv_run restart | ドライバを再起動し、直前の設定を可能な範囲で引き継ぎます。 |
./mpdrv_run remove | ドライバをアンロードします。 |
./mpdrv_run status | モジュール状態とCANインターフェースの詳細状態を表示します。 |
ボーレートとCAN FDの指定
mpdrv_runでは、環境変数で起動時のボーレートとCAN FD設定を指定できます。
| 環境変数 | 内容 |
|---|---|
MPX_BITRATE | arbitration bitrateを指定します。 |
MPX_DBITRATE | CAN FDのdata bitrateを指定します。 |
MPX_CANFD | 1でCAN FDとして起動します。未指定または0の場合はClassical CANです。 |
対応している通信ボーレートとサンプルポイントは以下のとおりです。サンプルポイントは固定値です。
| 通信プロトコル | MPX_CANFD | MPX_BITRATE | MPX_DBITRATE | Arbitration sample point | Data sample point |
|---|---|---|---|---|---|
| Classical CAN | 0または未指定 | 500000 | - | 80.0% | - |
| Classical CAN | 0または未指定 | 1000000 | - | 80.0% | - |
| CAN FD | 1 | 500000 | 2000000 | 80.0% | 80.0% |
| CAN FD | 1 | 500000 | 4000000 | 80.0% | 80.0% |
| CAN FD | 1 | 500000 | 5000000 | 80.0% | 75.0% |
Classical CAN 500 kbpsで起動する例:
MPX_BITRATE=500000 ./mpdrv_run start-all
Classical CAN 1 Mbpsで起動する例:
MPX_BITRATE=1000000 ./mpdrv_run start-all
CAN FD 500 kbps / 2 Mbpsで起動する例:
MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=2000000 ./mpdrv_run start-all
CAN FD 500 kbps / 4 Mbpsで起動する例:
MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=4000000 ./mpdrv_run start-all
CAN FD 500 kbps / 5 Mbpsで起動する例:
MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=5000000 ./mpdrv_run start-all
module parameter
load時に以下のmodule parameterを指定できます。
| parameter | 内容 |
|---|---|
bitrate | SocketCAN側でbitrate未指定の場合に使用するarbitration bitrateの既定値です。 |
dbitrate | CAN FDでdata bitrate未指定の場合に使用するdata bitrateの既定値です。 |
termination | デバイス側終端を指定します。1で有効、0で無効です。 |
enable_hwts | 受信hardware timestamp情報を指定します。1で有効、0で無効です。 |
指定例:
./mpdrv_run load bitrate=500000 dbitrate=2000000 termination=1 enable_hwts=1
以下の動画(YouTube)も参考にしてインストールしてください。
MicroPeckerX SocketCAN Driverクイックスタートガイド(candump)
※動画は古いバージョンとなります。最新版では通常start-allでcan0 / can1の両方を起動してください。