Modul-Nachrichten zum Engineering (Logging / Tracing)

Übersicht

TwinCAT 3 C++ bietet die Möglichkeit, Nachrichten aus einem C++ Modul in das TwinCAT 3 Engineering als Tracing oder Logging zu senden.

Syntax

Die Syntax zur Aufzeichnung von Meldungen ist folgende:

m_Trace.Log(TLEVEL, FNMACRO"A message", …);

Mit diesen Eigenschaften:

• TLEVEL kategorisiert eine Meldung in eine von fünf Ebenen.
  Das Aufzeichnen der höheren Ebene beinhaltet immer auch das Aufzeichnen der unteren Ebenen: d.h. eine auf Ebene „tlWarning“ klassifizierte Meldung wird auftreten mit Ebene „tlAlways“, „tlError“ und „tlWarning“ - sie wird die „tlInfo“ und „tlVerbose“ Meldungen NICHT aufzeichnen.

• FNMACRO kann verwendet werden, um den Funktionsnamen vor die zu druckende Meldung zu setzen
• FENTERA: Wird beim Eintritt in eine Funktion verwendet, druckt den Funktionsnamen gefolgt von „>>>“.
• FNAMEA: Wird innerhalb einer Funktion verwendet, druckt den Funktionsnamen.
• FLEAVEA: Wird beim Verlassen einer Funktion verwendet, druckt den Funktionsnamen gefolgt von „<<<“.
• Zur Ausgabe von Zeigern und anderen Variablen mit Plattform-spezifischer Größe wird der Formatspezifizierer %q verwendet.

Beispiel

HRESULT CModule1::CycleUpdate(ITcTask* ipTask, ITcUnknown* ipCaller, ULONG_PTR context)
 {
     HRESULT hr = S_OK;

     // Sample to showcase trace logs
     ULONGLONG cnt = 0;
     if (SUCCEEDED(ipTask->GetCycleCounter(&cnt)))
     {
         if (cnt%500 == 0)
             m_Trace.Log(tlAlways, FENTERA "Level tlAlways: cycle= %llu", cnt);

         if (cnt%510 == 0)
             m_Trace.Log(tlError, FENTERA "Level tlError: cycle=%llu", cnt);

         if (cnt%520 == 0)
             m_Trace.Log(tlWarning, FENTERA "Level tlWarning: cycle=%lld", cnt);

         if (cnt%530 == 0)
             m_Trace.Log(tlInfo, FENTERA "Level tlInfo: cycle=%llu", cnt);

         if (cnt%540 == 0)
             m_Trace.Log(tlVerbose, FENTERA "Level tlVerbose: cycle=%llu", cnt);
     }

     // TODO: Replace the sample with your cyclic code
     m_counter++;
     m_Outputs.Value = m_counter;

    return hr;
 }

Verfolgungsebene verwenden

Auf Höhe der Modulinstanz besteht die Möglichkeit, die Verfolgungsebene vorzukonfigurieren.

Alternativ dazu können Sie die Verfolgungsebene auch während der Laufzeit ändern, indem Sie zur Instanz gehen, eine Ebene bei Value für TraceLevelMax-Parameter auswählen, dann einen Rechtsklick vor der ersten Spalte machen und Online Write auswählen.

Meldungskategorien filtern

Visual Studio Error List ermöglicht das Filtern der Einträge nach deren Kategorie. Die drei Kategorien Errors, Warnings und Messages können unabhängig voneinander durch einfaches Umschalten der Tasten aktiviert oder deaktiviert werden.

In diesem Screenshot ist nur Warnings aktiviert - Errors und Messages dagegen sind deaktiviert:

In diesem Screenshot ist nur Messages aktiviert - Errors und Warnings dagegen sind für die Anzeige deaktiviert: