Datapisteet

Lukeminen

Read datapoint value lukee datapisteiden arvoja WS-rajapinnan ylitse. Samalla komennolla voidaan lukea useita pisteitä erottamalla niiden nimet puolipilkulla ( ; ).

Esimerkki: Luetaan koko piste ”sys/settings/networkSettings”.
/plc.php?get=sys/settings/networkSettings

Vastaus:
[{"get":"{\"defaultGateway\":\"192.168.0.1\",\"subnetMask\":\"255.255.255.0\",\"ipAddress\":\"192.168.0.128\",\"dnsServer\":\"8.8.8.8\",\"broadcastAddress\":\"192.168.0.255\"}"},{"time":"1505132981"}]

 

Esimerkki: Luetaan kahden prosessidatapisteen oloarvot (pisteet ioPoints/TK01/TE10 ja ioPoints/TK01/TE30).

/plc.php?get=ioPoints/TK01/TE10.pv;ioPoints/TK01/TE30.pv

Vastaus:
[{"get":"20.6"},{"get":"19.6"},{"time":"1505133163"}]

 

Esimerkki: Luetaan sellaisen pisteen arvo, jota ei ole olemassa.

/plc.php?get=ioPoints/TK01/TE100.pv

Vastaus:
[{"get":"-4294967296"},{"time":"1505133224"}]

 

kirjoittaminen

Datapisteen arvon kirjoittaminen WS-rajapinnan ylitse.

Value-parametri, eli kirjoitettava arvo annetaan JSON-muodossa.

Huom! Ei käytössä shared key -autentikoinnin kautta.

Esimerkki: Kirjoitetaan tuloilman asetusarvo (piste ”ioPoints/TK01/TE10_SP”).

/plc.php?set=ioPoints/TK01/TE10.pv&value=22.0

Vastaus:
[{"set":"true"},{"time":"1505137224"}]

 

 

Listaus

Prosessorin datapisteiden listaaminen. Suodatusta listassa voidaan tehdä joko pistenimissä (wildcard-merkillä *) tai niiden sisältämien arvojen perusteella. 

Syntaksi list- ja field-parametreille on sama kuin Data.list() -kutsussa. 

    list        Tällä parametrilla annetaan suodausehto pisteiden nimelle. Wildcardina toimii merkki ’*’, joka on URL-koodattuna %2A.

    field     Tämän parametrin avulla voidaan suodattaa pisteitä kenttien ja jopa kenttien arvojen perusteella. Tässä yhteydessä ei voi                  suoraan käyttää Wild card -merkkejä, koska lausekkeen täytyy olla validi vertailu.

 

Esimerkki 1: Listataan kaikki TK01:n pisteet, eli nimisuodattimena ”ioPoints/TK01/*”.

/plc.php?list=ioPoints/TK01/%2A

Vastaus:
[{"list":["ioPoints\/TK01\/TE10","ioPoints\/TK01\/TE30"]},{"time":"1505137744"}]

Esimerkki 2: Listataan kaikki pisteet joilla on kenttä ’dataSource’

/plc.php?list=ioPoints/TK01/%2A&field=(dataSource)

 

Esimerkki 3: Listataan kaikki pisteet joilla kenttä pv on suurempi kuin 9.0 

Muista että field parametrille täytyy tehdä URL enkoodaus! Selväkielisenä vertailu on (pv > 9.0)

/plc.php?list=ioPoints/TK01/%2A&field=(pv%20%3E%209.0)