> 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

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, no 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 alcance real desse controle depende do que está conectado à saída do dispositivo.

![Exemplo de widget de controle de saída](/files/f700ba7c6eee8b0f888e2bc2ff7ac453c9631129)

## 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 do estado de sua saída de volta para a plataforma, o último estado de saída recebido do dispositivo é exibido. 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 pode apenas ativá-las.

![Como o controle de saída funciona com dispositivo On-line e estados conhecidos](/files/50562535a3a74cefcf69f5650807b88ce0a88c7c)

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

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

* Se o dispositivo estiver off-line e o controle por SMS das saídas não estiver disponível para o modelo, o widget exibe 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 um dispositivo off-line](/files/b990ca1ec8f29374f6e1b7501b447a7ec8358191)

Então, 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](/files/1c9b700702d26c8b9b8721a7b3418f5867e7fe47)

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

* Será uma chamada de API [/tracker/output/set\_all](/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/output.md#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 estão desligadas no momento usaria um comando como 'setdigout 1,0,0'.
* Será uma chamada de API [/tracker/output/set](/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/output.md#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](/docs/admin/devices/air-console.md) que está disponível para todos os parceiros no painel de administração.

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 15 minutos tenham se passado. Isso é 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 dispositivo

### Formas de enviar comandos

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

* 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: isso 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 pela internet. No entanto, o método usado depende da integração do dispositivo. Normalmente, para dispositivos com controle pela internet, esse método é usado exclusivamente, mesmo que o próprio dispositivo também ofereça suporte a SMS. Isso está ligado 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 dispositivo incorporam lógica de Segurança para controle de saída. Elas são projetadas para impedir ações como desligar o motor enquanto o veículo está em Movimento. Os recursos de Segurança estão incorporados nos 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 Acelerômetro detectar Movimento.
* 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 poderão ser ignorados.
* Configuração de comandos pela internet: os dispositivos podem ignorar comandos pela internet até serem 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 desligar o motor via SMS. No entanto, não oferecemos suporte a esses comandos por motivos 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 possíveis pelos quais o controle de saída pode não funcionar como esperado.

* Dispositivo off-line, SMS sem suporte: 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 com suporte, mas o painel não tem o gateway de SMS conectado: o dispositivo pode estar On-line, mas oferece suporte apenas 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 a instalação do gateway de SMS](/docs/admin/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 o [opções do plano do dispositivo](/docs/admin/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 para 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 com a 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 por 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 Air Console e ele estiver alinhado com o protocolo do dispositivo, então o problema provavelmente não se origina da plataforma. Nesses casos, é recomendável verificar a lista acima e entrar em contato com o fabricante do dispositivo para determinar a causa da falha no 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 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/expert-center/pt-br/faq-and-troubleshooting/gps-devices/outputs-control.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.
