🚀 Release Candidate 4: This is version 1.0.0-rc4. STABLE: Automatic OAuth redirect + conflict detection with official Hinen Power integration working perfectly!

Advanced monitoring integration for Hinen solar inverters, PV systems, and battery storage. Provides 35+ detailed sensors for power users who want comprehensive monitoring beyond the official integration.

⚠️ COMPATIBILITY NOTICE: This integration cannot run simultaneously with the official Hinen Power integration on the same Hinen account due to API session limitations. See Compatibility section below for details and workarounds.

Official Hinen Power Integration:

• ✅ 12 basic sensors
• ✅ Control features (work modes, charge/discharge settings)
• ✅ Simple setup

Hinen Solar Advanced (This Integration):

• ✅ 35+ sensors - 3x more monitoring data
• ✅ PV String Monitoring - Track each of your 4 solar panel strings individually
• ✅ 3-Phase Grid Monitoring - Essential for commercial installations
• ✅ Battery Health - Voltage, current, temperature tracking
• ✅ Detailed Energy Statistics - Daily, monthly, yearly breakdowns
• ✅ Advanced monitoring for power users and solar enthusiasts

Important: This integration cannot run simultaneously with the official Hinen Power integration when using the same Hinen account.

Why? The Hinen API enforces session limitations that prevent multiple integrations from accessing the same account concurrently. When both are installed:

• One integration will show "Device Unavailable" or "Couldn't connect" errors
• API requests from one integration may invalidate the other's session
• Only one integration can reliably update at a time

Note: The Hinen mobile app CAN run alongside either integration (mobile apps use different API endpoints).

Option 1: Choose One Integration

• Use Hinen Solar Advanced if you want detailed monitoring (35+ sensors)
• Use Hinen Power if you need control features (changing modes, settings)

Option 2: Use Separate Hinen Accounts (Advanced Users)

• Create a second Hinen account
• Share your solar devices to the second account (if supported by Hinen)
• Use one account for Hinen Power, another for Hinen Solar Advanced

Future: We're working on resolving this limitation by using the same underlying API library as the official integration. Track progress in Issue #2.

The integration will automatically detect if Hinen Power is installed and prevent installation to avoid conflicts. If you want to use Hinen Solar Advanced, remove Hinen Power first.

• 📊 35+ Sensors: Comprehensive monitoring of solar, battery, grid, and load
• ☀️ PV String Monitoring: Up to 4 PV strings with voltage, current, and power
• ⚡ 3-Phase Grid Monitoring: Voltage, current, power, and frequency per phase
• 🔋 Battery Health: SOC, voltage, current, temperature, charging state
• 📈 Energy Statistics: Daily, monthly, yearly, and total energy tracking
• 🏠 Energy Dashboard: Full compatibility with Home Assistant energy dashboard
• 🌍 Multi-Region Support: Europe, Asia-Pacific, and Australia data centers
• 🔄 Automatic Token Refresh: Seamless re-authentication
• ✅ OAuth2 Authentication: Secure cloud authentication

1. Open HACS in Home Assistant
2. Go to "Integrations"
3. Click the three dots (⋮) in the top right
4. Select "Custom repositories"
5. Add this repository URL: https://github.com/jnctech/hinen-solar-homeassistant
6. Select category: "Integration"
7. Click "Add"
8. Find "Hinen Solar" in HACS and click "Download"
9. Restart Home Assistant

1. Download the latest release
2. Copy the custom_components/hinen folder to your config/custom_components/ directory
3. Restart Home Assistant

1. Developer Credentials:

   • Contact Hinen technical support to request developer platform access
   • Log in to Hinen Developer Platform
   • Navigate to: Backend Management → Application List
   • Copy your Client ID and Client Secret

2. Hinen Account: Active account with registered solar devices

3. Your Region: Know your region code (e.g., AU, GB, DE, SG) - see supported regions

1. In Home Assistant, go to: Settings → Devices & Services
2. Click + Add Integration
3. Search for "Hinen Solar Advanced"
4. Enter your credentials:
   • Client ID from the developer platform
   • Client Secret from the developer platform
   • Region (e.g., AU for Australia)
5. Click Submit
6. Follow the OAuth authorization link shown
7. Sign in with your Hinen account credentials
8. Authorize the application
9. Copy the authorization code you receive
10. Paste it back into Home Assistant
11. Click Submit

Your 35+ sensors will appear automatically!

Configure the Energy Dashboard (Settings → Dashboards → Energy):

• Solar Production: sensor.{device}_pv_generation_power
• Battery Storage: sensor.{device}_battery_power
• Grid Consumption: sensor.{device}_daily_energy_purchased
• Return to Grid: sensor.{device}_daily_grid_feed_in

🇦🇹 Austria (AT) | 🇧🇪 Belgium (BE) | 🇧🇬 Bulgaria (BG) | 🇨🇭 Switzerland (CH) | 🇨🇾 Cyprus (CY) | 🇨🇿 Czech Republic (CZ) | 🇩🇪 Germany (DE) | 🇩🇰 Denmark (DK) | 🇪🇪 Estonia (EE) | 🇪🇸 Spain (ES) | 🇫🇮 Finland (FI) | 🇫🇷 France (FR) | 🇬🇧 United Kingdom (GB) | 🇬🇷 Greece (GR) | 🇭🇷 Croatia (HR) | 🇭🇺 Hungary (HU) | 🇮🇪 Ireland (IE) | 🇮🇹 Italy (IT) | 🇱🇹 Lithuania (LT) | 🇱🇺 Luxembourg (LU) | 🇱🇻 Latvia (LV) | 🇲🇹 Malta (MT) | 🇳🇱 Netherlands (NL) | 🇵🇱 Poland (PL) | 🇵🇹 Portugal (PT) | 🇷🇴 Romania (RO) | 🇸🇪 Sweden (SE) | 🇸🇮 Slovenia (SI) | 🇸🇰 Slovakia (SK) | 🇺🇦 Ukraine (UA)

🇸🇬 Singapore (SG) | 🇵🇰 Pakistan (PK)

🇦🇺 Australia (AU) | 🇳🇿 New Zealand (NZ)

• ✅ Verify Client ID and Client Secret
• ✅ Check authorization code (ensure no extra spaces)
• ✅ Confirm your account has device access

• ✅ Log in to Hinen mobile app to verify device registration
• ✅ Contact Hinen support for account access verification

• ✅ Check internet connectivity
• ✅ Verify integration status in Settings → Devices & Services
• ✅ Try reloading the integration
• ✅ Check Home Assistant logs for errors

• The integration automatically refreshes tokens
• If issues persist, remove and re-add the integration

• Default: 2500 requests per 5 minutes
• Custom limits: Contact Hinen technical support

• Home Assistant development environment
• Hinen developer account
• Python 3.11+

# Set up development environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install homeassistant

# Run Home Assistant in development mode
hass -c config

• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Start a discussion
• 📖 Documentation: Wiki

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

MIT License - see LICENSE file for details

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

This is an unofficial integration and is not affiliated with or endorsed by Hinen or celinksmart.