Schema ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Questo attributo appartiene ai tipi di dispositivi THERMOSTAT che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura.

Campi

Campo Descrizione Tipo di dati
heatCelsius Temperatura target in gradi Celsius per le modalità CALDO e CALDO/FREDDO del termostato. number
Esempio: 20,0
coolCelsius Temperatura ottimale in gradi Celsius per le modalità FREDDO e CALDO/FREDDO del termostato. number
Esempio: 22,0

Richiesta e risposta GET di esempio - HEAT

Richiesta

GET /enterprises/project-id/devices/device-id

Risposta

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

Richiesta e risposta GET di esempio - COOL

Richiesta

GET /enterprises/project-id/devices/device-id

Risposta

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

Richiesta e risposta GET di esempio - HEATCOOL

Richiesta

GET /enterprises/project-id/devices/device-id

Risposta

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

Comandi

Il termostato deve essere nella modalità corrispondente al comando chiamato prima di modificare i setpoint di temperatura. Il comando e i campi per modificare i set-point variano in base alla modalità del termostato.

Ad esempio, per emettere il comando SetHeat, il termostato deve prima essere in modalità Caldo:

Modalità Comando Campo/i
RISCALDAMENTO SetHeat heatCelsius
FREDDO SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Tieni presente che i comandi del set-point accettano come parametro solo gradi Celsius, anche se Google Nest Thermostat può visualizzare la temperatura in gradi Celsius o Fahrenheit.

SetHeat

Imposta la temperatura target quando il termostato è in modalità CALDO.

Richiesta e risposta SetHeat

Richiesta

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

Risposta

{}

Campi della richiesta SetHeat

Campo Descrizione Tipo di dati
heatCelsius La temperatura ottimale da impostare quando il termostato è in modalità CALDO. number
Esempio: 22,0

SetCool

Imposta la temperatura target quando il termostato è in modalità FREDDO.

Richiesta e risposta SetCool

Richiesta

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

Risposta

{}

Campi della richiesta SetCool

Campo Descrizione Tipo di dati
coolCelsius La temperatura ottimale da impostare quando il termostato è in modalità FREDDO. number
Esempio: 20,0

SetRange

Imposta le temperature minima e massima quando il termostato è in modalità CALDO/FRIO.

Richiesta e risposta SetRange

Richiesta

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

Risposta

{}

Campi di richiesta SetRange

Campo Descrizione Tipo di dati
heatCelsius La temperatura minima target da impostare quando il termostato è in modalità CALDO/FREDDO. number
Esempio: 20,0
coolCelsius La temperatura massima da impostare quando il termostato è in modalità CALDO/FREDDO. number
Esempio: 22,0

Errori

In relazione a questo attributo, potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore RPC Risoluzione dei problemi
Comando non consentito nella modalità attuale del termostato. FAILED_PRECONDITION Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità del termostato è OFF, in base al tratto ThermostatMode . La modalità del termostato deve essere impostata su CALDO, FREDDO o CALDO/FREDDO prima di modificare la modalità Eco.
Il valore freddo deve essere maggiore del valore caldo. INVALID_ARGUMENT Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius nel comando.
Comando non consentito quando il termostato è in modalità MANUAL_ECO. FAILED_PRECONDITION Il set-point temperatura non può essere impostato quando il termostato è in modalità Eco manuale.

Consulta il riferimento ai codici di errore dell'API per un elenco completo dei codici di errore dell'API.