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） |
| Embarcadero Delphi | 通過com上的Delphi Community Edition 10.2測試（請參閱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，hinusb等。從您選擇的平台中充分使用我們的光譜儀，不需要其他包裝器或庫。
如果您沒有在我們的開源包裝器收藏中找到的光譜儀或光譜函數，請與我們聯繫並要求添加；或者，如果您想“弄髒雙手”，請隨時創建自己的實現，並與我們共享以合併為基礎分佈。 Wasatch Photonics很榮幸能幫助我們的在線社區，但在改善產品時不會太自豪地拒絕補丁！
也就是說，在我們的積壓待處理中可以找到一些已知的改進領域（下圖）。
WASATCH.NET分佈在Microsoft Installer（.msi）文件中，該文件安裝了wasatchnet.dll和libusbdotnet.dll c： Windows（因此它們始終在系統路徑中）。還安裝了FTDI驅動程序以支持SPI通信。
它還在 Program Files Wasatch Photonics（或32位系統上的Program Files（X86））下安裝了簡單的C＃光譜GUI應用程序WinformDemo，在32位系統上），為您提供了控制光譜儀的手段，并快速驗證驅動程序已安裝並正常工作。
除了雙擊.msi安裝程序外，完整安裝還需要一個或兩個附加步驟：
Wasatch.net是一個高級“應用程序驅動程序”，它使用“中級”驅動程序libusbdotnet與我們的光譜儀進行通信，該驅動程序使用“低級” USB驅動程序libusb-win32進行通信。但是，Windows不知道我們的光譜儀旨在使用Libusb-Win32，直到我們告訴它！
因此，我們需要做的第一件事是安裝.INF文件，該文件將USB設備（通過VID/PID）與Libusb相關聯。這是這樣做的過程：
插入USB WASATCH光子學光譜儀。
Windows可能會提示您“找到此設備的驅動程序”。如果沒有，請轉到設備管理器（只需在開始欄上的Win10搜索字段中鍵入“設備管理器”）。
您的光譜儀應在“其他設備”下以“ Stroker FX2”或“ Stroker Ingas相機”的形式出現。
右鍵單擊stroker條目，然後選擇“更新驅動程序”。
選擇“手動瀏覽驅動程序”。
確保檢查“ [x]包括子文件夾”
瀏覽到“ C： Program 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文件，因此您需要執行一個額外的手動步驟：
導航到 program Files 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/ Directory中提供的預編譯的DLL是使用Visual Studio 2017社區與.NET 4.0客戶端配置文件構建的。
要與Andor Camera系統一起使用XL系列光譜儀，Wasatch.net需要安裝Andor驅動程序包2。目前可以從Andor中獲得以下鏈接：
請參閱readme-spi.md。
我們的標準DLL是針對.NET 4.8客戶端配置文件構建的，因此DLL將具有用於用戶故障排除的最大調試符號和元數據。 WinFormDemo是針對.NET 4.8構建的。
標準和推薦的構建配置為X64，但是我們還為X86（WIN32）分發了安裝程序，例如，即使在64位操作系統上，許多用戶甚至具有32位版本的LabView版本。
通過用戶請求，我們還包括一個“ AnyCPU”安裝程序，但是此配置缺少某些功能（例如，andor / XL光譜儀的驅動程序）。
歡迎用戶根據任何目標配置或體系結構來構建庫本身；如果您遇到任何可以幫助解決的問題，請告訴我們。
如果您仍然需要與.NET Framework 4.0建立構建，請查看“ Framework40”分支並使用Visual Studio 2019 Community Edition構建。
測試安裝是否成功的最簡單方法是運行提供的winformdemo，應該在wasatch photonics下的開始菜單上可用 - > wasatch.net-> winformdemo。
如果您在設備管理器中的“ libusb-win32設備”下正確顯示了WASATCH光子光譜儀並正確顯示，則應可以運行演示，然後單擊“初始化”以連接到光譜儀。
儘管庫讓應用程序通過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)
這些環境“默認”仍然可以被應用程序代碼覆蓋，該應用程序明確調用上述方法和屬性。
至少一種客戶端語言（LabView NXG）僅支持加載GAC中加載的.NET組件（大會緩存）。為了加載到GAC中，必須“強烈命名”（數字簽名）...及其直接依賴項（例如Libusbdotnet）。
有關數字簽名WASATCH.NET組件以獲得GAC支持的信息，Wasatch維護者應引用“ Admin/Keys/Wasatch.net”。
如果您在安裝我們的libusb-win32驅動程序時遇到困難，請參見：
當Wasatch Dash或其他較舊的Wasatch驅動程序產品與Enlighten或我們的新驅動程序之一（例如Wasatch.net）安裝在同一台計算機上時，可能會發生這種情況。
您可以說，如果您在Windows設備管理器中查看，這就是問題所在，並且可以看到在“通用串行總線控制器”下列出的“ Wasatch Photonics Device FX2”。
要解決，請首先通過右鍵單擊“ Wasatch Photonics Device FX2”並選擇“卸載設備”：
確保單擊“刪除此設備的驅動程序軟件”：
從“操作”菜單中，選擇“掃描硬件更改”以在正確的設備驅動程序下重新數量：
現在，您應該看到在預期的Libusb-Win32驅動程序下列出的光譜儀：
現在，您應該能夠重新運行wasatch.net，wasatch.py或啟發軟件並連接到光譜儀。
有關駕駛員或API的問題，請聯繫：
