ממשקים
ממשקים
הגדרת ממשקים כ-Conduits, רישום מה שזורם דרכם, בדיקת קיבולת, מעקב אחר בשלות הממשקים במרשם הממשקים והפקת ICDs ומטריצות N² ו-I².
בדף זה
סקירה כללית
משתמשים בדפי הממשקים כדי להגדיר מה חוצה כל גבול במערכת, לבדוק שכל נתיב יכול להעביר את זה, ולמסור את התוצאה לצוותים אחרים כ-ICD.
ב-Holarch ממשק הוא Conduit. Conduit הוא ישות מודל ש:
- connects to שני נכסים (או פורטים)
- transfers את פריטי ה-Input/Output שחוצים אותו
כל Conduit בפרויקט הוא ממשק, בכל מקום שבו צוייר: בדיאגרמת בלוקים פנימית, בדיאגרמת I/O פיזית, בדיאגרמת בקרת ממשקים, בדיאגרמת I² או במסד הנתונים.
הקבוצה ממשקים בסרגל הניווט מכילה ארבעה דפים:
| דף | מה היא מציגה |
|---|---|
| מרשם הממשקים | כל Conduit עם נקודות קצה, סטטוס, בעלים, TBD/TBR, מספר פריטים, מספר דרישות ובדיקת קיבולת. |
| ICDs | דיאגרמות בקרת הממשקים בפרויקט (רשימת הדיאגרמות מסוננת לסוג הזה). |
| דיאגרמות N² | דיאגרמות ה-N² בפרויקט: פונקציות על האלכסון, ה-Input/Outputs שהן מחליפות בתאים. |
| פריטים ו-I/O | מסד הנתונים מסונן למחלקה Input/Output. |
מושגים
Conduit
Conduit הוא הנתיב הפיזי או הלוגי בין שני נכסים: כבל, אפיק, קישור RF, צינור, חיבור רשת. הוא מקושר לנקודות הקצה שלו עם connects to (מנקודת המבט של הנכס: connected by).
אפשר לפרק Conduit ל-Conduits צאצאים. אז ההורה פועל כצרור: הוא מעביר את כל מה שהצאצאים שלו מעבירים.
Holarch מוסיף את מאפייני הממשק האלה לכל Conduit:
| מאפיין | משמעות |
|---|---|
| Capacity ו-Units | המקסימום שהערוץ יכול להעביר, לדוגמה 400 Mbps או 15 W. משמש את בדיקת הקיבולת. |
| Latency | ההשהיה לאורך הערוץ (משך). |
| Connector/Pins | סוג המחבר והקצאת הפינים בכל קצה. |
| Medium | אמצעי ההעברה הפיזי, לדוגמה נחושת, סיב, קישור RF, צינור. |
| בעלים | האדם או הצוות שאחראים להגדרת הממשק. |
| Interface Status | בשלות ההגדרה: Draft, Proposed, Agreed או Baselined. |
| TBD/TBR | פריטים פתוחים: None, TBD (to be determined, טעון קביעה) או TBR (to be reviewed, טעון בדיקה). |
Input/Output (פריט)
Input/Output (פריט) הוא מה שחוצה את הממשק: נתונים, הספק, נוזל, כוח, אות. יש לו שלושה סוגי קישורים:
- generated by ה-Action שמפיק אותו
- received by ה-Action שצורך אותו
- transferred by ה-Conduits שמעבירים אותו
Holarch מוסיף את המאפיינים האלה:
| מאפיין | משמעות |
|---|---|
| Size ו-Units | הכמות לכל פריט, לדוגמה 2.5 GB. נספר בבדיקת הקיבולת כשלא הוגדר Data Rate. |
| Data Rate ו-Data Rate Units | הקצב שבו הפריט מועבר, לדוגמה 480 Mbps או 6 W. בדיקת הקיבולת מסכמת אותו. |
| Protocol/Format | פרוטוקול, קידוד או פורמט פיזי. |
| Message/Data Definition | השדות, הטווחים והמשמעות של הנתונים שהפריט נושא. |
דרישות ממשק
דרישה על ממשק מקושרת ל-Conduit עם traced from (ה-Conduit הוא traced from הדרישה). גם דרישות שה-Conduit satisfies מופיעות ברשימה. דרישה שנוצרת מבורר הדרישות של הממשק מקבלת את התווית דרישת ממשק.
פורטים ובלוקי ממשק
בדיאגרמות בלוקים נקודת קצה יכולה להיות פורט של בלוק במקום הבלוק עצמו. פורט יכול לקבל סוג של Input/Output או של Interface Block. Interface Block הוא Asset עם התווית Interface Block; הוא מתאר את הפריטים והזרימות שנקודת אינטראקציה תומכת בהם.
פורט Conjugated משתמש בסוג שלו כשכל כיווני הזרימה הפוכים. הוא מוצג כ-~Type.
בדיקת קיבולת
בדיקת הקיבולת מראה אם Conduit יכול להעביר את הפריטים שלו. לכל Conduit, Holarch:
- לוקח את העומס של כל פריט מועבר: ה-Data Rate שלו, או ה-Size שלו כשלא הוגדר קצב.
- ממיר כל עומס ל-Units של ה-Conduit ומסכם אותם.
- משווה את הסכום ל-Capacity.
פריטים של ערוצי הצאצא של צרור נספרים לצרור. התוצאה היא אחת מאלה:
| תוצאה | הטקסט במרשם | משמעות |
|---|---|---|
| Within capacity | OK | העומס הכולל נכנס. |
| Over capacity | Over capacity | העומס הכולל חורג מה-Capacity. |
| Unit mismatch | Unit mismatch | היחידות של פריט אחד לפחות לא ניתנות להמרה ליחידות של ה-Conduit; הפריט הזה לא נכלל בסכום. |
| No capacity | No capacity | ל-Conduit יש פריטים אבל אין Capacity, ולכן העומס לא נבדק. |
| Empty | — | ה-Conduit לא מעביר פריטים. |
היחידות מומרות באותה מערכת יחידות כמו בתקציבים (ראו יחידות וכמויות), כך ש-kbps, Mbps, Gbps, B/s, kW ו-W מתערבבים בחופשיות בתוך אותו סוג.
כיוון זרימת הפריט
במחבר של IBD כל פריט מציג חץ. Holarch לוקח את הכיוון מהראשון מבין אלה שמכריע אותו:
- ה-Actions שמבוצעים בכל צד. הצד שה-Action שלו מייצר את הפריט שולח אותו.
- מאפייני ה-Direction של הפורטים (In, Out, In and Out).
- ההגדרה זרימת פריטים של המחבר עצמו.
איך להשתמש בה
מתי ולמה
מגדירים ממשקים אחרי פירוק הארכיטקטורה, לצד ההקצאה הפונקציונלית. ברגע שהפונקציות מוקצות לתת-מערכות, כל החלפה שחוצה גבול של תת-מערכת צריכה נתיב פיזי.
ניהול ממשקים עונה על ארבע שאלות:
- מה חוצה כל גבול? הפריטים המועברים, עם הקצבים, הפורמטים והגדרות הנתונים שלהם.
- האם הנתיב יכול להעביר את זה? בדיקת הקיבולת.
- של מי זה, והאם זה סגור? Owner, Interface Status ו-TBD/TBR.
- אילו דרישות חלות על זה, ומה מוסרים לצוות השני? דרישות הממשק ומסמך ה-ICD.
קצב עבודה טיפוסי:
- ניסוח טיוטת ממשקים בסקירת דרישות המערכת.
- הסכמה עליהם בין הצוותים האחראים לפני סקירת התכן המקדמי.
- קיבוע קו בסיס שלהם לפני סקירת התכן הקריטי.
הגדרת ממשק בדיאגרמת בלוקים פנימית
מציירים את המחבר, מציינים מה הוא מעביר, ואז מתעדים את הסטטוס, הדרישות והקיבולת שלו.
- יש לפתוח את ארכיטקטורה ← דיאגרמות בלוקים.
- יש לפתוח את דיאגרמת בלוקים פנימית של המערכת. כדי ליצור אחת, לוחצים על + דיאגרמה חדשה, בוחרים דיאגרמת בלוקים פנימית ובוחרים את הבלוק בדיאגרמה של.
- יש לגרור את ידית הקצה של חלק אחד אל חלק או פורט אחר.
- יש לשחרר על היעד. המחבר נוצר מיד. כשגוררים מפורט אל בלוק, יש לבחור חיבור לבלוק או הוספת פורט מצומד בבורר החיבור.
מוצג מחבר. המחבר הוא Conduit.
- יש לבחור את המחבר.
- בחלונית המאפיינים, תחת פריטים מועברים (Item Flows), יש להוסיף פריט:
- כדי להעביר פריט שה-Actions של שני הקצוות כבר מחליפים, לוחצים על כפתור ההצעה שלו תחת מועבר בין הקצוות:, כמו + Image Strip.
- אחרת לוחצים על + הוספת פריט ▾ ובוחרים Existing Input/Output… או Input/Output חדש….
שם הפריט מופיע בירוק על המחבר, עם חץ הכיוון שלו.
- באותה חלונית, יש להגדיר Interface Status, בעלים ו-TBD/TBR.
- תחת דרישות ממשק, יש ללחוץ על + קישור דרישה… ולבחור או ליצור את הדרישה.
- במאפייני הישות, יש להגדיר את ה-Capacity וה-Units של ה-Conduit.
- בכל פריט, יש להגדיר Data Rate ו-Data Rate Units, או Size ו-Units.
התיבה בדיקת קיבולת מתעדכנת מיד. התווית של המחבר מציגה את הסטטוס בסוגריים מרובעים, לדוגמה Payload Interface [Agreed]. התווית הופכת ל:
- אדומה עם ⚠ over capacity כשהעומס גבוה מדי
- כתומה עם ⚠ unit mismatch כשהיחידות לא ניתנות להמרה
סקירת כל הממשקים במרשם
- יש לפתוח את ממשקים ← מרשם הממשקים.
מוצגים כרטיסי סטטוס (Draft, Proposed, Agreed, Baselined, לא הוגדר) וטבלה של כל ה-Conduits.
- אופציונלי: לחיצה על כרטיס מציגה רק את הממשקים האלה. לחיצה נוספת עליו, או לחיצה על השבב Status: … ×, מציגה את כולם.
- אופציונלי: הקלדה בסינון לפי שם או נקודת קצה מצמצמת את הרשימה.
- יש לסרוק את העמודה Capacity ולחפש Over capacity ו-Unit mismatch, ששניהם מוצגים באדום.
- לחיצה על שורה פותחת את ה-Conduit בחלונית המאפיינים, ושם עורכים את המאפיינים שלו.
- כדי לשתף את המרשם, לוחצים על ייצוא CSV. למסמך Word של ממשק אחד, לוחצים על ICD בשורה שלו.
הפקת מסמך בקרת ממשקים
דיאגרמת בקרת ממשקים מתארת את כל הממשק בין שני נכסי הורה. השורש שלה הוא Conduit של הממשק הזה.
- יש לפתוח את ממשקים ← ICDs.
- יש ללחוץ על + דיאגרמה חדשה, או לפתוח דיאגרמת בקרת ממשקים קיימת.
- יש ללחוץ על אין Asset בצד שמאל. בחירת Asset… ולבחור את נכס ההורה הראשון.
- יש ללחוץ על אין Asset בצד ימין. בחירת Asset… ולבחור את השני.
כל רצועה מציגה עכשיו את נכסי הצאצא של הנכס הזה.
- עבור כל קישור פיזי, יש לגרור Conduit מלוח הרכיבים אל תיבת המרכז.
ערוץ צאצא מופיע כפס בתיבת המרכז.
- עבור כל פריט שערוץ צאצא מעביר, יש לגרור Input/Output אל הערוץ הזה.
- אופציונלי: כדי להוסיף נכס צאצא, גוררים Asset לתוך רצועת הורה.
- יש לגרור מערוץ צאצא אל נכס צאצא (או להפך). הקישור connects to נוצר מיד. חוזרים על כך עבור הקצה השני.
- יש לבחור ערוץ צאצא ולמלא את חלונית הממשק שלו בחלונית המאפיינים, כמו ב-IBD.
- יש ללחוץ על ייצוא מסמך ICD לקבלת ICD בפורמט Word, או על ייצוא ICD (CSV) לקבלת ה-CSV.
בדיקת ממשקים מהצד הפונקציונלי
מתחילים מהפונקציות כדי למצוא החלפות שעדיין אין להן נתיב פיזי.
- יש לפתוח את ממשקים ← דיאגרמות N² ולפתוח את דיאגרמת N² של ה-Action ההורה.
ה-Actions הצאצאים נמצאים על האלכסון. התא בשורה A, עמודה B מפרט את הפריטים ש-A מייצר ו-B מקבל.
- כדי להוסיף החלפה, גוררים Input/Output מלוח הרכיבים אל תא מחוץ לאלכסון. אפשר גם לגרור תיבה מהאלכסון אל תא בשורה או בעמודה שלה: Input/Output חדש נוצר שם מיד.
הפריט החדש מקבל שם לפי התא שלו: <row action> To <column action>.
- יש לפתוח את דיאגרמת I/O פיזית של ה-Asset ההורה.
- יש ללחוץ על התג בדיקות הדיאגרמה (⚠ ומספר הממצאים).
חלונית המאפיינים מפרטת, תחת ממשקים, כל פריט שזורם בין שני נכסים אבל אין לו Conduit שיעביר אותו.
- יש לתקן כל ממצא. לוחצים על הצגה כדי לבחור את הקו שלו, ואז מגדירים את החלק החסר בחלונית המאפיינים של הקו (הוספה ליד אף Conduit לא מעביר את ה-Input/Output הזה.), או מוסיפים את הפריט ל-Conduit ב-IBD או ב-ICD.
דוגמה מעשית: ממשק המטען של CubeSat EO-1
יוצרים את ההדגמה עם ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש, ואז:
- יש לפתוח את ממשקים ← מרשם הממשקים.
בכרטיסים כתוב 2 Draft, 2 Proposed, 16 Agreed, 6 Baselined ו-0 לא הוגדר.
- יש למצוא את IF-05 Payload Interface (C&DH ↔ Payload Camera).
העמודה Capacity שלו מציגה Over capacity.
- יש להצביע על Over capacity.
מוצג Over capacity: 480.02 of 400 Mbps (120%).
- יש ללחוץ על השורה.
חלונית המאפיינים מציגה את ה-Conduit:
- Capacity
400Mbps - Owner Payload Lead
- Medium LVDS twisted pairs plus SPI
- Connector/Pins J5 (Micro-D 25)
- פריטים מועברים Command Schedule (0.02 Mbps) ו-Image Strip (480 Mbps)
קצב הרצועה הגולמי של המטען חורג מקישור ה-LVDS. אפשר לתקן זאת באחת משלוש דרכים:
- להעלות את ה-Capacity של ה-Conduit לדירוג האמיתי של הקישור, לדוגמה
600. אז במרשם כתוב OK. - להוסיף דחיסה על הלוויין, ואז להוריד את ה-Data Rate של Image Strip.
- לתעד את ההחלטה הפתוחה: להגדיר TBD/TBR ל-TBR, ולקשר דרישה חדשה עם + קישור דרישה… ב-IBD או ב-ICD.
- יש למצוא את IF-12 S-band Downlink ולהצביע על העמודה Capacity שלו.
מוצג Within capacity: 9.6 of 10 Mbps (96%). הוא עובר אבל עם מרווח קטן, ולכן הוא מועמד ל-TPM. ההדגמה עוקבת אחריו כ-TPM-3 Payload Downlink Rate (ראו תקציבים ו-TPMs).
- יש לפתוח את ממשקים ← ICDs ← IF-10 Space-to-Ground Link.
ההורים משמאל ומימין הם החללית ומקטע הקרקע. ערוצי הצאצא הם IF-11 UHF Command Uplink (9.6 kbps, Baselined) ו-IF-12 S-band Downlink (10 Mbps, Baselined).
- יש ללחוץ על ייצוא מסמך ICD.
קובץ ה-Word מכיל:
- את מרשם הממשקים של שלושת הערוצים
- סיכום סטטוסים
- סעיף אחד לכל ערוץ, עם נקודות הקצה, המאפיינים, הפריטים המועברים (עם כיוון), הדרישות המקושרות (5.1, 5.2 ו-5.3) ובדיקת הקיבולת
- יש לפתוח את דיאגרמת בלוקים פנימית של ה-EPS.
לפורט 12 V Bus יש הסוג של בלוק הממשק IFB-1 12 V Power Interface. הפורט 12 V In של המטען משתמש באותו סוג, מצומד, ולכן כתוב בו 12 V In : ~12 V Power Interface.
עצות ושיטות עבודה טובות
- נותנים ל-Conduits שמות עצם (Payload Interface, S-band Downlink) ולכל אחד מספר (
IF-05). בדיקות המודל מסמנות ערוצים בלי שם, בלי מספר או ששמם אינו שם עצם. - שמים את הקצב על הפריט, לא על הערוץ. הערוץ מחזיק את הקיבולת; הפריטים מחזיקים את העומס. כך פריט אחד שמועבר בכמה ערוצים נבדק בכל אחד מהם.
- משתמשים בערוץ צרור לרתמה או לקבוצת קישורים, ובערוצי צאצא לכל קו. דיאגרמת ה-ICD בנויה סביב המבנה הזה.
- מגדירים Interface Status בכל ערוץ. הכרטיס לא הוגדר צריך להיות אפס לפני סקירת תכן.
- מפנים לתקן הממשק: Artifact עם התווית Standard שהערוץ ושני הנכסים reference. בדיקת המודל Conduit.7 מחפשת אותו.
טעויות נפוצות
- יחידות לא תואמות. ל-Data Rate של פריט יש
Mbps, אבל ה-Units של הערוץ הןW. המרשם מציג Unit mismatch, והפריט לא נספר. יש לתקן את היחידות בצד השגוי. - ערוץ עם נקודת קצה אחת בלבד. Endpoints מציג לא מחובר או שם אחד בלבד. יש לחבר את הנכס השני עם connects to.
כיצד זה מתחבר לתכונות אחרות
- ניזון מ:
- הארכיטקטורה: Assets, בלוקים והפירוק שלהם
- ניתוח פונקציונלי: Actions שמייצרים ומקבלים Input/Outputs
- דרישות: דרישות ממשק
- מזין את:
- ה-RVTM: דרישות ממשק מאומתות כמו כל דרישה אחרת (ראו אימות)
- בדיקות המודל: Conduit.1–9 ו-IO.1–10
- תקציבים ו-TPMs: מרווחי קצב
- חבילות סקירה וקווי בסיס
- הצעות: ה-IBD מציע פריטים להעברה לפי ה-Actions שכל קצה מבצע, כך שההקצאה הפונקציונלית והממשקים הפיזיים נשארים עקביים.
מרשם הממשקים
הדף מפרט כל Conduit בפרויקט. הוא מתעדכן בזמן אמת כשהמודל משתנה. בפרויקט SysML v2 הוא מפרט את ה-connection usages וה-interface usages של המודל; גזירות של דרישות לא נכללות. רק השורות שליד מיקום הגלילה מצוירות, כך שהדף נפתח מיד גם בפרויקטים גדולים; הייצוא עדיין כולל כל ממשק.
כותרת הדף
| פקד | פעולה |
|---|---|
| ייצוא CSV | מוריד את Interface Register - <project>.csv: Number, Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements, Capacity Check (הטקסט המלא של הבדיקה), ואחר כך סיכום Status/Count. |
| ICDs | פותח את רשימת דיאגרמות בקרת הממשקים. |
| + ממשק חדש | פותח את ממשק חדש: שם (אופציונלי; ריק נותן <first> to <second>) ושני ה-Assets שהוא מחבר (בחירה… לכל אחד). יצירה מוסיף את ה-Conduit עם שני קישורי ה-connected by שלו ובוחר את השורה שלו; ביטול פעולה אחד מחזיר הכול לאחור. בפרויקט SysML v2 הכפתור הוא + חיבור חדש: הוא מוסיף connection usage בין שני parts. |
כרטיסי סטטוס
כרטיס אחד לכל סטטוס (Draft, Proposed, Agreed, Baselined) ובנוסף לא הוגדר, כל אחד עם הספירה שלו. הכרטיסים Agreed ו-Baselined ירוקים; «לא הוגדר» בצבע ענבר.
לחיצה על כרטיס מסננת. השבב Status: <status> × מנקה את הסינון. הכתובת interfaces?status=<status> פותחת את הדף מסונן. ליד סינון לפי שם או נקודת קצה, הספירה מציגה למשל 26 interfaces, או 3 of 26 interfaces כשסינון פעיל.
טבלה
| עמודה | תוכן |
|---|---|
| ממשק | מספר ושם; הקישור פותח את תצוגת הפריט. |
| נקודות קצה | שתי הישויות המחוברות, A ↔ B, או לא מחובר. |
| מצב | Interface Status, או לא הוגדר. |
| בעלים | המאפיין Owner. |
| TBD/TBR | TBD או TBR; ריק עבור None. |
| פריטים | מספר הפריטים המועברים, כולל הפריטים של ערוצי הצאצא. |
| דרישות | מספר דרישות הממשק המקושרות. |
| קיבולת | OK, Over capacity, Unit mismatch, No capacity או —. הצבעה מציגה את הטקסט המלא. |
| (כפתור) | ICD מייצא את מסמך ה-ICD של הממשק הזה (Word). |
לחיצה על שורה, או העברת המיקוד אליה ולחיצה על Enter או Space, מציגה את ה-Conduit בחלונית המאפיינים. ↑ ו-↓ עוברים בין שורות. Esc מנקה את הבחירה.
חלונית הממשק בחלונית המאפיינים
חלונית הממשק היא המקום שבו עורכים ממשק אחד. היא מופיעה בחלונית המאפיינים, מעל מאפייני הישות, כשבוחרים:
- מחבר בדיאגרמת בלוקים פנימית
- ערוץ צאצא או את תיבת המרכז בדיאגרמת בקרת ממשקים
החלונית מכילה:
- זרימת פריטים (IBD בלבד): Undirected, Directed, Reverse או Bidirectional. היא קובעת את חיצי הפריטים כשלא ה-Actions ולא כיווני הפורטים מכריעים.
- פריטים מועברים (Item Flows): כל פריט עם הכיוון שלו (
EPS → Payload Cameraאו both ways). פריטים מערוצי צאצא מסומנים (ערוץ צאצא). × מפסיק להעביר פריט; הפריט עצמו נשאר. בלי פריטים: אין פריטים. יש להוסיף את ה-Input/Outputs שהמחבר הזה מעביר. - מועבר בין הקצוות: כפתור + <item> אחד לכל פריט מוצע. פריט מוצע כש-Action בקצה אחד מייצר אותו, Action בקצה השני מקבל אותו, והערוץ עדיין לא מעביר אותו.
- + הוספת פריט ▾: Existing Input/Output… (בחירת אחד) או Input/Output חדש… (מתן שם; ברירת מחדל New Item).
- Interface Status, בעלים (מציין מיקום אדם או צוות) ו-TBD/TBR.
- דרישות ממשק: כל דרישה מקושרת עם traced from או satisfies. × מבטל את הקישור שלה. + קישור דרישה… פותח את הבורר. דרישה שנוצרת שם מקבלת את התווית «דרישת ממשק». כשאין: אין קישורים.
- בדיקת קיבולת: טקסט הבדיקה, באדום כשיש חריגה מהקיבולת.
חלונית הפורט
בחירת פורט בדיאגרמת בלוקים מוסיפה:
- סוג: ה-Interface Block או ה-Input/Output שנותנים לו סוג, או ללא סוג. הגדרת סוג… (או שינוי…) פותח את סוג היציאה (Interface Block או Input/Output). ניקוי מסיר את הסוג. מתן סוג Asset לפורט מוסיף את התווית Interface Block ל-Asset הזה.
- Conjugated (reverse the type's flows; shown as ~Type).
פורט עם סוג מוצג כ-name : Type; פורט מצומד כ-name : ~Type.
דיאגרמת בקרת ממשקים
השורש של דיאגרמת בקרת ממשקים הוא Conduit. משטח העבודה מציג:
- את רצועת נכס ההורה השמאלית ואת רצועת נכס ההורה הימנית
- ביניהן, את תיבת המרכז: ערוץ השורש
- בתוך תיבת המרכז, את ערוצי הצאצא כפסים אופקיים, עם הפריטים שלהם כתגיות ירוקות
סרגל כלים
| פקד | פעולה |
|---|---|
| Left: <asset> / אין Asset בצד שמאל. בחירת Asset… | יש לבחור את נכס ההורה השמאלי. ערוץ השורש connects to אותו; הקישור להורה השמאלי הקודם מבוטל. |
| Right: <asset> / אין Asset בצד ימין. בחירת Asset… | יש לבחור את נכס ההורה הימני. |
| ייצוא ICD (CSV) | מוריד את ICD - <name>.csv, שורה אחת לכל ערוץ צאצא ופריט (ראו בהמשך). |
| ייצוא מסמך ICD | מוריד את ICD - <name>.docx (ראו בהמשך). |
| מרשם הממשקים | פותח תיבת דו-שיח עם המרשם של השורש ושל ערוצי הצאצא שלו. |
כשלא נשמרו הורים, נעשה שימוש בשני הנכסים הראשונים שהשורש מתחבר אליהם.
לוח רכיבים
| פריט | היכן לשחרר אותו | תוצאה |
|---|---|---|
| Asset | רצועת נכס הורה | נכס צאצא של ההורה הזה (decomposed by). אחרת: יש לשחרר אותו ברצועת נכס הורה. |
| Conduit | תיבת הערוץ שבמרכז | ערוץ צאצא של השורש. אחרת: יש לשחרר אותו על תיבת ה-Conduit שבאמצע. |
| Input/Output | ערוץ צאצא | הערוץ transfers את הפריט. אחרת: יש לשחרר על ערוץ צאצא. |
אפשר לגרור באותה דרך Assets, Conduits ו-Input/Outputs קיימים מרשימת הישויות הקיימות של לוח הרכיבים. כל דבר אחר: הדיאגרמה הזו לא יכולה להציג את הישות הזו.
עריכה על משטח העבודה
- גרירה מערוץ צאצא אל נכס צאצא מקשרת ביניהם (connects to, נוצר מיד). צמדים אחרים נדחים עם ערוץ צאצא מתחבר לנכס צאצא. יש לגרור לאחד מהם.
- גרירת נכס צאצא לתוך הרצועה השנייה מעבירה אותו להורה הזה. גרירת פריט אל ערוץ צאצא אחר מעבירה אותו לשם.
- Delete מסיר את הבחירה מהדיאגרמה מיד (מבטל את הקישור; הישות נשארת). ⇧Delete / Shift+Delete מוחק את הישות אחרי אישור. הסרת רצועת הורה מבטלת את הקישור להורה הזה.
תצוגה ▾
| אפשרות | מסתיר |
|---|---|
| אזהרות יחידות | קו המתאר של האזהרה על פריט שהיחידות שלו שונות מאלה של הערוץ שלו, והממצא שלו בבדיקות הדיאגרמה (<item> is in <unit>; <conduit> carries <unit>. Change one unit.). |
| I/O | תגיות הפריטים. |
| השהיה וקיבולת | תוויות ההשהיה והקיבולת על תיבת המרכז ועל ערוצי הצאצא. |
| נכסי צאצא | נכסי הצאצא ברצועות וקווי החיבור שלהם. |
התווית של כל ערוץ צאצא מציגה את הסטטוס שלו בסוגריים מרובעים ואת Latency: … · Capacity: …. כשבדיקת הקיבולת נכשלת, התווית מוסיפה · over (120%) או · unit mismatch, והפס הופך לאדום או לכתום.
העמודות של טבלת ICD (CSV)
- ערוץ ונקודות קצה: Child Conduit, From Asset, To Asset.
- פריט: I/O, Units.
- מאפייני הערוץ: Latency, Capacity, Interface Status, Owner, TBD/TBR, Connector/Pins, Medium.
- מאפייני הפריט: Direction (From → To, To → From או Both), Size, Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition.
- Requirements, Capacity Check.
- עמודה אחת לכל מאפיין מותאם של Conduit (Conduit: <name>) ולכל מאפיין מותאם של Input/Output (I/O: <name>).
התוכן של מסמך ICD (Word)
- הכותרת Interface Control Document: <root>, שורה שמציינת את שני נכסי ההורה ואת תאריך היצירה, והתיאור של השורש.
- Interface Register: Interface, Endpoints, Status, Owner, TBD/TBR, Items, Capacity עבור השורש ועבור כל ערוץ צאצא.
- Status Summary: ספירה לכל סטטוס.
- סעיף אחד לכל ערוץ, עם:
- טבלה של Endpoints, Status, Owner, TBD/TBR, Connector/Pins, Medium, Latency, Capacity וכל מאפיין מותאם
- Conveyed Items: Item, Direction, Size, Data Rate, Protocol/Format, Message/Data Definition, ובנוסף מאפייני I/O מותאמים
- Requirements: Number, Requirement, Statement
- בדיקת קיבולת
הכפתור ICD בשורה של מרשם הממשקים מפיק את אותו מסמך עבור הערוץ הזה והצאצאים שלו.
תיבת הדו-שיח «מרשם הממשקים»
הכפתור מרשם הממשקים בסרגלי הכלים של ה-ICD וה-IBD פותח את Interface Register: <name>. הוא מפרט את הערוצים של הדיאגרמה הזו:
- תגיות סטטוס
- טבלה של Interface, Endpoints, Status, Owner, TBD/TBR, Items, Requirements ו-Capacity
- האפשרות All Conduits in the project
- הכפתורים ייצוא CSV, ייצוא מסמך ICD (ICD בלבד) וסגירה
כשאין ערוץ מחובר: No Conduits. Add Conduits to the diagram to list them here.
דיאגרמת I/O פיזית
משתמשים בדיאגרמת I/O הפיזית כדי לראות אילו פריטים זורמים בין החלקים של Asset, והאם Conduit מעביר כל אחד מהם. היא מציגה את נכסי הצאצא של ה-Asset ומציירת קו אחד לכל Input/Output שזורם ביניהם.
הקווים נגזרים מהמודל:
- ה-Actions שכל נכס מבצע (generates → receives)
- ה-Conduits שמחברים את הנכסים
קו מקווקו בלי פריט הוא Conduit שלא מעביר דבר.
- צבירה: Actions שמבוצעים על ידי כל צאצא של נכס מוצג, ו-Conduits שמחוברים אליו, נספרים כשייכים לנכס הזה עצמו. הצאצאים כוללים ילדים, נכדים ופורטים.
- חיצוניים: נכסים מחוץ להורה שמחליפים איתו פריטים מצוירים בשורה נפרדת, מסומנים external.
- סרגל הכלים: טיפול כפנימי וטיפול כחיצוני. בדיקות הממשק נמצאות בתג בדיקות הדיאגרמה. שני האחרונים דורשים נכס שנבחר (יש לבחור נכס תחילה.). תצוגה ▾ מפעיל ומכבה את Assets חיצוניים ואזהרות.
יצירת קו
- יש לגרור מנכס אחד לאחר.
הקו מופיע מיד, מהנכס הראשון אל השני, וביטול פעולה אחד מחזיר הכול לאחור:
- Input/Output חדש New Input/Output;
- שמועבר ב-Conduit שכבר מקשר בין שני הנכסים, או ב-Conduit חדש A to B (ה-Origin שלו בקצה של הנכס הראשון);
- שנשלח על ידי ה-Action היחיד של הנכס הראשון, או על ידי Send New Input/Output חדש, ומתקבל על ידי ה-Action היחיד של הנכס השני, או על ידי Receive New Input/Output חדש.
- הקו החדש נבחר. בחלונית המאפיינים שלו יש משבצת אחת לכל חלק: Input/Output, Conduit, Action שולחת וAction מקבלת. בכל משבצת:
- שינוי… בוחר ישות קיימת מהמחלקה הזו;
- חדש יוצר ישות עם שם ברירת המחדל (את השם משנים בחלונית המאפיינים שלה);
- ניקוי (ב-Input/Output בלבד) שומר את קו ה-Conduit בלי פריט.
- אופציונלי: מסמנים דו-כיווני כשה-Conduit מעביר פריטים בשני הכיוונים.
כל שינוי כותב מחדש את הקו, וביטול פעולה אחד מחזיר הכול לאחור. חלק חסר מסומן במשבצת (לדוגמה ⚠ אף Conduit לא מעביר את ה-Input/Output הזה.) עם הוספה כדי ליצור אותו.
אזהרות קו
| רמה | הודעה |
|---|---|
| אזהרה | <item> זורם בין A ל-B, אבל אף Conduit לא מקשר ביניהם כדי להעביר אותו. |
| אזהרה | <item> זורם בין A ל-B, אבל אף אחד מה-Conduits שמקשרים בין A ל-B לא מעביר אותו. |
| אזהרה | <item> זורם בין A ל-B, אבל אף Action לא מפיק או צורך אותו שם. |
| שגיאה | <item> זורם בין A ל-B בכיוון שה-Conduit המחבר לא מאפשר. |
| מידע | <conduit> מקשר בין A ל-B אבל לא מעביר Input/Outputs. |
קווי אזהרה בצבע ענבר, קווי שגיאה באדום. התג בדיקות הדיאגרמה מפרט אותם תחת ממשקים; הצגה בוחר את הקו. חלונית המאפיינים של הקו שנבחר מפרטת את האזהרות שלו.
דיאגרמות N² ו-I²
שתיהן מטריצות ריבועיות שנבנות מהצאצאים של השורש.
| דיאגרמת N² | דיאגרמת I² | |
|---|---|---|
| שורש | Action | Asset |
| אלכסון | Actions צאצאים | נכסי צאצא |
| תאים | Input/Outputs: השורה מייצרת, העמודה מקבלת | Conduits: השורה היא קצה המקור, העמודה היא הקצה השני |
| השורה העליונה | קלטים חיצוניים (מתקבלים, ושום דבר במטריצה לא מייצר אותם) | To (ערוצים עם קצה אחד שנכנסים לעמודה) |
| העמודה הימנית | פלטים חיצוניים (נוצרים, ושום דבר במטריצה לא מקבל אותם) | From (ערוצים עם קצה אחד שיוצאים מהשורה) |
| סרגל כלים | + פעולה, הסרה, ייצוא CSV | + נכס, הסרה, ייצוא CSV |
- הוספת רכיב באלכסון: לוחצים על + פעולה / + נכס, או גוררים אותו מלוח הרכיבים לכל מקום.
- הוספת רשומה בתא: גוררים Input/Output / Conduit מלוח הרכיבים אל תא מחוץ לאלכסון. או גוררים תיבה מהאלכסון אל תא בשורה או בעמודה שלה: Input/Output חדש / Conduit חדש נוצר שם מיד. שמות ברירת המחדל הופכים ל-
<row> To <column>,To <column>אוFrom <row>. - העברת רשומה: גוררים את השם שלה לתא אחר. הקשרים נכתבים מחדש.
- פתיחה: לחיצה כפולה על תיבה באלכסון או על רשומה פותחת את תצוגת הפריט שלה.
- הסרה: בוחרים אותה ולוחצים על Delete או Backspace, או לוחצים על הסרה. היא יוצאת מהמטריצה מיד (הקישור מבוטל; הישות נשארת). ⇧Delete / Shift+Delete מוחק את הישות אחרי אישור.
- תא מציג עד תשעה שמות בכל עמודה, אחר כך שתי עמודות, ואז +N more.
- ייצוא CSV כותב
N2 - <root>.csvאוI2 - <root>.csvעם הרשת המלאה. - סידור ▾: רענון.
- שגיאות: יש לשחרר על תא, יש לשחרר על תא מחוץ לאלכסון.
פריטים ו-I/O
ממשקים ← פריטים ו-I/O פותח את מסד הנתונים עם השאילתה class:"Input/Output". משתמשים בו כדי לערוך Data Rate, Size, Protocol/Format ו-Message/Data Definition בכמות גדולה, וכדי למצוא פריטים שאף ערוץ לא מעביר.
קיצורים
| מקש | היכן | פעולה |
|---|---|---|
| Enter / Space | שורה במרשם הממשקים | הצגת הממשק בחלונית המאפיינים |
| ↑ / ↓ | מרשם הממשקים | מעבר בין שורות |
| Esc | מרשם הממשקים, N²/I² | ניקוי הבחירה |
| Delete / Backspace | ICD, N²/I², I/O פיזי | הסרה או מחיקה של הבחירה |
הודעות
| הודעה | משמעות ותיקון |
|---|---|
| אין בפרויקט הזה ממשקים. יש להוסיף Conduits בדיאגרמת IBD, Physical I/O או ICD כדי שיופיעו כאן. | עדיין אין Conduits. יש לצייר מחבר או להוסיף Conduit. |
| אין ממשק שתואם לסינון. יש לנקות את הסינון כדי להציג את כל הממשקים. | סינון הטקסט או הסטטוס מסתיר את כל השורות. |
| לא הוגדרה Capacity; העומס לא נבדק. | יש להגדיר Capacity ו-Units ב-Conduit. |
| אין פריטים מועברים. | הערוץ לא מעביר דבר. יש להוסיף פריטים. |
| Over capacity: X of Y <unit> (N%). | יש להעלות את ה-Capacity, להוריד את קצבי הפריטים או לפצל את העומס. |
| N פריטים לא נספרו: היחידות "…" (<item>) לא ניתנות להמרה ל-"<unit>". | יש לתקן את היחידות של הפריט או של הערוץ. |
| ייצוא מסמכים אינו זמין בגרסה זו. | מייצא ה-Word לא נטען. יש לטעון מחדש את הדף. |
מגבלות
- בדיקת הקיבולת משווה סכומים של Data Rate (או Size) בלבד. היא לא ממדלת תקורת פרוטוקול או מחזור עבודה, ולכן יש להזין קצבים אפקטיביים.
- Conduit הוא מנקודה לנקודה. בדיקת המודל Conduit.5 מסמנת יותר משתי נקודות קצה.
- ה-Data Rate של פריט נספר פעם אחת לכל ערוץ שמעביר אותו, כולל דרך צרור.
קשור
- מדריך: מסמך בקרת ממשקים (ICD): מה הוא מכיל ואיך לשמור עליו מעודכן.
- אימות — אימות דרישות ממשק ומעקב אחר כיסוי.
- תקציבים ו-TPMs — יחידות, כמויות ומרווחים.
- דיאגרמות SysML — דיאגרמות בלוקים פנימיות, פורטים ומחברים.
- ניתוח פונקציונלי — ה-Actions וה-Input/Outputs שממשקים מעבירים.
- עזרה: מרשם הממשקים, ממשקים, Conduits ו-ICDs, בניית הארכיטקטורה והפקת ICD, דיאגרמת בלוקים פנימית, דיאגרמת בקרת ממשקים, דיאגרמת N², דיאגרמת I², דיאגרמת I/O פיזית, בדיקות המודל.