Miscellaneous

Im letzten Tab der Basis-Einstellungen geht es diverse Einstellungen. Der erste Teil geht um die Treiber Versionen, die verwendet werden. Die hier ausgewählte Version (Default: Latest) wird beim Aktivieren der TwinCAT Konfiguration automatisch auf das Zielsystem (Steuerung) heruntergeladen. Das gilt für alle Betriebssysteme unter 4026, wodurch eine zusätzliche Installation in Form von Paketen auf dem Zielsystem selbst entfällt.

Zusätzlich kann hier der Log für die Analytics Logger System Manager Extension eingesehen werden. Der Beckhoff Support könnte Sie im Supportfall auch dazu auffordern diese Datei zur Verfügung zu stellen.

Copy Deployment

Ebenfalls kann eine Art Patch Mechanismus mit dem Copy Deployment aktiviert und konfiguriert werden.

Das Copy Deployment bietet die Möglichkeit, mittels Patch-Dateien, in einem Target Verzeichnis, Änderungen vorzunehmen und nach einem TwinCAT Restart auszuführen. Der folgende Workflow beschreibt die Funktionsweise des Copy Deployments:

Workflow:

Patch-Datei-Format

Jede Config.json enthält:

Symbol hinzufügen

Um ein neues Symbol in den Stream aufzunehmen, einen Eintrag mit Namen, Datentyp und Größe hinzufügen.

Beispiel — MAIN.VarInt64 (8-Byte-Integer) hinzufügen:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "MAIN.VarInt64",
            "TypeName": "LINT",
            "Size": 8
        }
    ]
}

Beispiel — Inputs.Frm0State of a Device (2-Byte-Integer) hinzufügen:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "Inputs.Frm0State",
            "TypeName": "UINT",
            "Size": 2
            "IdxGrp": 61488,
            "IdxOffs": 1520,
        }
    ]
}

Beispiel — Symbole mit BIT-Datentypen hinzufügen:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "MAIN.VarBit1",
            "TypeName": "BIT",
            "Flags": 2,
            "Size": 1
        },
        {
            "Name": "MAIN.VarBit4",
            "TypeName": "BIT",
            "Flags": 2,
            "Size": 4
        }
    ]
}

Beispiel — Pointer hinzufügen:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "MAIN.PtrToInt^",
            "TypeName": "UINT",
            "Size": 2
            "Properties": [
                {
                    "Name": "DataAccess",
                    "Value": "Handle"
                }
            ]
        }
    ]
}

Beispiel — Referenzen hinzufügen:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "MAIN.RefToInt",
            "TypeName": "UINT",
            "Size": 2
            "Properties": [
                {
                    "Name": "DataAccess",
                    "Value": "Handle"
                }
            ]
        }
    ]
}

Symbol deaktivieren

Um ein vorhandenes Symbol zu deaktivieren, wird es per Name referenziert und mit einer Disable-Eigenschaft versehen.

Beispiel — MAIN.VarInt32 deaktivieren:

{
    "InitData": "...",
    "Symbols": [
        {
            "Name": "MAIN.VarInt32",
            "Properties": [
                { "Name": "Disable" }
            ]
        }
    ]
}

Kombiniert (Hinzufügen + Deaktivieren)

Beide Operationen können in einer einzigen Patch-Datei kombiniert werden.

Stream-Konfiguration editieren

Einige Einstellungen der Stream-Konfiguration lassen sich auch über die Patch-Datei editieren. Die Einstellungen sind im Folgenden beschrieben und mit Beispielen erklärt.

Beispiel — MQTT-Ziel aktivieren:

{
    "InitData": "...",
    "Mqtt": {
        "SamplesPerBuffer": 32,
        "CompressionWidth": 8,
        "MqttConfig": {
            "TcpPort": 1883,
            "Host": "127.0.0.1",
            "Topic": "Analytics/Stream1"
        }
    }
}

Beispiel — MQTT-Ziel mit TLS-Verschlüsselung (Zertifikate als Dateipfade):

{
    "InitData": "...",
    "Mqtt": {
        "MqttConfig": {
            "TcpPort": 8883,
            "Host": "broker.example.com",
            "Topic": "Analytics/Stream1",
            "Tls": {
                "Version": "tlsv1.2",
                "CaFile": "C:\\Certs\\ca.crt",
                "CertFile": "C:\\Certs\\client.crt",
                "KeyFile": "C:\\Certs\\client.key",
                "KeyPwd": "secret"
            }
        }
    }
}

Datei-Zielkonfiguration

Beispiel — Datei-Ziel mit Ringpuffer aktivieren:

{
    "InitData": "...",
    "File": {
        "SamplesPerBuffer": 64,
        "BuffersPerFile": 100,
        "FilesInRingBuffer": 10,
        "FilePath": "C:\\DataStore\\FileStreamTarget"
    }
}