OPC-UA

Activeu l'add-in OPC-UA

Aquest document us mostrarà com podeu afegir connectivitat OPC-UA a RoboDK. Una connexió OPC UA us permet interactuar amb PLC i altres dispositius que admeten aquest protocol. Hauríeu d'activar l'add-in OPC-UA a RoboDK per afegir funcions de servidor i client OPC UA als vostres projectes.

RoboDK inclou un add-in OPC-UA que us permet afegir compatibilitat OPC UA als vostres projectes de RoboDK.

Per defecte, l'add-in OPC-UA està desactivat a RoboDK. Un cop activat, l'add-in s'hauria de mostrar cada vegada que inicieu RoboDK.

Podeu activar l'add-in OPC UA seguint aquests passos:

1.Seleccioneu Eines-Add-ins.

2.Feu doble clic a OPC-UA.

Hauríeu de veure una barra d'eines addicional amb les funcions de l'OPC-UA.

OPC UA - Imatge 1    OPC UA - Imatge 2

Hauríeu de veure el botó OPC-UA a la barra d'eines i també l'entrada OPC-UA al menú.

OPC UA - Imatge 3

Exemple de servidor OPC UA

En aquest exemple aprendreu com habilitar l'add-in OPC UA i convertir RoboDK en un servidor OPC UA. Navegarem per algunes configuracions utilitzant el programari UaExpert i el Beckhoff TwinCAT3 TF6100.

OPC UA - Imatge 4

Configurar el vostre servidor OPC UA

L'Add-in OPC UA us permet configurar alguns paràmetres, com ara el port del servidor. També podeu triar d'activar el servidor, desactivar-lo o iniciar-lo automàticament amb RoboDK.

Amb l'Add-in OPC UA habilitat, seleccioneu OPC UA - Configuració d'OPC-UA per configurar la vostra configuració d'OPC UA.

La pantalla de configuració d'OPC UA es mostra al costat esquerre, tal com es mostra a la imatge següent.

OPC UA - Imatge 5

OPC UA - Imatge 6

Si veieu un missatge com ara "El servidor OPC UA de RoboDK s'executa al port 4840", vol dir que el servidor OPC UA de RoboDK s'ha iniciat.

Creeu la vostra pròpia estació

Podeu provar la connectivitat OPC UA amb qualsevol estació RoboDK que tingui un o més robots.

OPC UA - Imatge 7

Implementació amb UaExpert

Podeu utilitzar el programari UaExpert per provar la connectivitat amb el servidor OPC UA de RoboDK.

Podeu descarregar la versió gratuïta del programari UaExpert des del lloc web de Unified Automation: https://www.unified-automation.com/downloads/opc-ua-clients.html.

OPC UA - Imatge 8

Afegiu el servidor UaExpert

Inicieu l'UaExpert i feu clic al botó "+" per afegir el servidor OPC UA de RoboDK.

OPC UA - Imatge 9

Expandiu el node Custom Discovery i seleccioneu l'opció <Double clicks to Add Server.> per afegir el servidor OPC UA de RoboDK.

OPC UA - Imatge 10

Introduïu l'URL del servidor OPC UA, opc.tcp://127.0.0.1:48440, que heu configurat a l'etapa anterior.

OPC UA - Imatge 11

Connecteu el servidor OPC UA amb seguretat "None".

OPC UA - Imatge 12

El servidor està configurat.

OPC UA - Imatge 13

Connectar-se al servidor

Ara podeu connectar-vos al servidor OPC UA de RoboDK des de UaExpert.

OPC UA - Imatge 14

Podeu veure els Nodes i els Mètodes quan la connexió s'estableix.

OPC UA - Imatge 15

Nodes del servidor

Hi ha alguns nodes dins del servidor OPC UA de RoboDK que li permeten intercanviar informació bàsica sobre la seva estació.

RoboDK

El node RoboDK és un node que proporciona la versió actual del vostre programari RoboDK.

OPC UA - Imatge 16

S'ha utilitzat la versió RoboDK 64 Bit v5.5.3.23031 en aquest exemple.

OPC UA - Imatge 17

SimulationSpeed

SimulationSpeed és un node que mostra la velocitat de simulació real i permet a l'usuari sobreescriure la velocitat de simulació actual.

OPC UA - Imatge 18

El valor del node fa referència a la barra de desplaçament de la velocitat de simulació.

La simulació actual es pot llegir des d'aquest node i es pot sobreescriure la velocitat de simulació.

OPC UA - Imatge 19

Estació

El node Station és un node que permet a l'usuari obtenir el nom actual de l'estació a RoboDK.

OPC UA - Imatge 20

Com es veu a continuació, el node Station fa referència al vostre "Station Name" a RoboDK.

OPC UA - Imatge 21

Paràmetres de l'estació/Valor de l'estació

El parell de node "Station Parameter" i "Station Value" permet a l'usuari obtenir o establir qualsevol paràmetre dins de la vostra Estació. El servidor OPC UA de RoboDK monitoritzarà contínuament el valor actual de "StationParameter" i retornarà el valor d'aquest "StationParameter" des del node "Station Value".

OPC UA - Imatge 22

Podeu veure els paràmetres de l'estació fent clic amb el botó dret a la vostra estació de RoboDK > Paràmetres de l'estació.

OPC UA - Imatge 23

Al camp Paràmetres constants, podeu veure els paràmetres d'estació predeterminats i el seu valor.

OPC UA - Imatge 24

El paràmetre d'estació es refereix al camp «Parameter» i el valor de l'estació es refereix al camp «Value».

OPC UA - Imatge 25

I podem crear els nostres propis paràmetres fent clic al botó "Add".

OPC UA - Imatge 26

S'afegeix un nou paràmetre d'estació.

OPC UA - Imatge 27

Introduïu el nom del paràmetre i el valor del paràmetre, i després feu clic a Aplica per desar-lo.

OPC UA - Imatge 28

També podeu obtenir el vostre propi paràmetre d'estació.

OPC UA - Imatge 29

Time

El node time és un node que permet obtenir l'hora actual de l'estació RoboDK.

OPC UA - Imatge 30

Es retorna un valor amb format DataTime.

OPC UA - Imatge 31

I aquest node s'actualitza contínuament.

OPC UA - Imatge 32

Mètodes

El servidor RoboDK OPC UA també disposa d'alguns mètodes per permetre a l'usuari accedir dinàmicament a les dades de l'estació RoboDK.

Només cal fer clic amb el botó dret a Method>Call per executar el mètode.

OPC UA - Imatge 33

getItem

getItem és un mètode que permet a l'usuari obtenir el punter del vostre element.

OPC UA - Imatge 34

Per als InputArguments, el nom del dispositiu és obligatori; podeu imaginar que el nom del dispositiu és el nom de la vostra estació, el nom del robot, etc. L'ID de l'element és l'OutputArguments que retorna el punter d'aquest dispositiu.

OPC UA - Imatge 35

En aquest exemple, he rebut l'ID de l'element (punter) del meu robot ABB, que es diu "ABB_RB1".

OPC UA - Imatge 36

Es retorna 0 si el nom de l'element és invàlid o no existeix a la vostra estació.

OPC UA - Imatge 37

getJoints

getJoints és un mètode que permet a l'usuari obtenir el valor de les articulacions del robot des de l'estació, basant-se en l'ID de l'element.

OPC UA - Imatge 38

L'ID d'element és el valor de punter del vostre element i el podeu obtenir mitjançant el mètode getItem().

OPC UA - Imatge 39

Obtindrem l'ID d'element amb aquest nom d'element "ABB_RB1" i es retorna un valor UInt64.

OPC UA - Imatge 40

El valor de les articulacions es retorna en passar l'ID de l'element al mètode que vam obtenir en el pas anterior.

OPC UA - Imatge 41

getJointsStr

getJointsStr és un mètode que permet a l'usuari obtenir el valor de les articulacions basat en un valor de cadena.

OPC UA - Imatge 42

Podem passar el nom del robot (cadena) en aquest mètode.

OPC UA - Imatge 43

A la meva estació, ABB_RB1 és el nom del meu robot.

OPC UA - Imatge 44

Només hem de passar "ABB_RB1" al paràmetre del nom del robot i cridar el mètode: es retorna el valor de les articulacions en format de cadena.

OPC UA - Imatge 45

setJointsStr

setJointsStr és un mètode que permet a l'usuari establir el valor de les articulacions del robot, basat en un valor de cadena.

OPC UA - Imatge 46

En el nom del robot s'hi passa ABB_RB1, i només cal passar una cadena amb el valor de les articulacions al paràmetre Joints.

Per exemple:-0.000000,0.000000,-0.000000,-0.000000,-0.0,-0.000000

OPC UA - Imatge 47

Implementació amb Beckhoff TwinCAT 3

Podeu utilitzar el programari Beckhoff TwinCAT 3 per provar la connectivitat amb el servidor RoboDK OPC UA.

Afegiu el servidor TwinCAT3

Podeu començar creant el client OPC UA seleccionant I/O > Dispositius > Afegeix un element nou.

OPC UA - Imatge 48

Seleccioneu Dispositiu OPC UA virtual a OPC > D'acord.

OPC UA - Imatge 49

S'ha inserit el dispositiu virtual OPC UA.

OPC UA - Imatge 50

Hem d'afegir un client OPC UA per accedir al servidor OPC UA de RoboDK.

Seleccioneu Dispositiu 1 > clic dret > Afegeix un element nou.

OPC UA - Imatge 51

Seleccioneu “OPC UA Client(Module)” i feu clic a D'acord.

OPC UA - Imatge 52

S'ha inserit el client OPC UA.

OPC UA - Imatge 53

Configurar el servidor

Obriu el client OPC UA > Aneu a la pestanya Configuració > feu clic a "Selecciona punt final" per configurar el punt final del servidor OPC UA al qual voleu accedir.

OPC UA - Imatge 54

Introduïu l'URL del servidor OPC UA de RoboDK i actualitzeu-lo.

OPC UA - Imatge 55

Afegiu el mètode del servidor RoboDK

Premeu "Add Nodes" per navegar pel node que es troba dins del servidor OPC UA.

OPC UA - Imatge 56

Si la connexió entre TwinCAT i el servidor OPC UA s'estableix, podeu navegar pels detalls del servidor OPC UA.

OPC UA - Imatge 57

Seleccioneu tots els mètodes i feu clic a OK.

OPC UA - Imatge 58

Els mètodes s'han afegit a la vostra configuració.

OPC UA - Imatge 59

Genera automàticament el mètode RoboDK

Configureu el vostre prefix de nom en aquest camp.

OPC UA - Imatge 60

Premeu "Create Plc Code" per crear el codi PLC des de TwinCAT.

OPC UA - Imatge 61

S'ha creat una carpeta OpcUaClient al vostre projecte i tots els mètodes de RoboDK s'han creat en format de bloc de funcions IEC61131-3.

OPC UA - Imatge 62

Exemple de programa PLC

Aquesta secció mostra un programa d'exemple d'un PLC Beckhoff TwinCAT que es comunica amb el servidor OPC UA de RoboDK.

PROGRAM MAIN

VAR

   bConnected      :BOOL;

   StationPointer  :DINT;

   iStep           :INT;

   bStart          :BOOL;;

   i               :INT;

   TON             :TON;

   bReset          :BOOL;

   bWrite          :BOOL;

   TON2            :TON;

   bShow           :BOOL:=TRUE;

   bVis            :BOOL:=True;

END_VAR

 

VAR

   Robot_name      :STRING(80):='ABB_RB1';

   Item_ID         :ULINT;

   arrJoints       :ARRAY[0..11]OF LREAL;

   strJoints       :STRING(80):='';

   arrJointsFromStr:ARRAY[1..11]OF LREAL;

   sSeparator      :STRING(1) := ',';

   arrJointsCommand:ARRAY[1..11]OF LREAL;

   strJointsCommand:STRING(80);

END_VAR

 

VAR CONSTANT

   cStepWaitCmd          :INT:=0;

   cStepInit             :INT:=5;

   cStepGetItem          :INT:=10;

   cStepGetItemReset     :INT:=20;

   cStepGetItemError     :INT:=990;

  

   cStepGetJoints        :INT:=30;

   cStepGetJointsReset   :INT:=40;

   cStepGetJointsError   :INT:=991;

  

   cStepGetJointsStr     :INT:=50;

   cStepGetJointsStrReset:INT:=60;

   cStepGetJointsStrError:INT:=992;

  

   cStepSetJointStrDelay :INT:=69;

   cStepSetJointsStr     :INT:=70;

   cStepSetJointsStrReset:INT:=80;

   cStepSetJointsStrError:INT:=993;

  

   cStepEnd              :INT:=300;

   cStepWaitReset        :INT:=999;

END_VAR

 

 

VAR

      aSplit        :ARRAY[1..11] OF STRING(80);

      bResultSplit  :BOOL;

        debug      :BOOL;

     URL              :STRING:='http://192.168.3.42:8091';

END_VAR

bConnected:=OPCUA_VirtualClient_RoboDK_Station.bConnected;

 

CASE iStep OF

  

 

   cStepWaitCmd:

        IF bStart THEN

              iStep:=cStepInit;

              bStart:=FALSE;

        END_IF

  

   cStepInit:

 

        StationPointer:=0;

        FOR i :=1 TO 11 DO

              arrJoints[i]:=0.0;

              arrJointsFromStr[i]:=0.0;

              aSplit[i]:='';

        END_FOR

        IF NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bBusy

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJoints.bBusy

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJoints.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bBusy

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.setJoints.bBusy

              AND NOT OPCUA_VirtualClient_RoboDK_Station.setJoints.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bBusy

              AND NOT OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bError

              THEN

              iStep:=cStepGetItem;

        END_IF

        iStep:=cStepGetItem;

  

   cStepGetItem:

 

        IF OPCUA_VirtualClient_RoboDK_Station.getItem.bDone THEN

              iStep:=cStepGetItemReset;

        Item_ID:=OPCUA_VirtualClient_RoboDK_Station.getItem.Item_ID;

        ELSIF OPCUA_VirtualClient_RoboDK_Station.getItem.bError THEN

              iStep:=cStepGetItemError;

        END_IF

       

   cStepGetItemReset:

 

        IF NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bBusy

              THEN

              iStep:=cStepGetJoints;

        END_IF

   cStepGetJoints:

 

        IF OPCUA_VirtualClient_RoboDK_Station.getJoints.bDone

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJoints.bBusy

              THEN

              iStep:=cStepGetJointsReset;

        ELSIF OPCUA_VirtualClient_RoboDK_Station.getJoints.bError THEN

              iStep:=991;

        END_IF

       

   cStepGetJointsReset:

 

        IF NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getItem.bBusy

       

              THEN

              iStep:=cStepGetJointsStr;

        END_IF;

       

   cStepGetJointsStr:

 

        IF OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bDone

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bBusy

              THEN

              iStep:=cStepGetJointsStrReset;

        ELSIF OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bError THEN

              iStep:=cStepGetJointsStrError;

        END_IF         

 

   cStepGetJointsStrReset:

 

        IF NOT OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.getJointsStr.bBusy

             THEN

                   iStep:=cStepSetJointStrDelay;

        END_IF;

       

   cStepSetJointStrDelay:

        strJointsCommand:=''; strJointsCommand:=CONCAT(LREAL_TO_STRING(arrJointsCommand[1]),strJointsCommand);

      strJointsCommand:=CONCAT(strJointsCommand,',');

   strJointsCommand:=CONCAT(strJointsCommand,LREAL_TO_STRING(arrJointsCommand[2]));

      strJointsCommand:=CONCAT(strJointsCommand,',');

   strJointsCommand:=CONCAT(strJointsCommand,LREAL_TO_STRING(arrJointsCommand[3]));

      strJointsCommand:=CONCAT(strJointsCommand,',');

   strJointsCommand:=CONCAT(strJointsCommand,LREAL_TO_STRING(arrJointsCommand[4]));

      strJointsCommand:=CONCAT(strJointsCommand,',');

   strJointsCommand:=CONCAT(strJointsCommand,LREAL_TO_STRING(arrJointsCommand[5]));

      strJointsCommand:=CONCAT(strJointsCommand,',');

   strJointsCommand:=CONCAT(strJointsCommand,LREAL_TO_STRING(arrJointsCommand[6]));

        TON2(IN:=TRUE,PT:=T#0.2S);

        IF TON2.Q THEN

              TON2(IN:=FALSE);

              iStep:=cStepSetJointsStr;

        END_IF

  

   cStepSetJointsStr:

 

       

        IF (

        OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bDone

              AND NOT   

        OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bBusy

         )

              OR NOT bWrite

              THEN

              iStep:=cStepSetJointsStrReset;

        ELSIF OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bError           

          THEN

              iStep:=cStepSetJointsStrError;

        END_IF    

             

   cStepSetJointsStrReset:

        bWrite:=FALSE;

         OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bExecute:=FALSE;

        IF NOT OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bError

              AND NOT OPCUA_VirtualClient_RoboDK_Station.setJointsStr.bBusy

              THEN

              iStep:=cStepEnd;

        END_IF;

       

   cStepEnd:

        TON(IN:=TRUE,PT:=T#0.1S);

        IF TON.Q THEN

              TON(IN:=FALSE);

              IF NOT debug THEN

                   iStep:=10;

              ELSE

                   iStep:=cStepSetJointStrDelay;

              END_IF;

        END_IF

       

   cStepGetItemError:

        Item_ID:=0;

        iStep:=cStepWaitReset;

  

   cStepGetJointsError:

        FOR i :=0 TO 11 DO

              arrJoints[i]:=-99999.99;

        END_FOR

        iStep:=cStepWaitReset;

       

   cStepGetJointsStrError:

        strJoints:='';

        iStep:=cStepWaitReset;

       

   cStepWaitReset:

        IF bReset THEN

              iStep:=cStepInit;

              bReset:=FALSE;

        END_IF;   

END_CASE

 

aSplit[1] := strJoints;

 

FOR i:=1 TO 7 DO

    bResultSplit := FindAndSplit(

   pSeparator  := ADR(sSeparator)

   ,pSrcString := ADR(aSplit[i])

   ,pLeftString:= ADR(aSplit[i])

   ,nLeftSize  := SIZEOF(aSplit[i])

   ,pRightString:= ADR(aSplit[i+1])

   ,nRightSize := SIZEOF(aSplit[i+1])

   ,bSearchFromRight := FALSE );

    IF NOT bResultSplit THEN

        EXIT;

    END_IF

END_FOR

 

FOR i :=1 TO 6 DO

   arrJointsFromStr[i]:=STRING_TO_LREAL(aSplit[i]);

END_FOR;

 

//

OPCUA_VirtualClient_RoboDK_Station.getItem(

bExecute:=iStep=cStepGetItem

,Item_Name:=Robot_name

);

 

 

OPCUA_VirtualClient_RoboDK_Station.getJoints(

bExecute:=iStep=cStepGetJoints

,Item_ID:=Item_ID,Joints=>arrJoints

);

 

 

OPCUA_VirtualClient_RoboDK_Station.getJointsStr(

bExecute:=iStep=cStepGetJointsStr

,Robot_name:=Robot_name,Joints=>strJoints

);

 

IF bWrite THEN

OPCUA_VirtualClient_RoboDK_Station.setJointsStr(

   bExecute:=TRUE

   ,Robot_name:=Robot_name,Joints:=strJointsCommand);

END_IF;

Exemple de client OPC-UA

Aquest exemple us mostrarà com podeu afegir connectivitat de client OPC-UA a RoboDK. RoboDK inclou un Add-in OPC-UA que us permet afegir compatibilitat OPC UA als vostres projectes de RoboDK.

En aquest exemple aprendreu com obtenir les dades de l'estació de RoboDK mitjançant el client OPC UA.

OPC UA - Imatge 63

Es mostra la pantalla de paràmetres de l'estació i premeu "Clear All" per esborrar tots els paràmetres de l'estació.

OPC UA - Imatge 64

Implementació amb interfície

Podem crear un altre projecte RoboDK on el servidor OPC UA està configurat i iniciat.

OPC UA - Imatge 65

Afegir un client

Aquesta secció mostra com afegir un client OPC UA.

Introduïu l'URL de punt final, per exemple: opc.tcp://127.0.0.1:48441.

Cal que la configuració de l'adreça IP i el port coincideixi amb la del servidor OPC UA de destinació.

OPC UA - Imatge 66

Premeu "Connectar" per establir la connexió.

Si apareix un missatge que diu "S'han recuperat les variables del servidor. Feu clic amb el botó dret a l'element de l'estació i seleccioneu 'Paràmetres de l'estació' per veure les variables.", la connexió s'ha establert.

OPC UA - Imatge 67

Feu clic amb el botó dret a la vostra estació i seleccioneu "Paràmetres de l'estació".

OPC UA - Imatge 68

Nodes de client

Podeu comprovar els detalls de cada node a la secció de nodes.

OPC UA - Imatge 69

Implementació amb l'API de RoboDK

Després d'obtenir les dades dels nodes del servidor OPC UA mitjançant el client OPC UA a RoboDK, també podeu obtenir aquestes dades utilitzant la RoboDK-Python-API.

Instal·lació

Podeu consultar aquest enllaç per instal·lar la RoboDK Python-API.

https://robodk.com/doc/en/PythonAPI/intro.html#how-to-install

O instal·leu manualment el paquet robodk per a Python:

pip install robodk

Script

Aquest script d'exemple mostra com obtenir els paràmetres de l'estació mitjançant l'API de Python de RoboDK.

from robodk import robolink    # RoboDK API

 

RDK = robolink.Robolink()

 

from robodk import *      # RoboDK API

from robolink import *    # Robot toolbox

itemlist = RDK.ItemList()

if itemlist:

    # Get all Station Parameters

    print('Valid Parameters are configured in your Station.')

    StationParameters=RDK.getParams()

    for StationParameter in StationParameters:

        print("Station Parameters %s : %s"%(StationParameter[0],str((StationParameter[1]))))

else:

    print('No Parameter list..')

Aquí teniu el resultat de l'exemple de script:

Valid Parameters are configured in your Station.

Station Parameters RoboDK : RoboDK 64 bit v5.5.3.23031

Station Parameters time : 02/14/2023 03:58:29.191.000.000

Station Parameters SimulationSpeed : 13.8551

Station Parameters Station : MyTestStation