Google致力于提高黑人社区的种族平等。 怎么看。
此页面由 Cloud Translation API 翻译。
Switch to English

温控器

温控器控制

Nest Learning Thermostat™是一种互联网连接的设备,直观易用,可不断学习家庭使用方式,以优化舒适度并节省能源。用户可以在任何可以访问Internet连接的地方控制其加热和冷却。

要支持这些功能,就需要一个复杂的控制系统,该系统必须超越简单的基于设定点的程序。 Nest提供了多种算法(例如Early OnTrue RadiantAirwave™ ),与大多数恒温器相比,它们需要大量的计算能力。 Nest Thermostat具有提供这些高级功能所需的功能。

Nest API旨在允许产品控制HVAC系统,而不会中断Nest算法或使用户感到意外行为。他们可以访问Nest Thermostat的以下数据:

  • 结构名称和设备“位置名称”(家庭中的位置)
  • 自定义恒温器标签
  • 联机状态和上次连接信息
  • 当前温度和目标温度
  • 温度模式
  • 生态温度
  • 到达温度
  • 温度标度(设定F / C)
  • 温度锁定状态,如果锁定,则显示最小/最大锁定温度值
  • 风扇计时器持续时间和HVAC模式
  • 湿度
  • 防晒霜

温控器权限

要对所有恒温器API数据值进行读取访问, 为您的客户端选择恒温器读取权限。

要对所有恒温器API数据值进行读取访问,并对选择值进行其他写入访问, 为客户端选择恒温器读/写权限。此权限级别使您可以更新以下内容:

  • 目标温度
  • 暖通空调模式
  • 风扇计时器

从恒温器读/写v5开始,您还可以更新以下内容:

  • 温标
  • 温控器标签

恒温器标识符

设备

嵌套设备按类型列出为ID数组,可用于通过设备路径唯一标识设备。因此,恒温器ID为"peyiJNo..."意味着您可以通过API在devices/thermostats/peyiJNo...加载恒温器设备模型。

当设备连接到多个产品时,每个开发人员将看到该设备的不同ID。对于已安装来自同一开发人员的多个产品的设备,开发人员将看到相同的ID。

名称

提供了两个名称属性。较短的name属性显示在用户界面标签中,而name_long用于长格式文本。

name

在这些示例中, name为“走廊”或“走廊(西)”。

名称名字长

name_long

在此示例中, name_long是“办公室(楼上)”。

在消息中长名称

标签

姓名(标签)
姓名(标签)

权限版本v5开始,您可以通过API添加自定义恒温器标签。在Nest应用中,标签会在where名称后的括号中显示。

权限版本v6开始,您还可以阅读恒温器标签。

哪里

where_id

  • 由Nest生成的唯一标识符,代表name
  • where_id是只读的,并且会在调用中自动创建以创建自定义where name

详细了解Nest ThermostatsNest ProtectsNest Cams的名称

where_name

选择任何恒温器权限时 ,可以从设备对象( devices/thermostats )访问设备where_name

其他元数据

除非另有说明,否则所有数据值都是只读的。

资料值描述
locale 分配给此设备的语言和国家/地区代码
software_version 代表设备当前安装的固件的字符串
structure_id 一个唯一表示此结构的字符串;这是设备与之配对的结构
last_connection 上次成功连接Nest服务的时间戳
is_online 联机状态。这是由Nest使用last_connection时间和特定于设备的预期重新连接窗口确定的。

温控器功能

温控器模式

HVAC系统具有四个“打开”状态( heatcoolheat-cooleco )和一个“关闭”状态( off )。我们使用这些状态通过hvac_mode和温度数据值来管理舒适度和节能。

  • 选择“加热”或“冷却”模式(“ heat ,“ cool )时,恒温器会将房屋调节到目标温度。
  • 选择“加热• heat-cool模式(“ heat-cool )时,温控器将在理想的温度范围内保持居家舒适。
  • 选择“ 环保温度” (eco Temperatures )时,恒温器将应用节能算法,以保持房屋舒适并减少能源消耗。在此模式下的恒温器显示ECO。

结构具有与状态相关的两个状态:“归属”或“离开”。当房屋中没有感觉到运动时,结构将从“家”变为“家”,并且家中的恒温器将自动启用“环保温度”。

hvac_mode和温度值如何一起工作

根据hvac_mode的值,只能在API中访问某些温度数据值:

暖通空调模式您可以访问的温度数据值
heat还是cool target_temperature_ftarget_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
要么
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
要么
eco_temperature_low_ceco_temperature_high_c
off 没有

在某些情况下,围绕更改hvac_mode有一些特殊规则:

情境可以更改hvac_mode吗?
温度锁定已启用
紧急关闭处于活动状态没有
启用紧急加热 没有
can_coolcan_heat值为false 没有

生态温度

生态温度可让用户节省能源,无论他们是否在家。在产品中实现节能行为时,请考虑将hvac_mode切换为eco

在Nest API中,可从恒温器读取权限和读取/写入v6权限开始使用Eco Temperature端点

在环保和非环保模式之间切换

您的产品无需在Eco模式下直接管理目标温度。当房屋设置为离开时,基于用户选择,不显示目标温度,而是在内部设定目标温度。当恒温器设置为OFF时,则不会观察到目标温度。

如果绝对必须直接更改目标温度,请确保在两个单独的调用中进行更改:

  1. hvac_mode更改为eco以外的任何其他值
  2. 修改适当的target_temperature数据值

从恒温器读取和读取/写入v6权限开始,您可以通过API来访问previous_hvac_mode ,以协助进行HVAC模式转换。 previous_hvac_mode用于在过渡到“ eco”之前存储设备的hvac_mode

例如,如果Nest Thermostat使用的是环保温度( hvac_mode = "eco" ),则previous_hvac_mode可用,并且您希望产品设置target_temperature ,则必须首先:

  1. 获取previous_hvac_mode
  2. hvac_mode设置为previous_hvac_mode
  3. 确认hvac_mode不再设置为“ eco”

完成这些步骤后,适当设置目标温度。

根据hvac_mode值,这是previous_hvac_mode变化方式:

hvac_mode状态为... 然后, previous_hvac_mode可以是...
eco heatcoolheat-cooloff
heatcoolheat-cooloff 空白/空

目标温度

目标温度是HVAC系统最重要的值-这是所需的温度,通常由用户设置。大多数行动和决定都基于此。通过API,与Nest产品一起使用可以将目标温度写入更大的过程中。

打开系统电源时,始终会设置目标温度。

  • 当加热或冷却模式( heatcool被选择),一个单一的target_temperature是集
  • 当热•冷模式( heat-cool被选择),两个target_temperature值被设定,表示目标范围,一个更高的用于冷却和加热一个较低
  • 选择Eco模式( eco )时,在内部设置目标温度范围

还有一些安全温度可作为后盾,以防止管道冻结或房屋内温度过高。

当恒温器关闭时,不会设置目标温度。

到达温度

温度变化使您可以访问HVAC系统的以下数据值:

  • time_to_target结构达到目标温度time_to_target的时间(以分钟为单位)
  • time_to_target_training
    • 培训状况
    • 当恒温器了解HVAC系统的响应方式时,它会调整估算值以达到目标温度
    • 当恒温器有足够的把握确保达到目标温度所需的时间时,状态会从training变为ready

环境温度

在恒温器附近测得的温度。显示与用户首选的温度标度相对应的值。

温标

环境温度和目标温度变量按摄氏度或华氏度来组织。根据用户的喜好, temperature_scale属性将为“ F”或“ C”。此属性由每个恒温器设置,因此,在单个结构中,用户可能有两个恒温器​​,每个温度范围一个。在显示温度值时,请记住用户的偏好

权限版本v5开始,您可以通过API更改温度范围。

目标温度和环境温度字段具有_f_c变体,以适应显示温度时的一致舍入。

温度显示

温控器

显示目标温度信息时,请考虑以下三个相关值: temperature_scalehvac_mode和结构的away状态。

许多数据值可以共同确定Nest Thermostat显示屏上显示的内容以及其行为。

  • 如果将hvac_mode设置为heat-cool ,则Nest Thermostat会显示上下限设定值,并以项目符号(•)分隔,否则Nest Thermostat只会显示目标温度
  • hvac_mode设置为off ,Nest Thermostat上将以用户首选的语言显示“ OFF”字样
  • hvac_mode设置为eco ,Nest Thermostat上将以用户首选的语言显示“ ECO”字样

显示温度格式还取决于所选的温度标度(F / C)。

华氏温度以整数形式显示:

  • 目标温度:55°F
  • 环境温度:62°F

摄氏温度显示为整数或十进制值,最后一位设置为“ .5”:

  • 目标温度:12°C
  • 环境温度:16.5°C

当叶子图标显示在恒温器的正面时,恒温器将设置为节能温度,并且has_leaf = true

叶

温度锁

用户可以锁定Nest Thermostat,以便只能在有限的温度范围内对其进行调节。从权限版本v5开始,您可以通过检查is_locked来查看是否启用了温度锁定 ,如果已启用,则可以通过API读取温度锁定的最小值/最大值:

锁温度必须成对地指定为最大值和最小值,并且只有在is_locked = true才能写入。

湿度

在设备上测量的以百分比(%)格式表示的湿度四舍五入到最接近的5%。

防晒霜

Sunblock技术会自动调节Nest Thermostat上的温度,以补偿由于阳光直射在设备上而产生的热量峰值。

这些数据值将告诉您是否启用了Sunblock和/或正在主动校正温度。

风扇

许多HVAC系统都集成了风扇,这意味着无法独立控制风扇 。集成风扇没有关闭模式,因为在加热或冷却打开时风扇需要运行。

但是,如果HVAC系统兼容,则可以通过API明确打开风扇,以使乘员更舒适,而无需使用整个HVAC系统。

如果可以独立控制风扇,则has_fan将设置为true ,并可以通过恒温器读/写权限设置以下数据值:

  • fan_timer_active布尔值,如果使用了风扇定时器达预编程的持续时间,则返回true
  • fan_timer_duration -int,风扇设置为运行的时间长度(以分钟为单位)

将这些值一起使用可启动风扇计时器(打开风扇)达特定时间。您还可以使用fan_timer_timeout值来确定将风扇设置为停止运行的时间戳。

请注意,您始终可以更改fan_timer_duration它与hvac_mode或结构占用状态(离开)无关。

您可以期望这些响应成功或失败:

  • 200 OK
  • 400错误的要求

如果打开风扇的命令未产生预期的结果,则可能是因为风扇已被使用(用户手动或按计划进行,或者是由于HVAC的加热/冷却循环)。

限速

我们应用速率限制来防止过度呼叫设备,这可能会影响系统或电池性能。在正常情况下,Nest设备会通过加热和冷却系统上的低压电线为电池充电。但是,如果在短时间内拨打过多电话且电池电量不足,则Nest Thermostat会关闭Wi-Fi以节省电量。

实际上,这意味着我们限制了在定义的时间段内可以拨打设备的电话数量。如果超过此限制,您将收到错误响应和一条消息,指出您已超过限制。

有关更多信息,请参见数据速率限制

功率限制

在某些情况下,恒温器可能没有足够的电池电量来满足修改请求。在这种情况下,您将收到错误响应和一条消息,指示设备此时无法处理请求。如果发生这种情况,请在再次尝试之前给电池充电一段时间。

在Nest Learning Thermostat中了解有关电池电量不足的更多信息。

错误讯息

有些状态使某些功能不可用。这些规则是为了节约能源或提供舒适性和安全性而制定的。

有关什么是API调用错误的含义以及如何处理错误的信息 ,请参见错误消息

WLAN /连接问题

如果设备离线,则不允许进行修改。您可以在数据模型中观察设备的在线状态,并适当显示UI。