Google is committed to advancing racial equity for Black communities. See how.

Termostat

Sterowanie termostatem

Nest Learning Termostat ™ to urządzenie podłączone do Internetu, który jest intuicyjny i łatwy w użyciu, stale poznawania wzorców użycia w domu dla wygody zoptymalizować i oszczędzać energię. Użytkownicy mogą sterować ogrzewaniem i chłodzeniem z dowolnego miejsca, w którym mają dostęp do połączenia internetowego.

Obsługa tych funkcji wymaga zaawansowanego systemu sterowania, który wykracza poza proste programy oparte na wartości zadanej. Gniazdo zapewnia szeroki zakres algorytmów (jak na początku , Prawdziwego Radiant , Airwave ™ ), które wymagają znacznej ilości mocy obliczeniowej w porównaniu do większości termostatów. Nest Thermostat ma moc niezbędną do zapewnienia tych zaawansowanych funkcji.

Gniazdo API jest zaprojektowany tak, aby produkty do sterowania systemem HVAC bez zakłócania algorytmów gniazdo lub zaskakujące użytkownikowi nieoczekiwane zachowanie. Zapewniają dostęp do następujących danych dla termostatu Nest:

  • Nazwa struktury i nazwa urządzenia „gdzie” (lokalizacja w domu)
  • Niestandardowa etykieta termostatu
  • Status online i informacje o ostatnim połączeniu
  • Temperatury aktualne i docelowe
  • Tryb temperatury
  • Temperatury ekologiczne
  • Czas do temperatury
  • Skala temperatury (ustaw F/C)
  • Blokada temperatura stanu, a jeżeli zablokowany, osiągających minimalnej / maksymalnej wartości temperatury zamknięte
  • Czas pracy wentylatora i tryb HVAC
  • Wilgotność
  • Krem do opalania

Uprawnienia termostatu

Do odczytu do wszystkich wartości danych API termostatu wybierz termostat czytać zgody na kliencie.

Do odczytu do wszystkich wartości danych API termostatem i dodatkowym zapisem, aby wybrać wartości, wybierz Termostat odczytu / zapisu zgodę na kliencie. Ten poziom uprawnień umożliwia aktualizację następujących elementów:

  • Temperatura docelowa
  • Tryb HVAC
  • Liczniki wentylatora

Począwszy od odczytu/zapisu termostatu w wersji 5, możesz również zaktualizować następujące elementy:

  • Skala temperatury
  • Etykieta termostatu

Identyfikatory termostatu

Urządzenie

Urządzenia zagnieżdżone są wymienione według typu jako tablica identyfikatorów, których można użyć do jednoznacznej identyfikacji urządzenia na ścieżce urządzenia. Więc ID Termostat "peyiJNo..." oznacza, że można załadować termostatu model urządzenia w devices/thermostats/peyiJNo... za pośrednictwem interfejsu API.

Gdy urządzenie jest połączone z wieloma produktami, każdy programista zobaczy inny identyfikator tego urządzenia. W przypadku urządzenia, na którym zainstalowano wiele produktów tego samego programisty, programista zobaczy ten sam identyfikator.

Nazwa

Dostępne są dwa atrybuty nazwy. Im krótsza name atrybutu jest wyświetlane w etykietach interfejs użytkownika, podczas name_long jest stosowany w dłuższej formie tekstowej.

name

W tych przykładach, name jest „korytarz” lub „Przedpokój (West)”.

NazwaImię długie

name_long

W tym przykładzie, name_long jest "Office (na górze)".

Imię długie w wiadomości

Etykieta

Gdzie nazwa (etykieta)
Gdzie nazwa (etykieta)

Począwszy od wersji v5 uprawnienia , możesz dodawać niestandardowe etykiety termostatu poprzez API. W aplikacji Nest etykieta jest wyświetlana w nawiasach po nazwie gdzie.

Począwszy od wersji v6 uprawnienia , można również zapoznać się z ulotką termostat.

Gdzie

where_id

  • Wyjątkowy, Gniazdo wygenerowany identyfikator, który reprezentuje name
  • where_id , jest tylko do odczytu i jest tworzony automatycznie w zaproszeniu do tworzenia niestandardowych ustawień, gdzie name

Dowiedz się więcej o tym, gdzie nazwy Termostaty Nest ,Gniazdo Chroni i Nest kamery internetowe .

where_name

Po wybraniu dowolnej z uprawnieniami termostatem , można uzyskać dostęp do urządzenia where_name od obiektu urządzenia ( devices/thermostats ).

Inne metadane

Wszystkie wartości danych są tylko do odczytu, chyba że określono inaczej.

Wartość danych Opis
locale Kod języka i kraju przypisany do tego urządzenia
software_version Ciąg reprezentujący oprogramowanie układowe aktualnie zainstalowane na urządzeniu
structure_id Ciąg, który jednoznacznie reprezentuje tę strukturę; jest to struktura, z którą urządzenie jest sparowane
last_connection Znacznik czasu ostatniego udanego połączenia z usługą Nest
is_online Status aktywności. To zależy od gniazdem używając last_connection czas i oczekiwanego okna ponownego zwarcia, który jest specyficzny dla urządzenia.

Funkcje termostatu

Tryby termostatu

Systemy HVAC posiada cztery „na” państw ( heat , cool , heat-cool , eco ) i jeden „off” stanu ( off ). Używamy tych stanów zarządzać komfort i oszczędność energii dzięki hvac_mode wartości danych i temperatury.

  • Gdy ciepło lub trybie chłodzenia ( heat , cool wybrano) termostatu dostosowuje domowego do temperatury docelowej.
  • Gdy trybie chłodzenia • ciepła ( heat-cool jest zaznaczone), termostat utrzymania domu wygodne, w korzystnym zakresie temperatury.
  • Kiedy Eco Temperatury (ECO) jest wybrany, termostat zastosować algorytmy oszczędzania energii, aby utrzymać dom, wygodne i zmniejszyć zużycie energii. Termostaty w tym trybie wyświetlają ECO.

Struktury mają dwa stany związane z obecnością: W domu lub Poza domem. Gdy w domu nie zostanie wykryty ruch, struktura zmieni się z Dom na Poza domem, a termostaty w domu automatycznie włączą Temperatury Eco.

Jak hvac_mode i temperatury wartości współpracować

W zależności od wartości hvac_mode tylko niektóre wartości danych temperatury mogą być dostępne w API:

Tryb HVAC Wartości danych temperatury, do których można uzyskać dostęp
heat lub cool target_temperature_f lub target_temperature_c
heat-cool target_temperature_low_f i target_temperature_high_f
lub
target_temperature_low_c i target_temperature_high_c
eco eco_temperature_low_f i eco_temperature_high_f
lub
eco_temperature_low_c i eco_temperature_high_c
off Żaden

W niektórych scenariuszach, istnieją specjalne zasady wokół zmieniającym hvac_mode :

Scenariusz Można hvac_mode być zmienione?
Blokada temperatury jest włączona tak
Awaryjne odcinający jest aktywny Nie
Awaryjne ciepła jest włączona Nie
can_cool lub can_heat wartość jest false Nie

Temperatury ekologiczne

Temperatury ekologiczne pozwalają użytkownikowi oszczędzać energię, niezależnie od tego, czy jest w domu, czy nie. Rozważmy przełączania hvac_mode do eco przy wdrażaniu zachowań energooszczędnych w produkcie.

Eco punkty końcowe temperatury są dostępne w API gniazdem począwszy termostat czytać i odczytu / zapisu uprawnienia V6.

Przełączanie między trybami eko i nie-eko

Twój produkt nie powinien bezpośrednio zarządzać docelowymi temperaturami w trybie Eco. Gdy dom jest ustawiony jako poza domem, temperatura docelowa nie jest wyświetlana, ale jest ustawiana wewnętrznie, na podstawie wyboru użytkownika. Gdy termostat jest ustawiony na OFF, nie obserwuje się żadnych temperatur docelowych.

Jeśli koniecznie musisz zmienić temperaturę docelową bezpośrednio, pamiętaj, aby dokonać zmiany w dwóch osobnych wywołaniach:

  1. Zmień hvac_mode do dowolnej innej wartości niż eco
  2. Zmodyfikować odpowiednie target_temperature wartości danych

Począwszy termostat czytać i odczytu / zapisu v6 uprawnienia, można uzyskać dostęp previous_hvac_mode za pośrednictwem interfejsu API do pomocy HVAC przejścia trybu. previous_hvac_mode służy do przechowywania hvac_mode urządzenia przed przejściem na „eko”.

Na przykład, jeśli gniazdo termostatu jest stosowanie ekologicznych temperaturach ( hvac_mode = "eco" ), previous_hvac_mode jest dostępna i chcesz swój produkt do zadanej target_temperature , wówczas należy najpierw:

  1. get previous_hvac_mode
  2. zestaw hvac_mode do previous_hvac_mode wartości
  3. Potwierdź hvac_mode nie jest ustawiony na „eko”

Po wykonaniu tych czynności ustaw odpowiednie temperatury docelowe.

W zależności od hvac_mode wartości, to jak previous_hvac_mode zmienia:

Kiedy hvac_mode stan jest ... Następnie previous_hvac_mode może być ...
eco heat , cool , heat-cool lub off
heat , cool , heat-cool lub off puste/puste

Temperatura docelowa

Temperatura docelowa jest najważniejszą wartością dla systemu HVAC - jest to temperatura zadana, zwykle ustawiana przez użytkownika. Na tym opiera się większość działań i decyzji. Z interfejsu API produkty Works with Nest mogą zapisywać temperaturę docelową w ramach większego procesu.

Gdy system jest włączony, zawsze jest ustawiona temperatura docelowa.

  • Gdy ciepło lub trybie chłodzenia ( heat , cool jest wybrana), jeden target_temperature jest zestaw
  • Gdy ciepło • trybie chłodzenia ( heat-cool wybrano), dwa target_temperature ustawiane są oznaczając szereg tarczy, wyższy do chłodzenia i ogrzewania dolna
  • Kiedy tryb ekonomiczny ( eco jest zaznaczone), zakres temperatury docelowej wewnętrznie ustawione

Istnieją również temperatury bezpieczeństwa, które są zabezpieczeniem przed zamarzaniem rur lub zbyt wysokimi temperaturami w domu.

Gdy termostat jest wyłączony, nie są ustawiane żadne temperatury docelowe.

Czas do temperatury

Czas do temperatury daje dostęp do tych wartości danych dla systemu HVAC:

  • time_to_target - czas w minutach, który potrwa do konstrukcji do osiągnięcia temperatury docelowej
  • time_to_target_training
    • Status szkolenia
    • Gdy termostat uczy się, jak reaguje system HVAC, dostosowuje oszacowanie, aby osiągnąć temperaturę docelową
    • Gdy termostat jest dość pewny oszacowanie czasu, aby osiągnąć docelową temperaturę, status zmieni się z training na ready

Temperatura otoczenia

Temperatura mierzona w pobliżu termostatu. Wyświetl wartość odpowiadającą preferowanej przez użytkownika skali temperatury.

Skala temperatury

Zmienne temperatury otoczenia i temperatury docelowej są uporządkowane według skali Celsjusza lub Fahrenheita. temperature_scale atrybut będzie albo „F” lub „C”, w zależności od preferencji użytkownika. Ta właściwość jest ustawiana przez każdy termostat, więc możliwe jest, że w jednej strukturze użytkownik może mieć dwa termostaty, po jednym w każdej skali temperatury. Zachować preferencje użytkownika w umyśle podczas wyświetlania wartości temperatury.

Począwszy od wersji v5 uprawnienia , można zmienić skalę temperatury poprzez API.

Docelowe i temperatury otoczenia pola mają _f i _c warianty pomieścić spójnego zaokrąglania podczas wyświetlania temperatury.

Wyświetlacz temperatury

Termostat

Podczas wyświetlania informacji temperatury docelowej, należy rozważyć te trzy wartości zależne: temperature_scale , hvac_mode , a struktura jest away stan.

Wiele wartości danych współpracuje ze sobą, aby określić, co jest wyświetlane na wyświetlaczu Nest Thermostat i jak się zachowuje.

  • Gdy hvac_mode jest ustawiony heat-cool , gnieździe termostatu wyświetla niskie i wysokie wartości zadane oddzielone postaci kuli (•), poza wyświetlaczy Gniazdo Termostat tylko temperatura docelowa
  • Kiedy hvac_mode jest ustawiony na off , słowo „OFF” jest wyświetlany na gniazdo termostatu w preferowanym języku użytkownika
  • Kiedy hvac_mode jest ustawiony na eco , słowo „ECO” jest wyświetlany na gniazdo termostatu w preferowanym języku użytkownika

Format wyświetlanej temperatury zależy również od wybranej skali temperatury (F/C).

Temperatury w stopniach Fahrenheita są wyświetlane jako liczby całkowite:

  • Temperatura docelowa: 55 ° F
  • Temperatura otoczenia: 62 ° F

Temperatury Celsjusza są wyświetlane jako liczba całkowita lub wartość dziesiętna, z ostatnią cyfrą ustawioną na „.5”:

  • Temperatura docelowa: 12°C
  • Temperatura otoczenia: 16,5°C

Liść

Gdy ikona jest wyświetlana na liście z przodu termostatu, termostat jest ustawiony na temperaturę energooszczędnym i has_leaf = true .

Liść

Blokada temperatury

Użytkownicy mogą zablokować termostat Nest, aby można go było regulować tylko w ograniczonym zakresie temperatur. Począwszy od wersji v5 uprawnienia , można sprawdzić, czy blokada temperatury jest włączona sprawdzając is_locked , a jeżeli tak, to czytaj Blokada temperatury min / max wartości poprzez API:

Temperatury lock musi być podana w parach, jako wartości maksymalnych i minimalnych, a mogą być zapisywane tylko wtedy is_locked = true .

Wilgotność

Wilgotność, w procentach (%), mierzona na urządzeniu, zaokrąglona do najbliższych 5%.

Krem do opalania

Filtrami technologia automatycznie dostosowuje temperaturę na gniazdo termostatu do skompensowania kolcami ciepła, które występują przed bezpośrednim działaniem promieni słonecznych na urządzeniu.

Te wartości danych poinformują Cię, czy Sunblock jest włączony i/lub aktywnie koryguje temperaturę.

Wentylator

Wiele systemów HVAC zostały zintegrowane wentylatory, co oznacza, że wentylator nie może być sterowane niezależnie . Nie ma trybu wyłączenia dla zintegrowanych wentylatorów, ponieważ wentylator musi działać, gdy włączone jest ogrzewanie lub chłodzenie.

Jeśli jednak system HVAC jest kompatybilny, wentylator można włączyć bezpośrednio za pośrednictwem interfejsu API, aby zapewnić mieszkańcom większy komfort, bez angażowania pełnego systemu HVAC.

Jeżeli wentylator może być sterowane niezależnie, has_fan zostanie ustawiona na true , a następujące wartości danych mogą być ustawione z termostatem uprawnienia do odczytu / zapisu:

  • fan_timer_active - logiczna, zwraca true jeśli zegar jest włączony wentylator na zaprogramowany czas
  • fan_timer_duration - Int długość czasu (w minutach), że wentylator ma działać

Użyj tych wartości razem, aby zainicjować timer wentylatora (włączyć wentylator) na określony czas. Można również użyć fan_timer_timeout wartość, aby określić znacznik czasu, kiedy wentylator jest ustawiony wstrzymane.

Pamiętaj, że zawsze możesz zmienić fan_timer_duration - jest niezależna od hvac_mode lub stanu zajętości struktura (na wyjeździe).

Możesz spodziewać się tych odpowiedzi w przypadku powodzenia lub niepowodzenia:

  • 200 OK
  • 400 złych żądań

Jeśli polecenie włączenia wentylatora nie przyniesie oczekiwanego rezultatu, może to być spowodowane tym, że wentylator jest już włączony (ręcznie przez użytkownika, zgodnie z harmonogramem lub z powodu cyklu ogrzewania/chłodzenia HVAC).

Ograniczenie szybkości

Stosujemy ograniczenie szybkości, aby chronić przed nadmiernymi połączeniami z urządzeniami, które mogą mieć wpływ na wydajność systemu lub baterii. W normalnych warunkach urządzenia Nest ładują baterię z przewodów niskiego napięcia w układzie ogrzewania i chłodzenia. Ale jeśli w krótkim czasie wykonywane są nadmierne połączenia, a poziom baterii spadnie, Nest Thermostat wyłączy Wi-Fi, aby oszczędzać energię.

W praktyce oznacza to, że ograniczamy liczbę połączeń, które można wykonać do urządzenia w określonym czasie. Jeśli przekroczysz ten limit, otrzymasz odpowiedź o błędzie i komunikat informujący o przekroczeniu limitu.

Aby uzyskać więcej informacji, zobacz Data Rate Limits .

Ograniczenia mocy

W niektórych przypadkach bateria termostatu może nie mieć wystarczającej mocy baterii, aby obsłużyć żądanie modyfikacji. W takim przypadku otrzymasz odpowiedź o błędzie i komunikat wskazujący, że urządzenie nie może w tej chwili obsłużyć żądania. Jeśli tak się stanie, daj akumulatorowi trochę czasu na naładowanie przed ponowną próbą.

Dowiedz się więcej o warunkach słabego akumulatora w gnieździe Learning termostatu .

Komunikaty o błędach

Niektóre stany powodują, że niektóre funkcje są niedostępne. Zasady te mają na celu oszczędzanie energii lub zapewnienie komfortu i bezpieczeństwa.

Aby uzyskać informacje o tym, co znaczy błędy wywołania API i jak sobie z nimi radzić, patrz Komunikaty o błędach .

Problem z Wi-Fi / połączeniem

Jeśli urządzenie jest w trybie offline, modyfikacje nie są dozwolone. Możesz obserwować stan online urządzenia w modelu danych i odpowiednio wyświetlić interfejs użytkownika.