v1.3.0 — reconfigure flow (rotate credentials on demand)

Adds a Reconfigure flow: Settings → Devices & Services → Hinen Solar Advanced → Reconfigure now lets you enter a new Client ID and Client Secret on demand.

Previously credentials could only be replaced via reauthentication, which Home Assistant only offers after the stored token is rejected. That is too late when you rotate credentials deliberately — the config entry keeps the old client id and secret while the current access token carries on working, and re-adding the integration aborts as already-configured. There was no path to update them until the integration broke.

The existing entry is updated in place and reloaded, so entity IDs, history and automations are preserved. Additive — no entity changes.

Closes the Gold reconfiguration-flow quality-scale rule.

🤖 Generated with Claude Code

v1.2.0 — inverter run-state enum

Adds sensor.<device>_status — inverter run state as an enum (off / normal / sleep).

The connectivity binary sensor is on only when the device reports status 1, which collapses sleep into off — an inverter that legitimately sleeps overnight read identically to one that had dropped offline. Values match the legacy hinen_power semantics (0/1/2) and the entity ID matches the one it used, so prior dashboard references bind straight back.

Additive only — no existing entity IDs, unique IDs or names change.

⚠️ Still includes the v1.1.0 breaking change: Work Mode option values are stable slugs (self_consumption, battery_priority, grid_priority, time_period, power_keeping), not display labels.

🤖 Generated with Claude Code

v1.1.0 — work-mode slugs, fault visibility, diagnostics

Breaking for automations: Work Mode option values are now stable slugs (self_consumption, battery_priority, grid_priority, time_period, power_keeping) instead of display labels, with friendly labels moved to translations. These match the legacy hinen_power integration's slugs and device values, so automations written against it work unchanged. Entity IDs are unchanged.

Added

• Inverter fault visibility: sensor.<device>_alert_status (normal/alarm/error) and binary_sensor.<device>_problem — connectivity alone can't see a faulted-but-reachable inverter.
• Diagnostics download, with OAuth tokens, client id/secret, serial and device id redacted.
• README configuration-parameters reference, Troubleshooting and Removal sections.

Fixed

• An unreachable device logged an error every 60s poll; now logged once with a recovery log.

See CHANGELOG.md.

🤖 Generated with Claude Code

v1.0.1 — brand icon + docs

Ships the self-hosted brand icon (Hinen logo in HA 2026.3+ via the local brands proxy) and adds README Troubleshooting + Removal sections. Full HACS validation now runs with no disabled checks. See CHANGELOG.md.

🤖 Generated with Claude Code

v1.0.0 — Hinen Solar Advanced

Monitoring and control for Hinen solar inverters, PV, and battery storage — via Home Assistant's own Application Credentials + OAuth2 framework, with no third-party Python dependency. Live-verified against a real inverter (76 entities).

Highlights

• Auth rewrite onto HA Application Credentials + OAuth2; region auto-detected from the callback; reauthentication flow. No vendor Python dependency.
• 67 sensors — PV strings, external/AC-coupled PV (e.g. a Solis on the PV meter), grid, battery, temperatures, the full energy-flow matrix, daily & lifetime energy, solar yield, and battery health (SOH, cell voltages/temps).
• 7 controls — Work Mode select + SOC-limit and charge/discharge-power setpoints, with verified writes (set → refresh → read-back; raises if the inverter rejects the change, so automations enforcing charging rules fail loudly instead of silently drifting).
• Quality — real test suite (hass + aioclient_mock, no MagicMock), ~90% coverage; CI runs ruff, pytest, hassfest, HACS validation. Minimum HA 2024.12.0. Can run alongside the official hinen_power integration.

See CHANGELOG.md for full detail.

🤖 Generated with Claude Code

v1.0.0-rc4 - Stable OAuth Auto-Redirect

🎉 RC4 - Stable Release Candidate

This release confirms that automatic OAuth redirect is working perfectly! All core features are now functional and stable.

✨ What Works in RC4

🔐 Seamless OAuth Flow

• Automatic redirect after authorization ✅
• Auto-detection of authorization code ✅
• Smart fallback to manual entry if needed
• No more copy/paste of long authorization codes!

🛡️ Integration Safety

• Conflict detection prevents issues with official Hinen Power integration
• Clear error messages with workaround options
• Prevents confusing "Device Unavailable" errors

📊 Complete Monitoring (35+ Sensors)

• ✅ Battery management (SOC, power, temperature, charging state)
• ✅ PV monitoring (up to 4 strings with voltage, current, power)
• ✅ Grid monitoring (3-phase voltage, current, power, frequency)
• ✅ Energy statistics (daily/total for all categories)
• ✅ Inverter monitoring (temperature, rated power)
• ✅ Binary sensors (online status, battery charging)

⚡ Energy Dashboard Compatible

All sensors work seamlessly with Home Assistant's Energy Dashboard

🚀 Installation

Via HACS (Recommended)

1. Add custom repository: https://github.com/jnctech/hinen-solar-homeassistant
2. Install "Hinen Solar Advanced"
3. Restart Home Assistant

Manual Installation

1. Download hinen-solar-advanced-v1.0.0-rc4.zip
2. Extract to custom_components/hinen/
3. Restart Home Assistant

📝 Setup Instructions

1. Get Developer Credentials

   • Obtain Client ID and Secret from Hinen Developer Platform

2. Add Integration

   • Go to Settings → Devices & Services → Add Integration
   • Search for "Hinen Solar"
   • Enter your Client ID, Client Secret, and Region Code

3. Authorize (NEW: Automatic!)

   • Click the authorization URL
   • Log in and authorize on Hinen platform
   • You'll be redirected back automatically
   • Click Submit (leave code field empty for auto-detect)
   • Done! Devices appear automatically

⚠️ Known Limitations

Cannot run alongside official Hinen Power integration on the same Hinen account due to API session limitations.

Workarounds:

1. Use only Hinen Solar Advanced (remove Hinen Power first)
2. Use only Hinen Power (skip this integration)
3. Use separate Hinen accounts for each integration

See Compatibility section for details.

🌍 Supported Regions

✅ Europe: AU, NZ, GB, DE, FR, ES, IT, NL, BE, SE, AT, CH, PL, PT, IE, DK, FI, NO, GR, CZ
✅ Asia-Pacific: SG, PK
✅ Australia: AU, NZ

🔧 Bug Fixes from RC3

• Fixed exception handling indentation in config flow
• Improved OAuth callback detection logic
• Enhanced error messages for authorization failures
• Updated documentation with clearer setup instructions

🔮 What's Next?

v1.0.0 (Stable) will use the hinen-open-api library (same as official integration) to enable true coexistence with the official Hinen Power integration. No more choosing between integrations!

📊 Testing

Tested and confirmed working on:

• Home Assistant 2024.x
• Multiple regions (AU, GB, DE)
• Various Hinen inverter models

---

Full Changelog: v1.0.0-rc3...v1.0.0-rc4

Report Issues: https://github.com/jnctech/hinen-solar-homeassistant/issues

v1.0.0-rc3 - Automatic OAuth Redirect + Conflict Detection

What's New in RC3

🎯 Automatic OAuth Redirect

• Automatic callback handling - No more manual code copy/paste!
• Auto-detects Home Assistant URL for OAuth redirect
• Configurable redirect URL for external access scenarios
• Seamless authorization flow with auto-closing success page

🛡️ Integration Conflict Detection

• Detects conflicts with official Hinen Power integration
• Prevents installation when conflict exists
• Clear error messages with workaround options
• Protects users from confusing "Device Unavailable" errors

Features (from RC2)

• ✅ 35+ sensors for complete solar system monitoring
• ✅ Battery management (SOC, power, temperature, charging state)
• ✅ PV monitoring (up to 4 strings)
• ✅ Grid monitoring (3-phase voltage, current, power)
• ✅ Energy Dashboard compatible
• ✅ OAuth2 authentication

Known Limitations

• Cannot run alongside official Hinen Power integration on same account
• Use separate Hinen accounts or choose one integration
• See Compatibility section for details

Installation

1. Install via HACS (custom repository)
2. Obtain Client ID and Secret from Hinen Developer Platform
3. Add integration and follow OAuth flow
4. Devices will appear automatically

Supported Regions

✅ AU, NZ, GB, DE, FR, ES, IT, NL, BE, SE, AT, CH, PL, PT, IE, DK, FI, SG, PK, and more!

Future Plans

v1.0.0 will use the hinen-open-api library (same as official integration) to enable true coexistence with official integration.

---

Full Changelog: v1.0.0-rc2...v1.0.0-rc3

v1.0.0-rc2 - Critical Compatibility Fix

🔧 Hinen Solar Advanced v1.0.0-rc2 - Critical Compatibility Fix

🚨 CRITICAL FIX: Integration Compatibility

This release resolves a critical device identifier collision with the official Hinen Power integration that prevented both integrations from running simultaneously.

What Was Fixed

The Problem:

• Both Hinen Solar Advanced and official Hinen Power integration were using the same device_id from the Hinen API
• This caused Home Assistant's device registry to become confused about which integration owned which device
• Result: 500 errors, entity update failures, and broken functionality when both were installed

The Solution:

• Modified device identifiers to include _advanced suffix
• Changed from: identifiers={(DOMAIN, device_id)}
• Changed to: identifiers={(DOMAIN, f"{device_id}_advanced")}

The Result:

• ✅ Both integrations now run perfectly side-by-side
• ✅ No more device registry conflicts
• ✅ No more 500 errors or entity failures
• ✅ Each integration maintains its own separate device entry

---

🎯 Why This Matters

Users can now enjoy the best of both worlds:

Hinen Solar Advanced (this integration):

• 35+ sensors for comprehensive monitoring
• PV string-level data (4 strings)
• 3-phase grid monitoring
• Detailed battery health metrics
• Advanced energy statistics

Official Hinen Power:

• 12 basic sensors
• Control features (work modes, battery settings)
• Simpler setup process

---

📦 Installation Notes

For New Users

Simply install Hinen Solar Advanced v1.0.0-rc2 and it will work correctly whether or not you have the official integration installed.

For Existing Users (Upgrading from RC1)

IMPORTANT: If you previously installed RC1, you must perform a clean installation:

1. Remove Both Integrations:

   • Go to Settings → Devices & Services
   • Remove "Hinen Solar Advanced" integration
   • Remove "Hinen Power" integration (if installed)

2. Delete Old Devices:

   • Go to Settings → Devices & Services → Devices tab
   • Find any Hinen devices and delete them manually

3. Reinstall:

   • Install official Hinen Power first (if desired)
   • Then install Hinen Solar Advanced v1.0.0-rc2
   • Both should load without errors

4. Verify:

   • You should see two separate devices in Home Assistant (one per integration)
   • All entities from both integrations should update successfully
   • Check logs for any errors (there should be none)

✨ What's Included (Same as RC1)

📊 Comprehensive Monitoring

• 35+ sensors for complete solar system visibility
• PV String Monitoring - Track up to 4 solar panel strings individually
• 3-Phase Grid Monitoring - Essential for commercial installations
• Battery Health Tracking - Voltage, current, temperature, and SOC
• Detailed Energy Statistics - Daily, monthly, yearly breakdowns

🔌 Energy Dashboard Compatible

All sensors integrate seamlessly with Home Assistant's Energy Dashboard:

• Solar production tracking
• Battery charge/discharge monitoring
• Grid import/export metering
• Home consumption analysis

🔐 Secure Authentication

• OAuth2 authentication with automatic token refresh
• Multi-region support (Europe, Asia-Pacific, Australia)
• User-provided developer credentials for isolated API quotas

---

📋 Requirements

1. Hinen solar inverter or battery system
2. Developer credentials from Hinen Developer Platform
3. Home Assistant Core 2023.1 or later

---

🚀 Installation

Via HACS (Recommended)

1. Add custom repository: https://github.com/jnctech/hinen-solar-homeassistant
2. Search for "Hinen Solar Advanced" in HACS
3. Click Install
4. Restart Home Assistant

Manual Installation

1. Download hinen-solar-advanced-v1.0.0-rc2.zip
2. Extract to config/custom_components/hinen/
3. Restart Home Assistant

---

📖 Setup Guide

1. Go to Settings → Devices & Services → Add Integration
2. Search for "Hinen Solar Advanced"
3. Enter your Client ID and Client Secret from Hinen Developer Platform
4. Select your region code (e.g., AU, GB, DE)
5. Click the authorization URL to approve access
6. Copy and paste the authorization code
7. Done! Your devices will appear automatically

---

🐛 Changelog

v1.0.0-rc2 (2026-02-04)

• CRITICAL FIX: Device identifier collision with official Hinen Power integration
• Added _advanced suffix to device identifiers for uniqueness
• Updated documentation with compatibility information
• Added CONFLICT_ANALYSIS.md technical documentation

v1.0.0-rc1 (2026-02-03)

• Initial release candidate
• 35+ sensors for comprehensive monitoring
• OAuth2 authentication
• Multi-region support
• Energy Dashboard integration

---

📚 Documentation

• Full Documentation
• Quick Start Guide
• Conflict Analysis
• Issue Tracker

---

🙏 Credits

Built with ❤️ for the Home Assistant community. Special thanks to:

• Hinen for their developer API
• Early RC1 testers who helped identify the compatibility issue
• The Home Assistant community for feedback and support

---

⚠️ Known Issues

None at this time. Please report any issues on the GitHub issue tracker.

---

License: Apache 2.0
Domain: hinen
Compatibility: Home Assistant Core 2023.1+
Status: Release Candidate (testing phase)

Hinen Solar Advanced v1.0.0-rc1 - First Release Candidate

Release v1.0.0-rc1 - Hinen Solar Advanced

🚀 First Release Candidate - Advanced monitoring integration for Hinen solar systems

---

🎯 What is Hinen Solar Advanced?

Hinen Solar Advanced is a comprehensive monitoring integration for Home Assistant that provides 35+ detailed sensors for Hinen solar inverters, battery storage, and PV systems. This integration focuses on advanced monitoring and works alongside the official Hinen Power integration.

Why This Integration?

Official Hinen Power Integration:

• ✅ 12 basic sensors (power, SOC, energy totals)
• ✅ Control features (work modes, charge/discharge settings)
• ✅ Suitable for most users

Hinen Solar Advanced (This Integration):

• ✅ 35+ sensors - 3x more monitoring data
• ✅ PV String Monitoring - Individual tracking of up to 4 solar panel strings
• ✅ 3-Phase Grid Monitoring - Per-phase voltage, current, power, frequency
• ✅ Battery Health Metrics - Voltage, current, temperature, SOC
• ✅ Detailed Energy Statistics - Daily, monthly, yearly, and lifetime totals
• ✅ Binary Sensors - Online status, battery charging state
• ✅ Energy Dashboard Ready - Full compatibility with HA Energy Dashboard

You can run both integrations together for complete coverage!

---

✨ Features

📊 35+ Comprehensive Sensors

Power Monitoring (6 sensors):

• PV Generation Power
• Battery Power (charge/discharge)
• Load Power (consumption)
• Grid Power (import/export)
• Total System Power
• Inverter Output Power

Battery Management (5 sensors):

• State of Charge (SOC)
• Battery Voltage
• Battery Current
• Battery Temperature
• Battery Capacity

PV String Monitoring (12 sensors - 4 strings × 3 metrics):

• PV1-4 Voltage
• PV1-4 Current
• PV1-4 Power

3-Phase Grid Monitoring (10 sensors):

• R/S/T Phase Voltage
• R/S/T Phase Current
• R/S/T Phase Power
• Grid Frequency

Energy Statistics (10+ sensors):

• Daily/Total Consumption
• Daily/Total Generation
• Daily/Total Grid Feed-in
• Daily/Total Energy Purchased
• Daily/Total Battery Charging
• Daily/Total Battery Discharging
• Monthly/Yearly aggregates

Binary Sensors (2):

• Online Status
• Battery Charging State

🌍 Multi-Region Support

Supports all Hinen data centers:

• Europe: 30+ countries (GB, DE, FR, ES, IT, NL, BE, PL, SE, AT, CH, PT, IE, DK, FI, NO, GR, CZ, and more)
• Asia-Pacific: Singapore, Pakistan
• Australia: Australia, New Zealand

🔐 Secure OAuth2 Authentication

• Industry-standard OAuth2 authentication
• Automatic token refresh
• Secure credential storage
• No password storage required

🏠 Energy Dashboard Integration

All sensors properly configured for Home Assistant Energy Dashboard:

• Solar production tracking
• Battery charge/discharge cycles
• Grid import/export monitoring
• Home consumption analysis

---

📋 Prerequisites

Required

1. Hinen Developer Credentials:

   • Contact Hinen technical support for developer platform access
   • Obtain Client ID and Client Secret from Hinen Developer Platform
   • Navigate: Backend Management → Application List

2. Hinen Account:

   • Active account with registered solar devices
   • Accessible via Hinen mobile app

3. Region Code:

   • Know your region (e.g., AU, GB, DE, SG)
   • See supported regions

System Requirements

• Home Assistant 2023.1.0 or later
• HACS (recommended for installation)
• Internet connectivity for cloud API access

---

🚀 Installation

Via HACS (Recommended)

1. Open HACS in Home Assistant
2. Go to Integrations
3. Click ⋮ (three dots) → Custom repositories
4. Add: https://github.com/jnctech/hinen-solar-homeassistant
5. Category: Integration
6. Click Add
7. Search for "Hinen Solar Advanced"
8. Click Download
9. Restart Home Assistant

Manual Installation

1. Download the latest release
2. Extract to config/custom_components/hinen/
3. Restart Home Assistant

---

⚙️ Configuration

Setup Steps

1. Settings → Devices & Services → Add Integration
2. Search for "Hinen Solar Advanced"
3. Enter your Client ID and Client Secret
4. Select your Region
5. Follow the OAuth authorization link
6. Sign in with your Hinen account
7. Copy and paste the authorization code
8. Done! 35+ sensors will appear automatically

Configuration Options

• Scan Interval: 30-300 seconds (default: 60 seconds)
• Configurable via integration options

---

🔧 What's New in RC1

Initial Release Features

✅ Complete OAuth2 Implementation

• Fixed redirectUrl parameter requirement
• Automatic token refresh
• Multi-region support

✅ 35+ Sensors Implemented

• All power, battery, PV, grid sensors
• Energy statistics sensors
• Binary sensors

✅ HACS Compatible

• Custom repository support
• Proper manifest configuration
• Energy Dashboard integration

✅ Comprehensive Documentation

• README with full feature list
• Quick start guide
• Troubleshooting section

Known Limitations (RC1)

⚠️ User Credentials Required:

• Each user must obtain their own Hinen developer credentials
• Contact Hinen support for developer platform access
• Future releases may provide simplified authentication

⚠️ Read-Only Monitoring:

• This integration provides monitoring only
• No control features (work modes, charge settings)
• Use official Hinen Power integration for controls

⚠️ API Rate Limits:

• Default: 2500 requests per 5 minutes per Client ID
• Single user impact: ~0.4% of limit (very safe)
• Each user manages their own quota

---

📊 API Usage

Very Efficient:

• 2 API calls per update cycle
• Default 60s interval: 10 calls per 5 minutes (0.4% of limit)
• Aggressive 30s interval: 20 calls per 5 minutes (0.8% of limit)
• No risk of hitting rate limits for normal usage

---

🐛 Known Issues

OAuth Authorization

• AU region OAuth page previously had JavaScript errors (now fixed with redirectUrl parameter)
• Authorization codes expire in 5-10 minutes (get fresh code if expired)

First-Time Setup

• Developer credentials must be obtained from Hinen support
• May take 1-2 business days for approval

---

🔄 Upgrade Path

This is a new integration - no upgrade from previous versions.

Running Alongside Official Integration:

• Both integrations can coexist safely
• Different domains: hinen vs hinen_power
• No conflicts expected

---

📝 Feedback & Support

This is a Release Candidate - your feedback is valuable!

Report Issues:

• 🐛 GitHub Issues
• Include Home Assistant version, logs, and steps to reproduce

Feature Requests:

• 💡 GitHub Discussions

Documentation:

• 📖 Full README
• 📖 Quick Start Guide

---

🎯 Roadmap to v1.0.0

Before Production Release:

• Gather RC1 user feedback
• Fix any reported bugs
• Investigate simplified authentication options
• Contact Hinen for custom API limit quotation
• Consider shared credentials model (if economical)

Target: v1.0.0 production release after successful RC testing period

---

👏 Acknowledgments

• Thanks to Hinen/celinksmart for API access
• Home Assistant community for integration framework
• Early adopters and testers

---

⚖️ License

Apache License 2.0 - See LICENSE file for details

---

⚠️ Disclaimer

This is an unofficial integration and is not affiliated with or endorsed by Hinen or celinksmart. Use at your own risk. Always verify sensor data against your Hinen mobile app.

---

🔗 Links

• Repository: https://github.com/jnctech/hinen-solar-homeassistant
• Issues: https://github.com/jnctech/hinen-solar-homeassistant/issues
• Official Hinen Power: https://github.com/Hinen-IoT/ha_hinen_power
• Hinen Developer Platform: https://developer.celinksmart.com

---

Installation Command (HACS):

https://github.com/jnctech/hinen-solar-homeassistant

Release Date: February 3, 2026
Version: 1.0.0-rc1
Status: Release Candidate - Early Adopters Welcome!