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

アプリケーション作成のヒント

MicroPeckerX SocketCANドライバを使用すると、MicroPeckerXはLinux上のCANネットワークインターフェースとして扱えます。
アプリケーションからは、専用APIではなくLinuxのSocketCAN APIを使用してCAN / CAN FDフレームを送受信します。

アプリ作成前の確認手順​

アプリケーションを作成する前に、まずcan-utilsで送受信できることを確認してください。

  1. ドライバを起動します。
cd 01_drv
./mpdrv_run load
./mpdrv_run start-all
  1. 受信確認を行います。
candump can0
  1. 別ターミナルから送信します。
cansend can0 123#1122334455667788

この確認ができていれば、アプリケーションからも同じcan0 / can1を指定して送受信できます。

C言語でClassical CANを送信する例​

以下は、can0からClassical CANフレームを1回送信する最小例です。

#include <linux/can.h>
#include <linux/can/raw.h>
#include <net/if.h>
#include <stdio.h>
#include <string.h>
#include <sys/ioctl.h>
#include <sys/socket.h>
#include <unistd.h>

int main(void) {
int s;
struct sockaddr_can addr;
struct ifreq ifr;
struct can_frame frame;

s = socket(PF_CAN, SOCK_RAW, CAN_RAW);
if (s < 0) {
perror("socket");
return 1;
}

strcpy(ifr.ifr_name, "can0");
if (ioctl(s, SIOCGIFINDEX, &ifr) < 0) {
perror("ioctl");
close(s);
return 1;
}

memset(&addr, 0, sizeof(addr));
addr.can_family = AF_CAN;
addr.can_ifindex = ifr.ifr_ifindex;

if (bind(s, (struct sockaddr *)&addr, sizeof(addr)) < 0) {
perror("bind");
close(s);
return 1;
}

frame.can_id = 0x123;
frame.can_dlc = 8;
frame.data[0] = 0x11;
frame.data[1] = 0x22;
frame.data[2] = 0x33;
frame.data[3] = 0x44;
frame.data[4] = 0x55;
frame.data[5] = 0x66;
frame.data[6] = 0x77;
frame.data[7] = 0x88;

if (write(s, &frame, sizeof(frame)) != sizeof(frame)) {
perror("write");
close(s);
return 1;
}

close(s);
return 0;
}

ビルド例:

gcc -o can_send can_send.c

実行例:

./can_send

C言語でClassical CANを受信する例​

以下は、can0でClassical CANフレームを1回受信する最小例です。

#include <linux/can.h>
#include <linux/can/raw.h>
#include <net/if.h>
#include <stdio.h>
#include <string.h>
#include <sys/ioctl.h>
#include <sys/socket.h>
#include <unistd.h>

int main(void) {
int s;
int nbytes;
struct sockaddr_can addr;
struct ifreq ifr;
struct can_frame frame;

s = socket(PF_CAN, SOCK_RAW, CAN_RAW);
if (s < 0) {
perror("socket");
return 1;
}

strcpy(ifr.ifr_name, "can0");
if (ioctl(s, SIOCGIFINDEX, &ifr) < 0) {
perror("ioctl");
close(s);
return 1;
}

memset(&addr, 0, sizeof(addr));
addr.can_family = AF_CAN;
addr.can_ifindex = ifr.ifr_ifindex;

if (bind(s, (struct sockaddr *)&addr, sizeof(addr)) < 0) {
perror("bind");
close(s);
return 1;
}

nbytes = read(s, &frame, sizeof(frame));
if (nbytes < 0) {
perror("read");
close(s);
return 1;
}

printf("ID=0x%03X DLC=%d DATA=", frame.can_id & CAN_EFF_MASK, frame.can_dlc);
for (int i = 0; i < frame.can_dlc; i++) {
printf("%02X ", frame.data[i]);
}
printf("\n");

close(s);
return 0;
}

CAN FDアプリを作成する場合​

CAN FDを扱う場合は、事前にCAN FD設定でインターフェースを起動します。

MPX_CANFD=1 MPX_BITRATE=500000 MPX_DBITRATE=2000000 ./mpdrv_run start-all

アプリケーションでは、主に以下がClassical CANと異なります。

Classical CANCAN FD
struct can_framestruct canfd_frame
最大8 byte最大64 byte
sizeof(struct can_frame)で送受信sizeof(struct canfd_frame)で送受信
CAN FD flagsなしCANFD_BRSなどのflagsを使用可能

CAN FDフレームを送信する場合のフレーム設定例:

struct canfd_frame frame;

memset(&frame, 0, sizeof(frame));
frame.can_id = 0x123;
frame.len = 64;
frame.flags = CANFD_BRS;

for (int i = 0; i < frame.len; i++) {
frame.data[i] = i;
}

write(s, &frame, sizeof(frame));

Pythonから使用する場合​

Pythonでは、python-canなどのSocketCAN対応ライブラリを使用できます。
ライブラリのインストールや詳細なAPIは、使用するライブラリの説明に従ってください。

送信処理のイメージ:

import can

bus = can.interface.Bus(channel="can0", interface="socketcan")
msg = can.Message(arbitration_id=0x123, data=[0x11, 0x22, 0x33, 0x44], is_extended_id=False)
bus.send(msg)

CAN FDを使用する場合は、インターフェースをCAN FD設定で起動したうえで、CAN FD対応のメッセージ設定を使用してください。

アプリ作成時の注意​

  • アプリケーションで使用するインターフェース名は、実環境の名前に合わせてください。
  • 送受信前に、ip -details link show can0でbitrateやCAN FD設定を確認してください。
  • CAN FDを使用する場合は、送信側・受信側のbitrate / dbitrate設定を合わせてください。
  • 高周期・高負荷の送信を行う場合は、まず低い送信頻度から確認してください。
  • 受信hardware timestampを使用する場合は、ドライバロード時にenable_hwts=1を指定してください。