Wasatch.NET
1.0.0
Wasatch.net เป็น wrapper ระดับแอปพลิเคชันเหนือ USB ของ Wasatch Photonics 'และ SPI APIs มีให้เพื่อให้นักพัฒนาแอปพลิเคชันไม่จำเป็นต้องกังวลเกี่ยวกับ opcodes และ [de] marshalling octets ของข้อมูลดิบ; พวกเขาสามารถเรียกคุณสมบัติและวิธีการระดับสูงเช่น IntegrationTimems และ GetSpectrum ()
wasatch.net คาดว่าจะทำงานจากภาษาที่เข้ากันได้ทั้งหมด. NET ทั้งหมดรวมถึง:
| แพลตฟอร์ม | สถานะทดสอบ |
|---|---|
| C# | ทดสอบกับชุมชน Visual Studio 2017 |
| Labview | ทดสอบกับ 2017 32 บิต (ดู wasatch.lv) |
| MATLAB/SIMULINK | ทดสอบกับ 2017b 64 บิต (ดู Wasatch.Matlab) |
| Embarcadero Delphi | ทดสอบกับ Delphi Community Edition 10.2 มากกว่า com (ดู wasatch.delphi) |
| VBA (Excel) | ทดสอบกับ Office 2010 64 บิต (ดู Wasatch.excel) |
| R | ไม่ได้เริ่มต้น (วางแผนผ่าน RCLR) |
| ซามาริน | ไม่ได้เริ่ม |
| 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 เป็นต้นไม่จำเป็นต้องมีเครื่องห่อหุ้มหรือไลบรารีเพิ่มเติมเพื่อใช้ประโยชน์จากสเปกโตรมิเตอร์ของเราอย่างเต็มที่จากแพลตฟอร์มที่คุณเลือก
หากมีฟังก์ชั่นสเปกโตรมิเตอร์หรือสเปกโทรสโกปีที่คุณไม่พบในคอลเลกชัน Wrapper โอเพนซอร์ซของเราโปรดติดต่อเราและขอเพิ่มเติม หรือหากคุณต้องการ "ทำให้มือของคุณสกปรก" อย่าลังเลที่จะสร้างการใช้งานของคุณเองและเลือกแบ่งปันกับเราเพื่อรวมเข้ากับการกระจายฐาน Wasatch Photonics ภูมิใจที่จะช่วยสนับสนุนชุมชนออนไลน์ของเรา แต่ไม่ภูมิใจที่จะปฏิเสธแพตช์เมื่อพวกเขาปรับปรุงผลิตภัณฑ์!
ที่กล่าวว่าบางพื้นที่ที่รู้จักกันดีสำหรับการปรับปรุงสามารถพบได้ในงานค้างของเรา (ด้านล่าง)
wasatch.net มีการกระจายในไฟล์ Microsoft Installer (.MSI) ซึ่งติดตั้ง WasatchNet.dll และ libusbdotnet.dll ภายใต้ C: Windows (ดังนั้นพวกเขาจะอยู่ในเส้นทางของระบบเสมอ) นอกจากนี้ยังมีการติดตั้งไดรเวอร์ FTDI เพื่อรองรับการสื่อสาร SPI
นอกจากนี้ยังติดตั้งแอพ C# spectroscopy GUI อย่างง่าย Winformdemo, ภายใต้ Program Files Wasatch Photonics (หรือไฟล์โปรแกรม (x86) บนระบบ 32 บิต) ให้วิธีการควบคุมสเปกโตรมิเตอร์และตรวจสอบว่าไดรเวอร์ได้รับการติดตั้งและทำงานอย่างถูกต้อง
นอกเหนือจากการดับเบิลคลิกที่ติดตั้ง. MSI แล้วยังมีขั้นตอนเพิ่มเติมหนึ่งหรือสองขั้นตอนสำหรับการติดตั้งที่สมบูรณ์:
Wasatch.net เป็น "แอปพลิเคชันไดรเวอร์" ระดับสูงซึ่งสื่อสารกับสเปกโตรมิเตอร์ของเราโดยใช้ไดรเวอร์ "ระดับกลาง" libusbdotnet ซึ่งเป็นตัวขับเคลื่อนการสื่อสารโดยใช้ไดรเวอร์ USB ระดับ "ระดับต่ำ" Libusb-Win32 อย่างไรก็ตาม Windows ไม่ ทราบ ว่าสเปกโตรมิเตอร์ของเรามีความหมายที่จะใช้ libusb-win32 จนกว่าเราจะบอก!
ดังนั้นสิ่งแรกที่เราต้องทำคือติดตั้งไฟล์. inf ซึ่งเชื่อมโยงอุปกรณ์ USB ของเรา (ผ่าน VID/PID) กับ LIBUSB นี่คือกระบวนการที่จะทำเช่นนั้น:
เสียบเครื่องสเปกโตรมิเตอร์ USB Wasatch Photonics
Windows อาจแจ้งให้คุณ "ค้นหาไดรเวอร์สำหรับอุปกรณ์นี้" ถ้าไม่ไปที่ตัวจัดการอุปกรณ์ (เพียงพิมพ์ "ตัวจัดการอุปกรณ์" ลงในฟิลด์ค้นหา Win10 บนแถบเริ่มต้น)
เครื่องสเปกโตรมิเตอร์ของคุณควรปรากฏเป็น "Stroker FX2" หรือ "Stroker Ingas Camera" ภายใต้ "อุปกรณ์อื่น ๆ "
คลิกขวาที่รายการ Stroker แล้วเลือก "Update Driver"
เลือก "เรียกดูด้วยตนเองสำหรับไดรเวอร์"
ตรวจสอบ "[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 ของเราไม่ได้ลงทะเบียนไฟล์. TLB ที่ต้องการโดย VB6/VBA คุณต้องดำเนินการหนึ่งขั้นตอนเพิ่มเติม:
นำทางไปยัง program files wasatch photonics wasatch.net (หรือไฟล์โปรแกรม (x86) บนระบบ 32 บิต)
คลิกขวาที่ไฟล์แบตช์ "registerdll.bat" และเลือก "เรียกใช้เป็นผู้ดูแลระบบ"
ดังนั้นคุณต้องการสร้างและรวบรวม wasatch.net ตัวเองจากแหล่งที่มา? ดีนั่นคือวิธีที่เราชอบทำเช่นกัน ... คุณเรียนรู้มากขึ้นด้วยวิธีนี้ :-)
คนขับถูกเขียนและทดสอบภายใต้ชุมชน Visual Studio 2017 ใน Win10 64 บิต มันขึ้นอยู่กับห้องสมุดต่อไปนี้:
URL: https://sourceforge.net/projects/libusbdotnet/files/libusbdotnet/
นี่คือ wrapper. NET เหนือ LIBUSB-WIN32 มาตรฐานซึ่งใช้โดยผู้ขายอุปกรณ์ USB จำนวนมาก DLL ที่รวบรวมไว้ล่วงหน้าที่มีให้ในไดเรกทอรี LIB/ ไดเรกทอรีของเราถูกสร้างขึ้นจาก v2.2.8 โดยใช้ชุมชน Visual Studio 2017 กับโปรไฟล์ลูกค้า. NET 4.0
ในการใช้สเปกโตรมิเตอร์ XL-Series กับระบบกล้อง Andor นั้น Wasatch.net ต้องติดตั้ง Andor Driver Pack 2 ปัจจุบันมีให้บริการจาก Andor ที่ลิงค์ต่อไปนี้:
ดู readme-spi.md
DLL มาตรฐานของเราถูกสร้างขึ้นกับโปรไฟล์ไคลเอนต์. NET 4.8 เทียบกับเป้าหมายการดีบักดังนั้น DLL จะมีสัญลักษณ์การดีบักและข้อมูลเมตาสูงสุดสำหรับการแก้ไขปัญหาผู้ใช้ Winformdemo สร้างขึ้นกับ. NET 4.8
การกำหนดค่าการสร้างมาตรฐานและที่แนะนำคือ x64 แต่เรายังแจกจ่ายตัวติดตั้งสำหรับ x86 (Win32) เช่นผู้ใช้จำนวนมากมี LabVIEW รุ่น 32 บิตแม้ในระบบปฏิบัติการ 64 บิต
ตามคำขอของผู้ใช้เรารวมตัวติดตั้ง "AnyCPU" ด้วยเช่นกัน แต่การกำหนดค่านี้ขาดฟังก์ชั่นบางอย่าง (เช่นไดรเวอร์สำหรับเครื่องสเปกโตรมิเตอร์ Andor / XL)
ผู้ใช้สามารถสร้างไลบรารีด้วยการกำหนดค่าเป้าหมายหรือสถาปัตยกรรมใด ๆ โปรดแจ้งให้เราทราบหากคุณพบปัญหาใด ๆ ที่เราสามารถช่วยแก้ไขได้
หากคุณยังต้องการสร้างกับ. NET Framework 4.0 ให้ชำระเงินสาขา "Framework40" และสร้างโดยใช้ Visual Studio 2019 Community Edition
วิธีที่ง่ายที่สุดในการทดสอบว่าการติดตั้งของคุณประสบความสำเร็จคือการเรียกใช้ winformdemo ที่ให้ไว้ซึ่งควรมีอยู่ในเมนูเริ่มต้นของคุณภายใต้ Wasatch Photonics -> wasatch.net -> winformdemo
หากคุณมีสเปคโตรมิเตอร์ Wasatch Spectrometer และแสดงอย่างถูกต้องภายใต้ "อุปกรณ์ LIBUSB-WIN32" ในตัวจัดการอุปกรณ์คุณควรจะสามารถเรียกใช้การสาธิตได้จากนั้นคลิก "เริ่มต้น" เพื่อเชื่อมต่อกับสเปกโตรมิเตอร์
แม้ว่าไลบรารีจะช่วยให้แอปพลิเคชันกำหนดค่าการบันทึกทางโปรแกรมผ่าน 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) รองรับแอสเซมบลี. NET ที่โหลดใน GAC (แคชแอสเซมบลีทั่วไป) เพื่อที่จะโหลดลงใน GAC จะต้องมีการ "ตั้งชื่ออย่างยิ่ง" (เซ็นชื่อแบบดิจิทัล) ... พร้อมกับการพึ่งพาโดยตรง (DLL ที่ 3 ของพรรคเช่น libusbdotnet)
สำหรับข้อมูลเกี่ยวกับการลงนามแบบดิจิทัล Wasatch.net Assemblies สำหรับการสนับสนุน GAC ผู้ดูแล Wasatch ควรอ้างอิง "ผู้ดูแลระบบ/คีย์/wasatch.net"
หากคุณมีปัญหาในการติดตั้งไดรเวอร์ libusb-win32 ของเราให้ดู:
สิ่งนี้สามารถเกิดขึ้นได้เมื่อ Wasatch Dash หรือผลิตภัณฑ์ไดรเวอร์ Wasatch รุ่นเก่าอีกตัวได้รับการติดตั้งบนคอมพิวเตอร์เครื่องเดียวกับการรู้แจ้งหรือหนึ่งในไดรเวอร์ใหม่ของเรา (เช่น wasatch.net)
คุณสามารถบอกได้ว่านี่เป็นปัญหาหากคุณดูใน Windows Device Manager และคุณสามารถดู "Wasatch Photonics Device FX2" ที่ระบุไว้ภายใต้ "Universal Serial Bus Controllers"
ในการแก้ไขให้ถอนการติดตั้งไดรเวอร์ที่เก่ากว่าครั้งแรกโดยคลิกขวาที่ "Wasatch Photonics Device FX2" และเลือก "ถอนการติดตั้งอุปกรณ์"::
ตรวจสอบให้แน่ใจว่าคุณคลิก "ลบซอฟต์แวร์ไดรเวอร์สำหรับอุปกรณ์นี้":
จากเมนู "การกระทำ" เลือก "การสแกนสำหรับการเปลี่ยนแปลงฮาร์ดแวร์" เพื่อสร้างอุปกรณ์ใหม่ภายใต้ไดรเวอร์อุปกรณ์ที่ถูกต้อง:
ตอนนี้คุณควรเห็นสเปกโตรมิเตอร์ของคุณที่ระบุไว้ภายใต้ไดรเวอร์ LIBUSB-WIN32 ที่คาดหวัง:
ตอนนี้คุณควรจะสามารถเรียกใช้ซอฟต์แวร์ Wasatch.net, Wasatch.py หรือ Enlighten ของคุณอีกครั้งและเชื่อมต่อกับสเปกโตรมิเตอร์ของคุณ
สำหรับคำถามเกี่ยวกับคนขับหรือ API โปรดติดต่อ:
