> 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-center/kilo-mioty-service-center/onboarding/register-an-endpoint.md).

# Registar um Endpoint

Registe um endpoint MIOTY no KiloCenter — campos obrigatórios (EUI, chave de rede, perfil) e como uma estação base se liga.

### Objetivo

Crie um endpoint no KiloCenter para que possa ser anexado por uma estação base e trocar tráfego.

### Pré-requisitos

* KC-Core, KC-Gateway e KC-Web em execução
* Pelo menos uma estação base conectada (consulte Ligar uma Estação Base)

### Campos Obrigatórios

| Campo      | Formato                                        | Descrição                                                              |
| ---------- | ---------------------------------------------- | ---------------------------------------------------------------------- |
| `epEui`    | Cadeia hexadecimal de 16 caracteres (8 bytes)  | Identificador único do endpoint. Deve corresponder ao EUI do hardware. |
| `nome`     | Texto livre                                    | Etiqueta legível para o endpoint.                                      |
| `nwkSnKey` | Cadeia hexadecimal de 32 caracteres (16 bytes) | Chave de sessão de rede para autenticação de quadros.                  |
| `shAddr`   | Inteiro                                        | Endereço curto atribuído ao endpoint.                                  |

Estes valores provêm do processo de aprovisionamento do endpoint. O EUI e a chave de sessão de rede devem corresponder ao que está programado no hardware do endpoint.

### Registar através do KC-Web

1. Abra o KC-Web em `http://localhost/` (contentor) ou `http://localhost:5173` (desenvolvimento a partir do código-fonte).
2. Navegue para **Endpoints** na barra lateral.
3. Clica em **Adicionar Endpoint**.
4. Preencha os campos obrigatórios:
   * **EUI**: o EUI hexadecimal de 16 caracteres (por ex., `0011223344556677`)
   * **Nome**: uma etiqueta descritiva
   * **Chave de Sessão de Rede**: a chave hexadecimal de 32 caracteres
   * **Endereço Curto**: o endereço curto atribuído
5. Se o endpoint suportar comunicação bidirecional, ative a **Bidirecional** opção.
6. Guarde o endpoint.

### Validar o Estado do Endpoint

Após o registo, o endpoint deve aparecer na **Endpoints** lista com estado registado. Assim que uma estação base realizar uma operação de anexação para este endpoint, o estado será atualizado para refletir a ligação ativa.

### Campos de Perfil MIOTY Opcionais (Edição Enterprise)

A especificação MIOTY define campos adicionais do perfil do endpoint que controlam o comportamento de rádio. Estes campos estão disponíveis na Edição Enterprise:

| Campo         | Tipo     | Descrição                              |
| ------------- | -------- | -------------------------------------- |
| `dualChan`    | Booleano | Modo de canal duplo                    |
| `repetition`  | Booleano | Repetição de downlink                  |
| `wideCarrOff` | Booleano | Desvio de portadora ampla              |
| `longBlkDist` | Booleano | Distância interbloco longa do downlink |

Na Edição Community, estes campos usam valores predefinidos e são geridos automaticamente pelo KC-Core durante o processo de anexação.

### Falhas Comuns

| Sintoma                                  | Causa Provável                                                                           |
| ---------------------------------------- | ---------------------------------------------------------------------------------------- |
| erro "EUI inválido"                      | O EUI não tem exatamente 16 caracteres hexadecimais                                      |
| erro "Endpoint duplicado"                | Já existe um endpoint com este EUI                                                       |
| O endpoint permanece no estado registado | A estação base ainda não anexou este endpoint                                            |
| Os uplinks não aparecem                  | Incompatibilidade da chave de sessão de rede entre o hardware do endpoint e o KiloCenter |


---

# 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-center/kilo-mioty-service-center/onboarding/register-an-endpoint.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.