דוקומנטציה

קריאה ושליטה במנהל הטעינה של cFos באמצעות Modbus

בנוסף ל-HTTP ו-MQTT, ה-cFos Charging Manager מספק גם ממשק API של Modbus. זה מעוצב על פי SunSpec. תחת התצורה של Charging Manager אתה יכול לציין יציאת TCP או פרמטר יציאת COM וכן מזהה Modbus תחת "הגדרות כתובת SunSpec. המשמעות היא ש-cFos Charging Manager מאזין ליציאת TCP או ליציאת COM תחת הפרמטרים שצוינו ול- Modbus ID ומזהה Modbus + 1. ערכים, פרמטרים, דגלים ומשתנים של General Charging Manager זמינים תחת ה-Modbus ID. ניתן לשאול התקנים (ארגזי קיר ומדים) שהוגדרו ב-Charging Manager תחת ID + 1. כפונקציה של Modbus אתה יכול להשתמש ב-3 וב-4 לקריאה וב-6 וב-16 לכתיבה. שימו לב: ב-Raspberry, יציאות TCP מתחת ל-1024 שמורות לתוכניות עם זכויות אדמין. לכן עדיף לבחור מספר יציאה גבוה יותר, למשל 1502.

מפרט SunSpec Modbus קובע שטווח הכתובות של Modbus מתחיל במזהה "SunS" ולאחר מכן מכיל מה שנקרא מודלים של SunSpec. לכל דגם יש מספר מפתח דגם בהיסט 0 ואורך שאר הרגיסטרים השייכים לדגם בהיסט 1. ערכי הדגם מגיעים לאחר מכן מהיסט 2. חשוב: עליך לסרוק את טווח הכתובות של SunSpec ולחרוג תמיד מהאורך בהיסט 1. אל תניח אורכים קבועים או כתובות רישום קבועות, מכיוון שסביר מאוד שנוסיף ערכים נוספים למודלים עם הזמן. דגם 1 (משותף) תמיד מגיע ראשון עם פרטי היצרן, מספרי גרסאות וכו'. אנא הורד את מפרטי SunSpec Modbus מ- SunSpec Alliance לקבלת מידע מפורט. טווח הכתובות של SunSpec עבור cFos Charging Manager מתחיל בכתובת 40000.

מנהל הטעינה של cFos מציג בתחילה את הערכים הבאים תחת מזהה Modbus לפי הדגם הנפוץ כדגם 213 (מד תלת פאזי, צף):
הפניה לרשת
סך הצרכנים
סך הכל מפיק
עודף PV
בשימוש כוח Wallbox
ביצועי wallbox זמינים
ביצועי שגיאה

לאחר מכן עוקב אחר הדגם ה"מותאם אישית" 60000 עם הגדרת פרמטרים של מנהל הטעינה של cFos: לפי הדגם והאורך, ישנם כרגע 8 ערכי ציפה: זרם כולל מקסימלי, רזרבה, אוברדרפט, זרם סה"כ wallbox מקסימלי בmA לפאזה, הטיית פאזה מקסימלית (בmA), ניהול עומסים פעיל (1 = פעיל, 0 = לא פעיל), הטיה כולל צרכן (1 = פעיל, 0 = לא פעיל), זרם כולל מרבי באחוזים. אלו הם הפרמטרים העולמיים של Charging Manager שניתן להגדיר גם בממשק המשתמש. שינויים בערכים אלה נשמרים (בהשהייה מקסימלית של 150 שניות). ניתן להשתמש באחוז הזרם הכולל להתאמה דינמית של עוצמת הטעינה, למשל לפי בקשת מפעיל הרשת.

אחריו מגיע דגם "מותאם אישית" 60001. 32 רגיסטרים (16 סיביות) עוקבים אחר הדגם והאורך. אלה יכולים להכיל את הערכים 0 ו-1 ולקרוא או לכתוב עד 32 דגלים של Charging Manager. לאחר מכן ניתן לשאול את מצב הדגלים הללו בנוסחאות באמצעות CM._flag1 עד CM._flag32 ולהשתמש לחישובים.

לאחר מכן עוקב אחר מודל "מותאם אישית" 60002. משתנים אפשריים של מנהל החיובים עוקבים אחר המודל והאורך. ישנם 22 אוגרים זמינים עבור כל משתנה. 20 הרגיסטרים הראשונים הם מחרוזת Modbus עבור שם המשתנה (שמות ארוכים מדי יקוצצו). 2 הרשמים הבאים מכילים את הערך הצף הנוכחי של המשתנה. כשאתה כותב את הערך הצף של משתנה Charging Manager, אתה מוחק כל נוסחה קיימת ומגדיר את המשתנה לערך קבוע.

מונים ו-wallboxes שהוגדרו במנהל הטעינה מוצגים כדלקמן תחת Modbus ID + 1. בתור SunSpec דגם 113, קופסאות ה-wallbox מורחבות לכלול שני אוגרים של 16 סיביות. Offset 62 מציג את מצב ה-wallbox (1=מחכה, 2=מחובר לחשמל, 3=טעינה, 4=טעינה עם אוורור, 5=שגיאה) והיסט 63 מציג את מזהה המכשיר. 1 = E1, 2 = E2 וכו'. מונים מיוצגים עם דגם 213 מורחב על ידי 2 אוגרים של 16 סיביות. בהיסט 126 הוא תפקידו של המונה (0=תצוגה, 1=צריכה, 2=ייצור, 3=אספקת רשת, 4=צריכת רכב אלקטרוני, 5=מחסן בית, 6=אחסון הכל), בהיסט 127 הוא מזהה מכשיר (-1 עבור M1, -2 עבור M2 וכו'). אם המונה הוא זיכרון (תפקיד 5 או 6), דגם 213 מלווה בדגם 124, אשר מורחב על ידי אוגר של 16 סיביות. מזהה ההתקן נמצא שוב בהיסט 26. על מנת שמכשירים יוצגו תחת Modbus ID + 1, עליך להפעיל "פרסם מידע על המכשיר באמצעות Modbus" בהגדרות המכשיר.

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

רשימת ערכים לדגם 213:
היסט 0: 213
היסט 1: אורך
היסט 2: סך הזרמים L1-L3 (A)
היסט 4: נוכחי L1 (A)
היסט 6: נוכחי L2 (A)
היסט 8: נוכחי L3 (A)
היסט 10: מתח (V)
היסט 12: מתח L1 (V)
היסט 14: מתח L2 (V)
היסט 16: מתח L3 (V)
היסט 26: 50 הרץ
היסט 28: הספק (W)
היסט 30: הספק L1 (W)
היסט 32: הספק L2 (W)
היסט 34: הספק L3 (W)
היסט 36: כוח לכאורה (VA)
היסט 38: הספק לכאורה L1 (VA)
היסט 40: כוח לכאורה L2 (VA)
היסט 42: כוח לכאורה L3 (VA)
היסט 44: הספק תגובתי (VAr)
היסט 60: ייצוא, הספק פעיל (Wh)
היסט 68: ייבוא, הספק פעיל (Wh)
היסט 126: תפקיד (עם Modbus ID + 1)
היסט 127: מזהה מכשיר (עבור Modbus ID + 1)

רשימת ערכים לדגם 113:
היסט 0: 113
היסט 1: אורך
היסט 2: סך הזרמים L1-L3 (A)
היסט 4: נוכחי L1 (A)
היסט 6: נוכחי L2 (A)
היסט 8: נוכחי L3 (A)
היסט 16: מתח L1 (V)
היסט 18: מתח L2 (V)
היסט 20: מתח L3 (V)
היסט 22: הספק (W)
היסט 24: 50 הרץ
היסט 26: כוח לכאורה (VA)
היסט 32: ייבוא, הספק פעיל (Wh)
היסט 62: מצב (עם Modbus ID + 1)
היסט 63: מזהה מכשיר (עבור Modbus ID + 1)

רשימת ערכים לדגם 124:
היסט 0: 124
היסט 1: אורך
היסט 2: הספק טעינה/פריקה מרבי (W)
היסט 3: אחוז ממגבלת כוח הטעינה הנוכחית
היסט 4: אחוז ממגבלת הספק הפריקה הנוכחית
היסט 8: מצב טעינה באחוזים
היסט 18: מקדם קנה מידה עבור היסט 2
היסט 19: מקדם קנה מידה עבור היסט 3 ו-4
היסט 26: מזהה מכשיר (עבור Modbus ID + 1)

רשימת ערכים לדגם 60000:
כל הערכים בצוף, גישת קריאה/כתיבה, גורמים לעדכון הבזק, כלומר, לא משתנים לעתים קרובות כדי למנוע נזק.
היסט 0: 60000 (ללא 16, לקריאה בלבד)
היסט 1: אורך (uint16, קריאה בלבד)
היסט 2: זרם כולל מרבי (mA)
היסט 4: עתודת חשמל (mA)
קיזוז 6: אוברדרפט (mA)
היסט 8: זרם כולל מרבי של wallbox (mA)
היסט 10: הטיית פאזה מקסימלית (mA)
היסט 12: 1 = ניהול עומסים פעיל, 0 = לא פעיל
קיזוז 14: 1 = הוסף את צריכת הבית לחוסר האיזון, 0 = לא פעיל
היסט 16: אחוז מהזרם הכולל המרבי, אינו נשמר, ניתן לשינוי לעתים קרובות.

רשימת ערכים לדגם 60001:
כל הערכים 0 או 1, int16, גישת קריאה/כתיבה, אינם נשמרים, ניתנים לשינוי לעתים קרובות.
היסט 0: 60001 (uint16, לקריאה בלבד)
היסט 1: אורך (uint16, קריאה בלבד)
היסט 2: CM._flag1
...
אופסט 33: CM._flag32

רשימת ערכים עבור דגם 60002:
כל הערכים צפים, גישת קריאה/כתיבה, אינם נשמרים, ניתנים לשינוי לעתים קרובות. היסט 0: 60002 (uint16, לקריאה בלבד)
היסט 1: אורך (uint16, קריאה בלבד)
היסט 2..22: משתנה 1 של מנהל החיובים
היסט 23..24: משתנה מנהל טעינת ערך 1
קיזוז 25..45: משתנה 2 של מנהל טעינת שמות
היסט 46..47: משתנה מנהל טעינת ערך 2
...