Dispositivos

A página do dispositivo: cabeçalho e verbos, o cartão Dispositivo, o cartão Conexão com os campos que cada driver mostra, credenciais e certificados, a grade de Tags com edição em massa, copiar um dispositivo e como duplicatas e colisões de nome são tratadas.

Um dispositivo é um equipamento com que a estação conversa por um driver: como ele é alcançado e as tags lidas dele. Selecione a linha de um dispositivo na coluna Comunicação, ou pressione Abrir na linha de um dispositivo na tabela de um driver, de uma linha, de um broker ou de uma pasta, para abrir a página dele. Ver Connector lê a página; Configurar Connector a edita. Linhas seriais têm página própria, Linhas seriais, e os brokers MQTT são descritos em MQTT.

Criar um dispositivo

Um dispositivo novo se chama "Novo dispositivo" (depois "Novo dispositivo 2", e assim por diante), nasce habilitado, com intervalo de leitura de 1000 ms, unit id 1 e a porta que o driver dele usa (veja o cartão Conexão abaixo; um dispositivo do driver Generic serial and TCP nasce sem nenhuma), e ele não é aberto: aparece destacado, rolado até ficar à vista, na tabela Dispositivos da página que o lista (a do driver, da pasta, da linha ou do broker), e o feed mostra "Dispositivo 'Novo dispositivo' acrescentado. Abra-o para editar os detalhes dele." A partir dessa tabela a tela fica onde está; a partir do Novo… ou do menu de contexto, ela vai para essa página. O Abrir da linha, ou a linha dele na árvore, abre o dispositivo. Um dispositivo é recusado sob um driver que o pacote não carrega e sob o Matter, onde um dispositivo só vem de pareamento ou de descoberta ("Use Parear dispositivo para acrescentar um nó Matter novo, ou Descobrir para acrescentar um já comissionado."). Todos esses gestos ficam sob um driver já acrescentado; acrescentar um está descrito em A lista de drivers e a página de um driver.

Um dispositivo cujo driver chega ao equipamento por um host (todo driver com o campo Host ou IP) nasce com esse host vazio, e a estação não tenta conectá-lo até o host ser informado: o ponto dele fica cinza, a linha e a página dizem "Host ainda não informado", as tags dele leem lacunas, e nenhum erro de conexão pode aparecer antes de existir um endereço a tentar. Enquanto isso ele nunca é apontado para este computador; para um equipamento que está mesmo neste computador, informe localhost. Um dispositivo NI-DAQmx não tem host: ele espera da mesma forma pelo Nome do dispositivo, e diz "Dispositivo NI-DAQmx ainda não informado" até ter um (veja NI-DAQmx). Um dispositivo Fluke NetDAQ espera pelo host e depois pelo Canal base do seu instrumento, e diz "Canal base ainda não informado" até ter um (veja Fluke NetDAQ). Um dispositivo File espera pelo Caminho da pasta, e diz "Pasta ainda não informada" até ter uma (veja File). Um dispositivo Database espera pelo lugar do banco de dados dele (o servidor e o nome do banco de dados, o arquivo ou a origem de dados), e diz "Servidor ainda não informado" até ter um servidor (veja Database). Um dispositivo LoRaWAN espera pelo Identificador DevEUI (um sensor) ou pelo EUI da estação (um concentrador), e diz "DevEUI ainda não informado" ou "EUI da estação ainda não informado" até ter um (veja LoRaWAN); um identificador que foi informado e não tem 16 dígitos hexadecimais não é esperado, e sim recusado.

Depois que ele tem um host, conectar nunca é um passo que bloqueia: o Connector integra o dispositivo e conecta num laço de tentativas em segundo plano, então um dispositivo inalcançável não custa nada. As tags dele leem lacunas até a conexão acontecer, e a página mostra o último erro de conexão enquanto isso.

O cabeçalho

O nome, a frase "Um equipamento com que esta estação conversa: como ele é alcançado e as tags lidas dele." e uma pílula com o Base URI, o endereço exato a que o Connector se conecta, montado ao vivo a partir do cartão Conexão (por exemplo modbus+tcp://192.168.0.10:502/1, opc.tcp://plc:4840, simulated://CompressedAir). Um dispositivo ainda sem host não tem Base URI, então a pílula não aparece até o host ser informado. Ela também não aparece enquanto os campos não formam um endereço que o driver aceite, por exemplo num dispositivo Modbus RTU cuja linha está faltando, ou cuja linha tem um valor que a página dela não salvou. Abaixo dele, um de seis avisos:

• Driver não incluído neste pacote: "Este dispositivo precisa do driver …, que esta instalação não inclui, então ele fica desconectado. Os ajustes dele são mantidos e ele pode ser excluído; nada mais aqui muda o que ele lê." As reticências ficam no lugar do nome do driver.
• O VISA não está instalado neste computador (SCPI instruments, um dispositivo alcançado pelo VISA): "Este dispositivo chega ao instrumento pelo VISA, que este computador não tem, então ele fica desconectado. Instale o NI-VISA ou o Keysight IO Libraries Suite e o dispositivo se conecta. Um instrumento com porta de rede também pode ser alcançado por TCP." Veja SCPI instruments.
• O NI-DAQmx não está instalado neste computador (NI-DAQmx, num computador sem ele): "Este dispositivo é lido pelo NI-DAQmx, que este computador não tem, então ele fica desconectado. O Ganter Lab não inclui o NI-DAQmx: instale-o, gratuito em ni.com, e o dispositivo se conecta com a configuração que já tem." Veja NI-DAQmx.
• Esperando a aprovação do certificado (OPC UA, Redfish, AVEVA PI, HTTP por HTTPS, MQTT por TLS): "Este equipamento apresentou um certificado que esta estação nunca aprovou, então nada é lido dele ainda. Confira a impressão digital com quem comissionou o equipamento e depois aprove em Acesso a equipamentos, na página do driver OPC UA.", com o driver do próprio dispositivo nomeado, ou para um dispositivo MQTT "O broker deste dispositivo apresentou um certificado que esta estação nunca aprovou, então nada é lido do dispositivo ainda. Confira a impressão digital com quem administra o broker e depois aprove em Acesso a equipamentos, na página do driver MQTT.", com um botão Revisar o certificado que abre o Acesso a equipamentos da página do driver naquele certificado (OPC UA, Redfish, AVEVA PI, HTTP, MQTT).
• Host ainda não informado, um aviso neutro num dispositivo habilitado cujo host ainda está vazio: "A estação não tenta se conectar a este dispositivo enquanto ele não tiver host, então nada é lido dele ainda e não há erro a mostrar. Informe o host no cartão Conexão abaixo e a estação se conecta a ele." Um dispositivo NI-DAQmx sem o nome do dispositivo diz Dispositivo NI-DAQmx ainda não informado no lugar: "A estação não tenta se conectar a este dispositivo enquanto ele não tiver o nome de um dispositivo NI-DAQmx, então nada é lido dele ainda e não há erro a mostrar. Informe o nome que o NI MAX dá ao dispositivo no cartão Dispositivo NI-DAQmx abaixo e a estação se conecta a ele." Um dispositivo File sem pasta diz Pasta ainda não informada: "A estação não lê este dispositivo enquanto ele não tiver uma pasta, então nada é lido dele ainda e não há erro a mostrar. Informe a pasta no cartão Pasta e arquivo abaixo e a estação começa a lê-lo." Um dispositivo Database que não diz onde está o banco de dados dele diz Servidor ainda não informado, Nome do banco de dados ainda não informado, Arquivo do banco de dados ainda não informado ou Origem de dados ainda não informada, conforme o que ainda falta: "A estação não alcança este dispositivo enquanto ele não disser onde está o banco de dados dele, então nada é lido dele ainda e não há erro a mostrar. Informe isso no cartão Banco de dados abaixo (o servidor e o nome do banco de dados, o arquivo ou a origem de dados) e a estação se conecta a ele."
• Caso contrário, num dispositivo que passa por uma linha serial ou um broker com erro, um aviso neutro que aponta para lá, "Este dispositivo passa pela linha serial Bench bus, que está com erro. A página da linha diz por quê.", ou então o erro próprio do dispositivo em vermelho, quando existe um (veja Habilitação e saúde).

Abaixo deles, o dispositivo nomeia as tags que têm erro próprio, depois do mesmo marcador vermelho que a árvore mostra: "3 tags com erro: C3, Opt_Int, T5", e as demais contadas depois de três nomes. O motivo de cada uma fica na tag. Enquanto o dispositivo não está conectado, ele não nomeia nenhuma: o erro dele diz por quê.

A barra de comandos

O menu de contexto acrescenta Acrescentar tag e Mover para (veja Pastas de dispositivos).

O cartão Dispositivo

O cartão Conexão

O cartão aparece para todo driver que declara campos de conexão e mostra só os campos que aquele driver lê. A página de cada driver explica os campos dele a fundo; este é o inventário completo, como o painel o desenha.

Um dispositivo Matter mostra um cartão Conexão diferente: ID do nó · somente leitura, o node id de 64 bits que o pareamento atribuiu (ou "Precisa de novo pareamento" quando a identidade guardada não pode ser lida), Rede · somente leitura, o nome da rede em que o dispositivo entrou quando foi pareado (um dispositivo pareado antes de o Ganter Lab registrá-lo, ou acrescentado com Descobrir, diz que ele não foi registrado), e Estado, a palavra de saúde do dispositivo. Nada nele é editável. Um dispositivo Simulated não tem cartão Conexão nenhum. Um dispositivo do driver Generic serial and TCP traz mais dois cartões abaixo do cartão Conexão, Mensagens e Soma de verificação, que dizem como uma mensagem termina e como é conferida; veja Generic serial and TCP. Um dispositivo Omron lido por FINS traz um cartão FINS abaixo do cartão Conexão, com o transporte, a rede, os nós, a unidade e o timeout de resposta; veja Omron. Um dispositivo do driver SCPI instruments traz um cartão Instrumento abaixo do cartão Conexão, com a identidade do instrumento, o terminador, o timeout de resposta, a confirmação de escrita e os comandos de preparação; veja SCPI instruments. Um dispositivo NI-DAQmx não tem cartão Conexão: o cartão Dispositivo NI-DAQmx fica no lugar dele, com o nome que o NI MAX dá ao dispositivo e o produto que o NI-DAQmx lê dele; veja NI-DAQmx. Um dispositivo do driver SNMP traz um cartão Agente SNMP abaixo do cartão Conexão, com a versão, a community ou o usuário SNMPv3 com o nível de segurança, os protocolos e as senhas, o timeout de resposta e as novas tentativas; veja SNMP. Um dispositivo File não tem cartão Conexão: o cartão Pasta e arquivo fica no lugar dele, com a pasta, o arquivo e o formato, seguido do cartão Texto do arquivo e, num dispositivo que lê um arquivo, do cartão Escrita; veja File. Um dispositivo Database não tem cartão Conexão: o cartão Banco de dados fica no lugar dele, com o tipo de banco de dados e onde ele está, seguido do cartão Entrada em todo banco de dados menos o SQLite; veja Database.

Credenciais e certificados

Senhas, tokens bearer e communities SNMP ficam protegidos em repouso pela proteção de dados do Windows por usuário, então o banco de configuração nunca guarda o valor em claro. Essa proteção está atrelada à conta do Windows e à máquina que digitou o segredo: em outra conta o campo volta vazio, com a nota "Não pode ser lido nesta conta do Windows: ele só abre na máquina e na conta do Windows que o digitou. Digite de novo aqui." As credenciais são entregues direto ao driver; elas nunca aparecem no Base URI nem no diário, e são ocultadas das mensagens de erro que o feed de ações mostra.

Um dispositivo OPC UA apresenta o certificado do equipamento antes de uma sessão abrir, e o mesmo faz o equipamento que um dispositivo Redfish, AVEVA PI ou HTTP alcança por HTTPS, ou o broker de um dispositivo MQTT por TLS. Um certificado em que o Windows não confia e que esta estação nunca aprovou não falha em silêncio: o dispositivo mostra "Esperando a aprovação do certificado" na árvore e na página, e o botão do aviso abre o Acesso a equipamentos da página do driver dele no certificado, para aprovar ou bloquear. Revogar uma aprovação depois encerra as conexões que rodam sobre ela. Os detalhes estão na página de cada driver: OPC UA, Redfish, AVEVA PI, HTTP e MQTT.

O cartão Comandos

Três drivers alcançam equipamentos a que se pede fazer coisas, além de ler: HTTP, Redfish e AVEVA PI. A página de dispositivo deles carrega um cartão Comandos entre os cartões Conexão e Tags, com o título "O que se pode pedir a este equipamento. Cada comando nomeia o caminho a que o pedido é enviado, sob o endereço do dispositivo." Todo mundo vê a lista; declarar, editar e disparar exigem Configurar Connector, e um papel sem o bit não recebe nem os campos nem os verbos.

Adicionar comando acrescenta uma linha chamada "Comando 1" (numerada depois do que já existe). Cada linha carrega:

O grupo final leva os dois verbos que agem só naquela linha: Executar, que a envia e relata o que o equipamento respondeu ("'Reset' respondeu: aceito"), e Excluir. Executar diz por que é recusado, em vez de sumir: um comando sem caminho ("Este comando ainda não tem caminho, então não há o que enviar."), um comando desligado, um que ainda espera ser salvo no runtime, um dispositivo que não está conectado e o próprio limite de engenharia ou de execução da estação. Os outros drivers não carregam o cartão de jeito nenhum: um ponto de recarga também recebe comandos, mas os dele são fixados pelo protocolo e vêm do driver, não do que você digita aqui, e um nó Matter não recebe nenhum, porque toda mudança nele é uma escrita numa das tags dele.

Disparar é uma escrita no equipamento, então Executar passa pelo mesmo funil da escrita manual de um tag: o comando espera a vez dele atrás do que a estação já está fazendo, chega ao equipamento pelo mesmo caminho que uma chamada de um sistema de fora toma, e o acionamento fica registrado com o que foi pedido, em qual dispositivo e o que voltou. Enquanto a estação parou de aceitar trabalho, o acionamento é respondido em vez de ficar mudo: "A estação não está aceitando comandos agora." Um Connector que não está em execução responde "O Connector não está em execução, então nada pode ser enviado ao equipamento.", e uma recusa do próprio equipamento chega com as palavras dele. Um comando que o Connector não conseguiu executar diz o que encontrou na língua da estação, como a faixa vermelha de um dispositivo diz: "O dispositivo não está conectado, então nada foi enviado a ele." para um dispositivo que caiu, o dispositivo que não respondeu a tempo, uma requisição que a rede recusou ou o driver que falhou; o diário guarda a linha técnica.

O cartão Tags

O cartão tem o título Tags, depois "Formato de endereço · <hint>" dizendo como este driver endereça uma tag ("Nome de tag livre (por exemplo sim/temperature).", "Número do registrador + quantidade (campos tipados).", "ID do nó, por exemplo ns=2;s=Temperature."), e, para Configurar Connector, a instrução "Marque as linhas e depois edite uma célula para aplicar a todas elas. As marcas são limpas quando a edição é aplicada." mais o botão Acrescentar tag. Acrescentar tag cria "Tag 5" (numerada depois da contagem) como Float, ou como o primeiro tipo que o driver suporta, Somente leitura. A tag não é aberta: aparece destacada na grade, dentro do grupo do tipo dela e rolada até ficar à vista, onde os campos dela são editados na linha, e o Abrir dela leva à página dela. O feed mostra "Tag acrescentada a 'Furnace'." ou, quando a tag nova ainda precisa de algo, "Tag acrescentada a 'Furnace'. Preencha os detalhes na linha dela." No menu Novo… da coluna, a entrada de um dispositivo oferece Nova tag, e o menu de contexto do dispositivo Acrescentar tag: os dois levam a tela para a página do dispositivo e fazem o mesmo. Ao lado do botão Acrescentar tag, onde o driver do dispositivo consegue ler os pontos de um dispositivo só, fica Descobrir tags: varre o dispositivo atrás dos valores que ele publica e oferece os que ainda não têm tag (veja Descobrir as tags de um dispositivo).

A grade

As linhas são agrupadas por tipo de dado, nesta ordem: Numérico, Booleano, Texto e outros, cada grupo encabeçado pela sua contagem. As colunas seguem a ordem dos cartões da página da tag; uma célula que não se aplica a uma linha (um campo numérico numa tag booleana) é desenhada vazia e desabilitada.

Os três interruptores de estágio são colunas como os campos que governam, e são editados em massa junto com eles: marcar linhas, digitar os coeficientes e ligar o estágio muda o que aquelas linhas leem na mesma edição, sem abrir ponto por ponto. O que a grade ainda não carrega são as políticas de leitura inválida, os assistentes de dois pontos, o campo de escrita e as referências cruzadas: esses estão na página da tag. Um papel só de Calibrar lê a grade e não edita nada nela, nem as células Cal nem o interruptor Cal ligada; as calibrações dele passam pela página da tag.

Edição em massa

Marque as linhas a alterar e depois edite uma célula de qualquer linha: o valor novo é aplicado àquela linha e a toda linha marcada, e as marcas são gastas. Enquanto há linhas marcadas, uma faixa acima da grade diz "3 linhas selecionadas. Editar uma célula aplica a todas elas e limpa as marcas." com um botão Limpar a seleção. As marcas pertencem ao dispositivo: voltar a ele mais tarde as encontra limpas. Três regras mantêm honesta uma seleção mista: Nome e Endereço nunca replicam; a célula Tipo ajusta os campos dependentes de cada linha assim que cai; e um valor que uma linha não aceita é recusado para aquela linha e mantido como estava, que é como uma linha String sobrevive a receber um tipo de sinal numérico, e uma linha inteira a receber uma ação de limite NaN.

Copiar o dispositivo

Copiar o dispositivo cria um dispositivo seu a partir do selecionado: os mesmos campos de conexão e as mesmas credenciais, toda tag clonada sob uma identidade nova com a cadeia de valor inteira, o estado habilitado e o intervalo de leitura. A cópia assume o nome da origem enquanto ele estiver livre no driver, depois "Furnace (2)", "Furnace (3)", e cai no nível do próprio driver, seja qual for a pasta da origem; uma cópia Modbus RTU fica na mesma linha, sob o próximo unit id livre, uma cópia numa linha do driver Generic serial and TCP ou do driver SCPI instruments fica nessa linha, e uma cópia MQTT no mesmo broker, a Sparkplug B com o ID mais interno numerado do mesmo jeito ("Press1 (2)") para que dois dispositivos do broker nunca nomeiem a mesma identidade. A cópia não é aberta: a tela vai para a página que a lista (o driver, a linha ou o broker), com a cópia destacada na tabela Dispositivos dela e rolada até ficar à vista, o original ao lado: "'Furnace' copiado para 'Furnace (2)'. Abra a cópia para editá-la." Uma cópia Omron numa linha fica nessa linha com o próximo número de unidade livre.

Duplicatas e colisões

Nomes de dispositivo são únicos dentro de um driver, ignorando maiúsculas e minúsculas: os verbos de criação desviam com um sufixo numérico, e uma renomeação para um nome ocupado é recusada ao confirmar. Dois dispositivos habilitados sob um driver cujos nomes normalizam para o mesmo segmento técnico (Line A e Line-A) ficam os dois fora da leitura cíclica, em vez de um vencer, e as tags deles não leem nada até que um seja renomeado ou desabilitado. A identidade técnica é limitada a 128 caracteres: "A identidade técnica do dispositivo não pode passar de 128 caracteres." Dois dispositivos Modbus TCP podem compartilhar host e porta com unit ids diferentes, e passam então a compartilhar o ritmo de transações do endpoint. Dois dispositivos Matter podem nomear o mesmo node id: a descoberta oferece abrir o existente, mas não proíbe o segundo. Dois dispositivos NI-DAQmx podem ler o mesmo dispositivo do NI MAX da mesma forma, por exemplo um módulo em dois intervalos de leitura.

O que a página do dispositivo não faz

O driver não pode ser trocado, a pasta não é editada aqui e nem a linha de um dispositivo de linha serial nem o broker de um dispositivo MQTT podem ser reatribuídos; um dispositivo do driver Generic serial and TCP troca entre TCP e UDP, e um do driver SCPI instruments entre TCP e VISA, nunca entre uma linha e a rede. Habilitar um dispositivo não habilita as tags dele, e desabilitar um dispositivo não vira as delas. Não existe importação nem exportação por dispositivo, e nenhum teste de conexão além de habilitar o dispositivo e ler a saúde e o Último erro dele. Um dispositivo Omron alterna entre UDP e TCP, nunca entre uma linha e a rede.