Fotocélula A1

Estado

O estado é um documento JSON que armazena as configurações atuais do dispositivo. Ele pode ser aplicado e consultado através da API — consulte a seção Estado do guia de API.

A fotocélula possui em seu estado as seguintes propriedades:

Propriedade	Tipo	Manipulável	Descrição
connected	Booleano	Não	Se o dispositivo está conectado à AWS. Apenas a AWS deve definir.
manualMode	Booleano	Sim	Permite que a lâmpada seja controlada manualmente. Útil para demonstração.
lightOn	Booleano	Sim, se manualMode: true.	Se a lâmpada está acesa. Caso contrário, apenas o firmware atualiza esta propriedade.
defaultBrightness	Numérico (0-100)	Sim	Porcentagem da intensidade padrão de brilho da lâmpada.
commandTriggers	Lista de Comando	Sim	Agendamentos que alteram um recurso quando o gatilho é satisfeito.

Cada item de gatilho de comando (commandTriggers) possui:

Propriedade	Tipo	Descrição
resource	Recurso de Comando	Recurso a ser controlado
trigger	Gatilho	Condição a qual o recurso será alterado. Ver tabela abaixo.
value	Numérico	Valor aplicado ao recurso.

O gatilho (trigger) define quando o valor será aplicado.

Propriedade	Tipo	Descrição
type	String	Tipo do gatilho. Para agendamento por horário use cron.
stringValue	String	Para type: "cron", a expressão cron em 6 colunas (segundo, minuto, hora, dia do mês, mês, dia da semana). Ver guia sobre expressões cron.

Recursos controláveis

A fotocélula possui apenas um recurso que pode ser controlado via estado até o momento.

Recurso	Tipo	Descrição
brightness	Numérico (0-100)	Intensidade luminosa que o dimerizador deve aplicar à lâmpada.

Exemplo de estado

{
  "connected": true,
  "manualMode": false,
  "lightOn": true,
  "defaultBrightness": 80,
  "commandTriggers": [
    {
      "resource": "brightness",
      "trigger": {
        "type": "cron",
        "stringValue": "0 30 1 * * *"
      },
      "value": 50
    },
    {
      "resource": "brightness",
      "trigger": {
        "type": "cron",
        "stringValue": "0 0 7 * * *"
      },
      "value": 40
    }
  ]
}

Para gatilhos do tipo cron, leia o guia sobre expressões cron.

Alertas

Descrição	alertId
Luminária acesa fora do horário de operação	1
Luminária apagada durante o horário de operação	2
Luminária piscando	3
Queda de potência	4
Subtensão	5
Sobretensão	6
Queda de energia	7

Comandos

Os comandos da fotocélula executam ações que podem ser irreversíveis. Recomendamos a implementação apenas para uso interno da sua equipe técnica.

Comandos executam ações remotas no dispositivo. O envio é feito pela API — consulte a seção Comando do guia de API. O payload é um JSON com resource_id conforme definido no repositório de protobuf da TechFab.

Reiniciar fotocélula

Reinicia o dispositivo.

{
  "resource_id": 10
}

Restaurar de fábrica

Restaura as configurações de fábrica do dispositivo. O dispositivo reiniciará em seguida.

{
  "resource_id": 1
}