Variáveis locais

Este tipo de variável é utilizado para manter uma informação utilizada apenas pela POU associada. Variáveis locais podem ser acessadas apenas pela POU que a definiu. Em um projeto carregado, dê um clique duplo no item da POU desejada para acessar o Editor de variáveis locais, conforme apresentado na figura a seguir.

Editor de variáveis locais

Fig. 73 Painel de variáveis locais

A ativação do item POU selecionado abre o editor da POU. Nele, a aba de Variáveis permite acesso ao editor de variáveis locais que disponibiliza um conjunto de comandos para definição das variáveis locais utilizadas pela POU associada.

Tabela de comandos

Comandos disponíveis no editor de variáveis locais:

Fig. 74 Editor de Variáveis Locais

Comandos do editor de variáveis locais
Ícone	Descrição
	Cria um desenho em texto da POU quando a mesma for do tipo função ou bloco de função.
	Fecha o editor de variáveis.
	Abre o sistema de Help do ambiente, direcionando-o para o conteúdo do editor de variáveis.
	Cria uma nova variável na posição da linha selecionada no editor.
	Elimina a variável da linha selecionada no editor.
	Copia para o clipboard a variável na posição da linha selecionada no editor.
	Cola a variável do clipboard na posição da linha selecionada no editor.
	Corta (remove e copia) a variável na posição da linha selecionada no editor.
	Desloca para cima uma linha a variável da linha selecionada no editor.
	Desloca para baixo uma linha a variável da linha selecionada no editor.
	Move para o início da lista a variável da linha selecionada no editor.
	Move para o fim da lista a variável da linha selecionada no editor.
	Inspeciona a variável associada à linha selecionada no editor.
	Cria uma tabela no clipboard com a definição de todas as variáveis do editor.

Comandos de Importação / Exportação de tipos e variáveis
Ícone	Descrição
	Cria uma tabela de variáveis a partir de um arquivo .csv especificado pelo usuário.
	Cria no diretório do projeto corrente um arquivo .csv com a definição das variáveis da POU.

Dica

Clique em Importação / Exportação de tipos e variáveis para mais informações sobre como criar tabelas de variáveis e tipos de dados em uma planilha externa e importa-las para o HIstudio.

Campos associadas a definição de uma variável local

Cada variável local possui um conjunto de campos que define a mesma, conforme apresentado na figura seguinte:

Fig. 75 Campos de definições das Variáveis Locais

Cada campo possui a seguinte funcionalidade:

Campo	Descrição
Nome	Nome da variável. Este nome deve respeitar as especificações de um identificador de variável na norma IEC61131-3.
Classe	Especifica a classe da variável. Consulte a sessão de Classe da variável para mais informações.
Tipo	Tipo de variável associado ao nome. Consulte a sessão de Tipos de dados de uma variável para mais informações.
Dimensão	Este campo permite especificar se a variável definida é um valor único ou um vetor de variáveis. Veja a sessão de Definição da dimensão de uma variável para mais informações.
Valor inicial	Permite definir um valor inicial para a variável. Quando não especificado a variável é inicializada com o valor default para o tipo. Consulte os valores default para cada tipo de dados.
Opções	Permite ao usuário definir atributos associados a variável definida. Consulte a sessão de Opções na definição de uma variável para mais informações.
Descrição	Permite associar um texto à variável definida.

Classe da variável

Uma variável local pode pertencer a umas das seguintes classes dependendo da POU associada, conforme detalhado na tabela seguinte:

Classe	POU de Programa	POU de Função	POU de Bloco de função
Entrada	NÃO	SIM	SIM
Saída	NÃO	SIM	SIM
Entrada/Saída	NÃO	SIM	SIM
Local	SIM	NÃO	SIM
Temporária	SIM	SIM	SIM
Externa	SIM	SIM	SIM

Tipos de dados de uma variável

Uma variável pode estar associada a um dos seguintes grupos de tipos de dados:

TIPO	Descrição
Tipos nativos	Este grupo apresenta para seleção, todos os Tipos de dados nativos definidos na norma IEC61131-3 e suportados pelo firmware do equipamento conectado ou para o qual o programa será gerado.
Tipos de dados do usuário	Este grupo apresenta para seleção, todos os tipos de dados criados pela aplicação corrente ou presentes nas bibliotecas disponíveis no HIstudio.
Blocos de funções	Este grupo apresenta para seleção, todos os blocos de função criados pela aplicação corrente ou presentes nas bibliotecas disponíveis no HIstudio.

Definição da dimensão de uma variável

Um tipo de dado qualquer pode ser definido como escalar (um único elemento) ou um vetor de elementos. Quando o campo de dimensão estiver vazio significa que a variável associada é escalar. Quando a variável for um vetor, deve-se especificar o campo dimensão com um texto no seguinte formato:

[x..y]   onde:

x: índice inicial do vetor
y: índice final do vetor

Desta forma o nro de elementos do vetor será:

ME = y - x + 1    onde:

ME: nro. de elementos do vetor
 x: índice inicial do vetor
 y: índice final do vetor

O campo suporta tipos de várias dimensões que são definidos sequencialmente. Por exemplo, uma variável de 2 dimensões pode ser definida da seguinte forma:

[0..9][0..4]

Nota

O número de dimensões e o tamanho máximo dos vetores suportados são definidos em função do firmware associado ao programa de aplicação.

Opções na definição de uma variável

As opções associadas a uma variável são as seguintes:

TIPO	Descrição
Não retentivo	Variável é sempre inicializada.
Retentivo	Variável é retentiva, mantendo o último valor em memória
Constante	Definição associada a uma constante. Valor não pode ser alterado.

Filtro de variáveis do editor

Nos editores de variáveis, a partir da versão 2.2.19, é possivel filtrar as variáveis ou constantes definidas, facilitando a consulta e edição. No editor de variáveis locais, o filtro pode ser aplicado com base nas definições: Nome, Classe, Tipo ou Descrição da variável/constante. Isto pode ser feito através do campo disponível abaixo da tabela de variáveis:

Fig. 76 Filtro de variáveis locais

Acessando uma variável global em uma POU

Nota

A partir da versão 2.2.19 do HIstudio não é mais necessário declarar uma constante externa na lista de variáveis da POU, uma vez que o ambiente já realiza a associação das constantes definidas na lista de variáveis globais. Isto não se aplica à variáveis externas, portanto estas devem ser declaradas na lista de variáveis da POU em que a variável será utilizada.

Quando uma POU necessitar acessar uma variável global basta criar uma nova entrada na lista de variáveis da POU e no menu associado a coluna de Classe da variável selecione a opção externa. Clique em Selecionar variáveis globais e será exibida uma tela que permite a seleção de uma ou múltiplas variáveis:

Fig. 77 Acesso à variável externa

Ou clique em [ESPECIFICA MANUALMENTE] e digite o nome da variável:

Fig. 78 Variável externa na lista da POU

Uma vez especificada a variável, a mesma será apresentada na lista da POU e poderá ser acessada no código referenciando o seu nome apenas, da mesma forma como é referenciada uma variável local qualquer.

GV_0 := 30; // atribui um valor à variável global

Note que não é possível alterar os atributos da variável global na tela de variáveis da POU. Qualquer modificação na variável global deverá ser realizada no Editor de variáveis globais.