> 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/connectivity/data-forwarding/wialon-ips.md).

# Wialon IPS

Retransmita dados de GPS, sensores e eventos para servidores de monitoramento baseados em Wialon ou para um segundo servidor Navixy usando o protocolo Gurtam Wialon IPS via TCP.

Wialon IPS é um protocolo público da Gurtam para transmitir dados de dispositivos GPS entre servidores. Como ele é documentado abertamente e amplamente suportado, é a opção de uso geral quando o sistema de destino não é uma das integrações nomeadas.

Dois usos são comuns:

* Encaminhar dados do Navixy para um servidor de monitoramento baseado em Wialon, ou para qualquer servidor que aceite Wialon IPS.
* Copiar dados entre dois servidores Navixy, por exemplo, de uma conta ServerMate para uma instalação On-Premise.

O Wialon IPS envia mais dados originais do dispositivo do que qualquer outro protocolo de encaminhamento, porque inclui toda leitura de sensor que o dispositivo relatou como um parâmetro nomeado.

No Navixy, selecione **Wialon IPS** em **Protocolo** o menu suspenso.

## O que o Navixy envia

O Navixy abre uma conexão TCP, envia um pacote de login e, em seguida, envia um pacote de dados por mensagem. Ambos são em texto puro.

O pacote de login identifica o dispositivo e, quando uma senha é definida, autentica:

```
#L#<id do dispositivo>;<senha>
```

Cada pacote de dados começa com `#D#` e contém estes valores em ordem:

| Valor                | Conteúdo                                                |
| -------------------- | ------------------------------------------------------- |
| Data e hora          | Quando o dispositivo registrou a posição, em UTC        |
| Latitude e longitude | Posição no formato NMEA                                 |
| Velocidade           | Velocidade                                              |
| Rumo                 | Direção de deslocamento em graus                        |
| Altitude             | Altitude em metros                                      |
| Satélites            | Número de satélites utilizados, ou `NA`                 |
| HDOP                 | Precisão horizontal, ou `NA`                            |
| Entradas e saídas    | Estados de entrada e saída digitais, ou `NA`            |
| Sensores analógicos  | Valores dos sensores analógicos, separados por vírgulas |
| ID do motorista      | A chave de identificação do motorista, ou `NA`          |
| Parâmetros nomeados  | Toda leitura restante do sensor, como `nome:tipo:valor` |

Os parâmetros nomeados sempre incluem `EVENT`, que contém o código de evento da Navixy. A Navixy os adiciona quando os dados estiverem disponíveis:

* `SOS`, definido como `1` em um evento de SOS ou de contato de emergência
* `quilometragem_bruta`, a leitura do Odômetro em metros
* `nível_da_bateria`, o nível da bateria
* `gsm.signal.csq`, a intensidade do sinal móvel
* Um parâmetro para cada entrada adicional de sensor que o dispositivo informou

O Navixy envia todas as mensagens, inclusive mensagens sem posição.

## Antes de começar

Reúna o seguinte:

* O endereço e a porta do servidor receptor.
* A senha do Wialon IPS, quando o servidor receptor exigir uma. Muitos não exigem.

Quando você encaminhar entre dois servidores Navixy, use o endereço e a porta do servidor receptor `47768`.

O ID externo não é obrigatório. A Navixy envia o ID do dispositivo, a menos que você defina um.

{% hint style="info" %}
Para receber dados do Wialon no Navixy em vez de enviá-los, aponte a parte do Wialon para `tracker.navixy.com` para a plataforma da UE ou `tracker.us.navixy.com` para a plataforma dos EUA, na porta `47768`. Você também precisa criar um dispositivo no Navixy usando um modelo compatível com Wialon IPS, como Bitrek, para que a Navixy aceite os dados recebidos.
{% endhint %}

## Configurar encaminhamento

{% stepper %}
{% step %}

### Abra o bloco Encaminhamento de dados

Dispositivos e configurações **na barra lateral esquerda.**, selecione um dispositivo e, em seguida, encontre o **Encaminhamento de dados** bloco.
{% endstep %}

{% step %}

### Abra a lista de protocolos

Salvar **Protocolos**, depois clique em **+** para adicionar uma configuração.
{% endstep %}

{% step %}

### Insira as configurações do Wialon IPS

Preencha os campos da seguinte forma:

* **Nome**: um rótulo que identifica este retransmissor
* **Protocolo**: **Wialon IPS**
* **Endereço**: o endereço do servidor de recebimento
* **Porta**: a porta do servidor de recebimento, ou `47768` entre dois servidores Navixy
* **Senha**: a senha do Wialon IPS, quando o servidor de recebimento exigir uma

Este protocolo não usa login. Deixe esse campo em branco.
{% endstep %}

{% step %}

### Ative e salve

Ative **Ativado**, depois clique em **para salvar o comando. Clique em**. Um retransmissor que não está ativado não envia nada.
{% endstep %}

{% step %}

### Vincule o retransmissor a um dispositivo

No dispositivo **Encaminhamento de dados** bloco, ative o alternador do retransmissor que você criou e, em seguida, clique **para salvar o comando. Clique em**. Deixe o ID externo em branco, a menos que o servidor de recebimento exija um ID de dispositivo diferente.
{% endstep %}
{% endstepper %}

## Gerenciar encaminhamento

Para alterar ou interromper o encaminhamento via Wialon IPS:

* Desative o botão de alternância no **Encaminhamento de dados** bloco para interromper o encaminhamento para um dispositivo e manter a configuração para os demais.
* Salvar **Protocolos**, selecione a linha e edite-a para alterar o nome, o endereço, a porta ou a senha. A alteração se aplica a todos os dispositivos vinculados a este retransmissor.
* Exclua a configuração da **Protocolos** lista para interromper o encaminhamento para todos os dispositivos. Confirme na caixa de diálogo.

## Solução de problemas

Quando os dados não aparecerem no servidor de recebimento, verifique o seguinte, nesta ordem:

1. O retransmissor está ativado e seu alternador está ligado para o dispositivo.
2. O endereço e a porta estão corretos, e o servidor de recebimento aceita conexões TCP nessa porta.
3. A senha corresponde ao que o servidor de recebimento exige, quando ele exige uma.
4. O servidor de recebimento aceita o ID do dispositivo que a Navixy envia. Quando ele exigir um ID diferente, defina-o no campo ID externo.

Quando você receber dados do Wialon no Navixy e nada chegar, confirme se um dispositivo foi criado no Navixy com um modelo compatível com Wialon IPS.


---

# 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/connectivity/data-forwarding/wialon-ips.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.
