OSTEC-Flex-HEMS Module¶

Type: OSTEC_FLEX_HEMS Category: Flexibility Maturity: DEVELOPMENT 🟡 Integration mode: Passive (HEMS devices push data to the platform)

Extends OSTEC-Flex for use in the Hedge-IoT project, where Home Energy Management Systems (HEMS) push setpoints and offers to the platform. The module does not initiate outbound API calls — data flows inbound only.

Configuration Schema¶

Field	Type	Default	Description
`operation_mode`	string	`"DISPATCH"`	`OFFER_CURVES` · `DISPATCH` — required
`energy_sharing_mode`	string	`"AGG_HEDGE_IOT"`	`REC_AGG` · `AGG_HEDGE_IOT`
`l_extra`	number	`10`	Extra penalty weight for optimization
`solver`	string	`"CPLEX"`	`CPLEX` · `GUROBI` · `CBC`

{
  "operation_mode": "DISPATCH",
  "energy_sharing_mode": "AGG_HEDGE_IOT",
  "l_extra": 10,
  "solver": "CPLEX"
}

Activation¶

curl -X POST \
  https://<host>/core/api/communities/{community_id}/energy_management/configs \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "module_type": "OSTEC_FLEX_HEMS",
    "horizon": 24,
    "delta_t": 1.0,
    "config_data": {
      "operation_mode": "DISPATCH",
      "energy_sharing_mode": "AGG_HEDGE_IOT"
    }
  }'

Triggering a Calculation¶

curl -X POST \
  "https://<host>/core/api/communities/{community_id}/energy_management/configs/{config_id}/calculate?target_date=2026-04-18" \
  -H "Authorization: Bearer <token>"