> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/connectors.md).

# Conectores

Ligue protocolos de dispositivos ao Kilo IoT — LNS (LoRaWAN), Tracker (OBD2/CAN/GPS), MQTT, Mioty e Emulator numa única pipeline.

Cada conector estabelece uma ligação ao nível da organização a um protocolo de dispositivo específico ou fonte de dados. Os conectores não criam dispositivos — o registo de dispositivos é um fluxo de trabalho separado. Um conector permite que o servidor aceite dados de dispositivos desse tipo assim que estiverem registados.

Sem pelo menos um conector, o servidor não tem nenhuma vinculação de protocolo através da qual receber dados de dispositivos. Cada caminho de dados — seja LoRaWAN, rastreador de veículos ou um protocolo futuro — começa com um conector.

## Tipos de conectores

O Kilo IoT Server suporta os seguintes tipos de conector:

| Tipo         | Protocolo            | Estado | O que liga                                                                                                                                                                                                                                       |
| ------------ | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **LNS**      | LoRaWAN              | GA     | O servidor de rede LoRaWAN integrado no servidor. Gere automaticamente a comunicação dos dispositivos LoRaWAN.                                                                                                                                   |
| **Tracker**  | OBD2 / CAN bus / GPS | GA     | Rastreadores de veículos — dispositivos de rastreio de veículos OBD2, CAN bus e GPS autónomo. Inclui modelos pré-configurados para mais de 2.000 modelos de rastreadores de veículos.                                                            |
| **MQTT**     | MQTT                 | GA     | Ligações diretas de dispositivos MQTT. Duas variantes: **MQTT externo** liga-se ao seu próprio broker (até 10 por organização); **MQTT na nuvem** usa um broker provisionado pela plataforma com credenciais dedicadas por conector (ilimitado). |
| **Mioty**    | MIOTY                | GA     | A vinculação ao centro de serviço MIOTY da sua organização. Provisiona um endereço BSSCI ao qual as suas estações base MIOTY se ligam e desbloqueia os campos do endpoint MIOTY no formulário do dispositivo.                                    |
| **Emulador** | — (dados gerados)    | GA     | Dispositivos que geram a sua própria telemetria, para que possa criar e testar uma implementação antes de chegar qualquer hardware — e depois trocar o dispositivo para um conector real quando ele chegar.                                      |

Cada organização pode ter **um conector LNS** e **um conector Rastreador**. Os conectores MQTT existem em duas variantes com limites diferentes: MQTT externo — até 10 por organização; MQTT na nuvem — ilimitado.

## A página Conectores

Navegue até **Conectores** na barra lateral para ver a tabela de conectores. A tabela mostra todos os conectores configurados para a sua organização com as seguintes colunas:

| Coluna                      | Descrição                                                         |
| --------------------------- | ----------------------------------------------------------------- |
| **Nome**                    | O nome do conector (atribuído automaticamente durante a criação)  |
| **Últimos dados recebidos** | Quando o conector recebeu dados de um dispositivo pela última vez |
| **Dispositivos ligados**    | Número de dispositivos registados através deste conector          |
| **Data de criação**         | Quando o conector foi adicionado                                  |

### Ações da linha

Cada linha de conector tem botões de ação:

* **Adicionar dispositivo** — Abre a caixa de diálogo de registo de dispositivo com este conector pré-selecionado — um atalho para o fluxo de registo partilhado.
* **Remover conector** — Remove o conector da organização. Uma caixa de diálogo de confirmação aparece antes da eliminação.

Clique em qualquer ponto de uma linha de conector para abrir a página de detalhes desse conector, onde pode gerir gateways (para LNS) ou ver e gerir dispositivos ligados.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-6a3c1faede259343e5764c3199e96c1ad468bbd5%2Fconnectors-list.jpg?alt=media" alt="The Connectors page listing connectors with last data received, connected device count and row actions"><figcaption></figcaption></figure>

## Adicionar um conector

1. A partir da **Conectores** página, clique em **Adicionar conector** no canto superior direito.
2. Na caixa de diálogo, selecione um **Tipo de conector** no menu pendente:
   * **LNS** — se a sua organização ainda não tiver um conector LNS
   * **Tracker** — se a sua organização ainda não tiver um conector Rastreador
   * **MQTT externo** — liga-se ao seu próprio broker MQTT (até 10 por organização)
   * **MQTT na nuvem** — broker provisionado pela plataforma; cada conector recebe as suas próprias credenciais dedicadas (ilimitado)
   * **Mioty** — vincula a sua organização ao centro de serviço MIOTY e provisiona o respetivo endereço BSSCI
   * **Emulador** — gera dados de dispositivos sem hardware, para que possa criar e testar antes de chegarem os seus sensores (um por organização)
3. Clique **Adicionar**.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-3b4399167729628f590f8314b876b6d1c2296cfb%2Fconnector-type-list.jpg?alt=media" alt="The Add connector dialog with the Connector type dropdown open, listing the types still available to this organization"><figcaption></figcaption></figure>

Os tipos limitados a um por organização desaparecem do menu pendente assim que tiver um, pelo que a lista que vê é o conjunto ainda disponível para si.

Para conectores LNS, Tracker e Emulator, não é necessária configuração adicional durante a criação — o servidor trata da integração automaticamente. Para MQTT externo, configure os detalhes da ligação ao broker após a criação. Para MQTT na nuvem, a plataforma gera e apresenta credenciais imediatamente após a criação.

## O que se segue

Assim que um conector estiver configurado, pode:

* **Configurar o conector LNS** — gerir gateways LoRaWAN e dispositivos ligados, e explorar material de referência do protocolo LoRaWAN, incluindo bandas de frequência por país. Veja [Conector LNS](/kilo-docs-pt/kilo-iot-server/connectors/lns-connector.md).
* **Configurar o conector Tracker** — integrar rastreadores de veículos (OBD2, CAN bus, GPS autónomo). Veja [Conector Tracker](/kilo-docs-pt/kilo-iot-server/connectors/tracker-connector.md).
* **Configurar um conector MQTT** — ligar PLCs, contadores de energia, sistemas de gestão de edifícios ou qualquer hardware compatível com MQTT. Use MQTT externo para ligar o seu próprio broker, ou MQTT na nuvem para que a plataforma lhe provisione um endpoint de broker. Veja [Conector MQTT](/kilo-docs-pt/kilo-iot-server/connectors/mqtt-connector.md).
* **Configurar o conector Mioty** — vincular a sua organização ao centro de serviço MIOTY, obter o respetivo endereço BSSCI e desbloquear o registo da estação base e os campos de endpoint MIOTY. Veja [Conector MIOTY](/kilo-docs-pt/kilo-iot-server/connectors/mioty-connector.md).
* **Adicionar o conector Emulator** — colocar em funcionamento dispositivos que geram a sua própria telemetria, para que painéis, regras e alarmes possam ser criados e validados antes de qualquer hardware estar no local. Veja [Conector Emulador](/kilo-docs-pt/kilo-iot-server/connectors/emulator-connector.md).
* **Registar dispositivos** — adicionar dispositivos através de qualquer conector e configurar o respetivo Gémeo Digital. Veja [Registo de Dispositivos](/kilo-docs-pt/kilo-iot-server/devices/registering-devices.md).


---

# 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://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/connectors.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.
