> 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

Os sensores virtuais permitem que você processe os 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, 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.

<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 os valores podem ser derivados. 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. 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>

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 em que são recebidos do dispositivo. Todos os estados são as suas definições para esses valores.

Esta seção descreve como 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ínimo/máximo que você definiu), o 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, o 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 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 o motor estar ou não funcionando. 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 atribuindo 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 de intervalo, como 13,2 V. Não é necessário definir um valor 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 de ignição virtual</p></figcaption></figure>

Depois que você define o intervalo do limite de tensão, se o valor de bordo recebido estiver dentro desse intervalo, a plataforma liga o estado de ignição. Por outro lado, se estiver fora desse intervalo, 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 de 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 produza 1020 para -10 °C e 1900 = 0 °C. Os dados vindos dos sensores analógicos não são calibrados e, por isso, também devem ser especificados dessa 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 qualquer valor recebido. Este método funciona com conjuntos predefinidos de valores e strings, o que facilita trabalhar 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 carro

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: Em espera
* 4: Em espera remota
* 5: Definido
* 6: Desacelerar
* 7: Retomar
* 8: Acelerar

Para configurar esse sensor:

1. Dê a ele um nome.
2. Escolha a entrada.
3. **Considere 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 o método de cálculo por 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 suas 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 maneira 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 é enviada para a plataforma e seu nome associado pode ser exibido de forma 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 por valor de origem para leitura de sensor de chave de hardware ou 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 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 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á 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. Selecione **Índice de bit** como método de cálculo (isso informa ao 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 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 Leituras do sensor** na guia Informações do **dispositivo** guia.


---

# 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.