> 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 dispositivo 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 fechaduras, buzzers, 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 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ídas](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)

## Como o controle de saídas funciona

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

O usuário abre o widget do dispositivo na UI ou no aplicativo X-GPS Monitor. Há três formas distintas de exibição dos widgets de controle de saídas:

* Se um modelo de dispositivo puder retransmitir suas informações de estado de saída de volta à plataforma, é exibido o último estado de saída recebido do dispositivo. Por exemplo, se a saída estava "ligada", o usuário terá apenas 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ídas 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)

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

![Como o controle de saídas 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)

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

![Como o controle de saídas funciona em dispositivo offline](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)

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 da 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)

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

* Será uma chamada de API [/tracker/output/set\_all](/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, ativar a saída 1 em um dispositivo Teltonika com 3 saídas em que todas as saídas estejam desligadas no momento usaria um comando como 'setdigout 1,0,0'.
* Será uma chamada de API [/tracker/output/set](/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ídas em 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.

Após iniciar o comando, a plataforma envia o comando de controle de saídas para o dispositivo. Isso pode ser verificado por meio do [Air Console](/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ídas até que um novo estado de saída seja recebido ou 15 minutos tenham se passado. Isso serve para evitar spam 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ídas volta a ficar disponível.

## Como o controle de saídas funciona em diferentes modelos de dispositivo

### Formas de enviar comandos

Os comandos para gerenciar saídas podem ser enviados de algumas formas diferentes, dependendo do dispositivo e de suas capacidades:

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

Os modelos de dispositivo 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 via 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ídas.

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

Vários modelos de dispositivo incorporam lógica de segurança para o controle de saídas. 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 formas:

* Omissão por limite de velocidade: o dispositivo pode ignorar comandos de controle de saídas 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ídas se o movimento for detectado por um acelerômetro.
* Omissão baseada em cenário: por exemplo, dispositivos Teltonika permitem vincular DOUTs a diferentes cenários para comutação automática, e comandos de controle de saídas 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 poderão 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 possuir um comando de emergência específico para parar o motor via SMS. No entanto, não oferecemos suporte a esses comandos devido a preocupações de segurança. Por exemplo, esse é o caso de alguns dispositivos Coban.

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

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

* Dispositivo offline, SMS não suportado: o dispositivo pode estar offline 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 gateway SMS conectado: o dispositivo pode estar on-line, mas oferece suporte apenas a SMS para o controle de saídas, 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](/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](/docs/admin/pt-br/plans.md).
* Lógica específica de controle de saídas: o dispositivo pode ter uma lógica especializada de controle de saídas que afete sua operação. Por exemplo, a lógica de segurança ou de cenário descrita acima.
* Senha não padrão para o controle de saídas: o dispositivo pode estar configurado com uma senha para o controle de saídas que não seja 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ídas pela internet: o dispositivo pode não estar configurado corretamente para receber comandos de controle de saídas baseados na internet. Verifique as configurações do dispositivo e habilite o controle de saídas.
* 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 tudo está 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, conforme o protocolo e a integração do dispositivo. Isso é possível se o protocolo e os comandos tiverem sido alterados ou se alguma outra lógica tiver sido adicionada pelo fabricante.

Se a plataforma enviar o comando no Air Console e ele estiver alinhado ao protocolo do dispositivo, então o problema provavelmente não se origina na plataforma. Nesses casos, é aconselhável verificar a lista acima e contatar o fabricante do dispositivo para determinar a causa da falha no controle de saídas.

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.
