NFC-Ladefreigabe

Benötigt das Feature "nfc".

warp1

nfc/seen_tags

Die zuletzt von der Wallbox gesehenen NFC-Tags.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/nfc/seen_tags

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/seen_tags

[
  { "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE", "last_seen": 22724083 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "01:23:AB:3D", "last_seen": 10753 }
]

Index	Beschreibung
[0..7] object	Ein gesehenes NFC-Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.
[8] object	Das von nfc/inject_tag vorgetäuschte Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.

nfc/inject_tag

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Hiermit kann über die API ein Ladevorgang für einen bestimmten Benutzer gestartet oder gestoppt werden. Analog zur physischen Verwendung eines Tags wird der Ladevorgang bei Aufruf der API abwechselnd freigegeben oder blockiert. Siehe nfc/inject_tag_start und nfc/inject_tag_stop für genauere Kontrolle. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_start

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Starten eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_start -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_start -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_stop

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Stoppen eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_stop -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_stop -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/config

Die NFC-Konfiguration.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

curl http://$HOST/nfc/config -d '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

Mit MQTT auf $PREFIX/nfc/config_update

mosquitto_pub -h $BROKER -t $PREFIX/nfc/config_update -m '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

Name	Beschreibung
deadtime_post_start int (s)	Erlaubt das Stoppen eines Ladevorgangs mit einem NFC-Tag erst nach dieser Zeit, um Fehlbedienung zu vermeiden.
authorized_tags object[16]	Eine Liste authorisierter Tags. [0..15] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

warp2

nfc/seen_tags

Die zuletzt von der Wallbox gesehenen NFC-Tags.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/nfc/seen_tags

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/seen_tags

[
  { "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE", "last_seen": 22724083 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "01:23:AB:3D", "last_seen": 10753 }
]

Index	Beschreibung
[0..7] object	Ein gesehenes NFC-Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.
[8] object	Das von nfc/inject_tag vorgetäuschte Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.

nfc/inject_tag

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Hiermit kann über die API ein Ladevorgang für einen bestimmten Benutzer gestartet oder gestoppt werden. Analog zur physischen Verwendung eines Tags wird der Ladevorgang bei Aufruf der API abwechselnd freigegeben oder blockiert. Siehe nfc/inject_tag_start und nfc/inject_tag_stop für genauere Kontrolle. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_start

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Starten eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_start -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_start -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_stop

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Stoppen eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_stop -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_stop -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/config

Die NFC-Konfiguration.

Beispiel

HTTP (curl)

# $HOST z.B. warp2-AbCd

Lesen

curl http://$HOST/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

curl http://$HOST/nfc/config -d '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp2/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

Mit MQTT auf $PREFIX/nfc/config_update

mosquitto_pub -h $BROKER -t $PREFIX/nfc/config_update -m '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

Name	Beschreibung
deadtime_post_start int (s)	Erlaubt das Stoppen eines Ladevorgangs mit einem NFC-Tag erst nach dieser Zeit, um Fehlbedienung zu vermeiden.
authorized_tags object[32]	Eine Liste authorisierter Tags. [0..31] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

warp3

nfc/seen_tags

Die zuletzt von der Wallbox gesehenen NFC-Tags.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/nfc/seen_tags

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/seen_tags

[
  { "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE", "last_seen": 22724083 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "01:23:AB:3D", "last_seen": 10753 }
]

Index	Beschreibung
[0..7] object	Ein gesehenes NFC-Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.
[8] object	Das von nfc/inject_tag vorgetäuschte Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.

nfc/inject_tag

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Hiermit kann über die API ein Ladevorgang für einen bestimmten Benutzer gestartet oder gestoppt werden. Analog zur physischen Verwendung eines Tags wird der Ladevorgang bei Aufruf der API abwechselnd freigegeben oder blockiert. Siehe nfc/inject_tag_start und nfc/inject_tag_stop für genauere Kontrolle. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_start

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Starten eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_start -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_start -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_stop

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Stoppen eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_stop -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_stop -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/config

Die NFC-Konfiguration.

Beispiel

HTTP (curl)

# $HOST z.B. warp3-AbCd

Lesen

curl http://$HOST/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

curl http://$HOST/nfc/config -d '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp3/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

Mit MQTT auf $PREFIX/nfc/config_update

mosquitto_pub -h $BROKER -t $PREFIX/nfc/config_update -m '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

Name	Beschreibung
deadtime_post_start int (s)	Erlaubt das Stoppen eines Ladevorgangs mit einem NFC-Tag erst nach dieser Zeit, um Fehlbedienung zu vermeiden.
authorized_tags object[32]	Eine Liste authorisierter Tags. [0..31] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

warp4

nfc/seen_tags

Die zuletzt von der Wallbox gesehenen NFC-Tags.

Beispiel

HTTP (curl)

# $HOST z.B. warp4-AbCd

Lesen

curl http://$HOST/nfc/seen_tags

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp4/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/seen_tags

[
  { "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE", "last_seen": 22724083 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "01:23:AB:3D", "last_seen": 10753 }
]

Index	Beschreibung
[0..7] object	Ein gesehenes NFC-Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.
[8] object	Das von nfc/inject_tag vorgetäuschte Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.

nfc/inject_tag

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Hiermit kann über die API ein Ladevorgang für einen bestimmten Benutzer gestartet oder gestoppt werden. Analog zur physischen Verwendung eines Tags wird der Ladevorgang bei Aufruf der API abwechselnd freigegeben oder blockiert. Siehe nfc/inject_tag_start und nfc/inject_tag_stop für genauere Kontrolle. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp4-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp4/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_start

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Starten eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp4-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_start -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp4/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_start -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_stop

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Stoppen eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp4-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_stop -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp4/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_stop -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/config

Die NFC-Konfiguration.

Beispiel

HTTP (curl)

# $HOST z.B. warp4-AbCd

Lesen

curl http://$HOST/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

curl http://$HOST/nfc/config -d '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp4/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

Mit MQTT auf $PREFIX/nfc/config_update

mosquitto_pub -h $BROKER -t $PREFIX/nfc/config_update -m '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

Name	Beschreibung
deadtime_post_start int (s)	Erlaubt das Stoppen eines Ladevorgangs mit einem NFC-Tag erst nach dieser Zeit, um Fehlbedienung zu vermeiden.
authorized_tags object[32]	Eine Liste authorisierter Tags. [0..31] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

wem

Auf dieser Hardware nicht unterstützt!

wem2

Auf dieser Hardware nicht unterstützt!

any

nfc/seen_tags

Die zuletzt von der Wallbox gesehenen NFC-Tags.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/nfc/seen_tags

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/seen_tags

[
  { "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE", "last_seen": 22724083 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "", "last_seen": 0 },
  { "tag_type": 0, "tag_id": "01:23:AB:3D", "last_seen": 10753 }
]

Index	Beschreibung
[0..7] object	Ein gesehenes NFC-Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.
[8] object	Das von nfc/inject_tag vorgetäuschte Tag Name Beschreibung tag_type int Typ des Tags 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D last_seen int (ms) Zeit in Millisekunden vor der das Tag zuletzt gesehen wurde.

nfc/inject_tag

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Hiermit kann über die API ein Ladevorgang für einen bestimmten Benutzer gestartet oder gestoppt werden. Analog zur physischen Verwendung eines Tags wird der Ladevorgang bei Aufruf der API abwechselnd freigegeben oder blockiert. Siehe nfc/inject_tag_start und nfc/inject_tag_stop für genauere Kontrolle. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_start

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Starten eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_start -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_start -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/inject_tag_stop

Täuscht vor, dass ein Tag vom NFC-Leser erkannt wurde. Das Tag wird nur zum Stoppen eines Ladevorgangs verwendet. Das vorgetauschte Tag ist immer der letzte Eintrag in nfc/seen_tags

http

mqtt

Löst eine einmalige Aktion aus. Nachrichten, die über den Broker retained wurden, werden ignoriert.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Schreiben

curl http://$HOST/nfc/inject_tag_stop -d '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Schreiben

mosquitto_pub -h $BROKER -t $PREFIX/nfc/inject_tag_stop -m '{ "tag_type": 0, "tag_id": "01:23:AB:3D" }'

Name	Beschreibung
tag_type int	Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4
tag_id string	ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D

nfc/config

Die NFC-Konfiguration.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

curl http://$HOST/nfc/config -d '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/nfc/config

{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}

Schreiben

Mit MQTT auf $PREFIX/nfc/config_update

mosquitto_pub -h $BROKER -t $PREFIX/nfc/config_update -m '{
  "authorized_tags": [
    { "user_id": 1, "tag_type": 2, "tag_id": "04:E3:B2:27:39:AD:FE" },
    { "user_id": 2, "tag_type": 0, "tag_id": "01:23:AB:3D" }
  ]
}'

Name	Beschreibung
deadtime_post_start int (s)	Erlaubt das Stoppen eines Ladevorgangs mit einem NFC-Tag erst nach dieser Zeit, um Fehlbedienung zu vermeiden.
authorized_tags object[..]	Eine Liste authorisierter Tags. (Nur WARP 1) [0..15] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D (Nur WARP 2 und WARP 3 und WARP 4) [0..31] - Ein autorisiertes NFC-Tag Name Beschreibung user_id int ID des Nutzers dem dieses Tag zugeordnet ist, oder 0 falls es keinem Nutzer zugeordnet ist. tag_type int Typ des Tags. 0 - Mifare Classic 1 - NFC Forum Typ 1 2 - NFC Forum Typ 2 3 - NFC Forum Typ 3 4 - NFC Forum Typ 4 tag_id string ID des Tags. Je nach Tag-Typ bis zu 10 Hex-Bytes, separiert durch ':'. z.B. 01:23:AB:3D