Wasatch.NET
1.0.0
Wasatch.netは、Wasatch PhotonicsのUSBおよびSPI APIを介したアプリケーションレベルのラッパーです。アプリケーション開発者がOPCODESや[DE]のオクテットを生データのオクテットを心配する必要がないように提供されています。 IntegrationTimemsやGetSpectRum（）などの高レベルのプロパティと方法を単純に呼び出すことができます。
wasatch.netは、以下を含むすべての.net互換言語から動作することが期待されています。
| プラットフォーム | テストステータス |
|---|---|
| C＃ | Visual Studio 2017コミュニティでテストされています |
| LabView | 2017 32ビットでテストされました（wasatch.lvを参照） |
| matlab/simulink | 2017b 64ビットでテストしました（wasatch.matlabを参照） |
| エンバルカデロ・デルフィ | Delphi Community Edition 10.2をcomでテストしました（wasatch.delphiを参照） |
| VBA（Excel） | Office 2010 64ビットでテストしました（wasatch.excelを参照） |
| r | 開始されていない（RCLRを介して計画） |
| Xamarin | 開始されていません |
| Visual Basic.net | 開始されていません |
| F＃ | 開始されていません |
| Wolfram Mathematica | 開始されていません |
リストされている他の人がいる場合は、お知らせください。テストしてください。
事前にコンパイルされたインストーラーは、32ビットと64ビットのウィンドウで利用できます。
code {.cs}
WasatchNET.Driver driver = WasatchNET.Driver.getInstance();
if (driver.openAllSpectrometers() > 0)
{
WasatchNET.Spectrometer spectrometer = driver.getSpectrometer(0);
spectrometer.integrationTimeMS = 100;
double[] spectrum = spectrometer.getSpectrum();
}
endcode
サンプル通話コードについては、含まれているC＃WinFormDemoを参照してください。
APIドキュメントはこちらから入手できます。
ドライバーは、次のドキュメントで定義されているUSB APIを密接に模倣するように設計されています。
したがって、パラメーター、モード、およびオプションに関するほとんどの質問は、基礎となる分光計通信インターフェイスのレビューによって解決される可能性があります。
Wasatch Photonicsアプリケーションドライバーは、さまざまなプラットフォームや言語からUSBを介して分光計をコマンドおよび制御する方法を示すための参照実装として提供されます。 USB APIの作業例と「便利なラッパー」として、ハードウェアAPI内のすべての呼び出しとオプションに利便性関数を含めることは保証されておらず、特定の言語で最も効率的または最適な実装でもありません。
分光計への正式および完全なインターフェイスは、USB APIドキュメントで提供されています。標準のUSBドライバーは、その直接インターフェイスがすべての標準オペレーティングシステム（Libusb、Winusbなど）に豊富にある。選択したプラットフォームから分光計を最大限に活用するために追加のラッパーやライブラリは必要ありません。
オープンソースラッパーコレクションに提供されていない分光計または分光法機能がある場合は、お問い合わせください。追加の追加をリクエストしてください。または、「手を汚す」ことを希望する場合は、独自の実装を自由に作成し、オプションでベースディストリビューションに合流するために私たちと共有してください。 Wasatch Photonicsは、オンラインコミュニティをサポートすることを誇りに思っていますが、製品を改善するときにパッチを拒否することを誇りに思っていません！
とはいえ、改善のためのいくつかの既知の領域は、私たちのバックログ（以下）にあります。
wasatch.netは、c： windowsの下にwasatchnet.dllとlibusbdotnet.dllをインストールするmicrosoftインストーラー（.msi）ファイルに配布されます（常にシステムパスにあります）。 FTDIドライバーは、SPI通信をサポートするために設置されています。
また、シンプルなC＃分光法GUIアプリ、WinformDemo、 Program Files Wasatch Photonics（または32ビットシステムのプログラムファイル（x86））をインストールし、分光計を制御し、ドライバーがインストールされ、正しく機能することを迅速に確認する手段を提供します。
.msiインストーラーをダブルクリックすることに加えて、完全なインストールに必要な追加の手順が1つまたは2つあります。
wasatch.netは、「中間レベルの」ドライバーlibusbdotnetを使用して分光計と通信する高レベルの「アプリケーションドライバー」であり、「低レベルの」USBドライバーlibusb-win32を使用して通信します。ただし、Windowsは、分光計がLibusb-Win32を使用することを意図していることを知りません。
したがって、最初に行う必要があるのは、USBデバイス（VID/PID経由）をLiBUSBに関連付ける.infファイルをインストールすることです。これがそうするプロセスです：
USB Wasatch Photonics分光計をプラグインします。
Windowsは、「このデバイスのドライバーを見つける」ように促す場合があります。そうでない場合は、デバイスマネージャーに移動します（「デバイスマネージャー」と入力して、開始バーのWin10検索フィールドに入力してください）。
分光計は、「他のデバイス」の下に「ストローカーfx2」または「ストローカーインガスカメラ」として表示される必要があります。
ストローカーエントリを右クリックして、「ドライバーの更新」を選択します。
「ドライバーの手動閲覧」を選択します。
「[x]を含むサブフォルダー」がチェックされていることを確認してください
「C：プログラムFiles Wasatch Photonics Wasatch.net libusb_drivers」または「C： Program Files（x86） Wasatch Photonics wasatch.net libusb_drivers」を参照してください。
このステップは、Visual Basic 6（VB6）またはアプリケーションにVisual Basic（VBA、Microsoft Excelの一部）を使用する開発者にのみ必要とされると考えられています。
.msiインストーラーは、VB6/VBAで必要な.tlbファイルを登録していないため、1つの追加のマニュアルステップを実行する必要があります。
プログラムファイルに移動 wasatch photonics wasatch.net（または32ビットシステムのプログラムファイル（x86））
バッチファイル「RegisterDll.BAT」を右クリックし、[管理者として実行]を選択します
wasatch.netをソースから構築してコンパイルしたいですか？良い、それは私たちもそれをやりたい方法です...あなたはそのようにもっと多くのことを学びます:-)
ドライバーは、Win10 64ビットのVisual Studio 2017コミュニティで書かれてテストされました。それ自体は次のライブラリに依存します。
URL：https：//sourceforge.net/projects/libusbdotnet/files/libusbdotnet/
これは、多くのUSBデバイスベンダーが使用する標準のLibusb-Win32の.NETラッパーです。 LIB/ディレクトリで提供される事前にコンパイルされたDLLは、Visual Studio 2017コミュニティを.NET 4.0クライアントプロファイルに対して使用してV2.2.8から構築されました。
AndorカメラシステムでXLシリーズ分光計を使用するには、wasatch.netにはandorドライバーパック2をインストールする必要があります。これは現在、次のリンクでAndorから入手できます。
readme-spi.mdを参照してください。
当社の標準DLLは、DEBUGターゲットに対して.NET 4.8クライアントプロファイルに対して構築されているため、DLLには、ユーザーのトラブルシューティング用のデバッグシンボルとメタデータの最大量があります。 WinFormDemoは.NET 4.8に対して構築されています。
標準および推奨されるビルド構成はx64ですが、たとえば多くのユーザーが64ビットオペレーティングシステムでもLabViewの32ビットバージョンを持っているため、X86（Win32）のインストーラーも配布しています。
ユーザーリクエストでは、「AnyCPU」インストーラーも含めますが、この構成にはいくつかの機能が欠落しています（例：Andor / XL分光計のドライバーなど）。
ユーザーは、ターゲットの構成やアーキテクチャに対してライブラリ自体を構築できます。私たちが解決するのに役立つ問題が発生した場合は、お知らせください。
.NET Framework 4.0に対してまだ構築する必要がある場合は、「Framework40」ブランチをチェックアウトし、Visual Studio 2019 Community Editionを使用して構築してください。
インストールが成功しているかどうかをテストする最も簡単な方法は、提供されたWinFormDemoを実行することです。これは、Wasatch Photonics-> wasatch.net-> winformdemoの下のスタートメニューで利用できるようにする必要があります。
デバイスマネージャーの「Libusb-Win32デバイス」の下にプラグインして正しく表示されているWasatch Photonics分光計がある場合は、デモを実行し、[初期化]をクリックして分光計に接続できるはずです。
ライブラリでは、アプリケーションがDriver.Logger.Levelおよび.SetPathName（）を介してプログラムでロギングを構成することができますが、すべてのアプリケーションがそうするわけではありません。コンパイルされたアプリケーションのエンドユーザーは、wasatch.netを使用してプログラムを実行する前に、これらの環境変数を設定することにより、手動でロギングを構成できます。
C:> set WASATCHNET_LOGGER_PATHNAME=C:tempwasatchnet.log (assumes directory exists)
C:> set WASATCHNET_LOGGER_LEVEL=DEBUG (can be DEBUG, INFO, ERROR or NEVER)
ただし、これらの環境「デフォルト」は、上記のメソッドとプロパティを明示的に呼び出すアプリケーションコードによってオーバーライドできます。
少なくとも1つのクライアント言語（LabView NXG）は、GAC（総会のキャッシュ）にロードされた.NETアセンブリのみをサポートしています。 GACにロードするには、アセンブリを「強く命名」（デジタル署名）（Digitally Signed）...その直接的な依存関係（Libusbdotnetのような3番目のパーティDLL）とともに。
GACサポートのためのwasatch.netアセンブリにデジタル署名する詳細については、Wasatchメンテナーは「admin/keys/wasatch.net」を参照する必要があります。
libusb-win32ドライバーをインストールするのに問題がある場合は、次を参照してください。
これは、Wasatch Dashまたは別の古いWasatchドライバー製品がEnlightenまたは新しいドライバー（Wasatch.netなど）と同じコンピューターにインストールされている場合に発生する可能性があります。
Windows Device Managerを見ると、これが問題であることがわかり、「Universal Serial Bus Controllers」に記載されている「Wasatch Photonics Device FX2」が表示されます。
解決するには、「Wasatch Photonics Device FX2」を右クリックして「アンインストールデバイス」を選択して、古いドライバーを最初にアンインストールします。
「このデバイスのドライバーソフトウェアを削除する」をクリックしてください。
「アクション」メニューから、「ハードウェアの変更のスキャン」を選択して、正しいデバイスドライバーの下でデバイスを再登録します。
これで、予想されるLibusb-Win32ドライバーの下に分光計を表示する必要があります。
これで、wasatch.net、wasatch.pyまたは啓発ソフトウェアを再実行し、分光計に接続できるようになります。
ドライバーまたはAPIに関する質問については、次のように連絡してください。
