1 Wi6labs Essential
2 Wiotys App
3 Water Meter Models
- 3.1 Water Meter Index JSON
- 3.2 Water Meter Alarm JSON
- 3.3 Water Meter Index CSV
- 3.4 Water Meter Alarm CSV

The advanced models are used only in specific use case/application. They are not be available from Wiotys Web Interface. Please contact Wi6labs support for more information.

Wi6labs Essential

This is the basic format to get essential information of your devices with default decoded information.

JSON Field	Description	format

JSON Field	Description	format
id	unique identifier of a device in Wiotys	integer
deveui	unique identifier of a LoRa device	16 hexadecimal
timestamp	date and time of the information reception in UTC	Date-time RFC3339
payload_deciphered	Device applicative payload	hexadecimal data 0 to 104 character
data	decoded information	Default decoding. Format is depending of the device, configuration and codec selected

Example :

{
  "id": "1453",
  "deveui": "0123456789abcdef",
  "timestamp": "2022-02-10T09:28:48+00:00",
  "payload_deciphered": "4d4bf83bf203e101fd00d201ff00bdff",
  "data": {
    "battery": 75,
    "humidity": 59,
    "pressure": 1010,
    "CO2_moy": 481,
    "CO2_max": 466,
    "temperature_moy": 25.3,
    "temperature_max": 25.5,
    "signal_quality": -67
  }
}

Wiotys App

This is the format compatible with WiotysApp dashboard application.

JSON Field	Description	format

JSON Field	Description	format
protocol	current version of the protocol used	integer
device	unique identifier of a LoRa device on Wiotys App platformes specified as device customElement smartcoreDevelopperId
at	date and time of the information reception, in UTC
data	payload data
ver	version of the following smart dataset
data	decoded information	one or several dataset
dataset	decoded data	Smart formating
checksum	computed checksum calculated upon shared secret specified as device customElement smartcoreChecksum

Example :

{
  "protocol": "v3",
  "persist": "true",
  "device": "28776a99-185c-4df5-b9cf-289631ed9244",
  "at": 1554884039,
  "data": {
    "ver": "S1",
    "dataset": [
      {
        "columns": ["type","ref","value"],
        "values": [
          ["Measure","Global|0|SNR",1560415499],
          ["Measure","Global|0|Frame_cnt",546],
          ["Measure","Global|0|RSSI",-110]
        ]
      },
      {
        "columns": ["type","ref","value"],
        "values": [
          ["Status","Item|0|IGenericStatus",1]
        ]
      }
    ]
  },
  "checksum": "7a8df448e93bd1167a2575937a5e57e1d56ea589"
}

Water Meter Models

The following formats are dedicated for advanced information regarding the water meters. It is available only for several LoRaWAN water meters:

ITRON Cyble 5
Diehl G3
Elster Merlin
Maddalena Arrow 2

Water Meter Index JSON

This is a format dedicated for advanced information regarding water meters index.

JSON Field	Description	format

JSON Field	Description	format
Type_Trame	Index	string
Network_A	Lorawan	string
Network_B	Wi6labs	string
Manufacturer	Either iTron, Diehl, Elster Merlin, Maddalena	string
Module_addr	Serial number on the LoRaWAN device sticker (not always DevEUI)	string
Module_version	Version SW of the LoRaWAN module, if present in the frame	string
WaterMeter_Serial	Serial number of the Water Meter	string
DateTime_Module	LoRaWAN device time if present in the frame, otherwise time of frame reception	AAAA-MM-DDTHH:mm:ss
DateTime_ModuleGMT	LoRaWAN device time if present in the frame, otherwise time of frame reception	ISO 8601
DateTime_Concentrateur	Time of the frame reception by the LoRaWAN gateway	AAAA-MM-DDTHH:mm:ss
DateTime_ConcentrateurGMT	Time of the frame reception by the LoRaWAN gateway	ISO 8601
Index	Table of Index, one or several if the module sends data with an historic mode	table
DateTime_Index	Time of the index	AAAA-MM-DDTHH:mm:ss
DateTime_IndexGMT	Time of the index	ISO 8601
Pulse	Pulse weight to convert 1x impulsion into liter, purly informative	integer
Index	Water metter index in liters	integer
ID_concentrateur	EUI identifier of the LoRaWAN best gateway for the frame	16 hexadecimal

Example :

{
    "Type_Trame" : "Index",
    "Network_A" : "Lorawan",
    "Network_B" : "Wi6labs",
    "Manufacturer" : "Maddalena",
    "Module_addr" : "23926793",
    "Module_version" : "0.23",              
    "WaterMeter_Serial" : "H21VA231461",                        
    "DateTime_Module":"2023-02-05T07:08:00",
    "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
    "DateTime_Concentrateur":"2023-02-05T07:08:00",
    "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
    "Index":[
      {
        "DateTime_Index":"2023-02-05T07:08:00",
        "DateTime_IndexGMT":"2023-02-05T07:08:00+02:00",
        "Pulse":1   ,                        
        "Index": 1536
      },
      {
        "DateTime_Index":"2023-02-05T19:08:00",
        "DateTime_IndexGMT":"2023-02-05T19:08:00+02:00",
        "Pulse":1   ,                        
        "Index": 1589
      }
    ],
    "ID_concentrateur": "7076FF0056050A3A"
}

Water Meter Alarm JSON

This is a format dedicated for advanced information regarding water meters index.

JSON Field	Description	format

JSON Field	Description	format
Type_Trame	Alarme	string
Network_A	Lorawan	string
Network_B	Wi6labs	string
Manufacturer	Either iTron, Diehl, Elster Merlin, Maddalena	string
Module_addr	Serial number on the LoRaWAN device sticker (not always DevEUI)	string
DateTime_Module	LoRaWAN device time if present in the frame, otherwise time of frame reception	AAAA-MM-DDTHH:mm:ss
DateTime_ModuleGMT	LoRaWAN device time if present in the frame, otherwise time of frame reception	ISO 8601
DateTime_Concentrateur	Time of the frame reception by the LoRaWAN gateway	AAAA-MM-DDTHH:mm:ss
DateTime_ConcentrateurGMT	Time of the frame reception by the LoRaWAN gateway	ISO 8601
Alarm	Table of active alarms on the water meter module	table
DateTime_Alarme	Time of the alarm if available in the frame, otherwise time of frame reception	AAAA-MM-DDTHH:mm:ss
DateTime_AlarmeGMT	Time of the alarm if available in the frame, otherwise time of frame reception	ISO 8601
Alarm_Type	Type of alarm, depends on each manufacturer	string
value	Value of the alarm, 1 for active and 0 for inactive	0 / 1
ID_concentrateur	EUI identifier of the LoRaWAN best gateway for the frame	16 hexadecimal

Example :

{
    "Type_Trame" : "Alarme",
    "Network_A" : "Lorawan",
    "Network_B" : "Wi6labs",
    "Manufacturer" : "Diehl",
    "Module_addr" : "5322878121148402",                 
    "DateTime_Module":"2023-02-05T07:08:00",
    "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
    "DateTime_Concentrateur":"2023-02-05T07:08:00",
    "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
    "Alarm":[
      {
        "DateTime_Alarme":"2023-02-05T07:08:00",
        "DateTime_AlarmeGMT":"2023-02-05T07:08:00+02:00",
        "Alarm_Type": "MacroAlarme_InProgressAlarms"
        "value": 1,
      },
      {
        "DateTime_Alarme":"2023-02-05T07:08:00",
        "DateTime_AlarmeGMT":"2023-02-05T07:08:00+02:00",
        "Alarm_Type": "MacroAlarme_Metrology"
        "value": 1,
      }
    ],
    "ID_concentrateur": "7076FF0056050A3A"
}

Water Meter Index CSV

This is the equivalent of format Water Meter Index JSON but for FTP delivery.

Example :

{
    {
        "Type_Trame" : "Index",
        "Network_A" : "Lorawan",
        "Network_B" : "Wi6labs",
        "Manufacturer" : "Maddalena",
        "Module_addr" : "90dffb818734a123",
        "Module_version" : "",              
        "WaterMeter_Serial" : "H21VA231461",                        
        "DateTime_Module":"2023-02-05T07:08:00",
        "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Concentrateur":"2023-02-05T07:08:00",
        "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Index":"2023-02-05T07:08:00",
        "DateTime_IndexGMT":"2023-02-05T07:08:00+02:00",
         "Pulse":1   ,                        
        "Index": 1536
        "ID_concentrateur": "7076FF0056050A3A"
    },

    {
        "Type_Trame" : "Index",
        "Network_A" : "Lorawan",
        "Network_B" : "Wi6labs",
        "Manufacturer" : "Diehl",
        "Module_addr" : "90dffb818734a123",
        "Module_version" : "",              
        "WaterMeter_Serial" : "H21VA231461",                        
        "DateTime_Module":"2023-02-05T07:08:00",
        "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Concentrateur":"2023-02-05T07:08:00",
        "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Index":"2023-02-05T19:08:00",
        "DateTime_IndexGMT":"2023-02-05T19:08:00+02:00",
        "Pulse":1   ,                        
        "Index": 1589
        "ID_concentrateur": "7076FF0056050A3A"
    }
}

Water Meter Alarm CSV

This is the equivalent of format Water Meter Alarm JSON but for FTP delivery.

Example :

{
    {
        "Type_Trame" : "Alarme",
        "Network_A" : "Lorawan",
        "Network_B" : "Wi6labs",
        "Manufacturer" : "diehl",
        "Module_addr" : "90dffb818734a123",                 
        "DateTime_Module":"2023-02-05T07:08:00",
        "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Concentrateur":"2023-02-05T07:08:00",
        "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Alarme":"2023-02-05T07:08:00",
        "DateTime_AlarmeGMT":"2023-02-05T07:08:00+02:00",
        "Alarm_Type": "MacroAlarme_InProgressAlarms"
        "value": 1,
        "ID_concentrateur": "7076FF0056050A3A"
      },
      {
        "Type_Trame" : "Alarme",
        "Network_A" : "Lorawan",
        "Network_B" : "Wi6labs",
        "Manufacturer" : "diehl",
        "Module_addr" : "90dffb818734a123",                 
        "DateTime_Module":"2023-02-05T07:08:00",
        "DateTime_ModuleGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Concentrateur":"2023-02-05T07:08:00",
        "DateTime_ConcentrateurGMT":"2023-02-05T07:08:00+02:00",
        "DateTime_Alarme":"2023-02-05T07:08:00",
        "DateTime_AlarmeGMT":"2023-02-05T07:08:00+02:00",
        "Alarm_Type": "MacroAlarme_Metrology"
        "value": 1,
        "ID_concentrateur": "7076FF0056050A3A"
      }
}

Wiotys documentation

Advanced Models

Wi6labs Essential

Wiotys App

Water Meter Models

Water Meter Index JSON

Water Meter Alarm JSON

Water Meter Index CSV

Water Meter Alarm CSV

Related content