الأدوات السائلة MATLAB API التكامل الصمامات

دليل ترحيل MATLAB API

تؤدي ترقية Moku: Lab إلى الإصدار 3.0 من البرنامج إلى فتح مجموعة من الميزات الجديدة. عند التحديث، يجب على مستخدمي واجهة برمجة التطبيقات (API) اتخاذ خطوات إضافية لترحيل البرامج النصية الخاصة بهم إلى حزمة Moku API الجديدة. يوضح دليل الترحيل هذا تغييرات واجهة برمجة التطبيقات (API)، والميزات الجديدة المتوفرة في تحديث الإصدار 3.0، وأي قيود على التوافق مع الإصدارات السابقة.

زيادةview

يعد الإصدار 3.0 من برنامج Moku:Lab تحديثًا رئيسيًا يجلب البرامج الثابتة الجديدة وواجهة المستخدم وAPls إلى أجهزة Moku:Lab. يجعل التحديث Moku:Lab متوافقًا مع Moku:Pro وMoku:Go، مما يجعل من السهل مشاركة البرامج النصية عبر جميع منصات Moku. يفتح التحديث مجموعة من الميزات الجديدة للعديد من الأدوات الحالية. كما يضيف أيضًا ميزتين جديدتين: وضع الأدوات المتعددة وMoku Cloud Compile. توجد أيضًا بعض الاختلافات السلوكية الدقيقة، الموضحة في قسم التوافق مع الإصدارات السابقة.

يعد هذا تحديثًا رئيسيًا يؤثر على بنية واجهة برمجة التطبيقات (API)، وبالتالي فإن حزمة MATLAB API v3.0 الجديدة لن تكون متوافقة مع نصوص MATLAB النصية الحالية. سيحتاج مستخدمو واجهة برمجة التطبيقات (API) إلى نقل البرامج النصية الخاصة بهم إلى حزمة Moku API الجديدة إذا قاموا بترقية Moku:Lab إلى الإصدار 3.0. يجب على مستخدمي واجهة برمجة التطبيقات (API) الذين لديهم تطوير كبير للبرامج المخصصة أن يفكروا بعناية في مستوى الجهد المطلوب لنقل التعليمات البرمجية الحالية الخاصة بهم. لا يُنصح باستخدام Moku:Lab 1.9 لعمليات النشر الجديدة ويتم تشجيع جميع العملاء على الترقية. إذا ظهرت مشكلات بعد الترقية، فسيكون لدى المستخدمين خيار الرجوع إلى إصدار البرنامج 1.9.

يوضح دليل الهجرة هذا التقدمtagميزات التحديث والتعقيدات المحتملة لـ Moku:Lab الإصدار 3.0. كما أنه يوضح عملية ترقية MATLAB API وكيفية الرجوع إلى إصدار سابق من Moku:Lab إذا لزم الأمر.

الإصدار 3.0 الميزات الجديدة

الميزات الجديدة

يوفر الإصدار 3.0 من البرنامج وضع Multi-Instrument Mode وMoku Cloud Compile إلى Moku:Lab لأول مرة، بالإضافة إلى العديد من ترقيات الأداء وسهولة الاستخدام عبر مجموعة الأدوات.

وضع متعدد الآلات

يتيح وضع الأدوات المتعددة في Moku:Lab للمستخدمين نشر أداتين في وقت واحد لإنشاء محطة اختبار مخصصة. يتمتع كل جهاز بإمكانية الوصول الكامل إلى المدخلات والمخرجات التناظرية بالإضافة إلى التوصيلات البينية بين فتحات الجهاز. تدعم التوصيلات البينية بين الأجهزة اتصالاً رقميًا عالي السرعة وزمن وصول منخفض وفي الوقت الفعلي يصل إلى 2 جيجابت/ثانية، بحيث يمكن تشغيل الأجهزة بشكل مستقل أو توصيلها لبناء خطوط أنابيب متقدمة لمعالجة الإشارات. يمكن تبديل الأدوات ديناميكيًا للداخل والخارج دون مقاطعة الأداة الأخرى. يمكن للمستخدمين المتقدمين أيضًا نشر خوارزمياتهم المخصصة في وضع الأدوات المتعددة باستخدام Moku Cloud Compile.

تجميع سحابة موكو

يتيح لك Moku Cloud Compile نشر DSP مخصص مباشرةً على Moku:Lab FPGA في وضع الأجهزة المتعددة. كتابة الكود باستخدام أ web المتصفح وتجميعه في السحابة؛ يقوم Moku Cloud Compile بنشر تدفق البتات إلى جهاز واحد أو أكثر من أجهزة Moku المستهدفة.

منظار الذبذبات

• وضع الذاكرة العميقة: يوفر ما يصل إلى 4 ميجا ثانيةampLes لكل قناة بكامل sampمعدل لينغ (500 مللي أمبير/ثانية)

محلل الطيف

• تحسين أرضية الضوضاء
• مقياس Vrms اللوغاريتمي وVpp
• خمس وظائف نافذة جديدة (Bartlett، Hamming، Nuttall، Gaussian، Kaiser)

مقياس الطور

• إزاحة التردد، المرحلة، و ampيمكن الآن إخراج خط الطول كمجلد تناظريtagإشارات البريد
• يمكن للمستخدمين الآن إضافة إزاحة التيار المستمر إلى إشارات الإخراج
• يمكن الآن مضاعفة تردد خرج الموجة الجيبية المقفلة الطور حتى 2x أو تقسيمه إلى 50x
• تحسين نطاق عرض النطاق الترددي (1 هرتز إلى 100 كيلو هرتز)
• التفاف المرحلة المتقدمة ووظائف إعادة الضبط التلقائي

مولد الموجي

• إخراج الضوضاء
• تعديل عرض النبضة (PWM)

اربط Ampالقمامة

• تحسين أداء الترددات المنخفضة ب ل ل قفل
• تم تخفيض الحد الأدنى لتردد PLL إلى 10 هرتز
• يمكن الآن مضاعفة تردد إشارة PLL الداخلية حتى 250x أو تقسيمها إلى 125x لاستخدامها في إزالة التشكيل
• دقة مكونة من 6 أرقام لقيم الطور

محلل استجابة التردد

• زيادة الحد الأقصى للتردد من 120 ميجا هرتز إلى 200 ميجا هرتز
• زيادة الحد الأقصى لنقاط الاجتياح من 512 إلى 8192
• الديناميكية الجديدة Ampتعمل ميزة lititude على تحسين إشارة الإخراج تلقائيًا للحصول على أفضل نطاق ديناميكي للقياس
• وضع قياس ln/ln1 الجديد
• تحذيرات تشبع الإدخال
• تدعم قناة الرياضيات الآن معادلات ذات قيمة معقدة عشوائية تتضمن إشارات القناة، مما يتيح أنواعًا جديدة من قياسات دالة النقل المعقدة
• يمكن الآن قياس إشارات الإدخال بوحدات dBVpp وdBVrms بالإضافة إلى dBm
• يتم الآن عرض تقدم عملية المسح على الرسم البياني
• يمكن الآن قفل محور التردد لمنع التغييرات العرضية أثناء المسح الطويل

صندوق قفل الليزر

• يُظهر الرسم التخطيطي المحسّن مسارات إشارة المسح والتعديل
• القفل الجديد Stagتتيح ميزة es تخصيص إجراء القفل
• تحسين أداء الترددات المنخفضة ب ل ل قفل
• دقة مكونة من 6 أرقام لقيم الطور
• تحسين أداء الترددات المنخفضة ب ل ل قفل
• تم تخفيض الحد الأدنى لتردد PLL إلى 10 هرتز
• ال ب ل ل يمكن الآن مضاعفة تردد الإشارة حتى 250x أو تقسيمها إلى 0.125x لاستخدامها في إزالة التشكيل

آخر

تمت إضافة دعم لوظيفة الجيب إلى محرر المعادلات والذي يمكن استخدامه لإنشاء أشكال موجية مخصصة في مولد الموجات العشوائية

تحويل ثنائي LI files إلى تنسيقات CSV أو MATLAB أو NumPy عند التنزيل من الجهاز

ترقية دعم API

توفر حزمة Moku MATLAB API v3.0 الجديدة وظائف واستقرارًا محسنين. وسيتلقى تحديثات منتظمة لتحسين الأداء وإدخال ميزات جديدة.

قيود التوافق مع الإصدارات السابقة

واجهة برمجة التطبيقات

حزمة Moku MATLAB API v3.0 الجديدة غير متوافقة مع حزمة Moku:Lab MATLAB v1.9 السابقة. تختلف وسيطات البرمجة النصية MATLAB وقيم الإرجاع تمامًا. إذا كان لديك تطوير برامج مخصصة واسعة النطاق باستخدام Moku:Lab MATLAB، ففكر في تأثير ترحيل جميع برامجك لتكون متوافقة مع واجهة برمجة التطبيقات الجديدة.

في حين أن حزمة Moku:Lab MATLAB لن تتلقى التحديثات بعد الآن، ستستمر Liquid Instruments في تقديم الدعم للمستخدمين غير القادرين على الانتقال إلى حزمة API الجديدة.

البحث عن تفاصيل السابقينampملفات لكل أداة في حزمة Moku MATLAB API v3.0 الجديدة لتكون بمثابة خط أساسي لتحويل تطوير MATLAB السابق إلى حزمة API الجديدة.

الانحدارات

قرص RAM لتسجيل البيانات

الإصدار 1.9 كان بمساحة 512 ميجابايت fileالنظام الموجود في ذاكرة الوصول العشوائي (RAM) بالجهاز، والذي يمكن استخدامه لتسجيل البيانات بسرعة عاليةampمعدلات لينغ. في الإصدار 3.0، لم يعد تسجيل الدخول إلى ذاكرة الوصول العشوائي متاحًا. لتمكين تسجيل البيانات، مطلوب بطاقة SD. وبناء على ذلك، تتغير السرعة القصوى للاستحواذ أيضًا. يدعم الإصدار 1.9 ما يصل إلى 1 MSa/s، بينما يدعم الإصدار 3.0 ما يصل إلى 250 كيلو سا/ثانية في قناة واحدة و1 كيلو سا/ثانية في قناتين. حتى عند السرعات المنخفضة وباستخدام بطاقة SD، لن يتم دعم عمليات سير العمل التي تتضمن حفظ سجلات متعددة عالية السرعة في ذاكرة الوصول العشوائي (RAM) ثم نسخها لاحقًا إلى بطاقة SD أو العميل.

تسجيل البيانات إلى CSV

يتمتع الإصدار 1.9 بالقدرة على حفظ البيانات مباشرة في ملف CSV file أثناء التسجيل. هذه الميزة غير متوفرة مباشرة في الإصدار 3.0. المستخدمون الذين يتضمن سير عملهم حفظ ملف CSVfileمباشرة إلى بطاقة SD أو سيحتاج العميل الآن إلى تحويل الملف الثنائي أولاً file إلى CSV، إما باستخدام تطبيق العميل أو عن طريق تثبيت Liquid Instruments المستقل File تحويل على الكمبيوتر الذي يستخدمونه لمعالجة البيانات.

تغييرات غير متوافقة مع الإصدارات السابقة

تحجيم البيانات في LIA

في الإصدار 1.9، قمنا بتنفيذ تحجيم البيانات بحيث يؤدي ضرب إشارتين من التيار المستمر بقدرة 0.1 فولت إلى إنتاج تيار مستمر بقدرة 0.02 فولت. في الإصدار 3.0، قمنا بتغيير ذلك بحيث كانت النتيجة 0.01 فولت تيار مباشر، وهو ما يتماشى أكثر مع توقعات العملاء البديهية.

يجب تمكين مخرجات Waveform Generator لاستخدامها كمصدر/مشغل تعديل

في الإصدار 1.9، يمكن استخدام الشكل الموجي لقناة مختلفة كمصدر تعديل أو تشغيل في مولد الشكل الموجي، حتى لو تم تعطيل إخراج تلك القناة. تمت إزالة هذا في الإصدار

• سيحتاج المستخدمون الذين يرغبون في إجراء تعديل متقاطع دون الحاجة إلى فصل مخرجات أجهزتهم إلى ضبط إعداداتهم

موكو MATLAB API

تهدف حزمة Moku MATLAB API v3.0 إلى تزويد مطوري MATLAB بالموارد اللازمة للتحكم في أي جهاز Moku، وفي النهاية، القدرة على دمج عناصر التحكم هذه في تطبيقات أكبر للمستخدم النهائي. توفر حزمة Moku MATLAB API v3.0 الجديدة ما يلي:

• وظيفية بالكامل على سبيل المثالampالبرامج النصية MATLAB لكل منها
• يتم تزويد جميع نصوص MATLAB بالتعليقات، والتي يسهل فهمها ويمكن أن تكون بمثابة نقطة بداية للمستخدم النهائي للتخصيص والتعديل.
• مجموعة من الوظائف توفر التحكم الكامل في Moku

الأدوات المدعومة حاليا

1. مولد الموجي التعسفي
2. مسجل البيانات
3. صندوق مرشح رقمي
4. منشئ مرشح FIR
5. محلل استجابة التردد
6. صندوق قفل الليزر
7. قفل Ampالقمامة
8. منظار الذبذبات
9. مقياس الطور
10. وحدة التحكم PID
11. محلل الطيف
12. مولد الموجي
13. وضع متعدد الآلات
14. تجميع سحابة موكو

تثبيت

متطلبات

• إصدار MATLAB 2015 أو الأحدث

إذا كان لديك بالفعل إصدار سابق من Moku MATLAB API مثبتًا، فيرجى إلغاء تثبيته قبل المتابعة. يمكنك إلغاء تثبيت الحزمة من مدير الوظائف الإضافية.

1. افتح مدير الوظائف الإضافية من خلال علامة التبويب الصفحة الرئيسية > البيئة.
2. بحث عن Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. وبدلاً من ذلك، يمكنك تنزيل صندوق الأدوات مباشرةً من Liquid Instruments webالموقع في https://www.liquidinstruments.com/products/apis/matlab-api/. سيتعين عليك تعيين مسار البحث يدويًا إذا قمت بذلك.
4. تأكد من إضافة المسار الصحيح إلى صندوق الأدوات عن طريق تحديد "تعيين المسار" من علامة التبويب "الصفحة الرئيسية" > "البيئة".
5. تأكد من وجود إدخال يشير إلى موقع تثبيت صندوق الأدوات. قد يكون المسار النموذجي هو CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. تنزيل بيانات الأداة fileعن طريق كتابة "moku_download####) في نافذة أوامر MATLAB. يجب استبدال ### بإصدار البرنامج الثابت الحالي لديك. يمكن لـ Yol العثور على إصدار البرنامج الثابت الحالي الخاص بك من خلال تطبيق Moku: لسطح المكتب من خلال النقر بزر الماوس الأيمن على Moku والتمرير فوق "معلومات الجهاز"، أو في تطبيق iPad بالضغط لفترة طويلة على Moku.
7. تأكد من إعداد صندوق الأدوات الخاص بك بشكل صحيح عن طريق كتابة "مساعدة Moku" في نافذة أوامر MATLAB. إذا نجح هذا الأمر. ثم تم تثبيت صندوق الأدوات بنجاح

تغييرات Moku API

تختلف بنية Moku MATLAB API الجديدة بشكل كافٍ عن سابقتها وبالتالي فهي غير متوافقة مع نصوص API الموجودة. الذبذبات المبسطة التالية على سبيل المثالampيعرض le الاختلافات بين حزم واجهة برمجة التطبيقات القديمة والجديدة ويعمل كخريطة طريق لنقل التعليمات البرمجية الموجودة.

راسم الذبذبات على سبيل المثالample

خطوات التسلسل

1. قم باستيراد Moku MATLAB API 3.0
2. قم بالمطالبة بملكية Moku وقم بتحميل تدفق بتات راسم الذبذبات إلى
3. قم بتعيين القاعدة الزمنية وضبط النطاق الأيسر والأيمن لمحور الوقت.
4. احصل على البيانات، واحصل على إطار واحد للبيانات من راسم الذبذبات
5. إنهاء جلسة العميل بالتخلي عن ملكية Moku

التسلسل الموصوف أعلاه هو مثال مبسطample لتوضيح الاختلافات بين حزم API القديمة والجديدة. بصرف النظر عن بدء جلسة العميل، وتحميل تدفق بت للأداة إلى Moku، وإنهاء جلسة العميل، يمكن للمستخدم النهائي ممارسة أي عدد من الوظائف بترتيب مختلف لتلبية احتياجات تطبيقه.

الاختلافات

هنا، ننظر إلى الاختلافات بين APls لكل خطوة في التسلسل.

قم بالمطالبة بملكية Moku وقم بتحميل تدفق بتات راسم الذبذبات إلى الجهاز. بالمقارنة مع Moku MATLAB 1.9، فإن واجهة برمجة التطبيقات الجديدة لها وظائف مختلفة تمامًا:

	موكو ماتلاب 1.9		موكو ماتلاب 3.0
وظيفة	get_by_name()	Deploy_or_conn إلخ ()	راسم الذبذبات ()
الحقول والقيم المسموح بها	الاسم: مهلة السلسلة: تعويم	الأداة: فئة الأداة التي ترغب في نشرها	الملكية الفكرية: سلسلة المسلسل: سلسلة
	القوة: بول	set_defauIt: booI	force_connect: منطقي
		use_externa I: bool	تجاهل_مشغول: منطقي
			استمرار_الحالة: منطقي
			Connect_timeout: تعويم
			read_timeout: تعويم

 

1. ضبط قاعدة الوقت. الدالة هي نفسها، لكن الوسيطات المسموح بها مختلفة قليلاً:
   

   	موكو ماتلاب 1.9	موكو ماتلاب 3.0
   وظيفة	set_timebase()	set_timebase()
   الحقول والقيم المسموح بها	t1: تعويم t2: تعويم	t1: تعويم t2: تعويم صارم: منطقي

2. احصل على البيانات. الوظائف والوسائط المسموح بها هي نفسها، ولكن نوع البيانات التي تم إرجاعها وطولها مختلفان:
   

   	موكو ماتلاب 1.9	موكو ماتلاب 3.0
   وظيفة	احصل على البيانات()	احصل على البيانات()
   الحقول والقيم المسموح بها	المهلة: تعويم الانتظار: منطقي	المهلة: تعويم wait_reacquire: bool
   طول العودة	16383 نقطة لكل إطار	1024 نقطة لكل إطار

3. حرر ملكية Moku:
   

   	موكو ماتلاب 1.9	موكو API v3.0
   وظيفة	يغلق()	التخلي عن الملكية ()

قائمة وظائف الذبذبات

موكو ماتلاب 1.9	موكو ماتلاب 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
get_dataQ	get_dataQ
set_frontendQ	set_frontendQ
set_defau!tsQ set_timebaseO set_xmodeQ	set_defau!tsQ set_timebaseQ Disable_inputO Enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sync_phaseQ	sync_output_phaseQ
get_frontendQ	get_frontendQ
يحصل علىamp!rateO get_rea!time_dataQ	يحصل علىamp!rateO save_high_res_bufferO
gen_rampwaveO gen_sinewaveO	generator_waveformO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
مجموعاتampمثقفس set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	ملخصس

تعتمد واجهة Moku MATLAB API على Moku API. للحصول على وثائق Moku API الكاملة، راجع مرجع Moku API الموجود هنا https://apis.liq uidinstrume nts.com/re fe reنيس /.

يمكن العثور على تفاصيل إضافية لبدء استخدام Moku MATLAB API على الموقع https://a pis.liquid instruments.com/sta تصنيف-ماتلاب.بيت

عملية الرجوع إلى إصدار أقدم

إذا ثبت أن الترقية إلى الإصدار 3.0 تحد من شيء بالغ الأهمية لتطبيقك أو تؤثر سلبًا عليه، فيمكنك الرجوع إلى الإصدار السابق 1.9. ويمكن أن يتم ذلك من خلال أ web المتصفح.

خطوات

1. اتصل بالأدوات السائلة واحصل على file لإصدار البرنامج الثابت 9.
2. اكتب عنوان IP الخاص بـ Moku:Lab في ملف web المتصفح (انظر الصورة).
3. ضمن تحديث البرنامج الثابت، استعرض البرنامج الثابت وحدده file المقدمة من الأدوات السائلة.
4. حدد تحميل وتحديث. يمكن أن تستغرق عملية التحديث أكثر من 10 دقائق حتى تكتمل

© 2023 ليكويد إنسترومنتس. محجوز.

laudinstruments.com

المستندات / الموارد

الأدوات السائلة MATLAB API التكامل الصمامات [بي دي اف] دليل المستخدم MATLAB API، صمامات التكامل MATLAB API، صمامات التكامل، الصمامات

مراجع

• دليل المستخدم