Cluster TIME

Al igual que ocurría en el caso de la ubicación, la hora es una información de gran importancia.  En numerosas ocasiones, es necesario que, cada dispositivo sea capaz de gestionar esta información de modo autónomo:

  1. Escenarios en los que un dispositivo monitoriza parámetros o eventos en determinados momentos,  acumula la información, y realiza una notificación diferida de los mismos. En estas situaciones puede ser necesario que el dispositivo, conserve un timestamp.
  2. Acciones temporizadas, periódicas o necesidades similares pueden requerir un conocimiento de la hora, sin que interese hacer uso de los canales de comunicación.

Numerosos comandos o eventos, incluirán el timeStamp, como una marca para referenciar el momento temporal en el que tienen lugar. Salvo indicación contraria el timeStamp contendrá 5 bytes: MM-Mes, dd-Dia, hh:hora, mm:Minuto, ss:segundo.

Los comandos básicos de este cluster son:

  • GET_TIME – 0x00. (OBL)
    • Descripción: Solicita la fecha y hora del dispositivo.
    • Parámetros: Ninguno.
    • Respuesta: TIME_VALUE, DEV_ERROR.
  • SET_TIME – 0x01. (OBL)
    • Descripción: Define la fecha y hora del dispositivo.
    • Parámetros: 7 bytes.
      • timeValue: 7 bytes.  aa:año, MM:mes, dd:dia, hh:hora, mm:minuto, ss:segundo, dow: dia de la semana 0 a 6 equivale Lunes a Domingo
    • Respuesta: DEV_ACK, DEV_ERROR.
  •  GET_ALARM – 0x02.(HW)
    • Descripción: Solicita una alarma en el dispositivo.
    • Parámetros: 1 byte. Número de alarma sobre la que se solicita información.
      • timeAlarmNum: 1 byte.
      • 0xFF Solicita todas las alarmas.
    • Respuesta: TIME_ALARM, DEV_ERROR
  •  SET_ALARM – 0x03.(HW)
    • Descripción: Define una alarma en el dispositivo.
    • Parámetros: Payload: 10 Bytes. Caracteriza hora y parámetros de la alarma.
      • timeAlarmNum: 1 byte.
      • timeAlarmStatus: 1 byte. Estado de la alarma según la tabla  TIME _ALARM_STATUS_TABLE.
      • timeAlarmValue: 7 byte. aa MM dd hh mm ss

Byte enmascarado con 0xFF no busca coincidencia. Ej: 0xFF 0xFF 0xFF 0xFF 0x00 0x0A 0x00 genera alarma a las 0:05:00 1:05:00 2:05:00…23:05:00

      • timeAlarmBehaviour: 1 byte
    • Respuesta: DEV_ACK, DEV_ERROR.

 

Los eventos generados por este cluster son:

  •  TIME_VALUE – 0x00 (OBL)
    • Descripción: El dispositivo informa de la fecha y hora del sistema.
    • Parámetros: 7 bytes.
      • timeValue: 7 bytes.  aa:año, MM:mes, dd:dia, hh:hora, mm:minuto, ss:segundo, dow: dia de la semana 0 a 6 equivale Lunes a Domingo
  •  TIME_ALARM – 0x01 (HW)
    • Descripción: El dispositivo informa sobre una de sus alarmas configuradas.
    • Parámetros: Payload: 10 Bytes. Caracteriza hora y parámetros de la alarma.
      • timeAlarmNum: 1 byte.
      • timeAlarmStatus: 1 byte. Estado de la alarma según la tabla  TIME _ALARM_STATUS_TABLE.
      • timeValue: 7 byte. aa MM dd hh mm ss

Byte enmascarado con 0xFF no busca coincidencia. Ej: 0xFF 0xFF 0xFF 0xFF 0x00 0x0A 0x00 genera alarma a las 0:05:00 1:05:00 2:05:00…23:05:00

      • timeAlarmBehaviour: 1 byte