# Sensores virtuais

Sensores virtuais permitem que você processe dados de telemetria com mais eficiência. Ao mapear a tensão da placa, eles podem ajudar você a calcular as horas do 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. Isso abre novas possibilidades para monitorar, rastrear e prever o desempenho de tecnologias complexas.

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

### Como criar um sensor virtual

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. Entre na seção de dispositivos e configurações
2. Selecione um dispositivo GPS
3. Clique no **+** botão
4. Selecione **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>Adição de sensor virtual em sensores e botões</p></figcaption></figure>

Os próximos passos dependem do caso de uso que deve ser resolvido por meio do sensor virtual. Abaixo, você pode encontrar 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 em que são recebidos do dispositivo. Todos os estados são as suas definições para esses valores.

Aqui, descrevemos como diferentes métodos de cálculo funcionam. Clique no nome do método de cálculo para expandir.

#### **Valor no intervalo**

Este tipo de sensor virtual ajuda nossos 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, ele será 1 para a plataforma. E 1 é igual ao seu valor A.
* Se o valor do sensor estiver fora desses limites, o valor do sensor virtual será 0 para a plataforma. E 0 é igual ao seu valor 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 plena capacidade, você pode usar uma ferramenta de ignição virtual para detectar o estado da ignição. A tensão de bordo do carro aumentará significativamente quando o motor for ligado, permitindo que o limite de tensão seja usado como indicador de o motor estar funcionando ou não. Em geral, a tensão de bordo deve exceder 13,2 V para indicar que o motor está funcionando.

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. Ative **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 intervalo, como 13,2 V. O máximo não é necessário, 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ê definir o intervalo do limite de tensão, se o valor de bordo recebido estiver dentro desse intervalo, a plataforma ativará o estado de ignição. Por outro lado, se estiver fora desse intervalo, ele será desativado. A ignição virtual criada com esse método também será levada em conta em relatórios e notificações com base no seu status; por exemplo, você pode usá-la para gerar relatórios de horas do motor ou alertas de marcha lenta excessiva.

Além disso, essa ignição será usada para a detecção de viagens e estacionamento com consideração da ignição.

#### Exemplo com 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 emita 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 a uma plataforma. Por exemplo, temos um caminhão com CAN: sensor de estado da TDF, que pode emitir apenas os seguintes valores:

* 0 – Desligado
* 1 – Manter
* 2 – Manter remoto
* 3 – Em espera
* 4 – Em espera remota
* 5 – Definir
* 6 – Desacelerar
* 7 – Retomar
* 8 – Acelerar

Para configurar este sensor:

1. Informe 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 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 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 motoristas e seus iButtons, chaves RFID ou equipamentos conectados via sensores Bluetooth ao dispositivo. 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 anexada, que é reconhecida pela plataforma como uma chave de hardware. Quando conectada à máquina, essa chave será enviada à plataforma e seu nome associado poderá ser exibido de maneira compreensível, semelhante à forma como os valores de TDF 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 método de cálculo de valor de origem para leitura de chave de hardware ou sensor de 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 Sensores virtuais permite trabalhar com partes dos valores de telemetria, decodificando assim os dados transmitidos pelo hardware GPS.

Por exemplo, o valor transmitido é 011. Primeiro, devemos ler essas informações em little-endian de acordo com o protocolo:

* 1 mostra o status do cinto do motorista: 0 para afivelado, 1 para desafivelado. Bit 0.
* 1 exibe o status da porta do motorista: 0 para fechada, 1 para aberta. Bit 1.
* 0 indica a condição do capô: 0 para fechado, 1 para aberto. Bit 2.

Cada posição no parâmetro exibe o valor de diferentes sistemas do veículo. Para configurá-los e exibi-los, você precisa criar um sensor separadamente para cada parâmetro.

Para um sensor que mostra a condição do capô do carro em nosso exemplo, você precisa

1. Definir o nome do sensor
2. Escolher a entrada de acordo com a documentação do dispositivo
3. Selecione **Índice de bit** como método de cálculo
4. Escolher o bit 2 para este campo

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 de í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 Leituras do sensor** na **Informações** aba do dispositivo. Agora, os sensores do seu dispositivo podem falar no seu idioma.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
