Configuração de uma função
Selecione o cartão de uma função e clique em Settings na respetiva barra de ferramentas, ou faça duplo clique no cabeçalho do cartão, para abrir a caixa de diálogo de configuração. Apply fecha a caixa de diálogo; as alterações chegam ao servidor com Save na tela.
- Name — dê às funções um nome pensado para o residente que as vai ler na aplicação («Aquecimento da sala», não «Termostato 3»). É o título da página da função na aplicação.
- Description — opcional, uma nota para o instalador seguinte. A aplicação apresenta-a num único sítio: por baixo do valor de uma função de valor calculado. Não há ícone para escolher.
- Enabled — uma função desativada mantém a cablagem mas não é executada. Uma função nova começa desligada.
- Sheet — onde está arquivada.
- Category e Room — escolher uma Category é o que publica a função nas aplicações (ver «Functions in the App»); a Room passa a ser aí um filtro. Deixe Internal — not in app nas funções auxiliares que os residentes não devem ver.
- Settings — as definições tipadas do bloco, com intervalos, passos, unidades e visibilidade condicional (as definições irrelevantes para as opções atuais ficam ocultas). Uma definição substituída por uma porta de entrada associada é mostrada desativada — o fio prevalece.
- Per-setting exposure — as definições elegíveis têm um interruptor App: ligado, os residentes podem alterar essa definição a partir da página da função na aplicação; desligado, fica reservada ao administrador. A lista de definições elegíveis é fixa para cada bloco: as definições de alarme de vento de um estore automático e a proteção contra gelo e calor de um termostato, por exemplo, nunca têm o interruptor.
- Exposing an input (App-set) — alguns valores que os residentes ajustam são entradas, não definições: a Setpoint de um termostato, por exemplo. Clique na entrada no cartão, abra o separador App-set da respetiva caixa de diálogo Bind, escreva o Starting value, ligue Let app users change it e clique em Make app-set. A função passa então a guardar o valor e a aplicação mostra um controlo para ele. Com o interruptor desligado, o valor é guardado pela função e não é oferecido na aplicação.
⚠️ Aviso: publicar uma função dá sempre aos residentes o interruptor Function active na página da função na aplicação. Eles podem desligar uma função publicada, independentemente do que exponha. Mantenha uma função interna se nunca puder ser parada.

Saídas
Clique numa porta de saída para configurar o destino do seu valor. A caixa de diálogo de saída tem três separadores — Devices, Actions e Make a widget — e uma saída sem nada em nenhum deles não está avariada: permanece interna e alimenta outras funções através de fios, que é o caso normal de um comparador.
Devices. Cada objeto de dispositivo de destino é escrito num de dois modos:
| Modo | O que faz |
|---|---|
| Command | Aciona o objeto — como se um utilizador operasse o widget. Use-o para comandar atuadores reais. |
| Set state | Define o estado do objeto sem comandar nada. Use-o para publicar uma leitura calculada — num objeto virtual, ou num objeto sem endereço próprio (os registos de energia de um contador apenas de potência, ver «Logic Block Reference»). |
O seletor só oferece os objetos em que a porta pode escrever (de tipo compatível e com escrita); os objetos de retorno apenas de leitura ficam ocultos e a caixa de diálogo indica quantos são. A maioria dos objetos só admite um modo, pelo que o modo é indicado em vez de perguntado; onde ambos servem, a escolha é sua.
Actions. Uma saída booleana também pode fazer algo além de escrever um valor — as mesmas coisas que o THEN de uma automatização pode fazer:
| Ação | Configuração |
|---|---|
| Trigger a scenario | O cenário — é executado exatamente como se fosse premido na aplicação. |
| Trigger an automation | A automatização — as suas próprias condições continuam a ser verificadas e as suas ações só são executadas se forem cumpridas. O texto do mosaico diz que as contorna; não contorna. Uma automatização desligada não é executada seja qual for o caminho (o seletor indica «— disabled»). |
| Global command | What (Lights in a room, Shutters in a room, Lights in a category, Shutters in a category), To (On, Off, Up, Down, Stop) e uma Room ou uma Category. |
| Send a notification | Title, Message, Recipients (deixe vazio para notificar todos). |
| Send an e-mail | Subject, Message, Recipients (deixe vazio para enviar e-mail a todos os utilizadores com endereço). Requer o serviço de e-mail (ver «Email Service»). |
Dois controlos transformam um valor num evento, e ambos contam:
- Trigger — When it turns on (predefinição), When it turns off ou Both ways. Uma ação ocorre numa transição da saída, nunca numa repetição da mesma: um Direct link no modo every telegram reescreve os seus destinos de dispositivo em cada telegrama, mas só dispara as suas ações quando o valor muda realmente. Este é o contrato valor versus evento: os destinos de dispositivo transportam um valor, as ações são eventos.
- Not again within — um tempo de bloqueio em segundos (60 por predefinição, mínimo 1). Os cenários e os comandos globais escrevem muitos objetos, e cada um deles regressa e reavalia as funções associadas; o tempo de bloqueio é o que impede que isso se torne um ciclo. Deixe-o generoso, salvo se tiver um motivo. Uma transição descartada pelo tempo de bloqueio fica registada como descartada, não é engolida em silêncio.
O separador Actions está disponível nas saídas booleanas e nas saídas «any type» (um Direct link) cujo fio transporta um booleano — o servidor verifica o que a porta transporta realmente e comunica qualquer incompatibilidade no painel de validação (ver «Logic Validation, Monitoring & Safety»). Um número não tem nada a disparar. As ações aparecem na tela como etiquetas na saída. No histórico de execução (History → All), uma ação disparada é uma linha marcada «action fired» com a respetiva hora, e uma descartada pelo tempo de bloqueio ou por um teste é marcada «action dropped»; a linha não dá mais nenhum detalhe. No caso de um e-mail, a linha é escrita antes de o serviço de e-mail ser verificado, por isso consulte também a caixa de correio.
No separador Actions, Add this action adiciona a ação que acabou de preencher; Done sozinho não guarda um rascunho que não tenha adicionado.
Make a widget. O terceiro separador cria um dispositivo real para o valor (materialização da saída):
- Verifique Widget name, Room e Category. Chegam preenchidos a partir da função; Room e Category estão vazios quando a função não os tem, e tem de os escolher.
- Para uma saída numérica, escolha a Presentation — Value (uma leitura simples) ou Trend (um mosaico que desenha o seu histórico). Uma saída verdadeiro/falso não tem Presentation.
- Clique em Create the widget. As alterações pendentes desta função são primeiro guardadas; depois o widget é criado e ligado à saída no modo Set state. A caixa de diálogo fecha quando o servidor responde; se o servidor recusar, o motivo é mostrado no formulário. Não precisa de Save depois.
O resultado é um widget virtual normal — uma Analog input para um número, uma Digital input para uma saída verdadeiro/falso. Pode ser colocado em vistas, ligado ao KNX por uma ponte (ver «KNX Bridge & Triggers») e registado no histórico (ver «Object Settings, Logging & Notifications»; o registo começa desligado — ligue-o na página Devices). A unidade e as casas decimais do bloco são copiadas. Não é definido nenhum intervalo, a menos que a saída declare um (uma Thermostat setpoint declara, uma Calculated value não): introduza um mínimo e um máximo na página Devices apenas se quiser que a barra de nível do mosaico se preencha. O widget sobrevive à função: eliminar a função mais tarde pergunta o que fazer com ele em vez de o remover em silêncio.
Exemplo: materialize uma Calculated value que soma três contadores como «Total consumption», categoria Energy. Aparece na aplicação como uma leitura, não como um contador, e o seu primeiro valor chega quando a saída mudar na vez seguinte.
