SENEC.Home G3 lokālais JSON API: baterijas SOC un tīkla jauda uz KNX

SENEC.Home lokālā API pārskats

SENEC.Home G3 (5/10/15 kWh), V3 Hybrid (5-15 kWh), and V4 all expose a local JSON API at 'http://[senec-ip]:7001/lala.cgi'. This API is unauthenticated and accessible on the local LAN — no cloud dependency. It uses HTTP POST with a JSON body that specifies which data fields to return.

API ir pirms mūsdienu REST konvencijām: jūs nosūtāt POST ar JSON objektu, kur lauku vērtības ir tukšas, un atbilde atgriež šos laukus ar pašreizējiem sensoru rādījumiem.

API aptaujāšana: pieprasījuma struktūra

POST http://192.168.1.200:7001/lala.cgi
Content-Type: application/json

Request body:
{
  "ENERGY": {
    "GUI_BAT_DATA_POWER": "",
    "GUI_BAT_DATA_FUEL_CHARGE": "",
    "GUI_HOUSE_POW": "",
    "GUI_GRID_POW": "",
    "GUI_INVERTER_POWER": "",
    "STAT_STATE": ""
  }
}

Response fields:
  GUI_BAT_DATA_POWER     — battery power (W, float; positive=charging, negative=discharging)
  GUI_BAT_DATA_FUEL_CHARGE — battery SOC (%, float 0.0-100.0)
  GUI_HOUSE_POW          — house consumption (W, float)
  GUI_GRID_POW           — grid power (W, float; positive=import, negative=export)
  GUI_INVERTER_POWER     — PV inverter DC output (W, float; V3 Hybrid and V4 only)
  STAT_STATE             — operating state number (see table below)

Node-RED integrācijas plūsma

Prerequisite: install 'node-red-node-http-request' (built-in) and 'node-red-contrib-knx-ultimate' or standard KNX Classic nodes.

Plūsma: Inject (30 s intervāls) → HTTP Request (metode POST, URL http://192.168.1.200:7001/lala.cgi, ķermenis no msg.payload — inject iestata payload kā JSON virkni) → JSON parse → Function (izvilkt vērtības un nosūtīt uz KNX) → KNX Out.

const energy = msg.payload.ENERGY;
const soc = parseFloat(energy.GUI_BAT_DATA_FUEL_CHARGE);
const batPower = parseFloat(energy.GUI_BAT_DATA_POWER);
const gridPower = parseFloat(energy.GUI_GRID_POW);
node.send([
    { payload: soc,               topic: "6/4/3" },  // SOC DPT 5.001
    { payload: batPower / 1000,   topic: "6/4/4" },  // Battery kW DPT 9.001
    { payload: gridPower / 1000,  topic: "6/4/5" }   // Grid kW DPT 9.001
]);

KNX grupu adreses: 6/4/3 (akumulatora SOC DPT 5.001), 6/4/4 (akumulatora jauda kW DPT 9.001), 6/4/5 (tīkla jauda kW DPT 9.001 — negatīva vērtība norāda eksportu uz tīklu).

ioBroker SENEC adapteris

Install ioBroker adapter 'senec' (iobroker.senec). Configuration: enter SENEC IP address in adapter settings. Adapter polls port 7001 every 10s. Object tree: senec.0.ENERGY.GUI_BAT_DATA_FUEL_CHARGE (number, 0-100), senec.0.ENERGY.GUI_BAT_DATA_POWER (number, W).

KNX saistīšana (ioBroker KNX adapteris): saistiet senec.0.ENERGY.GUI_BAT_DATA_FUEL_CHARGE ar GA 6/4/3, DPT 5.001 (rakstīt uz izmaiņām, pielaide 1%). Saistiet GUI_BAT_DATA_POWER / 1000 ar GA 6/4/4 DPT 9.001. ETS6 nolasa KNX grupu adreses kā parasti — SENEC dati parādās kā standarta KNX vērtības.

Pašpatēriņa automatizācijas loģika

ETS6 logic (MDT Logic Controller): Rule 1 — When SOC (GA 6/4/3) rises above 85%, send '1' to GA 3/2/0 (washing machine KNX socket enable). Rule 2 — When grid export (GA 6/4/5 below -0.5 kW, i.e. exporting more than 500W): send '1' to GA 3/2/1 (dishwasher enable), send 32 to GA 6/0/8 (EV charger current GA, DPT 5.010). Rule 3 — When SOC drops below 20%: send '0' to GA 3/2/0 and GA 3/2/1 (disable flex loads). Reset timer: 30-minute minimum on-time per cycle to prevent short cycling.

V3 Hybrid un G3 atšķirības

SENEC.Home V3 Hybrid apvieno hibrīdinvertoru — pieejama GUI_INVERTER_POWER jauda (līdzstrāva no saules paneļiem). G3 ir maiņstrāvas sistēma, šī lauka nav; invertoru nopratiniet atsevišķi (piem., SMA Sunny Boy Modbus TCP ports 502, ierīce 3, maiņstrāvas jaudas reģistrs 30775). V4 hybrid: tas pats API gala punkts, papildu lauki daudzstīgu invertoram. Visas SENEC paaudzes izmanto vienu HTTP POST gala punktu un JSON lauku nosaukumus.