Wasatch.NET
1.0.0
Wasatch.net هو غلاف على مستوى التطبيق على واجهات برمجة تطبيقات Wasatch Photonics 'USB و SPI. يتم توفيره بحيث لا يحتاج مطورو التطبيقات إلى القلق بشأن الرموز المفروضة و [دي] يرقم الثمانيات من البيانات الخام ؛ يمكنهم ببساطة استدعاء الخصائص عالية المستوى وطرق مثل IntegrationTimeMs و Getpectrum ().
من المتوقع أن تعمل wasatch.net من جميع اللغات المتوافقة مع: بما في ذلك:
| منصة | حالة الاختبار |
|---|---|
| ج# | تم اختباره مع مجتمع Visual Studio 2017 |
| لابفيو | تم اختباره مع 2017 32 بت (انظر wasatch.lv) |
| MATLAB/SIMULINK | تم اختباره مع 2017b 64 بت (انظر wasatch.matlab) |
| Embarcadero Delphi | تم اختباره مع Delphi Community Edition 10.2 Over Com (انظر Wasatch.delphi) |
| VBA (Excel) | تم اختباره مع Office 2010 64 بت (انظر wasatch.excel) |
| ص | لم تبدأ (المخطط لها عبر RCLR) |
| Xamarin | لم تبدأ |
| Visual Basic.net | لم تبدأ |
| و# | لم تبدأ |
| 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 بشكل وثيق في المستندات التالية:
لذلك ، من المحتمل أن يتم حل معظم الأسئلة حول المعلمات والأوضاع والخيارات عن طريق مراجعة واجهة اتصالات الطيف الأساسية.
يتم توفير برامج تشغيل تطبيقات Wasatch Photonics كتطبيقات مرجعية لإظهار كيفية قيادة الطيف والتحكم فيه على USB من مجموعة متنوعة من المنصات واللغات. نظرًا لأن أمثلة العمل و "الأغلفة الراحة" على واجهة برمجة تطبيقات USB الخاصة بنا ، فهي ليست مضمونة لتضمين وظائف الراحة لكل مكالمة وخيار داخل واجهة برمجة تطبيقات الأجهزة ، كما أنها ليست بالضرورة التنفيذ الأكثر كفاءة أو الأمثل في أي لغة معينة.
يتم توفير الواجهة الرسمية والكاملة إلى مطيافنا في وثائق USB API الخاصة بنا. برامج تشغيل USB القياسية للوصول إلى هذه الواجهة المباشرة وفيرة في جميع أنظمة التشغيل القياسية: libusb ، winusb ، إلخ
إذا كان هناك وظيفة مطياف أو وظيفة مطياف لا تجدها في مجموعة Wrapper مفتوحة المصدر ، فيرجى الاتصال بنا وطلب إضافتها ؛ أو إذا كنت ترغب في "الحصول على يديك متسخًا" ، فلا تتردد في إنشاء تطبيقك الخاص ومشاركته اختياريًا معنا لدمج في التوزيع الأساسي. تفخر Wasatch Photonics بالمساعدة في دعم مجتمعنا عبر الإنترنت ، ولكن ليس فخوراً جدًا بتراجع البقع عند تحسين المنتج!
ومع ذلك ، يمكن العثور على بعض المجالات المعروفة للتحسين في تراكمنا (أدناه).
يتم توزيع wasatch.net في ملف مثبت Microsoft (.MSI) ، والذي يقوم بتثبيت wasatchnet.dll و libusbdotnet.dll تحت C: Windows (بحيث تكون دائمًا في مسار النظام). يتم تثبيت برامج تشغيل FTDI أيضًا لدعم اتصالات SPI.
كما أنه يقوم بتثبيت تطبيق GUI للطيات الطيفية البسيطة ، وينفورمديمو ، ضمن Program Files Wasatch Photonics (أو ملفات البرنامج (x86) على أنظمة 32 بت) ، مما يتيح لك وسيلة للتحكم في مطياف المطياف والتحقق بسرعة من تثبيت برنامج التشغيل والعمل بشكل صحيح.
إلى جانب النقر المزدوج على مثبت .MSI ، هناك خطوة أو خطوتين إضافيتين مطلوبتين للتثبيت الكامل:
Wasatch.net هو "برنامج تشغيل تطبيق" عالي المستوى ، والذي يتواصل مع مطيافنا باستخدام برنامج تشغيل "Libusbdotnet" متوسطة المستوى ، والذي يتواصل في الدوران باستخدام برنامج "Libusb-Win32" ذي المستوى المنخفض. ومع ذلك ، لا يعرف Windows أن مطيافنا تهدف إلى استخدام libusb-win32 حتى نخبرها!
لذا فإن أول شيء نحتاج إلى القيام به هو تثبيت ملفات .inf التي تربط أجهزة USB الخاصة بنا (عبر VID/PID) باستخدام libusb. هذه هي العملية للقيام بذلك:
قم بتوصيل مطياف الضوئيات الضوئية USB Wasatch.
قد يطالبك Windows بـ "تحديد موقع برامج التشغيل لهذا الجهاز". إذا لم يكن الأمر كذلك ، فانتقل إلى مدير الأجهزة (فقط اكتب "مدير الجهاز" في حقل البحث في WIN10 في شريط البدء).
يجب أن تظهر مطيافك (S) كـ "Stroker FX2" أو "stroker Ingas Camera" تحت "الأجهزة الأخرى".
انقر بزر الماوس الأيمن على إدخال 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 لا يسجل ملف .tlb الذي يحتاجه VB6/VBA ، تحتاج إلى إجراء خطوة يدوية إضافية واحدة:
انتقل إلى Program Files wasatch photonics wasatch.net (أو ملفات البرنامج (x86) على أنظمة 32 بت)
انقر بزر الماوس الأيمن فوق ملف الدُفعة "registerDll.bat" ، وحدد "Run as Administrator"
هل ترغب في بناء وتجميع wasatch.net بنفسك من المصدر؟ جيد ، هكذا نحب أن نفعل ذلك أيضًا ... تتعلم الكثير بهذه الطريقة :-)
تمت كتابة السائق واختباره بموجب مجتمع Visual Studio 2017 على Win10 64 بت. تعتمد نفسها على المكتبات التالية:
url: https://sourceforge.net/projects/libusbdotnet/files/libusbdotnet/
هذا هو غلاف .NET على libusb-win32 القياسي والذي يستخدمه العديد من بائعي أجهزة USB. تم بناء DLL المدمج مسبقًا في LIB/ دليلنا من V2.2.8 باستخدام مجتمع Visual Studio 2017 مقابل ملف تعريف العميل .NET 4.0.
لاستخدام مطياف السلسلة XL مع نظام الكاميرا Andor ، يتطلب Wasatch.net تثبيت Andor Driver Pack 2. هذا متاح حاليًا من Andor على الرابط التالي:
انظر readme-spi.md.
تم تصميم DLL القياسي الخاص بنا مقابل ملف تعريف العميل .NET 4.8 مقابل هدف التصحيح ، وبالتالي فإن DLL سيكون له أقصى قدر من رموز تصحيح الأخطاء والبيانات الوصفية لاستكشاف المستخدم وإصلاحها. تم بناء Winformdemo ضد .NET 4.8.
تكوين الإنشاء القياسي والمأمب هو X64 ، لكننا نقوم أيضًا بتوزيع المثبتات على X86 (Win32) ، كما هو الحال على سبيل المثال ، لدى العديد من المستخدمين إصدارات 32 بت من LabView حتى على أنظمة التشغيل 64 بت.
حسب طلب المستخدم ، نقوم بتضمين مثبت "anycpu" أيضًا ، ولكن هذا التكوين يفتقد بعض الوظائف (مثل برامج التشغيل الخاصة بـ Andor / XL Plectrometers).
نرحب بالمستخدمين لبناء المكتبة بأنفسهم مقابل أي تكوين أو بنية مستهدفة ؛ يرجى إعلامنا إذا واجهت أي مشكلات يمكننا المساعدة في حلها.
إذا كنت لا تزال بحاجة إلى البناء ضد .NET Framework 4.0 ، قم بالخروج عن فرع "Framework40" وبناء باستخدام Visual Studio 2019 Community Edition.
إن أبسط طريقة لاختبار ما إذا كان التثبيت الخاص بك ناجحًا هو تشغيل WinFormDemo المقدم ، والذي يجب أن يكون متاحًا في قائمة البداية الخاصة بك تحت Wasatch Photonics -> wasatch.net -> winformdemo.
إذا كان لديك مقياس طيف Wasatch Photonics تم توصيله بشكل صحيح وإظهاره بشكل صحيح ضمن "أجهزة 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 ، يجب أن يتم "تسمية بقوة" (موقعة رقميًا) ... إلى جانب تبعياتها المباشرة (DLLs الطرف الثالث مثل libusbdotnet).
للحصول على معلومات حول التوقيع الرقمي Wasatch.net Senslies لدعم GAC ، يجب على محفوظات Wasatch الإشارة إلى "admin/keys/wasatch.net".
إذا كنت تواجه مشكلة في تثبيت برامج تشغيل libusb-win32 ، انظر:
يمكن أن يحدث هذا عندما تم تثبيت Wasatch Dash أو منتج برنامج التشغيل Wasatch الأقدم الآخر على نفس الكمبيوتر مثل Enlighten أو أحد برامج التشغيل الأحدث (مثل 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 ، يرجى الاتصال:
