# A lista de drivers e a página de um driver

> O catálogo de todos os drivers desta estação na pasta Drivers, onde um driver é acrescentado, aberto e removido, e a página de um driver: Atualizar, Descobrir, Parear dispositivo e Remover o driver na barra, Acrescentar dispositivo, Acrescentar linha e Acrescentar broker à direita do título da tabela que fazem crescer, o cartão Escopo da varredura, a tabela de dispositivos e o estado de um driver que o pacote não carrega.

Duas superfícies da página Connector falam de drivers, e não de dispositivos. A pasta **Drivers**, a primeira da árvore da coluna Comunicação, abre o catálogo: todos os drivers que esta instalação carrega, primeiro os acrescentados à estação e depois os demais agrupados pelos equipamentos que alcançam. Um **driver** abre a sua própria página, pela linha dele sob a pasta Drivers ou por **Abrir** na linha dele no catálogo: seus dispositivos (ou, no Modbus RTU, suas linhas seriais, no Generic serial and TCP e no SCPI instruments, suas linhas seriais e seus dispositivos, e no MQTT, seus brokers) e os verbos que fazem o galho crescer. As duas ficam visíveis com Ver Connector; acrescentar e remover um driver e os verbos de criação exigem Configurar Connector. O Omron, como o Generic serial and TCP, mostra as linhas seriais e os dispositivos dele.

## O catálogo {#the-catalog}

O cabeçalho mostra **Drivers** com a frase "Todos os drivers que esta estação traz: primeiro os acrescentados a ela, sob Nesta estação, depois os demais agrupados pelos equipamentos que alcançam. Acrescente os que você usa: um driver acrescentado fica na árvore, com ou sem dispositivos." e uma pílula que conta o catálogo e os dispositivos: "25 drivers · 3 dispositivos", com as linhas seriais no meio assim que existe uma ("25 drivers · 1 linha · 3 dispositivos").

### A tabela {#the-table}

| Coluna | O que mostra |
| --- | --- |
| **Driver** | O nome de exibição. |
| **Descrição** | A descrição de uma linha do driver, ou "Driver não incluído neste pacote." para um driver que o pacote não carrega. |
| **Dispositivos** | Quantos dispositivos estão configurados sob ele. |
| **Saúde** | Para um driver com um dispositivo, uma linha serial ou um broker, um ponto e a palavra: Ainda não se sabe, Desabilitado, Desconectado, Parcialmente conectado ou Conectado, consolidada a partir dos dispositivos do driver (das linhas no Modbus RTU, das linhas e dos dispositivos fora de linha no Generic serial and TCP e no SCPI instruments, dos brokers no MQTT). Vazia para um driver sem nada configurado, que não tem o que julgar. | O Omron resume como o Generic serial and TCP.

O catálogo traz todo driver que este pacote carrega, acrescentado ou não, mais todo driver ausente que dispositivos ou linhas persistidos ainda nomeiam. Os drivers acrescentados à estação vêm primeiro, sob **Nesta estação**, entre eles um driver ausente, já que ainda tem algo; os demais vêm agrupados por categoria: cada grupo sob um cabeçalho com o seu nome e a sua contagem, na ordem CLPs, Protocolos industriais, Instrumentos e aquisição, Sem fio, Web e APIs, Arquivos e bancos de dados e Teste, e em ordem alfabética dentro dele ([qual driver está em qual grupo](drivers#every-driver)). Sem nenhum driver acrescentado, o grupo Nesta estação não aparece. Como a lista é lida do registro de drivers do Connector, ela se estabiliza alguns segundos depois da inicialização, quando o Connector já está no ar.

### Ações de linha {#row-actions}

| Comando | O que faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- |
| **Acrescentar driver** (um driver não acrescentado) | Acrescenta o driver à estação: ele fica sob a pasta Drivers sem nada abaixo dele ("0 dispositivos"), e a linha dele sobe para **Nesta estação**, destacada e trazida à vista, enquanto o catálogo continua na tela; o **Abrir** da linha, ou a linha do driver na árvore, abre a página dele. O feed mostra "Driver 'Modbus TCP' acrescentado." Nada é criado abaixo dele. | Uma execução segura a estação, o runtime está parado, ou uma varredura ou um pareamento está em andamento (a dica diz qual). | Sem Configurar Connector. |
| **Abrir** (um driver acrescentado) | Seleciona o driver na linha dele sob a pasta Drivers e abre a página dele. | Nunca. | Nunca. |
| **Remover o driver** (um driver acrescentado; tinta de perigo, por último) | Tira o driver da árvore e devolve a linha dele à sua categoria no catálogo, onde Acrescentar driver o traz de volta. O feed mostra "Driver 'Modbus TCP' removido." Não exclui nada e não pergunta nada. | O driver tem um dispositivo, uma linha serial, um broker ou uma pasta (a dica diz "Este driver ainda tem algo na árvore. Exclua primeiro o que está sob ele."), uma execução segura a estação, o runtime está parado, ou uma varredura ou um pareamento está em andamento. | Sem Configurar Connector. |

A página de um driver traz o que se prepara antes do primeiro dispositivo: o cartão Escopo da varredura, as redes do driver Matter, o acesso a equipamentos do driver OPC UA, e Acrescentar dispositivo, Acrescentar linha ou Acrescentar broker. Ela é alcançada assim que o driver é acrescentado, pelo **Abrir** da linha dele no catálogo ou pela linha dele na árvore. Acrescentar não liga nada: um driver acrescentado sem nada abaixo dele não lê nada, e Habilitar e Desabilitar mantêm o sentido próprio deles num dispositivo, numa linha ou num broker, uma linha que fica na árvore e para de ler.

### A barra de comandos {#the-command-bar}

| Comando | O que faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- |
| **Atualizar tudo** | Relê a configuração do banco e refaz a árvore. O Connector em execução fica como está: cada salvamento já aplica a ele o próprio dispositivo. A pasta Drivers continua selecionada com o catálogo aberto, o que estava expandido continua expandido, e o feed mostra "Dispositivos atualizados." | Uma execução segura a estação ou o runtime está parado. | Nunca. |

## A página de um driver {#a-drivers-page}

O cabeçalho leva o nome do driver, a contagem de dispositivos entre parênteses ("Simulated  (9)"; a contagem de linhas no Modbus RTU, a de brokers no MQTT) e um ponto de saúde. A frase abaixo dele depende da situação. Para um papel sem Configurar, ela diz "Os dispositivos com que este driver conversa. Abra uma linha para inspecionar os ajustes e as tags dela." Para o Matter: "Pareie um dispositivo físico novo por Bluetooth, ou descubra nós já comissionados no Fabric local." Para qualquer outro driver: "Acrescente um dispositivo e depois use as ações da linha para abrir, habilitar/desabilitar ou excluir. O driver é fixo por dispositivo." Para um driver que o pacote não carrega: "Os dispositivos que uma configuração de outro lugar deixou aqui. Abra uma linha para inspecionar os ajustes e as tags dela." O Modbus RTU diz outra coisa: "Cada linha é dona de um barramento serial físico. Configure os parâmetros de porta na linha e depois acrescente abaixo dela os dispositivos endereçados por unidade.", e o MQTT "Cada broker é uma conexão com um broker MQTT externo. Configure onde ele responde e como a estação entra nele, depois acrescente os dispositivos que publicam por ele.", o Generic serial and TCP "As linhas seriais levam os instrumentos que compartilham um barramento, e os dispositivos de rede ficam sob o driver. Acrescente uma linha ou um dispositivo e depois abra-o para descrever as mensagens dele." e o SCPI instruments "As linhas seriais levam os instrumentos que compartilham um barramento, e os instrumentos alcançados por TCP ou pelo VISA ficam sob o driver. Acrescente uma linha ou um dispositivo e depois abra-o para informar as consultas dele." O Omron diz "As linhas seriais levam os CLPs lidos por Host Link, cada um pelo número de unidade dele, e os CLPs alcançados pela rede ficam sob o driver. Acrescente uma linha ou um dispositivo e depois abra-o para informar as tags dele." Abaixo do cabeçalho, as linhas seriais, os brokers e os dispositivos que têm erro próprio são nomeados, uma linha para cada tipo ("2 dispositivos com erro: Boiler, Chiller"); as tags são nomeadas pelo dispositivo delas, nunca aqui.

### A barra de comandos {#the-command-bar-1}

| Comando | O que faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- |
| **Atualizar** | A mesma releitura do Atualizar tudo; o Connector em execução fica como está. O driver continua selecionado com a página aberta, e o que estava expandido continua expandido. | Uma varredura ou um pareamento está rodando, uma execução segura a estação, o runtime está parado. | Nunca. |
| **Descobrir** | Inicia a varredura do driver; vira **Cancelar** ("Cancelando…" depois de pressionado) enquanto ela roda. Detalhes em [Descoberta](connector-discovery). | O escopo está inválido (a dica diz o que falta, como o cartão **Escopo da varredura**), um pareamento está rodando, ou a estação recusa mudanças. | Sem Configurar Connector, ou quando o driver não tem varredura. O Modbus RTU varre a partir da página de uma linha serial e o MQTT a partir da página de um broker, então as páginas desses drivers não têm Descobrir, e o Generic serial and TCP não tem varredura nenhuma. |
| **Parear dispositivo** (só no Matter) | Abre o formulário de pareamento na página. | Uma varredura ou um pareamento está rodando, o formulário já está aberto, a estação recusa mudanças, ou nenhuma rede do cartão **Redes** serve ainda ("Acrescente primeiro a rede em que o dispositivo vai entrar."). | Sem Configurar Connector. |
| **Remover o driver** (tinta de perigo, à direita) | O Remover o driver do catálogo, para o driver na tela: o driver sai da árvore e continua no catálogo, a coluna volta para a pasta Drivers com o catálogo aberto, e o feed mostra "Driver 'Modbus TCP' removido." | O driver tem um dispositivo, uma linha serial, um broker ou uma pasta ("Este driver ainda tem algo na árvore. Exclua primeiro o que está sob ele."), uma varredura ou um pareamento está rodando, ou a estação recusa mudanças. | Sem Configurar Connector. |

A barra guarda o que age sobre o próprio driver. Acrescentar dispositivo, Acrescentar linha, Acrescentar broker e o endereço que uma varredura lê ficam na página, junto daquilo sobre o que agem. Clicar com o botão direito na linha do driver oferece o verbo que faz o galho dele crescer (Acrescentar linha, Acrescentar broker, Acrescentar dispositivo ou, no Matter, o Parear dispositivo da barra; no Generic serial and TCP e no SCPI instruments, Acrescentar dispositivo e Acrescentar linha), Nova pasta no nível próprio do driver (em todo driver menos Modbus RTU e MQTT, cujos dispositivos ficam presos a uma linha ou a um broker) e Atualizar, mais o **Descobrir** da barra onde o driver faz varredura, e depois, após um separador, **Remover o driver** em tinta de perigo, recusado como o da barra. O Omron também oferece os dois.

### Na página {#on-the-page}

O que faz crescer uma das tabelas da página fica à direita do título dessa tabela, acima das linhas que acrescenta, e o endereço que uma varredura lê fica no cartão Escopo da varredura, acima da tabela de dispositivos.

| Comando ou campo | Onde | O que faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- | --- |
| **Acrescentar dispositivo** (todo driver, menos Matter, Modbus RTU e MQTT) | À direita do título **Dispositivos**. | Cria "Novo dispositivo" (depois "Novo dispositivo 2", e assim por diante), habilitado, no nível do próprio driver, destacado nesta tabela e rolado até ficar à vista; veja [Dispositivos](connector-devices). No Generic serial and TCP o dispositivo novo é um dispositivo de rede, um Cliente TCP, e no SCPI instruments um dispositivo alcançado por TCP. Sob o Omron, um CLP alcançado pela rede (FINS sobre UDP). | O pacote não carrega o driver (dica "Driver não incluído neste pacote."), uma varredura ou um pareamento está rodando, ou a estação recusa mudanças. | Sem Configurar Connector. |
| **Acrescentar linha** (Modbus RTU, Generic serial and TCP, SCPI instruments, Omron) | À direita do título **Linhas seriais**. | Cria uma linha serial desabilitada, destacada nesta tabela; veja [Linhas seriais](connector-lines). | Uma varredura está rodando, ou a estação recusa mudanças. | Sem Configurar Connector. |
| **Acrescentar broker** (só no MQTT) | À direita do título **Brokers MQTT**. | Cria um broker desabilitado, destacado nesta tabela; veja [MQTT](driver-mqtt#the-broker). | O pacote não carrega o driver, uma varredura está rodando, ou a estação recusa mudanças. | Sem Configurar Connector. |
| Campo do alvo da descoberta | O cartão **Escopo da varredura**, sob a frase "Varrer em busca de dispositivos alcançáveis por este driver." | Para um driver cuja varredura recebe um endereço (OPC UA: "Endereço do servidor OPC UA, por exemplo opc.tcp://plc-host:4840"), a caixa guarda o endereço que o Descobrir lê. Enquanto ela não tem um que o driver consiga usar, uma linha vermelha embaixo dela diz o que é esperado, e o Descobrir esmaece. | Enquanto uma varredura roda. | Sem Configurar Connector, ou quando a varredura do driver não recebe endereço. |

### A tabela de dispositivos {#the-device-table}

Todo driver, menos o Modbus RTU e o MQTT, lista seus dispositivos, as mesmas linhas que a árvore desenha:

| Coluna | O que mostra |
| --- | --- |
| **Dispositivo** | O nome, seguido do marcador vermelho da árvore quando o dispositivo tem erro próprio, com o motivo como dica. |
| **Endpoint** | O Base URI a que o Connector se conecta, montado a partir do cartão Conexão do dispositivo. Vazio para um dispositivo ainda sem host. |
| **Tags** | Quantas tags o dispositivo tem. |
| **Saúde** | Ponto e palavra, como na árvore. |
| **Último erro** | O aviso ou erro mais recente que o diário associou ao dispositivo, ou "Driver não incluído neste pacote." para um dispositivo que o pacote não consegue atender, ou "Host ainda não informado" para um dispositivo habilitado sem host, ao qual a estação não está tentando se conectar ("Dispositivo NI-DAQmx ainda não informado" para um dispositivo NI-DAQmx sem nome de dispositivo, "Canal base ainda não informado" para um dispositivo Fluke NetDAQ com host e sem canal base, "Pasta ainda não informada" para um dispositivo File sem pasta, "Servidor ainda não informado" para um dispositivo Database sem servidor, "DevEUI ainda não informado" ou "EUI da estação ainda não informado" para um dispositivo LoRaWAN sem identificador). É o erro próprio do dispositivo, o mesmo que o marcador dele carrega: o erro de uma tag fica na tag, e um dispositivo cuja linha serial ou broker está com erro não mostra nenhum, porque é a linha serial ou o broker que o carrega. Para um erro, a célula diz o que falhou como a página do dispositivo diz, na língua da estação: o "Connect failed for device …:" que abre a linha do diário, a classe da exceção depois dele e o que a estação faz em seguida ("Retrying in the background …") ficam de fora. Uma falha que a estação reconhece (uma porta que recusa, um firewall no caminho, um timeout, um nome que não resolve, uma exceção Modbus) vira uma frase da própria estação, e qualquer outra mantém as palavras do driver. A dica da célula, o marcador da árvore e a página Eventos guardam a linha inteira. |

Ações de linha: **Abrir** para todo papel, depois, para Configurar Connector, **Habilitar** e **Desabilitar** (cada um esmaecido quando não se aplica) e **Excluir** em tinta de perigo, com uma confirmação que nomeia o dispositivo e suas tags. Os quatro ficam esmaecidos enquanto uma varredura ou um pareamento roda. A tabela vazia mostra "Nenhum dispositivo ainda."

O Modbus RTU lista as linhas dele em vez disso: **Linha**, **Parâmetros físicos** (porta · baud · formato · timeout), **Dispositivos**, **Estado** (um ponto mais um texto como "Conectado · 2/2 dispositivos conectados") e as ações Abrir, Habilitar, Desabilitar e Excluir, as três últimas só para Configurar Connector. Habilitar também fica esmaecido enquanto a tupla da linha está inválida. Uma linha cuja porta falhou leva o marcador vermelho depois do nome.

O Generic serial and TCP e o SCPI instruments trazem a mesma tabela de linhas, cujos **Parâmetros físicos** não têm timeout (porta · baud · formato), acima da tabela de dispositivos, que lista todo dispositivo do driver, os de linha incluídos; veja [Generic serial and TCP](driver-generic-serial-tcp#the-drivers-page) e [SCPI instruments](driver-scpi#the-drivers-page). O Omron traz a mesma tabela acima dos dispositivos dele; veja [Omron](driver-omron#host-link-on-a-serial-line).

O MQTT lista os brokers dele: **Nome**, **Endereço**, **Dispositivos**, **Estado** e as mesmas quatro ações; veja [MQTT](driver-mqtt#the-drivers-page). Um broker que recusou a estação leva o marcador vermelho depois do nome.

### Em volta da tabela {#around-the-table}

Acima da tabela de dispositivos, o driver Modbus TCP tem um cartão **Escopo da varredura** próprio, com os hosts e os unit ids que a varredura dele consulta (só para Configurar Connector), o driver SNMP um com o agente e as subárvores que a varredura dele percorre (só para Configurar Connector; veja [SNMP](driver-snmp#the-scan-scope-card)), o driver File um com o arquivo que a varredura dele lê (só para Configurar Connector; veja [File](driver-file#the-scan-scope-card)), o driver Database um com o dispositivo cujo banco de dados a varredura lê e as tabelas que ela lê (só para Configurar Connector; veja [Database](driver-database#the-scan-scope-card)), e o driver Matter tem o cartão **Redes**, onde as redes Wi-Fi e Thread em que os dispositivos dele entram são cadastradas antes do primeiro pareamento (só para Configurar Connector; veja [Redes](driver-matter#networks)); o Parear dispositivo abre o formulário **Parear dispositivo Matter** acima dele. Enquanto uma varredura roda, a linha de progresso dela fica logo acima da tabela, e o cartão **Dispositivos descobertos** aparece embaixo da tabela com os resultados da varredura. Tudo isso está em [Descoberta](connector-discovery).

## Driver não incluído neste pacote {#driver-not-included-in-this-package}

Um grupo de driver existe para um driver ausente só porque dispositivos persistidos o nomeiam: um backup restaurado, uma configuração trazida de outra máquina. A página dele mostra então um aviso de cautela, "Driver não incluído neste pacote": os dispositivos vieram de uma configuração que tinha o driver, mantêm suas configurações e podem ser excluídos, mas esta instalação não consegue alcançá-los, então eles ficam offline e nenhum dispositivo novo pode ser adicionado ali. Numa página assim, Acrescentar dispositivo continua desenhado e esmaecido com esse motivo, Descobrir não é oferecido, Copiar o dispositivo nos dispositivos dele fica esmaecido com a mesma dica, e a falha de integração do runtime não é repetida como Último erro, porque não há defeito a investigar. Com quais drivers isso pode acontecer está em [Drivers](drivers#a-driver-the-package-does-not-carry).

## O que estas páginas não fazem {#what-these-pages-do-not-do}

O catálogo não pode ser estendido pela página, e um driver não pode ser renomeado, reordenado nem desligado. Um dispositivo não pode ser movido para outro driver. Excluir pela tabela os dispositivos de um driver os exclui um a um, cada um com a sua confirmação; não existe excluir tudo. Excluir o último dispositivo, a última linha serial, o último broker ou a última pasta de um driver deixa o driver na árvore: só o Remover o driver o tira de lá, e nada tira um driver do catálogo. Remover um driver nunca exclui o que estava sob ele, porque é recusado enquanto há alguma coisa.