Esquema ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Esta característica pertenece a los tipos de dispositivos de THERMOSTAT que admiten la configuración de la temperatura objetivo y el rango de temperatura.

Campos

Campo Descripción Tipo de datos
heatCelsius Temperatura objetivo en grados Celsius para los modos CALOR y CALOR/FRÍO del termostato. number
Ejemplo: 20.0
coolCelsius Temperatura objetivo en grados Celsius para los modos COOL y HEATCOOL del termostato. number
Ejemplo: 22.0

Ejemplo de solicitud y respuesta GET: HEAT

SolicitudRespuesta
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Ejemplo de solicitud y respuesta GET: COOL

SolicitudRespuesta
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Ejemplo de solicitud y respuesta GET: HEATCOOL

SolicitudRespuesta
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Comandos

El termostato debe estar en el modo que corresponde al comando al que se llama antes de cambiar los puntos de ajuste de 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, 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 de punto de ajuste solo toman grados Celsius como parámetro, aunque el Google Nest Thermostat puede mostrar la temperatura en grados Celsius o Fahrenheit.

SetHeat

Establece la temperatura objetivo cuando el termostato está en modo CALOR.

Solicitud y respuesta de SetHeat

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

{}

Campos de la solicitud de SetHeat

Campo Descripción Tipo de datos
heatCelsius Es la temperatura objetivo que se debe establecer cuando el termostato está en modo CALOR. number
Ejemplo: 22.0

SetCool

Establece la temperatura objetivo cuando el termostato está en modo FRÍO.

Solicitud y respuesta de SetCool

SolicitudRespuesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

{}

Campos de la solicitud de SetCool

Campo Descripción Tipo de datos
coolCelsius Es la temperatura objetivo que se debe establecer cuando el termostato está en modo FRÍO. number
Ejemplo: 20.0

SetRange

Establece las temperaturas mínima y máxima cuando el termostato está en el modo HEATCOOL.

Solicitud y respuesta de SetRange

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

{}

Campos de la solicitud SetRange

Campo Descripción Tipo de datos
heatCelsius Es la temperatura objetivo mínima que se debe establecer cuando el termostato está en el modo HEATCOOL. number
Ejemplo: 20.0
coolCelsius Es la temperatura final máxima que se debe establecer cuando el termostato está en el modo HEATCOOL. number
Ejemplo: 22.0

Errores

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

Mensaje de error RPC Solución de problemas
No se permite el comando en el modo actual del termostato. FAILED_PRECONDITION Algunos modelos de termostatos no admiten el cambio del modo Eco cuando el modo del termostato está desactivado, según el atributo ThermostatMode . El modo del termostato debe cambiarse a CALOR, FRÍO o CALOR/FRÍO antes de cambiar el modo Eco.
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 en tu comando.
No se permite el comando cuando el termostato está en el modo MANUAL_ECO. FAILED_PRECONDITION No se puede establecer el punto de ajuste de temperatura cuando el termostato está en el modo Eco manual.

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