@rhizomatics/signalk-bluetti-plugin 1.4.1 → 1.5.1

package/devices/ep500p.yaml

@@ -0,0 +1,57 @@
+# Bluetti EP500P register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/ep500p.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  battery_soc:
+    register: 43
+    unit: "%"
+  dc_input_power:
+    register: 36
+    unit: W
+  ac_input_power:
+    register: 37
+    unit: W
+  ac_output_power:
+    register: 38
+    unit: W
+  dc_output_power:
+    register: 39
+    unit: W
+  ac_output_voltage:
+    register: 71
+    scale: 0.1
+    unit: V
+  ac_output_frequency:
+    register: 74
+    scale: 0.01
+    unit: Hz
+  ac_input_voltage:
+    register: 77
+    scale: 0.1
+    unit: V
+  ac_input_frequency:
+    register: 80
+    scale: 0.01
+    unit: Hz
+  dc_input_voltage:
+    register: 86
+    scale: 0.1
+    unit: V
+  dc_input_current:
+    register: 88
+    scale: 0.1
+    unit: A
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: EP500P

package/devices/ep600.yaml

@@ -0,0 +1,151 @@
+# Bluetti EP600 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/ep600.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  battery_soc:
+    register: 102
+    unit: "%"
+  power_generation:
+    register: 1202
+    scale: 0.1
+    unit: kWh
+  dc_input_power:
+    register: 1212
+    unit: W
+  dc_input_voltage:
+    register: 1213
+    scale: 0.1
+    unit: V
+  dc_input_current:
+    register: 1214
+    scale: 0.1
+    unit: A
+  pv_s2_power:
+    register: 1220
+    unit: W
+  pv_s2_voltage:
+    register: 1221
+    scale: 0.1
+    unit: V
+  pv_s2_current:
+    register: 1222
+    scale: 0.1
+    unit: A
+  sm_p1_power:
+    register: 1228
+    unit: W
+  sm_p1_voltage:
+    register: 1229
+    scale: 0.1
+    unit: V
+  sm_p1_current:
+    register: 1230
+    unit: A
+  sm_p2_power:
+    register: 1236
+    unit: W
+  sm_p2_voltage:
+    register: 1237
+    scale: 0.1
+    unit: V
+  sm_p2_current:
+    register: 1238
+    unit: A
+  sm_p3_power:
+    register: 1244
+    unit: W
+  sm_p3_voltage:
+    register: 1245
+    scale: 0.1
+    unit: V
+  sm_p3_current:
+    register: 1246
+    unit: A
+  grid_frequency:
+    register: 1300
+    scale: 0.1
+    unit: Hz
+  grid_p1_power:
+    register: 1313
+    unit: W
+  grid_p1_voltage:
+    register: 1314
+    scale: 0.1
+    unit: V
+  grid_p1_current:
+    register: 1315
+    scale: 0.1
+    unit: A
+  grid_p2_power:
+    register: 1319
+    unit: W
+  grid_p2_voltage:
+    register: 1320
+    scale: 0.1
+    unit: V
+  grid_p2_current:
+    register: 1321
+    scale: 0.1
+    unit: A
+  grid_p3_power:
+    register: 1325
+    unit: W
+  grid_p3_voltage:
+    register: 1326
+    scale: 0.1
+    unit: V
+  grid_p3_current:
+    register: 1327
+    scale: 0.1
+    unit: A
+  ac_output_frequency:
+    register: 1500
+    scale: 0.1
+    unit: Hz
+  ac_p1_power:
+    register: 1510
+    unit: W
+  ac_p1_voltage:
+    register: 1511
+    scale: 0.1
+    unit: V
+  ac_p1_current:
+    register: 1512
+    scale: 0.1
+    unit: A
+  ac_p2_power:
+    register: 1517
+    unit: W
+  ac_p2_voltage:
+    register: 1518
+    scale: 0.1
+    unit: V
+  ac_p2_current:
+    register: 1519
+    scale: 0.1
+    unit: A
+  ac_p3_power:
+    register: 1524
+    unit: W
+  ac_p3_voltage:
+    register: 1525
+    scale: 0.1
+    unit: V
+  ac_p3_current:
+    register: 1526
+    scale: 0.1
+    unit: A
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: EP600

package/devices/ep760.yaml

@@ -0,0 +1,72 @@
+# Bluetti EP760 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/ep760.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  battery_soc:
+    register: 102
+    unit: "%"
+  dc_input_power:
+    register: 1212
+    unit: W
+  dc_input_voltage:
+    register: 1213
+    scale: 0.1
+    unit: V
+  dc_input_current:
+    register: 1214
+    scale: 0.1
+    unit: A
+  sm_p1_power:
+    register: 1228
+    unit: W
+  sm_p1_voltage:
+    register: 1229
+    scale: 0.1
+    unit: V
+  sm_p1_current:
+    register: 1230
+    unit: A
+  ac_input_frequency:
+    register: 1300
+    scale: 0.1
+    unit: Hz
+  ac_input_power:
+    register: 1313
+    unit: W
+  ac_input_voltage:
+    register: 1314
+    scale: 0.1
+    unit: V
+  ac_input_current:
+    register: 1315
+    scale: 0.1
+    unit: A
+  ac_output_frequency:
+    register: 1500
+    scale: 0.1
+    unit: Hz
+  ac_output_power:
+    register: 1510
+    unit: W
+  ac_output_voltage:
+    register: 1511
+    scale: 0.1
+    unit: V
+  ac_output_current:
+    register: 1512
+    scale: 0.1
+    unit: A
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: EP760

package/devices/ep800.yaml

@@ -0,0 +1,21 @@
+# Bluetti EP800 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/ep800.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  battery_soc:
+    register: 102
+    unit: "%"
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: EP800

package/devices/handsfree1.yaml

@@ -0,0 +1,62 @@
+# Bluetti HANDSFREE1 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/handsfree1.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  dc_output_power:
+    register: 140
+    unit: W
+  ac_output_power:
+    register: 142
+    unit: W
+  dc_input_power:
+    register: 144
+    unit: W
+  ac_input_power:
+    register: 146
+    unit: W
+  time_remaining_minutes:
+    register: 104
+    scale: 6
+    unit: min
+  dc_input_voltage:
+    register: 1213
+    scale: 0.1
+    unit: V
+  dc_input_current:
+    register: 1214
+    scale: 0.1
+    unit: A
+  ac_input_frequency:
+    register: 1300
+    scale: 0.1
+    unit: Hz
+  ac_input_voltage:
+    register: 1314
+    scale: 0.1
+    unit: V
+  ac_input_current:
+    register: 1315
+    scale: 0.1
+    unit: A
+  ac_output_frequency:
+    register: 1500
+    scale: 0.1
+    unit: Hz
+  ac_output_voltage:
+    register: 1511
+    scale: 0.1
+    unit: V
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: Handsfree 1

package/devices/pr100v2.yaml

@@ -0,0 +1,34 @@
+# Bluetti PR100V2 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/pr100v2.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  dc_output_power:
+    register: 140
+    unit: W
+  ac_output_power:
+    register: 142
+    unit: W
+  dc_input_power:
+    register: 144
+    unit: W
+  ac_input_power:
+    register: 146
+    unit: W
+  ac_input_voltage:
+    register: 1314
+    scale: 0.1
+    unit: V
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: PR100 V2

package/devices/pr30v2.yaml

@@ -0,0 +1,34 @@
+# Bluetti PR30V2 register map
+# Source: https://github.com/Patrick762/bluetti-bt-lib (bluetti_bt_lib/devices/pr30v2.py)
+#
+# field_name is a standard Bluetti register name — the code maps these to
+# SignalK paths on its own (see lib/path-mapper.js). `path` on a field is an
+# override, only needed if you're exposing a register the code doesn't
+# recognise. `constants` are fixed, non-register facts about this model —
+# a bare scalar (string/number) or { value, unit } for one that needs unit
+# conversion (e.g. total_capacity in Wh -> J). No verified nominal capacity
+# is bundled for most models — add a total_capacity constant yourself if you
+# know it, to enable the derived remaining-capacity calculation.
+#
+
+fields:
+  dc_output_power:
+    register: 140
+    unit: W
+  ac_output_power:
+    register: 142
+    unit: W
+  dc_input_power:
+    register: 144
+    unit: W
+  ac_input_power:
+    register: 146
+    unit: W
+  ac_input_voltage:
+    register: 1314
+    scale: 0.1
+    unit: V
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: PR30 V2

package/docs/assets/icon.svg

@@ -0,0 +1,36 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#0f4c5c"/>
+      <stop offset="1" stop-color="#093542"/>
+    </linearGradient>
+    <linearGradient id="body" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#f4f6f7"/>
+      <stop offset="1" stop-color="#d7dde0"/>
+    </linearGradient>
+  </defs>
+
+  <!-- app icon background -->
+  <rect x="0" y="0" width="256" height="256" rx="48" fill="url(#bg)"/>
+
+  <!-- power station body -->
+  <rect x="56" y="58" width="144" height="132" rx="14" fill="url(#body)" stroke="#093542" stroke-width="4"/>
+
+  <!-- display -->
+  <rect x="74" y="74" width="56" height="34" rx="6" fill="#0f4c5c"/>
+  <!-- battery glyph inside display -->
+  <rect x="82" y="85" width="30" height="12" rx="2" fill="none" stroke="#7fd8c4" stroke-width="2.5"/>
+  <rect x="113" y="88.5" width="4" height="5" fill="#7fd8c4"/>
+  <rect x="85" y="88" width="18" height="6" fill="#7fd8c4"/>
+
+  <!-- lightning bolt -->
+  <path d="M156 72 L138 104 h14 l-6 30 26 -38 h-15 z" fill="#f4a340" stroke="#093542" stroke-width="3" stroke-linejoin="round"/>
+
+  <!-- ports along the bottom edge -->
+  <circle cx="80" cy="166" r="10" fill="none" stroke="#093542" stroke-width="4"/>
+  <circle cx="80" cy="166" r="3.5" fill="#093542"/>
+  <rect x="106" y="158" width="20" height="16" rx="3" fill="none" stroke="#093542" stroke-width="4"/>
+  <rect x="142" y="156" width="26" height="20" rx="3" fill="none" stroke="#093542" stroke-width="4"/>
+  <rect x="150" y="162" width="3.5" height="8" fill="#093542"/>
+  <rect x="157" y="162" width="3.5" height="8" fill="#093542"/>
+</svg>

package/docs/examples/model_definition.yaml

@@ -0,0 +1,112 @@
+# Example register map for a Bluetti device this plugin doesn't bundle yet.
+#
+# Drop a copy of this file (renamed, e.g. my-device.yaml) into your custom
+# register maps directory — see the plugin's "Custom register maps directory"
+# setting, which defaults to <SignalK home>/bluetti (e.g. ~/.signalk/bluetti)
+# — and it'll show up in the "Register map" dropdown for a device, keyed by
+# its filename (without .yaml).
+#
+# Two top-level keys:
+#
+#   fields:    one entry per live Modbus holding register on the device.
+#              The key is the field name; standard names (see lib/path-mapper.js's
+#              STANDARD_FIELD_PATHS) are resolved to a SignalK path automatically —
+#              use whichever of these match what your device actually reports.
+#              Any other name gets a best-effort guess, or set `path:` explicitly.
+#
+#     <field_name>:
+#       register: <number>     # Modbus holding register address (required)
+#       type: uint16            # uint16 (default) | int16 | uint32 | int32 | float32 | bool
+#       count: <number>         # registers this field spans; inferred from `type` if omitted
+#       scale: <number>         # multiply the raw value by this (default 1)
+#       offset: <number>        # add after scaling (default 0)
+#       unit: V                 # V | A | W | Wh | kWh | % | °C | Hz | min — drives SignalK unit conversion
+#       path: electrical.batteries.{name}.voltage   # optional override; {name} is the per-device name from config
+#
+#   constants: fixed, non-register facts about this model — a bare scalar
+#              (string or number) or, for a number that needs unit conversion
+#              (e.g. a capacity in Wh), an expanded { value, unit } form.
+#
+# Standard field names worth knowing: battery_soc, battery_voltage,
+# battery_current, battery_power, battery_temperature, dc_input_power/voltage/current
+# (solar), ac_output_power/voltage/current/frequency (inverter), ac_input_power/
+# voltage/current/frequency (mains charger), time_remaining_minutes,
+# total_capacity, battery_chemistry, battery_manufacturer_name, battery_manufacturer_model.
+
+fields:
+  battery_percent:
+    register: 100
+    unit: "%"
+  battery_voltage:
+    register: 101
+    scale: 0.1
+    unit: V
+  battery_current:
+    register: 102
+    type: int16
+    scale: 0.1
+    unit: A
+  battery_power:
+    register: 103
+    type: int16
+    unit: W
+  battery_temperature:
+    register: 104
+    scale: 0.1
+    unit: "°C"
+  dc_input_power:
+    register: 107
+    unit: W
+  dc_input_voltage:
+    register: 108
+    scale: 0.1
+    unit: V
+  dc_input_current:
+    register: 109
+    scale: 0.1
+    unit: A
+  ac_output_power:
+    register: 110
+    unit: W
+  ac_output_voltage:
+    register: 111
+    scale: 0.1
+    unit: V
+  ac_output_current:
+    register: 112
+    scale: 0.1
+    unit: A
+  ac_output_frequency:
+    register: 113
+    scale: 0.1
+    unit: Hz
+  ac_input_power:
+    register: 114
+    unit: W
+  ac_input_voltage:
+    register: 115
+    scale: 0.1
+    unit: V
+  ac_input_current:
+    register: 116
+    scale: 0.1
+    unit: A
+  ac_input_frequency:
+    register: 117
+    scale: 0.1
+    unit: Hz
+  internal_temperature:
+    register: 118
+    scale: 0.1
+    unit: "°C"
+  time_remaining_minutes:
+    register: 119
+    unit: min
+
+constants:
+  battery_chemistry: LiFePO4
+  battery_manufacturer_name: Bluetti
+  battery_manufacturer_model: My Device
+  total_capacity:
+    value: 2000
+    unit: Wh