SocketCAN基本操作
この章では、MicroPeckerX SocketCANドライバを起動した後に使用する、基本的なLinux SocketCANコマンドを説明します。
MicroPeckerXはLinux上ではCANネットワークインターフェースとして扱われるため、candump、cansend、cangenなどのcan-utilsコマンドを使用できます。
この章では説明上 can0 / can1 を使用します。実際のインターフェース名は、環境により異なる場合があります。ip link または ./mpdrv_run status で確認してください。
インターフェース状態の確認
CANインターフェースの一覧を確認します。
ip link
詳細な設定を確認する場合は、以下を実行します。
ip -details link show can0
ip -details link show can1
mpdrv_runを使用している場合は、以下でも確認できます。
./mpdrv_run status
bitrate、dbitrate、fd on/off、state ERROR-ACTIVEなどを確認してください。
受信する(candump)
CANフレームを受信する場合は、candumpを使用します。
candump can0
can1で受信する場合:
candump can1
複数インターフェースを同時に監視する場合:
candump can0 can1
終了する場合は、Ctrl + Cを押してください。
timestamp付きで受信する
受信時刻を表示する場合は、-taを指定します。
candump -ta can0
hardware timestampを確認する場合は、ドライバロード時にenable_hwts=1を指定し、-Hを付けて実行します。
candump -H -ta can0
本ドライバは受信hardware timestampの読み出しに対応しています。TX hardware timestampおよびhardware timestamp設定変更には対応していません。
Classical CANを送信する(cansend)
Classical CANフレームを1回送信する場合は、cansendを使用します。
cansend can0 123#1122334455667788
| 要素 | 意味 |
|---|---|
can0 | 送信するCANインターフェース |
123 | CAN ID。16進数で指定します。 |
# | Classical CANフレームの区切り文字 |
1122334455667788 | 送信データ。2桁で1 byte、最大8 byteです。 |
データ長を短くすることもできます。
cansend can0 123#11223344
データなしのフレームを送信する例:
cansend can0 123#
Extended IDを送信する場合は、CAN IDを拡張ID範囲で指定します。
cansend can0 12345678#11223344
CAN FDを送信する(cansend)
CAN FDフレームを送信する場合は、事前にCAN FD設定でインターフェースを起動してください。
MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=2000000 ./mpdrv_run start-all
CAN FDフレームは、##を使用して指定します。
cansend can0 123##1112233445566778899AABBCCDDEEFF
CAN FDでは、##直後の1文字がCAN FD flagsです。送信データは、その次の文字から始まります。
| 要素 | 意味 |
|---|---|
can0 | 送信するCANインターフェース |
123 | CAN ID。16進数で指定します。 |
## | CAN FDフレームの区切り文字 |
1 | CAN FD flags。0はBRSなし、1はBRSありです。 |
112233... | 送信データ。2桁で1 byte、最大64 byteです。 |
つまり、以下の例では##直後の0がflags、送信データは1122334455667788です。
cansend can0 123##01122334455667788
以下の例では##直後の1がflags、送信データは1122334455667788です。
cansend can0 123##11122334455667788
| コマンド例 | BRS | 送信データ |
|---|---|---|
cansend can0 123##01122334455667788 | なし | 1122334455667788 |
cansend can0 123##11122334455667788 | あり | 1122334455667788 |
CAN FDを使用する場合は、送信側・受信側ともCAN FD設定で起動してください。Classical CAN設定のままCAN FDフレームを送信・受信することはできません。
周期送信する(cangen)
周期的にCANフレームを送信する場合は、cangenを使用します。
Classical CANで、ID 123、8 byteデータを100 ms周期で送信する例:
cangen can0 -I 123 -L 8 -D 1122334455667788 -g 100
| オプション | 意味 |
|---|---|
-I 123 | CAN IDを固定します。 |
-L 8 | データ長を8 byteに固定します。 |
-D 1122334455667788 | 送信データを固定します。 |
-g 100 | 送信間隔を100 msにします。 |
CAN FDで周期送信する例:
cangen can0 -f -b -I 123 -L 64 -g 100
上記はデータ内容を固定していないため、送信データはcangenにより生成されます。
送信データも固定したい場合は、-Dでデータを指定します。
cangen can0 -f -b -I 123 -L 64 -D 00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF -g 100
| オプション | 意味 |
|---|---|
-f | CAN FDフレームを送信します。 |
-b | CAN FDのBRSを有効にします。 |
-I 123 | CAN IDを固定します。 |
-L 64 | データ長を64 byteに固定します。 |
-D ... | 送信データを固定します。2桁で1 byte、上記例では64 byteを指定しています。 |
-g 100 | 送信間隔を100 msにします。 |
送信を停止する場合は、Ctrl + Cを押してください。
周期を短くしすぎると、PCやUSB、CANバスの負荷が高くなります。まずは100 ms程度の周期から確認し、必要に応じて調整してください。
よく使うコマンド一覧
| 目的 | コマンド例 |
|---|---|
| インターフェース一覧確認 | ip link |
| CAN詳細設定確認 | ip -details link show can0 |
| ドライバ状態確認 | ./mpdrv_run status |
| can0で受信 | candump can0 |
| timestamp付き受信 | candump -ta can0 |
| hardware timestamp付き受信 | candump -H -ta can0 |
| Classical CAN送信 | cansend can0 123#1122334455667788 |
| CAN FD送信 | cansend can0 123##11122334455667788 |
| Classical CAN周期送信 | cangen can0 -I 123 -L 8 -D 1122334455667788 -g 100 |
| CAN FD周期送信 | cangen can0 -f -b -I 123 -L 64 -D 00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF00112233445566778899AABBCCDDEEFF -g 100 |