GET_CONN_FROM_ITF

Retorna o código de conectividade configurado na interface de comunicação especificada pelo seu identificador. É uma função (sem estado interno; o valor é retornado diretamente na chamada).

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

        GET_CONN_FROM_ITF
         +-------------+
USINT ---|ITF          |--- USINT
         +-------------+

Cada interface disponível no modelo do equipamento possui uma conectividade definida. A função recebe o identificador da interface (ITF) e retorna o código da conectividade associada a ela. As conectividades disponíveis variam conforme a família e o modelo do equipamento.

Os equipamentos possuem um padrão no qual podem ser alocadas até 6 interfaces de comunicação, distribuídas em até 2 módulos de hardware. Cada interface é identificada pelo seu ID, conforme a tabela a seguir.

Table 1 Identificadores de interface (ITF)

Label	ID	Descrição
ITF-A1	0	Interface de comunicação A1
ITF-A2	1	Interface de comunicação A2
ITF-B	2	Interface de comunicação B
ITF-C1	3	Interface de comunicação C1
ITF-C2	4	Interface de comunicação C2
ITF-D	5	Interface de comunicação D

Nota

As interfaces ITF-A e ITF-C possuem 2 canais quando a conectividade for serial e apenas 1 canal quando a conectividade for ethernet.

As conectividades são agrupadas nas seguintes classes.

Table 2 Classes de conectividade

Label	ID	Descrição
cvc_none_class	-1	Sem classe
cvc_asc232_class	0	Classe de comunicação RS232-C
cvc_asc485_class	1	Classe de comunicação RS485
cvc_modem_class	2	Classe de comunicação modem celular
cvc_ether_class	3	Classe de comunicação ethernet
cvc_wifi_class	4	Classe de comunicação wifi
cvc_wireless_class	5	Classe de comunicação de rádio dados
cvc_usb_class	6	Classe de comunicação USB
cvc_cbus_class	7	Classe de comunicação CBUS (controlador P7C)

O valor retornado pela função corresponde a uma das conectividades da tabela abaixo.

Table 3 Conectividades disponíveis (valor de retorno)

Label	ID	Classe	Descrição
cvy_not_avail	0	cvc_none_class	Recurso não disponível
cvy_rs232	1	cvc_asc232_class	Canal RS232-C simples (TX/RX)
cvy_rs232_full	2	cvc_asc232_class	Canal RS232-C com suporte (TX/RX/RTS/CTS)
cvy_rs485	16	cvc_asc485_class	Canal RS485
cvy_rs235	17	cvc_asc485_class	Canal RS232-C simples (TX/RX) ou RS485
cvy_3g_sara	32	cvc_modem_class	Canal G3 com chip ublox sara
cvy_4g_eg915u	34	cvc_modem_class	Canal com modem 4G EG915U da QUECTEL
cvy_4g_cmq151	35	cvc_modem_class	Canal com modem 4G firmware com autoconexão (compatível com a CMQ151)
cvy_eth_wiz	48	cvc_ether_class	Canal ethernet com WIZNET 5500
cvy_900_s3b	81	cvc_wireless_class	Canal com módulo XBEE 900Mhz - S3B
cvy_lora_m1	82	cvc_wireless_class	Canal com módulo LORA
cvy_usb_cnv	96	cvc_usb_class	Canal de comunicação com o módulo USB
cvy_cbus_p7c	112	cvc_cbus_class	Canal de comunicação com os módulos do P7C via CBUS
cvy_invalid	255	—	Canal de comunicação inválido

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
ITF	IN	USINT	—	0 .. 5	Identificador da interface de comunicação (ver tabela de interfaces).

Retorno / Saídas

Tipo: USINT

Código da conectividade associada à interface de comunicação especificada (ver tabela Conectividades disponíveis).

Observações

• A conectividade retornada depende da família e do modelo do equipamento; nem todas as interfaces existem em todos os modelos.

Ver também

GET_ITF_FROM_CCLASS para obter a interface associada a uma dada classe de conectividade.

Exemplo

Código ST

// Identifica a ação a ser tomada se existir uma interface ethernet (48) na ITF-A1 (0)
IF HILS.GET_CONN_FROM_ITF(0) = 48 THEN
    (* ... *)
END_IF;