FoundryNet / Fields / energy_kwh
Canonical field reference

energy_kwh

Cumulative energy consumption. The consumption-side counterpart to energy_delivered_kwh, kept distinct so a site that both draws and exports does not net the two into a meaningless single number.

4OEMs / profiles mapped
60distinct raw spellings
226corpus source tags
1.00match confidence
Get an API key All canonical fields

Vendor tag table

How 4 vendors spell energy_kwh

Each of these is a real tag as the device or controller emits it, taken from the Forge mapping corpus. This is the table that does not exist anywhere else — the reason cross-vendor telemetry is hard is visible in a single column.

OEM / profileRaw tag as the device emits itConfidence
FanucENERGYKWH(J)
ENERGYKWH_Wh
ENERGYKWH_kW
ENERGY_KWH_J
ENERGYKWH [W]
ENERGYKWH(Wh)
+40 more spellings
1.00
Siemensenergieverbrauch(J)
energieverbrauch(W)
energieverbrauch_Wh
energieverbrauch (J)
energieverbrauch(Wh)
1.00
CarrierkWh
EnergyKWH
1.00
SungrowDaily PV generation & battery discharge1.00

Every row above is an exact match — a deterministic pack entry or a confirmed corpus mapping — so all of them carry confidence 1.00. That is not a rounding: these are the two exact-match layers, and a tag that resolves here never reaches the embedding or LLM layers. Mappings resolved by the LLM layer do carry sub-1.0 confidence, but those are per-tenant and are not published here.


Unit contract

What Forge guarantees about the value

The canonical field is not just a name. It is a contract about units, sign convention and plausible range, enforced on the way in and re-checked at read time.

SI / canonical unitkWh
Accepted input unitsJ MWh Wh kJ kWh
Converted on ingestJ MWh Wh kJ → kWh
Physics bounds0.0 to 1000000000000.0 kWh
Measurement typecumulative — resets are expected; a decrease is a counter reset, not a negative reading
Distinct source tags in the corpus226

Normalization

Raw tag in, canonical field out

# Fanuc emits its own spelling; Forge returns the canonical field
curl -s -X POST https://forge.foundrynet.io/v1/normalize \
-H "Authorization: Bearer $FORGE_KEY" \
-H "Content-Type: application/json" \
-d '{"data": {"ENERGYKWH(J)": 0}, "oem": "fanuc"}'
{ "normalized": { "energy_kwh": 0 }, "match_type": "deterministic", "confidence": 1.0 }

No mapping table to maintain, and no per-vendor branch in your code. The same request shape works for every OEM in the table above.

# Same thing with no key and no account — the sandbox ships the packs
docker run -p 8000:8000 ghcr.io/foundrynet/forge-sandbox

Where this field appears

Protocols

Transports this field is carried on in the corpus.

BACnet/IP Modbus TCP
Every one of these tag names is someone’s integration project. The Machine Agent, weekly. Read it →
Get the thesis behind this infrastructure — The Machine Agent, weekly.