In the world of smart homes, the promise of Matter is simple: one protocol to rule them all, local control, and no more “app fatigue.” But as I discovered with my new Panasonic ACs, the journey from “plug-and-play” to “terminal-controlled” involves a bit more detective work than the marketing suggests.
Table of contents
Open Table of contents
The Goal: Local Control for Automation
The official Panasonic MirAIe app is functional, but like most proprietary IoT apps, it depends on the cloud. I wanted something faster, something I could script, and something that worked entirely offline.
My goal was to use the official CHIP Tool (the Matter reference controller) to talk to my ACs directly over my local network. No cloud, no latency, just pure local control.
The Breakthrough: Cracking the “SE” Pairing Cycle
The biggest hurdle wasn’t the protocol itself, but the hardware’s specific implementation. Initially, my Linux machine couldn’t “see” the ACs even when they were on the same Wi-Fi.
Through some nmap scans and avahi-browse monitoring, I discovered the Panasonic Pairing Cycle:
- SE Mode: Triggered via the remote (holding the SMART button), the AC enters a low-level setup state and actually disconnects from Wi-Fi.
- Reconnection: You have to wait until the “SE” display disappears and the unit reconnects to your home Wi-Fi.
- The Window: Only after reconnection does the AC open a brief Matter Commissioning Window.
- Success: By timing the
chip-toolcommand to hit exactly after reconnection, I finally established a local secure “fabric” between my terminal and the AC.
The Build: A Modern Python CLI
While the official chip-tool is powerful, its syntax is dense. I built a Python wrapper, panasonic-matter-ac-cli, to turn those complex hexadecimal strings into natural commands.
The Tech Stack
- Python 3.12+: For clean, readable logic and great regex support for parsing
chip-tooloutput. - Typer: To build a robust CLI structure with subcommands and auto-generated help menus.
- Rich: To create beautiful, formatted terminal reports and progress indicators.
- uv: The modern Python package manager, which allows the tool to be installed globally with a single command:
uv tool install git+....
What it Supports
The tool doesn’t just toggle power; it exposes every data point the Panasonic Matter implementation allows:
- Core Controls: Instant On/Off, Temperature setting (with auto-scaling), and Fan Speed control.
- Real-time Diagnostics: It fetches the room temperature directly from the AC’s sensor.
- Network Health: Tracks the real-time RSSI (Wi-Fi Signal Strength) so I can identify connectivity issues.
- Hardware Insights: Exposes hidden data like the Manufacturing Date, Firmware Version, and even a Reboot Counter (which revealed one of my units had restarted 51 times!).
# Example: Getting a full status report
panasonic-ac status bedroomWhy it Matters (Pun intended)
Building this tool taught me that even with new standards, the “real-world” behavior of hardware is still full of quirks. By bypassing the cloud and using Matter directly, I’ve created a system that is:
- Fast: Commands react in less than 100ms.
- Private: No data leaves my local network.
- Reliable: It works even if my internet is down.
Check out the code on GitHub:
Ready to take control of your air? 🚀