צעדים ראשונים
מדריכים
האזנה לדף הזה 19 דקות
אחד-עשר מדריכים מודרכים על מודל קטן של תחנת מזג אוויר, מהדרישה הראשונה ועד מפרט שנמסר, עם חלונית שלבים שבודקת את העבודה תוך כדי.
בדף זה
- איך להשתמש בה
- מדריך 1: Getting Around
- מדריך 2: Write Good Requirements
- מדריך 3: Trace Requirements
- מדריך 4: Functional Analysis
- מדריך 5: From a Spreadsheet to Requirement Diagrams
- מדריך 6: Physical Architecture and Allocation
- מדריך 7: Interfaces
- מדריך 8: Simulate the Functional Flow
- מדריך 9: Verify the Requirements
- מדריך 10: Baseline, Change, Impact
- מדריך 11: Produce the Deliverable
- פרויקטים של מדריכים ומגבלות התוכנית
- קשור
ב-Holarch יש אחד-עשר מדריכים מודרכים. כל אחד יוצר פרויקט התחלתי קטן ופותח חלונית שלבים לצד הדף. החלונית בודקת את המודל תוך כדי עבודה ומסמנת כל שלב כשהוא הושלם. הדף הזה מפרט כל שלב כטקסט, כך שאפשר לעקוב גם כאן.
כל המדריכים משתמשים באותה מערכת קטנה: WS-1 Weather Station, תחנה מבוססת אנרגיה סולרית שמודדת את מזג האוויר, רושמת את הקריאות ומדווחת עליהן לשרת. לכל מדריך יש פרויקט התחלתי משלו, כך שאפשר לבצע אותם בכל סדר. מדריכים 6 עד 11 ממשיכים את המודל: כל פרויקט התחלתי מכיל את תחנת מזג האוויר כפי שהמדריכים הקודמים השאירו אותה.
| מדריך | זמן | מה לומדים |
|---|---|---|
| התמצאות | 10 דקות | להשתמש בסרגל הניווט, במסד הנתונים, בחלונית המאפיינים, בחיפוש (⌘K / Ctrl+K) ובעזרה |
| כתיבת דרישות טובות | 15 דקות | ליצור מסמך דרישות, להוסיף דרישות, להריץ את בדיקת האיכות ולתקן ניסוח שסומן |
| עקיבה אחר דרישות | 12 דקות | לקשר דרישות לפונקציות ולרכיבים במטריצת העקיבות ולמצוא פער |
| ניתוח פונקציונלי | 15 דקות | לגזור פונקציות מדרישות, לפרק פונקציה ולהפיק FFBD |
| מגיליון אלקטרוני לדיאגרמות דרישות | 20 דקות | לייבא דרישות מ-Excel, לקבוע להן קו בסיס, לתקן את מה שבדיקת האיכות מסמנת, לשרטט ולייצא דיאגרמות Spider ועץ, להוסיף דרישות ולתייג אותן |
| ארכיטקטורה פיזית והקצאה | 15 דקות | לבנות את היררכיית הנכסים, להקצות פונקציות לרכיבים ולבדוק את התוצאה עם היררכיית ההקצאה |
| ממשקים | 15 דקות | לחבר תת-מערכות ב-Conduits, לתת שם למה שזורם, להוסיף יציאות, לקרוא את מרשם הממשקים ולייצא ICD |
| סימולציה של הזרימה הפונקציונלית | 15 דקות | לתת לפונקציות משכי זמן, לדמות את הזרימה, למצוא את הנתיב הארוך ביותר ולבדוק דרישת תזמון |
| אימות הדרישות | 15 דקות | לבחור שיטות אימות, ליצור מקרי בדיקה, לתעד תוצאות, לקרוא את ה-RVTM ולסגור את הפערים |
| קו בסיס, שינוי, השפעה | 20 דקות | לאשר דרישות ולקבוע להן קו בסיס, לשנות אחת מהן דרך בקשת שינוי, לסמן את הקישורים ששונו כנבדקים ולאשר אותה שוב |
| הפקת התוצר | 12 דקות | ליצור מפרט מתבנית, להכניס מטריצות חיות, לקבוע לו קו בסיס ולייצא אותו ל-Word |
איך להשתמש בה
התחלת מדריך
אפשר להתחיל מדריך מכל אחד מהמקומות האלה:
- עזרה → מדריכים בסרגל הניווט.
- ניהול פרויקטים → קובצי פרויקט ▾ → התחלת מדריך…, או התחלת מדריך כשעדיין אין פרויקטים.
- חיפוש (⌘K / Ctrl+K): יש להקליד
tutorialולבחור התחלת מדריך… או מדריך אחד לפי שם.
בדף מדריכים, יש ללחוץ על התחלה בכרטיס של מדריך. מופיע הפרויקט החדש, בשם Tutorial: <name> (Weather Station), עם חלונית השלבים משמאל.
ביצוע השלבים
- יש לקרוא את השלב הנוכחי בחלונית. זהו השלב הראשון בלי סימון.
- לחיצה על הדגמה מסמנת בקו מתאר את הפקד שהשלב צריך. קו המתאר דוהה אחרי כמה שניות ואף פעם אינו חוסם את הדף.
- כשהשלב מתבצע בדף אחר, יש ללחוץ על מעבר לשם.
- יש לבצע את השלב בחלון הרגיל של Holarch. השלב הופך לירוק ברגע שהמודל עומד בו. השלב הבא נפתח.
- לחיצה על קריאה נוספת פותחת את נושא העזרה או את פרק התיעוד המתאים.
החלונית נשארת מעוגנת בכל דף של פרויקט המדריך. לחיצה על › בכותרת שלה מכווצת אותה לרצועה צרה, ולחיצה על הרצועה מחזירה אותה.
צפייה בסרטון
מדריך עם סרטון מציג את התמונה שלו עם ▶ בכרטיס שלו בדף מדריכים, ו-▶ בכותרת החלונית. לחיצה על אחד מהם מנגנת את הסרטון בתיבת דו-שיח. הוא מתנגן מ-holarch.app עם כתוביות כבויות; אפשר להפעיל אותן בפקד הכתוביות של הנגן. כשלסרטון יש קריינות בשפת הממשק שלך, הוא מתנגן בשפה הזו (התמונה נשארת זהה); שמע מתחת לסרטון מחליף לשפה אחרת ושומר על המקום שבו הצפייה נעצרה. פקד הכתוביות מציג כל שפה שיש לסרטון כתוביות בה. סרטון בלי קריינות בשפה שלך מתנגן באנגלית. דבר אינו נטען לפני הלחיצה; ראו מדיניות הפרטיות. בגרסה למחשב הסרטון נפתח ב-holarch.app בכרטיסייה חדשה. לכל מדריך יש סרטון, והוא פועל גם בלעדיו.
עזרה → סרטונים מציג את סרטוני המדריכים, את הסיורים (סקירות קצרות של קבוצות תכונות על פרויקט ההדגמה CubeSat EO-1), את Building a CubeSat in Holarch, סדרה שבונה את מודל CubeSat EO-1 שלב אחר שלב מתפיסת המשימה ועד האימות, ואת Systems Engineering with Holarch, סדרה שעוקבת אחר התהליכים הטכניים של ISO/IEC/IEEE 15288 על תחנת מזג האוויר WS-1, ואת הדגשי התכונות, קטעים קצרים של תכונה אחת כל אחד; אותם סרטונים נמצאים בדף הסרטונים, וכל הדגש מתנגן גם בדף התכונות שלו. כל סרטון מתנגן מ-holarch.app, עם כתוביות (בגרסה למחשב הוא נפתח שם בכרטיסייה חדשה). נושאי עזרה עם סיור מתאים מציגים ▶ צפייה בסיור, נושאים עם הדגש מציגים ▶ צפייה: ואת שם הקטע, ופרויקט חדש או כמעט ריק מציג בדף הבית חדשים ב-Holarch? ▶ צפייה בסיור בן 4 דקות עד שסוגרים אותו עם ×.
המשך, התחלה מחדש או סיום
- המשך: יש לפתוח שוב את פרויקט המדריך, או ללחוץ על המשך בדף מדריכים. ההתקדמות נשמרת בפרויקט, ולכן אפשר להמשיך גם בדפדפן אחר.
- התחלה מחדש: יש ללחוץ על התחלה מחדש… בחלונית או בכרטיס. Holarch מוחק את פרויקט המדריך ויוצר פרויקט חדש.
- סימון כהושלם: יש ללחוץ על סימון כהושלם בחלונית כשהשלבים הושלמו. הכרטיס בדף מדריכים מציג הושלם. הפרויקט נשאר; אפשר למחוק אותו מניהול פרויקטים כשאין בו עוד צורך.
- סגירה: × בכותרת החלונית מסתיר את החלונית לפרויקט הזה. כדי להציג אותה שוב, יש ללחוץ על המשך בדף מדריכים, או להריץ את הצגת חלונית המדריך מ-⌘K / Ctrl+K.
כל כרטיס בדף מדריכים מציג טרם התחיל, בתהליך (עם השלבים שהושלמו) או הושלם, ומקשר אל השלבים כטקסט בדף הזה. בכרטיס של מדריך שהושלם מופיע פתיחה במקום המשך.
מדריך 1: Getting Around
לימוד חלקי החלון של Holarch על מודל מוגמר של תחנת מזג אוויר. בפרויקט ההתחלתי יש מסמך דרישות, ארבע פונקציות וארבעה רכיבים.
- פתיחת מסד הנתונים של המודל. יש ללחוץ על מסד הנתונים בתחתית סרגל הניווט. כל פריט בפרויקט מופיע בטבלה אחת.
- שימוש בחלונית המאפיינים. יש ללחוץ על השורה Sensor Suite. בחלונית המאפיינים משמאל, יש לשנות את שם בקבוצה הראשונה (הגדרה) ל-
Sensor Package. השם החדש נשמר מיד. כל דף מציג אותו. - חיפוש עם ⌘K / Ctrl+K. יש להקיש ⌘K / Ctrl+K (או ללחוץ על חיפוש בסרגל העליון), להקליד
Data Loggerולהקיש Enter. הפריט נפתח בדף משלו. - יצירת פריט מהחיפוש. יש להקיש ⌘K / Ctrl+K, להקליד
new reqולבחור Requirement חדש…. יש להזין את השםMeasure Wind Speedואת התיאורThe station shall measure the wind speed to within 0.5 m/s.וללחוץ על יצירה. - פתיחת קבוצת מחזור חיים. יש ללחוץ על התנהגות בסרגל הניווט. דף הסקירה מציג את הדפים של הקבוצה ואת המספרים החיים שלה.
- פתיחת מסמך הדרישות. בסרגל הניווט, יש לפתוח את צרכים ודרישות → מסמכים ואז ללחוץ על Weather Station Requirements.
- פתיחת העזרה של הדף. יש ללחוץ על ? בסרגל העליון, או להקיש ? מחוץ לשדה טקסט. העזרה פותחת את הנושא של הדף הנוכחי, לצד הדף.
מדריך 2: Write Good Requirements
כתיבת דרישות, בדיקתן מול כללי כתיבת הדרישות ותיקון מה שהבדיקה מסמנת. בפרויקט ההתחלתי יש את הרכיבים של תחנת מזג האוויר אך עדיין אין דרישות.
- יצירת מסמך דרישות. יש לפתוח את צרכים ודרישות → מסמכים וללחוץ על + מסמך חדש. יש להזין את השם
Weather Station Requirements, להשאיר ריק וללחוץ על יצירה. - הוספת ארבע דרישות. ב-הוספה מהירה מתחת למסמך, יש להקליד כל שורה ולהקיש Enter:
The station shall measure air temperature and report humidity quickly.The station shall store measurements as needed.The station should be easy to install.The station shall transmit the weather report to the server at intervals of 10 minutes.
- הרצת בדיקת האיכות. יש לפתוח את צרכים ודרישות → איכות, להגדיר את ההיקף ל-Document: Weather Station Requirements וללחוץ על בדיקת איכות. כל דרישה מקבלת ציון. העמודה הצעות מציינת מה לתקן.
- פיצול הדרישה המשולבת. הדרישה הראשונה מציינת שתי פעולות (מדידה ודיווח), ולכן היא נכשלת ב-Singular. יש לפתוח את המסמך, לבחור את הדרישה הראשונה ולשנות את התיאור שלה בחלונית המאפיינים ל-
The station shall measure the air temperature to within 0.5 °C.אחר כך יש להוסיףThe station shall measure the relative humidity to within 3 %.עם הוספה מהירה. - החלפת ניסוח מעורפל. יש לשנות את התיאור של הדרישה השנייה ל-
The station shall store the measurements of the last 30 days.ואת השלישית ל-The installer shall mount the station on the mast in 30 minutes.השלב הופך לירוק כשאף דרישה במסמך אינה נכשלת ב-Unambiguous. - בדיקה חוזרת. בדף איכות, יש ללחוץ שוב על בדיקת איכות. כל דרישה מקבלת עכשיו ציון של 67% ומעלה. Correct ו-Feasible דורשים שיקול דעת של מבקר, ו-Verifiable דורש בדיקה, ולכן 67% הוא הציון הגבוה ביותר שדרישה יכולה להשיג לפני שהיא נסקרת ומאומתת.
מדריך 3: Trace Requirements
קישור דרישות לפונקציות ולרכיבים שמספקים אותן, קריאת המטריצה ומציאת מה שחסר. בפרויקט ההתחלתי יש שש דרישות, ארבע פונקציות וארבעה רכיבים. חמש דרישות כבר מקושרות לפונקציות.
- פתיחת מטריצת העקיבות. יש ללחוץ על מעבר לשם בשלב, או לפתוח את אימות → מטריצת עקיבות. יש ללחוץ על השבב שורות, להגדיר את שורות מתוך ל-כל הישויות של מחלקה ואת מחלקה ל-Requirement, וללחוץ על סיום. כך גם עם השבב עמודות עבור Action. כל סימון הוא קשר בין דרישה (שורה) לפונקציה (עמודה).
- מציאת הפער וסגירתו. יש לסמן את פערים בלבד. נשארת שורה אחת: Report Battery Level; אף פונקציה אינה מספקת אותה. יש ללחוץ על התא שבו היא נפגשת עם F4 Manage Power ולבחור satisfied by אם Holarch שואל. השורה יוצאת מרשימת הפערים. יש לבטל את הסימון של פערים בלבד.
- קישור דרישה לרכיב. יש להגדיר את המחלקה של השבב עמודות ל-Asset. יש ללחוץ על התא שבו Store Measurements נפגשת עם Data Logger ולבחור satisfied by.
- הקצאת פונקציות לרכיבים. יש להגדיר את המחלקה של השבב שורות ל-Action ולהשאיר את העמודות על Asset. יש לקשר כל פונקציה לרכיב שמבצע אותה, עם performed by:
- F1 Measure Weather → Sensor Suite
- F2 Log Measurements → Data Logger
- F3 Report Weather → Radio Link
- F4 Manage Power → Power Subsystem
- קריאת העקיבה בדף הפריט. יש להקיש ⌘K / Ctrl+K, להקליד
Report Battery Levelולהקיש Enter. המקטע עקיבה שלה מראה ש-F4 Manage Power מספקת אותה. - מעקב אחר העקיבה עד הרכיב. יש ללחוץ על F4 Manage Power במקטע עקיבה, ואז על Power Subsystem תחת performed by. כך עברת לאורך השרשרת דרישה → פונקציה → רכיב.
מדריך 4: Functional Analysis
גזירת פונקציות מהדרישות, פירוק אחת מהן ושרטוט דיאגרמת בלוקי הזרימה הפונקציונלית (FFBD). בפרויקט ההתחלתי יש מסמך דרישות עם ארבע דרישות פונקציונליות ושתי דרישות ביצועים, ועדיין אין פונקציות.
- פתיחת הניתוח הפונקציונלי. יש לפתוח את התנהגות → ניתוח פונקציונלי ולהגדיר את ההיקף ל-Weather Station Requirements.
- חילוץ הפונקציות. בכרטיסייה פונקציות, יש ללחוץ על חילוץ לפי כללים…, לעבור על התצוגה המקדימה וללחוץ על החלה. Holarch יוצר פונקציה עליונה עם פונקציה אחת לכל דרישה פונקציונלית (F1–F4) ומקשר כל דרישה לפונקציה שלה עם satisfied by.
- שינוי השם של הפונקציה העליונה. יש ללחוץ על שם הפונקציה העליונה ליד פונקציה עליונה: ולשנות את השם שלה ל-
Operate Weather Station. - פירוק פונקציה. יש לפתוח את F1 Measure Weather (חיפוש עם ⌘K / Ctrl+K). במקטע עקיבה שלה, יש ללחוץ על ה-+ ליד decomposed by (ולסמן את הצגת כל הקשרים אם הוא אינו מופיע), לבחור Action חדשה… וליצור את ה-Action
Read Sensors. כך גם עבורCheck Readings. ל-F1 יש עכשיו שתי תת-פונקציות. - סידור הזרימה. יש לחזור לניתוח פונקציונלי ולפתוח את הכרטיסייה זרימה ו-FFBD. יש ללחוץ על עריכה כטקסט…, להזין
AND(LOOP(F1 -> F2 -> F3) | F4)ולהחיל. המדידה, הרישום והדיווח חוזרים עכשיו בלולאה בזמן שניהול ההספק פועל במקביל. - פתיחת ה-FFBD. יש ללחוץ על פתיחת FFBD. הדיאגרמה מציגה את הלולאה (LP) ואת הענף המקבילי (AND).
- שינוי הפריסה. בסרגל הכלים של ה-FFBD, יש להגדיר את הכיוון ל-מלמעלה למטה.
- פתיחת ה-FFBD של התת-פונקציה. לחיצה כפולה על F1 Measure Weather ב-FFBD פותחת את ה-FFBD שלה עצמה עם Read Sensors ו-Check Readings.
מדריך 5: From a Spreadsheet to Requirement Diagrams
הבאת דרישות מגיליון אלקטרוני ל-Holarch, בדיקתן ושיפורן, ושרטוט הדיאגרמות שמציגות את המבנה שלהן. פרויקט המדריך מתחיל ריק.
- קבלת הגיליון האלקטרוני. יש ללחוץ על הורדת גיליון אלקטרוני בשלב, או להוריד את weather-station-requirements.xlsx (גרסת CSV). כדי ליצור גיליון משלך ב-Excel או בכל אפליקציית גיליונות, יש להציב את העמודות האלה בשורה הראשונה:
- Number: מספר המתאר, כמו
1,1.1,1.2. - Name: שם קצר.
- Description: נוסח הדרישה, כמו
The weather station shall …. - Class:
Statementלכותרת קבוצה (1 Sensing),Requirementלשורות שמתחתיה (1.1,1.2). Holarch קורא קובצי Excel ישירות; אין צורך לשמור כ-CSV. בקובץ הדוגמה יש ארבע דרישות חלשות בכוונה.
- Number: מספר המתאר, כמו
- ייבוא. יש לפתוח את צרכים ודרישות → ייבוא וייצוא ולשחרר את הקובץ על הדף. יש ללחוץ פעמיים על המשך כדי להגיע ל-סקירה, ואז ללחוץ על ייבוא N פריטים. Holarch מתאים את העמודות לפי השמות שלהן וממקם כל דרישה תחת ה-Statement שלה לפי המספר. מסמך הדרישות נפתח.
- יצירת קו בסיס. במסמך, יש ללחוץ על גרסה ▾ בבלוק הכותרת ולבחור שמירת קו בסיס…. יש לתת לו את השם
Baseline 1וללחוץ על יצירה. קו הבסיס שומר את הגרסה הראשונה הזו, כך שאפשר להשוות אליה שינויים מאוחרים יותר. - הרצת בדיקת האיכות. יש לפתוח את צרכים ודרישות → איכות, להגדיר את ההיקף למסמך וללחוץ על בדיקת איכות. כדי לשמור את הדוח, יש ללחוץ על ייצוא ▾ → Excel (.xlsx). קריאת הרמות: בדיקות אוטומטיות מגיעות ל-78% לכל היותר. 67% ומעלה פירושו שהדרישה עומדת בכל כללי הניסוח. מתחת ל-67%: יש לנסח אותה מחדש.
- תיקון הדרישות שסומנו. יש לבחור במסמך כל דרישה שמתחת ל-67% ולשנות את התיאור שלה בחלונית המאפיינים. יש להריץ את הבדיקה שוב עד שכל אחת מגיעה ל-67%. Correct ו-Feasible דורשים סקירה שלך: אחרי הבדיקה, לחיצה על ה-✘ שלהם מסמנת Yes, וזה מעלה את הציון ל-89–100%. לדוגמה:
- 1.2:
The weather station shall measure the wind speed to the nearest 0.1 m/s. - 1.3:
The rain gauge shall record each 0.2 mm of rainfall. - 2.3:
The display shall show the latest readings. - 3.2:
The weather station shall send the low-battery alert at 20 % charge.
- 1.2:
- יצירה וייצוא של דיאגרמת ה-Spider. יש לפתוח את דיאגרמות בסרגל הניווט. כרטיסים שמסומנים תצוגה נגזרת הם דיאגרמות ש-Holarch מציע לכל ישות עליונה שיש לה צאצאים (ראו דיאגרמות); פתיחת אחת מהן שומרת אותה. את ה-Spider יוצרים בעצמך, כמו לכל ישות: יש ללחוץ על + דיאגרמה חדשה ולבחור דיאגרמת Spider. ב-שורש, יש להקליד
Weather Station, לבחור את המסמך Weather Station Requirements וללחוץ על יצירה.- ה-Spider עוקב אחר הקשרים שמסומנים במקטע תרשים של חלונית המאפיינים (קשרים… בסרגל הכלים עובר אליו), כאן source of (מהמסמך ל-Statements שלו) ו-decomposed by (מכל Statement לדרישות שלו).
- רמה קובעת כמה צעדים הוא מתרחק מהשורש. שינויים בכל אחד מהם חלים מיד.
- יש ללחוץ על ייצוא… בסרגל הכלים של הדיאגרמה ולבחור דיאגרמה (PNG) או דיאגרמה (SVG).
- פתיחה וייצוא של דיאגרמת העץ. דיאגרמות נפתחות גם מהמסמך. יש לפתוח את Weather Station Requirements; אם נבחר פריט, יש להקיש Esc כדי שהעץ יתחיל במסמך. יש ללחוץ על תצוגה ▾ בסרגל הכלים של המסמך ולבחור פתיחה ב- ▸ עץ. העץ מציג כל Statement עם הדרישות שלו מתחתיו. יש ללחוץ על ייצוא… ולבחור פורמט.
- הוספת דרישה במסד הנתונים. יש לפתוח את מסד הנתונים וללחוץ על + פריט חדש. יש לבחור Requirement, לתת לה את השם
Maximum Wind Speed, את המספר1.2.1ואת התיאורThe weather station shall report wind speeds up to 150 km/h.במקטע עקיבה של חלונית המאפיינים, יש ללחוץ על + ליד decomposes, לבחור קישור פריט קיים…, לסמן את 1.2 וללחוץ על קישור הנבחרים. בפתיחת המסמך, הדרישה החדשה נמצאת תחת 1.2. - תיוג הדרישות. יש לפתוח את צרכים ודרישות → דרישות, לסמן את 1.1 עד 3.2 וללחוץ על תווית ▾ → Functional Requirement. השורות נשארות מסומנות: יש ללחוץ על × בסוף סרגל הבחירה (או להקיש Esc) כדי לנקות אותן, ואז לסמן את 1.2.1 ולבחור תווית ▾ → Performance Requirement. לחיצה אחת מתייגת כל דרישה מסומנת.
- מעבר בין תצוגות ופרויקטים. יש לפתוח את המסמך מ-צרכים ודרישות → מסמכים, ואז את מסד הנתונים: שניהם מציגים את אותם פריטים. יש לפתוח את ניהול פרויקטים, לפתוח פרויקט אחר, ואז לחזור לפרויקט הזה דרך שם הפרויקט בסרגל העליון.
מדריך 6: Physical Architecture and Allocation
בניית הצד הפיזי של תחנת מזג האוויר וציון הרכיב שמבצע כל פונקציה. בפרויקט ההתחלתי יש את הדרישות, את הפונקציות F0–F4 (F1 מפורקת ל-Read Sensors ול-Check Readings) ואת הזרימה ממדריך 4, ואת המערכת WS-1 Weather Station בלי חלקים עדיין.
- פתיחת דיאגרמת ה-Asset. יש לפתוח את ארכיטקטורה → דיאגרמות Asset וללחוץ על + דיאגרמה חדשה. יש לבחור דיאגרמת Asset, לבחור את WS-1 Weather Station ב-שורש וללחוץ על יצירה. המערכת לבדה בדיאגרמה.
- הוספת תת-המערכות. יש לגרור Asset מלוח הרכיבים אל הדיאגרמה, להזין את השם של תת-מערכת וללחוץ על אישור. כל אחת הופכת לחלק מ-WS-1 (decomposed by). סידור ▾ → סידור הפריסה מיישר אותן:
Sensor SuiteData LoggerPower SubsystemRadio Link
- פירוק תת-מערכת. יש לגרור Asset מלוח הרכיבים לתוך התיבה Sensor Suite, לתת לו את השם
Temperature Sensorוללחוץ על אישור. כך גם עבורHumidity Sensor. Asset שמשוחרר לתוך תיבה הופך לצאצא שלה. - הקצאת הפונקציות. יש ללחוץ על מעבר לשם בשלב כדי לפתוח את מטריצת עקיבות עם פונקציות כשורות, נכסים כעמודות ו-performed by כקשר. יש ללחוץ על התא שבו כל פונקציה נפגשת עם המבצע שלה:
- F0 Operate Weather Station → WS-1 Weather Station
- F1 Measure Weather → Sensor Suite
- F2 Log Measurements → Data Logger
- F3 Report Weather → Radio Link
- F4 Manage Power → Power Subsystem
- הקצאת התת-פונקציות. באותה מטריצה, יש לקשר את F1.1 Read Sensors ל-Temperature Sensor ואת F1.2 Check Readings ל-Data Logger. Check Readings פועלת על הרושם, כך שפונקציית המדידה משתרעת עכשיו על פני שתי תת-מערכות.
- פתיחת דיאגרמת ההיררכיה. יש לפתוח את דיאגרמות, ללחוץ על + דיאגרמה חדשה ולבחור דיאגרמת היררכיה. ב-שורש, יש לבחור את WS-1 Weather Station וללחוץ על יצירה.
- החלת היררכיית ההקצאה. יש ללחוץ על הגדרה בסרגל הכלים של הדיאגרמה. ב-אפשרויות, יש ללחוץ על התבנית היררכיית הקצאה (ראו התבנית היררכיית הקצאה). כל תת-מערכת מציגה את המספרים של הפונקציות שהיא מבצעת, ואת הרכיבים שלה מתחתיה.
- בדיקת ההקצאה. קריאת הדיאגרמה: כל מספר פונקציה מופיע תחת תת-מערכת, ו-F1.2 נמצאת תחת Data Logger בעוד שההורה שלה F1 נמצאת תחת Sensor Suite. פונקציה שמפוצלת בין תת-מערכות פירושה שנתונים עוברים ביניהן; זהו הממשק של מדריך 7. יש לפתוח את אימות → בדיקות המודל ולוודא שאף כלל אינו מדווח פעולות שאף נכס לא מבצע.
מדריך 7: Interfaces
חיבור תת-המערכות, ציון מה שזורם ביניהן והפקת מסמך בקרת הממשקים (ICD). בפרויקט ההתחלתי יש את היררכיית הנכסים ואת ההקצאה ממדריך 6, ואין חיבורים.
- פתיחת דיאגרמת ה-Asset. יש לפתוח את ארכיטקטורה → דיאגרמות Asset וללחוץ על + דיאגרמה חדשה. יש לבחור דיאגרמת Asset, לבחור את WS-1 Weather Station ב-שורש וללחוץ על יצירה.
- שרטוט Conduit. יש ללחוץ על ⋯ (פעולות נוספות) בסרגל הכלים של הדיאגרמה, ואז על + Conduit. יש להגדיר את מ-Asset ל-Sensor Suite, את אל Asset ל-Data Logger ואת שם ל-
Sensor Bus, וללחוץ על יצירה. אפשר גם לגרור מהנקודה הירוקה של תיבה לתיבה אחרת. - חיבור שאר תת-המערכות. יש להוסיף עוד שני Conduits באותה דרך:
- Data Logger → Radio Link:
Serial Link - Power Subsystem → Data Logger:
Power Harness
- Data Logger → Radio Link:
- ציון מה שזורם. יש ללחוץ על הקו Sensor Bus. בחלונית שלו, יש ללחוץ על + מעביר I/O…, ואז על יצירת חדש…, וליצור את ה-Input/Output
Sensor Readings. כך גם ב-Serial Link עםWeather Report. - הסכמה על הממשק. כש-Sensor Bus נבחר, יש לפתוח את התכונות שלו בחלונית המאפיינים, להגדיר את Interface Status ל-Agreed ואת Latency ל-
1שניות. - הוספת יציאות. יש לפתוח את ארכיטקטורה → דיאגרמות בלוקים וללחוץ על + דיאגרמה חדשה. יש לבחור דיאגרמת בלוקים פנימית, לבחור את WS-1 Weather Station ב-שורש וללחוץ על יצירה. בלוח הרכיבים, יש להקליד
Sensor Outב-הוספה או חיפוש… ולגרור את “Sensor Out” as Port אל Sensor Suite. אחר כך יש להקלידSensor Inולגרור את “Sensor In” as Port אל Data Logger. - קריאת מרשם הממשקים. יש לפתוח את ממשקים → מרשם הממשקים. כל Conduit הוא שורה עם הקצוות שלו, מה שהוא מעביר והסטטוס שלו. לחיצה על הכרטיס Agreed מציגה רק את הממשקים המוסכמים.
- ייצוא ה-ICD. יש לפתוח את ממשקים → ICDs וללחוץ על + דיאגרמה חדשה. יש לבחור דיאגרמת בקרת ממשקים, לבחור את Sensor Bus ב-שורש וללחוץ על יצירה. לחיצה על ייצוא מסמך ICD שומרת את מסמך בקרת הממשקים ל-Word.
מדריך 8: Simulate the Functional Flow
מתן משכי זמן לפונקציות, הרצת הזרימה ממדריך 4 ומציאת מה שקובע את הזמן הכולל. בפרויקט ההתחלתי יש את הזרימה AND(LOOP(F1 -> F2 -> F3) | F4) ממדריך 4 ואת ההקצאה ממדריך 6.
- פתיחת דיאגרמת ה-Action. יש לפתוח את התנהגות → דיאגרמות Action וללחוץ על F0 Operate Weather Station. לולאה של F1 → F2 → F3 פועלת לצד F4 בענף מקבילי.
- מתן משך לכל פונקציה. יש לבחור כל פונקציה ולהגדיר את משך בתכונות שלה בחלונית המאפיינים. F1 Measure Weather מפורקת, ולכן הזמן שלה הוא הזמן של התת-פונקציות שלה: יש להגדיר את שלהן במקום זאת (לחיצה כפולה על F1 פותחת את הדיאגרמה שלה).
- F1.1 Read Sensors: 15 שניות
- F1.2 Check Readings: 5 שניות
- F2 Log Measurements: 5 שניות
- F3 Report Weather: 2 דקות
- F4 Manage Power: 10 דקות
- הגדרת מספר החזרות של הלולאה. יש לבחור את התיבה LOOP. בחלונית שלה, יש להשאיר את חזרה כל עוד על איטרציות ולהגדיר את המספר ל-
3. - הרצת הסימולציה. יש ללחוץ על ▶ סימולציה ▾ → אירוע בדיד. בדף סימולטור, יש ללחוץ על ⏩ הרצה עד הסוף. הסיכום מציג זמן כולל: 10 דקות. Holarch שומר את ההרצה תחת תוצאות שמורות ▾.
- מציאת הנתיב הארוך ביותר. יש לקרוא את ציר הזמן. שני הענפים מתחילים יחד, והמחזור מסתיים כשהאיטי מביניהם מסתיים: הלולאה לוקחת 7.25 דקות (שלושה מעברים של 2 דקות ו-25 שניות), Manage Power לוקחת 10 דקות. Manage Power נמצאת על הנתיב הארוך ביותר, ולכן היא קובעת את הזמן הכולל. יש לשנות את המשך שלה ל-
5דקות. - הרצה חוזרת. יש להריץ שוב עד הסוף. הזמן הכולל יורד ל-7.25 הדקות של הלולאה. הלולאה היא עכשיו הנתיב הארוך ביותר, וקיצור נוסף של Manage Power אינו משנה דבר.
- בדיקת דרישת תזמון. יש להגדיר את המשך של F3 Report Weather ל-
=triang.dist(1, 4, 2)דקות, כך שכל דיווח לוקח בין דקה ל-4 דקות. בסימולטור, יש לעבור ל-Monte Carlo וללחוץ על ▶ הרצת מונטה קרלו. יש ללחוץ על בדיקה מול דרישה…, לבחור זמן כולל, ≤10דקות ואת הדרישה Transmit Weather Report, ואז תיעוד התוצאה… ו-החלה. Holarch מתעד את התוצאה במקרה בדיקה שמאמת את הדרישה (ראו סימולציה).
מדריך 9: Verify the Requirements
תכנון האופן שבו כל דרישה מאומתת, תיעוד התוצאות וסגירת הפערים שה-RVTM מציג. בפרויקט ההתחלתי יש את הדרישות עם שיטות ומקרי בדיקה לדרישות 1 עד 3 בלבד.
- פתיחת מרכז הבדיקות. יש לפתוח את אימות → מרכז הבדיקות. כיסוי אימות מציג כל דרישה עם השיטה שלה ועם מקרי הבדיקה שלה.
- בחירת שיטות האימות. ב-כיסוי אימות, יש ללחוץ על אותיות השיטה (A ניתוח, D הדגמה, I בחינה, T בדיקה) עבור הדרישות שאין להן שיטה:
- 4 Transmit Weather Report: T
- 5 Operate on Solar Power: A
- 6 Report Battery Level: I
- קריאת ה-RVTM. יש לפתוח את אימות → RVTM. הכרטיסים סופרים את הדרישות לפי סטטוס: שתיים עבר, אחת לא הורץ, שלוש מתוכנן בלבד (שיטה אך בלי בדיקה). אין בדיקה ב-מאומת על ידי מסמן כל פער.
- סגירת הפערים. בחזרה במרכז הבדיקות, יש ללחוץ על + Test Case בשורות של דרישות 4, 5 ו-6. כל מקרה בדיקה חדש מאמת את הדרישה שלו ומתחיל כ-לא הורץ.
- תיעוד התוצאות. יש להגדיר את ה-Status של כל מקרה בדיקה: ללחוץ על הסטטוס בשורה שלו ולבחור ערך. הבדיקות של דרישות 3, 5 ו-6 עוברות: יש לבחור עבר. הדיווח הראשון של דרישה 4 הגיע אחרי 12 דקות, ולכן הבדיקה שלה נכשלת: יש לבחור נכשל.
- תיקון ובדיקה חוזרת. שעון הדיווח של הרדיו תוקן. יש להריץ שוב את הבדיקה שנכשלה ולהגדיר אותה ל-עבר. ה-RVTM מציג עכשיו כל דרישה כ-עבר.
- ייצוא ה-RVTM. בדף RVTM, יש ללחוץ על ייצוא ▾ → Excel (.xlsx).
מדריך 10: Baseline, Change, Impact
הכנסת הדרישות לבקרה, שינוי של אחת מהן בדרך המבוקרת וטיפול במה שהשינוי נוגע בו. בפרויקט ההתחלתי יש את המודל המאומת ממדריך 9, עם Conduits ומקרי בדיקה.
- אישור הדרישות. יש לפתוח את Weather Station Requirements, לבחור כל דרישה וללחוץ על אישור בתיבה אישור של חלונית המאפיינים. שינוי טקסט מאוחר יותר מחזיר דרישה מאושרת לסקירה.
- הגדרת בקרת שינויים. יש לפתוח את בקרה וסקירות → בקשות שינוי. ב-הגדרות, יש לסמן את מחברים יכולים לאשר את בקשות השינוי של עצמם: בפרויקט מדריך עובדים לבד. בצוות, בעלים אחר או ועדת שינויים מאשרים, ובדרך כלל גם שינויים בפריטים מאושרים ובקו בסיס דורשים בקשת שינוי מופעל.
- קביעת קו בסיס לפרויקט. יש לפתוח את בקרה וסקירות → קווי בסיס וגרסאות, ללחוץ על + שמירת קו בסיס… בכותרת הדף, להזין
SRRוללחוץ על שמירת קו בסיס. קו הבסיס שומר את כל המודל כפי שהוא בסקירת דרישות המערכת (SRR). - בקשת שינוי. הלקוח רוצה דיווח כל 5 דקות. ב-בקשות שינוי, יש ללחוץ על בקשת שינוי חדשה, להזין את הכותרת
Report every 5 minutesואת הסיבהCustomer asks for faster reports.וללחוץ על יצירה. - הכנת השינוי וההשפעה שלו. יש ללחוץ על הוספת שינוי ▾ → שינוי פריט…, לבחור את 4 Transmit Weather Report ולשנות את התיאור שלה ל-
The station shall transmit the weather report to the server at intervals of 5 minutes.יש ללחוץ על הכנת השינוי. תחת פריטים מושפעים, רשימת ההשפעה מציעה את הפריטים שנעקבים אליה; יש ללחוץ על + ליד F3 Report Weather ומקרה הבדיקה שלה. יש ללחוץ על שליחה לסקירה. - אישור והחלה. יש ללחוץ על אישור… ולאשר (בשירות המתארח, Holarch מבקש תחילה את הסיסמה שלך). אחר כך יש ללחוץ על החלת השינויים. Holarch מחיל את השינוי המוכן ומסמן את הבקשה כ-Implemented; וביטול פעולה אחד מחזיר הכול לאחור.
- מציאת הקישורים לבדיקה. יש לפתוח את צרכים ודרישות → קישורים לבדיקה. הטקסט החדש מסמן את הקישורים של דרישה 4 לבדיקה: מה שמספק ומאמת אותה אולי כבר אינו מתאים. דרישה 4 חזרה ל-In Review.
- בדיקה וסימון כנבדקו. יש ללחוץ על השוואה כדי לראות מה השתנה. F3 עדיין מספקת את הדרישה, והבדיקה שלה צריכה הרצה חדשה. יש ללחוץ על סימון הכול כנבדק…, להזין את ההערה
F3 checked; test re-run planned.וללחוץ על סימון כנבדק. - אישור חוזר. יש לפתוח את דרישה 4 וללחוץ שוב על אישור. היא נמצאת בקו הבסיס SRR, ולכן תיבת דו-שיח מציגה את הפריטים שנעקבים אליה; יש ללחוץ שם על אישור. יש לפתוח את קווי בסיס וגרסאות וללחוץ על השוואה ב-SRR כדי לראות את השינוי מאז קו הבסיס.
מדריך 11: Produce the Deliverable
הפיכת המודל למפרט שנשאר עדכני, ואחר כך הקפאתו וייצואו. בפרויקט ההתחלתי יש את המודל המאומת; מקרה בדיקה אחד (דרישה 5) עדיין לא הורץ.
- יצירת המפרט. יש לפתוח את צרכים ודרישות → מסמכים וללחוץ על + מסמך חדש. יש לתת לו את השם
WS-1 System Specification, לבחור את התבנית מפרט דרישות וללחוץ על יצירה. התבנית נותנת את הפרקים ואת הנחיות הכתיבה. - הכנסת RVTM חי. יש לבחור את הפרק 11 Verification Approach. יש ללחוץ על כתיבה ▾ → הוספה ▸ מטריצה…, לבחור מטריצת עקיבות אימות דרישות (RVTM), להגדיר את ההיקף ל-Weather Station Requirements וללחוץ על הוספה. לחיצה על ✓ (שמירה) בסרגל הכלים של העורך שומרת את הפרק.
- הכנסת מטריצת ההקצאה. יש לבחור את הפרק 3 System Overview ולהכניס באותה דרך את מטריצת הקצאה (פונקציות לרכיבים). היא מציגה את ההקצאה ממדריך 6.
- צפייה בעדכון. יש לפתוח את אימות → מרכז הבדיקות ולהגדיר את Verify Operate on Solar Power ל-עבר. בחזרה למפרט, דרישה 5 ב-RVTM מציגה עכשיו עבר: המטריצות עוקבות אחר המודל.
- קביעת קו בסיס למסמך. במפרט, יש ללחוץ על גרסה ▾ בבלוק הכותרת ולבחור שמירת קו בסיס…. יש לתת לו את השם
Issue 1וללחוץ על יצירה. - ייצוא ל-Word. יש ללחוץ על מסירה ▾ ולבחור מפרט (Word). בקובץ ה-Word יש את הפרקים, את המטריצות כטבלאות ואת בלוק הכותרת. מסירה ▾ → הדפסה או PDF… יוצר קובץ PDF באותה דרך.
פרויקטים של מדריכים ומגבלות התוכנית
- פרויקטים של מדריכים אינם נספרים ב-5 הפרויקטים הפעילים של תוכנית Free.
- כל פרויקט מדריך מכיל עד 300 פריטים.
- אפשר להחזיק פרויקט מדריך אחד לכל מדריך. התחלה מחדש… מחליף אותו.
- פרויקטים של מדריכים הם אישיים: אי אפשר להוסיף להם עורכים או להעביר אותם. אפשר להזמין צופים. לדוגמה, סטודנט יכול לשתף פרויקט מדריך עם מרצה כצופה.
- קבצים מצורפים בפרויקט מדריך נספרים באחסון שלך כמו כל קובץ אחר.