MicroPecker CANアプリケーション開発ライブラリ《S810-MP-SDK2N》
導入ご検討用詳細資料

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

目次
1.

概要 ........................................................................................................... 1
1.1.

用語 ............................................................................................................. 1

1.2. ライブラリでできること .................................................................................. 1
1.3. 構成 ............................................................................................................ 2
2. 開発環境 ..................................................................................................... 3
3. API ........................................................................................................... 4
4. シーケンス ................................................................................................... 5
4.1. モニタリングシーケンス.................................................................................. 5
4.2. シミュレーションシーケンス ............................................................................ 6
5. 機能比較 ..................................................................................................... 7

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

1. 概要
本ドキュメントは、MicroPecker CAN アプリケーション開発ライブラリ《S810-MPSDK2N》（以下本ライブラリ）の導入をご検討されているお客様向けに、その機能の詳細を記載した資料です。
なお、本ドキュメントは CAN の基本的な知識がある事を前提として記述しています。

1.1. 用語本ドキュメントで使用する用語の説明を以下に記します。
表 1:用語説明
用語
MicroPecker
モニタリング説明
本ライブラリにて使用する CAN モニタリングを行うためのハードウェア。USB で WindowsPC と接続する。
CAN バス上の信号を取得、監視すること。

CAN フレーム

CAN の通信単位。

スロット

送信する CAN フレームの情報をあらかじめ設定しておくためのバッファ。

備考
本ライブラリを使用するためには必須。

1.2. ライブラリでできること• MicroPecker の接続/切断と LED 操作
PC に接続されている MicroPecker を認識して、その MicroPecker の LED を点灯/消灯/点滅させることができます。
• CAN のモニタリング
MicroPecker に接続されたターゲットから送信された CAN フレームをモニタリングして、そのデータを取得することができます。
• CAN のシミュレーション
MicroPecker の CAN 機能を用いて、任意のタイミングで CAN フレームを送信することができます。

1

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

1.3. 構成
本ライブラリを使用する場合のシステム構成は以下の通りです。

Windows PC
ユーザーアプリケーション

MicroPecker CAN
アプリケーション開発ライブラリ
USB制御

USBバス
MicroPecker(CAN)
S810-MP-A1
CANバス（ケーブル）ターゲット
図 1:ライブラリ使用システム構成

ユーザーアプリケーションでは、MicroPecker 本体の操作及び CAN 機能の設定、CAN 通信データの受取りを行うのみで、USB（接続・切断・通信）制御は本ライブラリが担保します。
本ライブラリを使用するには、CAN のライセンスを保持した MicroPecker 本体並びに CAN ケーブルが必要となります。
こ れ ら は 、 「 MicroPecker CAN Analyzer 《 S810-MP-A1 》 」 ま た は「MicroPecker CAN Analyzer Software License Kit《S810-MP-A1》」にて提供しています。

2

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

2. 開発環境本ライブラリを使用することができる開発環境は以下の通りです。
表 2:開発環境
PC

Microsoft Windows が動作する IBM PC/AT 互換機

OS

CPU

Microsoft Windows 10 (64bit) (※1)
Microsoft Windows 8.1 (64bit) (※1)
Microsoft Windows 7 (32bit/64bit) (※1)
Microsoft Visual C++ （2005 以降）
Microsoft Visual C# （2005 以降） (※2)
Microsoft Visual Basic .NET （2005 以降） (※2)
Embarcadero C++ Builder （2010 以降）
Embarcadero Delphi （2010 以降）
Microsoft Excel （2013 以降）
Celeron 1.6GHz 以上を推奨

ハードディスク

50Mbyte 以上の空き容量

メモリ

1Gbyte 以上を推奨

USB ポート

USB2.0 搭載（Hi-Speed）

ログインユーザ

管理者権限を持つユーザ（USB ドライバのインストール時に必要）

開発環境

(※1)

Windows7 の XP モードなど、仮想環境での動作は非対応です。

(※2) 対応.NET バージョンは、2.0 および 4.0（64bit 版では 4.0 のみ）です。

3

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

3. API
本ライブラリにて提供される API は以下の通りです。
表 3:API 一覧
関数名
MPCANGetVersion
MPCANOpen

機能
バージョン情報取得
MicroPecker 接続

MPCANCloseMPCANSetLED

MicroPecker 切断
LED 操作MPCANGetStatus

ステータス取得

MPCANSetParamSimple

簡易パラメータ設定

MPCANSetParamDetail

詳細パラメータ設定

MPCANSetSlotMPCANMonitorStart

スロット設定モニタリング開始

MPCANMonitorStop
MPCANGetTimeStamp
MPCANChangeSlotData

モニタリング停止
タイムスタンプ取得
スロットデータ変更

MPCANSendSlot

スロット送信MPCANSendDirect

ダイレクト送信MPCANSendDirectEx

ダイレクト送信MPCANGetLog
MPCANGetLogEx

ログ取得
ログ取得

(※1)

説明
ライブラリのバージョン情報を取得する。
ライブラリの初期化、ならびにMicroPecker（CAN）の接続を行う。
MicroPecker（CAN）の切断を行う。
MicroPecker にある LED（赤および緑）を操作する。
MicroPecker のステータスを取得する。
CAN の動作パラメータを設定する（動作モード、ボーレート、サンプルポイント、Ack 有無）。
上記ボーレート及びサンプルポイント設
定をより詳細に設定する（プリスケーラ、セグメント等）
スロット情報を設定する。
モニタリング（シミュレーション）を開始する。
モニタリングを停止する。
現在のタイムスタンプを取得する。
指定スロットの CAN フレームを変更する。
指定スロットの CAN フレームを送信する。
スロットを介さずに CAN フレームを直接送信する。（※1）
スロットを介さずに CAN フレームを直接送信する。
モニタログを取得する。（※2）
モニタログを取得する。

Microsoft Excel では、MPCANSendDirect は使用できません。

(※2) Microsoft Excel では、MPCANGetLog は使用できません。

4

MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

4. シーケンス
本ライブラリにてソフトウェアを開発する際の API コールシーケンスは以下の通りです。
実線枠の項目は必須の処理、点線枠の項目は必須でない処理をそれぞれ表します。

4.1. モニタリングシーケンス

繰り返し

MicroPecker接続↓
パラメータ設定↓
モニタリング開始↓
ログ取得↓
モニタリング停止↓
MicroPecker切断

簡易または詳細

定期的に取得が必要(※1)

図 2:モニタリングシーケンス(※1)

定期的に取得しなかった場合、MicroPecker 内部のバッファオーバーが発生し、以降のログが正しく取得できなくなります（モニタリング停止→再開で再取得は可能です）。

5MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

4.2. シミュレーションシーケンス

繰り返し

MicroPecker接続↓
パラメータ設定↓スロット設定↓
モニタリング開始↓
ログ取得↓
スロットデータ変更
スロット送信ダイレクト送信↓モニタリング停止↓
MicroPecker切断

簡易または詳細
必要に応じて実施

ログが必要な場合に実施(※1)

必要に応じて実施

図 3:シミュレーションシーケンス(※1)

定期的に取得しなかった場合、MicroPecker 内部のバッファオーバーが発生します。シミュ
レーション処理に問題はありませんが、バッファオーバー発生後のログは正しく取得できなくなります（モニタリング停止→再開で再取得は可能です）。

6MicroPecker CAN アプリケーション開発ライブラリ 《S810-MP-SDK2N》 導入ご検討用詳細資料

5. 機能比較
製品版 MicroPecker（CAN アナライザ）との機能差異は以下の通りです。
表 4:機能比較
項目
複数 Ch 同時使用

ログ再生機能スロット設定の一部製品版との差異
同時に操作可能な MicroPecker は 1 台のみ。
（CAN アナライザでは最大 6Ch まで同時操作可能）
複数の CAN フレームを一度に設定し送信させることには非対応。
（CAN アナライザではログを読み込んで、その内容を CAN フレームとして再生可能）
ワンショット送信設定および最低送信保証間隔の設定には非対応。
（CAN アナライザではこれらの設定が可能）

備考
LIN の ラ イ ブ ラ リ と の同時使用は可能。
ダイレクト送信機能などを使用して仮想的に行うことは可能。

※ 上記以外で本ライブラリ非対応の機能（ログトリガ、ログ解析機能等）については、
CAN ア ナ ラ イ ザ の GUI ア プ リ ケ ー シ ョ ン に て 対 応 し て い る 機 能 で あ り 、MicroPecker の CAN 機能で実現しているものではありません。

7