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

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

目次
1.

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

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

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

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

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

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

LIN ヘッダ

マスタノード（タスク）より送信されるデータ要求。

LIN レスポンス

スレーブタスクより送信されるデータ応答。

LIN スケジュール

マスタノードが送信するヘッダの送信順や送信間隔を決めたもの。
LIN の通信単位（ヘッダ＋レスポンス）。

LIN フレーム

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

1

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

1.2. ライブラリでできること• MicroPecker の接続/切断と LED 操作
PC に接続されている MicroPecker を認識して、その MicroPecker の LED を点灯/消灯/点滅させることができます。
• LIN のモニタリング
MicroPecker に接続されたターゲットから送信された LIN フレーム（ヘッダ/レスポンス）をモニタリングして、そのデータを取得することができます。
• LIN のマスタシミュレーション
MicroPecker の LIN 機能により、マスタノードとして任意のタイミングでのヘッダ送信、ならびにレスポンスの受信を行うことができます。
• LIN のスレーブシミュレーション
MicroPecker の LIN 機能により、スレーブノードとして任意のヘッダ ID に対するレスポンスの送信を行うことができます。

2

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

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

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

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

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

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

3

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

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

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

OSCPU

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 のみ）です。

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

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

機能
バージョン情報取得

MPLINOpen

デバイス接続MPLINClose
MPLINSetLED

デバイス切断LED 操作MPLINGetState

ステータス取得

MPLINSetParam

パラメータ設定

MPLINSetLINStatus

LIN ステータス設定

MPLINSetMasterSim

MPLINMonitorStart

マスタ
シミュレーション設定
マスタ
アイテム設定スレーブ
シミュレーション設定
スレーブ
アイテム設定モニタリング開始

MPLINMonitorStop
MPLINGetTimeStamp
MPLINSetSchedule

モニタリング停止
タイムスタンプ取得
スケジュール設定

MPLINChangeSchedule

スケジュール変更

MPLINSendMasterInterrupt

マスタ
割り込み送信スレーブ
ウェイクアップ送信
ログ取得
ログ取得

MPLINSetMasterItem
MPLINSetSlaveSim
MPLINSetSlaveItem

MPLINSendSlaveWakeup
MPLINGetLog
MPLINGetLogEx(※1)

説明ライブラリのバージョン情報を取得する。
ライブラリの初期化、ならびにMicroPecker （ LIN ） の 接 続 を 行う。
MicriPecker（LIN）の切断を行う。
MicroPecker にある LED（赤および緑）を操作する。
MicroPecker のステータスを取得
する
LIN の動作パラメータを設定する（リビジョン、ボーレート、マスタ/スレーブ、ID 設定等）。
LIN ステータス（スリープ/RUN）を設定する。
マスタシミュレーション（スケジュール）の設定を行う。
スケジュール内のアイテム（ヘッダ/フレーム）を変更する。
スレーブシミュレーション（全 ID の応答情報）の設定を行う。
ID 毎の応答情報を設定する。
モニタリング（シミュレーション）を開始する。
モニタリングを停止する。
現在のタイムスタンプを取得する。
動作中にスケジュール設定を変更する。
動作中の実行スケジュールを変更する。
スケジュール中に割り込みでヘッダまたはフレームを送信する。
ウェイクアップ信号を送信する。
モニタログを取得する。（※１）
モニタログを取得する。

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

5

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

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

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

繰り返し

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

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

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

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

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

4.2. マスタシミュレーションシーケンス
MicroPecker接続↓パラメータ設定↓マスタシミュレーション設定

繰り返し↓
LINステータス設定↓
モニタリング開始↓ログ取得↓
スケジュール設定
スケジュール変更
マスタアイテム設定
マスタ割り込み送信
LINステータス設定↓モニタリング停止↓
MicroPecker切断

初期ステータスを変更したい場合に実施ログが必要な場合に実施(※1)

必要に応じて実施

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

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

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

4.3. スレーブシミュレーションシーケンス
MicroPeckerオープン↓
パラメータ設定↓
スレーブシミュレーション設定

繰り返し↓
モニタリング開始↓
ログ情報取得↓スレーブアイテム設定
スレーブウェイクアップ送信

ログが必要な場合に実施(※1)
必要に応じて実施↓モニタリング停止↓
MicroPeckerクローズ

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

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

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

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

ログ再生機能製品版との差異
同時に操作可能な MicroPecker は 1 台のみ。
（LIN アナライザでは最大 6Ch まで同時操作可能）
複数の LIN フレームを一度に設定し送信させることには非対応。
（LIN アナライザではログを読み込んで、その内容を LIN フレームとして再生可能）

備考
CAN のライブラリとの同時使用は可能。
スケジュール設定と割り込み送信機能などを使用して仮想的に行うことは可能。

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

9