Not in your language

This page is not yet available in en. You're reading the de version.

iot

Updated: 9/27/2026

Stand: Commit 26e366a · 2026-09-27

Bildschirm-Geräte und Sensor-Knoten des Unternehmens koppeln, beobachten und fernsteuern; Firmware-Blueprints, Peripherie und Kennzeichen-Erkennung einrichten.

Funktionen

Geräte koppeln – Ein neues Gerät über den angezeigten QR-Code dem Unternehmen und einer Fläche zuweisen, neu zuweisen oder auf Werkszustand zurücksetzen.
Geräte beobachten und steuern – Bildschirmfoto, Vorschau, Telemetrie und Fernaktionen je Gerät; Szenen und Service-Aufrufe aus Steuertafeln.
Firmware-Blueprints und MCU-Geräte – Firmware je Unternehmen beschreiben, bauen lassen und über die Luft an Mikrocontroller-Geräte verteilen.
Peripherie – Drucker, NFC-Leser, Bluetooth-Sensoren und Scanner an ein Gerät koppeln, prüfen und wieder lösen.
Kennzeichen-Erkennung – Positivliste pflegen, Erkennungen und das Zufahrts-Protokoll einsehen.

Zweck

Der Bereich IoT bindet die Geräte Ihres Unternehmens an die Plattform: Steuertafeln, Wandanzeigen, Terminals, Werbeflächen, Zutritts-Terminals und Sensor-Knoten melden sich hier an, erhalten ihren Kontext und lassen sich aus der Verwaltung beobachten und fernsteuern. Dazu kommen die Mikrocontroller-Linie mit eigener Firmware je Unternehmen, die Peripherie an den Geräten und die Kennzeichen-Erkennung an Zufahrten.

Einrichten

Voraussetzung ist ein Paket, das das Modul IoT enthält. Die Geräte selbst legen Sie nicht von Hand an: ein Gerät registriert sich beim ersten Kontakt und erscheint danach in den Geräte-Ansichten. Die Stammdaten der Bildschirm-Geräte liegen im Bereich Konfiguration (IoT-Geräte, Steuertafeln, Terminals, Sensoren), Wandanzeigen im Bereich Projekte und Zutritts-Terminals im Bereich Personal; der Bereich IoT trägt die Kopplung, die Laufzeit, die Firmware und die Kennzeichen.

Rollen vorbereiten. Wer Geräte koppeln soll, braucht die drei Kopplungs-Rechte; wer Geräte beobachtet, das Laufzeit-Recht (siehe „Rollen und Rechte“). Die Rolle Administrator erhält alle Rechte des Moduls beim ersten Start automatisch.
Gerät koppeln. Ein frisch gestartetes Gerät zeigt einen QR-Code. Ein Mitarbeiter mit Kopplungs-Recht scannt ihn in der Plattform-App, wählt das Unternehmen und die Fläche und bestätigt. Danach lädt das Gerät seinen Kontext: Branding, Rechte und Peripherie. Über dieselbe Ansicht weisen Sie ein Gerät später einer anderen Fläche zu oder setzen es auf den Werkszustand zurück; die Zuordnung ist dann aufgehoben.
Gerät beobachten. In der Geräte-Ansicht sehen Sie das jüngste Bildschirmfoto, die Vorschau, den Telemetrie-Verlauf und lösen Fernaktionen aus. Bildschirmfotos sind Momentaufnahmen, die das Gerät hochlädt; ein Gerät ohne Verbindung zeigt ein altes Bild.
Peripherie koppeln. Drucker, NFC-Leser, Bluetooth-Sensoren und Scanner werden je Gerät gekoppelt (Aktion „Koppeln“ mit dem Token des Zubehörs), mit „Ping“ geprüft, mit „Token erneuern“ neu abgesichert und mit „Lösen“ wieder getrennt.
Firmware-Blueprints (nur für Mikrocontroller-Geräte). Unter IoT → Firmware-Blueprints legen Sie einen Blueprint an. Pflichtfelder sind der Name und die Beschreibung der Firmware; als Gerätetyp steht ESP32 zur Wahl. „Firmware bauen“ reiht den Bau ein; der Status wandert von Entwurf über In Warteschlange und Wird gebaut nach Gebaut oder Fehlgeschlagen. Unter IoT → MCU-Geräte sehen Sie je Gerät Seriennummer, Typ und ob es Online oder Offline ist, und stoßen die Aktualisierung über die Luft an. Der Kanal des Geräts bestimmt, welche Fassung es erhält.
Kennzeichen-Erkennung. Unter IoT → Positivliste tragen Sie je Kennzeichen (Pflichtfeld) den Halter als Kunde oder Mitarbeiter, eine Bezeichnung, den Gültigkeitszeitraum und die Geräte ein, für die der Eintrag gilt. Die Ansicht Erkennungen zeigt jede gemeldete Erkennung mit Zone, Richtung und Trefferwert; das Zufahrts-Protokoll zeigt nur die Treffer, also die gewährten Zufahrten.

Nach der Kopplung läuft ein Gerät ohne weiteres Zutun: es liest seinen Kontext über seine Seriennummer, prüft jeden Aufruf mit seinem beim ersten Kontakt hinterlegten Geheimnis und meldet Telemetrie.

Rollen und Rechte

Recht (Schlüssel)	Wirkung
`iot.pairing.lookup`, `iot.pairing.init`, `iot.pairing.assign`	Kopplungs-Token nachschlagen, Kopplung starten und ein Gerät dem Unternehmen und einer Fläche zuweisen. Alle drei gehören zusammen.
`iot.runtime.read`	Bildschirmfoto, Vorschau, Radar-Stand und Telemetrie eines Geräts lesen.
`iot.controlpanel`, `iot.wallboard`, `iot.terminal`	Die Flächen Steuertafel, Wandanzeige und Terminal auf einem Gerät nutzen; diese Rechte gibt die Plattform an das Gerät weiter.
`iot.iotdeviceblueprints`, `iot.devicecomponentdefinitions`	Firmware-Blueprints anlegen, bauen und verteilen; Bauteil-Definitionen pflegen.
`iot.printers`, `iot.nfcreaders`, `iot.blesensors`, `iot.scannerdevices`	Peripherie sehen; Koppeln, Lösen, Ping und Token erneuern tragen je ein eigenes Recht (`….actions.pair`, `….actions.unpair`, `….actions.ping`, `….actions.regenerate-token`).
`iot.plateallowlistentries`, `iot.plateevents`	Positivliste pflegen; Erkennungen und Zufahrts-Protokoll einsehen.
`iot.factorytestprotocols`	Prüfprotokolle der Werksprüfung einsehen.
`iot.iottelemetrysamples`	Telemetrie-Rohwerte lesen (nur lesend).

Die Stammdaten der Bildschirm-Geräte verlangen die Rechte der jeweiligen Bereiche: config.iotdevices, config.controlpanels, config.terminals, config.sensors, pm.wallboards und hr.accessterminals.

Laufender Betrieb

Der Bereich hat keine Zeitgeber. Zwei Abläufe laufen im Hintergrund: der Firmware-Bau eines Blueprints und Service-Aufrufe, die ein Mitarbeiter an einer Steuertafel auslöst und die als Auftrag an den Bereich Kommunikation gehen. Der Firmware-Bau ist ein eigener Hintergrund-Dienst; steht er, bleibt ein Blueprint im Status In Warteschlange, ohne dass die Ansicht einen Fehler meldet.

Anbindungen: Das Modul braucht keinen Zugangsschlüssel im Tresor und bringt keine Feature-Flags und keine Webhooks mit. Der Nachrichten-Kanal zwischen Plattform und Geräten wird von der Plattform betrieben; Sie richten nichts ein. Die Werksprüfung vor der Auslieferung läuft beim Hersteller; ein Gerät im Werksmodus gehört noch nicht Ihrem Unternehmen und erscheint erst nach der Kopplung.

Alle Geräte, Blueprints, Positivlisten und Ereignisse gehören Ihrem Unternehmen. Ein Blueprint wird ausschließlich für Geräte Ihres Unternehmens gebaut und verteilt. Kennzeichen-Regeln gelten je Unternehmen; ein Erkennungs-Gerät, das mehreren Zufahrten dient, braucht je Zufahrt einen Eintrag.

Störungen

Symptom	Wahrscheinliche Ursache	Was Sie tun können
Der QR-Code lässt sich nicht einlösen.	Die Rolle trägt nicht alle drei Kopplungs-Rechte.	Rechte prüfen; das Gerät neu starten, es zeigt einen frischen Code.
Das Gerät zeigt nach der Kopplung kein Branding und keine Inhalte.	Das Gerät hat beim ersten Kontakt kein Geheimnis registriert oder die Fläche fehlt.	Gerät auf Werkszustand zurücksetzen und neu koppeln; Fläche in der Zuweisung prüfen.
Das Bildschirmfoto ist alt.	Das Gerät sendet nicht; Netz oder Gerät ist offline.	Netzverbindung des Geräts prüfen; die Telemetrie zeigt den letzten Kontakt.
Ein Blueprint bleibt in „In Warteschlange“.	Der Hintergrund-Dienst für den Bau läuft nicht.	Warten; bleibt der Status, im Bereich Projekte unter Aufgaben nach einem Fehler-Eintrag des Moduls suchen und den Bau erneut anstoßen.
Ein Blueprint ist „Fehlgeschlagen“.	Die Beschreibung der Firmware enthält einen Fehler.	Blueprint bearbeiten und erneut bauen.
Ein Kennzeichen wird erkannt, die Zufahrt bleibt zu.	Der Eintrag ist nicht für dieses Gerät freigegeben oder außerhalb des Gültigkeitszeitraums.	Geräte und Zeitraum am Eintrag der Positivliste prüfen; die Ansicht Erkennungen zeigt den Grund je Erkennung.
Peripherie antwortet nicht auf „Ping“.	Das Zubehör ist vom Gerät getrennt oder sein Token ist ungültig.	„Token erneuern“ ausführen und das Zubehör neu koppeln.

Fehler aus dem Hintergrund legt die Plattform als Aufgabe vom Typ „Bug“ im Bereich Projekte ab; dort sehen Sie Zeitpunkt, Modul und Fehlertext.

Einstellungen und Rechte

Bildschirme

iot.iotdeviceblueprints
iot.mcudevices
iot.plateallowlistentries
iot.plateevents
iot.plateevents.access

Rechte

AccessTerminals
BleSensors
BuildingSpaces
CalendarEntries
CallContextLayouts
Consumers
ControlPanels
CustomButtons
DeviceComponentDefinitions
DeviceRegistrations
Documents
Employees
FactoryTestProtocols
IoTDeviceBlueprints
IoTDevices
IoTTelemetrySamples
Machines
NfcReaders
PlateAllowlistEntries
PlateEvents
Printers
SensorLogs
Sensors
Services
Settings
States
Tasks
TerminalRoles
Terminals
UserSettings
WallBoards
WorkCenters
aYOUneAdvertisementDisplayGroups
aYOUneAdvertisementDisplayLocations
aYOUneAdvertisementDisplays
aYOUneCustomers
aYOUnePackages
aYOUneUsers

Glossar

Fläche – Die Rolle eines Bildschirm-Geräts: Steuertafel, Wandanzeige, Terminal, Werbefläche oder Zutritts-Terminal.
Kopplung – Der Vorgang, mit dem ein frisch gestartetes Gerät über einen QR-Code an das Unternehmen gebunden wird.
Blueprint – Die Beschreibung einer Firmware für Mikrocontroller-Geräte; aus ihr wird die Firmware gebaut.
Positivliste – Die Kennzeichen, denen ein Erkennungs-Gerät die Zufahrt gewährt.

Work with this page

Ready-made instructions for your AI tool. Copy, paste, go — the AI fetches the content itself via the address in the text.

Summarise the steps for me The essentials, in the right order.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Summarise the content for me.

- First, in two sentences: what is this about?
- Then the steps in the order I need to take them.
- One line per step, in plain language.
- At the end: what I should have ready beforehand.

Leave out nothing I need in order to actually finish.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Explain what I need this for What it is good for — and when it is worth it.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain to me what I need this for.

1. Which problem does it solve? In one sentence, from my point of view.
2. Three typical situations in which it genuinely helps me.
3. When I do NOT need it — that saves me time.
4. What I can do instead if it is not a fit.

Stick to what the source says. Where it gives nothing, say so openly instead
of guessing.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Help me set this up Step by step, asking me as you go.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Walk me through the setup step by step.

- First tell me what I need to have ready (access, data, time).
- Then take me through ONE step at a time. Wait for my "next".
- For each step, say how I can tell that it worked.
- If something goes wrong, ask me for the exact message instead of guessing.

If the instructions leave a point open, tell me so rather than inventing it.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Help me with a problem Narrow down the cause instead of guessing.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Help me narrow down a problem.

- First ask me what I observe and what I expected instead.
- From that, derive the most likely causes consistent with this source.
- For each cause, give me ONE test that confirms or rules it out.
- Order them so the cheapest test comes first.

Do not guess. If the source does not cover the problem, tell me where I should
look next.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Explain it in plain words No jargon, from the ground up.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Explain the content so that someone without prior knowledge understands it.

- Start with the purpose: why does this exist at all?
- Explain technical terms in half a sentence on first use.
- One everyday comparison where it genuinely holds — none where it limps.
- At the end: the three things worth remembering.

Do not shorten by dropping conditions. A simplification that hides a
prerequisite is a false statement.
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

A checklist to tick off To follow along while you do it.

Open in ChatGPT

Read the following documentation by tolinax UG and work with it.

This page: https://ayoune.com/en/docs/admin-handbook/iot.md
The complete collection: https://ayoune.com/en/docs/admin-handbook.md

Turn this into a **tick-off checklist** for practical use.

- Exactly one action per item, in the imperative.
- Order it so that no item depends on a later prerequisite.
- Prerequisites and pitfalls as indented sub-items.
- End with an acceptance step: how do I know everything is right?
A note on sources:
- Every page of this documentation is available as Markdown (the same address with `.md`).
- A machine-readable overview of all public content is at `/llms.txt`.
- If you have access to the aYOUne MCP server, you can work against live data
  instead of this snapshot. If not, ignore this point.

Was this article helpful?

👎 No (0)