固件更新与发布说明
Faikin Australia
如何更新 Faikin 模块的固件，以及每个版本的更新内容。
如果您是从 Home Assistant 中的固件更新通知来到这里的，那么您来对地方了。Home Assistant 会将本页面作为 Sora、Ninja、Oyu 和 Faiktron 模块的发行说明链接。
本页内容
更新 Sora、Ninja、Oyu 或 Faiktron 模块
这些模块不会自动更新。它们每隔几天会检查一次新固件，并在有新固件时通知您，但需要由您来启动更新。
- 在与模块连接到同一网络的手机或电脑上，打开模块的网页。请访问
faikinac-xxxx.local，其中 xxxx 为模块 MAC 地址的最后四个字符；或者在路由器的设备列表中查看模块的 IP 地址并访问该地址。 - 打开“Firmware Upgrade”菜单并开始升级。模块需要联网才能下载新固件。
- 请等待一两分钟。模块会下载固件、重新启动并自行恢复运行。在此期间，请勿在隔离开关处关闭空调。
- 请查看网页上显示的版本。如果您之前使用的是更旧的版本且版本号没有变化，请再运行一次升级。
从 3.9.2 版本起，更新不会再导致模块无法使用。如果新固件无法启动，或模块在更新后约 30 秒内重新启动，它会自行恢复到之前的固件。如果反复崩溃，它会以 Safe mode 启动，此时网页仍可使用，您可以再次运行升级。
如果升级中途停止并出现 OTA failed 提示，说明模块在下载新固件时内存不足。WiFi 信号较弱时更容易出现这种情况。请在模块的网页界面中开启 Safe mode，再次运行升级，然后关闭 Safe mode。
如果您使用的版本早于 3.9.2 且升级无法完成，请联系我们，我们会协助您完成升级。
Home Assistant 更新通知
只有 Sora、Ninja、Oyu 和 Faiktron 模块会显示此通知。Faikout 模块不会显示。
如果这些模块之一通过 MQTT 连接到 Home Assistant，它会显示为一个固件更新（Firmware update）实体。有新固件可用时，Home Assistant 会显示更新通知：
- 点击“Install”会发送与模块网页界面相同的升级命令。如果没有任何反应，请按上文所述使用模块的网页界面。
- 点击发行说明链接会打开本页面。
在测试版本上，Home Assistant 可能会显示低于已安装版本的最新版本。这是正常现象。除非另有指示，请不要在测试版本上升级固件！
更新 Faikout 模块
Faikout 模块运行 RevK 的开源固件，其工作方式与上述模块不同。
- 有新版本发布时，Faikout 固件大约每周自动更新一次。您可以在模块的设置中更改此行为。
- 要立即更新，请打开模块的网页，进入 WiFi 设置并点击“Upgrade”。模块需要联网，更新完成后会自行重新启动。
- 修复通常会先发布到测试版（beta）。模块网页的固件更新部分有一个可在正式版（release）与测试版之间切换的开关。切换到 beta 可提前获得修复，修复正式发布后再切换回 release。
固件源代码、手册和问题跟踪器位于 Codeberg：codeberg.org/RevK/ESP32-Faikout。正在进行中的更改列在 Work in progress页面中。我们的设置指南在这里。
发布日期
| 日期 | 模块 | 空调品牌 |
|---|---|---|
| 2026 年 10 月 15 日 | Sora | Daikin（S21 连接器）、LG、Mitsubishi Electric 和 Mitsubishi Heavy Industries，均提供 WiFi 和 Matter 版本 |
| 2026 年 10 月 9 日 | Faiktron | 配有 LM7、LM8 或 LM24 系列壁挂控制器的 ActronAir 风管式系统 |
| 2026 年 9 月 19 日 | Oyu | Daikin Altherma 4（测试中） |
| 2026 年 8 月 5 日 | Ninja | Mitsubishi Heavy Industries（X-Y） |
| 2026 年 8 月 2 日 | Oyu | Daikin Altherma 2 和 3 |
| 2026 年 7 月 8 日 | Ninja | Daikin 风管式、VRV 和 Sky Air（P1/P2） |
发行说明：Sora、Ninja、Oyu 和 Faiktron
最新版本在前。版本号按模块报告的形式显示。较长的版本号，例如 3.9.4.2-6-g1a2b3c4，是 3.9.4.2 之后的构建版本，包含截至该版本所列的全部内容。
3.9.4.3
2026 年 10 月 28 日 · Sora（LG）
- Matter 构建已更新至 Matter 1.6.1。
- 底层平台已更新，并包含底层 WiFi 稳定性修复。
3.9.4
2026 年 10 月 25 日 · 所有模块
- 修复了 Daikin 风管式系统（Ninja）的分区控制问题。
10 月修复（3.9.3 版本）
2026 年 10 月 17 日至 24 日
- Sora（Mitsubishi Heavy Industries）：修复了部分早期模块读取空调时出现的故障。WiFi 和 Matter 构建均已发布。
- Ninja：现在可以在 Daikin 分区系统上正确设置分区风速。
- 所有模块：如果模块在更新后约 30 秒内重新启动，现在会自动恢复到之前的固件。
- 所有模块：板载定时功能。在网页的“Setup”下的“Schedule”中设置时间和选项。定时在模块上运行，无需 Home Assistant 或互联网连接。
Sora（LG）修复
2026 年 10 月 9 日 · Sora（LG）
- 修复了空调在某些情况下忽略温控器更改的问题。
3.9.2
2026 年 10 月 2 日 · 所有模块
- 全新的网页界面。
- 更安全的更新：如果新固件无法启动，模块会恢复到之前的版本。
- Safe mode：连续崩溃五次后，模块会以最小模式启动，使您仍可访问网页并进行更新。
- 每三天检查一次新固件，并向 Home Assistant 报告。
Sora（LG）修复
2026 年 9 月 22 日 · Sora（LG）
- 状态 LED 现在显示正确的状态。
3.9.0
2026 年 9 月 12 日 · 所有模块
- MQTT 主题已更改，现在可以通过 MQTT 命令更改模块设置。如果您使用的是自己的 MQTT 自动化，而不是 Home Assistant 自动发现，请在更新后检查。
3.8.4
2026 年 7 月 22 日至 27 日 · 所有模块
- 取代了早期的 3.8 构建，并修复了其中发现的问题。
- Matter 构建：状态 LED 现在的行为与 WiFi 构建相同。
3.8.3
2026 年 7 月 16 日至 19 日
- Ninja：修复分区控制的错误。
- 已更新 Matter 构建。
3.8.0
2026 年 7 月 10 日
- Ninja：支持 Daikin 风管式系统的分区控制，分区会被自动检测。
- 支持 Apple Home 和 Matter。
发行说明：Faikout
Faikout 固件经常变动。完整且最新的列表，请参阅 Codeberg 上的 Work in progress页面。值得了解的近期修复：
- 一个可能导致部分模块长时间运行后重新启动的内存问题，已在当前的测试版中修复。
- Home Assistant 将空调短暂显示为不可用的问题，已在当前的测试版中修复。
- 板载定时功能可在“Setup”下的“Schedule”中使用。
