Termostato

Todos los modelos de Google Nest Thermostat son compatibles con la API de Smart Device Management (SDM). Estos dispositivos muestran el tipo de dispositivo THERMOSTAT:

sdm.devices.types.THERMOSTAT

Rasgo

Reference

Las siguientes características, comandos o eventos están relacionados con este grupo:

Rasgo	Descripción	Comandos
Conectividad	Esta característica pertenece a cualquier dispositivo que tenga información de conectividad.
Ventilador	Esta característica pertenece a cualquier dispositivo que tenga la capacidad del sistema para controlar el ventilador.	SetTimer
Humedad	Esta característica pertenece a cualquier dispositivo que tenga un sensor para medir la humedad.
Información	Esta característica pertenece a cualquier dispositivo para la información relacionada con el dispositivo.
Configuración	Esta característica pertenece a cualquier dispositivo para la información de configuración relacionada con el dispositivo.
Temperatura	Esta característica pertenece a cualquier dispositivo que tenga un sensor para medir la temperatura.
ThermostatEco	Esta característica pertenece a los tipos de dispositivos de TERMOSTATO que admiten los modos ECO.	SetMode
ThermostatHvac	Esta característica pertenece a los tipos de dispositivos de TERMOSTATO que pueden informar detalles de HVAC.
ThermostatMode	Esta característica pertenece a los tipos de dispositivos de TERMOSTATO que admiten diferentes modos de termostato.	SetMode
ThermostatTemperatureSetpoint	Esta característica pertenece a los tipos de dispositivos de TERMOSTATO que admiten la configuración de la temperatura final y el rango de temperatura.	SetHeat SetCool SetRange

JSON

La ausencia de una característica en una respuesta GET indica que la característica o característica no está disponible actualmente para el dispositivo. Consulta Tipos de dispositivos para obtener más información.

{
  "type" : "sdm.devices.types.THERMOSTAT",
  "traits" : {
    "sdm.devices.traits.Connectivity" : {
      "status" : "ONLINE"
    },
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    },
    "sdm.devices.traits.Humidity" : {
      "ambientHumidityPercent" : 35.0
    },
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    },
    "sdm.devices.traits.Settings" : {
      "temperatureScale" : "CELSIUS"
    },
    "sdm.devices.traits.Temperature" : {
      "ambientTemperatureCelsius" : 23.0
    },
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    },
    "sdm.devices.traits.ThermostatHvac" : {
      "status" : "HEATING"
    },
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    },
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Temperatura y humedad

Para leer la temperatura ambiente del termostato, usa la característicaTemperatura . La temperatura ambiente se mide en el dispositivo.

Para leer la humedad del ambiente del termostato, usa la característicaHumedad . La humedad del ambiente se mide en el dispositivo.

Escala de temperatura

El Google Nest Thermostat puede mostrar la temperatura en grados Celsius o Fahrenheit, pero la API de SDM no puede configurar la escala. Para determinar la escala de temperatura que establece el usuario actualmente, usa la característicaConfiguración .

Cambiar el modo

El modo del termostato se administra a través de dos características diferentes: ThermostatMode y ThermostatEco.

Modos estándar

Para cambiar el modo del termostato a CALOR, FRÍO o HEATCOOL, usa el comando SetMode de la característica ThermostatMode.

Este comando también se puede usar para desactivar el modo del termostato, no para activar el modo Eco.

Por ejemplo, para cambiar uno de los modos estándar del termostato, haz lo siguiente:

Solicitud

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

Respuesta

{}

Modo Eco

Para activar el modo Eco, usa MANUAL_ECO como modo con el comando SetMode de la característica ThermostatEco:

Solicitud

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

Respuesta

{}

Este comando afecta otras características, según el estado actual del modo Eco o los cambios en él:

• Si el modo Eco está DESACTIVADO, el termostato se establecerá de forma predeterminada en el último modo estándar (CALOR, Frío, HEATCOOL o APAGADO) que estaba activo.
• Si el modo Eco es MANUAL_ECO:
• Se rechazan los comandos correspondientes a la característica ThermostatTemperatureSetpoint .
• El atributo ThermostatTemperatureSetpoint muestra los puntos de ajuste de temperatura.

Algunos modelos de termostatos no admiten el cambio del modo Eco cuando el termostato está DESACTIVADO, según la característica ThermostatMode . El modo del termostato debe cambiarse a CALOR, FRÍO o HEATCOOL antes de cambiar el modo Eco.

Cómo cambiar los puntos de ajuste de la temperatura

Los puntos de ajuste de temperatura solo se pueden cambiar cuando el termostato está en los modos CALOR, Frío o HEATCOOL, y los puntos de ajuste permitidos corresponden al modo actual del termostato. Los puntos de ajuste de la temperatura no se pueden cambiar cuando el modo está OFF o cuando el modo Eco está configurado en MANUAL_ECO.

El termostato debe estar en el modo que corresponda al comando al que se llama antes de cambiar los puntos de ajuste de la temperatura. El comando y los campos para cambiar los puntos de ajuste varían según el modo del termostato.

Por ejemplo, para emitir el comando SetHeat, primero el termostato debe estar en modo CALOR:

Modo	Comando	Campos
CALOR	SetHeat	heatCelsius
FRÍO	SetCool	coolCelsius
HEATCOOL	SetRange	heatCelsius, coolCelsius

Ten en cuenta que los comandos del punto de ajuste solo toman grados Celsius como parámetro, aunque el Google Nest Thermostat puede mostrar la temperatura en grados Celsius o Fahrenheit.

Se rechazarán todos los comandos Set* si el termostato está en modo Eco. Consulta la característica ThermostatEco para obtener más información.

Por ejemplo, para cambiar el punto de ajuste de la temperatura cuando el termostato está en modo CALOR, usa el comando SetHeat de la característica ThermostatTemperatureSetpoint:

Solicitud

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Respuesta

{}

Puntos de ajuste del modo Eco

El usuario establece los puntos de ajuste heatCelsius y coolCelsius que muestra el trait ThermostatEco, y estos no se pueden cambiar mediante la API de SDM.

Cómo encender o apagar el ventilador

Si el termostato admite un ventilador, usa el comando SetTimer de la característica Ventilador para encenderlo o apagarlo. Cuando se enciende, puedes especificar el tiempo de funcionamiento del ventilador, en segundos.

Por ejemplo, para hacer funcionar el ventilador durante una hora, haz lo siguiente:

Solicitud

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

Respuesta

{}

Si se omite el campo duration, el ventilador funcionará durante un tiempo predeterminado de 15 minutos.

Si el comando para encender el ventilador no produce el resultado esperado, es posible que el ventilador ya esté activado (ya sea de forma manual, según un programa, o bien debido a un ciclo de HVAC). La API de SDM no puede anular algunos comportamientos de los ventiladores del Google Nest Thermostat.

Comprueba la conectividad del dispositivo

Si el dispositivo no responde a comandos ni envía eventos, o si recibes errores de la API relacionados con él, usa la característicaConectividad para verificar si el dispositivo tiene el estado SIN CONEXIÓN. Verifica la conexión a Internet del dispositivo y asegúrate de que el Servicio de Nest esté activo.

Si tienes eventos habilitados, también deberías haber recibido un evento de recurso que indique que el dispositivo se desconectó:

Carga útil

{
  "eventId" : "b7705246-9224-46af-b5f2-b2af8437cd0e",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "traits" : {
      "sdm.devices.traits.Connectivity" : {
        "status" : "OFFLINE"
      }
    }
  },
  "userId": "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Reacciona a eventos del dispositivo

Cualquier cambio en un campo de característica genera un evento. Por ejemplo, recibirías el siguiente evento resourceUpdate si el estado de HVAC del termostato cambiara a CALOR:

Carga útil

{
  "eventId" : "849df9a2-9a28-452e-9b34-5490fc93d88b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "traits" : {
      "sdm.devices.traits.ThermostatHvac" : {
        "status" : "HEATING"
      }
    }
  },
  "userId": "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Los eventos se activan para todas las características asociadas a este tipo de dispositivo. Habilita los eventos si necesitas reaccionar a ellos de alguna manera como parte de una integración.

Horario de los eventos

Ten en cuenta que un evento para un cambio en el estado de HVAC no se puede entregar al mismo tiempo que los eventos para un cambio de modo del termostato.

Por ejemplo, a veces hay una demora en el inicio del modo de calefacción o enfriamiento de un termostato para proteger el sistema de HVAC. En este caso, cambiar el modo del termostato solo puede enviar en un principio eventos ThermostatMode y ThermostatTemperatureSetpoint . Si no hubo retrasos en la activación del sistema de HVAC, se enviarían los tres eventos al mismo tiempo.

Errores

Es posible que se muestren los siguientes códigos de error en relación con este dispositivo:

Mensaje de error	RPC	Solución de problemas
El valor de enfriamiento debe ser mayor que el valor de calor.	INVALID_ARGUMENT	Asegúrate de que el campo heatCelsius sea menor que el campo coolCelsius de tu comando.
Comando no permitido en el modo de termostato actual.	FAILED_PRECONDITION	Algunos modelos de termostatos no admiten el cambio del modo Eco cuando el termostato está DESACTIVADO, según la característica ThermostatMode . El modo del termostato debe cambiarse a CALOR, FRÍO o HEATCOOL antes de cambiar el modo Eco.
Ventilador del termostato no disponible.	FAILED_PRECONDITION	El termostato no admite ventiladores. No se pueden usar características ni comandos relacionados con los fans en este dispositivo.
Comando no permitido cuando el termostato está en modo MANUAL_ECO.	FAILED_PRECONDITION	No se puede establecer el punto de ajuste de temperatura cuando el termostato está en modo Eco manual.

Consulta la referencia de códigos de error de la API para ver la lista completa.