> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md). # Sensores virtuais Sensores virtuais no Navixy convertem telemetria bruta em rótulos simples, derivam a ignição da tensão e mapeiam estados de dispositivos com vários valores para indicadores legíveis. Sensores virtuais permitem que você processe dados de telemetria de forma mais eficaz. Ao mapear a tensão de bordo, eles podem ajudar você a calcular Horas de motor com base em condições e valores definidos. Além disso, eles permitem converter vários pontos de dados de diferentes sensores conectados a um dispositivo em indicadores mais fáceis de entender, como "quente", "frio", "aberto" e "fechado", independentemente do fabricante ou modelo do dispositivo.

Virtual sensor interface — Interface do sensor virtual

## Disponibilidade Disponível quando o dispositivo tem entradas ou estados dos quais derivar valores. Cada dispositivo suporta até 100 sensores virtuais. ## Como criar um sensor virtual Sensores virtuais podem ser criados por meio do **Sensores e botões** bloco localizado no **na barra lateral esquerda.** módulo. Para criar um sensor virtual: 1. Acesse a seção Dispositivos e configurações 2. Selecione um dispositivo GPS 3. Enviar **+** botão 4. Selecione **Sensor virtual** Cada dispositivo pode ter até 100 sensores virtuais.

Virtual sensor adding in sensors and buttons block — Adição de sensor virtual em Sensores e botões

As próximas etapas dependem do caso de uso que deve ser resolvido por meio do sensor virtual. Abaixo, você encontra exemplos e instruções para diferentes métodos de cálculo. ## Métodos de cálculo Os sensores virtuais têm três tipos diferentes de cálculo: * Valor no intervalo * Valor de origem * Índice de bit Todos os valores para sensores virtuais devem corresponder ao formato no qual são recebidos do dispositivo. Todos os estados são as suas definições para esses valores. Esta seção descreve como os diferentes métodos de cálculo funcionam. Clique no nome do método de cálculo para expandir. ### **Valor no intervalo** Esse tipo de sensor virtual ajuda os clientes a manter parâmetros importantes, como Ignição virtual, temperatura, umidade e nível de combustível dentro de uma faixa especificada. Veja como funciona: * Se o valor do sensor estiver dentro dos limites especificados (a faixa mínima/máxima que você definir), a Navixy o trata como 1 (o que significa que a condição está ativa) e exibe seu rótulo A. * Se o valor do sensor estiver fora dessa faixa, a Navixy o trata como 0 (a condição está inativa) e exibe seu rótulo B. ### Exemplo de Ignição virtual Se você não tiver uma entrada de ignição ou seu dispositivo já estiver operando com capacidade máxima, você pode usar uma ferramenta de Ignição virtual para detectar o estado da ignição. A tensão de bordo do carro aumenta significativamente quando o motor é ligado, permitindo que o limite de tensão seja usado como um indicador de se o motor está funcionando ou não. Em geral, a tensão de bordo deve exceder 13,2 V para indicar que o motor está em funcionamento. Para criar esse sensor: 1. Comece dando um nome a ele. 2. Defina a entrada como **Tensão de bordo** ou qualquer outro sensor, se necessário. 3. Ativar **Considerar como estado de ignição** nas configurações. 4. Escolha “Valor no intervalo” como método de cálculo. 5. Especifique um valor mínimo de faixa, como 13,2 V. Não é necessário definir um máximo, já que a tensão de bordo pode variar com a ignição ligada. 6. Por fim, defina os valores de estado 0 e 1. Normalmente, eles são **ligado** Webhook **desligado,** respectivamente.

Example configuration for virtual ignition — Exemplo de configuração para Ignição virtual

Depois que você definir a faixa do limite de tensão, se o valor de bordo recebido estiver dentro dessa faixa, a plataforma ativa a ignição. Por outro lado, se ele estiver fora dessa faixa, ela será desativada. A Ignição virtual criada com esse método também é considerada em relatórios e notificações com base em seu status. Por exemplo, você pode usá-la para gerar relatórios de Horas de motor ou alertas de Em marcha lenta excessiva. Além disso, essa ignição é usada para detecção de trajetos e de estacionamento com consideração da ignição. ### Exemplo com um sensor analógico Este exemplo é semelhante ao anterior, mas em vez de monitorar a ignição do veículo, ele monitora a temperatura. Suponha que você tenha um sensor analógico que coleta dados de temperatura. Digamos que ele produza 1020 para -10°C e 1900 = 0°C. Os dados vindos dos sensores analógicos não são calibrados e, portanto, também devem ser especificados dessa forma para o sensor virtual. A faixa pode ser configurada: qualquer valor entre 1020 e 1900 seria categorizado como "frio" (1), e qualquer valor acima de 1900 seria considerado "quente" (0).

Example configuration for reading temperature from analog sensor — Exemplo de configuração para leitura de temperatura a partir de sensor analógico

### **Valor de origem** Com os sensores virtuais, você pode atribuir sua definição a quaisquer valores recebidos. Esse método funciona com conjuntos predefinidos de valores e cadeias de caracteres, o que facilita trabalhar com valores estáticos sem precisar especificar faixas diferentes. Além disso, ele pode funcionar com quaisquer dados de que você precise. Por exemplo: * 0/1, * verdadeiro/falso, * ligado/desligado, * aberto/fechado, * armado/desarmado, * estado 1/estado 2/estado 3, * chave 1/chave 2/chave 3, etc. O modo funciona assim: * quando o valor 1 chega, esse é o seu valor A. * quando o valor 2 chega, esse é o seu valor B. * e quando o valor 3 chega, esse é o seu valor C e assim por diante. Vamos ilustrar esse tipo de funcionalidade com um exemplo específico. ### Exemplo com leituras CAN do carro Alguns sensores CAN podem fornecer diferentes valores numéricos à plataforma Navixy. Por exemplo, um caminhão com um sensor de estado CAN: PTO pode fornecer apenas os seguintes valores: * 0: Desligado * 1: Manter * 2: Manutenção remota * 3: Espera * 4: Espera remota * 5: Definir * 6: Desacelerar * 7: Retomar * 8: Acelerar Para configurar esse sensor: 1. Digite o nome dele. 2. Escolha a entrada. 3. **Considerar como estado de ignição** deve ser desativado. 4. Selecione **Valor de origem** como método de cálculo. 5. Preencha a tabela com seus próprios valores no lado esquerdo e os valores correspondentes do sensor no lado direito. Adicione linhas clicando no **+** botão e exclua-as usando o botão da lixeira.

Configuration example for source value calculation method — Exemplo de configuração para o método de cálculo de valor de origem

### Leituras de chave de hardware para motoristas, equipamentos e reboques Alguns dispositivos podem ler motoristas e seus iButtons, chaves RFID ou equipamentos conectados ao dispositivo via sensores Bluetooth. A plataforma pode detectar o equipamento ou motorista mais próximo do dispositivo, e o Sensor virtual é capaz de exibir esses nomes. A maneira mais simples de identificação é por meio de etiquetas: cada unidade conectada a equipamento pesado tem seu próprio sensor com uma etiqueta afixada, que é reconhecida pela plataforma como uma chave de hardware. Quando conectada à máquina, essa chave é enviada à plataforma e o nome associado a ela pode ser exibido de maneira compreensível, de forma semelhante a como os valores de PTO foram nomeados.

Configuration example for source value calculation method for hardware key or state field sensor reading — Exemplo de configuração para o método de cálculo de valor de origem para leitura de sensor de chave de hardware ou de campo de estado

### **Índice de bit** Alguns dispositivos podem fornecer dados avançados em seus pacotes, às vezes mesclando vários parâmetros [em um único valor](https://www.navixy.com/blog/sensor-parameters-avl/). A ferramenta de sensores virtuais permite trabalhar com bits individuais dentro desses valores combinados, decodificando o que cada posição significa de acordo com o protocolo do dispositivo. Por exemplo, o valor transmitido é 011. Dispositivos como esse codificam vários estados em um único número usando um layout bit a bit lido da direita para a esquerda (ordem little-endian, conforme definido no protocolo do dispositivo): * Bit 0 (dígito mais à direita): o valor 1 significa que o cinto do motorista está desatado (0 = afivelado, 1 = desatado). * Bit 1 (dígito do meio): o valor 1 significa que a porta do motorista está aberta (0 = fechada, 1 = aberta). * Bit 2 (dígito mais à esquerda): o valor 0 significa que o capô está fechado (0 = fechado, 1 = aberto). Cada posição de bit codifica um estado diferente do sistema do veículo. Para configurá-las e exibi-las, crie um sensor virtual para cada parâmetro que você deseja monitorar. Para um sensor que mostra a condição do capô do carro neste exemplo: 1. Defina o nome do sensor 2. Escolha a entrada de acordo com a documentação do dispositivo 3. Selecione **Índice de bit** como método de cálculo (isso diz à Navixy para ler uma única posição de bit do valor combinado) 4. Escolha o bit 2 para esse campo (a posição que codifica o estado do capô) Abaixo está um exemplo de um sensor que mostra a condição do capô do carro.

Configuration example for Bit index calculation sensor — Exemplo de configuração para sensor de cálculo de índice de bit

Depois que um sensor virtual é configurado e o sensor associado do dispositivo tiver fornecido dados, ele pode ser visualizado no **widget de leituras de sensores** na **Informações** aba. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.