INSTRUMENTS נוזלי MATLAB API אינטגרציה נתיכים

מדריך הגירה של 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 Cloud Compile. ישנם גם כמה הבדלים התנהגותיים עדינים, המתוארים בסעיף תאימות לאחור.

זהו עדכון גדול המשפיע על ארכיטקטורת ה-API, ולכן החבילה החדשה של MATLAB API v3.0 לא תהיה תואמת לאחור עם סקריפטים קיימים של MATLAB. משתמשי API יצטרכו להעביר את הסקריפטים שלהם לחבילה החדשה של Moku API אם הם ישדרגו את Moku:Lab שלהם לגרסה 3.0. משתמשי API עם פיתוח תוכנה מותאם אישית משמעותי צריכים לשקול היטב את רמת המאמץ הנדרשת להעברת הקוד הקיים שלהם. Moku:Lab 1.9 אינו מומלץ לפריסות חדשות וכל הלקוחות מוזמנים לשדרג. אם מתעוררות בעיות לאחר השדרוג, למשתמשים תהיה אפשרות לשדרג לאחור לגרסת תוכנה 1.9.

מדריך הגירה זה מתאר את היתרונותtagנקודות של עדכון וסיבוכים פוטנציאליים לגרסה 3.0 של Moku:Lab. זה גם מתאר את התהליך לשדרוג ה-API של MATLAB וכיצד לשדרג לאחור את Moku:Lab שלך במידת הצורך.

גרסה 3.0 תכונות חדשות

תכונות חדשות

גרסת תוכנה 3.0 מביאה לראשונה את מצב Multi-Instrument ו-Moku Cloud Compile ל-Moku:Lab, כמו גם שדרוגי ביצועים ושימושיות רבים בכל חבילת המכשירים.

מצב רב כלים

מצב ריבוי מכשירים ב-Moku:Lab מאפשר למשתמשים לפרוס שני מכשירים בו זמנית כדי ליצור תחנת בדיקה מותאמת אישית. לכל מכשיר יש גישה מלאה לכניסות וליציאות האנלוגיות יחד עם חיבורים בין חריצי המכשיר. החיבורים בין מכשירים תומכים בתקשורת דיגיטלית בזמן אמת במהירות גבוהה, בהשהייה נמוכה עד 2 Gb/s, כך שהמכשירים יכולים לפעול באופן עצמאי או להיות מחוברים לבניית צינורות מתקדמים לעיבוד אותות. ניתן להחליף כלים באופן דינמי פנימה והחוצה מבלי להפריע למכשיר השני. משתמשים מתקדמים יכולים גם לפרוס אלגוריתמים מותאמים אישית משלהם במצב ריבוי מכשירים באמצעות Moku Cloud Compile.

Moku Cloud Compile

Moku Cloud Compile מאפשר לך לפרוס DSP מותאם אישית ישירות על Moku:Lab FPGA במצב ריבוי מכשירים. כתוב קוד באמצעות א web דפדפן והידור שלו בענן; Moku Cloud Compile פורס את זרם הסיביות למכשיר יעד אחד או יותר של Moku.

אוֹסְצִילוֹסקוּפּ

• מצב זיכרון עמוק: שמור עד 4M samples לערוץ ב-s מלאampקצב לינג (500 MSa/s)

מנתח ספקטרום

• רצפת רעש משופרת
• סולם Vrms ו-Vpp לוגריתמי
• חמש פונקציות של חלון חדש (ברטלט, המינג, נוטל, גאוס, קייזר)

מד שלבים

• היסט תדר, פאזה ו ampניתן כעת לצאת לליטוד ככרך אנלוגיtage אותות
• משתמשים יכולים כעת להוסיף היסט DC לאותות הפלט
• כעת ניתן להכפיל את פלט גלי הסינוס נעול הפאזה בתדר עד 2 50x או לחלק למטה ל 125x
• טווח רוחב פס משופר (1 הרץ עד 100 קילו-הרץ)
• פונקציות מתקדמות של גלישת שלב ואיפוס אוטומטי

מחולל צורות גל

• תפוקת רעש
• אפנון רוחב הדופק (PWM)

לנעול ב Ampחיים יותר

• ביצועים משופרים של תדר נמוך PLL נְעִילָה
• תדר ה-PLL המינימלי ירד ל-10 הרץ
• כעת ניתן להכפיל את אות ה-PLL הפנימי בתדר עד 250x או לחלק עד 125x לשימוש בדמודולציה
• דיוק של 6 ספרות לערכי פאזה

מנתח תגובת תדרים

• הגדלת התדר המקסימלי מ-120 מגה-הרץ ל-200 מגה-הרץ
• הגדל את נקודות הסריקה המקסימליות מ-512 ל-8192
• הדינמיקה החדשה Ampתכונת litude מייעלת את אות הפלט באופן אוטומטי לטווח הדינמי המדידה הטוב ביותר
• מצב מדידת ln/ln1 חדש
• אזהרות רוויה קלט
• הערוץ המתמטי תומך כעת במשוואות שרירותיות בעלות ערכים מורכבים המערבות את אותות הערוץ, מה שמאפשר סוגים חדשים של מדידות פונקציות העברה מורכבות
• כעת ניתן למדוד אותות כניסה ב-dBVpp וב-dBVrms בנוסף ל-dBm
• התקדמות הסוויפ מוצגת כעת בגרף
• כעת ניתן לנעול את ציר התדר כדי למנוע שינויים מקריים במהלך סוויפ ארוך

תיבת נעילת לייזר

• דיאגרמת הבלוק המשופרת מציגה נתיבי אותות סריקה ואפנון
• s הנעילה החדשהtagתכונת es מאפשרת התאמה אישית של הליך הנעילה
• ביצועים משופרים של תדר נמוך PLL נְעִילָה
• דיוק של 6 ספרות לערכי פאזה
• ביצועים משופרים של תדר נמוך PLL נְעִילָה
• תדר ה-PLL המינימלי ירד ל-10 הרץ
• ה PLL כעת ניתן להכפיל את האות בתדר עד פי 250 או לחלק אותו ל-0.125x לשימוש בדמודולציה

אַחֵר

נוספה תמיכה בפונקציית הסינוס לעורך המשוואות שניתן להשתמש בה כדי ליצור צורות גל מותאמות אישית במחולל צורות הגל השרירותי

המר בינארי LI files לפורמטים CSV, MATLAB או NumPy בעת הורדה מהמכשיר

תמיכת API משודרגת

החבילה החדשה של Moku MATLAB API v3.0 מספקת פונקציונליות ויציבות משופרים. הוא יקבל עדכונים שוטפים כדי לשפר את הביצועים ולהציג תכונות חדשות.

מגבלות תאימות לאחור

ממשק API

החבילה החדשה של Moku MATLAB API v3.0 אינה תואמת לאחור לחבילת Moku:Lab MATLAB v1.9 הקודמת. ארגומנטי הסקריפט של MATLAB וערכי ההחזרה שונים לחלוטין. אם יש לך פיתוח תוכנה מותאם אישית נרחב תוך שימוש ב-Moku:Lab MATLAB, שקול את ההשפעה של העברת כל התוכנה שלך כתואמת ל-API החדש.

בעוד חבילת Moku:Lab MATLAB לא תקבל עוד עדכונים, Liquid Instruments עדיין תמשיך לספק תמיכה למשתמשים שאינם מסוגלים לעבור לחבילת ה-API החדשה.

מצא אקס מפורטamples עבור כל מכשיר בחבילת Moku MATLAB API v3.0 החדשה כדי לשמש קו בסיס להמרת פיתוח קודם של MATLAB לחבילת API החדשה.

רגרסיות

דיסק RAM לרישום נתונים

לגרסה 1.9 היה 512 מגה-בייט fileמערכת בזיכרון ה-RAM של המכשיר, שיכולה לשמש לרישום נתונים ב-s גבוהampשיעורי ling. בגרסה 3.0, כניסה ל-RAM אינה זמינה עוד. כדי לאפשר רישום נתונים, יש צורך בכרטיס SD. בהתאם לכך, מהירות הרכישה המקסימלית משתנה גם כן. גרסה 1.9 נתמכת בעד 1 MSa/s, בעוד שגרסה 3.0 תומכת בעד 250 kSa/s בערוץ אחד ו-1 kSa/s בשני ערוצים. אפילו במהירויות נמוכות יותר ועם כרטיס SD, זרימות עבודה שכללו שמירת יומנים מרובים במהירות גבוהה ב-RAM ולאחר מכן העתקתם מאוחר יותר לכרטיס ה-SD או ללקוח לא ייתמכו עוד.

רישום נתונים ל-CSV

לגרסה 1.9 הייתה יכולת לשמור נתונים ישירות ל-CSV file תוך כדי רישום. תכונה זו אינה זמינה ישירות בגרסה 3.0. משתמשים שזרימת העבודה שלהם כללה שמירת CSVfiles ישירות לכרטיס SD או שהלקוח יצטרך כעת להמיר תחילה את הבינארי file ל-CSV, באמצעות אפליקציית הלקוח או על ידי התקנת ה-Liquid Instruments העצמאיים File ממיר למחשב שבו הם משתמשים לעיבוד נתונים.

שינויים שאינם תואמים לאחור

קנה מידה של נתונים ב-LIA

בגרסה 1.9, יישמנו קנה מידה של נתונים כך שהכפלת שני אותות 0.1 V DC הובילה לפלט של 0.02 V DC. בגרסה 3.0, שינינו זאת כך שהתוצאה הייתה 0.01 V DC, וזה יותר בקנה אחד עם הציפיות האינטואיטיביות של הלקוחות.

יש להפעיל את פלט מחולל הגל כדי להשתמש בו כמקור/טריגר אפנון

בגרסה 1.9, ניתן להשתמש בצורת גל של ערוץ אחר כמקור אפנון או טריגר ב-Waveform Generator, גם אם הפלט של ערוץ זה היה מושבת. זה הוסר בגרסה

• משתמשים שרוצים לעשות מודולציה צולבת בלי צורך לנתק את היציאות של המכשיר שלהם יצטרכו להתאים את

ממשק API של Moku MATLAB

חבילת Moku MATLAB API v3.0 נועדה לספק למפתחי MATLAB את המשאבים הדרושים לשליטה בכל מכשיר Moku, ובסופו של דבר, את היכולת לשלב את הפקדים הללו ביישומי משתמש קצה גדולים יותר. החבילה החדשה של Moku MATLAB API v3.0 מספקת את הדברים הבאים:

• אקס פונקציונלי לחלוטיןample MATLAB סקריפטים לכל אחד מהם
• כל הסקריפטים של MATLAB מסופקים עם הערות שקל להבין ויכולות לשמש כנקודת מוצא של משתמש קצה להתאמה אישית ו
• סט פונקציות המספקות שליטה מלאה על ה-Moku

מכשירים נתמכים כרגע

1. מחולל צורות גל שרירותי
2. לוגר נתונים
3. תיבת פילטר דיגיטלית
4. בונה מסנני FIR
5. מנתח תגובת תדרים
6. תיבת נעילת לייזר
7. נעילה Ampחיים יותר
8. אוֹסְצִילוֹסקוּפּ
9. מד שלבים
10. בקר PID
11. מנתח ספקטרום
12. מחולל צורות גל
13. מצב רב כלים
14. Moku Cloud Compile

הַתקָנָה

דרישות

• 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. לחלופין, אתה יכול להוריד את ארגז הכלים ישירות מהמכשירים הנוזליים webאתר ב https://www.liquidinstruments.com/products/apis/matlab-api/. תצטרך להגדיר את נתיב החיפוש באופן ידני אם תעשה זאת.
4. בדוק שהנתיב הנכון נוסף לארגז הכלים על ידי בחירה ב'הגדר נתיב' מהכרטיסייה בית > סביבה.
5. ודא שיש ערך המצביע על מיקום התקנת ארגז הכלים. נתיב טיפוסי עשוי להיות CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. הורד את נתוני המכשיר files על ידי הקלדת 'moku_download####) בחלון הפקודה של MATLAB. יש להחליף את ### בגרסת הקושחה הנוכחית שלך. Yol יכול למצוא את גרסת הקושחה הנוכחית שלך דרך אפליקציית Moku: שולחן העבודה על ידי לחיצה ימנית על Moku שלך וריחוף 'פרטי מכשיר', או באפליקציית iPad על ידי לחיצה ארוכה על Moku שלך.
7. אשר את ארגז הכלים שלך מוגדר כהלכה על ידי הקלדת 'help Moku' בחלון הפקודה של MATLAB. אם הפקודה הזו תצליח. אז ארגז הכלים הותקן בהצלחה

שינויים ב-Moku API

ארכיטקטורת ה-API החדשה של Moku MATLAB שונה במידה מספקת מקודמתה ולכן אינה תואמת לאחור עם סקריפטים קיימים של API. האוסילוסקופ המפושט הבא למשלample מראה את ההבדלים בין חבילות ה-API הישנות והחדשות ומשמשת כמפת דרכים להעברת קוד קיים.

אוסילוסקופ לשעברample

שלבי רצף

1. ייבא את Moku MATLAB API 3.0
2. תבע את הבעלות על Moku והעלה את זרם הסיביות של Oscilloscope אל
3. הגדר את בסיס הזמן והגדר את טווח יד שמאל וימין עבור ציר הזמן.
4. קבל נתונים, רכוש מסגרת בודדת של הנתונים מהאוסילוסקופ
5. סיים את הפגישה עם הלקוח על ידי ויתור על הבעלות על Moku

הרצף שתואר לעיל הוא דוגמה פשוטהample כדי להמחיש את ההבדלים בין חבילות ה-API החדשות והחדשות. מלבד תחילת הפעלת לקוח, העלאת זרם סיביות של מכשירים ל-Moku, וסיום הפעלת לקוח, משתמש קצה יכול להפעיל כל מספר של פונקציות בסדר שונה כדי לענות על צורכי היישום שלו.

הבדלים

כאן אנו מסתכלים על ההבדלים בין שני ה-APls עבור כל שלב ברצף.

תבע בעלות על Moku והעלה את זרם הסיביות של Oscilloscope למכשיר. בהשוואה ל-Moku MATLAB 1.9, ל-API החדש יש פונקציות שונות לחלוטין:

	Moku MATLAB 1.9		Moku MATLAB 3.0
פוּנקצִיָה	get_by_name()	deploy_or_conn ect()	אוֹסְצִילוֹסקוּפּ()
שדות וערכים מותרים	שם: פסק זמן למחרוזת: לצוף	מכשיר: המעמד של המכשיר שרוצה לפרוס	ip: מחרוזת סידורית: מחרוזת
	כוח: bool	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()
   שדות וערכים מותרים	פסק זמן: צף המתן: bool	פסק זמן: לצוף wait_reacquire: bool
   אורך החזרה	16383 נקודות לכל פריים	1024 נקודות לכל פריים

3. שחרר את הבעלות על Moku:
   

   	Moku MATLAB 1.9	Moku API v3.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	gener_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

ה-API של Moku MATLAB מבוסס על Moku API. לתיעוד מלא של Moku API, עיין ב-Moku API Reference שנמצא כאן 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. צור קשר עם Liquid Instruments והשיג את file עבור גירסת קושחה 9.
2. הקלד את כתובת ה-IP של Moku:Lab שלך ב-a web דפדפן (ראה צילום מסך).
3. תחת עדכן קושחה, דפדף ובחר את הקושחה file מסופק על ידי Liquid Instruments.
4. בחר העלה ועדכון. תהליך העדכון עשוי להימשך יותר מ-10 דקות

© 2023 Liquid Instruments. שָׁמוּר.

laudinstruments.com

מסמכים / משאבים

INSTRUMENTS נוזלי MATLAB API אינטגרציה נתיכים [pdfמדריך למשתמש MATLAB API, MATLAB API אינטגרציה נתיכים, אינטגרציה נתיכים, נתיכים

הפניות

• מדריך למשתמש