Alteração de IP via Aplicação em RunTime

Neste tutorial estão descritas orientações e procedimentos para alterar o IP, a máscara de rede e o gateway do seu CLP, em tempo de execução, por meio de blocos funcionais disponibilizados pela biblioteca SysSocket do CODESYS, no MasterTool. 

Componentes

Software:  MasterTool IEC XE 3.52;

CLP:  XP340;

Firmware: 1.12.29.0

Seções do Tutorial

1.  ARQUITETURA 

2.  DESENVOLVIMENTO

   2.1.  Inserindo a biblioteca SysSocket_Implementation no MasterTool IEC XE

   2.2.  Inserindo a biblioteca SysTypes2 Interfaces no MasterTool IEC XE

   2.3.  Declarando os function blocks SysSockSetIpAddress e SysSockSetSubnetMask

   2.4. Exemplo utilizando um controlador programável XP3XXX

   2.5. String de identificação da interface Ethernet

   2.6. Considerações finais IMPORTANTES

1.  ARQUITETURA 

2. DESENVOLVIMENTO

Neste tutorial descrevemos os passos para alterar seu endereço de IP, mascara de rede e gateway com a aplicação em execução. É necessário inserir uma biblioteca do MasterTool chamada SysSocket_Implementation para utilizar as funções SysSockSetIpAddress, SysSockSetSubnetMask e SysSockSetDefaultGateway.

2.1.  Inserindo a biblioteca SysSocket no MasterTool IEC XE

A alteração do endereço IP, da máscara de rede e do gateway, pode ser realizada em tempo de execução pela aplicação do PLC utilizando algumas funções disponíveis na biblioteca SysSocket do MasterTool (maiores informações podem ser consultadas Online Help).

O primeiro passo é incluir a biblioteca SysSocket Implementation no projeto.

• Acesse o Gerenciador de Bibiloteca, na árvore de dispositivos, conforme a imagem abaixo:

• Quando aberto, selecione a opção de adicionar biblioteca, conforme a imagem abaixo:

• Irá abrir uma aba, clique na opção "Avançado...", conforme na imagem abaixo:

• Pesquise pela biblioteca "SysSocket Implementation" e clique 2 vezes para adicionar ela, conforme a imagem abaixo:

2.2. Inserindo a biblioteca SysTypes2 Interfaces no MasterTool IEC XE

Também será necessária a biblioteca SysTypes2 Interfaces, portanto, repita os passos anteriores com a outra biblioteca.

2.2.  Declarando os function blocks SysSockSetIpAddress, SysSockSetSubnetMask e  SysSockSetDefaultGateway

Como mencionado anteriormente, serão  utilizadas três funções desta biblioteca, a SysSockSetIpAddress, a SysSockSetSubnetMask e a SysSockSetDefaultgateway.

2.3. Exemplo utilizando um controlador programável XP3XXX

Abaixo um exemplo de utilização em linguagem ST para um controlador XP3xx:

Neste exemplo, quando bChangeIp for para TRUE, a interface ‘eth0’ (que representa NET1 do Xpress) irá receber as configurações de IP, máscara e gateway. As funções são chamadas em sequência, condicionado aos seus retornos (Result, Result2 e Result3) pois, quando em zero, indicam que as funções executaram com sucesso.

2.4. String de identificação da interface Ethernet

A string de identificação da interface Ethernet é específica para cada modelo de controlador, conforme apresentado abaixo:

2.5. Considerações finais IMPORTANTES

É importante considerar que , ao confirmar a nova configuração via aplicação, haverá desconexão com o MasterTool (time out). Para logar novamente no controlador, é necessário realizar novamente scan no Gateway e selecionar o dispositivo. Não é necessário alterar a configuração da NET1 no projeto.

Caso seja alterado apenas o endereço gateway não haverá desconexão!

Também deve-se ter em mente que esta alteração de configuração não é retentiva, isto é, ao desligar e ligar o controlador, o mesmo retornará com o IP configurado na NET1 do projeto.