فیوزهای یکپارچه سازی API MATLAB LIQUID INSTRUMENTS

راهنمای مهاجرت MATLAB API

ارتقاء Moku: Lab به نرم افزار نسخه 3.0 مجموعه ای از ویژگی های جدید را باز می کند. هنگام به روز رسانی، کاربران API باید اقدامات بیشتری را برای انتقال اسکریپت های خود به بسته جدید Moku API انجام دهند. این راهنمای مهاجرت تغییرات API، ویژگی‌های جدید موجود در به‌روزرسانی نسخه 3.0 و هرگونه محدودیت سازگاری به عقب را شرح می‌دهد.

تمام شدview

Moku:Lab نرم افزار نسخه 3.0 یک به روز رسانی بزرگ است که سفت افزار جدید، رابط کاربری و APls را به سخت افزار Moku:Lab می آورد. این به روز رسانی Moku:Lab را با Moku:Pro و Moku:Go هماهنگ می کند و اشتراک گذاری اسکریپت ها را در تمامی پلتفرم های Moku آسان می کند. این به روز رسانی مجموعه ای از ویژگی های جدید را برای بسیاری از ابزارهای موجود باز می کند. همچنین دو ویژگی جدید اضافه می کند: حالت چند ابزار و کامپایل ابری Moku. برخی از تفاوت های رفتاری ظریف نیز وجود دارد که در بخش سازگاری با عقب اشاره شده است.

این یک به‌روزرسانی بزرگ است که بر معماری API تأثیر می‌گذارد و بنابراین بسته جدید MATLAB API v3.0 با اسکریپت‌های MATLAB موجود سازگار نخواهد بود. اگر کاربران API Moku:Lab خود را به نسخه 3.0 ارتقا دهند، باید اسکریپت های خود را به بسته جدید Moku API منتقل کنند. کاربران API با توسعه نرم افزار سفارشی قابل توجه باید میزان تلاش لازم برای انتقال کد موجود خود را به دقت در نظر بگیرند. Moku:Lab 1.9 برای استقرارهای جدید توصیه نمی شود و همه مشتریان تشویق می شوند که آن را ارتقا دهند. در صورت بروز مشکل پس از ارتقاء، کاربران این گزینه را خواهند داشت که به نسخه 1.9 نرم افزار تنزل دهند.

این راهنمای مهاجرت به تشریح Advan می پردازدtagبه روز رسانی و عوارض احتمالی Moku:Lab نسخه 3.0. همچنین روند ارتقاء API MATLAB و نحوه تنزل رتبه Moku:Lab را در صورت لزوم شرح می دهد.

ویژگی های جدید نسخه 3.0

ویژگی های جدید

نسخه نرم‌افزار 3.0 حالت Multi-Instrument و Moku Cloud Compile را برای اولین بار به Moku:Lab می‌آورد، همچنین عملکرد و قابلیت استفاده بسیاری را در مجموعه ابزارها ارتقا می‌دهد.

حالت چند ابزار

حالت چند ابزار در Moku:Lab به کاربران اجازه می دهد تا دو ابزار را به طور همزمان برای ایجاد یک ایستگاه آزمایشی سفارشی مستقر کنند. هر ابزار به ورودی ها و خروجی های آنالوگ به همراه اتصالات بین شکاف های ابزار دسترسی کامل دارد. اتصالات بین ابزارها از ارتباطات دیجیتالی با سرعت بالا، کم تاخیر و بلادرنگ تا 2 گیگابیت بر ثانیه پشتیبانی می کند، بنابراین ابزارها می توانند به طور مستقل کار کنند یا برای ساخت خطوط لوله پردازش سیگنال پیشرفته به هم متصل شوند. ابزارها را می توان به صورت پویا در داخل و خارج بدون وقفه در ساز دیگر تعویض کرد. کاربران پیشرفته همچنین می توانند الگوریتم های سفارشی خود را در حالت چند ابزاری با استفاده از Moku Cloud Compile اجرا کنند.

Moku Cloud Compile

Moku Cloud Compile به شما امکان می دهد DSP سفارشی را مستقیماً در Moku:Lab FPGA در حالت چند ابزار مستقر کنید. با استفاده از a کد بنویسید web مرورگر و کامپایل آن در ابر؛ Moku Cloud Compile جریان بیت را در یک یا چند دستگاه هدف Moku مستقر می کند.

اسیلوسکوپ

• حالت حافظه عمیق: تا 4 میلیون ثانیه صرفه جویی کنیدampله در هر کانال در ثانیه کاملampنرخ لینگ (500 MSa/s)

تجزیه و تحلیل طیف

• کف سر و صدا بهبود یافته است
• مقیاس لگاریتمی Vrms و Vpp
• پنج عملکرد پنجره جدید (بارتلت، همینگ، ناتال، گاوسیان، قیصر)

فازمتر

• آفست فرکانس، فاز و amplitude اکنون می تواند به صورت آنالوگ vol خروجی شودtagسیگنال های e
• اکنون کاربران می توانند افست DC را به سیگنال های خروجی اضافه کنند
• خروجی موج سینوسی قفل فاز اکنون می تواند فرکانس را تا 2 50 برابر یا به 125 برابر تقسیم کند.
• محدوده پهنای باند بهبود یافته (1 هرتز تا 100 کیلوهرتز)
• بسته بندی فاز پیشرفته و عملکردهای تنظیم مجدد خودکار

ژنراتور شکل موج

• خروجی نویز
• مدولاسیون عرض پالس (PWM)

قفل کردن Ampزنده تر

• بهبود عملکرد فرکانس پایین PLL قفل کردن
• حداقل فرکانس PLL به 10 هرتز کاهش یافته است
• سیگنال داخلی PLL اکنون می تواند فرکانس را تا 250xor تقسیم به 125x برای استفاده در دمدولاسیون کند.
• دقت 6 رقمی برای مقادیر فاز

تحلیلگر پاسخ فرکانس

• حداکثر فرکانس از 120 مگاهرتز به 200 مگاهرتز افزایش یافته است
• حداکثر نقاط جابجایی را از 512 به 8192 افزایش دهید
• دینامیک جدید Ampویژگی litude سیگنال خروجی را به طور خودکار برای بهترین محدوده دینامیکی اندازه گیری بهینه می کند
• حالت جدید اندازه گیری ln/ln1
• هشدارهای اشباع ورودی
• کانال ریاضی اکنون از معادلات با ارزش مختلط دلخواه شامل سیگنال های کانال پشتیبانی می کند و انواع جدیدی از اندازه گیری تابع انتقال پیچیده را امکان پذیر می کند.
• سیگنال های ورودی را می توان علاوه بر dBm در dBVpp و dBVrms اندازه گیری کرد.
• اکنون پیشرفت جارو بر روی نمودار نمایش داده می شود
• اکنون می توان محور فرکانس را برای جلوگیری از تغییرات تصادفی در طول یک جاروی طولانی قفل کرد

جعبه قفل لیزری

• بلوک دیاگرام بهبود یافته مسیرهای سیگنال اسکن و مدولاسیون را نشان می دهد
• قفل جدید stagویژگی es اجازه می دهد تا روش قفل را سفارشی کنید
• بهبود عملکرد فرکانس پایین PLL قفل کردن
• دقت 6 رقمی برای مقادیر فاز
• بهبود عملکرد فرکانس پایین PLL قفل کردن
• حداقل فرکانس PLL به 10 هرتز کاهش یافته است
• را PLL سیگنال اکنون می تواند فرکانس را تا 250x ضرب یا به 0.125x برای استفاده در دمدولاسیون تقسیم کند.

دیگر

پشتیبانی از تابع سینوس به ویرایشگر معادله اضافه شده است که می تواند برای تولید شکل موج های سفارشی در مولد شکل موج دلخواه استفاده شود.

باینری را تبدیل کنید LI fileهنگام دانلود از دستگاه به فرمت های CSV، MATLAB یا NumPy بروید

پشتیبانی API ارتقا یافته

بسته جدید Moku MATLAB API v3.0 عملکرد و ثبات بیشتری را ارائه می دهد. به‌روزرسانی‌های منظم برای بهبود عملکرد و معرفی ویژگی‌های جدید دریافت می‌کند.

محدودیت های سازگاری با عقب

API

بسته جدید Moku MATLAB API v3.0 با بسته قبلی Moku:Lab MATLAB v1.9 سازگار نیست. آرگومان های برنامه نویسی متلب و مقادیر بازگشتی کاملاً متفاوت هستند. اگر توسعه نرم‌افزار سفارشی گسترده‌ای با استفاده از Moku:Lab MATLAB دارید، تأثیر مهاجرت همه نرم‌افزارهای خود را با API جدید سازگار در نظر بگیرید.

در حالی که بسته Moku:Lab MATLAB دیگر به‌روزرسانی دریافت نمی‌کند، Liquid Instruments همچنان به پشتیبانی از کاربرانی که قادر به مهاجرت به بسته API جدید نیستند، ادامه می‌دهد.

جزئیات قبلی را پیدا کنیدamples برای هر ابزار در بسته جدید Moku MATLAB API v3.0 به عنوان خط پایه برای تبدیل توسعه قبلی MATLAB به بسته API جدید.

رگرسیون ها

دیسک RAM برای ثبت اطلاعات

نسخه 1.9 دارای 512 مگابایت بود fileسیستم در رم دستگاه، که می تواند برای ثبت اطلاعات در ثانیه های بالا استفاده شودampنرخ لینگ در نسخه 3.0، ورود به رم دیگر در دسترس نیست. برای فعال کردن ثبت اطلاعات، یک کارت SD لازم است. بر این اساس، حداکثر سرعت اکتساب نیز تغییر می کند. نسخه 1.9 تا 1 MSa/s پشتیبانی می کند، در حالی که نسخه 3.0 تا 250 kSa/s در 1 کانال و 125 kSa/s در 2 کانال پشتیبانی می کند. حتی در سرعت‌های پایین‌تر و با کارت SD، جریان‌های کاری که شامل ذخیره چندین گزارش با سرعت بالا در RAM و سپس کپی کردن آنها در کارت SD یا مشتری می‌شود، دیگر پشتیبانی نمی‌شوند.

ثبت داده ها به CSV

نسخه 1.9 این قابلیت را داشت که داده ها را مستقیماً در یک CSV ذخیره کند file در حین ورود به سیستم این ویژگی به طور مستقیم در نسخه 3.0 در دسترس نیست. کاربرانی که گردش کارشان شامل ذخیره CSV استfileمستقیماً به یک کارت SD یا کلاینت اکنون باید ابتدا باینری را تبدیل کند file به CSV، یا با استفاده از برنامه مشتری یا با نصب ابزار مایع مستقل File تبدیل به کامپیوتری که برای پردازش داده ها استفاده می کنند.

تغییرات غیر سازگار با عقب

مقیاس بندی داده ها در LIA

در نسخه 1.9، مقیاس بندی داده ها را به گونه ای اجرا کردیم که ضرب دو سیگنال 0.1 ولت DC منجر به خروجی 0.02 ولت DC شد. در نسخه 3.0، ما این را طوری تغییر دادیم که نتیجه 0.01 ولت DC بود که بیشتر با انتظارات بصری مشتریان مطابقت دارد.

خروجی Waveform Generator برای استفاده به عنوان منبع مدولاسیون/ماشه باید فعال باشد

در نسخه 1.9، شکل موج کانال دیگری می تواند به عنوان مدولاسیون یا منبع ماشه در Waveform Generator استفاده شود، حتی اگر خروجی آن کانال غیرفعال باشد. این در نسخه حذف شد

• کاربرانی که می‌خواهند مدولاسیون متقابل را بدون نیاز به جدا کردن خروجی‌های دستگاه خود انجام دهند، باید خود را تنظیم کنند.

Moku MATLAB API

بسته Moku MATLAB API v3.0 در نظر گرفته شده است تا منابع مورد نیاز برای کنترل هر دستگاه Moku را در اختیار توسعه دهندگان MATLAB قرار دهد و در نهایت، توانایی ترکیب این کنترل ها را در برنامه های کاربردی کاربر نهایی بزرگتر فراهم کند. بسته جدید Moku MATLAB API v3.0 موارد زیر را ارائه می دهد:

• کاملاً کاربردی سابقampاسکریپت های متلب برای هر کدام
• تمام اسکریپت های متلب همراه با نظرات ارائه شده است که به راحتی قابل درک است و می تواند به عنوان نقطه شروع کاربر نهایی برای سفارشی سازی و
• مجموعه ای از توابع که کنترل کامل بر موکو را فراهم می کند

ابزارهایی که در حال حاضر پشتیبانی می شوند

1. مولد شکل موج دلخواه
2. ثبت اطلاعات
3. جعبه فیلتر دیجیتال
4. فیلتر ساز FIR
5. تحلیلگر پاسخ فرکانس
6. جعبه قفل لیزری
7. قفل کردن Ampزنده تر
8. اسیلوسکوپ
9. فازمتر
10. کنترل کننده PID
11. تجزیه و تحلیل طیف
12. ژنراتور شکل موج
13. حالت چند ابزار
14. Moku Cloud Compile

نصب و راه اندازی

الزامات

• متلب نسخه 2015 یا بالاتر

اگر قبلاً نسخه قبلی Moku MATLAB API را نصب کرده‌اید، لطفاً قبل از ادامه آن را حذف نصب کنید. می‌توانید بسته را از «مدیر افزونه» حذف نصب کنید.

1. مدیر افزونه را از طریق تب Home > Environment باز کنید.
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. با انتخاب "Set Path" از تب Home > Environment، بررسی کنید که مسیر صحیح به جعبه ابزار اضافه شده است.
5. اطمینان حاصل کنید که ورودی به محل نصب جعبه ابزار اشاره دارد. یک مسیر معمولی ممکن است CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB باشد.
6. داده های ابزار را دانلود کنید fileبا تایپ "moku_download####) در پنجره دستور MATLAB. ### باید با نسخه سیستم عامل فعلی شما جایگزین شود. Yol می‌تواند نسخه میان‌افزار فعلی‌تان را از طریق برنامه دسک‌تاپ Moku با کلیک راست روی Moku و نگه‌داشتن روی «اطلاعات دستگاه» یا در برنامه iPad با فشار طولانی روی Moku پیدا کند.
7. با تایپ کردن "help Moku" در پنجره فرمان MATLAB، تأیید کنید که جعبه ابزار شما به درستی تنظیم شده است. اگر این دستور موفق شد. سپس جعبه ابزار با موفقیت نصب شد

Moku API تغییر می کند

معماری جدید Moku MATLAB API به اندازه کافی با مدل قبلی خود متفاوت است و بنابراین با اسکریپت های API موجود سازگار نیست. اسیلوسکوپ ساده زیرample تفاوت‌های بین بسته‌های API قدیمی و جدید را نشان می‌دهد و به عنوان یک نقشه راه برای انتقال کدهای موجود عمل می‌کند.

اسیلوسکوپ سابقample

ترتیب مراحل

1. Moku MATLAB API 3.0 را وارد کنید
2. مالکیت Moku را ادعا کنید و جریان بیت اسیلوسکوپ را در آن آپلود کنید
3. پایه زمانی را تنظیم کنید و بازه سمت چپ و راست را برای محور زمانی تنظیم کنید.
4. داده ها را دریافت کنید، یک فریم از داده ها را از اسیلوسکوپ به دست آورید
5. با انصراف از مالکیت Moku، جلسه مشتری را پایان دهید

توالی شرح داده شده در بالا یک مثال ساده شده استampبرای نشان دادن تفاوت‌های بین بسته‌های API قدیمی و جدید. به غیر از شروع یک جلسه مشتری، آپلود یک بیت استریم ابزار در Moku و پایان دادن به جلسه مشتری، کاربر نهایی می تواند هر تعداد عملکرد را به ترتیب مختلف انجام دهد تا نیازهای برنامه خود را برآورده کند.

تفاوت ها

در اینجا، ما به تفاوت بین دو APls برای هر مرحله در دنباله نگاه می کنیم.

مالکیت Moku را ادعا کنید و جریان بیت اسیلوسکوپ را در دستگاه آپلود کنید. در مقایسه با Moku MATLAB 1.9، API جدید عملکردهای کاملاً متفاوتی دارد:

	Moku MATLAB 1.9		Moku MATLAB 3.0
تابع	get_by_name()	deploy_or_conn ect()	اسیلوسکوپ ()
فیلدها و مقادیر مجاز	نام: زمان پایان رشته: شناور	ابزار: کلاس ابزاری که مایل به استقرار است	ip: string serial: string
	زور: بوول	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: شناور
			read_timeout: شناور

 

1. پایه زمانی را تنظیم کنید تابع یکسان است، اما آرگومان های مجاز کمی متفاوت هستند:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   تابع	set_timebase()	set_timebase()
   فیلدها و مقادیر مجاز	t1: float t2: float	t1: float t2: float strict: bool

2. داده ها را دریافت کنید. توابع و آرگومان های مجاز یکسان هستند، اما نوع و طول داده های برگشتی متفاوت است:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   تابع	get_data()	get_data()
   فیلدها و مقادیر مجاز	تایم اوت: float صبر کنید: bool	timeout: float wait_reacquire: bool
   طول بازگشت	16383 امتیاز در هر فریم	1024 امتیاز در هر فریم

3. مالکیت Moku را آزاد کنید:
   

   	Moku MATLAB 1.9	Moku API نسخه 3.0
   تابع	بستن ()	relinquish_ownership()

لیست توابع اسیلوسکوپ

Moku MATLAB 1.9	Moku MATLAB 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
get_samp!erateO get_rea!time_dataQ	get_samp!erateO save_high_res_bufferO
gen_rampwaveO gen_sinewaveO	generate_waveformO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!oadQ
set_samplerateQ set_framerateQ	get_interpo!ationO set_output_!oadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	خلاصه Q

Moku MATLAB API مبتنی بر Moku API است. برای مستندات کامل Moku API، به مرجع Moku API موجود در اینجا مراجعه کنید https://apis.liq uidinstrume nts.com/re fe rence/.

جزئیات بیشتر برای شروع به کار با Moku MATLAB API را می‌توانید در اینجا پیدا کنید https://a pis.liquid instruments.com/sta رتبه بندی-متلب.خانه

فرآیند تنزل رتبه

اگر ثابت شده است که ارتقاء به نسخه 3.0 چیزی را که برای برنامه شما حیاتی است محدود می کند یا تأثیر نامطلوبی دارد، می توانید به نسخه قبلی 1.9 تنزل دهید. این را می توان از طریق a انجام داد web مرورگر.

مراحل

1. با Liquid Instruments تماس بگیرید و آن را دریافت کنید file برای سیستم عامل نسخه 9.
2. آدرس IP Moku:Lab خود را در یک تایپ کنید web مرورگر (نگاه کنید به تصویر).
3. در قسمت Update Firmware، سیستم عامل را مرور کرده و انتخاب کنید file ارائه شده توسط Liquid Instruments.
4. Upload & Update را انتخاب کنید. فرآیند به‌روزرسانی ممکن است بیش از 10 دقیقه طول بکشد

© 2023 Liquid Instruments. رزرو شده است.

laudinstruments.com

اسناد / منابع

فیوزهای یکپارچه سازی API MATLAB LIQUID INSTRUMENTS [pdfراهنمای کاربر MATLAB API, MATLAB API Fuses, Integration Fuses, Fuses

مراجع

• راهنمای کاربر