> 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/eye-sensor-configuration.md).

# Configuração do sensor Eye

Configure sensores virtuais no Navixy para acessórios Teltonika Eye para expor o estado de movimento, a temperatura, a umidade e os dados de ímã coletados via Bluetooth.

Esta página mostra como configurar sensores virtuais para [Teltonika Eye Sensors](https://teltonika-gps.com/products/accessories/sensors-beacons/eye), que registram dados de temperatura, umidade, movimento e estado do ímã. O estado de movimento, em particular, exige um sensor virtual para se tornar acessível no Navixy.

## Disponibilidade

Disponível em dispositivos Teltonika pareados com sensores Eye BLE.

## Configuração do sensor em um dispositivo

Para configurar a transmissão de dados do sensor para a plataforma Navixy, use o [Teltonika Configurator](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_Introduction). Certifique-se de [baixar a versão](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions) que corresponde ao firmware e ao modelo do dispositivo atuais. Depois de baixar e iniciar o configurador, acesse as configurações do sistema e selecione o **Codec 8 Extended** protocolo de dados (o formato de dados estendido da Teltonika que oferece suporte a muito mais parâmetros de sensor do que o Codec 8 padrão).

<figure><img src="https://www.navixy.com/wp-content/uploads/2023/03/1-4.png" alt="Enabling Codec 8 Extended in the Teltonika configurator"><figcaption><p>Ativando o Codec 8 Extended no configurador da Teltonika</p></figcaption></figure>

Na seção Bluetooth 4.0, desative o recurso **Non-Stop Scan** e defina a **Frequência de atualização** Webhook **Duração da varredura** para 30 segundos.

<figure><img src="https://www.navixy.com/wp-content/uploads/2023/03/2-4.png" alt="Scan frequency for BLE sensors"><figcaption><p>Frequência de varredura para sensores BLE</p></figcaption></figure>

Em seguida, selecione o **Connection #** e defina o modo de operação para **seção Avançado**. Isso fornece acesso às configurações detalhadas do sensor. Procure os botões localizados no canto superior direito e selecione a **Lista de predefinições**. Isso permite simplificar o processo de configuração do sensor.

<figure><img src="https://www.navixy.com/wp-content/uploads/2023/03/3-2.png" alt="Setting the Advanced mode for the sensor and the location of the Preset list button"><figcaption><p>Definindo o modo avançado para o sensor e a localização do botão Lista de predefinições</p></figcaption></figure>

Depois que você clicar no botão da lista de predefinições, uma nova janela será aberta exibindo uma seleção de sensores disponíveis. Escolha o que você está usando no momento, como o **sensor Eye**. Essa tabela configura automaticamente todas as definições necessárias. Depois disso, acesse a guia I/O para configurar a transmissão de dados desses sensores dentro dos pacotes do seu dispositivo.

Para configurar a transmissão de dados desses sensores dentro dos pacotes do seu dispositivo, acesse a guia I/O. Aqui, você precisa definir os parâmetros apropriados para as configurações desejadas. Por exemplo, se o número de conexão do seu sensor for 1, configure os parâmetros com o mesmo número. Na maioria dos casos, o ideal é definir a prioridade como Baixa para os parâmetros que precisam ser monitorados na plataforma. Também é importante garantir que todas as outras configurações permaneçam com seus valores padrão, a menos que você tenha alterado algo anteriormente. Nesses casos, as configurações recomendadas são as seguintes:

* Prioridade = Baixa
* Nível baixo = 0
* Nível alto = 0
* Apenas evento = Não
* Operando = Monitoramento

<figure><img src="https://www.navixy.com/wp-content/uploads/2023/03/4-2.png" alt="Setting up the sending of sensor data in device packets"><figcaption><p>Configurando o envio de dados do sensor nos pacotes do dispositivo</p></figcaption></figure>

## Configuração na plataforma

### Sensor de status de movimento

A leitura deste sensor é totalmente configurável com sensores virtuais com [o método de cálculo de índice de bit](/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md#bit-index). Os dados de estado de movimento chegam no bit 16 (a 17ª posição de bit, contando a partir de zero) do campo BLE 1 Custom 1. A configuração do estado de movimento exige as seguintes etapas:

1. Crie um sensor virtual e especifique seu nome.
2. Selecione o [ID AVL apropriado](https://wiki.teltonika-mobility.com/view/Full_AVL_ID_List#BLE_Sensor_I.2FO_elements) como entrada. Um ID AVL é o identificador numérico da Teltonika para um parâmetro de dados específico. Para BLE 1 Custom 1, use o número 331.
3. Defina o número de bit que corresponde aos dados de estado de movimento. Nesse caso, selecione o bit 16 do campo BLE 1 Custom 1.
4. Defina os nomes dos estados conforme necessário. Por exemplo, "Parado" e "Movimento".
5. Especifique os valores correspondentes: 0 significa que nenhum movimento foi detectado, 1 significa que houve movimento registrado.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-043a763fcd601bc1d7e131a06925bf656143dd5b%2Fimage-20241118-031514.png?alt=media" alt="Setting up the Virtual Sensor to read the Eye sensor&#x27;s motion status" width="563"><figcaption><p>Configurando o sensor virtual para ler o status de movimento do sensor Eye</p></figcaption></figure>

Nesse ponto, o estado de movimento atual é recuperado. No entanto, tenha em mente que as informações só podem ser obtidas em relatórios e regras se o estado de movimento estiver definido como ignição.

Relatórios e regras para sensores virtuais sem ignição não são suportados neste momento.

### Sensores de temperatura e umidade

Configurar esses sensores é semelhante a configurar sensores de medida padrão. [sensores de medida](/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/measurement-sensors.md). Vamos ver um exemplo de configuração para cada um desses sensores:

A umidade é transmitida pelo dispositivo em %.

* Especifique o nome desejado do sensor.
* Selecione a entrada apropriada **BLE: Umidade \[N]** e informe seu número.
* Selecione o tipo de sensor **Personalizado**.
* Especifique a unidade de medida em %.
* Outras configurações não são necessárias.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ab016caf8db9b9056dea3803fa9cda8ecb356a02%2Fimage-20241118-031634.png?alt=media" alt="Setting up the BLE humidity sensor"><figcaption><p>Configurando o sensor BLE de umidade</p></figcaption></figure>

A temperatura é transmitida pelo dispositivo em °C.

* Especifique o nome desejado do sensor.
* Selecione a entrada apropriada BLE: Temperatura \[N] e especifique seu número.
* Selecione o tipo de sensor Temperatura.
* Especifique a unidade de medida em °C.
* Outras configurações não são necessárias.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-a45f67ca3e6b14504470107ae121aa0fe1667153%2Fimage-20241118-031701.png?alt=media" alt="Setting up the BLE temperature sensor" width="368"><figcaption><p>Configurando o sensor BLE de temperatura</p></figcaption></figure>

Usando leituras do sensor, você pode gerar um relatório de sensores de medida que fornece insights úteis sobre os dados coletados pelo sensor. Além disso, você pode monitorar leituras configurando alertas usando a **regra Parâmetro em intervalo** que permite que você receba notificações quando parâmetros específicos saem dos intervalos predefinidos.

Além disso, sensores virtuais podem ser criados para fornecer nomes compreensíveis aos valores do sensor recebidos em widgets. Para isso, use [o método de cálculo de valor no intervalo](/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md#value-in-range). Isso permite personalizar os dados do sensor exibidos e facilita a interpretação das informações apresentadas pelo sensor.

### Sensor de estado magnético

Configurar sensores de estado magnético é um processo simples e direto. Na verdade, nenhuma configuração adicional é necessária além de conectar os sensores à plataforma. Os dados de estado magnético são transmitidos para a plataforma como campos de status e são exibidos assim que são recebidos do dispositivo conectado.

Usando sensores virtuais com o [método de cálculo de valor de origem](/docs/user/pt-br/guide/devices-and-settings/vehicle-sensors/virtual-sensors.md#source-value), você pode personalizar os valores do seu campo de status para serem exibidos como "aberto" ou "fechado" e dar a eles nomes facilmente reconhecíveis.

Ao configurar a **regra Valor do campo de status** você pode monitorar os campos de status e receber alertas quando eventos específicos ocorrerem.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e1781ff2d571a1827018a2544b44db9bf399d68d%2Fimage-20241118-031749.png?alt=media" alt="Example of setting the magnet state sensor with its values and name" width="563"><figcaption><p>Exemplo de configuração do sensor de estado magnético com seus valores e nome</p></figcaption></figure>


---

# 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/eye-sensor-configuration.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.
