fix(1P): ac power scaling (#123)

* fix(1P): scale AC power registers by register 54 (AC power ratio)

Per the V119 protocol, the AC power registers 167-169 (grid), 170-172
(external CT) and 176-178 (load) are reported in units of register 54
(1W or 10W per LSB). Read register 54 as an "AC Power Ratio" sensor and
multiply those power sensors by it, so values match the inverter display
(e.g. External CT Power 875 -> 8750 when the ratio is 10). Falls back to
the raw value while the ratio is unread.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* refactor(1P): only scale AC power on known ratio, hoist lambda into substitution

Per PR #123 review: guard the register 54 multiply so it only applies on a
verified 10W/LSB value and passes raw watts through otherwise. Confirmed on
hardware: SG02 10kW reports ratio 10 (10W units), SG04 6kW reports 0 (1W
units). NaN == 10.0f is false, so the not-yet-read state needs no isnan check.
Lambda hoisted into a substitution following the tou.yaml pattern.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(1P): mark AC power ratio register 54 as internal

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: SupermotoJerry

pv_inverter/packages/deye_hybrid_1p/grid.yaml

@@ -12,6 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+substitutions:
+  # Register 54 = "AC power ratio". Only scale when it reads a known 10W/LSB
+  # value; pass raw watts through otherwise (covers 1, 0/unsupported and the
+  # not-yet-read NaN state).
+  func_scale_ac_power: "return (id(ac_power_ratio).state == 10.0f) ? x * 10.0f : x;"
+
 globals:
   - id: last_total_energy_bought
     type: float
@@ -21,11 +27,29 @@ globals:
     restore_value: yes
 
 sensor:
+  # Register 54 = "AC power ratio". Per the V119 protocol, the AC power registers
+  # 167-169, 170-172 and 176-178 are reported in units of this value (1W or 10W
+  # per LSB). Verified on hardware: SG02 10kW reads 10 (10W units), SG04 6kW
+  # reads 0 (1W units) - so only a value of 10 triggers scaling.
+  - platform: modbus_controller
+    modbus_controller_id: ${modbus_controller_id}
+    name: "AC Power Ratio"
+    id: ac_power_ratio
+    register_type: holding
+    address: 54
+    value_type: U_WORD
+    accuracy_decimals: 0
+    entity_category: diagnostic
+    icon: "mdi:multiplication"
+    internal: true
+
   - platform: modbus_controller
     modbus_controller_id: ${modbus_controller_id}
     name: "Grid L1 Power"
     register_type: holding
     address: 167
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"
@@ -38,6 +62,8 @@ sensor:
     name: "Grid L2 Power"
     register_type: holding
     address: 168
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"
@@ -50,6 +76,8 @@ sensor:
     name: "Grid Power"
     register_type: holding
     address: 169
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"
@@ -208,6 +236,8 @@ sensor:
     name: "External CT L1 Power"
     register_type: holding
     address: 170
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     accuracy_decimals: 0
@@ -219,6 +249,8 @@ sensor:
     name: "External CT L2 Power"
     register_type: holding
     address: 171
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     accuracy_decimals: 0
@@ -230,6 +262,8 @@ sensor:
     name: "External CT Power"
     register_type: holding
     address: 172
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     accuracy_decimals: 0

pv_inverter/packages/deye_hybrid_1p/load.yaml

@@ -11,6 +11,13 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
+
+substitutions:
+  # Register 54 = "AC power ratio" (defined in grid.yaml). Only scale when it
+  # reads a known 10W/LSB value; pass raw watts through otherwise (covers 1,
+  # 0/unsupported and the not-yet-read NaN state).
+  func_scale_ac_power: "return (id(ac_power_ratio).state == 10.0f) ? x * 10.0f : x;"
+
 sensor:
   - platform: modbus_controller
     modbus_controller_id: ${modbus_controller_id}
@@ -43,6 +50,8 @@ sensor:
     name: "Load L1 Power"
     register_type: holding
     address: 176
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"
@@ -55,6 +64,8 @@ sensor:
     name: "Load L2 Power"
     register_type: holding
     address: 177
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"
@@ -67,6 +78,8 @@ sensor:
     name: "Load Power"
     register_type: holding
     address: 178
+    filters:
+      - lambda: ${func_scale_ac_power}
     unit_of_measurement: "W"
     device_class: power
     state_class: "measurement"