1. 先搞清楚“接入”到底能做什么如果你手上有一个酷态科10号Ultra移动电源并且家里在用Home Assistant或苹果的HomeKit那这篇文章就是为你准备的。核心就一件事把这个移动电源变成一个能被智能家居系统管理的“智能设备”。这听起来有点抽象具体能干嘛最直接的价值是你可以在手机App、平板或者Siri语音里实时看到这个移动电源的剩余电量、充电状态甚至远程控制它的输出开关。比如你可以设置一个自动化当移动电源电量低于20%时自动打开墙上的插座给它充电或者晚上睡觉后自动关闭它的所有输出省电又安全。很多人看到“教程”会以为要拆机、焊线或者刷固件其实完全不用。酷态科10号Ultra本身通过蓝牙与手机App通信我们要做的就是利用Home Assistant这个“万能中转站”把蓝牙数据“翻译”成Home Assistant和HomeKit能理解的格式。整个过程不需要任何硬件改造核心工具就是运行Home Assistant的设备比如树莓派、旧电脑、NAS和几个官方或社区提供的集成Integration。所以这篇文章适合两类人一是已经搭建了Home Assistant想把手头设备都接进去的玩家二是对智能家居感兴趣想从酷态科10号Ultra这个具体设备开始实践的新手。最关键的步骤其实就三步确认环境、安装集成、配置实体。下面我会按实际操作的顺序一步步拆解。2. 动手前的环境与条件自查在开始点击任何按钮之前先花五分钟确认下面这几件事。很多问题都卡在第一步不是因为教程复杂而是前置条件没满足。2.1 核心硬件你的酷态科10号Ultra和Home Assistant主机首先确保你的酷态科10号Ultra在蓝牙可被发现的状态。通常短按一下电源键让电量指示灯亮起即可。它不需要一直保持输出状态。其次也是最重要的你必须有一个正在运行的Home Assistant简称HA实例。HA是一个开源的家庭自动化平台它需要安装在一台24小时运行的设备上。常见的选择有树莓派最经典的选择功耗低。旧笔记本电脑或迷你主机性能更强。NAS如群晖、威联通通过Docker或虚拟机安装。官方Home Assistant Yellow/Green等设备。如果你还没有安装HA需要先完成这一步。这不是本文的重点但你可以去Home Assistant官网查找安装指南。请确保你的HA版本是比较新的如2024.x版本以保证更好的兼容性。2.2 网络与距离蓝牙通信的关键HA主机需要能“听到”移动电源的蓝牙信号。这意味着距离要足够近建议在初次配置时将酷态科10号Ultra放在距离HA主机比如树莓派3米以内中间不要有厚实的墙体阻隔。HA主机需要有蓝牙适配器大部分树莓派板载了蓝牙。如果你的HA安装在X86电脑或虚拟机里可能需要额外购买一个USB蓝牙适配器建议选择支持蓝牙4.0以上的。2.3 软件准备Home Assistant的账户与插件管理权限登录你的Home Assistant前端界面。你需要一个具有管理员权限的账户。确保HA系统已经安装了“File editor”或“Samba share”这类可以编辑配置文件的插件方便高级配置非必须但推荐。知道如何安装“HACS”Home Assistant Community Store。HACS是社区商店很多第三方集成都在这里。虽然本教程用的核心集成可能来自官方库但HACS是智能家居玩家的必备工具建议提前安装好。检查完以上三点你的“战场”就准备好了。如果HA还没装先去装HA如果没蓝牙先去买适配器。别急着往下走。3. 核心步骤安装集成与配置设备环境就绪后我们进入核心操作环节。整个过程在Home Assistant的网页界面中完成。3.1 安装蓝牙集成与监控器Home Assistant需要先管理好蓝牙本身。进入HA的“设置” - “设备与服务”。点击右下角的“添加集成”按钮。在搜索框中输入“Bluetooth”选择官方提供的“Bluetooth”集成并安装。通常它会自动发现并配置你的蓝牙适配器。接着再次“添加集成”搜索并安装“Passive BLE Monitor”集成。这个集成是关键它专门用于被动监听无需配对各种蓝牙低功耗BLE设备广播的数据酷态科10号Ultra的数据就是通过它来捕获和解码的。安装“Passive BLE Monitor”时通常保持默认配置即可它会自动开始监听周围的BLE设备信号。3.2 获取酷态科10号Ultra的MAC地址我们需要告诉HA具体监听哪个设备。这需要设备的蓝牙MAC地址。确保酷态科10号Ultra已开机短按电源键亮灯。在HA中进入“设置” - “系统” - “日志”。点击“加载完整日志”然后查找包含“BLE Monitor”或“bluetooth”的日志条目。你可能会看到一些设备名称为“CUKTECH”或类似字符后面跟着一串由冒号分隔的字母数字组合例如AA:BB:CC:DD:EE:FF。这就是MAC地址。把它复制下来。小技巧你也可以使用手机App如nRF Connect扫描蓝牙设备寻找名为“CUKTECH”的设备并查看其MAC地址。3.3 配置YAML文件关键步骤“Passive BLE Monitor”集成安装后默认可能不会自动识别酷态科10号Ultra的特定数据格式。我们需要通过编辑configuration.yaml文件来手动指定设备。在HA中通过“File editor”或“Samba share”打开你的配置文件configuration.yaml。在文件末尾确保格式正确注意缩进添加以下配置ble_monitor: devices: - mac: AA:BB:CC:DD:EE:FF # 替换为你刚才找到的MAC地址 name: CUKTECH 10号 Ultra # 自定义一个你喜欢的名字 device_type: cgg1 # 这是关键告诉集成使用哪种解码器参数解释mac必须替换成你的设备真实MAC地址。name在HA中显示的名称可以随意改。device_type: cgg1这是经过社区验证的适用于酷态科/小米系部分蓝牙设备的解码器类型。它告诉集成如何解析设备广播的电池电量、电压等数据。保存configuration.yaml文件。回到HA进入“设置” - “系统”点击“重新启动”按钮选择“重新启动 Home Assistant”。重启是让新的配置生效。3.4 验证实体是否生成重启完成后等待一两分钟。进入“设置” - “设备与服务”。在“设备”标签页下你应该能看到一个名为“CUKTECH 10号 Ultra”或你自定义的名字的新设备。点击进入该设备你应该能看到它提供的实体Entities例如sensor.cuktech_10号_ultra_battery电池电量百分比sensor.cuktech_10号_ultra_voltage电压binary_sensor.cuktech_10号_ultra_light可能代表输出状态或指示灯具体实体名称和数量可能因集成版本略有差异如果能看到电池电量传感器并且数值能随着移动电源实际电量变化而更新可能需要等待几分钟或让设备状态变化一下那么恭喜最核心的一步已经成功了。4. 接入HomeKit实现苹果生态控制现在你的酷态科10号Ultra已经是Home Assistant里的一个设备了。如果你还想把它接入苹果的HomeKit用iPhone家庭App或Siri控制接下来就是水到渠成。4.1 通过Home Assistant桥接HomeKitHome Assistant自带强大的HomeKit桥接功能。再次进入“设置” - “设备与服务”。点击“添加集成”搜索“HomeKit”。选择“HomeKit Bridge”模式。这个模式会将HA中的设备暴露给苹果家庭。在配置界面你可以选择要暴露哪些设备。这里我们找到刚刚添加的“CUKTECH 10号 Ultra”设备勾选它。你可以只暴露电池电量传感器也可以暴露所有相关实体。点击提交HA会为你创建一个HomeKit配件。界面上会显示一个配对码格式如123-45-678务必记下这个码。4.2 在苹果家庭App中添加配件打开iPhone或iPad上的“家庭”App。点击右上角的“”添加配件。选择“添加其他配件...”。点击屏幕底部的“我没有代码或无法扫描”。在列表里应该能找到名为“Home Assistant Bridge”的配件点击它。输入上一步HA提供的8位数配对码输入时不带横线。按照提示将配件添加到合适的房间并完成命名。添加成功后你就能在苹果家庭App里看到酷态科10号Ultra的电池电量信息了。你可以把它放在桌面上作为小组件或者用Siri询问“移动电源还有多少电”。4.3 关于开关控制你可能注意到目前主要接入了传感器电量。对于开关控制打开/关闭移动电源输出情况稍微复杂一些原生支持这取决于“Passive BLE Monitor”集成是否完整解析了设备的控制指令以及设备本身是否开放了通过蓝牙控制的接口。目前看来主要实现的是状态监测只读。进阶思路如果需要真正的开关控制可能需要研究设备本身的蓝牙协议并通过HA的bluetooth集成或ESPHome等工具发送特定指令。这涉及逆向工程超出了“超简单教程”的范围。对于大多数用户能远程查看电量并基于电量触发其他自动化如提醒充电已经解决了核心痛点。5. 自动化场景与高级排查接入不是终点让它为你工作才是。5.1 创建实用自动化利用电池电量传感器你可以在HA里创建非常实用的自动化低电量提醒当移动电源电量低于15%时向你的手机发送一条通知提醒充电。自动充电结合智能插座。当电量低于20%且时间在白天时自动打开智能插座为其充电电量高于95%时自动关闭插座。离家关闭当你和家人的手机都离开家通过HA的地理围栏判断时自动执行一个“关闭所有非必要电源”的场景其中可以包括一条“通知”“移动电源当前电量XX%请确认其输出已关闭”。这些自动化在HA的“设置” - “自动化与场景”中创建使用图形化编辑器或YAML均可。5.2 常见问题与排查如果过程中遇到问题按这个顺序排查设备找不到/无数据确认距离将移动电源紧挨着HA主机。确认状态短按移动电源按键确保其处于广播状态指示灯亮。查日志查看HA完整日志过滤“ble_monitor”或“bluetooth”关键词看是否有错误信息或扫描到的设备列表。重启服务尝试重启HA的“Passive BLE Monitor”集成在集成页面点击该集成选择重启或者直接重启HA主机。实体状态不更新BLE设备为了省电不是每秒都广播数据。可能需要等待几分钟或者触发一下设备如插拔一下充电线让其广播新数据。检查configuration.yaml中device_type是否正确。可以尝试社区讨论的其他类型如lywsd03mmc但cgg1成功率较高。HomeKit无法添加或配件无响应确认网络运行HA的设备必须和你的iPhone在同一个局域网子网下。重启桥接在HA的HomeKit集成配置里删除桥接并重新添加一次。检查防火墙如果HA安装在虚拟机或docker中确保允许mDNS端口5353和HomeKit相关端口的通信。配置修改后不生效任何修改configuration.yaml的操作后必须重启Home Assistant不仅仅是重载配置ble_monitor集成对配置更改比较敏感。整个过程的核心其实是理解智能家居的数据流设备蓝牙广播 - 采集器BLE Monitor - 平台Home Assistant - 桥接HomeKit。只要每一步的配置指向正确剩下的就是耐心等待和细微调整。对于这类蓝牙设备首次成功配置后只要它和HA主机在蓝牙范围内就能稳定工作为你提供一个全新的设备管理视角。