Viessmann Vicare
这Vicare
集成使您可以控制维斯曼通过Viessmann Vicare(REST)API的设备。应支持最新的与网络连接的Viessmann加热设备(例如,燃气锅炉)。
目前,家庭助理中的以下设备类型支持:必威是什么
配置
可以通过使用此my按钮将Viessmann Vicar必威体育存款e添加到您必威是什么的家庭助理实例中:
Viessmann Vicare可以由家庭助理自动发现。必威是什么如果发现实例,它将显示为“发现”,您可以选择立即设置它。
放用户名
和密码
给您的Viessmann开发人员门户网站登录凭据。所需的客户ID可以如下获取:
- 注册并登录Viessmann开发人员门户网站。
- 在菜单中导航到API键。
- 使用以下数据创建新的OAuth客户端:
名称:Pyvicare Google Recaptcha:残疾人重定向uris:vicare:// oauth-callback/everest
这加热_TYPE
可以汽车
自动找到最适合您的设备的类型或一种气体
,,,,油
,,,,颗粒
,,,,热泵
,,,,燃料电池
,,,,杂交种
。
可以根据安装的燃烧器和/或电路的数量生成多个设备实例。如果有一个以上的实例,则所有设备都带有电路或燃烧器ID的后缀。
Viessmann API限制
Viessmann API是限制的。如果您超过以下限制之一,则将禁止使用24小时:
- 限制1:120个时间窗口10分钟的电话
- 限制2:1450的时间窗口24小时
默认值scan_interval
60秒将在这些限制内工作。但是请注意,通过集成设置温度,但通过与Vicare App进行交互也可以计入这些限制,请注意API的任何其他请求,例如,通过设置温度。因此,建议将scan_interval调整为使用情况。
气候
有关当前温度属性的注释:带有室温的Viessmann设备将通过Current_temperature
。所有其他设备将显示加热电路的当前电源温度。
支持服务气候
以下服务气候组件由Vicare整合提供:set_temperature
,,,,set_hvac_mode
,,,,set_preset_mode
服务set_temperature
将目标温度设置为给定温度。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 字符串或字符串列表ENTITY_ID 要控制的气候设备。要针对所有实体,请使用全部 关键字而不是entity_id。 |
温度 |
不 | 所需的目标温度 |
注意set_temperature
将始终影响当前的正常温度,或者,如果设定预设的预设温度(即,诸如ECO或舒适度之类的Viessman程序)。
服务climate.set_hvac_mode
为气候设备设置HVAC模式。支持以下模式:
这气候.Vicare_heating
组件具有以下HVAC模式到Viessmann操作模式的映射:
HVAC模式 | Viessmann模式 | 描述 |
---|---|---|
离开 |
被迫 |
永久将加热设置为降温。注意:这也将停用家用热水 |
热 |
原始正态 |
永久将加热设置为正常温度。 |
汽车 |
dhwandheating |
在设备中编程的加热时间表中,在降低和正常温度之间的切换 |
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 字符串或字符串列表ENTITY_ID 要控制的气候设备。要针对所有实体,请使用全部 关键字而不是entity_id。 |
HVAC_MODE |
不 | HVAC模式的新值 |
服务climate.set_vicare_mode
设置Viessmann定义的气候设备的模式(请参阅set_hvac_mode用于映射家庭助理气候模式。必威是什么这允许对加热模式进行更细节的控制。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 字符串或字符串列表ENTITY_ID 要控制的气候设备。要针对所有实体,请使用全部 关键字而不是entity_id。 |
vicare_mode |
不 | Vicare模式的新价值。对于支持的值,请参阅vicare_modes 气候实体的属性。 |
服务set_preset_mode
设置预设模式。支持的预设模式是生态和舒适。这些与各自的Viessmann程序相同,并且仅暂时活跃8小时。生态模式将目标温度降低3°C,而舒适模式将目标温度设置为可配置的值。请咨询您的加热设备手册以获取更多信息。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 字符串或字符串列表ENTITY_ID 要控制的气候设备。要针对所有实体,请使用全部 关键字而不是entity_id。 |
PRESET_MODE |
不 | 预设模式的新值。 |
热水器
由于这将与加热部件的操作模式相抵触,因此无法通过热水器组件打开/关闭水加热。因此,该组件的操作模式仅作为属性可用,无法修改。
支持服务Water_heater.vicare_water
以下服务热水器组件由Vicare整合提供:set_temperature
服务set_temperature
将家用热水的目标温度设置为给定温度。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 字符串或字符串列表ENTITY_ID 要控制的气候设备。 |
温度 |
不 | 热水器的新目标温度 |
传感器
来自Vicare的其他数据可作为单独的传感器获得。传感器是根据可用API数据点自动发现的。
按钮
按钮实体可用于触发热水器的一次性充电。