> 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 a transmissão de dados de dispositivos GPS entre servidores. Como é amplamente documentado e tem suporte generalizado, é 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 dos dados originais do dispositivo do que qualquer outro protocolo de encaminhamento, porque inclui cada leitura de sensor que o dispositivo informou como um parâmetro nomeado.

Na Navixy, selecione **Wialon IPS** em **Protocolo** menu suspenso.

## O que a Navixy envia

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

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

```
#L#<device id>;<password>
```

Cada pacote de dados começa com `#D#` e contém estes valores na seguinte 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 do deslocamento em graus                        |
| Altitude             | Altitude em metros                                      |
| Satélites            | Número de satélites usados, 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  | Cada leitura de sensor restante, como `name:type:value` |

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

* `SOS`, definido para `1` em um evento de SOS ou de contato de emergência
* `raw_quilometragem`, 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 relatou

O Navixy envia cada mensagem, inclusive mensagens sem posição.

## Antes de começar

Colete o seguinte:

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

Quando você encaminhar entre dois servidores Navixy, use o endereço e a porta do servidor de recebimento `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 o lado 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 o encaminhamento

{% stepper %}
{% step %}

### Abrir o bloco de Encaminhamento de dados

Acesse **Dispositivos e configurações**, selecione um dispositivo e localize o **Encaminhamento de dados** bloco.
{% endstep %}

{% step %}

### Abrir a lista de protocolos

Clique em **Protocolos**, e 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 %}

### Ativar e salvar

Ligar **Ativado**, e depois clique em **Salvar**. Um retransmissor que não está ativado não envia nada.
{% endstep %}

{% step %}

### Vincular o retransmissor a um dispositivo

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

## Gerenciar o encaminhamento

Para alterar ou interromper o encaminhamento via Wialon IPS:

* Desative a chave no **Encaminhamento de dados** bloco para interromper o encaminhamento de um dispositivo e mantenha a configuração para os outros.
* Clique em **Protocolos**, selecione a linha e edite-a para alterar o nome, endereço, porta ou 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 aparecem no servidor de recebimento, verifique o seguinte, nesta ordem:

1. O retransmissor está ativado e sua chave está ligada 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 exigir uma.
4. O servidor de recebimento aceita o ID do dispositivo que Navixy envia. Quando ele exigir um ID diferente, defina-o no campo External ID.

Quando você receber dados do Wialon para o Navixy e nada chegar, confirme que foi criado um dispositivo 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 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/connectivity/data-forwarding/wialon-ips.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.