# Controle de saídas

Vários modelos de dispositivo vêm equipados com a capacidade de controlar o estado de dispositivos ou motores conectados. Esse recurso pode ser aplicado a uma variedade de componentes, incluindo travas, buzzeres, 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 sua casa sobre rodas, que é melhor rastrear e controlar via rastreador GPS. O conceito principal aqui é a capacidade de ligar ou desligar uma função ou dispositivo específico remotamente 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](/files/e98068678d60b3d7cf2ed2c4599aad2871c3dd4b)

## 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 um modelo de dispositivo puder retransmitir as informações de estado de sua saída de volta para a plataforma, o último estado de saída recebido do dispositivo será exibido. Por exemplo, se a saída estava 'ligada', o usuário terá apenas a opção de enviar um comando de 'desligar saída' e vice-versa. Na próxima captura de tela, todas as 4 saídas estão desativadas e o usuário pode apenas ativá-las.

![Como o controle de saída funciona com dispositivo online e estados conhecidos](/files/3643a50172f29e9f48f24b4b1b6bc1440004481f)

* 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 poderá 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 'desligar saída' e na área verde para enviar um comando de 'ligar saída'.

![Como o controle de saída funciona com dispositivos sem estado](/files/a2bbde95e853164984b25278a6ae458410f2fb50)

* Se o dispositivo estiver offline e o controle de saída por SMS 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ída não é possível.

![Como o controle de saída funciona em dispositivo offline](/files/202a26b0943a0aab7464d891b79ea36e603ea148)

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](/files/077063dc8d6adbfc2e4bc2af503794d1557a043f)

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

* Será uma chamada de API [/tracker/output/set\_all](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/output#set_all) se o dispositivo oferecer suporte a comandos que listem 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 estão desligadas no momento, usaria um comando como 'setdigout 1,0,0'.
* Será uma chamada de API [/tracker/output/set](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/output#set) se o dispositivo oferecer suporte ao envio de comandos para cada saída individualmente.

Ao usar 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.

Após 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](/docs/admin/pt-br/devices/air-console.md) que está disponível para todos os parceiros no painel Admin.

No caso do 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 tenham se passado 15 minutos. Isso é feito para evitar o envio excessivo de comandos, o que poderia causar erros ou mau funcionamento do dispositivo.

Assim que um novo estado for recebido, a plataforma atualiza o widget para refletir o novo estado, e o controle de saída volta a ficar disponível.

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

### 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 offline ou se apenas mensagens SMS forem suportadas para gerenciar saídas.
* Internet móvel: aplicável a dispositivos padrão que podem operar os controles de saída usando uma conexão à 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 por internet, esse método é usado exclusivamente, mesmo que o dispositivo também ofereça suporte a SMS. Isso está relacionado a uma lógica diferente de segurança no controle de saída.

### Lógica diferente de segurança no controle de saída

Diversos modelos de dispositivo incorporam lógica de segurança para 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 integrados 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 vinculadas a diferentes cenários para comutação automática, e os comandos de controle de saída podem ser ignorados 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 a nossa plataforma não estiver listada como remetente confiável, os comandos poderão ser ignorados.
* Configuração de comandos por internet: os dispositivos podem ignorar comandos pela internet até que estejam devidamente configurados para recebê-los.

É importante observar que alguns dispositivos implementam lógica de segurança apenas para comandos por internet, mas ainda podem possuir um comando de emergência específico para desligar o motor via SMS. No entanto, não oferecemos suporte a esses comandos devido a questões de 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 potenciais pelos quais o controle de saída pode não funcionar como esperado.

* Dispositivo offline, SMS sem suporte: 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 online e tente novamente.
* Dispositivo online, apenas SMS suportado, mas o painel não tem gateway de SMS conectado: o dispositivo pode estar online, mas só oferece suporte a SMS para controle de saída, e o gateway de SMS não está conectado ao painel. Nesse caso, você pode solicitar a instalação do seu gateway de SMS. Verifique [os requisitos para instalação do gateway de SMS](/docs/admin/pt-br/settings/messaging-gateways.md#sms-gateway).
* Fundos insuficientes para SMS: o usuário pode não ter crédito suficiente para enviar mensagens SMS, conforme exigido pelo plano do rastreador. Verifique o saldo do usuário e as [opções de plano do rastreador](/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 sua operação. 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 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í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 com a fiação, como polaridade incorreta dos fios ou conexão inadequada. Verifique novamente como a saída está conectada. A forma 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, 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 alguma outra lógica tiver sido adicionada pelo fabricante.

Se a plataforma enviar o comando no AirConsole 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: 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:

```
GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/gps-devices/outputs-control.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
