Termostato

Tutti i modelli di Google Nest Thermostat sono supportati nell'API Smart Device Management (SDM). Questi dispositivi restituiscono il tipo di dispositivo TERMOSTATO:

sdm.devices.types.THERMOSTAT

Tratti

{
  "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 e umidità

Per leggere la temperatura ambiente del termostato, utilizza l'attributo Temperatura . La temperatura ambiente viene misurata sul dispositivo.

Per leggere l'umidità ambientale del termostato, utilizza il tratto Umidità . L'umidità ambientale viene misurata sul dispositivo.

Scala di temperatura

Il termostato Google Nest può visualizzare la temperatura in gradi Celsius o Fahrenheit, ma la scala non può essere impostata dall'API SDM. Per determinare la scala di temperatura attualmente impostata dall'utente, utilizza il trattoSettings .

Cambiare la modalità

La modalità del termostato è gestita da due tratti diversi: ThermostatMode e ThermostatEco.

Modalità standard

Per impostare la modalità del termostato su HEAT, COOL o HEATCOOL, utilizza il comando SetMode del tratto ThermostatMode.

Ad esempio, per modificare una delle modalità standard del termostato:

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

{}

Modalità Eco

Per attivare la modalità Eco, utilizza MANUAL_ECO come modalità con il comando SetMode del tratto ThermostatEco:

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

{}

Questo comando influisce su altre caratteristiche in base allo stato attuale o alle modifiche apportate alla modalità Eco:

• Se la modalità Eco è disattivata, la modalità del termostato verrà impostata per impostazione predefinita sull'ultima modalità standard (CALDO, FREDDO, CALDO • FREDDO o SPENTO) attiva.
• Se la modalità Eco è MANUAL_ECO:
• I comandi per la caratteristica ThermostatTemperatureSetpoint vengono rifiutati.
• I setpoint di temperatura non vengono restituiti dalla caratteristica ThermostatTemperatureSetpoint .

Modificare i setpoint di temperatura

I set-point di temperatura possono essere modificati solo quando il termostato è in modalità CALDO, FREDDO o CALDO • FREDDO e i set-point consentiti corrispondono alla modalità attuale del termostato. I setpoint di temperatura non possono essere modificati quando la modalità è OFF o quando la modalità Eco è impostata su MANUAL_ECO.

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à RISCALDAMENTO:

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.

Ad esempio, per modificare il set-point di temperatura quando il termostato è in modalità HEAT, utilizza il comando SetHeat del tratto ThermostatTemperatureSetpoint:

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

{}

Setpoint della modalità Eco

I setpoint heatCelsius e coolCelsius restituiti dalla caratteristica ThermostatEco sono impostati dall'utente e non possono essere modificati tramite l'API SDM.

Attivare o disattivare la ventola

Se il termostato supporta una ventola, utilizza il comando SetTimer del tratto Ventola per attivarla o disattivarla. Quando la attivi, puoi specificare la durata di funzionamento della ventola in secondi.

Ad esempio, per far funzionare la ventola per un'ora:

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

{}

Se il campo duration viene omesso, la ventola funzionerà per un periodo di tempo predefinito di 15 minuti.

Controllare la connettività del dispositivo

Se il dispositivo non risponde ai comandi o non invia eventi oppure ricevi errori dall'API relativi al dispositivo, utilizza il tratto Connettività per controllare la connettività del dispositivo per uno stato OFFLINE. Controlla la connessione a internet del dispositivo e assicurati che il servizio Nest sia attivo.

Se hai attivato gli eventi, dovresti aver ricevuto anche un evento risorsa che indica che il dispositivo è offline:

{
  "eventId" : "6ac04910-dab8-40c0-8d16-63645e9b801c",
  "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"
  ]
}

Reagire agli eventi del dispositivo

Qualsiasi modifica a un campo caratteristica genera un evento. Ad esempio, riceveresti il seguente evento resourceUpdate se lo stato dell'impianto HVAC del termostato è cambiato in HEATING:

{
  "eventId" : "1dc5ae6d-7334-4a71-8bb1-3e50d452a322",
  "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"
  ]
}

Gli eventi vengono attivati per tutte le caratteristiche associate a questo tipo di dispositivo. Attiva gli eventi se devi reagire in qualche modo nell'ambito di un'integrazione.

Sincronizzazione degli eventi

Tieni presente che un evento per una modifica dello stato dell'impianto HVAC potrebbe non essere inviato contemporaneamente agli eventi per una modifica della modalità del termostato.

Ad esempio, a volte si verifica un ritardo nell'avvio della modalità di riscaldamento o raffreddamento di un termostato per proteggere l'impianto HVAC. In questo scenario, la modifica della modalità del termostato potrebbe inizialmente inviare eventi solo per le modifiche delle caratteristiche ThermostatMode e ThermostatTemperatureSetpoint , mentre la modifica della caratteristica ThermostatHvac viene inviata in un secondo momento come evento separato una volta che l'impianto si accende. Se non ci fosse stato alcun ritardo nell'accensione dell'impianto di climatizzazione, tutti e tre gli eventi sarebbero stati inviati contemporaneamente.

Errori

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

Per l'elenco completo dei codici di errore dell'API, consulta il riferimento ai codici di errore dell'API.