SPI WinRT ストライド検証テスト

[アーティクル]
06/19/2023

SPI テストでは、Windows.Devices.Spi WinRT API を介してユーザーモードに公開される SPI コントローラーの機能およびストレステストを行います。テストの範囲は次のとおりです。

指定されたフレンドリ名を持つ SPI コントローラーが、ユーザーモードからアクセスできることの検証。
SPI モード、クロック周波数、データビット長、転送長の範囲にわたってデータが正しく送信および受信されていることの検証。
転送内のバイト間にギャップがないことの検証。 LED ストリップやアナログ/デジタルコンバーターなどのデバイスには、中断されないクロック信号が必要なものがあります。
使用される実際のクロック速度が、要求された値の 15% 以内であることの検証。
ストライドの倍数ではないバッファー長で転送が試行されたときに、その転送が STATUS_INVALID_PARAMETER で失敗し、バス上でアクティビティが生成されないことの検証。ストライドは、DataBitLength によって次のように決定されます。


DataBitLength	Stride
4 - 8	1
9 - 16	2
17 - 32	4

テストは、外部接続された mbed LPC1768 に対して実行されます。 mbed LPC1768 は、Sparkfun、Digikey、Adafruit を含むさまざまなオンライン小売業者から購入できる、一般的なマイクロコントローラープロトタイププラットフォームです。テストファームウェアイメージを使用した mbed のプログラミングは、ファームウェアイメージを大容量記憶装置にドラッグアンドドロップするのと同じくらい簡単です。ファームウェアのソースコードは github で入手できます。 mbed の準備とテストの実行に関する詳細な手順を以下に示します。

テストの詳細


仕様	Device.BusController.SPI.WinRT.Discretional
プラットフォーム
サポートされているリリース	Windows 10 Windows 10 バージョン 1511 Windows 10 Version 1607 Windows 10 Version 1703 Windows 10 バージョン 1709 Windows 10 バージョン 1803 Windows 10 Version 1809 Windows 10 バージョン 1903 Windows 10 への次の更新プログラム
予想される実行時間 (分)	5
カテゴリ	開発
タイムアウト (分)	10
再起動が必要です	false
特別な構成が必要です	false
Type	automatic

その他のドキュメント

この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。

Device.BusController のその他のドキュメント

テストの実行

テストを実行するには次のハードウェアが必要です:

mbed LPC1768
ブレッドボード
ジャンパーワイヤ

まず、テストファームウェアを mbed に読み込む必要があります。

USB 経由で mbed LPC1768 を PC に接続します。 PC にリムーバブルドライブとして表示されます。
エクスプローラーでドライブを開きます
c:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\x86\iot\busses-tester-mbed_LPC1768.bin をドライブにコピーします
mbed のボタンを押して、マイクロコントローラーをリセットします

次に、mbed をテスト対象の SPI コントローラーに接続します。 mbed の電源をオンにする場合は、USB 経由でテスト対象デバイスに接続するか、VIN および GND ピンをテスト対象デバイスの電源ピンに直接接続できます。テスト対象デバイスと mbed の間で次の接続を行います (mbed のピン配列)。

mbed ピン 13 (P0.15/SCK0) を、テスト対象デバイスの SCK ピンに接続します
mbed ピン 30 (P0.4/CAP2.0) を、テスト対象デバイスの SCK ピンに接続します (このピンは正確なクロック測定に使用されます)
mbed ピン 11 (P0.18/MOSI0) を、テスト対象デバイスの MOSI ピンに接続します
mbed ピン 12 (P0.17/MISO0) を、テスト対象デバイスの MISO ピンに接続します
mbed ピン 14 (P0.16/SSEL0) を、テスト対象デバイスのチップセレクトピンに接続します
mbed GND をテスト対象デバイスの GND ピンに接続します

これで、HLK Studio でテストをスケジュールできるようになりました。

トラブルシューティング

HLK テストエラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。

コマンドラインでテストを実行して、エラーに関する分析情報を取得し、ソリューションをすばやく反復処理することをお勧めします。また、salae などのロジックアナライザーを接続することをお勧めします。バストラフィックを検査する機能がない場合、エラーの原因を特定するのが困難または不可能な場合があります。

以下にコマンドラインでテストを実行する方法を示します。

%programfiles(x86)%\Windows Kits\10\Testing\Runtimes\TAEF\<arch>\MinTe を c:\data\minte にコピーします
%programfiles(x86)%\Windows Kits\10\Hardware Lab Kit\Tests\<arch>\iot からデバイス上の c:\data に Windows.Devices.LowLevel.UnitTests.dll をコピーします。
デバイスに Telnet または ssh で接続します
ディレクトリを c:\data に移動します

テストを実行します。

minte\te windows.devices.lowlevel.unittests.dll /name:SpiHlk*

コマンドラインテストの使用法:

minte\te windows.devices.lowlevel.unittests.dll [/name:test_name] [/p:SpiFriendlyName=friendly_name] [/p:ClockFrequency=clock_frequency] [/p:DataBitLength=data_bit_length] [/p:SpiMode=0|1|2|3] [/p:Length=length] [/p:WriteLength=write_length] [/p:ReadLength=read_length] [/p:ExtraClocks=extra_clocks] [/p:Verbose=true]

test_name - 実行するテストの名前。ワイルドカードを含む場合があります。例: /name:SpiHlk*、/name:SpiHlkTests::VerifyClockFrequency#metadataSet0
friendly_name - テスト対象の SPI コントローラーのフレンドリ名。省略した場合は、最初に列挙されたコントローラーが使用されます。例: /p:SpiFriendlyName=SPI1
clock_frequency - 指定されたクロック周波数を使用するようにテストを強制します。既定では、クロック周波数はテストデータから取得されます。これは、周波数の範囲にわたって対象を指定するように設計されています。このパラメーターは、通常の状況では省略する必要があります。例: /p:ClockFrequency=1500000
data_bit_length - 指定されたデータビット長を使用するようにテストを強制します。例: /p:DataBitLength=9
SpiMode - 指定された SPI モードを使用するようにテストを強制します。例: /p:SpiMode=2
length - 転送に指定されたバッファー長を使用するようにテストを強制します。例: /p:length=128
write_length - 転送の書き込み部分に指定されたバッファー長を使用するように TransferSequential テストを強制します。例: /p:WriteLength=8
read_length - 転送の読み取り部分に指定されたバッファー長を使用するように TransferSequential テストを強制します。例: /p:ReadLength=16
extra_clocks - パフォーマンス測定、ギャップ検出、クロック周波数の確認で予想されるクロックアクティブ時間を計算するときにテストで使用されるバイトあたりのクロック数の調整を指定します。たとえば、BCM2836 SPI コントローラーでは、各バイトの後に余分なクロックサイクルを待機します。そのため、この動作を補正するには、測定値を調整する必要があります。例: /p:ExtraClocks=1.5
/p:Verbose=true - 詳細出力を有効にします。これにより、エラーが発生すると、バッファー全体がコンソールにダンプされます。既定では、最初の不一致バイトのみが表示されます。

例:

使用可能なテストを一覧表示する場合:

minte\te windows.devices.lowlevel.unittests.dll /list

IO 確認テストを実行する場合:

minte\te windows.devices.lowlevel.unittests.dll /name:SpiHlkIoTests*

ギャップ検出テストを実行する場合:

minte\te windows.devices.lowlevel.unittests.dll /name:SpiHlkGapTests*

クロック周波数の確認とストライドテストを実行する場合:

minte\te windows.devices.lowlevel.unittests.dll /name:SpiHlkTests*

特定の SPI コントローラーインスタンスに対して特定のテストを実行する場合:

minte\te windows.devices.lowlevel.unittests.dll /name:SpiHlkIoTests#2::VerifyTransferSequential#metadataSet9 /p:SpiFriendlyName=SPI1

手動でのトラブルシューティングに役立つ場合があるツールは、SpiTestTool です。 SpiTestTool は、コマンドラインから SPI と対話するためのシンプルなユーティリティです。

詳細

パラメーター

パラメーター名	パラメーターの説明
SpiFriendlyName	テスト対象の SPI コントローラーのフレンドリ名 (SPI0 など)。

次の方法で共有