> 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/expert-center/pt-br/faq-and-troubleshooting/sensors/configuring-ble-sensors-on-suntech-trackers-in-navixy-bluetooth.md).

# Configurando sensores BLE em dispositivos Suntech

Emparelhe sensores BLE Minew com dispositivos GPS Suntech e exiba os valores na Navixy. Abrange a configuração do BeaconSET+ e do MSensor, o emparelhamento do SyncTrak e o mapeamento de relatórios, e os códigos de eventos BLE para pânico, porta e th

Sensores Bluetooth Low Energy (BLE) permitem monitorar temperatura, umidade, estado da porta e eventos de pânico sem fiação extra. Um dispositivo GPS Suntech com um gateway BLE lê esses sensores e envia os valores para a Navixy dentro de seus relatórios normais de status e alertas.

Este artigo aborda sensores BLE: como preparar beacons Minew, como emparelhá-los no SyncTrak e como exibir os dados na Navixy. Para ignição e entradas digitais, veja [Mapeando a entrada de ignição e movimento para dispositivos Suntech na Navixy](/docs/expert-center/pt-br/faq-and-troubleshooting/gps-devices/input-control/mapping-the-ignition-motion-input-for-suntech-devices-on-navixy.md).

Famílias Suntech compatíveis (gateway BLE necessário):

* Série ST4300, por exemplo ST4315B, ST4345LB
* Série ST4900, por exemplo ST4932, ST4955LCBW, ST4915LCBF
* Série ST8000, por exemplo SD8000U, ST8230

Confirme o suporte a BLE e o modelo correspondente da Navixy para o seu dispositivo exato antes de começar. Os exemplos de parâmetros abaixo vêm de um ST4315B. Os números dos slots podem diferir em outros modelos se o mapeamento de relatórios usar uma ordem de campos diferente.

## Como preparar os sensores nos aplicativos Minew

O dispositivo apenas lê o que cada sensor já transmite. Configure o sensor primeiro. Anote o endereço MAC de cada sensor. Você vai precisar dele no SyncTrak.

Instale o BeaconSET+ para a pulseira e o sensor de temperatura e umidade. Instale o MSensor para o sensor de porta. Ative o Bluetooth, abra o aplicativo e selecione o sensor pelo endereço MAC.

### Configuração do sensor via aplicativos móveis

#### Pulseira Minew B10 (Botão do pânico): use o aplicativo BeaconSET+ (PIN padrão: minew123 ou 000000)

* Slot 1 iBeacon: parâmetros básicos desligados.
* Parâmetros de gatilho: ligados. Ative os tipos de toque (simples, duplo, triplo).
* Tipo de gatilho: ative toques simples, duplos e triplos se o aplicativo os oferecer.
* Tempo de advertising após o gatilho: 10 segundos. Com 1 segundo, o botão muitas vezes para antes que o dispositivo o leia, e o evento de pânico se perde.
* Intervalo e potência: 900 ms, 0 dBm.

O dispositivo relata pânico como evento 136. O subtipo segue o número de cliques:

* Um clique: Pacote 136;1 (Navixy sub\_event\_code: 136\_1)
* Dois cliques: Pacote 136;2 (Navixy sub\_event\_code: 136\_2)
* Três cliques: Pacote 136;3 (Navixy sub\_event\_code: 136\_3)

#### Sensor de temperatura e umidade Minew: use o BeaconSET+ (PIN padrão: minew123)

* Slot 1 iBeacon: parâmetros básicos desligados (iBeacon sozinho não carrega telemetria).
* Slot de telemetria (SLOT4 TLM / HT): parâmetros básicos ligados.
* Intervalo e potência: 900–1000 ms, 0 dBm.

#### Sensor de porta Minew S4: use o MSensor (PIN padrão: minewtech1234567)

* Modo de operação: modo normal (não use o modo de economia de energia, ou os eventos de porta serão atrasados/perdidos).
* Intervalo e potência: 900–1000 ms, 0 dBm.

{% hint style="warning" %}
Um sensor BLE aceita uma conexão por vez. Enquanto o aplicativo do celular permanecer conectado, o dispositivo não consegue ler esse sensor. Feche o BeaconSET+ ou o MSensor, ou se afaste do alcance, depois que salvar os parâmetros.
{% endhint %}

### Como emparelhar os sensores no SyncTrak

Depois que os sensores começarem a transmitir, abra a ferramenta de desktop SyncTrak para configurar as regras de varredura BLE do dispositivo.

#### Aba de parâmetros BLE

* BLE SCAN (4021): ativar.
* Tempo de varredura BLE do Sensor RPT (4011): 20 segundos.
* Varredura contínua (4037): ativar. Mantenha a varredura contínua ativada quando usar um Botão do pânico ou um sensor de porta. Se você a desativar, o receptor BLE dorme entre as janelas de varredura. Um pressionamento ou uma mudança no estado da porta nessa janela é descartado. Temperatura e umidade ainda podem ser atualizadas.
* Tempo de varredura BLE do BDA RPT (4012): defina abaixo do tempo de rastreamento fino. Se a varredura durar mais do que o intervalo de relatório, o dispositivo interrompe a varredura para enviar o relatório no horário. O relatório BLE então mostra status de varredura 0 e contagem de sensores 0.

#### Aba de registro BLE

* Adicione a pulseira e o sensor climático aqui. Tipo de sensor: 5: MINEW. Clique em ADD, insira o endereço MAC e salve.
* A ordem de registro importa. O primeiro sensor é dedicado BLE 1, o segundo é dedicado BLE 2. Campos de relatório como `DED_BLE1_TEMP` seguem essa ordem. Mantenha a ordem estável.
* Defina In alert como ativar apenas quando você usar os limites alto e baixo desse sensor. Não registre o sensor de porta apenas nesta aba.

#### Aba Registrar porta

* Registre o sensor de porta aqui. Tipo de sensor: 4: MINEW DOOR. Ative o sensor de porta para esse ponto.
* O firmware mantém periféricos de porta em uma lista separada. Um sensor de porta que exista apenas em Registrar BLE não envia nenhum estado de porta. O mesmo MAC pode aparecer nas duas abas sem problema, mas Registrar porta é a entrada que funciona.

#### Aba de configuração do sensor BLE

* Defina o relatório do sensor BLE (2610) como Stt/Alt scan enable para que os valores BLE sejam anexados aos relatórios padrão.

<figure><img src="https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2FAOf819gOtPvt4vQmjJLV%2Funknown.png?alt=media&amp;token=261a58ef-fd0b-4298-9759-f28a173ad5ac" alt="" height="269" width="624"><figcaption><p>Parâmetros BLE do SyncTrak e abas de registro configurados para varredura contínua e emparelhamento de sensores.</p></figcaption></figure>

#### Ative os alertas BLE no SyncTrak

Nas abas de configuração de alertas, ative os eventos que você usa na Navixy:

* 119: sensor BLE dedicado dentro do alcance
* 120: sensor BLE dedicado fora do alcance
* 121 / 122: temperatura BLE dedicada alta / baixa
* 124 / 125: umidade BLE dedicada alta / baixa
* 135: estado de porta BLE dedicado
* 136: estado de pânico BLE dedicado

#### Aba de mapeamento de relatório

A Navixy não lê o relatório BLE bruto BDA. Selecione os campos BLE no mapeamento de relatório para que sejam incluídos em STT e ALT.

Selecione pelo menos:

* Temperatura e umidade do sensor climático dedicado (por exemplo `DED_BLE1_TEMP` quanto no `DED_BLE1_HUM`, ou `DED_BLE2_*` se esse sensor for o ponto 2).
* ID grande do sensor BLE dedicado se você quiser o MAC na plataforma Navixy.

Observe a posição de cada campo na **S\_ASSIGN** coluna, listada na **Tabela pequena** caixa à direita da tela. O primeiro campo nessa coluna chega como `stt_small_assign_1`, o segundo como `stt_small_assign_2`, e assim por diante.

Em um objeto de laboratório ST4315B com vários **S\_ASSIGN** campos selecionados (voltagem, altitude e, depois, medições BLE), a temperatura chegou como `stt_small_assign_6` e a umidade como `stt_small_assign_7`. Se você selecionar menos campos, ou outra ordem, os números dos slots mudam. Sempre confirme o slot no Air Console. Depois que os sensores forem mapeados, veja [Monitorar valores do sensor](/docs/expert-center/pt-br/faq-and-troubleshooting/sensors/monitor-sensor-values.md) para ver como as leituras aparecem na Navixy.

## Como os dados chegam à Navixy e configuração da plataforma

Registre o dispositivo GPS na Navixy usando o modelo de dispositivo correspondente.

<figure><img src="https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2FTcuwWhSXYt5q6FWb5V6R%2Funknown.png?alt=media&amp;token=5548c82a-2236-4e33-99fb-8127dc96abf4" alt="" height="204" width="378"><figcaption><p>Como o ST4315 aparece na Navixy. Outras unidades ST4300, ST4900 e ST8000 usam seus próprios nomes de modelo.</p></figcaption></figure>

### Como o dispositivo se comunica

O dispositivo transmite três tipos principais de pacotes:

* STT é o relatório de status periódico. Ele carrega medições BLE mapeadas em cada intervalo de rastreamento fino.
* ALT é o relatório de alerta. O dispositivo o envia quando ocorrem eventos de pânico, porta ou limite. Campos BLE mapeados também são incluídos nesse pacote.
* BDA é um despejo BLE separado. A Navixy não o processa. Mantenha os campos no mapeamento de relatório.

### Como exibir os dados BLE na Navixy

1. Na Navixy, registre o dispositivo sob o modelo de dispositivo.
2. Vá para Dispositivos > Sensores e botões.
3. Abra o Air Console para inspecionar os parâmetros recebidos:
   * Bitmask de entrada: leia da direita para a esquerda. Bit 0 = ignição, Bit 1 = Entrada 1, Bit 2 = Entrada 2. (00000001 = ignição ligada; 00000011 = ignição ligada + Entrada 1 aterrada, usando ignição por movimento).
   * Bitmask de saída: Bit 0 = Saída 1, Bit 1 = Saída 2 (00000011 = ambas ativas).
4. Criar [Sensores de medida](/docs/expert-center/pt-br/faq-and-troubleshooting/sensors/manage-sensors.md): mapear `stt_small_assign_6` para Temperatura (°C) e `stt_small_assign_7` para Personalizado / Umidade (%).

<figure><img src="https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2FSOAI1eyASY0MyKQ7mDT5%2Funknown.png?alt=media&amp;token=a9a46399-bfa6-41d7-aafa-4e81eb603f4d" alt="" height="563" width="212"><figcaption><p>Air Console da Navixy mostrando os parâmetros de telemetria stt_small_assign recebidos e os estados de hardware.</p></figcaption></figure>

### Como criar regras e alertas para eventos BLE na Navixy

A Navixy processa eventos de hardware via `event_code` quanto no `sub_event_code`. Para os tipos de regra de alerta que os consomem, veja [Entradas e saídas](/docs/user/pt-br/guide/events-and-notifications/inputs-and-outputs.md).

#### Eventos de pânico (`event_code` 136)

* 136\_1: clique único
* 136\_2: clique duplo
* 136\_3: clique triplo

**Limite de espera:** O firmware do dispositivo impõe um período de espera de 60 segundos por tipo de clique. Um segundo clique único dentro de 60 segundos é descartado, mas um clique duplo ainda pode disparar imediatamente.

#### Estado da porta (`event_code` 135)

* 135\_0: porta fechada (135;0;6,MAC)
* 135\_1: porta aberta (135;1;6,MAC)

{% hint style="info" %}
O `6` em a carga útil é o comprimento do endereço MAC em bytes. Ele não é o tipo de sensor que você configurou no SyncTrak.
{% endhint %}

#### Alertas de alcance do sensor

* 119: sensor BLE dedicado dentro do alcance
* 120: sensor BLE dedicado fora do alcance
* 121 / 122: temperatura BLE alta / baixa
* 124 / 125: umidade BLE alta / baixa

**Dica de configuração da regra:** Disparar em `event_code` quando qualquer pressionamento ou atividade da porta precisar gerar o alerta. Disparar em `sub_event_code`, por exemplo `135_1` ou `136_3`, ao filtrar por estados específicos.

<figure><img src="https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2FfMw1V6ukLNaNyIcTfE0H%2Funknown.png?alt=media&amp;token=57aad98c-1a41-4a55-b4ff-c3e98bc3a34c" alt="" height="487" width="338"><figcaption><p>Janela de configuração da regra de alerta da Navixy usando event_code e sub_event_code.</p></figcaption></figure>

## Verificação e solução de problemas

1. Eventos de pânico ou da porta nunca chegam? Certifique-se de que Varredura contínua (4037) esteja ativada na aba de parâmetros BLE.
2. Telemetria BLE vazia ou zero? Verifique se o tempo de varredura do parâmetro 4012 é menor que o tempo de relatório do rastreamento fino. Certifique-se de que os aplicativos de configuração móvel estejam totalmente fechados.
3. Estado da porta ausente? Confirme se o MAC do sensor de porta está registrado na aba Registrar porta, e não na aba Registrar BLE.

## Veja também

* [Gerenciar sensores](/docs/expert-center/pt-br/faq-and-troubleshooting/sensors/manage-sensors.md): adicione sensores e corrija leituras ausentes, unidades erradas e lacunas de medição
* [Monitorar valores do sensor](/docs/expert-center/pt-br/faq-and-troubleshooting/sensors/monitor-sensor-values.md): crie alertas de sensor com múltiplas condições para cadeia fria e monitoramento de equipamentos
* [Mapeando a entrada de ignição e movimento para dispositivos Suntech na Navixy](/docs/expert-center/pt-br/faq-and-troubleshooting/gps-devices/input-control/mapping-the-ignition-motion-input-for-suntech-devices-on-navixy.md): como as entradas físicas Suntech se mapeiam para os canais de entrada da Navixy
* [Configurando Suntech ST4410G master-slave na Navixy](/docs/expert-center/pt-br/faq-and-troubleshooting/sensors/configuring-suntech-st4410g-master-slave-on-navixy.md): redundância master-slave, monitoramento de distância e integração de alertas


---

# 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/expert-center/pt-br/faq-and-troubleshooting/sensors/configuring-ble-sensors-on-suntech-trackers-in-navixy-bluetooth.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.
