Zustände (States)

Bemerkung

Lies zuerst die Grundlagen zur Daten-Speicherung.

States können beispielsweise über das CLI (Command Line Interface) ausgelesen werden:

iobroker state get admin.0.info.updatesNumber

Wenn man nur den Wert (also die Eigenschaft val) auslesen möchte, geht das per CLI (Command Line Interface) wie folgt:

iobroker state getvalue admin.0.info.updatesNumber

Beispiel

{
    "val": 0,
    "ack": true,
    "ts": 1633428163294,
    "lc": 1633092122629
    "q": 0,
    "from": "system.adapter.admin.0",
    "user": "system.user.admin"
}

Eigenschaften

val

Der eigentliche Wert des Zustandes. Der Datentyp hängt vom übergeordneten Objekt ab

Type:: mixed

ack

Bestätigt-Flag, ob der (neue) Wert vom Adapter bzw. Ziel-System akzeptiert wurde

Type:: boolean

ts

Unix Timestamp (Zeitstempel in Millisekunden) wann der Zustand zuletzt aktualisiert wurde (ts = time stamp)

Type:: number

lc

Unix Zimestamp (Zeitstempel in Millisekunden) wann der Zustand zuletzt geändert wurde (lc = last change)

Type:: number

q

Qualität

0x00 - 00000000 - good (can be undefined or null)
0x01 - 00000001 - general bad, general problem
0x02 - 00000010 - no connection problem

0x10 - 00010000 - substitute value from controller
0x20 - 00100000 - substitute initial value
0x40 - 01000000 - substitute value from device or instance
0x80 - 10000000 - substitute value from sensor

0x11 - 01000001 - general problem by instance
0x41 - 01000001 - general problem by device
0x81 - 10000001 - general problem by sensor

0x12 - 00010010 - instance not connected
0x42 - 01000010 - device not connected
0x82 - 10000010 - sensor not connected

0x44 - 01000100 - device reports error
0x84 - 10000100 - sensor reports error

Type:: number

from

(optional) Instanz, welche die Änderung durchgeführt hat (z.B. system.adapter.admin.0)

Type:: string

user

(optional) Benutzer, welcher die Änderung durchgeführt hat (z.B. system.user.admin)

Type:: string

c

(optional) Kommentar

Hier wird z.B. vom JavaScript-Adapter der Name des Scripts hinterlegt, welches den Wert zuletzt geändert hat

Type:: string

expire

(optional) Zeit in Sekunden, bis der Wert abläuft (auf null gesetzt wird)

Type:: number