> 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/gps-devices/outputs-control.md).

# Controle de saídas

Controle saídas remotas na Navixy para ativar travas, imobilizadores e corte do motor. Abrange lógica de Segurança, métodos de comando e solução de problemas de dispositivos.

Vários modelos de dispositivos vêm equipados com a capacidade de controlar o estado de dispositivos conectados ou motores. Esse recurso pode ser aplicado a uma variedade de componentes, incluindo travas, campainhas, imobilizadores, sistemas de corte de óleo/motor e sistemas automáticos de aquecimento do motor, como o Webasto. Ele pode até se estender a aplicações de casa inteligente, como tomadas inteligentes e lâmpadas inteligentes, entre outras. Ele pode ser usado, por exemplo, em seu motorhome, que é melhor rastrear e controlar por meio de um dispositivo GPS. O conceito principal aqui é a capacidade de ligar ou desligar remotamente uma função ou um dispositivo específico por meio de um comando transmitido pelo ar. É claro que o escopo real desse controle depende do que está conectado à saída do dispositivo.

![Exemplo de widget de controle de saída](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2a8bca84847247dbee45ddd358b1376eb00f08d8%2Fimagen-20230727-155729.png?alt=media\&token=b80592ab-6b10-4354-bf4c-d23e0db616a5)

## Como o controle de saída funciona

O controle de saída na plataforma Navixy funciona da seguinte forma:

O usuário abre o widget do dispositivo na interface do usuário ou no aplicativo X-GPS Monitor. Há três maneiras distintas pelas quais os widgets de controle de saída são exibidos:

* Se o modelo do dispositivo puder enviar de volta à plataforma as informações sobre o estado de sua saída, o último estado de saída recebido do dispositivo é exibido. Por exemplo, se a saída estava "ligada", o usuário só terá a opção de enviar um comando de "desligar a saída" e vice-versa. Na próxima captura de tela, todas as 4 saídas estão desativadas e o usuário só pode ativá-las.

![Como o controle de saída funciona com dispositivo on-line e estados conhecidos](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-5bb3faa13863216e54c458d41ca5a9c1f6ce2b87%2Fimage-20240125-094039.png?alt=media\&token=e725f936-1bdf-4698-9df3-48ef4da4a6d2)

* Se o modelo do dispositivo não fornecer uma resposta à plataforma ou não incluir o estado da saída em suas mensagens, a plataforma pode enviar qualquer comando, seja para ligar ou desligar o estado da saída. O usuário pode clicar na área vermelha para enviar um comando de "saída desligada" e na área verde para enviar um comando de "saída ligada".

![Como o controle de saída funciona com dispositivos sem estado](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-455b52e203e6dd2737817b508b5445625372c27b%2Fimage-20240125-093603.png?alt=media\&token=44b6e15a-e565-4f3c-bdb7-ab3d7fa44349)

* Se o dispositivo estiver off-line e o controle das saídas por SMS não estiver disponível para o modelo, o widget exibe os últimos estados conhecidos da saída em um modo esmaecido, indicando que o controle de saída não é possível.

![Como o controle de saída funciona em dispositivo off-line](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8fd54911ca29ffe1bffc68a328ec3c6c15d9d360%2Fimage-20240125-093342.png?alt=media\&token=cacf492d-7900-42e1-a5aa-bc445af44f3a)

Em seguida, o cliente seleciona a saída desejada e altera seu estado. Por exemplo, se o usuário decidir desligar a saída 1, a plataforma solicitará confirmação para evitar ativação acidental.

![Confirmação de alteração do estado das saídas](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-48b9868c27e1d155833e5a8ec97668eda7defc9d%2Fimage-20240125-095825.png?alt=media\&token=4a6c9d33-de12-4432-8921-ef587affcb15)

Confirmar é equivalente a enviar uma solicitação de API:

* Será uma chamada de API [/tracker/output/set\_all](https://navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/output.md#post-tracker-output-set_all) se o dispositivo oferecer suporte a comandos que listam todos os estados simultaneamente. Por exemplo, habilitar a saída 1 em um dispositivo Teltonika com 3 saídas, em que todas as saídas estão desligadas no momento, usaria um comando como 'setdigout 1,0,0'.
* Será uma chamada de API [/tracker/output/set](https://navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/output.md#post-tracker-output-set) se o dispositivo oferecer suporte ao envio de comandos para cada saída individualmente.

Usando APIs, você pode [automatizar o controle de saída no seu dispositivo](https://www.navixy.com/blog/cloud-functions-for-tailored-vehicle-telematics-solutions/?utm-source=slack), vinculando-o a tipos específicos de eventos ou valores recebidos.

Depois de iniciar o comando, a plataforma envia o comando de controle de saída para o dispositivo. Isso pode ser verificado por meio do [Air Console](https://navixy.com/docs/admin/pt-br/devices/air-console.md) que está disponível para todos os parceiros no painel Admin.

No caso de um widget de saída com estados conhecidos, a plataforma bloqueia temporariamente o widget de controle de saída até que um novo estado de saída seja recebido ou 15 minutos tenham se passado. Isso serve para evitar o envio excessivo de comandos, o que poderia causar erros ou mau funcionamento do dispositivo.

Assim que um novo estado é recebido, a plataforma atualiza o widget para refletir o novo estado, e o controle de saída fica disponível novamente.

## Como o controle de saída funciona em diferentes modelos de dispositivos

### Formas de enviar comandos

Os comandos para gerenciar saídas podem ser enviados de algumas maneiras diferentes, dependendo do dispositivo e de seus recursos:

* SMS: Este método é usado se o dispositivo estiver off-line ou oferecer suporte apenas a mensagens SMS para gerenciar saídas.
* Internet móvel: Isto se aplica a dispositivos padrão que podem operar os controles de saída usando uma conexão com a internet.

Os modelos de dispositivos podem oferecer suporte tanto a comandos de controle por SMS quanto por internet. No entanto, o método usado depende da integração do dispositivo. Normalmente, para dispositivos com controle por internet, esse método é usado exclusivamente, mesmo que o próprio dispositivo também ofereça suporte a SMS. Isso está relacionado a diferentes lógicas de segurança do controle de saída.

### Diferentes lógicas de segurança do controle de saída

Vários modelos de dispositivos incorporam lógica de segurança para o controle de saída. Elas foram projetadas para evitar ações como desligar o motor enquanto o veículo está em movimento. Os recursos de segurança são incorporados aos próprios dispositivos, pois a plataforma não inclui essas opções de segurança.

A lógica de segurança pode ser implementada de várias maneiras:

* Omissão por limite de velocidade: o dispositivo pode ignorar comandos de controle de saída se a velocidade do veículo exceder um determinado limite, como 5 km/h.
* Sensor de movimento (acelerômetro): alguns dispositivos podem ignorar comandos de controle de saída se o movimento for detectado por um acelerômetro.
* Omissão baseada em cenário: por exemplo, dispositivos Teltonika permitem que DOUTs sejam vinculados a diferentes cenários para comutação automática, e comandos de controle de saída podem ser omitidos com base nesses cenários.
* Proteção por senha: os comandos podem ser ignorados se não incluírem uma senha específica. Nossa plataforma oferece suporte a comandos padrão e senhas padrão.
* Verificação de remetente confiável: alguns dispositivos aceitam comandos apenas de remetentes confiáveis. Se nossa plataforma não estiver listada como remetente confiável, os comandos podem ser ignorados.
* Configuração de comandos pela internet: os dispositivos podem ignorar comandos pela internet até que estejam configurados corretamente para recebê-los.

É importante observar que alguns dispositivos implementam lógica de segurança apenas para comandos pela internet, mas ainda podem aceitar um comando SMS específico de emergência que desliga um motor em funcionamento. No entanto, não oferecemos suporte a tais comandos devido a preocupações com a segurança. Por exemplo, esse é o caso de alguns dispositivos Coban.

## Por que o controle de saída pode não funcionar

Há vários motivos possíveis pelos quais o controle de saída pode não funcionar como esperado.

* Dispositivo off-line, SMS não suportado: o dispositivo pode estar off-line e, para este modelo específico, o gerenciamento por SMS pode não ser suportado. Aguarde até que seu dispositivo fique on-line e tente novamente.
* Dispositivo on-line, apenas SMS suportado, mas o painel não tem o gateway SMS conectado: o dispositivo pode estar on-line, mas oferece suporte apenas a SMS para controle de saída, e o gateway SMS não está conectado ao painel. Nesse caso, você pode solicitar a instalação do seu gateway SMS. Verifique [os requisitos para a instalação do gateway SMS](https://navixy.com/docs/admin/pt-br/settings/messaging-gateways.md#sms-gateway).
* Saldo insuficiente para SMS: o usuário pode não ter crédito suficiente para enviar mensagens SMS, conforme exigido pelo plano do dispositivo. Verifique o saldo do usuário e as [opções do plano do dispositivo](https://navixy.com/docs/admin/pt-br/plans.md).
* Lógica específica de controle de saída: o dispositivo pode ter uma lógica especializada de controle de saída que afeta seu funcionamento. Por exemplo, a lógica de segurança ou de cenário descrita acima.
* Senha não padrão para controle de saída: o dispositivo pode estar configurado com uma senha de controle de saída que não é a padrão. Nesse caso, verifique as configurações do dispositivo e habilite a senha padrão.
* Dispositivo não configurado para controle de saída pela internet: o dispositivo pode não estar configurado corretamente para receber comandos de controle de saída baseados na internet. Verifique as configurações do dispositivo e habilite o controle de saída.
* Plataforma não confiável para comandos: a plataforma pode não estar listada pelo dispositivo como remetente confiável de comandos. Nesse caso, adicione a plataforma à lista de remetentes confiáveis.
* Fiação incorreta: pode haver um problema na fiação, como polaridade incorreta dos fios ou conexão inadequada. Verifique novamente como a saída está conectada. A maneira mais rápida é usar comandos SMS. Se funcionar com SMS, então está tudo conectado corretamente.
* Incompatibilidade de firmware: o dispositivo pode estar executando uma versão de firmware que não oferece suporte aos comandos usados pela plataforma, de acordo com o protocolo e a integração do dispositivo. Isso é possível se o protocolo e os comandos tiverem sido alterados ou se o fabricante tiver adicionado alguma outra lógica.

Se a plataforma enviar o comando no Air Console e ele estiver alinhado com o protocolo do dispositivo, então o problema provavelmente não se origina da plataforma. Nesses casos, é aconselhável verificar a lista acima e entrar em contato com o fabricante do dispositivo para determinar a causa do mau funcionamento do controle de saída.

Caso o comando não esteja correto, entre em contato com nossa [equipe de suporte](mailto:support@navixy.com).


---

# 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/gps-devices/outputs-control.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.
