Schema ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

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

Campi

Campo Descrizione Tipo di dati
heatCelsius Temperatura target in gradi Celsius per le modalità RISCALDAMENTO e RISCALDAMENTO/RAFFREDDAMENTO del termostato. number
Esempio: 20.0
coolCelsius Temperatura target in gradi Celsius per le modalità FREDDO e CALDO/FREDDO del termostato. number
Esempio: 22.0

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

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

Ad esempio, per eseguire il comando SetHeat, il termostato deve essere prima in modalità HEAT:

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

Tieni presente che i comandi di setpoint accettano solo gradi Celsius come parametro, 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

{}

Imposta i campi della richiesta SetHeat

Campo Descrizione Tipo di dati
heatCelsius La temperatura target da impostare quando il termostato è in modalità RISCALDAMENTO. 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 target da impostare quando il termostato è in modalità FREDDO. number
Esempio: 20.0

SetRange

Imposta le temperature minima e massima quando il termostato è in modalità Riscaldamento e raffreddamento.

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 della richiesta SetRange

Campo Descrizione Tipo di dati
heatCelsius La temperatura target minima da impostare quando il termostato è in modalità CALDO • FREDDO. number
Esempio: 20.0
coolCelsius La temperatura target massima da impostare quando il termostato è in modalità CALDO • FREDDO. number
Esempio: 22.0

Errori

Per questo attributo potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore RPC Risoluzione dei problemi
Il comando non è consentito nella modalità termostato attuale. FAILED_PRECONDITION Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità termostato è OFF, in base all'attributo ThermostatMode . Prima di modificare la modalità Eco, la modalità del termostato deve essere impostata su HEAT, COOL o HEATCOOL.
Il valore di raffreddamento deve essere maggiore del valore di riscaldamento. INVALID_ARGUMENT Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius nel comando.
Il comando non è consentito quando il termostato è in modalità MANUAL_ECO. FAILED_PRECONDITION Il setpoint di temperatura non può essere impostato quando il termostato è in modalità Eco manuale.

Consulta i riferimenti ai codici di errore dell'API per l'elenco completo dei codici di errore dell'API.