{"id":1305,"date":"2026-11-17T09:44:36","date_gmt":"2026-11-17T12:44:36","guid":{"rendered":"https:\/\/www.pascalscada.com\/?page_id=1305"},"modified":"2026-11-17T09:44:36","modified_gmt":"2026-11-17T12:44:36","slug":"opc-ua","status":"publish","type":"page","link":"https:\/\/www.pascalscada.com\/pb\/opc-ua\/","title":{"rendered":"Cliente OPC UA"},"content":{"rendered":"<h5>Introdu\u00e7\u00e3o<\/h5>\n<p><img decoding=\"async\" src=\"https:\/\/www.pascalscada.com\/wp-content\/uploads\/2026\/11\/TOPCUADriver.png\" alt=\"\" \/> O <code>TOPCUADriver<\/code> \u00e9 um <strong>cliente OPC UA<\/strong>. Ele l\u00ea e escreve as vari\u00e1veis de qualquer servidor OPC UA: o servidor do S7-1200\/1500 e do PLCSim, o servidor embutido em CLPs de outras marcas, um gateway OPC UA, um SCADA que publica os seus tags ou um servidor feito com a open62541.<\/p>\n<p>O protocolo em si fica por conta da <strong>open62541 1.5<\/strong> (a biblioteca em C), atrav\u00e9s do binding Pascal <a href=\"https:\/\/github.com\/fluisgirardi\/fpopen62541\">fpopen62541<\/a>, que vem junto com o PascalSCADA em <code>src\/external\/fpopen62541<\/code>. A biblioteca \u00e9 carregada em tempo de execu\u00e7\u00e3o, s\u00f3 na primeira conex\u00e3o: um programa que n\u00e3o usa o driver n\u00e3o precisa dela.<\/p>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Servidores<\/td>\n<td>qualquer servidor OPC UA acess\u00edvel por <code>opc.tcp:\/\/<\/code><\/td>\n<\/tr>\n<tr>\n<td>Endere\u00e7amento<\/td>\n<td>o NodeId da vari\u00e1vel: <code>ns=3;s=\"DB1\".\"Speed\"<\/code>, <code>nsu=urn:meu:servidor;i=1001<\/code><\/td>\n<\/tr>\n<tr>\n<td>Valores<\/td>\n<td>por subscri\u00e7\u00e3o (o servidor avisa as mudan\u00e7as) ou por leitura peri\u00f3dica em lotes<\/td>\n<\/tr>\n<tr>\n<td>Seguran\u00e7a<\/td>\n<td>None, Sign, SignAndEncrypt; an\u00f4nimo ou usu\u00e1rio\/senha<\/td>\n<\/tr>\n<tr>\n<td>Tag Builder<\/td>\n<td>navega pelo servidor e cria os tags<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<blockquote><p><strong>Um driver fala com um servidor.<\/strong> Para ler dois servidores, use dois <code>TOPCUADriver<\/code>.<\/p><\/blockquote>\n<h5>Componentes necess\u00e1rios<\/h5>\n<ol>\n<li>Um <strong><code>TOPCUADriver<\/code><\/strong> (unit <code>OPCUADriver<\/code>) com <code>EndpointUrl<\/code> = endere\u00e7o do servidor, por exemplo <code>opc.tcp:\/\/192.168.0.10:4840<\/code>. A 4840 \u00e9 a porta padr\u00e3o do OPC UA. N\u00e3o h\u00e1 componente de porta de comunica\u00e7\u00e3o: a pr\u00f3pria biblioteca abre a conex\u00e3o.<\/li>\n<li>Os tags (<code>TPLCTagNumber<\/code>, <code>TPLCBlock<\/code>, <code>TPLCString<\/code>) com <code>ProtocolDriver<\/code> apontando para o driver e <code>LongAddress<\/code> com o NodeId da vari\u00e1vel (veja <em>Endere\u00e7amento<\/em>).<\/li>\n<li>A biblioteca <strong>open62541 1.5<\/strong> na m\u00e1quina que roda o programa (veja a pr\u00f3xima se\u00e7\u00e3o).<\/li>\n<\/ol>\n<p>O jeito mais r\u00e1pido de chegar ao passo 2 \u00e9 o <strong>Tag Builder<\/strong> (veja abaixo), que navega pelo servidor e cria os tags.<\/p>\n<h5>A biblioteca open62541<\/h5>\n<p>O driver precisa da open62541 <strong>1.5<\/strong> compilada como biblioteca compartilhada e com criptografia (<code>UA_ENABLE_ENCRYPTION=OPENSSL<\/code>); uma biblioteca de outra vers\u00e3o, ou sem criptografia, \u00e9 recusada ao carregar, com uma mensagem dizendo o motivo.<\/p>\n<ul>\n<li><strong>Linux:<\/strong> compile a partir dos fontes e instale no sistema:<\/li>\n<\/ul>\n<pre><code>git clone --branch v1.5.10 --recurse-submodules https:\/\/github.com\/open62541\/open62541.git\r\ncmake -S open62541 -B open62541\/build -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON \\\r\n      -DUA_ENABLE_ENCRYPTION=OPENSSL\r\ncmake --build open62541\/build -j\r\nsudo cmake --install open62541\/build &amp;&amp; sudo ldconfig\r\n<\/code><\/pre>\n<ul>\n<li><strong>Windows:<\/strong> a <code>libopen62541.dll<\/code>, com a mesma quantidade de bits do programa, na pasta do execut\u00e1vel (e na do <code>lazarus.exe<\/code> para usar o Tag Builder na IDE). O workflow <code>BuildOpen62541v1.5.yml<\/code> do fpopen62541 a compila para Win32 e x64 com o OpenSSL dentro dela, ent\u00e3o nenhuma DLL do OpenSSL \u00e9 necess\u00e1ria.<\/li>\n<\/ul>\n<p>Com <code>LibraryName<\/code> vazio, o driver procura a biblioteca nesta ordem: o nome do sistema (<code>libopen62541.so<\/code> \/ <code>libopen62541.dll<\/code>), <code>libopen62541.so.1.5<\/code> (Linux) e os mesmos nomes na pasta do execut\u00e1vel \u2014 assim a biblioteca pode ir junto com a aplica\u00e7\u00e3o. <code>LibraryName<\/code> com um caminho ou um nome pula a busca. Quando nada \u00e9 encontrado, <code>LastError<\/code> lista todos os lugares tentados.<\/p>\n<h5>Preparando o servidor<\/h5>\n<p>Num <strong>S7-1200\/1500<\/strong> (ou PLCSim Advanced), no TIA Portal:<\/p>\n<ol>\n<li>Propriedades da CPU \u2192 <em>OPC UA<\/em> \u2192 <em>Server<\/em>: marque <em>Activate OPC UA server<\/em>. O endpoint mostrado ali \u00e9 o <code>EndpointUrl<\/code> (porta 4840 por padr\u00e3o). A CPU tamb\u00e9m precisa de uma licen\u00e7a de runtime OPC UA selecionada em <em>Runtime licenses<\/em>.<\/li>\n<li>S\u00f3 as vari\u00e1veis marcadas como <em>Accessible from HMI\/OPC UA<\/em> (e <em>Writable from HMI\/OPC UA<\/em> para escrever) s\u00e3o publicadas.<\/li>\n<li><em>Server<\/em> \u2192 <em>Security<\/em>: as pol\u00edticas de seguran\u00e7a que o servidor aceita e se o acesso de convidado (an\u00f4nimo) est\u00e1 habilitado. Sem <em>No security<\/em> na lista, o driver precisa usar Sign ou SignAndEncrypt, e o servidor precisa confiar no certificado do cliente (veja <em>Seguran\u00e7a<\/em>).<\/li>\n<\/ol>\n<p>Os NodeIds das vari\u00e1veis de uma CPU Siemens t\u00eam a forma <code>ns=3;s=\"DB1\".\"Speed\"<\/code> \u2014 com as aspas.<\/p>\n<h5>Propriedades do driver<\/h5>\n<table>\n<thead>\n<tr>\n<th>Propriedade<\/th>\n<th>Padr\u00e3o<\/th>\n<th>Descri\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>EndpointUrl<\/code><\/td>\n<td>\u2013<\/td>\n<td>Endere\u00e7o do servidor, <code>opc.tcp:\/\/host:porta<\/code>.<\/td>\n<\/tr>\n<tr>\n<td><code>Username<\/code> \/ <code>Password<\/code><\/td>\n<td>vazio<\/td>\n<td><code>Username<\/code> vazio: sess\u00e3o an\u00f4nima.<\/td>\n<\/tr>\n<tr>\n<td><code>SecurityMode<\/code><\/td>\n<td><code>osmNone<\/code><\/td>\n<td><code>osmNone<\/code>, <code>osmSign<\/code> (assinado) ou <code>osmSignAndEncrypt<\/code> (assinado e criptografado).<\/td>\n<\/tr>\n<tr>\n<td><code>SecurityPolicy<\/code><\/td>\n<td><code>ospAuto<\/code><\/td>\n<td><code>ospAuto<\/code> pega a melhor que o servidor oferece para o modo; ou uma fixa: <code>ospBasic256Sha256<\/code>, <code>ospAes128Sha256RsaOaep<\/code>, <code>ospAes256Sha256RsaPss<\/code>, <code>ospBasic256<\/code>, <code>ospBasic128Rsa15<\/code>.<\/td>\n<\/tr>\n<tr>\n<td><code>CertificateFile<\/code> \/ <code>PrivateKeyFile<\/code><\/td>\n<td>vazio<\/td>\n<td>Certificado e chave do cliente (DER ou PEM). Vazio: um \u00e9 gerado na primeira conex\u00e3o segura e guardado em <code>CertificateDir<\/code>.<\/td>\n<\/tr>\n<tr>\n<td><code>CertificateDir<\/code><\/td>\n<td>pasta de configura\u00e7\u00e3o da aplica\u00e7\u00e3o + <code>opcua-pki<\/code><\/td>\n<td>Onde o certificado gerado fica: <code>own\/pascalscada-client.der<\/code> e <code>private\/pascalscada-client.key<\/code>.<\/td>\n<\/tr>\n<tr>\n<td><code>TrustListDir<\/code><\/td>\n<td>vazio<\/td>\n<td>Pasta com os certificados (<code>.der<\/code>, <code>.pem<\/code>, <code>.crt<\/code>, <code>.cer<\/code>) dos servidores confi\u00e1veis. <strong>Vazia aceita qualquer servidor.<\/strong><\/td>\n<\/tr>\n<tr>\n<td><code>ApplicationUri<\/code> \/ <code>ApplicationName<\/code><\/td>\n<td><code>urn:pascalscada:opcua:client<\/code> \/ <code>PascalSCADA OPC UA Client<\/code><\/td>\n<td>Como o cliente se apresenta. A URI vai no certificado gerado.<\/td>\n<\/tr>\n<tr>\n<td><code>AllowUnencryptedPassword<\/code><\/td>\n<td><code>False<\/code><\/td>\n<td>Deixa a senha passar num canal sem criptografia (<code>osmNone<\/code>). Mantenha desligado fora de testes.<\/td>\n<\/tr>\n<tr>\n<td><code>Timeout<\/code><\/td>\n<td>5000<\/td>\n<td>Tempo limite de uma requisi\u00e7\u00e3o, em ms.<\/td>\n<\/tr>\n<tr>\n<td><code>SessionTimeout<\/code><\/td>\n<td>60000<\/td>\n<td>Tempo de vida da sess\u00e3o pedido ao servidor, em ms.<\/td>\n<\/tr>\n<tr>\n<td><code>ReconnectInterval<\/code><\/td>\n<td>3000<\/td>\n<td>Espera entre duas tentativas de conex\u00e3o, em ms.<\/td>\n<\/tr>\n<tr>\n<td><code>UseSubscriptions<\/code><\/td>\n<td><code>True<\/code><\/td>\n<td>Valores por subscri\u00e7\u00e3o; <code>False<\/code> l\u00ea os tags periodicamente (veja <em>Subscri\u00e7\u00e3o ou leitura peri\u00f3dica<\/em>).<\/td>\n<\/tr>\n<tr>\n<td><code>PublishingInterval<\/code><\/td>\n<td>100<\/td>\n<td>De quanto em quanto tempo, em ms, o servidor manda as mudan\u00e7as da subscri\u00e7\u00e3o.<\/td>\n<\/tr>\n<tr>\n<td><code>MaxItemsPerRequest<\/code><\/td>\n<td>500<\/td>\n<td>M\u00e1ximo de vari\u00e1veis numa requisi\u00e7\u00e3o de leitura, escrita ou de itens monitorados; mais que isso \u00e9 dividido em v\u00e1rias requisi\u00e7\u00f5es.<\/td>\n<\/tr>\n<tr>\n<td><code>LibraryName<\/code><\/td>\n<td>vazio<\/td>\n<td>Nome ou caminho da biblioteca; vazio faz a busca (veja acima).<\/td>\n<\/tr>\n<tr>\n<td><code>LogLevel<\/code> \/ <code>OnLog<\/code><\/td>\n<td><code>ollWarning<\/code><\/td>\n<td>Mensagens do driver e da biblioteca. O <code>OnLog<\/code> \u00e9 chamado pelas threads do driver: n\u00e3o mexa no form dentro dele.<\/td>\n<\/tr>\n<tr>\n<td><code>ReadOnly<\/code><\/td>\n<td><code>False<\/code><\/td>\n<td>Nenhuma escrita chega ao servidor.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>M\u00e9todos: <code>Connected<\/code>, <code>LastError<\/code>, <code>ListTags<\/code>, <code>Browse<\/code>, <code>GetVariableInfo<\/code>, <code>GetServerCertificates<\/code>, <code>GetClientCertificate<\/code> (veja <em>Navegando por c\u00f3digo<\/em>).<\/p>\n<h5>Endere\u00e7amento<\/h5>\n<p>O <code>LongAddress<\/code> \u00e9 o <strong>NodeId<\/strong> da vari\u00e1vel, em texto:<\/p>\n<pre><code>ns=3;s=\"DB1\".\"Speed\"                   \/\/ \u00edndice do namespace + identificador texto (Siemens)\r\nns=2;i=1001                            \/\/ identificador num\u00e9rico\r\nns=2;g=09087e75-8e5e-499b-954f-f2a9603db28a   \/\/ GUID\r\nnsu=http:\/\/www.siemens.com\/simatic-s7-opcua;s=\"DB1\".\"Speed\"   \/\/ URI do namespace\r\n<\/code><\/pre>\n<p>O <code>ns=<\/code> usa o \u00edndice do namespace no servidor; o <code>nsu=<\/code> usa a URI dele, que n\u00e3o muda se o servidor reordenar os namespaces \u2014 o Tag Builder escreve <code>nsu=<\/code> por padr\u00e3o. O namespace 0 \u00e9 o padr\u00e3o do OPC UA: <code>i=2258<\/code> \u00e9 a hora atual do servidor.<\/p>\n<p>Um <code>|<\/code> seguido de um <strong>IndexRange<\/strong> escolhe elementos de um array: <code>ns=3;s=\"DB1\".\"Arr\"|4<\/code> \u00e9 o elemento 4, <code>ns=3;s=\"DB1\".\"Arr\"|0:9<\/code> os dez primeiros. Os \u00edndices come\u00e7am em 0, quaisquer que sejam os limites do array no programa do CLP.<\/p>\n<h5>Tags e tipos<\/h5>\n<p>O servidor informa o tipo de cada vari\u00e1vel, ent\u00e3o o pr\u00f3prio driver converte o valor: deixe <code>TagType = pttDefault<\/code>, sem swaps nem truques de escala.<\/p>\n<table>\n<thead>\n<tr>\n<th>Tipo OPC UA<\/th>\n<th>Tag<\/th>\n<th>Valor<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Boolean<\/td>\n<td><code>TPLCTagNumber<\/code><\/td>\n<td>0 \/ 1; escrever qualquer valor diferente de 0 escreve <code>true<\/code><\/td>\n<\/tr>\n<tr>\n<td>SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64<\/td>\n<td><code>TPLCTagNumber<\/code><\/td>\n<td>o n\u00famero. Inteiros de 64 bits acima de 2^53 perdem precis\u00e3o (o valor do tag \u00e9 um Double).<\/td>\n<\/tr>\n<tr>\n<td>Float, Double<\/td>\n<td><code>TPLCTagNumber<\/code><\/td>\n<td>o n\u00famero<\/td>\n<\/tr>\n<tr>\n<td>DateTime<\/td>\n<td><code>TPLCTagNumber<\/code><\/td>\n<td>um <code>TDateTime<\/code> na hora local (formate com <code>FormatDateTime<\/code>)<\/td>\n<\/tr>\n<tr>\n<td>Enumera\u00e7\u00e3o, StatusCode<\/td>\n<td><code>TPLCTagNumber<\/code><\/td>\n<td>o valor num\u00e9rico<\/td>\n<\/tr>\n<tr>\n<td>array de qualquer um acima<\/td>\n<td><code>TPLCBlock<\/code> (<code>Size<\/code> = n\u00famero de elementos)<\/td>\n<td>um valor por elemento<\/td>\n<\/tr>\n<tr>\n<td>String, LocalizedText, QualifiedName, ByteString, Guid, NodeId<\/td>\n<td><code>TPLCString<\/code> (<code>StringType = stC<\/code>)<\/td>\n<td>o texto em UTF-8<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Uma escrita que n\u00e3o cabe no tipo da vari\u00e1vel (300 num Byte, um texto que n\u00e3o \u00e9 n\u00famero numa vari\u00e1vel num\u00e9rica) \u00e9 recusada com <code>ioIllegalValue<\/code>, sem chegar ao servidor. Escrever um elemento de um <code>TPLCBlock<\/code> escreve s\u00f3 aquele elemento (por IndexRange); se o servidor n\u00e3o aceita escrita por IndexRange, o driver l\u00ea o array, troca o elemento e escreve o array inteiro.<\/p>\n<p>Estruturas (tipos de dados do usu\u00e1rio) n\u00e3o s\u00e3o decodificadas: enderece os membros um a um.<\/p>\n<h5>Subscri\u00e7\u00e3o ou leitura peri\u00f3dica<\/h5>\n<p>Com <code>UseSubscriptions = True<\/code> (o padr\u00e3o) o driver cria uma subscri\u00e7\u00e3o e um item monitorado por vari\u00e1vel: o servidor amostra a vari\u00e1vel a cada <code>RefreshTime<\/code> do tag e s\u00f3 manda o que mudou, no m\u00e1ximo a cada <code>PublishingInterval<\/code>. Um tag com <code>RefreshTime = 0<\/code> pede ao servidor a amostragem mais r\u00e1pida que ele tiver. V\u00e1rios tags no mesmo NodeId dividem um item monitorado, com o <code>RefreshTime<\/code> mais r\u00e1pido.<\/p>\n<p>Com <code>UseSubscriptions = False<\/code> as vari\u00e1veis s\u00e3o lidas periodicamente, cada uma no seu <code>RefreshTime<\/code>, em lotes de at\u00e9 <code>MaxItemsPerRequest<\/code>. Use com servidores que n\u00e3o aceitam subscri\u00e7\u00e3o, ou para ter cada valor lido numa taxa fixa mesmo quando n\u00e3o muda.<\/p>\n<p>Quando a conex\u00e3o cai, todos os tags recebem o erro; o driver tenta de novo a cada <code>ReconnectInterval<\/code> e, ao reconectar, recria a subscri\u00e7\u00e3o sozinho.<\/p>\n<h5>Seguran\u00e7a<\/h5>\n<ul>\n<li><strong>None<\/strong> (<code>osmNone<\/code>): nada \u00e9 assinado nem criptografado. Uma senha s\u00f3 \u00e9 mandada assim com <code>AllowUnencryptedPassword = True<\/code>.<\/li>\n<li><strong>Sign<\/strong> \/ <strong>SignAndEncrypt<\/strong>: as mensagens s\u00e3o assinadas (e criptografadas). Os dois lados apresentam certificados e cada um precisa confiar no outro:\n<ul>\n<li><strong>O servidor confia no cliente.<\/strong> Com <code>CertificateFile<\/code> vazio o driver gera um certificado autoassinado na primeira conex\u00e3o segura e o guarda em <code>CertificateDir<\/code>. Entregue o <code>own\/pascalscada-client.der<\/code> ao servidor como cliente confi\u00e1vel \u2014 no TIA Portal ele vai para os clientes confi\u00e1veis do servidor OPC UA (<em>Server<\/em> \u2192 <em>Security<\/em> \u2192 <em>Secure channel<\/em>), a menos que o servidor esteja configurado para aceitar certificados de cliente automaticamente; outros servidores costumam guardar um certificado recusado numa pasta <em>rejected<\/em>, de onde ele \u00e9 movido para <em>trusted<\/em>. O Tag Builder tem o bot\u00e3o <strong>Export client certificate<\/strong> para isso. O certificado \u00e9 guardado, ent\u00e3o basta confiar nele uma vez.<\/li>\n<li><strong>O cliente confia no servidor.<\/strong> Com <code>TrustListDir<\/code> vazio, qualquer servidor \u00e9 aceito. Para aceitar s\u00f3 servidores conhecidos, coloque os certificados deles nessa pasta \u2014 o bot\u00e3o <strong>Trust server certificate<\/strong> do Tag Builder salva l\u00e1 o do servidor atual.<\/li>\n<\/ul>\n<\/li>\n<li><strong>Usu\u00e1rio e senha<\/strong>: <code>Username<\/code> e <code>Password<\/code>. Uma senha errada termina em <code>ioAuthError<\/code>.<\/li>\n<\/ul>\n<h5>Tag Builder<\/h5>\n<p>Clique com o bot\u00e3o direito no <code>TOPCUADriver<\/code> \u2192 <strong>Tag Builder<\/strong> abre o <em>OPC UA Tag Builder<\/em>.<\/p>\n<ol>\n<li>Aperte <strong>Browse<\/strong>: a \u00e1rvore mostra a pasta Objects do servidor; pastas e objetos s\u00e3o expandidos sob demanda.<\/li>\n<li>Selecione as vari\u00e1veis (Ctrl\/Shift para v\u00e1rias). Ajuste <strong>Scan<\/strong> (o <code>RefreshTime<\/code> dos tags novos) e, se quiser, um <strong>Prefix<\/strong> para os nomes. <em>Address with the namespace URI (nsu=)<\/em> escolhe entre endere\u00e7os <code>nsu=<\/code> (padr\u00e3o) e <code>ns=<\/code>.<\/li>\n<li><strong>OK<\/strong> cria um tag por vari\u00e1vel: <code>TPLCTagNumber<\/code> para um escalar num\u00e9rico, <code>TPLCBlock<\/code> (com o <code>Size<\/code> j\u00e1 ajustado) para um array num\u00e9rico e <code>TPLCString<\/code> para um texto. Estruturas e outros tipos sem equivalente s\u00e3o pulados e contados numa mensagem.<\/li>\n<\/ol>\n<p>Os bot\u00f5es <strong>Trust server certificate<\/strong> (salva o certificado do servidor em <code>TrustListDir<\/code>) e <strong>Export client certificate<\/strong> ficam na mesma janela (veja <em>Seguran\u00e7a<\/em>).<\/p>\n<h5>Navegando por c\u00f3digo<\/h5>\n<pre class=\"brush: delphi; tab-size: 2; title: ; notranslate\" title=\"\">var\r\n  tags: TPLCTagInfoArray;\r\n  info: TOPCUAVariableInfo;\r\n  i: Integer;\r\nbegin\r\n  if OPCUADriver1.ListTags(tags) = ioOk then      \/\/ todas as vari\u00e1veis abaixo de Objects\r\n    for i := 0 to High(tags) do\r\n      Memo1.Lines.Add(tags&#x5B;i].Path + &#039;  &#039; + tags&#x5B;i].NativeType);\r\n\r\n  if OPCUADriver1.GetVariableInfo(&#039;ns=3;s=&quot;DB1&quot;.&quot;Speed&quot;&#039;, info) = ioOk then\r\n    Memo1.Lines.Add(Format(&#039;%s rank %d&#039;, &#x5B;info.DataTypeName, info.ValueRank]));\r\nend;<\/pre>\n<p>O <code>ListTags<\/code> percorre a pasta Objects recursivamente, at\u00e9 12 n\u00edveis e 20000 vari\u00e1veis (<code>Path<\/code> \u00e9 o NodeId com <code>nsu=<\/code>, pronto para o <code>LongAddress<\/code>); o <code>Browse<\/code> devolve os filhos de um n\u00f3; o <code>GetVariableInfo<\/code> informa o tipo, o ValueRank (-1 escalar, \u2265 0 array), as dimens\u00f5es e o n\u00edvel de acesso de uma vari\u00e1vel. Eles conectam sozinhos quando precisam.<\/p>\n<h5>Exemplo passo a passo<\/h5>\n<ol>\n<li>Coloque um <code>TOPCUADriver<\/code> no form e ajuste o <code>EndpointUrl<\/code> (ex.: <code>opc.tcp:\/\/192.168.0.10:4840<\/code>).<\/li>\n<li>Clique com o bot\u00e3o direito nele \u2192 <strong>Tag Builder<\/strong> \u2192 <strong>Browse<\/strong>, selecione algumas vari\u00e1veis e aperte <strong>OK<\/strong>.<\/li>\n<li>Coloque controles HMI (<code>THMILabel<\/code>, <code>THMIEdit<\/code>, <code>THMITrackBar<\/code>, \u2026) e aponte o <code>PLCTag<\/code> deles para os tags novos.<\/li>\n<li>Rode. Os valores aparecem; digitar num <code>THMIEdit<\/code> escreve de volta no servidor.<\/li>\n<\/ol>\n<p>Para testar sem um servidor, o <a href=\"https:\/\/github.com\/fluisgirardi\/pascalscada_v0\/tree\/master\/examples\/laz_opcua_hmi\"><code>examples\/laz_opcua_hmi<\/code><\/a> sobe um pequeno servidor de teste dentro do pr\u00f3prio programa.<\/p>\n<h5>Erros<\/h5>\n<p>Os StatusCodes do OPC UA viram os <code>TProtocolIOResult<\/code> de sempre dos tags:<\/p>\n<table>\n<thead>\n<tr>\n<th>StatusCode (exemplos)<\/th>\n<th>Resultado<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Good, Uncertain<\/td>\n<td><code>ioOk<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadNodeIdUnknown, BadNodeIdInvalid, BadNotFound<\/td>\n<td><code>ioObjectNotExists<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadUserAccessDenied, BadNotReadable, BadNotWritable<\/td>\n<td><code>ioObjectAccessNotAllowed<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadTypeMismatch, BadOutOfRange<\/td>\n<td><code>ioIllegalValue<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadIndexRangeInvalid, BadIndexRangeNoData<\/td>\n<td><code>ioIllegalMemoryAddress<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadTimeout<\/td>\n<td><code>ioTimeOut<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadIdentityTokenInvalid\/Rejected, senha errada<\/td>\n<td><code>ioAuthError<\/code><\/td>\n<\/tr>\n<tr>\n<td>BadCertificate\u2026, BadSecurityChecksFailed, BadConnectionRejected<\/td>\n<td><code>ioConnectPLCFailed<\/code><\/td>\n<\/tr>\n<tr>\n<td>conex\u00e3o ou sess\u00e3o perdida<\/td>\n<td><code>ioCommError<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h5>Problemas comuns<\/h5>\n<table>\n<thead>\n<tr>\n<th>Sintoma<\/th>\n<th>Causa prov\u00e1vel<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>LastError<\/code>: <em>libopen62541 1.5 not found<\/em><\/td>\n<td>A biblioteca n\u00e3o est\u00e1 instalada nem na pasta do execut\u00e1vel; veja <em>A biblioteca open62541<\/em>.<\/td>\n<\/tr>\n<tr>\n<td><em>is not an open62541 1.5 library<\/em> \/ <em>was built without encryption<\/em><\/td>\n<td>Uma biblioteca de outra vers\u00e3o, ou compilada sem <code>UA_ENABLE_ENCRYPTION<\/code>.<\/td>\n<\/tr>\n<tr>\n<td>Todos os tags em <code>ioConnectPLCFailed<\/code> com Sign\/SignAndEncrypt<\/td>\n<td>O servidor ainda n\u00e3o confia no certificado do cliente: exporte-o e adicione aos confi\u00e1veis do servidor. Ou o <code>TrustListDir<\/code> est\u00e1 preenchido e n\u00e3o tem o certificado do servidor.<\/td>\n<\/tr>\n<tr>\n<td>Todos os tags em <code>ioAuthError<\/code><\/td>\n<td>Usu\u00e1rio\/senha errados, ou o servidor n\u00e3o permite acesso an\u00f4nimo.<\/td>\n<\/tr>\n<tr>\n<td><code>ioObjectNotExists<\/code> numa vari\u00e1vel Siemens<\/td>\n<td>NodeId sem as aspas (<code>s=\"DB1\".\"Speed\"<\/code>), ou a vari\u00e1vel n\u00e3o est\u00e1 <em>Accessible from HMI\/OPC UA<\/em>.<\/td>\n<\/tr>\n<tr>\n<td>Escritas recusadas (<code>ioObjectAccessNotAllowed<\/code>)<\/td>\n<td>A vari\u00e1vel n\u00e3o est\u00e1 <em>Writable from HMI\/OPC UA<\/em>, o usu\u00e1rio n\u00e3o pode escrever, ou <code>ReadOnly = True<\/code>.<\/td>\n<\/tr>\n<tr>\n<td>Um sinal r\u00e1pido \u00e9 visto com atraso<\/td>\n<td>Diminua o <code>RefreshTime<\/code> (amostragem) e o <code>PublishingInterval<\/code>, ou use leitura peri\u00f3dica.<\/td>\n<\/tr>\n<tr>\n<td>Um tag passa a ler outra vari\u00e1vel (ou nenhuma) depois que o servidor foi atualizado<\/td>\n<td>O servidor reordenou os namespaces e o \u00edndice do <code>ns=<\/code> mudou: use endere\u00e7os <code>nsu=<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h5>Exemplos relacionados<\/h5>\n<ul>\n<li><a href=\"https:\/\/github.com\/fluisgirardi\/pascalscada_v0\/tree\/master\/examples\/laz_opcua_client\"><code>examples\/laz_opcua_client<\/code><\/a> \u2014 conecta em qualquer endpoint, lista as vari\u00e1veis do servidor, monitora e escreve as escolhidas; <em>Servidor de teste<\/em> sobe um servidor local para testar sem CLP.<\/li>\n<li><a href=\"https:\/\/github.com\/fluisgirardi\/pascalscada_v0\/tree\/master\/examples\/laz_opcua_hmi\"><code>examples\/laz_opcua_hmi<\/code><\/a> \u2014 uma tela de IHM feita s\u00f3 no form: <code>TOPCUADriver<\/code>, tags e controles HMI ajustados em tempo de projeto, com as instru\u00e7\u00f5es no pr\u00f3prio form.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>Introdu\u00e7\u00e3o O TOPCUADriver \u00e9 um cliente OPC UA. Ele l\u00ea e escreve as vari\u00e1veis de qualquer servidor OPC UA: o servidor do S7-1200\/1500 e do PLCSim, o servidor embutido em &#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1305","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/pages\/1305","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/comments?post=1305"}],"version-history":[{"count":1,"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/pages\/1305\/revisions"}],"predecessor-version":[{"id":1310,"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/pages\/1305\/revisions\/1310"}],"wp:attachment":[{"href":"https:\/\/www.pascalscada.com\/pb\/wp-json\/wp\/v2\/media?parent=1305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}