#Liebherr

Liebherr 集成可让您通过云端 SmartDevice HomeAPI 控制和监控 Liebherr SmartDevice 冰箱和冷柜。借助此集成，您可以监控温度、调整制冷设置，并创建自动化，以便在温度超过食品安全储存阈值时收到提醒。

用例：监控食品储存温度、在超过阈值时发送提醒、优化能耗，并在您离家时自动调整制冷设置。

#支持的设备

此集成支持以下设备：

• 支持 Wi-Fi 连接的 Liebherr SmartDevice 冰箱和冷柜

#前提条件

在设置集成之前，您需要从 Liebherr SmartDevice 应用中获取 API key：

1. 连接设备：下载 SmartDevice 应用，并将您的 Liebherr 设备连接到家庭 Wi-Fi 网络。按照设置说明完成初始配置。

2. 获取 API key：

   • 打开 SmartDevice 应用
   • 前往 Settings
   • 选择 Become a beta tester
   • 启用 Beta testing HomeAPI
   • 选择 Generate new key
   • 复制 API key。该 API key 只能在应用中复制一次。

3. 验证连接状态：只有通过 SmartDevice 应用连接到互联网的设备，才能通过 HomeAPI 访问。仅注册但未实际联网的设备不会显示在 Home Assistant 中。

当您的设备位于同一网络中时，此集成可被自动发现。如果自动发现无效，您也可以手动添加该集成。

API key:
    description: "来自 Liebherr SmartDevice 应用的 API key（**Settings** > **Become a beta tester**）。注意：API key 只能在应用中复制一次。"

#支持的功能

Liebherr 集成为您的 SmartDevice 冰箱和冷柜分区提供温度监控与控制功能。

#数值实体

此集成会为每个冷却分区创建用于控制设定温度的 number 实体。

• Setpoint：冷却分区的目标温度。调整该值即可更改期望温度。

温度范围和单位取决于您设备的能力和设置。

对于具有多个冷却分区的设备（例如冷藏冷冻组合机型），每个分区都会创建独立的 number 实体：

• Top zone setpoint：最上层分区的目标温度
• Middle zone setpoint：中间分区的目标温度（如果存在）
• Bottom zone setpoint：最下层分区的目标温度（如果存在）

#传感器

此集成会为设备中的每个冷却分区创建温度传感器。

• Zone temperature：当前在冷却分区内部测得的温度。

对于具有多个冷却分区的设备（例如冷藏冷冻组合机型），每个分区都会创建独立的传感器：

• Top zone：最上层冷却分区
• Middle zone：中间分区（如果存在）
• Bottom zone：最下层冷却分区（如果存在）

#选择实体

此集成会为设备上的特殊功能创建 select 实体。根据设备型号和能力的不同，并非所有 select 都可用。对于具有多个冷却分区的设备，每个分区都会创建独立的 select 实体。

• IceMaker：控制自动制冰机。可选项为 Off、On 和 MaxIce（如果设备支持）。MaxIce 会临时提高制冰量，适合您需要更多冰块的场景。
• HydroBreeze：控制 HydroBreeze 喷雾系统，该系统会定期喷出细雾以保持果蔬新鲜。可选项为 Off、Low、Medium 和 High。
• BioFresh-Plus：控制 BioFresh-Plus 分区的温度设置。可选项表示两个 BioFresh-Plus 抽屉的温度组合（例如 0|0、0|-2、-2|-2、-2|0），可帮助您为不同类型的新鲜食材优化储存条件。

#开关

此集成会为设备上的特殊运行模式创建 switch 实体。根据设备型号和能力的不同，并非所有 switch 都可用。

#分区级开关

这些开关作用于单个冷却分区。对于具有多个分区的设备，每个分区都会创建独立的开关：

• SuperCool：可在最长 12 小时内将冷藏室温度快速降至 +2°C。适合快速冷却大量新放入的食物或饮料，防止内部温度升高并确保更佳保鲜效果。
• SuperFrost：可将冷冻室温度快速降至 -32°C (-26°F)，形成低温储备，以利于保留维生素的冷冻过程。冻结完成后，此功能会自动恢复为正常模式，最长不超过 65 小时，有助于节省电力。

#整机开关

这些开关作用于整台设备：

• PartyMode：一种持续 24 小时的便捷模式，通过最大化制冷性能，让设备为聚会场景做好准备。它会自动启用 SuperCool 来快速冰镇饮料，并启用 SuperFrost 来冷冻食物，同时在支持时提高制冰量。
• NightMode：通过关闭所有设备提示音、暂停 IceMaker，并将内部 LED 灯光调暗为柔和亮度，营造更安静的厨房环境。

#自动化

以下是一些您可以使用 Liebherr 集成创建的自动化示例。

#夜间模式计划

让您的 Liebherr 设备在睡觉时自动启用夜间模式，并在早晨自动关闭，以实现更安静的夜间运行。

alias: "Liebherr 夜间模式计划"
description: >-
  在睡觉时自动启用夜间模式，并在早晨关闭，以获得更安静的夜间运行体验。
triggers:
  - trigger: time
    at: "22:00:00"
    id: night_mode_on
  - trigger: time
    at: "07:00:00"
    id: night_mode_off
actions:
  - choose:
      - conditions:
          - condition: trigger
            id: night_mode_on
        sequence:
          - action: switch.turn_on
            target:
              entity_id: switch.my_fridge_night_mode
      - conditions:
          - condition: trigger
            id: night_mode_off
        sequence:
          - action: switch.turn_off
            target:
              entity_id: switch.my_fridge_night_mode
mode: single

#数据更新

Liebherr 集成会每 1 分钟从 SmartDevice HomeAPI 云服务中 polls 一次数据。

如果您有超过 2 台设备，建议增大轮询间隔，以避免触发 API 速率限制。

#已知限制

• 云依赖：该集成需要互联网连接才能与 Liebherr SmartDevice HomeAPI 云服务通信。如果您的网络中断，将无法通过 Home Assistant 控制设备。
• Beta API：SmartDevice HomeAPI 当前仍处于 beta 阶段。随着 Liebherr 持续开发该 API，功能和行为可能发生变化。
• API key 限制：API key 只能在 SmartDevice 应用中复制一次。如果丢失，您需要重新生成一个新的 key。
• 仅显示已连接设备：只有通过 Wi-Fi 主动连接到互联网的设备才会出现在 Home Assistant 中。已注册但已断开的设备无法访问。

#故障排除

#删除集成

此集成遵循标准集成删除流程，无需额外步骤。

#To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three-dot menu. Then, select Delete.

移除集成后，您的 API key 在 SmartDevice 应用中仍然保持有效。若要撤销访问权限，请在应用中生成新的 API key，这会使旧 key 失效。