CXMM Message Management Library: Effizientes HMI-Messaging für IEC-61131-PLC-Applikationen

Einführung

Die CXMM_MessageManagement-Bibliothek stellt Funktionen bereit, um Informations-, Warn-, Fehler- und andere Meldungen aus dem Applikationsprogramm auf dem HMI anzuzeigen. Das Design orientiert sich an der PLCnext WBM-Benachrichtigungsanzeige.

Erste-Schritte-Beispiel

Nachrichtentext in PLC-Variable udtTextBuffer setzen

Empfehlung: Nachrichtentexte in CSV-Datei speichern und FB PBCL_FileCsvRead aus der PLCnextBase-Library nutzen, um Daten in die PLC-Variable zu schreiben.

Text für Sender-Spalte setzen

Parameter: uiSender > 0, wCode = 0, wAddCode = 0

CXMM_udtMessageMgr.udtTextBuffer.arrText[0].uiSender := 12345;
CXMM_udtMessageMgr.udtTextBuffer.arrText[0].wCode := WORD#16#0;
CXMM_udtMessageMgr.udtTextBuffer.arrText[0].wAddCode := WORD#16#0;
CXMM_udtMessageMgr.udtTextBuffer.arrText[0].strText := 'My_FB';

Text für Nachrichten-Spalte setzen

Parameter: uiSender > 0, wCode > 0, wAddCode > 0

CXMM_udtMessageMgr.udtTextBuffer.arrText[1].uiSender := 12345;
CXMM_udtMessageMgr.udtTextBuffer.arrText[1].wCode := WORD#16#8001;
CXMM_udtMessageMgr.udtTextBuffer.arrText[1].wAddCode := WORD#16#1001;
CXMM_udtMessageMgr.udtTextBuffer.arrText[1].strText := 'Not in position';

Beispiel: PBCL_FileCsvRead FB nutzen

PBCL_FileCsvRead(
    uiOffset := UINT#1,
    strFileName := strFileNameFileCsvRead,
    strDataTypes := 'UINT;WORD;WORD;STRING',
    strDelimiter := ';',
    udiRowCnt => udiRowCntFileCsvRead,
    anyTable := CXMM_udtMessageMgr.udtTextBuffer.arrText
);

Funktionsbaustein CXMM_MessageManager instanziieren

CXMM_MessageManager(udtMessageMgr := CXMM_udtMessageMgr);

HMI-Symbol CXMM_MessageDisplay instanziieren

Mit dem CXMM_MessageManager-Funktionsbaustein verbinden.

Funktionsbaustein CXMM_SendMessage instanziieren

CXMM_SendMessage_11(
    xSend := xSend,
    uiSender := UINT#12345,
    uiSenderType := UINT#0,
    wCode := WORD#1,
    wAddCode := WORD#0,
    enSeverity := CXMM_enSeverity#Error,
    udtMessageMgr := CXMM_udtMessageMgr
);

CXMM_MessageDisplay zeigt Nachrichtentext

Library herunterladen: GitHub Repository