メインコンテンツまでスキップ

インストールとドライバ起動

フォルダ構成​

フォルダ・ファイル名内容
01_drvSocketCANドライバ本体が含まれるディレクトリです。
02_sampleサンプルスクリプトが含まれるディレクトリです。
Readme.txt同梱説明ファイルです。

インストール方法​

ドライバのビルド(初回のみ)​

  1. 01_drvディレクトリをLinux PCにコピーします。
  2. ターミナルで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
MTU16
Arbitration bitrate500000
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を使用せず、手動で起動する場合の手順です。

  1. SocketCANカーネルドライバを起動します。
sudo modprobe can
  1. デバイスドライバ用ライブラリを読み込みます。
sudo modprobe can_dev
  1. MicroPeckerXドライバを読み込みます。
sudo insmod ./MpxDrv.ko
  1. 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 CANmtu 16
CAN FDmtu 72

mpdrv_runの主なコマンド​

コマンド内容
./mpdrv_run load [params...]ドライバをロードします。module parameterを指定できます。
./mpdrv_run start-allcan0 / can1を順に起動します。通常はこちらを使用します。
./mpdrv_run start can0can0のみを起動します。通信用途では通常start-allを使用してください。
./mpdrv_run start can1can1のみを起動します。通信用途では通常start-allを使用してください。
./mpdrv_run stop can0can0を停止します。
./mpdrv_run stop can1can1を停止します。
./mpdrv_run restartドライバを再起動し、直前の設定を可能な範囲で引き継ぎます。
./mpdrv_run removeドライバをアンロードします。
./mpdrv_run statusモジュール状態とCANインターフェースの詳細状態を表示します。

ボーレートとCAN FDの指定​

mpdrv_runでは、環境変数で起動時のボーレートとCAN FD設定を指定できます。

環境変数内容
MPX_BITRATEarbitration bitrateを指定します。
MPX_DBITRATECAN FDのdata bitrateを指定します。
MPX_CANFD1でCAN FDとして起動します。未指定または0の場合はClassical CANです。

対応している通信ボーレートとサンプルポイントは以下のとおりです。サンプルポイントは固定値です。

通信プロトコルMPX_CANFDMPX_BITRATEMPX_DBITRATEArbitration sample pointData sample point
Classical CAN0または未指定500000-80.0%-
Classical CAN0または未指定1000000-80.0%-
CAN FD1500000200000080.0%80.0%
CAN FD1500000400000080.0%80.0%
CAN FD1500000500000080.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内容
bitrateSocketCAN側でbitrate未指定の場合に使用するarbitration bitrateの既定値です。
dbitrateCAN 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の両方を起動してください。