> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# KNX

> Integre sistemas de automação predial KNX ao Portal

# KNX

A integração KNX permite controlar dispositivos em redes **KNX/EIB**, o padrão europeu de automação predial amplamente utilizado em edifícios comerciais e residenciais de alto padrão.

## Pre-requisitos

* Gateway KNX (KNX/IP)
* Projeto ETS com enderecos de grupo configurados
* Rede acessivel ao Portal

## Configurar

<Steps>
  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → KNX**.
  </Step>

  <Step title="Configure o gateway">
    Insira o endereco IP do gateway KNX e as credenciais de acesso.
  </Step>

  <Step title="Configure dispositivos lógicos">
    Acesse a página de configuração KNX para criar **dispositivos lógicos** e mapear **enderecos de grupo**.
  </Step>
</Steps>

## Enderecos de Grupo

No KNX, os dispositivos se comunicam via **enderecos de grupo**. No Portal, você mapeia esses enderecos para entidades:

| Tipo               | Exemplo |
| ------------------ | ------- |
| Luz on/off         | 1/0/1   |
| Luz dimmer         | 1/0/2   |
| Cortina posição    | 2/0/1   |
| Sensor temperatura | 3/0/1   |

## Gerenciar Dispositivos KNX

Acesse **Configurações → Integrações → KNX → \[entrada]** para:

* Criar dispositivos lógicos
* Mapear enderecos de grupo para cada funcionalidade
* Configurar tipos de entidade (light, cover, sensor, etc.)

<Info>
  A integração KNX utiliza um worker dedicado para comunicação em tempo real com o gateway.
</Info>