Schema del set di temperatura del termostato

Termostato Nest 

sdm.devices.traits.ThermostatTemperatureSetpoint

Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura ottimale.

Campi

Campo Descrizione Tipo di dati
heatCelsius Temperatura ottimale in gradi Celsius per le modalità HEAT e HEATCOOL del termostato. number
Esempio: 20,0
coolCelsius Temperatura ottimale in gradi Celsius per le modalità COOL e HEATCOOL del termostato. number
Esempio: 22,0

Esempio di richiesta e risposta GET - 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,
    }
  }
}

Esempio di richiesta e risposta GET - 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
    }
  }
}

Esempio di richiesta e risposta GET - 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 della modifica i set-point di temperatura. Il comando e i campi per modificare i set-point variano in base al termostato .

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

Modalità Comando Campo/i
RISCALDAMENTO SetHeat heatCelsius
RAFFR. SetCool coolCelsius
RAFFR. SetRange heatCelsius, coolCelsius

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

SetHeat

Imposta la temperatura ottimale 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 di 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 ottimale quando il termostato è in modalità RAFFR.

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 di richiesta SetCool

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

SetRange

Imposta la temperatura minima e massima quando il termostato è in modalità HEATCOOL.

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 ottimale minima da impostare quando il termostato è in modalità HEATCOOL. number
Esempio: 20,0
coolCelsius La temperatura ottimale massima da impostare quando il termostato è in modalità HEATCOOL. number
Esempio: 22,0

Errori

Potrebbero essere restituiti i seguenti codici di errore in relazione a questo tratto:

Messaggio di errore RPC Risoluzione dei problemi
Comando non consentito nell'attuale modalità del termostato. FAILED_PRECONDITION Alcuni modelli di termostato non supportano il cambio della modalità Eco quando questa è disattivata, in base alla modalità ThermostatMode . Prima di cambiare la modalità Eco, è necessario passare alla modalità Caldo, Freddo o HEATCOOL.
Il valore del raffreddamento deve essere maggiore del valore del riscaldamento. INVALID_ARGUMENT Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius del comando.
Comando non consentito quando il termostato è in modalità MANUAL_ECO. FAILED_PRECONDITION Non è possibile impostare il set-point di temperatura quando il termostato è in modalità Eco manuale.

Consulta la documentazione sul codice di errore API per l'elenco completo dei codici di errore dell'API.