Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Termostat

Sterowanie termostatem

Nest Learning Thermostat ™ to urządzenie połączone z Internetem, które jest intuicyjne i łatwe w użyciu, nieustannie ucząc się wzorców użytkowania w domu, aby zoptymalizować komfort i oszczędzać energię. Użytkownicy mogą sterować ogrzewaniem i chłodzeniem z każdego miejsca, w którym mają dostęp do internetu.

Obsługa tych funkcji wymaga wyrafinowanego systemu sterowania, który wykracza poza proste programy oparte na nastawach. Nest zapewnia szeroki zakres algorytmów (takich jak Early On , True Radiant , Airwave ™ ), które wymagają znacznej ilości mocy obliczeniowej w porównaniu do większości termostatów. Nest Thermostat ma moc potrzebną do zapewnienia tych zaawansowanych funkcji.

Nest API został zaprojektowany, aby umożliwić produktom sterowanie systemem HVAC bez zakłócania algorytmów Nest lub zaskakiwania użytkownika nieoczekiwanymi zachowaniami. Zapewniają dostęp do następujących danych dla termostatu Nest:

  • Nazwa struktury i „gdzie nazwa” urządzenia (lokalizacja w domu)
  • Niestandardowa etykieta termostatu
  • Stan online i informacje o ostatnim połączeniu
  • Aktualne i docelowe temperatury
  • Tryb temperatury
  • Temperatury ekologiczne
  • Czas do temperatury
  • Skala temperatury (zestaw F / C)
  • Status blokady temperatury , a jeśli jest zablokowana, wartości minimalnej / maksymalnej zablokowanej temperatury
  • Czas pracy wentylatora i tryb HVAC
  • Wilgotność
  • Krem z filtrem

Uprawnienia do termostatu

Aby uzyskać dostęp do odczytu wszystkich wartości danych API termostatu, wybierz dla klienta uprawnienie do odczytu termostatu .

Aby uzyskać dostęp do odczytu wszystkich wartości danych API termostatu i dodatkowy dostęp do zapisu wybranych wartości, wybierz dla klienta uprawnienie do odczytu / zapisu termostatu . Ten poziom uprawnień umożliwia aktualizację następujących elementów:

  • Temperatura docelowa
  • Tryb HVAC
  • Zegary wentylatorów

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

  • Skala temperatury
  • Etykieta termostatu

Identyfikatory termostatów

Urządzenie

Urządzenia Nest są wymienione według typu jako tablica identyfikatorów, których można użyć do jednoznacznej identyfikacji urządzenia za pomocą ścieżki urządzenia. Tak więc identyfikator termostatu "peyiJNo..." oznacza, że ​​można załadować model urządzenia termostatu na devices/thermostats/peyiJNo... przez API.

Gdy urządzenie jest podłączone do wielu produktów, 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.

Imię

Podano dwa atrybuty nazwy. Krótszy atrybut name jest wyświetlany w etykietach interfejsu użytkownika, natomiast name_long jest używany w długim tekście.

name

W tych przykładach name to „Przedpokój” lub „Przedpokój (Zachód)”.

ImięImię długie

name_long

W tym przykładzie name_long to „Office (Upstairs)”.

Imię długie w wiadomości

Etykieta

Gdzie nazwa (etykieta)
Gdzie nazwa (etykieta)

Począwszy od wersji uprawnień v5 , możesz dodać niestandardową etykietę termostatu za pośrednictwem interfejsu API. W aplikacji Nest etykieta pojawia się w nawiasach po nazwie miejsca.

Począwszy od wersji uprawnień v6 , możesz również przeczytać etykietę Termostat.

Gdzie

where_id

  • Unikalny, wygenerowany przez Nest identyfikator, który reprezentuje name
  • where_id jest tylko do odczytu i jest tworzony automatycznie w wywołaniu w celu utworzenia niestandardowej name gdzie

Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

where_name

Wybierając dowolne uprawnienia Termostatu , możesz uzyskać dostęp do urządzenia where_name z obiektu urządzenia ( devices/thermostats ).

Inne metadane

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

Wartość danych Opis
locale Język i kod kraju przypisany do tego urządzenia
software_version Ciąg, który reprezentuje oprogramowanie układowe aktualnie zainstalowane na urządzeniu
structure_id Ciąg, który w unikalny sposób reprezentuje tę strukturę; to jest struktura, z którą sparowane jest urządzenie
last_connection Sygnatura czasowa ostatniego udanego połączenia z usługą Nest
is_online Status aktywności. Jest to określane przez Nest przy użyciu czasu last_connection i oczekiwanego okna ponownego połączenia, które jest specyficzne dla urządzenia.

Funkcje termostatu

Tryby termostatu

Systemy HVAC mają cztery stany „włączone” ( heat , cool , heat-cool , eco ) i jeden stan „wyłączony” ( off ). Używamy tych stanów do zarządzania komfortem i oszczędnością energii poprzez wartości danych hvac_mode i temperatury.

  • Gdy wybrany jest tryb heat lub chłodzenia ( heat , cool ), termostat dostosowuje temperaturę w domu do docelowej temperatury.
  • Gdy wybrany jest tryb Ogrzewanie • Chłodzenie ( heat-cool ), termostat zapewni komfort w domu w preferowanym zakresie temperatur.
  • Gdy wybrane jest Temperatury ekologiczne (eko), termostat zastosuje algorytmy oszczędzania energii, aby utrzymać komfort w domu i zmniejszyć zużycie energii. Termostaty w tym trybie wyświetlają ECO.

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

Jak hvac_mode i wartości temperatury

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

Tryb HVAC Wartości danych temperatury, do których masz 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 dotyczące zmiany hvac_mode :

Scenariusz Czy można zmienić hvac_mode ?
Blokada temperatury jest włączona tak
Wyłączenie awaryjne jest aktywne Nie
Ogrzewanie awaryjne jest włączone Nie
can_cool lub can_heat to false Nie

Temperatury ekologiczne

Temperatury ekologiczne pozwalają użytkownikowi oszczędzać energię, niezależnie od tego, czy jest w domu, czy nie. Rozważ przełączenie hvac_mode na eco podczas wdrażania energooszczędnych zachowań w swoim produkcie.

Punkty końcowe Eco Temperature są dostępne w Nest API, począwszy od uprawnień Thermostat do odczytu i odczytu / zapisu v6.

Przełączanie między trybami eco i non-eco

Twój produkt nie powinien wymagać bezpośredniego zarządzania temperaturami docelowymi w trybie Eco. Gdy dom jest ustawiony na nieobecność, temperatura docelowa nie jest wyświetlana, ale jest ustawiana wewnętrznie na podstawie wyborów użytkownika. Gdy termostat jest wyłączony, nie obserwuje się temperatur docelowych.

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

  1. Zmień hvac_mode na dowolną inną wartość z wyjątkiem eco
  2. Zmodyfikuj odpowiednie wartości danych target_temperature

Począwszy od uprawnień do odczytu i odczytu / zapisu termostatu w wersji 6, można uzyskać dostęp do trybu previous_hvac_mode za pośrednictwem interfejsu API, aby pomóc w przechodzeniu do trybu HVAC. previous_hvac_mode służy do przechowywania hvac_mode urządzenia przed przejściem do hvac_mode „eco”.

Na przykład, jeśli termostat Nest korzysta z temperatur hvac_mode = "eco" ( hvac_mode = "eco" ), dostępny jest hvac_mode = "eco" previous_hvac_mode i chcesz, aby produkt ustawiał target_temperature , musisz najpierw:

  1. pobierz previous_hvac_mode
  2. ustaw hvac_mode na wartość previous_hvac_mode
  3. potwierdź, że hvac_mode nie jest już ustawiony na „eco”

Po tych krokach ustaw odpowiednio temperatury docelowe.

W zależności od wartości hvac_mode , w ten sposób zmienia się previous_hvac_mode :

Gdy stan hvac_mode to ... Wtedy 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 żądana, zwykle ustawiana przez użytkownika. Na nim opiera się większość działań i decyzji. Za pomocą 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 wybrany jest tryb Ogrzewanie lub Chłodzenie ( heat , cool ), target_temperature jest pojedyncza target_temperature
  • Gdy wybrany jest tryb Heat • Cool ( heat-cool ), target_temperature są dwie wartości target_temperature , oznaczające zakres docelowy, wyższy dla chłodzenia i niższy dla ogrzewania
  • Po wybraniu trybu Eco ( eco ) docelowy zakres temperatury jest ustawiany wewnętrznie

Istnieją również temperatury bezpieczeństwa, które stanowią zabezpieczenie przed zamarzaniem rur lub zbyt wysoką temperaturą w domu.

Gdy termostat jest wyłączony, temperatury docelowe nie są ustawione.

Czas do temperatury

Funkcja Time-to-Temperature zapewnia dostęp do następujących wartości danych dla systemu HVAC:

  • time_to_target - czas w minutach, w jakim konstrukcja osiągnie docelową temperaturę
  • time_to_target_training
    • Status szkolenia
    • Gdy termostat uczy się, jak reaguje system HVAC, dostosowuje oszacowanie w celu osiągnięcia temperatury docelowej
    • Gdy termostat ma wystarczającą pewność co do szacowanego czasu osiągnięcia docelowej temperatury, stan zmieni się z training na ready

Temperatura otoczenia

Temperatura mierzona w pobliżu termostatu. Wyświetla wartość, która odpowiada preferowanej przez użytkownika skali temperatury.

Skala temperatury

Zmienne temperatury otoczenia i temperatury docelowej są uporządkowane według skali Celsjusza lub Fahrenheita. Atrybut temperature_scale będzie miał wartość „F” lub „C”, w zależności od preferencji użytkownika. Ta właściwość jest ustawiana przez każdy termostat, więc jest możliwe, że w jednej konstrukcji użytkownik może mieć dwa termostaty, po jednym w każdej skali temperatur. Podczas wyświetlania wartości temperatury pamiętaj o preferencjach użytkownika .

Począwszy od wersji uprawnień v5 , można zmienić skalę temperatury za pomocą interfejsu 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ółdziała ze sobą, aby określić, co jest wyświetlane na wyświetlaczu termostatu Nest i jak się zachowuje.

  • Gdy hvac_mode jest ustawiony na heat-cool , termostat Nest wyświetla dolną i hvac_mode wartość zadaną oddzielone hvac_mode (•), w przeciwnym razie termostat Nest wyświetla tylko temperaturę docelową
  • Gdy hvac_mode jest off , na termostacie Nest wyświetla się słowo „OFF” w preferowanym języku użytkownika
  • Gdy hvac_mode jest ustawiony na eco , na termostacie Nest wyświetla się słowo „ECO” w preferowanym języku użytkownika

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

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

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

Temperatury Celsjusza są wyświetlane w postaci liczby całkowitej lub wartości dziesiętnej, przy czym ostatnia cyfra jest ustawiona na „.5”:

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

Liść

Kiedy ikona liścia jest wyświetlana z przodu termostatu, termostat jest ustawiony na energooszczędną temperaturę i has_leaf = true .

Liść

Blokada temperatury

Użytkownicy mogą zablokować termostat Nest, tak aby można go było regulować tylko w ograniczonym zakresie temperatur. Począwszy od wersji uprawnień v5 , możesz sprawdzić, czy blokada temperatury jest włączona, is_locked , a jeśli tak, odczytaj wartości min / max blokady temperatury za pomocą interfejsu API:

Temperatury blokady muszą być określone parami jako wartości maksymalne i minimalne i mogą być zapisane tylko wtedy, gdy is_locked = true .

Wilgotność

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

Krem z filtrem

Technologia Sunblock automatycznie dostosowuje temperaturę na termostacie Nest, aby skompensować skoki ciepła, które występują w wyniku bezpośredniego działania promieni słonecznych na urządzenie.

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

Wentylator

Wiele systemów HVAC ma zintegrowane wentylatory, co oznacza, że nie można nimi sterować niezależnie . W przypadku zintegrowanych wentylatorów nie ma trybu wyłączenia, ponieważ wentylator musi działać, gdy włączone jest ogrzewanie lub chłodzenie.

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

Jeśli wentylator może być sterowany niezależnie, parametr has_fan zostanie ustawiony na true , a następujące wartości danych można ustawić za pomocą uprawnień do odczytu / zapisu termostatu:

  • fan_timer_active - boolean, zwraca wartość true jeśli zegar wentylatora jest włączony przez zaprogramowany czas
  • fan_timer_duration - int, czas (w minutach), przez który wentylator ma pracować

Użyj tych wartości razem, aby zainicjować licznik czasu wentylatora (włączyć wentylator) na określony czas. Możesz również użyć wartości fan_timer_timeout aby określić sygnaturę czasową, kiedy wentylator ma się zatrzymać.

Zauważ, że zawsze możesz zmienić fan_timer_duration - jest to niezależne od hvac_mode lub stanu zajętości struktury (away).

Możesz spodziewać się tych odpowiedzi w przypadku sukcesu lub porażki:

  • 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).

Ograniczanie szybkości

Stosujemy ograniczanie szybkości w celu ochrony przed nadmiernymi połączeniami z urządzeniami, które mogą wpływać na wydajność systemu lub baterii. W normalnych warunkach urządzenia Nest ładują akumulator za pomocą przewodów niskiego napięcia w systemie ogrzewania i chłodzenia. Ale jeśli w krótkim czasie wykonasz nadmierne połączenia, a poziom naładowania baterii spadnie, termostat Nest wyłączy Wi-Fi, aby oszczędzać energię.

W praktyce oznacza to, że ograniczamy liczbę połączeń, które można wykonać na urządzenie 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 Limity szybkości transmisji danych .

Ograniczenia mocy

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

Dowiedz się więcej o niskim poziomie naładowania baterii w Nest Learning Thermostat .

Komunikaty o błędach

W niektórych stanach pewne funkcje są niedostępne. Zasady te mają na celu oszczędzanie energii lub zapewnienie komfortu i bezpieczeństwa.

Aby uzyskać informacje o tym, co oznaczają błędy wywołań interfejsu API i jak sobie z nimi radzić, zobacz 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świetlać interfejs użytkownika.