SAJ Monitor v0.1.4

SAJ Monitor v0.1.4

Added

• Added local Home Assistant brand images for the custom integration page.
• Includes brand/icon.png, brand/icon@2x.png, brand/logo.png, and brand/logo@2x.png for Home Assistant 2026.3+ local brand image support.

Notes

• This is a UI/packaging update only. The SEC KPI and TNB Domestic ToU + NEM sensors from v0.1.3 are unchanged.

SAJ Monitor v0.1.3

SAJ Monitor v0.1.3

Added

• eSolar SEC/load-monitoring KPI sensors for plants with working plant-level secData access:
  • SEC Last Data Time
  • SEC Data Age
  • SEC Load Self Consumed Energy
  • SEC Self Consumption Rate
  • SEC Solar Offset Rate
• Estimated TNB ToU NEM Cost Today sensor.
• Internal scripts/check_esolar_sec_openapi.py probe script for safely checking SAJ eSolar SEC OpenAPI access without printing secrets.

Changed

• Home Load Power now prefers official eSolar SEC loadPower when available.
• Home Load Power now exposes source metadata:
  • source: sec, estimated: false for official SEC load data
  • fallback source values for inverter-derived estimates
• Replaced the old flat RM/kWh import-cost estimate with a Domestic ToU + NEM bill-derived estimate model.
• Bumped integration version to 0.1.3.

Notes

• The TNB ToU/NEM cost sensor is intentionally marked as estimated because SAJ SEC provides daily total import/export energy, not peak/off-peak bucketed energy.
• Use plant-level secData for SEC load monitoring. Continue using inverter/device SN for realtime, history, and device-info endpoints.

SAJ Monitor v0.1.2

Release 0.1.2

This release focuses on significant enhancements to the binary sensors, improving clarity, accuracy, and organization for device connection statuses.

Key Changes:

• Improved Status Display: Connection status binary sensors now display "Online" or "Offline" instead of "Connected"/"Disconnected" for a more intuitive user experience.
• Enhanced Battery Inverter Status: The connection status for battery inverters now more accurately reflects their true online/offline state based on API data.
• Distinct Entity IDs: Implemented separate and more descriptive entity IDs for battery inverter status (e.g., binary_sensor.your_device_battery_inverter_status) and solar inverter status (e.g., binary_sensor.your_device_solar_inverter_status), making them easier to identify and manage.
• Clearer Solar Nighttime Context: Added specific logic and state attributes to clarify that solar inverters are normally "Offline" during nighttime. This includes an is_nighttime attribute and a note for better context.
• Refined Debug Logging: Debug logging for binary sensors has been improved to be more contextual and less redundant.
• Version Bump: Updated the integration version to 0.1.2 in manifest.json.

These changes aim to provide a more robust and user-friendly experience when monitoring your SAJ devices.

SAJ Monitor v0.1.1

This release brings significant improvements to the SAJ Monitor integration for Home Assistant, enhancing support for both solar inverters and battery systems.

New Features

• Improved nighttime operation for solar inverters with graceful fallback to load monitoring data
• Enhanced battery system monitoring with comprehensive metrics
• Added environmental impact sensors (CO2 reduction, equivalent trees)
• Added financial metrics (estimated annual savings)
• Better error handling for API communication

Technical Improvements

• Optimized API requests with intelligent data source selection
• Reduced API calls during nighttime for solar systems
• More robust data processing with fallbacks for missing values
• Extended logging for easier troubleshooting

Installation

You can install this integration through HACS by adding this repository as a custom repository, or manually by copying the custom_components/saj_monitor directory to your Home Assistant configuration.

Documentation

See the README.md for full installation and configuration instructions.

Feedback

If you encounter any issues or have suggestions for improvements, please open an issue on GitHub.