Informações comuns dos equipamentos com firmware G5

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

Endereços	Descrição do grupo
F 1..19	Informações gerais do equipamento
F 20..29	Base de Status de Operação e Falha
F 30..49	Reserva
F 50..59	Relógio de tempo real local
F 60..79	Informações adicionais do programa de aplicação
F 80..99	Reserva.
F 100..199	Canais de comunicação, configuração e recursos
F 200..699	Status e comandos operacionais dos canais de comunicação
F 700..899	Reservado para base específica de aplicação.
F 900..999	Reserva.

Atenção

Estes recursos não estão disponíveis em todos os controladores. Consulte o manual do equipamento utilizado para mais informações sobre as funcionalidades do produto.

A tabela a seguir provê informações estáticas para identificação dos recursos associados ao equipamento.

Informações gerais do equipamento

Endereço	Bit	R/W	LABEL	Descrição [1]
F 1		R	DEV_ID	Código da família do equipamento conectado. Consulte a tabela de família de equipamentos para mais informações.
F 2		R	DEV_SUB_ID	Modelo do equipamento. O valor depende da família do equipamento. Consulte o manual do equipamento para mais informações sobre o valor deste campo.
F 3		R	DEV_SN	Nro de série do equipamento. Este número é único dentro de uma mesma família
F 4		R	DEV_GRES	Flags de recursos gerais do controlador.
	.0			Reserva.
	.1		DGR_SDCARD	Possui SDCARD.
	.2		DGR_FILESYS	Possui sistema de arquivo.
	.3		DGR_MMI	Possui MMI integrada.
	.4-5			Reserva
	.6		DGR_MTK	Equipamento possui suporte mutitarefa em programas de aplicação.
	.7		DGR_SEC_FLAGS	Equipamento possui suporte para flags de segurança da aplicação.
	.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		DGR_RTC_OFF	Indica se RTC está desabilitado (condição existente no bootloader)
	.11		DGR_BL_ON	Indica que o equipamento esta operando no bootloader.
	12..14		PWRUP_COND	Indica a condição de ativação do firmware no equipamento. 0 : Não definido 1 : Firmware ativado por alimentação do equipamento 2 : Firmware ativado por saída do modo sleep 3 : Firmware ativado por estouro do watch dog timer 4 : Firmware ativado por reset da aplicação
	15			Reserva.
F 5		R	STARTUP_MODE	Modo de inicialização do controlador: 0: UNDEFINED 1: COLD-START 2: WARM-START 3: HOT-START
F 6..9				Reserva
F 10		R	FIRW_ID	ID do firmware do equipamento conectado. Consulte a tabela de firmwares para mais informações.
F 11		R	FIRM_VER	Versão corrente do firmware no equipamento. Ex: 1230 -> versão 1.2.30
F 12		R	PROG_ID	ID. do programa de aplicação carregado. Se equipamento não possui programa carregado, o valor retornado é zero.
F 13		R	PROG_CRC	CRC da aplicação carregada. Se não definido retorna 0.
F 14		R	PROG_REV	Versão do programa de aplicação. Se não definido retorna 0.
F 15		R	FSYS_REV	Revisão da biblioteca de sistema de arquivo. Se não definido retorna 0. [5]
F 16		R	STP_REV	Revisão da base de parametros de comunicação do equipamento. Se não definido retorna 0. [5] [6]
F 17		R	GLB_FIRWM_REV	Revisão global da biblioteca de firmware.
F 18				Reserva
F 19		W	GLOB_CMDS	Comandos globais associados ao controlador
	0x0001			Gera um reset no controlador. [2] [3]
	0x0002			Comando para zerar o contador de reset de powerup
	0x0003			Comando para zerar o contador de reset por wdt
	0x0004			Comando para zerar o contador de reset por instrução inválida
	0x0010			Liga o controlador ethernet 0 do módulo (se existir). [2] [4]
	0x0011			Liga o controlador ethernet 1 do módulo (se existir). [2] [4]
	0x0020			Desliga o controlador ethernet 0 do módulo (se existir). [2] [4]
	0x0021			Desliga o controlador ethernet 1 do módulo (se existir). [2] [4]
	0x0030			Libera o acesso externo às variáveis exportadas da aplicação.
	0x0031			Bloqueia o acesso externo às variáveis exportadas da aplicação.

	[1] As informações gerais do controlador sobre o firmware e aplicação não mudam em uma mesma sessão de operação.
	[2] (1,2,3,4,5) Estes comandos que não são operacionais quando realizados via comunicação. Operam apenas quando executados dentro da aplicação.
	[3] O comando de reset deve ser executado com cuidado pois, quando chamado, todas as operações pendentes da aplicação serão abortadas, incluindo arquivos abertos e processos de comunicação em andamento.
	[4] (1,2,3,4) 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, todos os sockets ethernet associados são reinicializados. Esta operação de reinicialização também 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
	[5] (1,2) Formato J.M onde J = revisão maior, M = revisão menor. Os bits 0..4 representam a revisão menor, os bits 5..7 representam a revisão maior.
	[6] Note que, o valor fornecido se refere a versão da base de setup salva na flash do equipamento. Mesmo que o firmware seja atualizado com uma versão da base diferente, esta informação não será disponibilizada até que a base seja salva no equipamento novamente.

Tabela de Firmwares

EQUIPAMENTO	FIRMWARE	CODIGO
P7C (CPU910)	G5PLC.C910.SD	0823(HEXA)	2083(DEC)
P7C (CPU911)	G5PLC.C911.ST	082C(HEXA)	2092(DEC)
P7C-PPU (CPU910)	G5PPU.C910.SD	0843(HEXA)	2115(DEC)
P7C-PPU (CPU911)	G5PPU.C911.ST	084C(HEXA)	2124(DEC)
NEON (CPU910)	G5PLC.C910.SD	0823(HEXA)	2083(DEC)
NEON (CPU911)	G5PLC.C911.ST	082C(HEXA)	2092(DEC)
NEON-5 (CPU950)	G5PLC.C950.ST	0824(HEXA)	2084(DEC)
RION (CPU501/502)	G5PLC.C501.ST	0825(HEXA)	2085(DEC)
RION (CPU521)	G5PLC.C521.ST	082A(HEXA)	2090(DEC)
GTON (CPU502)	G5PLC.C502.ST	0829(HEXA)	2089(DEC)
GTON (CPU532)	G5PLC.C532.ST	082B(HEXA)	2091(DEC)

Tabela de família de equipamentos

EQUIPAMENTO	CÓDIGO
P7C	8
NEON	9
RION / RION+ / RION-5	10
GTON-P	11
GTON-M	83
GTON-C	84

Base de Status de Operação e Falha

Esta base provê informações de status e falhas 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	R/W	LABEL	Descrição
F 20		R	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 breakpoint em depuração
	.3-7			Reserva.
	.8		GOS_HAS_FS	Indica que equipamento conectado possui suporte para sistema de arquivo
	.9-15			Reserva.
F 21		R	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_ETH_FAIL	Indica que equipamento identificou falha em um dos controladores ethernet do equipamento
	.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 22		R	DEV_POWER_COUNT	Contador de falhas de energia no equipamento. Se não disponível no controlador apresenta -1. [7]
F 23		R	DEV_WDT_COUNT	Contador de resets por WDT no equipamento. Se não disponível no controlador apresenta -1. [7]
F 24		R	DEV_BAT_STS	Estado da bateria do equipamento. [0] = Sem bateria [1] = bateria crítica [2] = bateria fraca [3] = bateria Ok [4] = bateria não disponível no modelo
F 25		R	DEV_BAT_VT	Valor da tensão da bateria em mV. Se não disponível apresenta 0.
F 26		R	DEV_PRG_CYCLE	Tempo do ciclo de programa de aplicação médio em us. Se não disponível apresenta 0.
F 27		R	DEV_INV_INSTR	Contador de falhas devido a instrução inválida
F 28..29				Reserva

[7] (1,2) Estes contadores são reinicializados com valor zero sempre que um novo programa é carregado no controlador.

Relógio de tempo real local

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 variáveis 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 58	R	DEV_DT_TIME_ZONE	Valor do timezone em minutos de -660 (-11h) a 840 (+14h) (Brasilia: -180(-3h))
F 59			Reserva

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

Endereço	R/W	LABEL	Descrição
F 60	R	PRG_NAME_0	Buffer com o nome do programa de aplicação (caracteres 0 e 1). [8]
F 61	R	PRG_NAME_1	Buffer com o nome do programa de aplicação (caracteres 2 e 3).
F 62	R	PRG_NAME_2	Buffer com o nome do programa de aplicação (caracteres 4 e 5).
F 63	R	PRG_NAME_3	Buffer com o nome do programa de aplicação (caracteres 6 e 7).
F 64	R	PRG_NAME_4	Buffer com o nome do programa de aplicação (caracteres 8 e 9).
F 65	R	PRG_NAME_5	Buffer com o nome do programa de aplicação (caracteres 10 e 11).
F 66	R	PRG_NAME_6	Buffer com o nome do programa de aplicação (caracteres 12 e 13).
F 67	R	PRG_NAME_7	Buffer com o nome do programa de aplicação (caracteres 14 e 15).
F 68	R	PRG_NAME_8	Buffer com o nome do programa de aplicação (caracteres 16 e 17).
F 69	R	PRG_NAME_9	Buffer com o nome do programa de aplicação (caracteres 18 e 19).
F 60	R	PRG_NAME_0	Buffer com o nome do programa de aplicação (caracteres 20 e 21).
F 71	R	PRG_NAME_1	Buffer com o nome do programa de aplicação (caracteres 22 e 23).
F 72	R	PRG_NAME_2	Buffer com o nome do programa de aplicação (caracteres 24 e 25).
F 73	R	PRG_NAME_3	Buffer com o nome do programa de aplicação (caracteres 26 e 27).
F 74	R	PRG_NAME_4	Buffer com o nome do programa de aplicação (caracteres 28 e 29).
F 75	R	PRG_NAME_5	Buffer com o nome do programa de aplicação (caracteres 30 e 31).
F 76..79	R		Reserva

[8] O nome do programa de aplicação é composto por Nome da aplicação:Equipamento corrente por exemplo APP:DEV_1

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

Endereço	Valor	R/W	LABEL	Descrição
F 100		R/W	DEV_COM_ID	Endereço de comunicação do equipamento.
F 101		R/W	COM_CONN_TMO	Tempo (seg) sem comunicação para indicar canal offline.
F 102				Reserva.
F 103		R/W	COM_BROAD_ADDR	Endereço de broadcast do equipamento (default 255). Se zero desabilita recursos de broadcast.
F 104		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 105		R/W	CLUSTER_INI	Endereço inicial do cluster PPE. [9]
F 106		R/W	CLUSTER_END	Endereço final do cluster PPE. [9]
F 107..109				Reserva
F 110			COM_ON_LSB_STS	Flags de canais de comunicação online (LSB). [10]
	.0		ONF_COM1	Indica que o canal COM1 está trocando dados com equipamento externo.
	.1		ONF_COM2	Indica que o canal COM2 está trocando dados com equipamento externo.
	.2		ONF_COM3	Indica que o canal COM3 está trocando dados com equipamento externo.
	.3		ONF_COM4	Indica que o canal COM4 está trocando dados com equipamento externo.
	.8		ONF_SOCK0	Indica que o canal do socket 0 está trocando dados com equipamento externo.
	.9		ONF_SOCK1	Indica que o canal do socket 1 está trocando dados com equipamento externo.
	.10		ONF_SOCK2	Indica que o canal do socket 2 está trocando dados com equipamento externo.
	.11		ONF_SOCK3	Indica que o canal do socket 3 está trocando dados com equipamento externo.
	.12		ONF_SOCK4	Indica que o canal do socket 4 está trocando dados com equipamento externo.
	.13		ONF_SOCK5	Indica que o canal do socket 5 está trocando dados com equipamento externo.
	.14		ONF_SOCK6	Indica que o canal do socket 6 está trocando dados com equipamento externo.
	.15		ONF_SOCK7	Indica que o canal do socket 7 está trocando dados com equipamento externo.
F 111			COM_ON_MSB_STS	Flags de canais de comunicação online (MSB).
	.0		ONF_CBUS	Indica que o canal CBUS está trocando dados com equipamento externo.
	.1..15			Reserva
F 112		R	COM_PORT_ID	Retorna o identificador de comunicação do canal que está sendo utilizado para obter esta informação. Para mais informações acesse Identificador dos canais de comunicação.
F 113		R	COM_RESOURCES	Flags de recursos de comunicação disponíveis.
	.0		CR_EXT_ID	Indica que o firmware do equipamento suporta endereçamento estendido no protocolo MODBUS. Para mais informações acesse ID de comunicação MODBUS.
	.1..15			Reserva
F 114..119				Reserva
F 120		R	DEV_ITFA1_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-A1. [12] Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 121		R	DEV_ITFA2_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-A2. Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 122		R	DEV_ITFB_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-B. Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 123		R	DEV_ITFC1_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-C1. Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 124		R	DEV_ITFC2_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-C2. Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 125		R	DEV_ITFD_TYPE	Indica o tipo de recurso de comunicação associado a interface de comunicação ITF-D. Para mais informações acesse Tipos de interface de comunicação disponíveis.
F 126..134				Reserva
F 135		R	COM_MODEM_SIG_QLY	Indica a qualidade do sinal da rede celular detectada pelo modem 4GA1-CMQ151. O valor apresentado varia de 0 a 100%. Esta variável é válida apenas para os módulos de modem 4GA1-CMQ151.
F 136		R	COM_MODEM_OPER_STS	Indica status do processo de conexão do modem 4GA1-CMQ151 com a rede celular. [0] = Falha de hardware [1] = Configuração do modem inválida [2] = Erro de SIMCard [10] = Sem rede celular [11] = Falha de autenticação na rede celular [12] = Modem em modo de configuração [15] = Erro no acesso ao servidor (ex: IP/porta inválidos) [19] = Modem com conexão estabelecida Esta variável é válida apenas para os módulos de modem modelo 4GA1-CMQ151. Para os outros modelos de modem consultar variável F-138.
F 137		R	ESP_PARM_INFO	Informações sobre os parâmetros adicionais dos módulos de modem 3G-SARA/NBIOT/LORA.
	.0..2		ESP_PARM_TYPE	Tipo e modo de operação do módulo associado a interface de comunicação ITF-B. [0] = Sem informação associada [1] = informações associadas ao Modem 3G-SARA [2] = informações associadas ao Modem NBIOT [3] = informações associadas ao módulo LORA (modo OTA) [4] = informações associadas ao módulo LORA (modo ABP)
	.3..6		RESERVA	Reserva
	.7		EN_STK	Se igual a 1 indica STK TOOL-KIT habilitado para modem 3G-SARA (utilizado com chips multi-operadora)
F 138		R	COM_MODEM_NSI	Indica status de conexão de rede do modem (network status indicator) para os modens 3G-SARA e NBIOT [0] = Modem não disponível [1] = Modem em reset [2] = Sem rede disponível / chip desconectado / procurando rede [3] = Rede 2G detectada [4] = Rede 3G detectada [5] = Rede 4G detectada (NBIOT) [6] = Rede 5G detectada [7] = Rede Roaming 2G detectada [8] = Rede Roaming 3G detectada Para modens do modelo 4GA1-CMQ151 consultar variável F-136.
F 140		R/W	COM_ETH_IP_LOW	Endereço IP do equipamento (low word) [11]
F 141		R/W	COM_ETH_IP_HIG	Endereço IP do equipamento (high word)
F 142		R/W	COM_ETH_GAT_LOW	Endereço IP do gateway do equipamento (low word)
F 143		R/W	COM_ETH_GAT_HIG	Endereço IP do gateway do equipamento (high word)
F 144		R/W	COM_ETH_MASK_LOW	Máscara de subrede do equipamento (low word)
F 145		R/W	COM_ETH_MASK_HIG	Máscara de subrede do equipamento (high word)
F 146		R/W	COM_ETH_DEST_IP_LOW	Endereço IP do equipamento destino (low word)
F 147		R/W	COM_ETH_DEST_IP_HIG	Endereço IP do equipamento destino (high word)
F 148		R/W	COM_ETH_DEST_PORT	Porta do equipamento destino
F 149		R	ETH_MAC_LOW	Endereço MAC do equipamento (low word)
F 150		R	ETH_MAC_MID	Endereço MAC do equipamento (mid word)
F 151		R	ETH_MAC_HIGH	Endereço MAC do equipamento (high word)
F 152..196				Reserva
F 197		R/W		Comandos associados à base de setup em RAM
	0			Desabilita PPE
	1			Habilita PPE
F 198		W		Comandos associados ao modem 3G-SARA/4G-EG915U/NBIOT/4GA1-CMQ151
	1			Habilita modem 3G-SARA/4G-EG915U/NBIOT
	2			Desabilita modem 3G-SARA/4G-EG915U/NBIOT
	4			Habilita modo configuração do modem 4GA1-CMQ151
	8			Habilita modo de operação do modem 4GA1-CMQ151
	16			Desativa (nível lógico 0) pino de PWR do modem 4GA1-CMQ151
	32			Ativa (nível lógico 1) pino de PWR do modem 4GA1-CMQ151
F 199		W	GLOB_COM_CMDS	Comandos globais relacionados ao protocolo de comunicação
	0x1000			Desabilita o retorno do ID de comunicação programado no equipamento na resposta de um pacote broadcast [13]
	0x2000			Habilita o retorno do ID de comunicação programado no equipamento na resposta de um pacote broadcast (default) [13]
	0x4000			Recupera base de setup atualmente salva na flash
	0x8000			Salva base de setup de comunicação

	[9] (1,2) Estes campos representam a faixa de endereços na qual o CLP repassa o pacote . recebido para o canal PPE associado. Por default, o endereço mínimo é 1 e o máximo é 254.
	[10] O número de sockets disponíveis depende do modelo do equipamento.
	[11] Para atualização do endereço IP do controlador, a variável F 140 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 141 este valor é composto com o valor previamente escrito na memória F 140 e o resultado é então atribuído como novo endereço IP do controlador.
	[12] Existem 6 possíveis interfaces de comunicação disponíveis na linha de equipamentos. Estas interfaces são nomeadas como ITF_A1, ITF_A2, ITF_B, ITF_C1, ITF_C2, ITF_D. O número. de interfaces e os recursos disponíveis podem variar dependendo da família e do modelo do equipamento. Para mais informações acesse Tipos de interface de comunicação disponíveis.
	[13] (1,2) Por default, quando for enviado para um escravo um pacote de comunicação MODBUS com o id. de comunicação igual a 255 (endereço broadcast), o pacote retornado pelo equipamento remoto possuirá o endereço de comunicação programado no equipamento escravo. Quando enviado o comando 0x1000 para a variável F199 as transações MODBUS subsequentes irão retornar no pacote de resposta o endereço de comunicação enviado mesmo quando o endereço for o de broadcast. O comando 0x2000 retorna o comportamento da resposta MODBUS para a condição padrão utilizada no firmware G5.

Identificador dos canais de comunicação

Nome	Ident.	Descrição
HILS.COM1_PORT_ID	0	Canal serial COM1
HILS.COM2_PORT_ID	1	Canal serial COM2
HILS.COM3_PORT_ID	2	Canal serial COM3
HILS.COM4_PORT_ID	3	Canal serial COM4
HILS.COM5_PORT_ID	4	Canal serial COM5
HILS.COM6_PORT_ID	5	Canal serial COM6
HILS.COM7_PORT_ID	6	Canal serial COM7
HILS.COM8_PORT_ID	7	Canal serial COM8
HILS.SOCK0_PORT_ID	8	Controlador Ethernet 1: Socket 0
HILS.SOCK1_PORT_ID	9	Controlador Ethernet 1: Socket 1
HILS.SOCK2_PORT_ID	10	Controlador Ethernet 1: Socket 2
HILS.SOCK3_PORT_ID	11	Controlador Ethernet 1: Socket 3
HILS.SOCK4_PORT_ID	12	Controlador Ethernet 1: Socket 4
HILS.SOCK5_PORT_ID	13	Controlador Ethernet 1: Socket 5
HILS.SOCK6_PORT_ID	14	Controlador Ethernet 1: Socket 6
HILS.SOCK7_PORT_ID	15	Controlador Ethernet 1: Socket 7
HILS.ETH2_SOCK0_PORT_ID	16	Controlador Ethernet 2: Socket 0
HILS.ETH2_SOCK1_PORT_ID	17	Controlador Ethernet 2: Socket 1
HILS.ETH2_SOCK2_PORT_ID	18	Controlador Ethernet 2: Socket 2
HILS.ETH2_SOCK3_PORT_ID	19	Controlador Ethernet 2: Socket 3
HILS.ETH2_SOCK4_PORT_ID	20	Controlador Ethernet 2: Socket 4
HILS.ETH2_SOCK5_PORT_ID	21	Controlador Ethernet 2: Socket 5
HILS.ETH2_SOCK6_PORT_ID	22	Controlador Ethernet 2: Socket 6
HILS.ETH2_SOCK7_PORT_ID	23	Controlador Ethernet 2: Socket 7

	Este texto pode ser utilizado como parâmetro pois esta definido no tipo COMM_CHAN_ID disponível na biblioteca HI_STD.
	Cada equipamento possui um sub-conjunto dos recursos de comunicação indicados na tabela acima. Para identificar quais recursos estão disponíveis em um dado equipamento, consulte o manual do mesmo.

Tipos de interface de comunicação disponíveis

Identificador	Código	Descrição	ITF-A1	ITF-A2	ITF-B	ITF-C1	ITF-C2	ITF-D
cvy_not_avail	0	recurso não disponível
cvy_rs232	1	canal RS232-C simples (TX/RX)	X	X	X	X	X	X
cvy_rs232_full	2	canal RS232-C com suporte (RTS/CTS)	X			X
cvy_rs485	16	canal RS485			X			X
cvy_rs235	17	canal RS232-C simples ou RS485	X			X
cvy_3g_sara (*)	32	modem 3G			X			X
cvy_nbiot_r410m (*)	33	modem NBIOT			X			X
cvy_4g_eg915u	34	modem 4G EG915U da QUECTEL			X			X
cvy_4g_cmq151	35	modem 4G (compatível com a CMQ151)			X			X
cvy_eth_wiz	48	canal ethernet	X		X	X		X
cvy_wifi_esp07 (*)	65	canal com módulo WIFI			X			X
cvy_wifi_cmf233	66	canal com módulo WIFI			X			X
cvy_900_s3b	81	canal com módulo 900Mhz/250mW			X			X
cvy_lora_m1	82	canal com módulo LORA			X			X
cvy_cbus_p7c	112	canal CBUS (P7C apenas)						X

Legenda: (*) Módulo de comunicação obsoleto.

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 * 20 + 200 onde:

n representa o número 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 200 .. F 219	Canal COM1
F 220 .. F 239	Canal COM2
F 240 .. F 259	Canal COM3
F 260 .. F 279	Canal COM4
F 280 .. F 299	Canal COM5
F 300 .. F 319	Canal COM6
F 320 .. F 339	Canal COM7
F 340 .. F 359	Canal COM8
F 360 .. F 379	Socket ethernet 0. Socket de controle [14] [15].
F 380 .. F 399	Socket ethernet 1.
F 400 .. F 419	Socket ethernet 2.
F 420 .. F 439	Socket ethernet 3.
F 440 .. F 459	Socket ethernet 4.
F 460 .. F 479	Socket ethernet 5.
F 480 .. F 499	Socket ethernet 6.
F 500 .. F 519	Socket ethernet 7. [16]
F 520 .. F 539	Socket ethernet 0. (controlador ethernet 2)
F 540 .. F 559	Socket ethernet 1. (controlador ethernet 2)
F 560 .. F 579	Socket ethernet 2. (controlador ethernet 2)
F 580 .. F 599	Socket ethernet 3. (controlador ethernet 2)
F 600 .. F 619	Socket ethernet 4. (controlador ethernet 2)
F 620 .. F 639	Socket ethernet 5. (controlador ethernet 2)
F 640 .. F 659	Socket ethernet 6. (controlador ethernet 2)
F 660 .. F 679	Socket ethernet 7. (controlador ethernet 2)
F 680 .. F 699	Canal CBUS (exclusivo para p/ P7C)

	[14] 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.
	[15] O socket de controle (socket 0) não é avaliado para contabilizar as informações estatísticas de variáveis relativas ao canal ethernet.
	[16] O número de sockets disponíveis pode variar dependendo do equipamento ou versão de firmware utilizado.

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

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		Reserva
	.4	R	COF_CON_TCP	Quando canal é um socket ethernet, indica canal com conexão TCP estabelecida. Reserva para os demais tipos de canais.
	.5	R	COF_AUTH_V1	Indica se o canal esta habilitado para autenticação V1. Este contexto se aplica também aos canais seriais quando conectados internamente a módulos de Modem.
	.6	R	COF_ID_ON_CONN	Indica se o canal esta habilitado para envio de string de identificação ao estabelecer conexão (id_on_connection). Este contexto se aplica também aos canais seriais quando conectados internamente a módulos de Modem.
	.7-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	SOCKET_PORT	Quando canal é um socket ethernet, mantém a porta ethernet associada ao socket. [17] 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		R/W	ETH_CONN_CRIT	Lê e configura o critério de conexão Ethernet de um socket servidor. [0] = Conexão aceita por qualquer ip e porta [1] = Conexão aceita apenas por ip definido [2] = Conexão aceita apenas por porta definida [3] = Conexão aceita apenas por ip e porta definida. Retorna 0 para os demais tipos de canais.
F Cn+9		R/W	TCP_CONN_CNT	Contador de conexões TCP abertas com sucesso pelo socket. Retorna 0 para os demais tipos de canais.
F Cn+10		R/W	TCP_CONN_TRIES	Contador de tentativas de conexões realizadas pelo socket. Retorna 0 para os demais tipos de canais.
F Cn+11		R/W	TCP_CUR_INAC_TMO	Valor corrente do contador de inatividade em 0.1 seg
F Cn+12		R/W	EXT_RESP_TMO	Tempo adicional em ms para resposta de uma transação cliente
F Cn+13		R/W	INTER_CHAR_TMO	Tempo máximo entre caracteres em ms para término do pacote recebido. Disponível apenas para os canais seriais. Retorna 0 para os demais tipos de canais.
F Cn+14		R/W	COMM_CACHE_LEN	Tamanho em bytes da cache de dados do canal de comunicação associado. Retorna 0 se o canal especificado não existir ou não for inicializado no equipamento.
F Cn+15..17				Reserva.
F Cn+18		W	SER_CTRL_PIN	Define estado do pino de controle dos canais seriais (quando disponível).
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.

[17] O socket 0 (memória F 366) pode ser acessado apenas para leitura. Escrita neste parâmetro irá retornar erro indicando que o parâmetro é apenas de leitura.

Atenção

Quando qualquer parâmetro de comunicação for alterado, para que os novos valores sejam processados o controlador necessita ser reinicializado.

Configuração do canal de comunicação

O endereço Cn+4 mantém 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				MDBcfg	Modo do protocolo	Res.		Stop	Paridade		Data	BaudRate
0:ASCII				0: [18]	0:ESCRAVO/MESTRE			0:1	0:nenhuma		0:7 bits	0:1200 bauds
1:ASCII+SOF				1: [19]	1:MESTRE [20]			1:2	1:par		1:8 bits	1:2400 bauds
2:ASCII_EOF									2:impar			2:4800 bauds
3:ASCII+SOF+EOF												3:9600 bauds
6:MQTT Client												4:19200 bauds
8:MODBUS-RTU												5:38400 bauds
9:MODBUS-TCP												6:57600 bauds
10: HTTP Server												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.	Modo	MDBcfg	Modo do protocolo	Reserva
0:ASCII				0:TCP	0:SERVER	0: [18]	0:ESCRAVO/MESTRE
1:ASCII + SOF				1:UDP	1:CLIENT	1: [19]	1:MESTRE [20]
2:ASCII + EOF
3:ASCII + SOF+EOF
6:MQTT Client
8:MODBUS-RTU
9:MODBUS-TCP
10: HTTP Server
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 360 .. F 379) podem ser acessados apenas para leitura. A escrita nestes parâmetros não será persistida.

Mapeamento de Cn+4 para o canal CBUS (controlador P7C apenas)

Para o canal CBUS, o campo Cn+4 é mapeado em bits, possuindo o seguinte formato:

BITS
Protocolo				MDBcfg	Modo do protocolo	Não usado
8:MODBUS-RTU				0: [18]	0:ESCRAVO/MESTRE	0
15	14	13	12	11	10	9..0

	[18] (1,2,3) Este campo é utilizado apenas no protocolo MODBUS operando como mestre. Quando igual a 0 o protocolo utiliza apenas os comandos de escrita WRITE_MULTIPLE_COINS (15) e WRITE_MULTIPLE_REGISTER (16) mesmo quando o número de variáveis a serem escritas for igual a 1.
	[19] (1,2) Este campo é utilizado apenas no protocolo MODBUS operando como mestre. Quando igual a 1 o protocolo utiliza os comandos de escrita WRITE_SINGLE_COIN (5) e WRITE_SINGLE_REGISTER (6) quando o número de variáveis a serem escritas for igual a 1.
	[20] (1,2) Este campo é utilizado apenas no protocolo MODBUS. O estado default é ESCRAVO/MESTRE. Nesta condição o canal opera como ESCRAVO por default e caso a aplicação envie algum pacote o protocolo comuta automaticamente para MESTRE, retornando para ESCRAVO após o término da transação. Quando configurado como MESTRE apenas; os pacotes recebidos que não forem respostas de um comando enviado são descartados.