General
When Using wMbus/OMS Telegrams there is a Problem: The Telegrams are self describing in a way that they describe values as "this is a Volume in m³" "this is a Date with Time" but they dont include the information about the businesses meaning if the value.
For example in the following "heat cost" device we got several H.C.A Values and 3 Date informations:
When we want to create a heating bill for tenants we need to know the meaning because we want to use a Due Date and the Value for that due Date or we want to use the actual H.C.A Value with the it is from.
The problem here is: The order and meaning of these Values differ widely. Sometimes the actual Value is the first one, sometimes the last one, Sometimes Due Date values of the last 12 months are presented in descending order sometimes in ascending order. Sometimes the date information regarding due dates are grouped next to the duedate values some times values and date information are kept in 2 blocks. So we want to archive a a way to configure the logical meaning for different devices so we can produce a general usable format containing the meter data usable by billing software.
Mapping Configuration
Configures how telegrams are mapped to the Domain Model.
The Mapping contains a filter part to select telegrams that the mapping shall be applied to. The mapping is applied if all filters match true.
{
"mappings":[
{
"comment":"Kampstrup MC603 in SEAS Konfiguration",
"filter":{
"formatSignature":"7869",
"manafacture":"KAM",
"type":"04",
"version":53
},
"heat":{
"currentValueIdx":0,
"flowTemperatureIdx": 5,
"returnTemperatureIdx": 6,
"volumeIdx": 3
}
}
]
}
API Endpoint
curl Example: (With mapping from: domainMappings.json File)
Method: POST
Path: /api/meterData
URL Params:
Telegram: raw=44442d2c0198508035048d20aac070c420dd3d967a564c53dfe4dedfbc45e8d41912db6c0973921bef3c2d5dc8d3b6fe01cc272258cd728f825a2d2e76b256fd722680
MeterKey: key=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
Body: Type: application/json with a Mapping Configuration as described on this Page.
Answers: With Domain Data described under "Metering Domain Model" on this Page.
Authorization: Header ("Authorization") with Bearer Token from the Platform: https://platform.lobaro.com/#/organisation/integrations/rest/
Curl Example:
curl -X 'POST' \ 'localhost:8082/api/meterData?raw=44442d2c0198508035048d20aac070c420dd3d967a564c53dfe4dedfbc45e8d41912db6c0973921bef3c2d5dc8d3b6fe01cc272258cd728f825a2d2e76b256fd722680&key=7ADA08C8C89C7D21EAEE6F662BF0A6ED' \ -H 'accept: \ application/json' -H 'Authorization: Bearer eyJh[...]' -H "Content-Type: application/json" -d @domainMappings.json