PanasonicComfortCloudClient 1.0.1
dotnet add package PanasonicComfortCloudClient --version 1.0.1
NuGet\Install-Package PanasonicComfortCloudClient -Version 1.0.1
<PackageReference Include="PanasonicComfortCloudClient" Version="1.0.1" />
<PackageVersion Include="PanasonicComfortCloudClient" Version="1.0.1" />
<PackageReference Include="PanasonicComfortCloudClient" />
paket add PanasonicComfortCloudClient --version 1.0.1
#r "nuget: PanasonicComfortCloudClient, 1.0.1"
#:package PanasonicComfortCloudClient@1.0.1
#addin nuget:?package=PanasonicComfortCloudClient&version=1.0.1
#tool nuget:?package=PanasonicComfortCloudClient&version=1.0.1
PanasonicComfortCloudClient
A standalone, asynchronous C# 14 client for Panasonic Comfort Cloud, including the Aquarea air-to-water heat-pump API. Targets .NET 10 and .NET Framework 4.7.2. The Windows test console supports interactive use and command-line automation.
Version 1.0.1 fixes ordered session-change notification delivery. API documentation and guides. This is an independent implementation, not affiliated with or endorsed by Panasonic. Panasonic's mobile-app cloud interface is not a public compatibility contract.
Features
- Typed device discovery with Aquarea, air-conditioner and standalone hot-water families.
- OAuth authorization-code/PKCE browser authentication, including Panasonic-hosted MFA, token refresh and cloud client registration.
- Legacy password/CSRF login, classic OTP and hosted Guardian MFA; explicit v1 policy and isolated Aquarea cookie routes.
- Aquarea live or explicitly cached status, zones, tank, operating modes, quiet/powerful modes, special setpoint offsets, energy history and weekly schedules.
- Aquarea branch changes read fresh status and preserve other zones and tank operation.
- Separate AC and HWS status, control, history and scheduling endpoints.
- Numeric enums preserve unknown reported values; missing readings remain null and real zeroes remain zeroes.
- Typed schedule round trips preserve unknown wire fields. AC and Aquarea history/control encodings are separate types.
- Schedule creation/editing helpers, AC capability evaluation, daily energy selection and application-owned energy/change tracking.
- Explicit optional AC power-on/preference buffering and cached app-version discovery.
- Cancellation, request pacing, one request at a time, bounded responses and typed cloud errors.
- Optional
Microsoft.Extensions.Logginglogging; the default logger is silent and credentials and response bodies are never logged.
See the complete upstream method/field audit, protocol coverage, authentication, console usage and validation status.
Build and test
dotnet build PanasonicComfortCloudClient.slnx -c Release
dotnet test tests/PanasonicComfortCloudClient.Tests -c Release -f net10.0
dotnet test tests/PanasonicComfortCloudClient.Tests -c Release -f net472
Run net472 tests and the console on Windows. The library has no Crestron SDK reference; ordinary cloning and Visual Studio/VS Code builds do not install or contact processors. Shared build and documentation tasks are available through build/Invoke.ps1.
Read Aquarea status
using PanasonicComfortCloudClient;
using PanasonicComfortCloudClient.Models;
using var client = new ComfortCloudClient(new ComfortCloudOptions
{
AppVersion = currentAndroidComfortCloudAppVersion
});
await client.RestoreSessionAsync(applicationStoredSession, cancellationToken);
var groups = await client.GetGroupsAsync(cancellationToken);
var heatPump = groups.SelectMany(g => g.Devices)
.Single(d => d.Family == DeviceFamily.Aquarea);
var snapshot = await client.GetAquareaStatusAsync(
heatPump.DeviceGuid!, StatusSource.Live, cancellationToken);
Console.WriteLine(snapshot.Status?.OutdoorTemperature);
The application owns credentials, storage, browser presentation and polling. Subscribe to SessionChanged and persist the latest CurrentSession atomically when refresh tokens rotate. The client does not write files, open windows, schedule polling or log out on disposal. Use separate clients for separate Panasonic accounts.
Concurrent client operations are serialized, including compound schedule/policy operations. Disposal cancels admitted work and defers owned-resource cleanup until it exits. Trackers synchronize their state; mutable DTOs/builders still require caller-owned coordination. See the thread-safety and Mono audit.
Windows test console
dotnet run --project src/PanasonicComfortCloudClient.Console -- help
dotnet run --project src/PanasonicComfortCloudClient.Console -- login --app-version CURRENT_ANDROID_VERSION
dotnet run --project src/PanasonicComfortCloudClient.Console -- devices
dotnet run --project src/PanasonicComfortCloudClient.Console -- aquarea status --device DISCOVERED_GUID
Run without arguments for an interactive prompt. Default login opens a Panasonic ID window backed by Microsoft Edge WebView2. login --legacy instead uses masked password/OTP prompts. Neither mode accepts password/token command-line arguments. The console stores its session using Windows DPAPI for the current user. Every device/account-changing command requires --apply.
Validation and limitations
Fake-HTTP protocol tests run on both target frameworks. Actual cloud/device validation is tracked separately and must not be inferred from offline tests. The available live device is an Aquarea heat pump; browser authorization, discovery, live status, weekly-schedule reads and energy-history reads have passed on both workstation frameworks; see the validation record for processor results. Bounded quiet-mode and tank-target round trips also passed on the workstation and processor, with original settings restored and confirmed. AC/HWS model coverage is not a claim that those hardware families have been live-tested here.
Cloud acknowledgement is not confirmation that the heat pump changed state. Read status separately. Device writes are never automatically retried after rejection, cancellation or uncertain transport outcomes. Schedule writes replace the full week and must begin with a schedule read from the intended device.
Reference and licence
Protocol reference: aio-panasonic-comfort-cloud, audited commit 80d7784fa6b35d6f71a7b1f842062e2929d2d653, including release 2026.10.1 and its four subsequent commits. The maintained product contains C# source, not a Python runtime or Python implementation. See third-party notices and source provenance.
Copyright (c) 2026 Neil Colvin. MIT licensed.
Source and build conventions
The shared EditorConfig is included under Solution Items. C# source uses tabs with a width of three and the model projects' brace and spacing rules. Every authored C# file carries the copyright and MIT licence header.
Directory.Build.props also owns the shared author/company, copyright, licence, repository and assembly-generation metadata. Its single Version value supplies the package version; the SDK derives assembly/file/informational versions. Project files retain their distinct names, titles, products, descriptions and package IDs.
C# is pinned to 14.0. Nullable reference analysis, recommended .NET analyzers and build-time code-style checks are enabled for both configurations, including the console and tests. Shared conditional groups in Directory.Build.props, also listed under Solution Items, treat compiler/analyzer warnings as errors in Debug and leave them as warnings in Release. Detailed formatting/style rules remain in .editorconfig. Strict XML validation requires summaries, parameter/type-parameter and return descriptions, property <value> descriptions and valid references; CI also checks the generated Pages navigation, search and API output.
The Framework target retains only the compatibility dependencies this client uses: three Hafner attribute packages, required/init support, System.Memory and task extensions. Async interfaces and Unsafe arrive transitively through the JSON/memory dependencies. Unused BCL memory/index/range and hash-code packages are excluded. See the compatibility package guide. C# 14 extension members supply the missing modern guard, hashing, hex, cancellation and memory-stream APIs while shared call sites keep the modern .NET APIs. A separate Framework HTTP handler preserves Panasonic's bodyless-GET headers.
Verify formatting and style with:
dotnet format whitespace PanasonicComfortCloudClient.slnx --verify-no-changes
dotnet format style PanasonicComfortCloudClient.slnx --verify-no-changes --severity info
dotnet build PanasonicComfortCloudClient.slnx -c Debug
See the bounded live-control test protocol before selecting any physical setting test.
Changes in 1.0.1
Session-change notifications are queued in commit order and delivered serially after the operation gate is released. Concurrent callers wait for their notifications. Reentrant session operations commit and queue their notification without waiting for the current callback, avoiding deadlocks. Persistence across separate clients or processes still needs application-owned coordination.
Release packaging and publication use the shared publication component. Set RELEASE_VERSION=1.0.1 and run ./build/Invoke.ps1 -Task release-assets for local preparation; it publishes nothing. GitHub publication reuses retained, hash-verified artifacts and the repository's existing NuGet trust identity.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
-
.NETFramework 4.7.2
- Hafner.Compatibility.CallerInformationAttributes.G2 (>= 1.0.0)
- Hafner.Compatibility.NullableReferenceTypeAttributes.G1 (>= 1.0.3)
- Hafner.Compatibility.NullableReferenceTypeAttributes.G3 (>= 1.0.3)
- HtmlAgilityPack (>= 1.12.4)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- System.Memory (>= 4.6.3)
- System.Text.Json (>= 10.0.12)
- System.Threading.Tasks.Extensions (>= 4.6.3)
-
net10.0
- HtmlAgilityPack (>= 1.12.4)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
# PanasonicComfortCloudClient 1.0.1
This patch corrects the audited reliability issues while retaining the existing public API and supported frameworks.
- Session-change notifications are queued in commit order and delivered serially after the operation gate is released. Concurrent callers wait for their notifications. Reentrant session operations commit and queue their notification without waiting for the current callback, avoiding deadlocks. Persistence across separate clients or processes still needs application-owned coordination.
## Validation
- Offline workstation tests passed in Debug and Release on .NET 10 and .NET Framework 4.7.2: Panasonic net10.0: 392; Panasonic net472: 395. No failures or skips.
- 24 selected tests passed in the shared 374-case processor run on Mono 6.12.0.107 (32-bit), with no failures or skips. The merged host's resolved dependency graph was tested; these are not eight independent release-package tests.
- Fake transports and credentials exercised ordering, cancellation, shutdown and failure recovery. No new household-device or cloud control was performed. Pairing storage is unchanged.
- Strict XML, formatting and style checks passed. Package and companion-app preparation is verified separately by the shared release pipeline.
See [the changelog](https://github.com/oznetmaster/PanasonicComfortCloudClient/blob/v1.0.1/CHANGELOG.md) and [validation provenance](https://github.com/oznetmaster/PanasonicComfortCloudClient/blob/v1.0.1/release-validation/v1.0.1.json).