MQTTマニュアル

MQTT 経由での Faikin Faikout の制御と監視に関する完全ガイドです。初期設定から、トピック・コマンド・設定の完全なリファレンスまでを扱います。

本書は、RevK のファームウェアを実行する WiFi 版 Faikout モジュールを対象とします（デバイスのブランド名は Faikout ですが、旧称の Faikin が表示される場合もあります）。ファームウェアがプロトコルを自動的に判別するため、S21、X50A、CN_WIRED いずれのユニットにも同様に適用されます。本書全体を通じて、ホスト名の例は GuestAC、ブローカー IP の例は 192.168.1.10 です。いずれもご自身の値に置き換えてください。

1. MQTT でできること

すべてがローカルで完結します。Faikout はご自身のネットワーク上で MQTT を話し、クラウドアカウントもインターネットへの依存もありません。MQTT 経由で次のことができます。

• ユニットの制御: 電源、モード、設定温度、風量、ルーバーのスイング、パワフル/エコノ。
• 赤外線リモコンでは見えないライブ測定値の読み取り: 室温、コイル/液側、吸込、外気の各温度に加えて、機種名と運転状態。
• Faikout Auto レイヤーの制御: 目標範囲、スケジュール、外部温度基準。
• Home Assistant（ネイティブの自動検出）、openHAB、Node-RED、Domoticz、ioBroker、その他 MQTT に対応するあらゆるものとの連携。

MQTT 制御は、内蔵の Web インターフェースおよび赤外線リモコンと並行して動作します。いずれかの手段で行った変更は、数秒以内にすべての場所へ反映されます。

2. 始める前に

必要なもの:

• Faikout が取り付けられ、2.4GHz WiFi にすでに接続されていること（セットアップマニュアルを参照）。ブラウザで GuestAC.local からアクセスできます。
• 同じネットワーク上の MQTT ブローカー。よく使われるのは Home Assistant 内の Mosquitto アドオン、または Raspberry Pi・NAS・サーバー上の単独の Mosquitto です。
• ブローカーの IP アドレスまたはホスト名、およびブローカーが認証を必要とする場合は ユーザー名とパスワード（Home Assistant のブローカーは通常必要とします）。

ブローカーはご自身が管理するネットワーク上に置いてください。Faikout の MQTT は平文のローカル通信であり、インターネットに公開することは想定されていません。

3. ステップ 1: Faikout を MQTT ブローカーに向ける

1. GuestAC.local にアクセスし、WiFi 設定を開きます（まだ WiFi に接続されていない場合は、デバイスのセットアップを起動し、その Daikin/Faikout アクセスポイントに接続します）。
2. MQTT セクションで、Host（ブローカーの IP またはホスト名、例: 192.168.1.10）を入力し、ブローカーが使用する場合は Username と Password も入力します。
3. Hostname を覚えやすいもの、例えば GuestAC に設定してください。この名前はすべての MQTT トピックの一部になるため、オートメーションを組む前に決めておきます。
4. 保存します。Faikout は再接続し、パブリッシュを開始します。

基盤となる接続設定は mqtthost です（RevK ライブラリの標準）。ユーザー名とパスワードは同じページで入力します。接続後は MQTT 自体を介してこれらを後から変更することもできます（設定リファレンスを参照）。

4. ステップ 2: 接続を確認する

これにターミナルは必要ありません。次の2か所ですぐに確認できます。

Faikout 自身のページで

GuestAC.local にアクセスします。ページ上部のデバイス名の横に、Faikout がブローカーの接続状態を表示します。MQTT connected と表示されていれば、モジュールがブローカーに到達し、パブリッシュしている状態です。

この表示はページ上部のデバイス名の横にあります。MQTT のホスト、ユーザー、パスワードは同じページの下のほうにあります。

この表示がない場合は、ホスト、ユーザー名、パスワードのいずれかが誤っているか、モジュールが接続しているネットワークからブローカーに到達できません。設定ページの MQTT セクションを確認し、そのうえでトラブルシューティングをご覧ください。

Home Assistant で

手作業で追加するものはありません。Faikout は Home Assistant の MQTT ディスカバリーメッセージをパブリッシュするため、ブローカーに到達するとHome Assistant が自動的に見つけます。MQTT 統合がすでに設定され、同じブローカーを指していれば十分です。

1. 設定 > デバイスとサービス > MQTT に移動し、デバイス一覧を開きます。
2. GuestAC が数秒以内に表示され、メーカーが RevK、ファームウェアのバージョンとともに一覧に載ります。
3. 開くと、デバイスはすでにすべて揃っています。現在温度と設定温度を表示する climate エンティティ（MQTT HVAC）、Controls にある運転モードと各機能のスイッチ（Auto、Comfort、Econo、Power、Powerful、Quiet outdoor、Sensor、Streamer、Restart）、そして Sensors にある室温と設定温度、圧縮機と送風機の回転数、湿度、熱交換器温度と外気温度、消費電力、積算電力量です。

Home Assistant の Faikout デバイスページです。ここにあるものは手作業で追加したものではなく、climate エンティティもコントロールもセンサーもすべて MQTT ディスカバリーで届きます。

表示されない場合は、Home Assistant がモジュールと同じブローカーを使用しているか確認し、そのうえでトラブルシューティングをご覧ください。Faikout では YAML で climate エンティティを手書きする必要は決してありません。手書きが必要になっている場合は、どこか手前に問題があります。

ターミナルで確認したい場合

任意です。mosquitto のクライアントツールをすでにインストールしている場合にのみ意味があります。

mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'state/GuestAC/#' -v

保持された state/GuestAC メッセージが表示されるはずです。エアコンがモジュールと通信しているとき、そのペイロードは online を true として報告します。サフィックスのない state/GuestAC トピックはデバイス自身の在席状態を示し、ペイロードが false の場合は Faikout 自体がオフラインであることを意味します（これはその MQTT の will/birth メッセージです）。

何も届かない場合は、トラブルシューティングへ進んでください。

5. トピック構造

Faikout は RevK ライブラリ標準のトピック構成 prefix/hostname/suffix を使用します。ホスト名が GuestAC の場合:

ほとんどのオートメーションでは、このうち 2 つだけで十分です。command/GuestAC/control にパブリッシュし、state/GuestAC をサブスクライブします。

6. コマンドの送信

command/GuestAC/<command> にパブリッシュします。単純なコマンドはペイロードを取りません。いくつかのコマンドは引数をペイロードとして取ります。

例:

# Power on
mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/on' -n

# Switch to cooling
mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/cool' -n

# Set target to 21 C
mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/temp' -m '21'

7. control メッセージ（最も重要なもの）

command/GuestAC/control は JSON ペイロードを取り、複数の項目を一度に設定する最もすっきりした方法です。同じフィールド名がステータス JSON にも現れるため、送信する内容と読み取る内容が一致します。

例: 風量自動、垂直スイングオンで 24°C まで冷房する場合:

mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/control' \
  -m '{"power":true,"mode":"C","temp":24,"fan":"A","swingv":true}'

注意: powerful、econo、streamer などの追加機能は機種に依存します。S21 はリバースエンジニアリングされたもので、ユニットによって同一ではないため、お使いのユニットにないスイッチは単に無視されます。お使いのユニットが実際に公開している制御は、ステータス JSON で確認できます。

8. ステータスの読み取り

Faikout は 3 系統のトピックにステータスをパブリッシュします。

• state/GuestAC は人間/オートメーション向けのステータスで、reporting 秒ごと（既定 60）および重要な変化時にパブリッシュされます。livestatus をオンにすると、すべての変化時にリアルタイムでもパブリッシュされます。
• Faikout/... は約 1 分に 1 回パブリッシュされ、faikoutlog ツールがグラフ化のために MySQL/MariaDB データベースへ保存することを目的としています。
• <MAC>/... は Home Assistant の自動検出フィードで、HA サポートが有効なときにパブリッシュされます（セクション 9 を参照）。

state JSON には上記の control テーブルのすべて（power、mode、temp、fan などを読み戻せます）に加え、次の読み取り専用フィールドが含まれます。

データベースのログ形式: Faikout/ フィードでは、各値が期間にわたって要約されます。変化しなかった場合は単一の値として報告され、変化した場合、数値は [min, average, max] の配列に、ブール値はその期間に true であった割合を示す 0.0～1.0 の小数になります。fixstatus をオンにすると、常に配列/小数形式が使用されます。

9. MQTT 経由の Home Assistant

Faikout は Home Assistant のネイティブな自動検出機能を備えており、既定で有効です（設定 haenable、既定はオン）。モジュールが Home Assistant と同じブローカーと通信すると、climate エンティティが自動的に現れます。

セットアップ:

1. Home Assistant が使用する MQTT ブローカーを実行します。最も簡単なのは、Home Assistant OS の Mosquitto broker アドオンに MQTT インテグレーションを追加する方法です。
2. デバイス用に Home Assistant で MQTT ユーザーを作成します（Mosquitto アドオンでは通常の HA ユーザーで動作します）。
3. Faikout のセットアップページで、MQTT host を Home Assistant の IP に設定し、その ユーザー名とパスワードを入力します。
4. 1 分以内に Home Assistant がデバイスを検出し（<MAC>/... トピック配下にパブリッシュされます）、climate カードを追加します。YAML は不要です。

便利な HA 関連の設定（MQTT または Advanced Web ページから設定）:

ダッシュボードおよびエンティティカードの YAML

エンティティを作成するのに YAML は不要です。自動検出が climate エンティティと温度センサーを自動的に作成します。以下の YAML は、それらを Lovelace ダッシュボード上に配置するためのものです。

エンティティ ID はホスト名から導出されるため、GuestAC という名前のデバイスでは climate.guestac となり、センサーは sensor.guestac_temperature のようになります。正確なスラグはファームウェアのバージョンや HA の命名設定によって異なるため、設定 → デバイスとサービス → MQTT →（お使いのデバイス）または 開発者ツール → 状態で確認し、以下の ID をそれに合わせて調整してください。

エンティティカード。 任意のダッシュボードで カードを追加 → 手動からカードを追加し、次を貼り付けます。

type: entities
title: Guest AC
show_header_toggle: false
entities:
  - entity: climate.guestac          # adjust IDs to match your install
    name: Air conditioner
  - type: section
    label: Live temperatures
  - entity: sensor.guestac_temperature
    name: Room
  - entity: sensor.guestac_outside_temperature
    name: Outside
  - entity: sensor.guestac_inlet_temperature
    name: Inlet
  - entity: sensor.guestac_liquid_temperature
    name: Liquid / coil

ダッシュボード全体のビュー。 ダッシュボードを開き、編集 →（3 点メニュー）→ 構成エディタ（Raw）を選び、これを views: 配下に新しいビューとして追加します。

title: Climate
path: climate
icon: mdi:air-conditioner
cards:
  - type: thermostat
    entity: climate.guestac          # adjust IDs to match your install

  - type: entities
    title: Guest AC
    entities:
      - entity: climate.guestac
        name: Controls
      - type: section
        label: Live temperatures
      - entity: sensor.guestac_temperature
        name: Room
      - entity: sensor.guestac_outside_temperature
        name: Outside
      - entity: sensor.guestac_inlet_temperature
        name: Inlet
      - entity: sensor.guestac_liquid_temperature
        name: Liquid / coil

  - type: history-graph
    title: Temperatures (24 h)
    hours_to_show: 24
    entities:
      - sensor.guestac_temperature
      - sensor.guestac_outside_temperature

1 枚のカードを視覚的に組み立てたい場合は、Mushroom の「Climate」カードと組み込みの Thermostat カードのいずれも climate.guestac に直接バインドできます。

より簡単な、MQTT を使わない代替手段。 Faikout は Daikin 独自のローカル API もエミュレートし、BRP 互換の UDP 検出に応答します（設定 udpdiscovery）。MQTT ブローカーを運用したくない場合は、代わりに Home Assistant の組み込み Daikin インテグレーションを追加し、Faikout の IP アドレスを指定できます。技術に詳しくない方にとっては、これが HA へ入る最も手間のかからない経路です。MQTT の経路は、Daikin インテグレーションが公開していない機能が必要な場合や、HA 以外のものと連携する場合に取っておきましょう。

Apple Home / Alexa / Google。 これらは MQTT を直接話しませんが、ブリッジがその差を埋めます。Home Assistant は 3 つすべてをブリッジします。HA を使わない Apple 専用の環境では、MQTT プラグイン（例: EasyMQTT）を入れた Homebridge によって、Faikout をネイティブの iOS ホームアプリと Siri に取り込めます。実績のある方法ですが、セットアップにはセルフホストのサーバーが必要なため、ある程度の設定作業を見込んでください。

10. その他のプラットフォーム

同じ 2 つのトピック（書き込みは command/GuestAC/control、読み取りは state/GuestAC）がどこでも機能します。

mosquitto コマンドライン

# Watch everything for this device
mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'state/GuestAC/#' -v

# Ask the device to report its current settings (empty payload)
mosquitto_pub -h 192.168.1.10 -t 'setting/GuestAC' -n

# Change one setting
mosquitto_pub -h 192.168.1.10 -t 'setting/GuestAC/reporting' -m '30'

# Full control
mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/control' \
  -m '{"power":true,"mode":"H","temp":21,"fan":2}'

Node-RED

• 制御する場合: トピック command/GuestAC/control を設定した mqtt out ノードを使います。これに JSON オブジェクトである msg.payload を渡します（template または function ノード、あるいはペイロードを JSON 値に設定する change ノードを使用）。
• 監視する場合: state/GuestAC に対する mqtt in ノードを置き、続いて json ノードでオブジェクトに解析して、それを基にルーティングできます（例: payload.home、payload.power）。

openHAB

汎用の MQTT バインディングを使用します。ブローカー用の MQTT Thing を作成し、続いて次のようなチャンネルを作成します。

• commandTopic = command/GuestAC/control を指定し、値を {"power":%s} として整形する Switch チャンネル。
• stateTopic = state/GuestAC を指定し、室温を読み取るために $.home のような JSONPATH 変換を用いる Number チャンネル。

同じパターン（command/.../control へ JSON をパブリッシュし、state/... から JSON を解析する）が、Domoticz、ioBroker、Jeedom、FHEM、Homey、Hubitat、Gladys にも当てはまります。

11. MQTT 経由の Faikout Auto

Faikout Auto は、ユニットを暖房/冷房/オフの間で細かく切り替えながら目標範囲を維持する追加の制御レイヤーで、エアコン自身のセンサーの代わりに 外部 温度センサーを任意で使用できます。Web UI から、BLE センサーから、または MQTT 経由の 3 通りで制御できます。MQTT の経路を以下に示します。

A. 自前のオートメーションから測定値をプッシュする

env（および任意で target）を含む control メッセージを送信します。するとユニットは自身がリモート制御下にあるものとして扱います。

mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/control' \
  -m '{"env":22.4,"target":[20,22]}'

• env はお使いのセンサーから得た現在の室温です。すべての control メッセージで再送し、かつ少なくとも tcontrol 秒ごと（既定 600）に送る必要があります。タイムアウトすると、ユニットはリモート/自動モードから外れて元に戻ります。
• [min,max] 配列としての target（または margin を伴う単一の数値）は、Faikout Auto モードを強制し、快適範囲を定義します。

B. Faikout をセンサートピックにサブスクライブさせる

プッシュする代わりに、既存の MQTT トピックを Faikout に追従させます。

重要: autotopic のペイロードは、指定したフィールドを含む JSON でなければなりません。値そのものをパブリッシュするトピック（例: 単純な ESPHome の state トピック）は解析できません。JSON で包むか、経路 A を使用してください。

C. 外部センサーを追従しつつ、オン/オフは手動のままにする

よくある要望として、正確な外部測定値に合わせて制御しつつ、ユニットが自ら電源をオン/オフしないようにしたい、というものがあります。難点は、env を送るとユニットが「リモート」状態になり、リモート時には autoptemp が 0 でない限り（既定 0.5）自動電源が前提になることです。そこで次のようにします。

• autop をオフ、autoptemp を 0 に設定します（自動の電源オン/オフを停止します）。
• tempadjust をオンのままにします（これがユニットを実際に基準値へ合わせる役割を果たします。設定温度を reference - measured の分だけ調整します）。
• target 配列は送らないでください（配列は完全な Auto の範囲/電源動作を強制します）。{"env": 22.4} のみを送ります。

mosquitto_pub -h 192.168.1.10 -t 'setting/GuestAC' -m '{"autop":false,"autoptemp":0}'
mosquitto_pub -h 192.168.1.10 -t 'command/GuestAC/control' -m '{"env":22.4}'

control メッセージで送ることもできる Auto モードの制御

これらは設定を反映するもので、リモート制御下にないときはステータスで報告されます。

12. 設定リファレンス

設定は MQTT 経由で 2 つの形式で読み書きします。

• 一括／読み戻し: setting/GuestAC に JSON をパブリッシュします（例: {"reporting":30,"livestatus":true}）。空のペイロードを送ると、デバイスは現在の設定をパブリッシュします。
• 1 つずつ: setting/GuestAC/<name> に値そのものをパブリッシュします（例: トピック setting/GuestAC/livestatus、ペイロード true）。

以下の名前は MQTT 名です（Advanced Web ページではグループ化されていますが、MQTT では 1 単語として記述します）。これは実用的な抜粋であり、お使いのファームウェアにおける正式な一覧は、デバイス自身の設定ダンプ（setting/GuestAC への空ペイロード）です。

接続と報告

Home Assistant

セクション 9 を参照: haenable、haswitches、ha1c、hafanrpm、hacomprpm、hadomain、udpdiscovery、nohvacaction、nohomepreset。

Faikout Auto

予測および範囲の挙動の微調整（pushtemp、switchtemp、coolover、coolback、heatover、heatback、tpredicts、tpredictt、tsample、tcoolmin、theatmax、frosttemp、minoutside）は Advanced マニュアルに記載されており、変更が必要になることはまれです。

機能の上書き

ファームウェアが、お使いのユニットに実際にはない制御を提示する場合（またはその逆の場合）、no... 設定で何を隠すかを指定します。例: nopowerful、noecono、nostreamer、noswingv、noswingh、noquiet、nodemand、nofaikoutauto。プロトコルを強制する設定 nos21、nox50a、nocnwired は、自動検出が誤ったプロトコルを選んだ場合に、その特定のプロトコルを試みないようにします。

デバッグ

13. トラブルシューティング

MQTT に何も現れない／デバイスがオフラインと表示される。 サフィックスのない state/GuestAC トピックを確認します。false は Faikout 自体がブローカーに接続されていないことを意味します。続いて、設定内のブローカーの IP/ホスト名に到達できること、MQTT のユーザー名とパスワードが正しいこと、ブローカーが待ち受けていること（通常は LAN 上のポート 1883）、モジュールが 2.4GHz WiFi 上にあること（5GHz は使用しません）を確認します。ブラウザで GuestAC.local が読み込めれば WiFi が正常である証拠で、その場合は MQTT 認証情報またはブローカーへの到達性の問題です。

ユニットが勝手にオンになり続ける。 control メッセージで env を送るとユニットはリモート制御下になり、リモート時には autoptemp が 0 でない限り（既定 0.5）自動電源が前提になります。オン/オフを手動のままにするには、autop をオフ、autoptemp を 0 に設定し、tempadjust をオンのままにして、target 配列を付けずに {"env": ...} のみを送ります。セクション 11C を参照してください。

Faikout がしばらくすると Auto モードから外れる。 env/control メッセージは tcontrol 秒（既定 600）でタイムアウトします。すべての control メッセージで env を再送し、タイムアウトより短い間隔で送ってください。

autotopic が何も動作しない。 サブスクライブするトピックは、autopayload で指定したフィールドを含む JSON を運ぶ必要があります。値そのもののペイロードは解析できません。JSON をパブリッシュするか、env の control メッセージで自分で値をプッシュしてください（セクション 11A）。

Home Assistant にデバイスが表示されない。 haenable がオンであること（既定でオン）、HA の MQTT インテグレーションが検出有効でインストールされていること、デバイスが HA と同じブローカー上にあることが必要です。<MAC>/#（モジュールの MAC アドレス）をサブスクライブして、検出メッセージが届いていることを確認します。MQTT をまったく使いたくない場合は、代わりに Faikout の IP を指定したネイティブの Daikin インテグレーションを使用してください。

ステータスが古く見える。 state/ メッセージは保持されるため、クライアントは再起動後に最後の値を表示できます。本当に古いデータが見える場合は、そのトピックの保持メッセージをクリアし、変化時の即時更新のために livestatus をオンにしてください。

一部の制御が何も動作しない。 S21 はリバースエンジニアリングされたもので機種によって異なります。powerful、econo、demand などはお使いのユニットに存在しないことがあり、その場合は単に無視されます。お使いのユニットが実際に公開している制御は、ステータス JSON で確認できます。

14. クイックリファレンス（早見表）

GuestAC をご自身のホスト名に、192.168.1.10 をご自身のブローカーに置き換えてください。

読み取り（サブスクライブ）

コマンド（command/GuestAC/... にパブリッシュ）

control ペイロード

{"power":true,"mode":"C","temp":24,"fan":"A","swingv":true}

設定（setting/GuestAC... にパブリッシュ）

外部センサー、オン/オフは手動のまま

出典: RevK ESP32-Faikout のファームウェアおよびマニュアル（README、Setup、Controls、Advanced）と、Codeberg（codeberg.org/RevK/ESP32-Faikout）上の ESP/main/settings.def。記載の挙動は 2026 年 6 月時点のファームウェアに対応します。インストール済みのバージョンについては、デバイス自身の設定ダンプが正式な情報源です。