> 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.

Os 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 as Horas de motor com base em condições e valores definidos. Além disso, 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.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_clvf66ikbi.png" alt="Virtual sensor interface"><figcaption><p>Interface do sensor virtual</p></figcaption></figure>

## Disponibilidade

Disponível quando o dispositivo tem entradas ou estados dos quais é possível derivar valores. Cada dispositivo suporta até 100 sensores virtuais.

## Como criar um sensor virtual

Os sensores virtuais podem ser criados por meio do **Sensores e botões** bloco localizado no **Dispositivos e configurações** módulo. Para criar um sensor virtual:

1. Acesse a seção Dispositivos e configurações
2. Selecione um dispositivo GPS
3. Clique no **+** botão
4. Selecionar **Sensor virtual**

Cada dispositivo pode ter até 100 sensores virtuais.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_73sv6rayqh.png" alt="Virtual sensor adding in sensors and buttons block" width="375"><figcaption><p>Adicionar sensor virtual em Sensores e botões</p></figcaption></figure>

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 dos sensores virtuais devem corresponder ao formato em que são recebidos do dispositivo. Todos os estados são 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 um intervalo especificado.

Veja como funciona:

* Se o valor do sensor estiver dentro dos limites especificados (o intervalo mín./máx. que você definiu), 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 desse intervalo, 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 se o seu dispositivo já estiver operando em 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 usar o limiar de tensão como um indicador de se o motor está ou não funcionando. Em geral, a tensão de bordo deve ultrapassar 13,2 V para indicar que o motor está em funcionamento.

Para criar este 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 **Considere 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 do intervalo, como 13,2 V. Não é necessário definir o máximo, pois 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** e **desligado,** respectivamente.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_7qx9prhhxc.png" alt="Example configuration for virtual ignition" width="375"><figcaption><p>Exemplo de configuração para Ignição virtual</p></figcaption></figure>

Depois que você define o intervalo do limiar de tensão, se o valor de bordo recebido estiver dentro desse intervalo, a plataforma liga o estado da ignição. Caso contrário, ele é desligado. A Ignição virtual criada usando esse método também é levada em conta 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 para Em marcha lenta excessiva.

Além disso, essa ignição é usada para detecção de Trajeto e Detecção 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 retorne 1020 para -10°C e 1900 = 0°C. Os dados provenientes dos sensores analógicos não são calibrados e, portanto, também devem ser especificados nessa forma para o sensor virtual.

O intervalo pode ser configurado: qualquer valor entre 1020 e 1900 seria categorizado como “frio” (1), e qualquer valor acima de 1900 seria considerado “quente” (0).

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_kgzvrsdzb1.png" alt="Example configuration for reading temperature from analog sensor" width="563"><figcaption><p>Exemplo de configuração para leitura de temperatura de sensor analógico</p></figcaption></figure>

### **Valor de origem**

Com sensores virtuais, você pode atribuir sua definição a quaisquer valores recebidos. Esse método funciona com conjuntos predefinidos de valores e strings, o que facilita o trabalho com valores estáticos sem precisar especificar intervalos 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 veículo

Alguns sensores CAN podem fornecer diferentes valores numéricos para a plataforma Navixy. Por exemplo, um caminhão com um sensor de estado CAN: PTO pode retornar apenas os seguintes valores:

* 0: Desligado
* 1: Manter
* 2: Manter remotamente
* 3: Espera
* 4: Espera remota
* 5: Definir
* 6: Desacelerar
* 7: Retomar
* 8: Acelerar

Para configurar este sensor:

1. Insira o nome dele.
2. Escolha a entrada.
3. **Considere como estado de ignição** deve ficar desativado.
4. Selecionar **Valor de origem** como método de cálculo.
5. Preencha a tabela com seus próprios valores no lado esquerdo e os respectivos valores do sensor no lado direito. Adicione linhas clicando no **+** botão e exclua-as usando o botão da lixeira.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_xlxdl1ak9e.png" alt="Configuration example for source value calculation method" width="563"><figcaption><p>Exemplo de configuração para o método de cálculo de valor de origem</p></figcaption></figure>

### Leituras de chave de hardware para Motoristas, equipamentos e reboques

Alguns dispositivos podem ser capazes de ler dados de Motoristas e seus iButtons, chaves RFID ou equipamentos conectados ao dispositivo por meio de 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 forma mais simples de identificação é por meio de Etiquetas: cada unidade conectada a equipamentos pesados 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 para a plataforma e seu nome associado pode ser exibido de maneira compreensível, semelhante à forma como os valores de PTO foram nomeados.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_vw7hkgdl0n.png" alt="Configuration example for source value calculation method for hardware key or state field sensor reading" width="563"><figcaption><p>Exemplo de configuração para o método de cálculo de valor de origem para leitura de sensor de chave de hardware ou campo de estado</p></figcaption></figure>

### **Í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 que você trabalhe 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 uma disposição bit a bit lida 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á desafivelado (0 = afivelado, 1 = desafivelado).
* 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á-los e exibi-los, crie um sensor virtual para cada parâmetro que você deseja monitorar.

Para um sensor que mostre 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. Selecionar **Índice de bit** como método de cálculo (isso informa à Navixy para ler uma única posição de bit do valor combinado)
4. Escolha o bit 2 para este 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.

<figure><img src="https://www.navixy.com/wp-content/uploads/2024/03/browser_2qcam8zclk.png" alt="Configuration example for Bit index calculation sensor" width="563"><figcaption><p>Exemplo de configuração para sensor de cálculo por índice de bit</p></figcaption></figure>

Depois que um sensor virtual é configurado e o sensor do dispositivo associado fornece dados, ele pode ser visualizado no **widget de leituras do sensor** nas **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=<question>&goal=<user_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.
