fix: fill profile implements

Author: kulti

README.md

@@ -46,6 +46,8 @@ The blueprint is an entity containing all aspects pertaining to device integrati
 - [`manifest.yml`](https://developers.enapter.com/docs/reference) describes your device interfaces (telemetry it sends, commands it executes, alerts it raises);
 - `firmware.lua` implements these interfaces for the specific piece of hardware using the [Lua](https://www.lua.org) programming language and high-level platform APIs.
 
+Blueprints can implement [profiles](https://github.com/Enapter/profiles) — standardized interfaces that define common telemetry, properties, and commands for specific device categories (e.g. battery inverters, PV inverters). When a blueprint declares a profile in its `implements` section, it must provide all telemetry defined by that profile with matching types and enum values.
+
 There are two types of hardware that can run your blueprint:
 
 - a physical [Enapter UCM](https://handbook.enapter.com/modules/modules.html) that implements communication through [RS-485](https://handbook.enapter.com/modules/ENP-RS485/ENP-RS485.html), [CAN](https://handbook.enapter.com/modules/ENP-CAN/ENP-CAN.html), your own hardware based on [UCM Kit](https://go.enapter.com/ucmkit-enpkit) and other standards,

battery_inverters/sma_sunny_island_v3/manifest.yml

@@ -73,9 +73,14 @@ properties:
       - flow
       - sodium_based
       - other
+  battery_nominal_voltage:
+    display_name: Battery Nominal Voltage
+    description: Nominal DC bus voltage of the battery system.
+    type: float
+    unit: V
   battery_nameplate_capacity:
     display_name: Battery Nameplate Capacity
-    type: float
+    type: integer
     unit: Wh
   country_code:
     display_name: Country Code
@@ -91,59 +96,91 @@ telemetry:
   status:
     display_name: Status
     type: string
-    description: Current operational status of the inverter
     enum:
-      "off":
-        display_name: "Off"
-        color: purple-lighter
-        description: Inverter is switched off
+      - standby
+      - fault
+      - waiting_pv_voltage
+      - start
+      - shutdown
+      - waiting_utilities
+      - bolted
+      - standalone
+      - derating
+      - mpp
+      - "off"
+      - stop
+      - const_voltage
+      - warning
+      - run
+  inverter_status:
+    display_name: Inverter Status
+    type: string
+    description: Current operational status of the inverter.
+    enum:
+      idle:
+        display_name: Idle
+        description: >
+          Inverter is powered and ready to operate but is not converting power.
+          It will not start until commanded by a user or a rule.
       standby:
         display_name: Standby
-        color: blue
         description: >
-          Inverter is in standby mode waiting for startup conditions.
+          Inverter is not converting power but will autonomously resume
+          operation when conditions are met. No command is required.
       starting:
         display_name: Starting
-        color: pink-light
-        description: Inverter is going through startup procedure
+        description: >
+          Inverter is executing its startup sequence.
       operating:
         display_name: Operating
-        color: cyan
-        description: Inverter is actively operating
-      shutting_down:
-        display_name: Shutting Down
-        color: pink-light
-        description: Inverter is going through shutdown procedure
+        description: >
+          Inverter is actively converting power at its operating setpoint.
+      throttled:
+        display_name: Throttled
+        description: >
+          Inverter is operating at reduced power output due to an external
+          constraint or internal condition.
+      stopping:
+        display_name: Stopping
+        description: >
+          Inverter is executing a controlled stop sequence.
       fault:
         display_name: Fault
-        color: red
-        description: Inverter has detected a fault and is not operating
+        description: >
+          Inverter has detected a condition that prevents normal operation.
+          Operator attention is required before the device can resume.
+      maintenance:
+        display_name: Maintenance
+        description: >
+          Inverter is in a maintenance or configuration mode.
+  battery_charge_status:
+    display_name: Battery Charge Status
+    type: string
+    description: Current charge direction or mode of the battery.
+    implements:
+      - lib.energy.battery.charge_status.battery_charge_status
+    enum:
+      idle:
+        display_name: Idle
+        description: Battery is not charging or discharging.
+      charging:
+        display_name: Charging
+        description: Battery is actively absorbing energy.
+      discharging:
+        display_name: Discharging
+        description: Battery is actively delivering energy.
+      float:
+        display_name: Float
+        description: >
+          Battery is fully charged and receiving trickle current to
+          maintain full state of charge.
   health:
     display_name: Health Status
     type: string
     enum:
       - ok
       - warning
       - fault
-  operating_status:
-    display_name: Operating Status
-    type: string
-    enum:
-      - standby
-      - fault
-      - waiting_pv_voltage
-      - start
-      - shutdown
-      - waiting_utilities
-      - bolted
-      - standalone
-      - derating
-      - mpp
-      - "off"
-      - stop
-      - const_voltage
-      - warning
-      - run
   recom_action:
     display_name: Recommended Action
     type: string
@@ -251,10 +288,11 @@ telemetry:
   ac_power_factor:
     display_name: AC Power Factor
     type: float
+    unit: "1"
   residual_current:
     display_name: Residual Current
     type: float
-    unit: A
+    unit: mA
     implements: lib.energy.inverter.residual_current.inverter_residual_current
   internal_temperature:
     display_name: Internal Temperature

battery_inverters/sma_sunny_island_v3/src/main.lua

@@ -55,7 +55,8 @@ function send_properties()
   properties.inverter_nameplate_capacity = 8000
   properties.grid_mode = 'off_grid'
   properties.battery_type = parse_battery_type(conn:read_u32_enum(40035))
-  properties.battery_nameplate_capacity = (conn:read_u32_fix0(40031) or 0) * 48
+  properties.battery_nominal_voltage = 48
+  properties.battery_nameplate_capacity = (conn:read_u32_fix0(40031) or 0) * properties.battery_nominal_voltage
   properties.country_code = parse_country_code(conn:read_u32_fix0(40109))
   if conn_cfg then
     properties.address = conn_cfg.address
@@ -87,9 +88,10 @@ function send_realtime_telemetry()
   local telemetry = {
     alerts = parse_alerts(conn:read_u32_enum(30213), conn:read_u32_enum(30247)),
     health = parse_health_status(conn:read_u32_enum(30201)),
-    status = convert_operating_status_to_status(operating_status),
-    operating_status = operating_status,
+    status = operating_status,
+    inverter_status = to_inverter_status(operating_status),
 
+    battery_charge_status = to_battery_charge_status(battery_current),
     battery_soc = conn:read_u32_fix0(30845),
     battery_soh = conn:read_u32_fix0(30847),
     battery_voltage = battery_voltage,
@@ -134,7 +136,7 @@ function send_detailed_telemetry()
     ac_power_apparent = conn:read_s32_fix0(30813),
     ac_power_factor = conn:read_u32_fix3(30949),
 
-    residual_current = conn:read_s32_fix3(31247),
+    residual_current = (conn:read_s32_fix3(31247) or 0) * 1000,
     internal_temperature = conn:read_s32_fix1(34113),
 
     load_power = conn:read_s32_fix0(30861),
@@ -239,30 +241,41 @@ function parse_operating_status(value)
   return tostring(value)
 end
 
-function convert_operating_status_to_status(value)
+function to_inverter_status(value)
   if not value then
     return
   end
 
   if value == 'off' or value == 'stop' then
-    return 'off'
+    return 'idle'
   elseif value == 'standby' or value == 'waiting_pv_voltage' or value == 'waiting_utilities' or value == 'bolted' then
     return 'standby'
   elseif value == 'start' then
     return 'starting'
-  elseif
-    value == 'derating'
-    or value == 'mpp'
-    or value == 'run'
-    or value == 'standalone'
-    or value == 'const_voltage'
-    or value == 'warning'
-  then
+  elseif value == 'run' or value == 'mpp' or value == 'const_voltage' or value == 'warning' then
     return 'operating'
+  elseif value == 'derating' then
+    return 'throttled'
   elseif value == 'shutdown' then
-    return 'shutting_down'
+    return 'stopping'
   elseif value == 'fault' then
     return 'fault'
+  else
+    enapter.log('unmapped vendor status: ' .. tostring(value), 'warn')
+  end
+end
+
+function to_battery_charge_status(current)
+  if not current then
+    return
+  end
+
+  if current > 0 then
+    return 'charging'
+  elseif current < 0 then
+    return 'discharging'
+  else
+    return 'idle'
   end
 end
 

power_meters/schneider_electric_pm2100_v3/manifest.yml

@@ -65,6 +65,7 @@ telemetry:
     type: float
     unit: Wh
     display_name: Active Energy Consumed by Loads
+    implements: energy.power_meter.ac.3_phase.energy_lifetime
   total_power:
     type: float
     unit: W

solar_inverters/deye_sunsynk/main.lua

@@ -112,6 +112,7 @@ function parse_metrics1(telemetry, data)
   local base = 500
   telemetry.grid_status = get_grid_status(data, base)
   telemetry.status = get_device_status(data, base)
+  telemetry.inverter_status = to_inverter_status(telemetry.status)
   telemetry.alerts = get_alerts(data, base)
   -- XXX: check again on low/high word registers
   telemetry.internal_temperature = data[540 - base + 1] * 0.1 - 100
@@ -122,6 +123,7 @@ function parse_metrics1(telemetry, data)
   telemetry.battery_soc = data[588 - base + 1]
   telemetry.battery_power = s16(data[590 - base + 1])
   telemetry.battery_current = s16(data[591 - base + 1]) * 0.01
+  telemetry.battery_charge_status = to_battery_charge_status(telemetry.battery_power)
 
   telemetry.battery_charged_energy_total = ((data[517 - base + 1] << 16) + data[516 - base + 1]) * 0.1 * 1000
   telemetry.battery_discharged_energy_total = ((data[519 - base + 1] << 16) + data[518 - base + 1]) * 0.1 * 1000
@@ -215,6 +217,38 @@ function get_device_status(data, base)
   end
 end
 
+function to_battery_charge_status(power)
+  if not power then
+    return
+  end
+
+  if power > 0 then
+    return 'charging'
+  elseif power < 0 then
+    return 'discharging'
+  else
+    return 'idle'
+  end
+end
+
+function to_inverter_status(value)
+  if not value then
+    return
+  end
+
+  if value == 'standby' then
+    return 'standby'
+  elseif value == 'starting' then
+    return 'starting'
+  elseif value == 'operating' then
+    return 'operating'
+  elseif value == 'fault' then
+    return 'fault'
+  else
+    enapter.log('unmapped vendor status: ' .. tostring(value), 'warn')
+  end
+end
+
 function get_alerts(data, base)
   if not data then
     return