Wasatch.NET
1.0.0
Wasatch.net adalah pembungkus tingkat aplikasi atas USB dan API SPI Wasatch Photonics. Ini disediakan agar pengembang aplikasi tidak perlu khawatir tentang opcode dan [de] marshalling oktet data mentah; Mereka dapat dengan mudah memanggil properti dan metode tingkat tinggi seperti IntegrationTimems dan GetSpectrum ().
Wasatch.net diharapkan bekerja dari semua bahasa yang kompatibel.
| Platform | Status pengujian |
|---|---|
| C# | Diuji dengan Komunitas Visual Studio 2017 |
| Labview | Diuji dengan 2017 32-bit (lihat wasatch.lv) |
| Matlab/Simulink | Diuji dengan 2017b 64-bit (lihat wasatch.matlab) |
| Embarcadero Delphi | Diuji dengan Delphi Community Edition 10.2 over com (lihat wasatch.delphi) |
| VBA (Excel) | Diuji dengan Office 2010 64-bit (lihat wasatch.excel) |
| R | tidak dimulai (direncanakan melalui rclr) |
| Xamarin | tidak dimulai |
| Visual Basic.net | tidak dimulai |
| F# | tidak dimulai |
| Wolfram Mathematica | tidak dimulai |
Jika ada orang lain yang ingin Anda lihat terdaftar, beri tahu kami dan kami akan mengujinya!
Installer yang telah dikompilasi tersedia untuk jendela 32-bit dan 64-bit:
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
Untuk kode panggilan sampel, lihat C# WinFormDemo yang disertakan.
Dokumentasi API tersedia di sini:
Pengemudi dirancang untuk meniru dengan cermat USB API yang ditentukan dalam dokumen berikut:
Oleh karena itu, sebagian besar pertanyaan tentang parameter, mode, dan opsi kemungkinan dapat diselesaikan dengan meninjau antarmuka komunikasi spektrometer yang mendasarinya.
Driver aplikasi Wasatch Photonics disediakan sebagai implementasi referensi untuk menunjukkan cara memerintahkan dan mengontrol spektrometer kami atas USB dari berbagai platform dan bahasa. Sebagai contoh yang berfungsi dan "pembungkus kenyamanan" di atas USB API kami, mereka tidak dijamin untuk memasukkan fungsi kenyamanan untuk setiap panggilan dan opsi dalam API perangkat keras, juga tidak harus implementasi yang paling efisien atau optimal dalam bahasa apa pun.
Antarmuka formal dan lengkap untuk spektrometer kami disediakan dalam dokumentasi API USB kami. Driver USB standar untuk mengakses antarmuka langsung yang berlimpah pada semua sistem operasi standar: LIBUSB, WINUSB dll. Tidak ada pembungkus atau perpustakaan tambahan yang diperlukan untuk memanfaatkan sepenuhnya spektrometer kami dari platform pilihan Anda.
Jika ada fungsi spektrometer atau spektroskopi yang tidak Anda temukan disediakan dalam koleksi pembungkus sumber terbuka kami, silakan hubungi kami dan minta penambahannya; Atau jika Anda ingin "membuat tangan Anda kotor," jangan ragu untuk membuat implementasi Anda sendiri dan secara opsional membaginya dengan kami untuk bergabung ke dalam distribusi dasar. Wasatch Photonics dengan bangga membantu mendukung komunitas online kami, tetapi tidak terlalu bangga untuk menolak tambalan ketika mereka meningkatkan produk!
Yang mengatakan, beberapa bidang yang diketahui untuk perbaikan dapat ditemukan di simpanan kami (di bawah).
Wasatch.net didistribusikan dalam file Microsoft Installer (.msi), yang menginstal wasatchnet.dll dan libusbdotnet.dll di bawah C: windows (jadi mereka akan selalu berada di jalur sistem). Driver FTDI juga diinstal untuk mendukung SPI Communications.
Ini juga menginstal aplikasi GUI C# Spectroscopy sederhana, WinFormDemo, di bawah Program Files Wasatch Photonics (atau file program (x86) pada sistem 32-bit), memberi Anda cara untuk mengontrol spektrometer dan dengan cepat memverifikasi driver diinstal dan berfungsi dengan benar.
Selain mengklik dua kali penginstal .msi, ada satu atau dua langkah tambahan yang diperlukan untuk instalasi lengkap:
Wasatch.net adalah "driver aplikasi tingkat tinggi, yang berkomunikasi dengan spektrometer kami menggunakan driver libusbdotnet" level menengah ", yang secara turn-turn berkomunikasi menggunakan driver USB libusb-win32" tingkat rendah ". Namun, Windows tidak tahu bahwa spektrometer kami dimaksudkan untuk menggunakan libusb-win32 sampai kami mengatakannya!
Jadi hal pertama yang perlu kita lakukan adalah menginstal file .inf yang mengaitkan perangkat USB kita (melalui VID/PID) dengan libusb. Ini adalah proses untuk melakukannya:
Colokkan spektrometer fotonik USB Wasatch.
Windows dapat meminta Anda untuk "menemukan driver untuk perangkat ini". Jika tidak, buka Device Manager (cukup ketik "Device Manager" ke bidang pencarian Win10 di bilah start).
Spektrometer Anda akan muncul sebagai "Stroker FX2" atau "Stroker Ingas Camera" di bawah "perangkat lain".
Klik kanan pada entri Stroker dan pilih "Perbarui Driver".
Pilih "Jelajahi secara manual untuk pengemudi".
Pastikan "[x] termasuk subfolder" diperiksa
Jelajahi ke "C: Program Files Wasatch Photonics wasatch.net libusb_drivers" atau "C: Program Files (x86) Wasatch Photonics wasatch.net libusb_driver" sebagaimana mestinya.
Langkah ini diyakini hanya diperlukan untuk pengembang yang menggunakan Visual Basic 6 (VB6) atau Visual Basic untuk aplikasi (VBA, bagian dari Microsoft Excel).
Karena penginstal .msi kami tidak mendaftarkan file .tlb yang diperlukan oleh VB6/VBA, Anda perlu melakukan satu langkah manual tambahan:
Arahkan ke Program Files Wasatch Photonics wasatch.net (atau file program (x86) pada sistem 32-bit)
Klik kanan file batch "registerdll.bat", dan pilih "Run as Administrator"
Jadi Anda ingin membangun dan menyusun wasatch.net diri Anda dari sumber? Bagus, begitulah cara kami melakukannya juga ... Anda belajar lebih banyak seperti itu :-)
Pengemudi itu ditulis dan diuji di bawah komunitas Visual Studio 2017 di Win10 64-bit. Itu sendiri tergantung pada perpustakaan berikut:
Url: https://sourceForge.net/projects/libusbdotnet/files/libusbdotnet/
Ini adalah pembungkus .net di atas libusb-win32 standar yang digunakan oleh banyak vendor perangkat USB. DLL yang telah dikompilasi sebelumnya yang disediakan di LIB/ Direktori kami dibangun dari v2.2.8 Menggunakan Komunitas Visual Studio 2017 Melawan Profil Klien .NET 4.0.
Untuk menggunakan spektrometer XL-Series dengan sistem kamera Andor, Wasatch.net mengharuskan Andor Driver Pack 2 diinstal. Ini saat ini tersedia dari Andor di tautan berikut:
Lihat readme-spi.md.
DLL standar kami dibangun terhadap profil klien .NET 4.8 terhadap target debug, sehingga DLL akan memiliki jumlah maksimum simbol debugging dan metadata untuk pemecahan masalah pengguna. WinFormDemo dibangun melawan .NET 4.8.
Konfigurasi build standar dan yang disarankan adalah x64, tetapi kami juga mendistribusikan installer untuk x86 (Win32), karena misalnya banyak pengguna memiliki versi 32-bit dari LabView bahkan pada sistem operasi 64-bit.
Dengan permintaan pengguna, kami juga menyertakan penginstal "anycpu", tetapi konfigurasi ini tidak ada fungsionalitas (misalnya driver untuk spektrometer Andor / XL).
Pengguna dipersilakan untuk membangun perpustakaan sendiri terhadap konfigurasi target atau arsitektur apa pun; Beri tahu kami jika Anda menghadapi masalah apa pun yang dapat kami bantu selesaikan.
Jika Anda masih perlu membangun melawan .NET Framework 4.0, checkout cabang "Framework40" dan membangun menggunakan Visual Studio 2019 Community Edition.
Cara paling sederhana untuk menguji apakah instalasi Anda berhasil adalah menjalankan WinFormDemo yang disediakan, yang seharusnya tersedia di menu start Anda di bawah Wasatch Photonics -> wasatch.net -> WinFormDemo.
Jika Anda memiliki spektrometer fotonik Wasatch yang dicolokkan dan ditampilkan dengan benar di bawah "perangkat libusb-win32" di manajer perangkat, Anda harus dapat menjalankan demo, lalu klik "Inisialisasi" untuk terhubung ke spektrometer.
Meskipun perpustakaan memungkinkan aplikasi mengkonfigurasi logging secara terprogram melalui driver.logger.level dan .setPathName (), tidak semua aplikasi melakukannya. Pengguna akhir dari aplikasi yang dikompilasi masih dapat mengkonfigurasi logging secara manual dengan mengatur variabel lingkungan ini sebelum menjalankan program menggunakan 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)
Namun, "default" lingkungan ini masih dapat diganti dengan kode aplikasi yang secara eksplisit menyebut metode dan properti di atas.
Setidaknya satu bahasa klien (LabView NXG) hanya mendukung .NET Assemblies yang dimuat dalam GAC (General Assembly Cache). Untuk dimuat ke GAC, sebuah perakitan harus "dinamai kuat" (ditandatangani secara digital) ... bersama dengan dependensi langsungnya (DLL pihak ke-3 seperti libusbdotnet).
Untuk informasi tentang penandatanganan digital wasatch.net rakitan untuk dukungan GAC, pemelihara wasatch harus merujuk "admin/tombol/wasatch.net".
Jika Anda kesulitan memasang driver libusb-win32 kami, lihat:
Ini dapat terjadi ketika Wasatch Dash atau produk driver Wasatch yang lebih lama telah diinstal pada komputer yang sama dengan Enlighten atau salah satu driver kami yang lebih baru (seperti Wasatch.net).
Anda dapat mengatakan bahwa ini adalah masalah jika Anda melihat di Windows Device Manager, dan Anda dapat melihat "Wasatch Photonics Device FX2" yang tercantum di bawah "Pengontrol Bus Serial Universal".
Untuk menyelesaikan, pertama-tama hapus instalan driver yang lebih tua, dengan mengklik kanan "Wasatch Photonics Device FX2" dan memilih "Uninstall Device"::
Pastikan Anda mengklik "Hapus perangkat lunak driver untuk perangkat ini":
Dari menu "Action", pilih "Pindai untuk Perubahan Perangkat Keras" untuk menilai kembali perangkat di bawah driver perangkat yang benar:
Anda sekarang harus melihat spektrometer Anda terdaftar di bawah driver LibUSB-Win32 yang diharapkan:
Anda sekarang harus dapat menjalankan kembali perangkat lunak wasatch.net, wasatch.py atau pencerahan Anda dan terhubung ke spektrometer Anda.
Untuk pertanyaan tentang pengemudi atau API, silakan hubungi:
