Informações operacionais do controlador

As variáveis de sistema com endereços na faixa entre 1 .. 999 tem por função disponibilizar informações sobre:

Endereços	Descrição do grupo
F 1..9	Informações gerais do controlador
F 20..29	Canais de comunicação, configuração e recursos
F 40..49	Base de Status de Operação e Falha
F 50..59	Relógio de tempo real
F 60..69	Informações adicionais do programa de aplicação
F 70..79	Informações adicionais do RTC
F 80..89	Informações sobre variáveis disponíveis no firmware
F 90..99	Reserva.
F 100..499	Status e comandos operacionais dos canais de comunicação
F 600..899	Reservado para base específica de aplicação.
F 900..999	Reserva.

Estes recursos não estão disponíveis em todos os controladores. Consulte o manual do controlador associado para mais detalhes sobre os recursos de comunicação disponíveis.

Informações gerais do controlador

Esta base provê informações estáticas para identificação dos recursos associados ao controlador.

Endereço	Bit	R/W	LABEL	Descrição
F 1			DEV_ID	Identificador do tipo de controlador.
F 2			DEV_SID	Identificador do modelo do controlador. Se não existir modelo retorna 0.
F 3			DEV_SN	Número de série do controlador. Este nro é único dentro de uma mesma família de controladores.
F 4			DEV_GRES	Flags de recursos gerais do controlador.
	.0		DGR_NAND	Possui NAND-Flash.
	.1		DGR_SDCARD	Possui SDCARD.
	.2		DGR_FILESYS	Possui sistema de arquivo.
	.3		DGR_MMI	Possui MMI integrada.
	.4		DGR_COM_FLEX	Possui COM1/COM2 flex (duas COM´s com RX/TX ou 1 COM com RX/TX/RTS/CTS).
	.5-7			Reserva
	.8		DGR_EMB_APP	Possui aplicação embarcada. Pode ou não possuir programa de aplicação recarregável.
	.9		DGR_HAS_BL	Possui bootloader para atualização de firmware
	.10-15			Reserva.
F 5..9				Reserva
F 10			FIRW_ID	Identifica o tipo de firmware associado ao controlador.
F 11			FIRM_VER	Versão corrente do firmware no equipamento. Valor -1003 implica na versão V 1.0.03
F 12			PROG_ID	ID. do programa de aplicação carregado. Se equipamento não possui programa carregado o valor retornado é zero.
F 13			PROG_CRC	CRC da aplicação carregada. Se não definido retorna 0.
F 14			COM_VER	Versão corrente da biblioteca de comunicação do equipamento. Valor -3105 implica na versão V 3.1.05
F 15			BL_VER	Versão do bootloader corrente. Se igual a zero, a versão do firmware não tem suporte ou o CLP não possui bootloader (G3S)
F 16..18				Reserva
F 19			GLOB_CMDS	Comandos globais associados ao controlador
	0x0001			Gera um reset no controlador.
	0x0010			Liga o controlador ethernet do módulo (se existir).
	0x0020			Desliga o controlador ethernet do módulo (se existir).

	As informações gerais do controlador sobre o firmware e aplicação não mudam em uma mesma sessão de operação.
	Estes comandos não são operacionais quando realizados via comunicação. Operam apenas quando executados dentro de um programa ladder.
	O comando de reset deve ser executado com cuidado pois, quando chamado, todas as operações pendentes da aplicação seram abortadas, incluindo arquivos abertos e processos de comunicação em andamento.
	Quando o controlador ethernet for desligado o mesmo é mantido em reset ativando o modulo low power e desta forma reduzindo o consumo de corrente do módulo. Ao ser reativado é necessário reinicializar os sockets ethernet desejados para que se tornem operacionais. Esta operação pode ser realizada pela variável de sistema F 319 para o socket 0, F 339 para o socket 1, etc. Para mais informações consulte a sessão Status e comandos operacionais dos canais de comunicação

Canais de comunicação, configuração e recursos

Endereço	Valor	R/W	LABEL	Descrição
F 20		R/W	DEV_COM_ID	Endereço de comunicação do equipamento.
F 21		R/W	COM_CONN_TMO	Tempo (seg/10) sem comunicação para indicar canal offline. Caso seja requerido um
				tempo de 60s, configurar na variável o valor 6.
F 22		R/W	COM_SCP_REMAP_ID	Id da tabela de strings de remapeamento de endereços para protocolo SCP-HI. Se o valor for zero não existe o remapeamento para o protocolo SCP-HI.
F 23		R/W	COM_MDB_REMAP_ID	Id da tabela de strings de remapeamento de endereços para protocolo MODBUS. Se o valor for zero não existe o remapeamento para o protocolo MODBUS.
F 24				Reserva
F 25		R/W	CLUSTER_ID	Identificador do cluster de comunicação.
F 26		R/W	CLUSTER_MASK	Identificador do cluster de comunicação.
F 27		R/W	CHANNEL_REMAP	Remapeamento dos canais de comunicação. Se zero desabilita recursos de ponto a ponto estendido (PPE).
F 28		R/W	COM_EXT_TMO	Tempo adicional (em ms) a ser acrescentado para timeout de recepção e interchar quando canal serial. (default = zero). Permite aguardar um intervalo maior de tempo para receber um pacote via canal serial. Se zero, considera o timeout default calculado pelo firmware a partir do baudrate corrente.
F 29		R/W	COM_BROAD_ADDR	Endereço de broadcast do equipamento (default 255). Se zero desabilita recursos de broadcast.
F 30..38				Reserva
F 39		W	GLOB_COM_CMDS	Comandos globais relacionados ao protocolo de comunicação
	0x4000			Recupera base de setup atualmente salva na flash
	0x8000			Salva base de setup de comunicação

	Este campo mantem o id do cluster de comunicação quando utilizado o recurso de ponto a ponto estendido (PPE). Deve ser zero quando este recurso esta desabilitado.
	Este campo mantem a máscara utilizada para verificação se o id. de comunicação enviado pertence ao cluster associado ao equipamento. Quando não utilizado recurso PPE esta valor deve ser 0xFFFF.
	Define a associação entres os canais para operação com o recurso de ponto a ponto estendido. Existe suporte para 2 conjuntos de associações. Quando desabilitado o recurso PPE este valor é zero.

Base de Status de Operação e Falha

Esta base provê informações de status e falha associadas. Estas informações são dinâmicas, ou seja, refletem a condição operacional do controlador no momento que que foram obtidas.

Endereço	Bit	LABEL	Descrição
F 40		DEV_GOPE_STS	Flags de condições de operação do equipamento.
	.0	GOS_HAS_PROG	Indica que possui aplicação do usuário carregada.
	.1	GOS_RUNNING	Indica que aplicação do usuário esta rodando.
	.2	GFS_BREAK	Indica que aplicação esta parada em algum break point em depuração
	.3	GFS_WARMUP	Indica que aplicação ainda não terminou o processo de inicialização geral (warmup)
	.4-7		Reserva.
	.8	SV_GOS_HAS_FS	Indica que equipamento conectado possui suporte para sistema de arquivo
	.9	SV_GOS_HAS_SDCARD	Indica que equipamento suporta sistema de arquivo tipo SD Card. 0: NAND-Flash 1: SDCARD
	.10-14		Reserva.
	.15	GOS_WDT_RST	Indica que o último reset do equipamento ocorreu por estouro do WDT.
F 41		DEV_GFAIL_STS	Flags de condições de falha do equipamento.
	.0	GFS_BLOCK_FAIL	Indica que equipamento não está executando aplicação devido a uma falha detectada.
	.1	GFS_NBLOCK_FAIL	Indica que equipamento identificou uma falha operacional, porém continua operando parcialmente.
	.2	GFS_FS_FAIL	Indica que ocorreu falha no acesso ao sistema de arquivo.
	.3	GFS_INV_RTC_VAL	Valor do RTC inválido
	.4-7		Reserva.
	.8	GFS_INIT_FAIL	Falha no processo de inicialização do hardware.
	.9	GFS_IDENT_FAIL	Falha no processo de identificação do hardware.
	.10	GFS_OPER_FAIL	Falha detectada durante operação do hardware.
	.11	GFS_UNMATCH	Hardware incompatível com a aplicação carregada.
	.12	GFS_INV_PROG	Programa carregado inválido.
	.13	GFS_INV_FIRM	Firmware não autorizado para operação com o equipamento.
	.14	GFS_NVR_FAIL	Base de dados retentiva em falha.
	.15		Reserva.
F 42		DEV_POWER_COUNT	Contador de falhas de energia no equipamento. Se não disponível no controlador apresenta -1.
F 43		DEV_WDT_COUNT	Contador de resets por WDT no equipamento. Se não disponível no controlador apresenta -1.
F 44		DEV_BAT_STS	Estado da bateria do equipamento. [0] = Sem bateria, [1] = bateria crítica, [2] = bateria fraca, [3] = bateria Ok, [4] = Equipamento sem suporte para bateria.
F 45		DEV_BAT_VT	Valor da tensão da bateria em mV. Se não disponível apresenta 0.
F 46		DEV_PRG_CYCLE	Tempo do ciclo de programa de aplicação médio em us. Se não disponível apresenta 0.
F 47		COM_ONLINE_STS	Flags de canais de comunicação online.
	.0	ONF_ETH	Indica que no mínimo um dos sockets esta trocando dados com equipamento externo.
	.1	ONF_COM1	Indica que o canal COM1 está trocando dados com equipamento externo.
	.2	ONF_COM2	Indica que o canal COM2 está trocando dados com equipamento externo.
	.3	ONF_COM3	Indica que o canal COM3 está trocando dados com equipamento externo.
	.4	ONF_COM4	Indica que o canal COM4 está trocando dados com equipamento externo.
	.8	ONF_USB	Indica que o canal USB está trocando dados com equipamento externo.
	.9	ONF_CBUS	Indica que o canal CBUS está trocando dados com equipamento externo.
	.10	ONF_SOCK0	Indica que o canal do socket 0 está trocando dados com equipamento externo.
	.11	ONF_SOCK1	Indica que o canal do socket 1 está trocando dados com equipamento externo.
	.12	ONF_SOCK2	Indica que o canal do socket 2 está trocando dados com equipamento externo.
	.13	ONF_SOCK3	Indica que o canal do socket 3 está trocando dados com equipamento externo.
	.14-15		Reserva.

Estes contadores são reinicializados com valor zero sempre que um novo programa é carregado no controlador.

Relógio de tempo real

Endereço	R/W	LABEL	Descrição
F 50	R/W	DEV_DT_SEC	Segundo corrente do equipamento (0..59). Se não disponível apresenta 0.
F 51	R/W	DEV_DT_MIN	Minuto corrente do equipamento (0..59). Se não disponível apresenta 0.
F 52	R/W	DEV_DT_HOUR	Hora corrente do equipamento (0..23). Se não disponível apresenta 0.
F 53	R/W	DEV_DT_DAY	Dia corrente do equipamento (1..31). Se não disponível apresenta 0.
F 54	R/W	DEV_DT_MON	Mês corrente do equipamento (1..12). Se não disponível apresenta 0.
F 55	R/W	DEV_DT_YEAR	Ano corrente do equipamento (ex:2015). Se não disponível apresenta 0.
F 56	R/W	DEV_DT_WEEK_DAY	Dia da semana corrente do equipamento (0: Domingo, 1: Segunda,…).
F 57	W	DEV_RTC_WR	Programa o relógio com os valores previamente escritos nas variaveis F50..F55. O valor a ser escrito nesta memória deve ser 12345. Qualquer valor diferente deste é ignorado e a escrita não é realizada.
F 70	R	LS_DEV_DT_SEC	Segundo corrente do ultimo ajuste do relógio.
F 71	R	LS_DEV_DT_MIN	Minuto corrente do ultimo ajuste do relógio.
F 72	R	LS_DEV_DT_HOUR	Hora corrente do ultimo ajuste do relógio.
F 73	R	LS_DEV_DT_DAY	Dia corrente do ultimo ajuste do relógio.
F 74	R	LS_DEV_DT_MON	Mês corrente do ultimo ajuste do relógio.
F 75	R	LS_DEV_DT_YEAR	Ano corrente do ultimo ajuste do relógio.
F 79	R	LS_COUNTER	Contador de vezes que o RTC foi ajustado na sessão corrente

Informações adicionais do programa de aplicação

Endereço	R/W	LABEL	Descrição
F 60	R	PRG_NAME_0	Buffer conteudo o nome do programa de aplicacao (caracteres 0 e 1).
F 61	R	PRG_NAME_1	Buffer conteudo o nome do programa de aplicacao (caracteres 2 e 3).
F 62	R	PRG_NAME_2	Buffer conteudo o nome do programa de aplicacao (caracteres 4 e 5).
F 63	R	PRG_NAME_3	Buffer conteudo o nome do programa de aplicacao (caracteres 6 e 7).
F 64	R	PRG_NAME_4	Buffer conteudo o nome do programa de aplicacao (caracteres 8 e 9).
F 65	R	PRG_NAME_5	Buffer conteudo o nome do programa de aplicacao (caracteres 10 e 11).
F 66	R	PRG_NAME_6	Buffer conteudo o nome do programa de aplicacao (caracteres 12 e 13).
F 67	R	PRG_NAME_7	Buffer conteudo o nome do programa de aplicacao (caracteres 14 e 15).
F 68	R	PRG_PIN	PIN associado ao programa corrente. Todo projeto quando criado recebe um numero de identificação (PIN) que é transferido para o controlador durante a carga da aplicação. Este número portanto identifica o projeto associado independentemente do nome atribuido ao programa de aplicação. Quando o usuário efetua o comando de “salvar como” no ambiente de programação, este numero é alterado.

As variaveis F60..F67 formam um buffer de 16 caracters que armazena o nome do programa de aplicação corrente. Caso o nome seja menor que 16 caracteres o restante do buffer é preenchido como valor zero.

Informações adicionais do RTC

Endereço	R/W	LABEL	Descrição
F 70	R	DEV_LSRTC_SEC	Valor corrente do RTC - segundo (0..59)
F 71	R	DEV_LSRTC_MIN	Valor corrente do RTC - minuto (0..59)
F 72	R	DEV_LSRTC_HOUR	Valor corrente do RTC - hora (0..23)
F 73	R	DEV_LSRTC_DAY	Valor corrente do RTC - dia (1..31)
F 74	R	DEV_LSRTC_MONTH	Valor corrente do RTC - mes (1..12)
F 75	R	DEV_LSRTC_YEAR	Valor corrente do RTC - ano (acima de 2000)
F 76	R	DEV_LSRTC_WEEK_DAY	Valor corrente do RTC - dia da semana (0 - Domingo, 1 - segunda…)
F 77..78	R	Reserva	Reserva
F 79	R	DEV_LS_COUNTER	Contador de vezes que houve ajuste do RTC na sessão corrente)

Informações sobre variáveis disponíveis no firmware

Endereço	R/W	LABEL	Descrição
F 80	R	MEM_AMT_R	Número de variáveis do tipo R disponíveis
F 81	R	MEM_AMT_M	Número de variáveis do tipo M disponíveis
F 82	R	MEM_AMT_D	Número de variáveis do tipo D disponíveis
F 83	R	MEM_AMT_L	Número de variáveis do tipo L disponíveis
F 84	R	MEM_AMT_X	Número de variáveis do tipo X disponibilizadas pela aplicação
F 85..89	R	Reserva	Reserva

O número de strings disponibilizadas pela aplicação pode indicar quantas variáveis do tipo M estão sendo utilizadas pelas variáveis do tipo string. Cada string ocupa 25 variáveis do tipo M, alocadas no final da faixa de variáveis.

Status e comandos operacionais dos canais de comunicação

Está reservado na base de variáveis de sistema, suporte para utilização de até 18 canais de comunicação no controlador associado. O endereço inicial da base do canal de comunicação Cn é obtido através da seguinte equação:

Cn = n * 10 + 100 onde:

n representa o nro do canal de comunicação (0..17).

A tabela apresentada a seguir mapeia a faixa de endereços de variáveis de sistema aloca para cada canal de comunicação e identifica o mesmo.

Endereços	Canal
F 100 .. F 119	Canal Ethernet. Totaliza as informações de todos os sockets.
F 120 .. F 139	Canal COM1.
F 140 .. F 159	Canal COM2.
F 160 .. F 179	Canal COM3.
F 180 .. F 199	Canal COM4.
F 200 .. F 219	Canal COM5.
F 220 .. F 239	Canal COM6.
F 240 .. F 259	Reserva.
F 260 .. F 279	Canal USB.
F 280 .. F 299	Canal CBUS (exclusivo para p/ P7C).
F 300 .. F 319	Socket ethernet 0. Socket de controle .
F 320 .. F 339	Socket ethernet 1. Socket cliente default.
F 340 .. F 359	Socket ethernet 2.
F 360 .. F 379	Socket ethernet 3.
F 380 .. F 399	Socket ethernet 4.
F 400 .. F 419	Socket ethernet 5.
F 420 .. F 439	Socket ethernet 6.
F 440 .. F 459	Socket ethernet 7.

	Os endereços associados ao canal Ethernet possuem um tratamento especial. As informações obtidas retornam valores que totalizam as informações de todos os sockets disponíveis no equipamento. O flag COF_ONLINE é true se qualquer dos sockets estiver online. A variável COM_OK_PERC retorna o percentual médio das transações de todos os sockets do usuário. A variável COM_LAST_FAIL retorna o código de falha do primeiro socket que for diferente de sucesso (0). A variável COM_CONN_TMO retorna informação válida visto que é o mesmo valor para todos os canais de comunicação. As memórias F 104 e F 105 possuem o endereço IP controlador.
	O socket de controle (socket 0) não é avaliado para contabilizar as informações estatísticas de variáveis relativas ao canal ethernet.
	Para obter as informações individuais dos sockets acesse a área de memória de cada um (ex: socket 2 -> F 340 a F 359)
	O número de sockets disponíveis pode variar dependendo do equipamento ou versão de firmware utilizado.

Informações do canal Ethernet

Os endereços do canal Ethernet totalizam as informações de todos os sockets disponíveis, possuindo um tratamento especial. Para informações de um socket específico, consultar Informação dos canais de comunicação (seriais e sockets).

Cada canal de comunicação reporta em um conjunto de 10 variáveis de sistema o status operacional do mesmo, conforme indicado na tabela a seguir.

Endereço	Bit	R/W	LABEL	Descrição
F 100		R	DEV_COM_INFO	Flags de condições operacionais de canal de comunicação Cn.
	.0	R	COF_AVAL	Canal disponível no equipamento
	.1	R	COF_INIT_OK	Canal inicializado corretamente
	.2	R	COF_ONLINE	Canal conectado. Indica que existe cliente remoto trocando dados com o canal com sucesso.
	.3	R	COF_ADDR_REMAP_BIT	Canal utiliza remapeamento de endereços.
	.4	R	COF_CON_TCP	Canal com conexão TCP estabelecida.
	.5-15	R		Reserva
F 101		R	COM_OK_PERC	Percentual de pacotes trocados com sucesso. Se -1 indica que não foram trocados nenhum pacote pelo canal.
F 102		R	COM_LAST_FAIL	Código da ultima falha de comunicação.
F 103		R/W	COM_ABORT_CODE	Código de abort detectado pelo driver de comunicação.
F 104		R/W	COM_CONFIG	Retorna a word (16 bits) menos significativa do endereço IP associado ao controlador.
F 105		R/W	ASCII_DELIM	Retorna a word (16 bits) mais significativa do endereço IP associado ao controlador.
F 106		R/W		Reserva
F 107		R	TRANS_COUNT	Soma dos pacotes trocados com sucesso em todos os sockets.
F 109..18				Reserva.

	Para atualização do endereço IP do controlador, a variável F 104 deve ser escrita primeiramente. Esta escrita é salva temporariamente no controlador e não modifica o endereço IP corrente. Ao ser escrita a memória F 105 este valor é composto com o valor previamente escrito na memória F 104 e o resultado é então atribuido como novo endereço IP do controlador.
	Considere que o CLP esteja com endereço IP 192.168.0.1. Em hexa, será C0.A8.0.1. Assim: F104 = 0x0100 e F105 = 0xA8C0

Informação dos canais de comunicação (seriais e sockets)

Informações dos canais de comunicação serial e dos sockets Ethernet.

Endereço	Bit	R/W	LABEL	Descrição
F Cn+0			DEV_COM_INFO	Flags de condições operacionais de canal de comunicação Cn.
	.0	R	COF_AVAL	Canal disponível no equipamento
	.1	R	COF_INIT_OK	Canal inicializado corretamente
	.2	R	COF_ONLINE	Canal conectado. Indica que existe cliente remoto trocando dados com o canal com sucesso.
	.3	R	COF_ADDR_REMAP_BIT	Canal utiliza remapeamento de endereços.
	.4	R	COF_CON_TCP	Canal com conexão TCP estabelecida.
	.5-15	R		Reserva
F Cn+1		R	COM_OK_PERC	Percentual de pacotes trocados com sucesso. Se -1 indica que não foram trocados nenhum pacote pelo canal.
F Cn+2		R	COM_LAST_FAIL	Código da ultima falha de comunicação.
F Cn+3		R/W	COM_ABORT_CODE	Código de abort detectado pelo driver de comunicação.
F Cn+4		R/W	COM_CONFIG	Configuração do canal de comunicação .
F Cn+5		R/W	ASCII_DELIM	Delimitadores para operação com o protocolo ASCII. Os bits (0..7) contém o caracter utilizado como SOF quando habilitado no protocolo ASCII. Os bits (8..15) contém o caracter utilizado como EOF quando habilitado no protocolo ASCII.
F Cn+6		R/W		Quando canal é um socket ethernet, mantem a porta ethernet associadao ao socket. Reserva para os demais tipos de canais.
F Cn+7		R	TRANS_COUNT	Contador de pacotes trocados com sucesso para o canal corrente.
F Cn+8..18				Reserva.
F Cn+19		W	CHAN_CMDS	Comandos associados ao canal de comunicação.
	0x8000			Reinicializa o canal de comunicação com os parâmetros correntes.

	O socket 0 (memória F 206) pode ser acessado apenas para leitura. Escrita neste parâmetro irá retornar erro indicando que o parâmetro é apenas de leitura.
	Este comando reinicializa o canal e não reseta o CLP.

Atenção

Quando qualquer parâmetro de comunicação for alterado, para que os novos valores sejam processados o controlador necessita ser reinicializado. Para que os comandos sejam salvos na base, utilizar a variável de sistema F39 (Canais de comunicação, configuração e recursos). Se o comando de salvar for executado, um reset no equipamento também será necessário, via variável F19 (Informações gerais do controlador).

Configuração do canal de comunicação

O endereço Cn+4 mantem informações sobre a configuração de operação do canal de comunicação associado. Através deste campo pode-se supervisionar ou modificar alguns dos parâmetros de comunicação associados ao canal. O mapeamento das informações deste campo são diferentes para cada um dos tipos de canais disponíveis.

Mapeamento de Cn+4 para os canais seriais

Para os canais seriais, o campo Cn+4 é mapeado em bits, possuindo o seguinte formato:

BITS
Protocolo				Reserva				Stop	Paridade		Data	BaudRate
0:ASCII								0:1	0:nenhuma		0:7	0:1200 bauds
1:ASCII+SOF								1:2	1:par		1:8	1:2400 bauds
2:ASCII_EOF									2:impar			2:4800 bauds
3:ASCII+SOF+EOF												3:9600 bauds
4:SCP-HI												4:19200 bauds
8:MODBUS-RTU												5:38400 bauds
												6:57600 bauds
												7:115200 bauds
15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0

Mapeamento de Cn+4 para os sockets ethernet

Para os canais ethernet, o campo Cn+4 é mapeado em bits, possuindo o seguinte formato:

BITS
Prot. Aplicação				Transp.	Reserva
0:ASCII				0:TCP
1:ASCII + SOF				1:UDP
2:ASCII + EOF
3:ASCII + SOF+EOF
4:SCP-HI
9:MODBUS-TCP
15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0

Nota

Os parâmetros do socket 0 (memórias F 200 .. F 209) podem ser acessados apenas para leitura. Escrita nestes parâmetros irão retornar erro indicando que os mesmos são apenas de leitura.