はじめに
本書の目的
本書は、MicroPeckerX アプリケーション開発ライブラリ for Windowsのユーザーズマニュアルです。
本製品を使用することで、MicroPeckerXを使用してCAN、CAN FDまたはLINのモニタリングやシミュレーションを行うためのWindowsアプリケーションを開発できます。
最大でMicroPeckerX4台の制御が可能です。
本書の使い方
各章では、本製品の定義やAPIの機能などについて説明します。
疑問点がある場合は、FAQをご覧頂くか、弊社へお問い合わせください。
ただし、MicroPeckerX アプリケーション開発ライブラリ for Windowsに関する技術的な問い合わせは、別途有償サポート契約が必要です。
用語説明
本書で使用する用語の説明を以下に記述します。
| 用語 | 説明 |
|---|---|
| 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 (※1) | Microsoft Windows 11 （64bit） Microsoft Windows 10 （64bit） |
| 開発環境(※2) | Microsoft Visual C++ （2012以降を推奨） Microsoft Visual C# （2012以降を推奨） Microsoft Visual Basic .NET （2012以降を推奨） Embarcadero C++ Builder （2010以降を推奨） Microsoft Excel （2013以降） |
| CPU | Intel Core i5相当以上を推奨 |
| ハードディスク | 10ギガバイト以上の空き容量 |
| メモリ | 8ギガバイト以上を推奨 |
| USBポート | USB2.0搭載（Hi-Speed）(※2)(※3) |
| ログインユーザ | 管理者権限を持つユーザ（USBドライバのインストール時に必要） |
※1: 仮想環境での動作は非対応です。
※2: 複数台のMicroPeckerXを接続する場合は、その台数分のUSBポートが必要です。
※3: 外付けのUSBハブを用いてMicroPeckerXを接続する場合は、必ずセルフパワー対応機器を使用し、外部から電源を供給した上で接続してください。
USBハブをバスパワー駆動にしてMicroPeckerXを接続した場合、動作しない、または動作が不安定になることがあります。