Quick Start (C++ / UDP)

Implementierung des UDP Echo Servers in einem C++ Projekt

Das Modul muss das ITcIoUdpProtocolRecv implementieren. Hierdurch wird eine Methode erzeugt, die aufgerufen wird, falls UDP Pakete eintreffen.

Das Modul benötigt einen Interface Pointer zum ITcIoUdpProtocol, welches die Referenz auf das TCP/UDP RT Objekt beinhalten wird.

In der CPP Datei des Moduls (Module1.cpp) muss in der CycleUpdate() Methode die Methode CheckReceived() des TCP/UDP RT Moduls aufgerufen werden. Hierdurch werden eintreffende UDP Pakete per Callback an die implementierte Methode ReceiveData() übergeben.

///<AutoGeneratedContent id="ImplementationOf_ITcCyclic">
HRESULT CModule1::CycleUpdate(ITcTask* ipTask, ITcUnknown* ipCaller, ULONG_PTR context)
{
HRESULT hr = S_OK;
    m_counter+=m_Inputs.Value;
    m_Outputs.Value=m_counter;
    m_spUdpProt->CheckReceived(); // ADDED
    return hr;
}

Die durch die Implementierung des Interfaces angelegte Methode “ReceiveData” wird durch das CheckReceived() mehrfach aufgerufen werden: Für jedes zwischenzeitlich empfangene Paket ein Aufruf.

///<AutoGeneratedContent id="ImplementationOf_ITcIoUdpProtocolRecv">
HRESULT CModule1::ReceiveData(ULONG ipAddr, USHORT udpDestPort, USHORT udpSrcPort, ULONG nData, PVOID pData, ETYPE_VLAN_HEADER* pVlan)
{
    HRESULT hr = S_OK;
    // mirror incomming data
    hr = m_spUdpProt->SendData(ipAddr, udpSrcPort, udpDestPort, nData, pData, true);
    m_Trace.Log(tlInfo, FLEAVEA "UDP ReceiveData: IP: %d.%d.%d.%d udpSrcPort: %d DataSize: %d (hr2=%x) \n", 
         ((PBYTE)&ipAddr)[3], ((PBYTE)&ipAddr)[2], ((PBYTE)&ipAddr)[1], ((PBYTE)&ipAddr)[0], 
        udpSrcPort, nData, hr);
    return hr; 
}
///</AutoGeneratedContent>

Beim Starten und Beenden muss aus der konfigurierten OID eine Referenz auf das „UdpProtocol“ Interface gesetzt werden; entsprechende Freigaben sind beim Runterfahren zu erledigen.

HRESULT CModule1::SetObjStateSO()
{
    HRESULT hr = S_OK;
    //START EDITING
    if (SUCCEEDED(hr) && m_spUdpProt.HasOID())
    {
        m_Trace.Log(tlInfo, FLEAVEA "Register UdpProt");
        if (SUCCEEDED_DBG(hr = m_spSrv->TcQuerySmartObjectInterface(m_spUdpProt)))
        {
            m_Trace.Log(tlInfo, FLEAVEA "Server: UdpProt listen to Port: %d", 10000);
            if (FAILED(hr = m_spUdpProt->RegisterReceiver(10000,
 THIS_CAST(ITcIoUdpProtocolRecv))))
            {
                m_Trace.Log(tlError, FLEAVEA "Server: UdpProtRegisterReceiver failed on Port: %d", 10000);
                m_spUdpProt = NULL;
            }
    }
    }

    // If following call is successful the CycleUpdate method will be
called, 
    // eventually even before method has been left.
    hr = FAILED(hr) ? hr : AddModuleToCaller(); 
    // Cleanup if transition failed at some stage
    if ( FAILED(hr) )
    {
        if (m_spUdpProt != NULL)
            m_spUdpProt->UnregisterReceiver(10000);
        m_spUdpProt = NULL;
        RemoveModuleFromCaller(); 
    }
    //END EDITING
    m_Trace.Log(tlVerbose, FLEAVEA "hr=0x%08x", hr);
    return hr;
}

HRESULT CModule1::SetObjStateOS()
{
    m_Trace.Log(tlVerbose, FENTERA);
    HRESULT hr = S_OK;
    
    if (m_spUdpProt != NULL)
            m_spUdpProt->UnregisterReceiver(10000);
    m_spUdpProt = NULL;
    m_Trace.Log(tlVerbose, FLEAVEA "hr=0x%08x", hr);
    return hr;
}

Abschließend muss das Modul instanziiert und konfiguriert werden

“TCP/UDP RT” Modul Konfiguration

Verbindungsabbruch durch Betriebssystem bei Promiscuous Mode Wenn an dem RT-Ethernet Adapter im Tab „Adapter“ der Promiscuous Mode eingeschaltet ist, werden eintreffende TCP Verbindungsaufbauten durch das Betriebssystem abgebrochen, da dieses einen im TCP/UDP RT Objekt geöffneten Port nicht kennt.

Testing

Nachdem die Konfiguration aktiviert wurde, kann mittels des UDP Sample Clients ein UDP Paket zu dem C++ Modul gesendet werden. Durch aktivieren des entsprechenden TraceLevels (hier mindestens tlInfo; vgl. C++ Tracing) kann eine Ausgabe im Log des Visual Studios erzeugt werden. Der Client zeigt die zurückgesendeten Pakete im oberen Bereich an.

Keine lokale Kommunikation Der UDP Sample Client muss auf einem anderen Rechner laufen als die PLC mit dem TCP/UDP RT Objekt, denn es ist keine lokale Kommunikation von dem Windows Betriebssystem in die Echtzeit möglich. Möglich ist alternativ die Verwendung eines „Loop-Kabels“, welches 2 Netzwerk-Ports verbindet. Der UDP Sample Client kann durch die Auswahl der Quelle (Dropdown „Source“) veranlasst werden einen spezifischen Port zu verwenden.