はじめに
本書の目的
本書は、MicroPeckerX アプリケーション開発ライブラリ for Linuxのユーザーズマニュアルです。
本製品を使用することで、MicroPeckerXを使用してCAN、CAN FDまたはLINのモニタリングやシミュレーションを行うためのLinuxアプリケーションを開発できます。
最大でMicroPeckerX4台の制御が可能です。
本書の使い方
各章では、本製品の定義やAPIの機能などについて説明します。
疑問点がある場合は、FAQをご覧頂くか、弊社へお問い合わせください。
ただし、MicroPeckerX アプリケーション開発ライブラリ for Linuxに関する技術的な問い合わせは、別途有償サポート契約が必要です。
用語説明
本書で使用する用語の説明を以下に記述します。
| 用語 | 説明 |
|---|---|
| CAN | Controller Area Networkの略称。 車載ネットワーク用に開発された通信プロトコル。ISO 11898で規定された国際標準規格。 |
| CAN FD | CAN with Flexible Data-rateの略称。 CANを拡張し、より高速・大容量のデータ送受信を可能にした通信プロトコル。ISO 11898-1:2015として標準規格化。 |
| LIN | Local Interconnect Networkの略称。 車載ネットワークのコストダウンを図ることを目的に開発された通信プロトコル。ISO 17987で規定された国際標準規格。 |
| API | Application Programming Interfaceの略称。 ソフトウェアや機器とやり取りするための仕様やインターフェース。 |
| モニタリング | 通信内容をリアルタイムに監視・記録すること。 MicroPeckerXでは、CAN/CAN FD/LINバスの通信データを監視する機能。 |
| シミュレーション | 実際の機器・車両を模した通信の再現や試験を行うこと。 MicroPeckerXでは、任意のCAN/CAN FD/LINフレームを送信することでテストを実施できる。 |
| フレーム | 通信データの1単位。CAN/CAN FD/LINでは、IDやデータ本体などから構成される。 |
| チャンネル(CH) | MicroPeckerXが持つ物理的な通信ポート(CH1/CH2など)。 |
| APIモード | ログ取得の方法のひとつ。API関数を定期的に呼び出してログ情報を取得する方式。 |
| コールバックモード | ログ取得の方法のひとつ。ログ情報が一定間隔で自動的にコールバック関数経由で渡される方式。 |
| ボーレート | 通信速度の単位。1秒間に送信できるビット数(bps)を示す。CANでは500kbpsや1Mbps、LINでは9600bpsや19200bpsが代表的に使用される。 |
| サンプルポイント | CAN/CAN FDのデータビットの読み取りタイミングを示すポイント。通信品質やエラー低減に影響する。 |
| 終端抵抗 | CANバスの両端に接続する120Ωの抵抗。通信波形の乱れ防止のために必須。 |
| ビットレートスイッチ(BRS) | CAN FD特有の高速データ転送機能で、データ部のみ転送速度を上げる仕組み。 |
| FDフォーマット(FDF) | CAN FDのフレームを識別するためのビット。 |
| エラーフラグ | フレームや通信状態でエラーが発生したことを示す指標。 |
| バッファオーバーラン | 一時記憶領域(バッファ)が一杯になり、新たなデータを保存できなくなる状態。データ消失の原因となる。 |
| リモート送信要求(RTR) | CANでデータ要求のみを伝えるフレーム種別。データ送信フレームとは区別される。 |
| IDフォーマット(IDE) | CAN IDのフォーマットを示す。標準ID(11bit)と拡張ID(29bit)がある。 |
| データレングスコード(DLC) | フレームのデータ部の長さを示す4ビット値。 |
| アービトレーションボーレート | CAN/CAN FDでフレームの識別(ID)などを送る区間の転送速度。CAN FDではデータ部より低速。 |
| データボーレート | データ部の転送速度。CAN FDでのみ設定可能。 |
| スロット | CAN/CAN FDで送信データやトリガ条件を設定する論理単位。各スロットごとに個別のフレーム設定が可能。 |
| トリガ | 一定条件でフレーム送信などを開始するきっかけとなる信号やイベント。 |
本書のご利用にあたって
- 本書の内容の一部または全部を、著作者の許可なく複製、改変、翻訳することは、著作権法で認められた場合を除き禁止されています。
- 本書に掲載されている情報や画像は、執筆時点のものであり、最新の製品や製品サイトの内容(文言やデザインなど)と異なる場合があります。
- 本書に記載されている社名および製品名は、各社の商標または登録商標です。
動作環境
基本要件
| 項目 | 内容 |
|---|---|
| OS | Linux |
| CPUアーキテクチャ | x86(64bit/32bit)(※1) Arm v7-A, v8-A |
| 開発環境 | GNU C++(G++) Python |
| メモリ | 512メガバイト以上 |
| USBポート | USB2.0搭載(Hi-Speed)(※2)(※3) |
※1: 仮想環境での動作は非対応です。
※2: 複数台のMicroPeckerXを接続する場合は、その台数分のUSBポートが必要です。
※3: 外付けのUSBハブを用いてMicroPeckerXを接続する場合は、必ずセルフパワー対応機器を使用し、外部から電源を供給した上で接続してください。
USBハブをバスパワー駆動にしてMicroPeckerXを接続した場合、動作しない、または動作が不安定になることがあります。
動作確認済み環境
当社で動作を確認した環境を以下に示します。 なお、以下に記載していない環境での動作可否を示すものではありません。
| 確認に使用した機器 | OS/ディストリビューション | カーネル | CPUアーキテクチャ | 開発環境 |
|---|---|---|---|---|
| x86搭載PC | Ubuntu 24.04 (64bit) | Linux 7.0.0-28-generic | x86 | gcc 13.3.0, glibc 2.39 |
| Raspberry Pi 5 | Raspberry Pi OS (Debian GNU/Linux 13 64bit) | Linux 6.18.34+rpt-rpi-2712 | Arm v8-A | gcc 14.2.0, glibc 2.41 |
Linuxでは、ディストリビューションやバージョン、システム構成などによって動作条件が異なる場合があります。 また、本書に記載しているサンプルプログラムの環境構築手順は、あくまでも特定の環境における一例として示したものですので、お使いの環境に応じて設定内容やコマンドを適宜読み替え、必要な対応を行ってください。