Werte

kanal und parameterwerte die kanal und parameterdaten beinhalten immer den aktuellen wert, welcher in einem containerobjekt gekapselt ist es gibt die folgenden internen datentypen für werte datentyp beschreibung number long 64 bit ganzzahl mit vorzeichen number double 64 bit gleitkommazahl mit doppelter genauigkeit und vorzeichen text string mit einer maximalen länge von 2 147 483 647 zeichen state repräsentation eines zustandes als string color farbinformationen als string eine genauere beschreibung mit wertebereichen und einheit ist in der wertebeschreibung (descriptionid) enthalten containerdaten alle container enthalten folgende felder, zusätzlich besitzt jeder datentypcontainer spezifische felder feld datentyp beschreibung type string der interne datentyp des wertes info string optionale information über kanal/parameter descriptionid string die id der wertbeschreibung changeable boolean flag ob der wert änderbar ist number long simpleiotcorenumberlongvaluedto feld datentyp beschreibung value number 64 bit ganzzahl mit vorzeichen codebeispiele simpleiotcorenumberlongvaluedto { "type" "number long", "info" "dimmer", "descriptionid" "28fe2f5c44b7eed19be6ae35d8386bce", "changeable" true, "value" 12 } number double simpleiotcorenumberdoublevaluedto feld datentyp beschreibung value number 64 bit gleitkommazahl mit doppelter genauigkeit und vorzeichen codebeispiele simpleiotcorenumberdoublevaluedto { "type" "number double", "info" "batteryvoltage", "descriptionid" "9dd8b5f7bc9be573a8da87e284f71afa", "changeable" true, "value" 4 2 } text simpleiotcoretextvaluedto feld datentyp beschreibung value string string mit einer maximalen länge von 2 147 483 647 zeichen codebeispiele simpleiotcoretextvaluedto { "type" "text", "info" "notes", "descriptionid" "2d6b4d84700ecd2e29b00b8482eda29c", "changeable" false, "value" "this is an example string value" } state simpleiotcorestatevaluedto feld datentyp beschreibung value string repräsentation eines zustandes als string codebeispiele simpleiotcorestatevaluedto { "type" "state", "info" "window", "descriptionid" "5c731d9c9025dc1a943cfe8ca22103dc", "changeable" false, "value" "opened" } color simpleiotcorecolorvaluedto feld datentyp beschreibung value string farbinformationen als hexadezimaler wert codebeispiele simpleiotcorecolorvaluedto { "type" "color", "info" "dimmer", "descriptionid" "4036cbe644b0e2b0c1b689c7b6d7583c", "changeable" false, "value" "ffffff" } wertbeschreibung beschreibungscontainer dienen dazu eine detailierte spezifikation zu liefern wie werte zu interpretieren sind oder welche bereiche möglich sind es gibt für jeden internen datentyp einen beschreibungscontainer, um die spezifischen anforderungen zu erfüllen jeder container hat eine eigene id, welche auch von mehreren kanälen gleichzeitig genutzt werden kann die id ist systemübergreifend gleich, kann sich aber ggf zwischen softwareversionen unterscheiden jeder container enthält folgende felder, zusätzlich besitzt jeder beschreibungscontainer spezifische felder feld datentyp beschreibung type string der interne datentyp für welchen die beschreibung gilt descriptionid string die id der wertbeschreibung number long simpleiotcorenumberlongdescriptiondto feld datentyp beschreibung minvalue number minimaler wert maxvalue number maximaler wert stepsize number optional schrittgröße beim einstellen des wertes stadardwert 1 measuringunit string optional maßeinheit des wertes codebeispiele simpleiotcorenumberlongdescriptiondto { "type" "number long", "descriptionid" "28fe2f5c44b7eed19be6ae35d8386bce", "measuringunit" "%", "minvalue" 0, "maxvalue" 100, "stepsize" 1 } number double simpleiotcorenumberdoubledescriptiondto feld datentyp beschreibung minvalue number minimaler wert maxvalue number maximaler wert stepsize number optional schrittgröße beim einstellen des wertes standardwert 1 0 decimalpartdigits number optional anzahl der kommastellen des wertes standardwert 2 measuringunit string optional maßeinheit des wertes codebeispiele simpleiotcorenumberdoubledescriptiondto { "type" "number double", "descriptionid" "9dd8b5f7bc9be573a8da87e284f71afa", "measuringunit" "v", "minvalue" 0 0, "maxvalue" 5 0, "stepsize" 0 1, "decimalpartdigits" 1 } text simpleiotcoretextdescriptiondto feld datentyp beschreibung minlength number minimale anzahl an zeichen maxlength number maximale anzahl an zeichen codebeispiele simpleiotcoretextdescriptiondto { "type" "text", "descriptionid" "72cce1e3aa4eefd44f89519cf01a2b1d", "minlength" 0, "maxlength" 255 } state simpleiotcorestatedescriptiondto feld datentyp beschreibung possiblestates array ein array von strings mit den möglichen zuständen codebeispiele simpleiotcorestatedescriptiondto { "type" "state", "descriptionid" "f4a95060064eaf3304240300b3a42c10", "possiblestates" \[ "opened", "closed" ] } color simpleiotcorehexcolordescriptiondto feld datentyp beschreibung colortype string information wie der wert zu interpretieren ist im feld colortype sind folgende werte möglich type beschreibung html hex hexadezimaler farbwert (rrggbb) ohne führende raute codebeispiele simpleiotcorehexcolordescriptiondto { "type" "color", "descriptionid" "4afc44d3b5f76bfe5c71693d861fb058", "colortype" "html hex" }