Cómo definir puertos GDS complejos y conectarlos al puerto GDS en código IEC

Resumen

En este artículo explicaré cómo definir puertos GDS complejos como estructuras de datos en C++ y conectarlos al puerto GDS en código IEC.

Estructuras de datos

Cómo declarar estructuras de datos. Veamos C++.

#pragma once
#include "Arp/System/Core/Arp.h"
#include "Arp/Plc/Commons/PlcTypes.h"

namespace MyComponent
{

class MyData
{
public:
    MyData() = default;
    ~MyData() = default;

public:
    Arp::boolean Valid = false;
    Arp::int16 IntegerValue = 0;
    Arp::Plc::Commons::Gds::StaticString<80> StringValue = "";
    Arp::uint8 Data[8] = {0x00};
};

} // namespace MyComponent

Y en el encabezado de la clase de programa, este tipo ahora se puede definir como Puerto GDS.

#pragma once
...
#include "MyData.hpp"

namespace MyComponent
{

//#program
//#component(MyComponent::MyComponent)
class MyProgramm ...
{

...

public:
    //#port
    //#name(TheData)
    //#attributes(Input)
    MyData GdsPortMyData;

};

} // namespace MyComponent

Para poder conectar el puerto GDS a un puerto GDS en código IEC, la variable en el código IEC debe ser del mismo tipo. Esto significa que la estructura IEC debe tener el mismo diseño de datos que el tipo de datos de C++. Además, todos los nombres de los elementos deben coincidir con los elementos del tipo C++.

TYPE

UDT_PROJECT_MY_DATA : STRUCT
    Valid BOOL;
    IntegerValue : INT;
    StringValue : STRING;
    Data : ARRAY [0..7] OF BYTE;
END_STRUCT;

END_TYPE

Un puerto de salida GDS del tipo UDT_PROJECT_MY_DATA ahora se puede conectar al GDS In Port TheData del programa C++.

Nota especial a CADENA

Una nota especial para el tipo de datos STRING. Tenga en cuenta que el código IEC por ahora no reconoce la codificación UTF-8. Los literales de cadena utilizan la codificación ISO-8859-1. Por lo tanto, puede ser necesario convertirlos a UTF-8 antes de compararlos con cadenas literales en código C++. Puede usar la biblioteca boost-locale para convertir de ISO-8859-1 a UTF-8 y viceversa.

Arp::String toUtf8(const Arp::String& s)
{
    return boost::locale::conv::to_utf<char>(s.CStr(), "ISO-8859-1");
}