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

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

目次
1.

2.

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

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

1.2.

SDK で出来ること...................................................................................................... 1

開発条件 .......................................................................................................................... 2
2.1.

構成 .......................................................................................................................... 2

2.2.

開発環境 ................................................................................................................... 3

2.3.

制約事項 ................................................................................................................... 4

3.

API................................................................................................................................... 64.

制御フロー ........................................................................................................................ 7

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

1. 概要
本ドキュメントは MicroPecker RAM Monitor アプリケーション開発ライブラリ《S810-MPSDK1N》(以下本 SDK)の導入をご検討されているお客様へ、その機能の概要を記した資料です。
本製品を利用することで、ターゲットマイコンのデバッグインターフェースを通じて、RAM モニタや RAM の読み出し/書き換え、および A/D モニタや A/D データの読み出しを行うためのアプリケーションを開発できます。

1.1. 用語本ドキュメントで使用する用語の説明を以下に記します。
用語説明

備考

MicroPecker

本 SDK にて使用する RAM モニタリングを行うためのハード

本 SDK を使用するにはウェア。USB にて WinodowsPC と接続します。

必須

拡張ユニットNSD 通信から他通信インターフェースへの接続変換ユニット。MicroPecker とターゲットの間に接続します。

1.2. SDK で出来ること
・MicroPecker の接続/切断
PC に接続されている MicroPecker を認識、接続、切断することができます。
・RAM のモニタリング
MicroPecker に接続されたターゲットからの RAM の値をモニタリングし、そのデータを収集することができます。
・RAM の書き換え/読み出し
MicroPecker から任意のタイミングで RAM 値の書き換え、読み出しができます。
・A/D データのモニタリング
MicroPecker に接続されたターゲットからの A/D データ（電圧データ）をモニタリングし、そのデータを収集することができます。
・A/D データの読み出し
MicroPecker から任意のタイミングで A/D データ（電圧データ）の読み出しができます。

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

2. 開発条件
本章では、本製品でアプリケーションを開発するための条件を記述します。

2.1. 構成
本製品にて提供される API の関係を、以下に示します。

Windows PC
RAMモニタアプリケーション

Open I/F Common Service API

MCU別機種依存Service API
A/D収集ユニットServiceAPI

Close I/F Service API

Device Driver

USB I/F
本製品のAPI
アダプタ（Micropecker）
一線式通信

本製品で開発可能なアプリケーション

ターゲット

なお、以降では本 API を用いて制御される MicroPecker を「アダプタ」と称します。
本 SDK を使用するには RAM Monitor のライセンスを保持した MicroPecker 本体並びにMicroPecker 用 NSD ケーブルが必要となります（MicroPecker RAM Monitor for Highspeed
Single Wire [S810-MP-R1]または MicroPecker RAM Monitor for Highspeed Single Wire
Software License Kit[S810-MP-SR1]にて提供）。

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

また、対応マイコンに応じてインターフェース変換ユニットが必要になります。
A/D データのモニタリング、読み出しには、A/D データ収集ユニット[S810-MP-EX3]が必要です。

2.2. 開発環境
本製品の開発環境を以下に示します。
PC

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

OS

CPU

Microsoft Windows 11 (※1)(※2)
Microsoft Windows 10 (※1)(※2)
Microsoft Windows 8.1 (※1)(※2)
Microsoft Visual C++ （Ver.6.0 以降）
Microsoft Visual C# （2005 以降）
Embarcadero C++ Builder （Ver.7 以降）
Celeron 1.6GHz 以上を推奨

ハードディスク

50Mbyte 以上の空き容量

メモリ

1Gbyte 以上を推奨

USB ポート

USB2.0 搭載（Hi-Speed）

CD-ROM ドライブ

本製品をインストール時に使用

ログインユーザ

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

開発環境(※1) 64 ビット OS の場合でも、32 ビットアプリケーションのみ開発可能です。
(※2) 仮想環境での動作は非対応です。

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

2.3. 制約事項
本製品でアプリケーションを開発する場合には、以下の制約があります。
・ データアラインメントはクワッドワード（8 バイト）です。
・ 本バージョンでは、NSD 通信（NSD◆AUD 変換ユニットによる AUD 通信、NSD◆
N-Wire 変換ユニットによる N-Wire 通信、NSD◆A/D 収集ユニットによる A/D モニタも含む）に対応しています。
なお、対応 MCU の型名及び対応 MCU 毎の注意事項については、デバイスリストを参照してください。
・ RAM モニタ、並びに RAM 読み出し/書き換えを行う際には、以下のようにサイズに応じて設定可能なアドレスに制限がありますが、API ではこのチェックを行いません
ので、アプリケーションにてチェックを行うようにしてください。
この制限を守らなかった場合、RAM モニタデータを収集する関数では、取得したデータ数が 0 になり、データが取得できません。また、RAM 読み出し/書き換えの関数では、実行結果が失敗となります。
サイズ
8 ビット（1 バイト）
16 ビット（2 バイト）
32 ビット（4 バイト）モニタ
任意アドレス
偶数アドレス
4 の倍数のアドレス

読み出し/書き換え任意アドレス
偶数アドレス
4 の倍数のアドレス

・ RAM モニタ、並びに RAM 読み出し/書き換えが可能なアドレスの範囲は、MCU の内蔵 RAM 領域に限られますが、API ではこのチェックを行いませんので、アプリケーションにてチェックを行うようにしてください。
NSD 通信及び AUD 通信では、レジスタ領域のモニタは可能ですが、その際はサイズを各々のレジスタに合わせるようにしてください（全てのレジスタへのアクセスを保証するものではありません）。
なお、詳細については各 MCU のハードウェアマニュアルを参照してください。
・ RAM モニタ可能なアドレス点数の最大値は、サンプリング周期に応じて以下のようになりますが、API ではアドレス点数が最大値を超えていないかのチェックは行いませんので、アプリケーションにてチェックを行うようにしてください。
この制限を守らなかった場合、取得データが異常になるなどの影響が出ます。
サンプリング周期
0.1ms
0.2ms
0.3ms
0.4ms
0.5ms

アドレス点数
6点
12 点
19 点
25 点
32 点

サンプリング周期
0.6ms
0.7ms
0.8ms
0.9ms
1ms 以上

アドレス点数
38 点
44 点
51 点
57 点
64 点

・ RAM モニタを実行する際には、別スレッドを起動して、スレッド上でデータの収集を定期的に行う必要があります。
・ RAM 読み出し/書き換え可能なアドレス点数は、最大 32 点です。

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

・ A/D 読み出し可能な Ch 点数は、最大 8 点です。
・ 同一プロセスから本 API を複数実行させる（例えば、RAM モニタと A/D モニタを 1 つのプロセス内の複数スレッドで同時に処理させる）ことには対応していません。

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

3. API
本 SDK で提供される API は以下の通りです。
API の一覧を以下に示します。
分類
MicroPecker 制御用 API

RAM モニタおよび A/D モニタ
制御用 API

API 名
GetVersion
GetDeviceList
SelectDevice
GetDeviceType
GetAdapterList
OpenAdapter
ConnectTarget
SeparateTarget
CloseAdapter
GetAdapterStatus
GetUnitInfo
SetMonParam
SetMonSyncMode
StartMon
StopMon
PauseMon
RestartMon
GetMonStatus
GetMonData
GetAdDataReadMemory
WriteMemory
ReadADData

機能API バージョン取得
対応デバイスリスト取得
処理対象デバイス選択
デバイス種別取得
アダプタ情報リスト取得
アダプタのオープン
ターゲットへの接続
ターゲットからの切断
アダプタのクローズ
アダプタ状態取得
拡張ユニット情報取得
RAM モニタ条件設定
タイムスタンプ同期設定
RAM モニタ開始
RAM モニタ停止
RAM モニタ一時停止
RAM モニタ再開
RAM モニタ状態取得
RAM モニタデータ収集
A/D モニタデータ収集
RAM 読み出し
RAM 書き換えA/D データ読み出し

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

4. 制御フロー本製品で MicroPecker を制御する場合、API 呼び出しのフローは以下のようになります。