קריאת העסקה
אחד מהתרחישים לדוגמה הראשונים שבהם מתבצעת אינטראקציה עם Nodes ב- Matter הוא הקריאה של מאפיין מצומת אחר, כמו ערך טמפרטורה מחיישן. באינטראקציות כאלה, הפעולה שחייבת לבצע היא 'פעולה של בקשת קריאה'.
פעולת קריאה של הבקשה
כיוון: מאתחל -> טירגוט
בפעולה הזו, המאתחל שולח שאילתה על יעד שמספק:
- בקשות למאפיינים: רשימה של אפס מאפיינים או יותר מהמאפיינים של היעד. הרשימה הזו מורכבת מאפס נתיבים או יותר ליעד המבוקש מאפיינים.
- בקשות לאירועים: רשימה של אפס נתיבים או יותר אל היעד המבוקש אירועים.
אחרי שהפעולה 'בקשה לקריאה' תתקבל ביעד, הוא ירכיב פעולה של דיווח על נתונים עם המידע המבוקש.
פעולה לגבי נתוני דיווח
כיוון: יעד -> יוזם
בפעולה הזו, היעד משיב באמצעות:
- דוחות מאפיינים: רשימה של אפס המאפיינים המדווחים שהתבקשה בבקשה של פעולת קריאה.
- דוחות אירועים: רשימה של אפס אירועים מדווחים או יותר.
- Suppress Response: דגל שקובע אם הסטטוס צריך לבטל את התגובה לפעולה הזו.
- מזהה מינוי: אם הדוח הזה הוא חלק מעסקה של הרשמה, עליו לכלול מספר שלם שמשמש לזיהוי עסקת המינוי.
פעולת התגובה לסטטוס
כיוון: או יעד -> יוזם או יוזם -> טירגוט
אחרי שיוזם ההזמנה מקבל את הנתונים המבוקשים, כברירת מחדל הוא צריך ליצור פעולת תגובת סטטוס. הפעולה הזו נשלחה מהיוזם, באישור את קבלת הנתונים המדווחים. אם הדגל Suppress Status Response מוגדר, הגורם שהתחיל את הקריאה לא צריך לשלוח את הפעולה Status Response Action.
לאחר שפעולת תגובת הסטטוס נשלחת על ידי המאתחל, או נתוני דוח יוזם המודעה מקבל את הפעולה כשהדגל 'תגובה מבוטלת' מופעל, שאילתת הקריאה/דיווח הסתיימה.
פעולת התגובה בסטטוס פשוט מכילה את השדה status אישור הפעולה או הצגת קוד כישלון.
הגבלות קריאה
פעולת הקריאה של הבקשה והפעולה של נתוני הדיווח הן Unicast בלבד. בנוסף, אסור שהנתיבים של הבקשות האלה יטרגטו קבוצה של צמתים.
פעולת התגובה לסטטוס היא Unicast בלבד ולא ניתן להיות שנוצרת כתגובה ל-groupcast.
עסקת מינוי
פעולה של בקשת הרשמה
כיוון: מאתחל -> טירגוט
בנוסף לפעולה יחידה של בקשת קריאה, מבצע הבקשה יכול גם להירשם לעדכונים תקופתיים של מאפיין או אירוע. לכן, אותה פעולה של נתוני דיווח כתוצאה מעדכוני נתונים תקופתיים שמבוססים על עסקת מינוי.
אינטראקציה עם מינוי יוצרת קשר בין שני צמתים, שבו היעד יוצר מדי פעם פעולות דיווח על הנתונים ליוזם. יוזם המודעה הוא המנוי והיעד הוא בעל התוכן הדיגיטלי.
פעולת בקשת הרשמה כוללת:
- Min Interval Floor: מרווח הזמן המינימלי בין הדוחות.
- תקרה מקסימלית: המרווח המקסימלי בין דוחות.
- דוחות מאפיינים: רשימה של אפס מאפיינים מדווחים שהתבקשה בבקשה של פעולת קריאה.
- דוחות אירועים: רשימה של אפס אירועים מדווחים או יותר.
אחרי בקשת ההרשמה, היעד משיב למאתחל באמצעות דיווח על פעולה לגבי נתונים, שמכילה את אצוות הנתונים הראשונה המדווחים: קובץ ה-Primed נתונים שפורסמו.
לאחר מכן, המאתחל מאשר את הפעולה של נתוני הדיווח עם תגובת סטטוס הפעולה נשלחה ליעד. אחרי שהיעד מקבל פעולת תגובה עם סטטוס ללא שגיאות, הוא שולח פעולת תגובה של הרשמה.
לאחר מכן, היעד ישלח מדי פעם את הפעולה של נתוני הדיווח בשעה פרק הזמן המוסכם והיוזם ישיב לפעולות האלה עד המינוי אבד או בוטל.
פעולת התגובה להרשמה
כיוון: יעד -> יוזם
זו הפעולה האחרונה בעסקת המינוי, והיא הסתיימה תהליך האימות. היא כוללת:
- Subscriptions ID: מספר שלם שמזהה את המינוי.
- מרווח מינימלי: המרווח המינימלי הסופי, הנקבע בין דוחות.
- מרווח מקסימלי: המרווח המקסימלי הסופי, הנקבע - המרווח המקסימלי בין דוחות.
הגבלות על הרשמה
- פעולת בקשת ההרשמה ופעולת התגובה להרשמה הן פעולות ל-Unicast בלבד.
- כל הפעולות על נתוני הדוחות באינטראקציה עם מינוי חייבות להיות זהות מזהה המינוי.
- אם המנוי לא מקבל פעולה על נתוני דיווח בטווח המקסימלי במרווחי זמן מוסכם בין פעולות, המינוי יסתיים.
- כתוצאה מהכלל הקודם, בעל התוכן הדיגיטלי רשאי לבטל אינטראקציה עם מינויים: פשוט להפסיק לשלוח נתוני דוחות תקופתיים פעולות.
- המנוי רשאי לסיים את האינטראקציה עם המינוי על ידי שליחת תגובה
דיווח על פעולה בנתונים עם קוד הסטטוס
INACTIVE_SUBSCRIPTION
.