DIVUS VISION API ווייכווארג באַניצער מאַנואַל

DIVUS VISION API ווייכווארג

ספּעסאַפאַקיישאַנז

• פּראָדוקט: DIVUS VISION API
• פאַבריקאַנט: DIVUS GmbH
• ווערסיע: 1.00 REV0 1 - 20240528
• אָרט: Pillhof 51, Eppan (BZ), איטאליע

פּראָדוקט אינפֿאָרמאַציע

די DIVUS VISION API איז אַ ווייכווארג געצייַג דיזיינד פֿאַר ינטערפייסינג מיט DIVUS VISION סיסטעמען. עס אַלאַוז ניצערס צו אַקסעס און קאָנטראָלירן פאַרשידן עלעמענטן אין די סיסטעם ניצן MQTT פּראָטאָקאָלס.

FAQ

ק: קען איך נוצן די DIVUS VISION API אָן פריערדיק וויסן פון פּיסי אָדער אָטאַמיישאַן טעכנאָלאָגיע?

א: דער מאַנואַל איז טיילערד פֿאַר ניצערס מיט פרייַערדיק וויסן אין די געביטן צו ענשור עפעקטיוו נוצן פון די API.

אַלגעמיינע אינפֿאָרמאַציע

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - איטאליע

אַפּערייטינג ינסטראַקשאַנז, מאַניואַלז און ווייכווארג זענען פּראָטעקטעד דורך קאַפּירייט. אלע רעכטן רעזערווירט. קאַפּיינג, דופּליקייטינג, איבערזעצן, איבערזעצן אין גאַנץ אָדער טייל איז ניט דערלויבט. אַ ויסנעם אַפּלייז צו די שאַפונג פון אַ באַקאַפּ קאָפּיע פון ​​די ווייכווארג פֿאַר פּערזענלעך נוצן.
די מאַנואַל איז אונטערטעניק צו טוישן אָן באַמערקן. מיר קענען נישט גאַראַנטירן אַז די דאַטן קאַנטיינד אין דעם דאָקומענט און אויף די סטאָרידזש מידיאַ סאַפּלייד זענען פריי פון ערראָרס און ריכטיק. פֿירלייגן פֿאַר ימפּרווומאַנץ און הינץ אויף ערראָרס זענען שטענדיק באַגריסן. די אַגרימאַנץ אויך אַפּלייז צו די ספּעציפיש אַנעקסיז צו דעם מאַנואַל. די באַצייכענונגען אין דעם דאָקומענט קען זיין טריידמאַרקס וועמענס נוצן דורך דריט פּאַרטיעס פֿאַר זייער אייגענע צוועקן קען ינפרינדזש די רעכט פון זייער אָונערז. באַניצער אינסטרוקציעס: ביטע לייענען דעם מאַנואַל איידער ניצן עס פֿאַר די ערשטער מאָל און האַלטן עס אין אַ זיכער אָרט פֿאַר צוקונפֿט רעפֿערענץ. ציל גרופּע: די מאַנואַל איז געשריבן פֿאַר ניצערס מיט פרייַערדיק וויסן פון פּיסי און אָטאַמיישאַן טעכנאָלאָגיע.

פּרעזענטירונג קאַנווענשאַנז

הקדמה

אַלגעמיינע הקדמה

דער מאַנואַל באשרייבט די VISION API (אַפּפּליקאַטיאָן פּראָגראַממינג צובינד) - אַ צובינד דורך וואָס VISION קענען זיין אַדרעסד און קאַנטראָולד פֿון פונדרויסנדיק סיסטעמען.
אין פּראַקטיש טערמינען, דאָס מיטל אַז איר קענען נוצן סיסטעמען אַזאַ ווי

• MQTT Explorer (https://www.microsoft.com/store/... - פֿאַר טעסטינג),
• היים אַססיסטאַנט (https://www.home-assistant.io/) אָדער
• נאָדע-רויט (https://nodered.org/)

צו קאָנטראָלירן די עלעמענטן געראטן דורך VISION אָדער לייענען זייער סטאַטוס. אַקסעס און קאָמוניקאַציע נעמען אָרט דורך די MQTT פּראָטאָקאָל, וואָס ניצט אַזוי גערופענע טעמעס צו אַדרעס יחיד פאַנגקשאַנז אָדער שטעלט פון פאַנגקשאַנז אָדער צו זיין ינפאָרמד וועגן ענדערונגען צו זיי. אַ MQTT סערווער (מעקלער) איז געניצט פֿאַר דעם צוועק, וואָס כאַנדאַלז זיכערהייט און די פאַרוואַלטונג / פאַרשפּרייטונג פון אַרטיקלען צו די פּאַרטיסאַפּאַנץ. אין דעם פאַל, די MQTT סערווער איז ליגן גלייַך אויף די DIVUS KNX IQ און איז ספּעציעל קאַנפיגיערד פֿאַר דעם צוועק. כאָטש די VISION API קענען אויך זיין געוויינט אָן פּראָגראַממינג וויסן, די פאַנגקשאַנאַליטי איז פּאַסיק פֿאַר אַוואַנסירטע ניצערס.

פּרירעקוואַזאַץ

ווי דערקלערט אין די VISION מאַנואַל, דער אַפּי באַניצער מוזן דורך פעליקייַט ערשטער זיין אַקטיווייטיד אין סדר צו קענען צו נוצן עס, די אַפּי אַקסעס אַרבעט בלויז מיט די אָטענטאַקיישאַן דאַטן פון Api יוזערז. ווי ווייַט ווי די באַניצער רעכט זארגן, די אַקטאַוויישאַן פֿאַר דעם פאַנגקשאַנאַליטי קענען זיין קאַנפיגיערד אָדער אויף אַלע אָדער אויף יחיד עלעמענטן. זען טשאַפּ.0. דאָך, איר אויך דאַרפֿן אַ VISION פּרויעקט אין וואָס די עלעמענטן וואָס איר ווילן צו קאָנטראָלירן פֿון אַרויס זענען גאָר קאַנפיגיערד און די פֿאַרבינדונג צו זיי איז הצלחה טעסטעד. צו קענען אַדרעס יחיד עלעמענטן דורך די API, זייער עלעמענט שייַן מוזן זיין באַוווסט: דאָס איז געוויזן אין די דנאָ פון די עלעמענט סעטטינגס פאָרעם

זיכערהייט

פֿאַר זיכערהייט סיבות, אַפּי אַקסעס איז בלויז מעגלעך לאָוקאַלי (ד"ה נישט דורך די וואָלקן). די זיכערהייט ריזיקירן ווען אַקטאַווייטינג אַפּי אַקסעס איז דעריבער נידעריק. פונדעסטוועגן, זיכערהייט-באַטייַטיק עלעמענטן זאָל ניט זיין ענייבאַלד אָדער בפירוש געלייקנט פֿאַר אַפּי אַקסעס.

MQTT און זייַן טערמינען - קורץ דערקלערונג

• אין MQTT, די ראָלע פון ​​סענטראַלייזד פאַרוואַלטונג און פאַרשפּרייטונג פון אַלע אַרטיקלען איז די מעקלער. כאָטש MQTT סערווער און MQTT מעקלער זענען נישט סינאָנימס (סערווער איז אַ ברייטערער טערמין פֿאַר אַ ראָלע וואָס MQTT קלייאַנץ קענען אויך שפּילן), דער מעקלער איז שטענדיק מענט אין דעם מאַנואַל ווען MQTT סערווער איז דערמאנט. די DIVUS KNX IQ זיך פיעסעס די MQTT מעקלער / MQTT סערווער ראָלע אין דעם קאָנטעקסט פון דעם מאַנואַל.
• אַ MQTT סערווער ניצט אַזוי גערופענע טעמעס: אַ כייעראַרקאַקאַל סטרוקטור מיט וואָס דאַטן זענען קאַטאַגערייזד, געראטן און ארויס.
• פּובלישינג האט די ערשטיק ציל צו מאַכן דאַטן בנימצא צו אנדערע פּאַרטיסאַפּאַנץ דורך טעמעס. אויב איר ווילן צו טוישן אַ ווערט, איר שרייַבן צו דער געוואלט טעמע צוזאַמען מיט די געבעטן ווערט טוישן, אויך ניצן אַ ארויסגעבן קאַמף. דער ציל מיטל אָדער די MQTT סערווער לייענט די געבעטן ענדערונג וואָס אַפעקץ עס און אַדאַפּץ עס אַקאָרדינגלי. צו קאָנטראָלירן אַז די ענדערונג איז געווענדט, איר קענט קוקן אין די סאַבסקרייבד פאַקטיש-צייט טעמע צו זען צי די ענדערונג איז שפיגלט דאָרט - אויב אַלץ איז געווען גוט.
• קלייאַנץ אויסקלייַבן די טעמעס וואָס אינטערעס זיי: דאָס איז גערופן אַבאָנירן. יעדעס מאל ווען א ווערט ענדערט זיך אין/אונטער א טעמע, ווערן אלע אבאנענטירטע קליענטן אינפארמירט - דאס הייסט אן מען דארף בפירוש פרעגן צי עפעס האט זיך געביטן אדער וואס די יעצטיגע ווערט איז.
• איר קענען עפֿענען (אָדער אַדרעס) אַ באַזונדער קאָמוניקאַציע קאַנאַל מיט די MQTT סערווער דורך אַרייַן קיין יינציק שטריקל גערופן client_id אין אַ טעמע. דער client_id מוזן זיין געוויינט אין דער טעמע צו פּראָצעס וואַלועס. דאָס סערוועס צו ידענטיפיצירן די אָנהייב פון יעדער ענדערונג, העלפּס מיט קיין ערראָרס און טוט נישט ווירקן די אנדערע קלייאַנץ, ווייַל די קאָראַספּאַנדינג רעספּאָנסעס פון די סערווער, אַרייַנגערעכנט קיין טעות קאָודז און אַרטיקלען, דערגרייכן די טעמע מיט דער זעלביקער client_id (און אַזוי בלויז דעם קליענט). דער קליענט_יד איז אַ יינציק כאַראַקטער שטריקל וואָס באשטייט פון קיין קאָמבינאַציע פון ​​​​די אותיות 0-9, אַז, אַז, "-", "_".
• אין אַלגעמיין, די אַבאָנירן טעמעס פון די MQTT סערווער פון די DIVUS KNX IQ אַנטהאַלטן די קיווערד סטאַטוס, בשעת די אַרויסגעבן טעמעס אַנטהאַלטן די קיווערד בעטן. יענע מיט סטאַטוס זענען אויטאָמאַטיש דערהייַנטיקט ווי באַלד ווי עס איז אַ פונדרויסנדיק ווערט ענדערונג אָדער ווי באַלד ווי אַ ווערט ענדערונג איז געבעטן דורך דער קליענט זיך דורך אַ אַרויסגעבן און איז הצלחה געווענדט. די פֿאַר ארויסגעבן זענען ווייַטער צעטיילט אין די פון טיפּ (רעקוועסט /) באַקומען און די פון טיפּ (רעקוועסט /) שטעלן.
• ווערט ענדערונגען און אנדערע אַפּשאַנאַל פּאַראַמעטערס זענען מוסיף צו די טעמע מיט די אַזוי גערופענע פּיילאָוד. די פּאַראַמעטערס פון די יחיד עלעמענטן (עלעמענט-שייַן, נאָמען, טיפּ, פאַנגקשאַנז)

דער הויפּט חילוק צווישן MQTT און דער קלאַסיש קליענט-סערווער מאָדעל, ווו דער קליענט ריקוועס און דעמאָלט ענדערונגען דאַטן, איז סענטערד אויף די קאַנסעפּס פון אַבאָנירן און אַרויסגעבן. פּאַרטיסיפּאַנץ קענען אַרויסגעבן דאַטן, מאכן עס בנימצא צו אנדערע, וואָס אויב אינטערעסירט קענען אַבאָנירן צו עס. די אַרקאַטעקטשער מאכט עס מעגלעך צו מינאַמייז דאַטן וועקסל און נאָך האַלטן אַלע אינטערעסירט פּאַרטיעס דערהייַנטיקט. מער וועגן די דעטאַילס דאָ: און ספּעציעל פּאַראַמעטערס (uuid, פילטערס) זאָל זיין געוויינט דאָ. כאָטש עס זענען עטלעכע אָפּציעס, די פּיילאָוד איז געוויזן פאָרמאַטטעד ווי JSON אין דעם מאַנואַל. JSON ניצט בראַקאַץ און קאָממאַס צו פאָרשטעלן דאַטן פון קיין סטרוקטור און אַזוי מינאַמייז די גרייס פון די דאַטן פּאַקיץ צו זיין טראַנסמיטטעד. מער דעטאַילס וועגן פּיילאָודז קענען זיין געפֿונען שפּעטער אין די מאַנואַל.

• פֿאַר ספּעציעלע צוועקן, עס איז מעגלעך צו פילטער לויט דעם טיפּ פון פֿונקציע, למשל צו אַדרעס בלויז אויף / אַוועק, ד"ה 1-ביסל סוויטשיז. די פילטערס פּאַראַמעטער אין די פּיילאָוד איז געניצט פֿאַר דעם צוועק. פֿילטרירונג איז דערווייַל מעגלעך בלויז דורך פֿונקציע טיפּ.
• צו קענען אַדרעסירן יחיד עלעמענטן, זייער עלעמענט ID איז פארלאנגט. דאָס קענען זיין געפֿונען אין VISION אין די עלעמענט פּראָפּערטיעס מעניו אָדער קענען אויך זיין לייענען גלייך פֿון די דאַטן וואָס זענען געוויזן אין פראָנט פון יעדער בנימצא עלעמענט אין דער אַלגעמיין אַבאָנירן פון די MQTT Explorer (עלעמענטן דאָרט זענען ליסטעד אַלפאַבעטיקלי דורך עלעמענט שייַן).

קאָנפיגוראַטיאָן פֿאַר די אַפּי אַקסעס

קאַנפיגיערינג זעאונג פֿאַר אַפּי באַניצער אַקסעס

אין VISION ווי אַ אַדמיניסטראַטאָר, גיין צו קאָנפיגוראַטיאָן - באַניצער/אַפּי אַקסעס מאַנאַגעמענט, דריקט אויף וסערס/אַפּי אַקסעס און רעכט גיט אויף אַפּי באַניצער (אָדער דריקן און האַלטן) צו עפֿענען די עדיטינג פֿענצטער. דאָרט איר וועט געפֿינען די פּאַראַמעטערס און דאַטן

• געבן (טשעקבאָקס)
  • דער באַניצער איז ערשטער ענייבאַלד דאָ. פעליקייַט איז פאַרקריפּלט
• נאמען
  • דער שטריקל איז פארלאנגט פֿאַר אַקסעס דורך אַפּי - נאָכמאַכן עס פֿון דאָ
• שפּריכוואָרט
  • דער שטריקל איז פארלאנגט פֿאַר אַקסעס דורך אַפּי - נאָכמאַכן עס פֿון דאָ
• פּערמישאַנז
  • די פעליקייַט רעכט פֿאַר לייענען און שרייבן די וואַלועס פון די VISION עלעמענטן קענען זיין דיפיינד דאָ, ד"ה וואָס איז דיפיינד דאָ אַפּלייז צו אַלע יגזיסטינג און צוקונפֿט עלעמענטן. אויב איר נאָר ווילן צו לאָזן אַקסעס צו יחיד עלעמענטן, איר זאָל נישט טוישן די פעליקייַט רעכט

פּערמישאַנז אויף יחיד עלעמענטן

עס איז רעקאַמענדיד אַז איר טאָן ניט געבן אַפּי אַקסעס צו די גאנצע פּרויעקט, אָבער בלויז צו די געבעטן עלעמענטן. גיינ ווייַטער ווי גייט

1. קלאָץ אין צו VISION ווי אַ אַדמיניסטראַטאָר
2. סעלעקטירן דעם געוואלט עלעמענט און עפענען זייַן סעטטינגס מעניו (רעכט גיט אָדער האַלטן געדריקט, דעמאָלט סעטטינגס)
3. אונטער די מעניו פּאָזיציע אַלגעמיינע - פּערמישאַנז, אַקטאַווייט "אָוועררייד פעליקייַט פּערמישאַנז" און דעמאָלט גיין צו די סאַב-נומער פּערמישאַנז, וואָס ווייַזן די פּערמישאַנז מאַטריץ.
4. אַקטאַווייט די קאָנטראָל דערלויבעניש דאָ, וואָס אויך ינייבאַלז די view דערלויבעניש גלייַך. אויב איר נאָר ווילן צו לייענען דאַטן דורך די API אַקסעס, עס איז גענוג צו געבן די view דערלויבעניש.
5. איבערחזרן די זעלבע פּראָצעדור פֿאַר אַלע די עלעמענטן איר ווילן צו אַקסעס

קשר דורך MQTT

הקדמה

ווי אַן עקסampמיר וועלן באַווייַזן אַקסעס דורך די MQTT API פון די DIVUS KNX IQ מיט אַ לעפיערעך פּשוט פריי ווייכווארג גערופֿן MQTT Explorer (זען קאַפּיטל 1.1), וואָס איז בארעכטיגט פֿאַר Windows, Mac און Linux. א יקערדיק וויסן און דערפאַרונג מיט MQTT איז ימפּלייד.

דאַטן פארלאנגט פֿאַר די פֿאַרבינדונג

ווי דערמאנט פריער (זען אָפּטיילונג 2.1), די נאמען און פּאַראָל פון די API באַניצער זענען פארלאנגט. דאָ איז אַן איבערview פון אַלע די דאַטן וואָס מוזן זיין געזאמלט איידער אַ קשר איז געגרינדעט:

• נאמען לייענען אויף די דעטאַל בלאַט פון די API באַניצער
• שפּריכוואָרט לייענען אויף די דעטאַל בלאַט פון די API באַניצער
• IP אַדרעס לייענען אין די לאָנטשער סעטטינגס אונטער אַלגעמיינע - נעטוואָרק - עטהערנעט (אָדער דורך סינטשראָניזער)
• פּאָרט 8884 (דעם פּאָרט איז רעזערווירט פֿאַר דעם צוועק)

ערשטער פֿאַרבינדונג מיט MQTT EXPLORER און אַלגעמיינע אַבאָנירן

נאָרמאַללי, MQTT דיסטינגגווישיז צווישן די אַקטיוויטעטן אַבאָנירן און אַרויסגעבן. MQTT Explorer סימפּלאַפייז דעם דורך אויטאָמאַטיש אַבאָנירן צו אַלע פאַראַנען טעמעס (טעמע #) ווען דער ערשטער קשר איז געמאכט. ווי אַ רעזולטאַט, דער בוים וואָס פירט צו אַלע בנימצא עלעמענטן (ד"ה אַפּי באַניצער אַקסעס געגעבן) קענען זיין געזען גלייך אין די לינקס געגנט פון די MQTT Explorer פֿענצטער נאָך אַ געראָטן קשר. צו אַרייַן ווייַטער אַבאָנירן טעמעס אָדער צו פאַרבייַטן די # מיט אַ מער ספּעציפיש טעמע, גיין צו אַוואַנסירטע אין די קשר פֿענצטער. די טעמע געוויזן אויף די אויבערשטער רעכט קוקט עפּעס ווי דאָס:

ווו 7f4x0607849x444xxx256573x3x9x983 איז די אַפּי נאמען און אָבדזשעקץ_ליסט כּולל אַלע די בנימצא עלעמענטן. דאס טעמע איז שטענדיק געהאלטן אַרויף-צו-טאָג ד"ה קיין ווערט ענדערונגען זענען שפיגלט דאָרט אין פאַקטיש-צייט. אויב איר נאָר ווילן צו אַבאָנירן צו יחיד עלעמענטן, אַרייַן די עלעמענט שייַן פון די געבעטן עלעמענט נאָך objects_list/.

באַמערקונג: דעם טיפּ פון אַבאָנירן בעערעך קאָראַספּאַנדז צו די לאָגיק הינטער די KNX באַמערקונגען אַדרעסעס; עס ווייזט די קראַנט סטאַטוס פון די עלעמענטן און קען זיין געוויינט צו קאָנטראָלירן צי די געבעטן ענדערונגען זענען הצלחה געווענדט. אויב איר נאָר ווילן צו לייענען דאַטן אָבער נישט טוישן עס, דעם טיפּ פון אַבאָנירן איז גענוג.

א איין פּשוט עלעמענט קוקט עפּעס ווי דאָס אין JSON נאָוטיישאַן

באַמערקונג: אַלע וואַלועס האָבן די סינטאַקס געוויזן אויבן, למשל {"ווערט": "1"} ווי דער רעזולטאַט פון די אַבאָנירן טעמעס, בשעת די ווערט איז געשריבן גלייַך אין די פּיילאָוד צו טוישן אַ ווערט (ד"ה פֿאַר אַרויסגעבן טעמעס) - די בראַקאַץ און "ווערט" זענען איבערגעהיפּערט, למשל "אָנאָפף": "1".

אַוואַנסירטע באַפֿעלן

הקדמה

עס זענען 3 מינים פון טעמעס אין אַלגעמיין:

1. אַבאָנירן טעמע (s) צו זען די בנימצא עלעמענטן און צו באַקומען פאַקטיש-צייט ווערט ענדערונגען
2. אַבאָנירן טעמע (s) צו באַקומען די ענטפֿערס צו (די קליענטן ) אַרויסגעבן ריקוועס
3. אַרויסגעבן טעמע (s) צו באַקומען אָדער צו שטעלן עלעמענטן מיט זייער וואַלועס

מיר וועלן שפּעטער אָפּשיקן צו די מינים ניצן די נומערינג געוויזן דאָ (למשל טעמעס פון טיפּ 1, 2, 3). מער דעטאַילס אין די פאלגענדע סעקשאַנז און אין קאַפּ. 4.2.

אַבאָנירן טעמעס צו זען די בנימצא עלעמענטן און צו באַקומען פאַקטיש-צייט ווערט ענדערונגען

די זענען שוין דיסקרייבד

אַבאָנירן טעמעס צו באַקומען די ענטפֿערס צו דער קליענט ס אַרויסגעבן ריקוועס

דעם מין פון טעמעס איז אַפּשאַנאַל. עס אַלאַוז צו

• עפֿענען אַ יינציק קאָמוניקאַציע קאַנאַל מיט די MQTT סערווער דורך ניצן אַ אַרביטראַריש client_id. מער וועגן דעם אין קאַפּ. 4.2.2
• באַקומען די רעזולטאַט פון אַרויסגעבן ריקוועס אויף די קאָראַספּאַנדינג אַבאָנירן טעמע: הצלחה אָדער דורכפאַל מיט טעות קאָד און אָנזאָג.

עס זענען פאַרשידענע טעמעס צו באַקומען ענטפֿערס צו באַקומען אָדער צו שטעלן אַרויסגעבן קאַמאַנדז. די קאָראַספּאַנדינג חילוק אין אַמאָל איר באַקומען די נייטיק טעמעס פֿאַר דיין סיסטעם גלייך, איר קען באַשליסן צו באַזייַטיקן דעם שריט און גלייך נוצן אַרויסגעבן טעמעס.

 אַרויסגעבן טעמעס צו באַקומען אָדער צו שטעלן עלעמענטן מיט זייער וואַלועס

די טעמעס נוצן אַ וועג ענלעך צו די אָנעס פֿאַר אַבאָנירן - דער בלויז ענדערונג איז די וואָרט "בעטן" אין פּלאַץ פון די "סטאַטוס" געניצט צו אַבאָנירן. גאַנץ טעמע פּאַטס זענען געוויזן שפּעטער אין קאַפּ. 4.2.2 א באַקומען טעמע וועט בעטן צו לייענען די עלעמענטן און וואַלועס פון די MQTT סערווער. די פּיילאָוד קען זיין גענוצט צו פילטער באזירט אויף די פֿונקציע טיפּ פון די עלעמענטן. א באַשטימט טעמע וועט בעטן צו טוישן עטלעכע טיילן פון אַן עלעמענט, ווי דיטיילד אין זיין פּיילאָוד.

פּרעפיקס פֿאַר קאַמאַנדז און קאָראַספּאַנדינג רעספּאָנסעס

 קורץ דערקלערונג

אַלע קאַמאַנדז וואָס זענען געשיקט צו די MQTT סערווער האָבן אַ פּראָסט ערשט טייל, ניימלי:

דעטאַלירטע דערקלערונג

די פאַקטיש-צייט טעמעס (טיפּ 1) וועט האָבן די אַלגעמיינע פּרעפיקס (זען אויבן) דערנאָך נאכגעגאנגען דורך

or

פֿאַר שטעלן קאַמאַנדז, די פּיילאָוד דאָך פיעסעס די הויפּט ראָלע ווי עס וועט אַנטהאַלטן די געבעטן ענדערונגען (ד"ה געביטן וואַלועס פֿאַר די פאַנגקשאַנז פון די עלעמענט). א ווארענונג: קיינמאָל נוצן די ריטיין אָפּציע אין דיין טיפּ 3 קאַמאַנדז ווייַל דאָס קען פאַרשאַפן ישוז אויף די KNX זייַט.

EXAMPLE: אַרויסגעבן פֿאַר טשאַנגינג די ווערט (S) פון איין עלעמענט

די סימפּלאַסט פאַל איז צו ווילן צו טוישן די ווערט פון איינער פון די עלעמענטן געוויזן דורך די אַלגעמיינע אַבאָנירן.
אין אַלגעמיין, טשאַנגינג / באַשטימען אַ פונקציע פון ​​VISION דורך MQTT באשטייט פון 3 סטעפּס, ניט אַלע פון ​​וואָס זענען לעגאַמרע נייטיק, אָבער מיר נאָך רעקאָמענדירן צו פירן זיי ווי דיסקרייבד.

1. די טעמע וואָס כּולל די פֿונקציע וואָס מיר ווילן צו רעדאַגירן איז אַבאָנירן מיט אַ מנהג client_id
2. די טעמע פֿאַר עדיטינג איז ארויס צוזאַמען מיט די פּיילאָוד מיט די געבעטן ענדערונגען ניצן די client_id אויסדערוויילט אין 1.
3. צו קאָנטראָלירן, איר קענט זען די ענטפער אין די טעמע (1.) - דאָס הייסט צי (2.) געארבעט אָדער נישט
4. אין דער אַלגעמיין אַבאָנירן, ווו אַלע וואַלועס זענען דערהייַנטיקט ווען ענדערונגען זענען געמאכט, איר קענען זען די געבעטן ווערט טוישן (s) אויב אַלץ איז געווען גוט.

די טריט צו טאָן דאָס זענען:

1. אויסקלייַבן אַ client_id, למשל "Divus" און אַרייַנלייגן עס אין די דרך נאָך די API נאמען
   דאָס איז די פולשטענדיק טעמע פֿאַר אַבאָנירן צו דיין אייגענע קאָמוניקאַציע קאַנאַל מיט די MQTT סערווער. דאָס דערציילט די סערווער ווו איר דערוואַרטן די רעספּאָנסעס צו די ענדערונגען וואָס איר ווילט שיקן. באַמערקן די סטאַטוס / שטעלן טייל וואָס דיפיינז אַ. אַז עס איז אַ אַבאָנירן טעמע און ב. אַז עס וועט באַקומען די ענטפֿערס צו שטעלן טיפּ קאַמאַנדז.
2. די אַרויסגעבן טעמע וועט זיין די זעלבע אַחוץ פֿאַר סוויטשינג די טערמינען פון סטאַטוס בעטן
3. פון וואָס די ענדערונג זאָל צונויפשטעלנ זיך איז געשריבן אין די פּיילאָוד. דאָ זענען עטלעכע עקסamples.
   • באַשטימען אַוועק אַן עלעמענט וואָס האט די אויף / אַוועק פונקציע (1 ביסל):
   • באַשטימען אויף אַן עלעמענט וואָס האט די אויף / אַוועק פונקציע (1 ביסל). אין אַדישאַן, אויב עטלעכע אַזאַ קאַמאַנדז זענען סטאַרטעד פֿון דער זעלביקער קליענט, די uuid פּאַראַמעטער ("יינציק שייַן", איז יוזשאַוואַלי אַ 128-ביסל שטריקל פאָרמאַטטעד ווי 8-4-4-4-12 דידזשאַץ העקס) קענען זיין געוויינט צו באַשטימען די ענטפער צו די קאָראַספּאַנדינג אָנפֿרעג, ווי דער פּאַראַמעטער - אויב עס איז פאָרשטעלן אין די אָנפֿרעג - קענען אויך זיין געפֿונען אין דער ענטפער.
   • באַשטימען אויף און באַשטעטיקן די ברייטנאַס פון אַ דיממער צו 50%
   • דער ענטפער צו די טעמע געוויזן און אַבאָנירן צו אויבן (זייַן פּיילאָוד, צו זיין גענוי) איז דעמאָלט, למשלample.
     די אויבן ענטפער איז אַן עקסample אין דעם פאַל פון אַ ריכטיק פּיילאָוד, כאָטש דער עלעמענט האט קיין דימינג פונקציע. אויב עס זענען מער ערנסט פּראָבלעמס וואָס פירן די פּיילאָוד נישט צו זיין ינטערפּראַטאַד ריכטיק, דער ענטפער וועט קוקן ווי דאָס (למשל):
     פֿאַר אַ דערקלערונג פון די טעות קאָודז און אַרטיקלען, אָבער אין אַלגעמיין, ווי פֿאַר http, 200 קאָודז זענען positive ענטפֿערס און 400 זענען נעגאַטיוו.

EXAMPLE: אַרויסגעבן פֿאַר טשאַנגינג קייפל עלעמענטן וואַלועס

דער פּראָצעדור איז ענלעך צו דער געוויזן פריער צו טוישן אַ איין עלעמענט. דער חילוק איז אַז איר פאַרלאָזן די עלעמענט_יד פון די טעמעס און דערנאָך אָנווייַזן די גאַנג פון עלעמענט_ידס אין פראָנט פון די דאַטן אין די פּיילאָוד. זען די סינטאַקס און סטרוקטור אונטן.

פילטער לויט פונקציע טיפּ אין פֿראגן

די פילטערס פּאַראַמעטער אין די פּיילאָוד אַלאַוז בלויז די געבעטן פֿונקציע (s) פון אַן עלעמענט צו זיין אַדרעסד. די אָנ / אַוועק פונקציע פון ​​​​אַ באַשטימען אָדער דיממער איז גערופן "אָנאָפף", למשלample, און די קאָראַספּאַנדינג פילטער איז דיפיינד אין דעם וועג:

דער ענטפֿער זעט אויס ווי דאָס, למשלample

די קוואַדראַט קלאַמער ינדיקייץ אַז איר קענען אויך פילטער דורך עטלעכע פאַנגקשאַנז, למשל

פירט צו אַן ענטפער ווי דאָס:

אַפּפּענדיקס

טעות קאָדעס

ערראָרס אין MQTT קאָמוניקאַציע רעזולטאַט אין אַ נומעריקאַל קאָד. די פאלגענדע טיש העלפט צו ברעכן עס אַראָפּ.

פּאַראַמעטערס פון די פּיילאָוד

די פּיילאָוד שטיצט פאַרשידענע פּאַראַמעטערס דיפּענדינג אויף דעם קאָנטעקסט. די פאלגענדע טיש ווייזט וואָס פּאַראַמעטערס קענען פּאַסירן אין וואָס טעמעס

ווערסיע נאטיצן

• ווערסיע 1.00

נייַעס:

• ערשטער ארויסגעבן