HALOWERKSolarwerk
battery cycle
Integrates the supplied current over time by the trapezoidal rule, so the result is only as good as the sampling interval; gaps longer than the stated max_gap_seconds are excluded and reported. Sign convention: positive current is charging, negative is discharging. Internal resistance is estimated from the largest current step in the series and is a rough figure, not a measurement under defined conditions.
POST https://solar.halowerk.com/battery-cycleEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| samples | array | Ja | |
| cells_in_series | integer | Nein | |
| nominal_capacity_ah | number | Nein | |
| rest_current_a | number | Nein | Below this absolute current a sample counts as resting. |
| max_gap_seconds | number | Nein |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"samples"
],
"additionalProperties": false,
"properties": {
"samples": {
"type": "array",
"minItems": 3,
"maxItems": 5000,
"items": {
"type": "object",
"required": [
"t_s",
"voltage_v",
"current_a"
],
"additionalProperties": false,
"properties": {
"t_s": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Seconds since series start, strictly increasing."
},
"voltage_v": {
"type": "number",
"minimum": 0,
"maximum": 1000,
"description": "Pack voltage."
},
"current_a": {
"type": "number",
"minimum": -2000,
"maximum": 2000,
"description": "Positive charging, negative discharging."
},
"temperature_c": {
"type": "number",
"minimum": -60,
"maximum": 120
}
}
}
},
"cells_in_series": {
"type": "integer",
"minimum": 1,
"maximum": 64,
"default": 4
},
"nominal_capacity_ah": {
"type": "number",
"minimum": 0.1,
"maximum": 10000
},
"rest_current_a": {
"type": "number",
"minimum": 0,
"maximum": 100,
"default": 0.5,
"description": "Below this absolute current a sample counts as resting."
},
"max_gap_seconds": {
"type": "number",
"minimum": 1,
"maximum": 86400,
"default": 300
}
}
}Veröffentlichtes Eingabebeispiel
{
"samples": [
{
"t_s": 0,
"voltage_v": 13.2,
"current_a": 0
},
{
"t_s": 60,
"voltage_v": 13.1,
"current_a": -5
},
{
"t_s": 120,
"voltage_v": 13,
"current_a": -5
}
],
"cells_in_series": 4,
"nominal_capacity_ah": 100
}Ergebnis & Dokumentation
Veröffentlichtes Ergebnisschema anzeigen
{
"$ref": "https://solar.halowerk.com/battery-cycle/schema#/outputSchema"
}Veröffentlichtes Ergebnisbeispiel öffnen
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Solarwerk0,003 USDC
autonomy forecast
POSThttps://solar.halowerk.com/autonomy-forecastDaily energy balance and straight run-down from the figures supplied. Solar input is caller data in watt-hours per day; nothing is fetched and no weather is assumed. Time to empty means time to the reserve floor, not to zero. Idle draw and
- Solarwerk0,004 USDC
building heat demand
POSThttps://solar.halowerk.com/building-heat-demandComputes a transparent planning estimate for space-heating demand. The method is not DIN, VDI, GEG or PHPP and must not be used as regulatory proof. It combines transmission heat loss from each envelope component, ventilation heat loss from
- Solarwerk0,003 USDC
clear sky yield
POSThttps://solar.halowerk.com/clear-sky-yieldThis is an astronomical and geometric calculation, not a forecast. It assumes a cloudless sky and states the models used; real yield is lower whenever there is cloud, haze, snow, soiling or high cell temperature. The system_derate factor co