Data reading

Data from tcPDU can be read on demand by special HTTP request and MQTT command. All device parameters are divided into reading groups, so that only the desired values can be freely selected and read. The response contains variables from selected groups in JSON format.

HTTP

Two queries are available - one for static data and one for dynamic data (a conventional term). The data to be read is selected by placing selected groups as parameters of the HTTP query as follows:

• static data:

  http://[IP]/api/v1/read/set/?[GRUPA 1]
  

  http://[IP]/api/v1/read/set/?[GRUPA 1]&[GRUPA 2]&[GRUPA 3]
  

  e.g.

  http://192.168.1.130/api/v1/read/set/?outConfig
  

  http://192.168.1.130/api/v1/read/set/?outConfig&dsConfig&i2cConfig&diffConfig
  

• dynamic data:

  http://[IP]/api/v1/read/status/?[GRUPA 1]
  

  http://[IP]/api/v1/read/status/?[GRUPA 1]&[GRUPA 2]&[GRUPA 3]
  

  e.g.

  http://192.168.1.130/api/v1/read/status/?boardValues
  

  http://192.168.1.130/api/v1/read/status/?boardValues&statusValues&timeValues&outValues&dsValues&i2cValues&diffValues
  

A complete list of groups and their data is described in List of groups.

Access permissions with Basic Authentication

When Basic Authentication is enabled, access to data groups depends on the user role. These restrictions apply only to HTTP requests and do not affect MQTT.

• Public (without authentication):

  • publicConfig

• User user:

  • static groups:
    webConfig, outConfig, dsConfig, i2cConfig, diffConfig, iDConfig, powerConfig, varConfig
  • dynamic groups:
    boardValues, statusValues, timeValues, outValues, dsValues, i2cValues, diffValues, iDValues, powerValues, varValues

• User admin:

  • access to all data groups.

MQTT

This feature will be available in a future firmware release.

The command to read data via MQTT should be sent like other MQTT commands (more about this). The command format is as follows:

read=[GRUPA 1]

read=[GRUPA 1]&[GRUPA 2]&[GRUPA 3]

List of groups

Groups of readings are divided into two types:

• with static data such as settings, names of sensor readings
• with dynamic data such as sensor readings

Group types are read by separate queries, and each query may contain many groups (reading method described above).

In the list below, the names of some variables are supplemented with {X,Y}, which means that it is a set of readings. For example, iDValue{1,2} corresponds to iDValue1 and iDValue2, and oledLine{1,4}{1,4} corresponds to oledLine1, oledLine12, oledLine13, oledLine14, oledLine21, oledLine22, oledLine23, oledLine24, oledLine31, oledLine32, oledLine33, oledLine34, oledLine41, oledLine42, oledLine43, oledLine44.

Static data

• publicConfig

  [
      "hardwareVersion",
      "softwareVersion",
      "webLanguage",
      "webRefresh",
      "webHomepage",
      "webAutoSignIn", // not used since SW 1.36
      "netHostname"
  ]
  

• generalConfig

  [
      "hardwareVersion",
      "softwareVersion",
      "mqttDeviceID",
      "modemPresent"
  ]
  

• webConfig

  [
      "webRefresh",
      "webLanguage",
      "webUserSetNames",
      "webReadOnlyUser",
      "webAutoSignIn", // not used since SW 1.36
      "webHomepage",
      "webCheckUpdates", // reserved for future use
      "webVisibility",
      "webPositionTop",
      "webPositionLeft",
      "picture" // reserved for future use
  ]
  

• varConfig

  [
      "varName{1,8}"
  ]
  

• outConfig

  [
      "outName{1,7}",
      "outAutoSwitch{1,7}",
      "outAutoSwitchH{1,7}",
      "outAutoSwitchL{1,7}",
      "outStartOn{1,7}",
      "outStartOnTime{1,7}",
      "outResetTime{1,7}",
      "outSaveState{1,7}",
      "outNegation",
      "outLock"
  ]
  

• dsConfig

  [
      "dsName{1,8}",
      "dsID{1,8}",
      "dsOffset{1,8}"
  ]
  

• i2cConfig

  [
      "i2cTempName",
      "i2cHumName",
      "i2cSensor",
      "i2cFrequency"
  ]
  

• diffConfig

  [
      "diffName{1,6}",
      "diffConfig1S{1,6}",
      "diffConfig2S{1,6}",
      "diffConfigO{1,6}"
  ]
  

• iDConfig

  [
      "iDName{1,2}",
      "iDNegation{1,2}",
      "iDBistable{1,2}",
      "iDBistableTime{1,2}"
  ]
  

• modemConfig

  [
      "modemCode",
      "modemAPN",
      "modemNumberEv{1,4}",
      "modemTextEvT{1,4}",
      "modemTextEvF{1,4}"
      "modemReturnSMS",
      "modemCLIP", // added in SW 1.36
      "modemCLIPNumber", // added in SW 1.36
      "modemCLIPOutput" // added in SW 1.36
  ]
  

• powerConfig

  [
      "powerName{1,6}",
      "powerIOption{1,6}",
      "powerCounting{1,6}",
      "powerSaveToMem"
  ]
  

• eventConfig

  [
      "event{1,20}"
  ]
  

• scheduleConfig

  [
      "schedule{1,50}"
  ]
  

• wdConfig

  [
      "wdConfig{1,7}"
  ]
  

• httpConfig

  [
      "httpModem", // not used since SW 1.22
      "httpReadingCode",
      "httpDigestAuth",
      "httpPerEnabled",
      "httpPerPeriod",
      "httpPerURL",
      "httpPerMethod", // added in SW 1.36
      "httpPerHeaders", // added in SW 1.36
      "httpPerBody", // added in SW 1.36
      "httpURLEvT{1,4}",
      "httpURLEvF{1,4}",
      "httpMethodEvT1{1,4}", // added in SW 1.36
      "httpMethodEvF1{1,4}", // added in SW 1.36
      "httpHeadersEvT1{1,4}", // added in SW 1.36
      "httpHeadersEvF1{1,4}", // added in SW 1.36
      "httpBodyEvT1{1,4}", // added in SW 1.36
      "httpBodyEvF1{1,4}" // added in SW 1.36
  ]
  

• mqttConfig

  [
      "mqttEnabled",
      "mqttAuth",
      "mqttTLS",
      "mqttLWT",
      "mqttHost",
      "mqttPort",
      "mqttLogin",
      "mqttPassword",
      "mqttPrefix",
      "mqttPeriod",
      "mqttKeepAlive",
      "mqttSend"
  ]
  

• snmpConfig

  [
      "snmpTrapEnabled",
      "snmpV2Enabled",
      "snmpV3Enabled",
      "snmpCommRead",
      "snmpCommWrite",
      "snmpCommTrap",
      "snmpTrapReceive",
      "snmpUser",
      "snmpAuthPass",
      "snmpPrivacyPass"
  ]
  

• networkConfig

  [
      "netHostname",
      "netHttpPort",
      "netHttpsOn",
      "netMac",
      "netDhcp",
      "netIp",
      "netMask",
      "netGateway",
      "netDns1",
      "netDns2",
  ]
  

• timeConfig

  [
      "timeNTP",
      "timeNTPHost",
      "timeNTPPort",
      "timeTimezone",
      "timeNTPPeriod"
  ]
  

• accessConfig

  [
      "auth",
      "upgr",
      "adminLogin",
      "adminPass",
      "userLogin",
      "userPass",
      "authUser{1,50}"
  ]
  

• emailConfig

  [
      "emailHost",
      "emailPort",
      "emailTLS",
      "emailUser",
      "emailPassword",
      "emailSender",
      "emailWdTo",
      "emailWdSubj",
      "emailWdText",
      "emailToEvT{1,4}",
      "emailToEvF{1,4}",
      "emailSubjEvT{1,4}",
      "emailSubjEvF{1,4}",
      "emailTextEvT{1,4}",
      "emailTextEvF{1,4}"
  ]
  

• oledConfig

  [
      "oledEnabled",
      "oledTime",
      "oledSize",
      "oledScreen{1,4}",
      "oledLine{1,4}{1,4}",
      "oledFrequency"
  ]
  

Dynamic data

• boardValues

  [
      "uRms",
      "iRms",
      "pActive",
      "pApparent",
      "pReactive",
      "pFactor",
      "pospf",
      "posang"
  ]
  

• statusValues

  [
      "restartFlag",
      "oledScreenNow",
      "mqttConnected"
  ]
  

• outValues

  [
      "out{1,7}",
      "outAutoSwitchE{1,7}"
  ]
  

• dsValues

  [
      "ds{1,8}",
      "dsReadID"
  ]
  

• i2cValues

  [
      "i2cTemp",
      "i2cHum",
      "dewPoint"
  ]
  

• diffValues

  [
      "diff{1,6}"
  ]
  

• iDValues

  [
      "iDValue{1,2}"
  ]
  

• modemValues

  [
      "modemConsole",
      "modemConnected",
      "modemRegistered"
  ]
  

• powerValues

  [
      "power{1,6}",
      "energy{1,6}"
  ]
  

• eventValues

  [
      "eventConditionResult{1,20}"
  ]
  

• varValues

  [
      "var{1,8}"
  ]
  

• wdValues

  [
      "wdEnableStatus",
      "wdPingTime",
      "wdPingFailCount",
      "wdRestartCount"
  ]
  

• timeValues

  [
      "time",
      "uptimeDays",
      "uptimeHours",
      "uptimeMinutes",
      "uptimeSeconds"
  ]