> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/devices/registering-devices.md).

# Geräte registrieren

Registrieren Sie ein Gerät in Kilo IoT über LNS, MIOTY, Tracker, MQTT oder den Emulator — erstellen Sie seinen Digital Twin, sein Profil und die Metrik-Zuordnungen.

Jedes auf dem Kilo IoT Server registrierte Gerät wird zu einem Digital Twin — einer vollständigen digitalen Repräsentation, die den aktuellen Zustand, die Konfiguration, die Telemetriehistorie und die Verhaltensmuster des Geräts widerspiegelt. Der Digital Twin bleibt bestehen, selbst wenn das physische Gerät offline ist, und bietet Ihnen eine kontinuierliche Betriebsansicht Ihrer gesamten Bereitstellung. Da die physische Gerätebindung optional ist, können Sie ein Geräteprofil erstellen und vollständig konfigurieren, bevor die Hardware verbunden ist — Einrichtung und Hardware-Inbetriebnahme müssen also nicht gleichzeitig erfolgen. Mit dem [Emulator](/kilo-docs-de/kilo-iot-server/devices/emulated-devices.md), können Sie noch weiter gehen und das Gerät Daten erzeugen lassen, bevor die Hardware überhaupt existiert.

Die Geräteregistrierung ist der Prozess, bei dem dieser Digital Twin erstellt und über einen Connector mit einem physischen Gerät verknüpft wird. Der Registrierungsablauf führt Sie durch die Benennung des Geräts, die Bindung an einen Connector, die Konfiguration seines Kommunikationsprofils und die Zuordnung der von ihm gemeldeten Messwerte.

## Voraussetzungen

Bevor Sie ein Gerät registrieren, benötigen Sie:

* **Einen Connector** — mindestens ein LNS-, Mioty-, Tracker-, MQTT-(Cloud oder Extern) oder Emulator-Connector muss eingerichtet sein. Siehe [Connectors](/kilo-docs-de/kilo-iot-server/connectors.md) und die [MQTT-Connector](/kilo-docs-de/kilo-iot-server/connectors/mqtt-connector.md) Dokumentation.
* **Gerätekennungen** — für LoRaWAN-Geräte: die Device EUI und der AppKey (typischerweise auf dem Gerät oder seiner Verpackung aufgedruckt). Für MIOTY-Endpunkte: die End Point EUI und der Network Session Key. Für Tracker-Geräte: die vom Hersteller bereitgestellte Unique ID. Für MQTT-Geräte: das Topic-Element auf Geräteebene, unter dem das Gerät publisht und das als Device ID im Gerätedatensatz verwendet wird; es muss exakt bytegenau mit dem veröffentlichten Segment übereinstimmen (Leerzeichen werden bei der Eingabe entfernt). **Emulierte Geräte benötigen nichts davon** — Sie wählen die Device ID selbst.
* **Nur für MQTT-Geräte — das Gerät muss bereits veröffentlichen, bevor die Zuordnung abgeschlossen werden kann.** Das Dropdown für den Connector-Schlüssel auf der Registerkarte „Zuordnung“ wird aus Payload-Schlüsseln befüllt, die tatsächlich vom Gerät empfangen wurden. Siehe den [Abschnitt zum MQTT-spezifischen Verhalten](#mqtt-specific-behavior) unten für den Zwei-Durchgänge-Workflow.

## Wo Sie anfangen

Für die Geräteregistrierung gibt es zwei Einstiegspunkte — beide öffnen denselben Dialog „Gerät verwalten“:

1. **Geräte** — Klicken Sie **Geräte** in der Seitenleiste. Diese Seite zeigt alle Geräte aller Connectoren. Klicken Sie **Gerät hinzufügen** oben rechts.
2. **Connector-Zeilenaktion** — Auf der **Connectors** Seite klicken Sie auf die **+ Gerät hinzufügen** Schaltfläche in einer beliebigen Connector-Zeile. Der Dialog öffnet sich mit diesem Connector vorausgewählt.

Das Geräteformular ist für kleine Bildschirme ebenso wie für den Desktop ausgelegt, sodass Sie Hardware direkt am Installationsort mit einem Smartphone registrieren können.

## Phase 1 — Geräteprofil erstellen

Der Dialog öffnet sich im **Gerät hinzufügen** Modus und zeigt nur den Abschnitt **Geräteinfo** . Noch sind keine Tabs oder Navigationspunkte sichtbar — der erste Schritt besteht einfach darin, das Gerät zu identifizieren.

* **Gerätefotos** — Laden Sie optional Fotos des physischen Geräts zur visuellen Identifikation hoch.
* **Gerätename** — Geben Sie einen beschreibenden Namen ein (erforderlich). Verwenden Sie eine Benennungskonvention, die in Ihrer Bereitstellung skaliert — zum Beispiel, indem Sie den Standort oder den Gerätetyp in den Namen aufnehmen.

Klicken Sie auf **Speichern**. Der Digital Twin wird nur mit dem Namen und einem optionalen Foto erstellt. Der Dialog wechselt automatisch in den Bearbeitungsmodus.

## Phase 2 — Verbindung, Messwerte und Protokolle konfigurieren

Nach dem ersten Speichern wird der Dialog erneut geöffnet mit **Geräteinfo**, **Verbindung**, **Zuordnung** und **Protokolle** Tabs und einer **Weiter** Schaltfläche zum Navigieren zwischen ihnen. Hier binden Sie das Gerät an einen Connector und konfigurieren seine Daten. Zwei weitere Tabs erscheinen, wenn sie zutreffen: **Befehle & Zustände** bei einem Gerät, das Downlinks empfangen kann, und **Emulator** bei einem an den Emulator-Connector gebundenen Gerät.

### Registerkarte „Verbindung“

Diese Registerkarte bindet den Digital Twin an das Gerät, das ihn über einen Connector versorgt. Das Dropdown listet die Connectoren auf, die Ihre Organisation tatsächlich hat, nach Name und Typ, und die Felder darunter ändern sich passend zu Ihrer Auswahl.

<figure><img src="https://895787959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-0b1b2e7c7299f6756315a0c0b160108d1f843f07%2Fdevice-connector-type-list.jpg?alt=media" alt="The Connection tab of a device with the connector type dropdown open, listing the organization&#x27;s connectors by name and type"><figcaption></figcaption></figure>

#### Für LoRaWAN-Geräte (LNS-Connector)

1. **Connector-Typ** — Wählen Sie den LNS-Connector aus dem Dropdown. Wenn nur ein LNS-Connector existiert, ist er möglicherweise bereits vorausgewählt.
2. **Device EUI** — Geben Sie die eindeutige LoRaWAN-Kennung des Geräts ein (8-Byte-Hexadezimalzeichenfolge, angezeigt als `HH HH HH HH HH HH HH HH`). Diese ist typischerweise auf dem Geräteetikett oder der Verpackung aufgedruckt. Sobald ein physisches Gerät gebunden ist, kann dieses Feld nicht geändert werden, ohne das Gerät zuerst zu trennen.

   **QR-Code scannen** — Anstatt sechzehn Hex-Zeichen von einem Etikett abzutippen, klicken Sie auf **QR-Code scannen** und halten Sie die Kamera Ihres Laptops oder Smartphones auf den QR-Code am Gerät oder seiner Verpackung. Die Device EUI wird aus dem Code übernommen, und wenn der Code auch den AppKey enthält, wird dieses Feld ebenfalls befüllt. Das ist der schnellere und sicherere Weg bei der Inbetriebnahme von Geräten in großen Stückzahlen — ein einziges falsch eingegebenes Zeichen in einer DevEUI führt zu einem Gerät, das stillschweigend nie beitritt.

   Wenn der Browser nicht auf eine Kamera zugreifen kann, meldet der Scanner **„QR-Code-Scanner wurde nicht gefunden. Bitte versuchen Sie es erneut.“** Prüfen Sie, ob eine Kamera vorhanden ist und ob dem Browser Kameraberechtigungen für die Website erteilt wurden, und versuchen Sie es dann erneut — oder geben Sie die Kennungen manuell ein.
3. **Geräteprofilvorlagen verwenden** — Aktivieren Sie diese Option, um aus einer Bibliothek bekannter Geräteprofile auszuwählen.

   Geräteprofilvorlagen sind praktische Voreinstellungen für bekannte LoRaWAN-Geräte. Jede Vorlage enthält die LoRaWAN-Klasse des Geräts, das Frequenzband und einen **Codec** — die Payload-Dekodierlogik, die die rohen binären Uplink-Daten des Geräts in lesbare Felder übersetzt. Die Auswahl einer Vorlage ist ein zweistufiger Prozess:

   * **Marke** — Wählen Sie den Gerätehersteller aus der Autovervollständigungs-Liste.
   * **Modell** — Wählen Sie das Gerätemodell. Die Liste filtert sich anhand der ausgewählten Marke.
   * **Profil** — Wählen Sie das Vorlagenprofil für dieses Gerät. Die Optionen werden aus den unterstützten regionalen Bändern des Modells abgeleitet.

   Sobald Sie alle drei ausgewählt haben, ruft der Server die passende Vorlage ab und übernimmt deren Konfiguration in das Formular: Die LoRaWAN- **Klasse**, **Band** und **Codec**  werden automatisch ausgefüllt. Sie können diese Werte vor dem Speichern überprüfen und anpassen.

   Vorlagen werden als praktische Hilfen bereitgestellt. Eine korrekte Payload-Dekodierung ist nicht für jede Firmware-Version oder Hardware-Revision garantiert. Wenn der Codec einer Vorlage fehlende oder falsche Felder erzeugt, können Sie die **Code-Funktionen** direkt bearbeiten (siehe unten).

   Wenn Sie keine Vorlage verwenden, konfigurieren Sie das Profil manuell:

   * **Klasse** — Wählen Sie die LoRaWAN-Geräteklasse:
     * **Klasse A** — Das Gerät schläft zwischen den Übertragungen und öffnet nur kurze Empfangsfenster nach jedem Uplink. Das ist äußerst energieeffizient — die meisten batteriebetriebenen Sensoren verwenden Klasse A und können jahrelang mit einer einzigen Batterie laufen.
     * **Klasse C** — Das Gerät hält seinen Empfänger dauerhaft offen, sodass es jederzeit Downlink-Befehle vom Server empfangen kann. Da das Funkmodul ständig lauscht, verbrauchen Klasse-C-Geräte deutlich mehr Strom und werden typischerweise netzbetrieben. Wählen Sie Klasse C für Geräte, die sofort auf Befehle reagieren müssen, etwa Aktoren, Schalter oder Anzeigen.
   * **Marke** und **Modell** — Geben Sie Hersteller und Modell des Geräts als Freitext ein.
   * **Band** — Wählen Sie das LoRaWAN-Frequenzband für Ihre Region. Das Band muss zur Konfiguration Ihres Gateways und zu den Funkvorschriften Ihrer Region passen. Verfügbare Optionen: EU868 (Europa), US915 (USA), AU915 (Australien), AS923 (Asien), KR920 (Südkorea), IN865 (Indien), RU864 (Russland), CN470 (China), CN779 (China), EU433 (Europa 433 MHz), ISM2400 (2,4 GHz global). Eine vollständige Liste der Frequenzbänder nach Land finden Sie unter [LoRaWAN-Frequenzen](/kilo-docs-de/kilo-iot-server/connectors/lns-connector/lorawan-frequencies.md). Eine Einführung in LoRaWAN finden Sie unter [Was ist LoRaWAN?](/kilo-docs-de/kilo-iot-server/connectors/lns-connector/what-is-lorawan.md).
   * **AppKey** — Geben Sie den Anwendungsschlüssel des Geräts ein — den LoRaWAN-Verschlüsselungsschlüssel, der für die Over-the-Air-Aktivierung (OTAA) verwendet wird. Dieser wird typischerweise vom Gerätehersteller bereitgestellt; prüfen Sie die Geräteverpackung oder die offizielle Dokumentation.

#### Zum Vault hinzufügen

Geräteanmeldedaten landen oft irgendwo unpraktisch: als Aufkleber an einem Gerät, das jetzt sechs Meter hoch in einem Lagergang montiert ist. Klicken Sie auf **Zum Vault hinzufügen** dem Geräteformular, um die EUI und das Schlüsselpaar des Geräts im Key Vault zu speichern, wo sie unabhängig von Hardware und Etikett wieder abgerufen werden können. Bei einem LoRaWAN-Gerät speichert dies den AppKey zum DevEUI.

Tun Sie dies bei der Registrierung, solange die Anmeldedaten vor Ihnen liegen. Ein Gerät neu zu provisionieren, dessen AppKey Sie nicht mehr zur Hand haben, bedeutet, wieder direkt zum Gerät zurückzukehren — und ob sich der Schlüssel an dieser Stelle auslesen lässt, hängt vom Hersteller ab und kann eine Kabelverbindung zur Platine erfordern. Siehe [Key Vault](/kilo-docs-de/kilo-iot-server/reports/key-vault.md).

#### Code-Funktionen (Codec)

Die **Code-Funktionen** Das Feld enthält den Payload-Codec des Geräts — JavaScript-Logik, die die rohen LoRaWAN-Uplink-Payloads des Geräts in benannte Felder dekodiert. Diese dekodierten Felder werden zu den **Connector-Schlüsseln** die auf der Registerkarte „Zuordnung“ sichtbar sind.

Wenn Sie eine Geräteprofilvorlage auswählen, wird dieses Feld automatisch mit dem Codec der Vorlage befüllt. Wenn Sie manuell konfigurieren, ist dieses Feld zunächst leer — Sie müssen möglicherweise einen Codec aus der Dokumentation des Geräteherstellers oder aus einem Community-Codec-Repository einfügen.

Wenn die dekodierte Ausgabe nicht dem entspricht, was Sie erwarten — zum Beispiel, wenn Felder fehlen, Werte falsch aussehen oder Feldnamen nicht zur Dokumentation Ihres Sensors passen —, können Sie den Code direkt bearbeiten. Der Editor ist ein mehrzeiliges Textfeld mit Monospace-Formatierung.

<figure><img src="https://895787959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2FfxlAml2eAelfgb3nPtsw%2Fimage.png?alt=media&amp;token=714b80f3-4af8-46ee-ab77-de6e9d90167a" alt="The Connection tab of a LoRaWAN device, showing the device profile fields and the Code functions codec editor"><figcaption></figcaption></figure>

#### Sendeintervall der Daten

Ein Gerät sendet nach einem festen Zeitplan — alle paar Minuten, einmal am Tag, einmal im Monat — und dieser Zeitplan wird **auf dem Gerät selbst**. Er unterscheidet sich von Hersteller zu Hersteller: Einige Geräte werden bereits mit dem vom Hersteller eingestellten Intervall ausgeliefert, andere müssen bei der Inbetriebnahme konfiguriert werden. In jedem Fall ist der Zeitplan eine Eigenschaft des Geräts. Das **Sendeintervall der Daten** Feld ist der Ort, an dem Sie der Plattform mitteilen, wie dieser Zeitplan aussieht, damit sie weiß, wann sie Daten erwarten kann.

Stellen Sie ihn so ein, dass er der tatsächlichen Konfiguration des Geräts zum Senden entspricht. Wenn das Gerät einmal pro Tag sendet, setzen Sie dies auf **1 Tag**; einmal pro Monat setzen Sie es auf **1 Monat**. Das Feld beginnt standardmäßig bei **1 Stunde** nur deshalb, weil die Plattform einen Anfangswert benötigt — sie hat keine Möglichkeit, den echten Zeitplan des Geräts auszulesen, also betrachten Sie diesen Standardwert als Platzhalter, den Sie ersetzen.

Wenn innerhalb des konfigurierten Intervalls keine Nachricht eingeht, wird das Gerät in der Geräteliste als offline markiert und auf der Geräte-Karte der Übersichtsseite hervorgehoben. Das Intervall an das Gerät anzupassen verhindert, dass ein gesundes, selten sendendes Gerät einfach deshalb als offline markiert wird, weil es zwischen geplanten Berichten still ist.

Wählen Sie eine Zahl und eine Einheit: **Minute**, **Stunde**, **Tag**, **Woche**, oder **Monat**.

> **Emulierte Geräte sind die Ausnahme.** Bei einem an den Emulator-Connector gebundenen Gerät ist dieses Feld keine Beschreibung eines Zeitplans, den die Hardware bereits einhält — es *ist* der Zeitplan, den die Plattform ausgibt. Siehe [Emulierte Geräte](/kilo-docs-de/kilo-iot-server/devices/emulated-devices.md).

#### Für Fahrzeug-Tracker (Tracker-Connector)

1. **Connector-Typ** — Wählen Sie den Tracker-Connector aus dem Dropdown.
2. **Unique ID** — Geben Sie die eindeutige Gerätekennung des Trackers ein.
3. **Gerätemodell** — Suchen und wählen Sie aus der Tracker-Modellbibliothek aus. Beginnen Sie mit der Eingabe, um die Liste zu filtern.
4. **URL für GPS-Tracker** — Nachdem Sie ein Modell ausgewählt haben, erscheint ein Bereich mit der Endpunkt-URL. Klicken Sie auf die Kopierschaltfläche, um sie zu kopieren, und konfigurieren Sie dann Ihren Tracker so, dass er Daten an diese URL sendet.

#### Für MIOTY-Endpunkte (Mioty-Connector)

Wählen Sie den Mioty-Connector aus dem Dropdown, und das Formular zeigt den MIOTY-Parametersatz an — End Point EUI, Kurzadresse, Network Session Key und Zähler. Diese Felder, ihre gültigen Wertebereiche und die Vorlage, die die Payloads des Endpunkts dekodiert, sind vollständig dokumentiert unter [MIOTY-Geräte](/kilo-docs-de/kilo-iot-server/devices/mioty-devices.md).

#### Für emulierte Geräte (Emulator-Connector)

Wählen Sie den Emulator-Connector aus, und das Gerät erzeugt seine eigenen Telemetriedaten, anstatt sie zu empfangen — keine Kennungen, keine Anmeldedaten, keine Hardware. Sie vergeben ihm eine Device ID, wählen aus, was es misst (per Hand oder aus einer Gerätevoreinstellung), und legen fest, wie oft es Meldungen sendet. Eine zusätzliche **Emulator** Registerkarte ermöglicht es Ihnen dann, seine Werte direkt zu steuern.

So bauen Sie eine Bereitstellung auf, bevor die Sensoren eintreffen, und stellen später dasselbe Gerät auf echte Hardware um. Siehe [Emulierte Geräte](/kilo-docs-de/kilo-iot-server/devices/emulated-devices.md).

### Registerkarte „Zuordnung“

Diese Registerkarte ordnet die rohen Sensordaten des Geräts den normalisierten Messdefinitionen zu. Wenn für den Gerätetyp Metrikvorlagen konfiguriert wurden, können die Zuordnungen automatisch befüllt werden. Andernfalls können Sie Metrikvorlagen manuell zuweisen.

#### Connector-Schlüssel — sehen Sie, was das Gerät sendet

Sobald das Gerät verbunden ist und Daten sendet, zeigt die Registerkarte „Zuordnung“ eine **Tabelle der Connector-Schlüssel** an, die jedes Feld in der rohen Payload des Geräts zeigt. Jede Zeile zeigt den Feldnamen (genau so, wie das Gerät ihn sendet — z. B. `t`, `temp1`, `humidity_pct`), seinen aktuellen Wert und den Zeitstempel der letzten Aktualisierung. Dies ist die Live-Payload des Geräts, die in Echtzeit aktualisiert wird.

Kehren Sie zu dieser Tabelle zurück, wann immer Sie wissen müssen, was ein Gerät meldet und in welcher Form — etwa beim Schreiben einer Regelbedingung oder beim Festlegen des erwarteten Werts für einen Befehl. Siehe [Payload-Dekodierung und Connector-Schlüssel](/kilo-docs-de/kilo-iot-server/devices/payload-decoding.md).

#### Rohfelder Metrikvorlagen zuordnen

Hier verwandeln Sie kryptische Geräteausgaben in aussagekräftige, beschriftete Messwerte. Wenn Sie einen rohen Connector-Schlüssel (wie `t`) einer Metrikvorlage zuordnen (wie „Temperatur“, Einheit: °C, Typ: Float), geben Sie diesem Rohfeld eine lesbare Identität. Von da an zeigen Dashboards, Automatisierungsregeln, Alarme und historische Abfragen alle „Temperatur (°C)“ an — nicht den Rohfeldnamen, den die Gerätefirmware sendet.

Um ein Rohfeld zu normalisieren:

1. **Metrik hinzufügen** — Klicken Sie **Schlüssel hinzufügen** und wählen Sie eine Metrikvorlage aus dem Dropdown (z. B. „Temperatur“, Einheit: °C, Typ: Float). Die Spalten Einheit, Typ und Datentyp werden automatisch aus der Vorlage befüllt. Wenn die benötigte Vorlage nicht existiert, erstellen Sie zuerst eine in [Messwerte](/kilo-docs-de/kilo-iot-server/devices/metric-templates.md) .
2. **Wählen Sie den Connector-Schlüssel aus** — Wählen Sie in dem **Connector-Schlüssel** Dropdown für diese Metrik den Rohfeldnamen aus, der zu diesem Messwert gehört (z. B. wählen Sie `t` für ein Gerät, das Temperatur als `t`).
3. **Speichern** — Die Zuordnung wird sofort wirksam. Normalisierte Daten fließen durch Dashboards, Automatisierungsregeln, Alarmauswertungen und historische Abfragen.

Wenn der Connector-Schlüssel nicht ausgefüllt ist, werden die Daten für diese Metrik ignoriert.

Wiederholen Sie das für jeden Messwert, den das Gerät meldet. Mehrere Metriken können in einer Sitzung zugeordnet werden.

#### Jedes Gerät, jedes Payload-Format

Dieser Ablauf akzeptiert Daten von jedem Gerät, das der Server empfangen kann — einschließlich Prototyp-Hardware mit sich weiterentwickelnden Payload-Schemata, Sensoren kleiner Hersteller mit undokumentierten Telemetrieformaten und Legacy-Feldgeräten, die kodierte Kennungen statt lesbarer Feldnamen übertragen. Wenn das Gerät Daten sendet, zeigt die Tabelle der Connector-Schlüssel sie an und Sie können sie zuordnen.

Einzelheiten zum Einrichten von Metrikvorlagen finden Sie unter [Messwerte](/kilo-docs-de/kilo-iot-server/devices/metric-templates.md).

#### MQTT-spezifisches Verhalten

Für Geräte, die über den [MQTT-Connector](/kilo-docs-de/kilo-iot-server/connectors/mqtt-connector.md)eingelesen werden, gelten zwei Besonderheiten im Registrierungsablauf:

* **Das Dropdown für den Connector-Schlüssel ist leer, bis die erste Veröffentlichung eintrifft.** Das Dropdown wird aus Payload-Schlüsseln befüllt, die tatsächlich vom Gerät empfangen wurden, nicht aus einer Freitexteingabe. Für einen brandneuen MQTT-Gerätedatensatz erfordert dies einen Speichervorgang in zwei Durchgängen: Fügen Sie pro Metrik eine Zeile hinzu, wählen Sie den normalisierten Schlüssel aus und setzen Sie den Datentyp, lassen Sie den Connector-Schlüssel leer, speichern Sie, bestätigen Sie, dass das Gerät sendet, öffnen Sie den Gerätedatensatz erneut — jetzt ist das Dropdown für den Connector-Schlüssel befüllt, ordnen Sie jede Zeile zu und speichern Sie erneut.
* **Wertspalte der Registerkarte „Zuordnung“ vs. Historie der Registerkarte „Protokolle“.** Die Wertspalte ist eine Live-Schnappschussansicht der jüngsten Payload (wird bei jeder akzeptierten Veröffentlichung aktualisiert, unabhängig davon, ob Connector-Schlüssel befüllt sind). Die Registerkarte „Protokolle“ ist die Historie pro Sensor (befüllt nur durch Veröffentlichungen, die *nach* dem Speichern der Connector-Schlüssel eintreffen). Nachdem Sie den zweiten Durchgang abgeschlossen haben, erzeugen Sie eine neue Veröffentlichung, um die Registerkarte „Protokolle“ zu füllen — ältere Veröffentlichungen werden nicht nachträglich normalisiert.
* **Die Zuordnung ist iterativ.** Bei der ersten Registrierung werden selten alle nützlichen Payload-Schlüssel erfasst. Sobald Live-Daten über einen repräsentativen Zeitraum eingetroffen sind, öffnen Sie den Gerätedatensatz erneut, prüfen Sie das Dropdown für den Connector-Schlüssel und die Wertspalte, um zu sehen, was tatsächlich veröffentlicht wird, fügen Sie Zuordnungszeilen für alle zusätzlichen Felder hinzu, die Sie verfolgen möchten, speichern Sie und lösen Sie eine neue Veröffentlichung aus, damit die Registerkarte „Protokolle“ beginnt, die Historie für die neuen Zuordnungen aufzuzeichnen.

Siehe [Topics und Gerätrouting](/kilo-docs-de/kilo-iot-server/connectors/mqtt-connector/topics-and-device-routing.md) für den vollständigen MQTT-spezifischen Registrierungsablauf.

### Registerkarte „Protokolle“

Die Registerkarte „Protokolle“ ist zunächst leer. Sobald das Gerät beginnt, Daten zu senden, zeigt diese Registerkarte das Rohereignisprotokoll mit Zeitstempeln und Payload-Details an.

Klicken Sie auf **Speichern** erneut, um die Verbindungs- und Metrikkonfiguration zu speichern.

## Nach dem Speichern

Das Gerät erscheint in den Gerätelisten im gesamten Server — in der Gerätetabelle des Connectors, unter Geräte und in allen Dashboards oder Automatisierungsregeln, die darauf verweisen.

Bei LoRaWAN-Geräten beginnen die Daten zu fließen, sobald das physische Gerät eine Join-Anfrage sendet und der Server sie akzeptiert. Bei Tracker-Geräten beginnen die Daten zu fließen, sobald der Tracker beginnt, Daten an den konfigurierten URL-Endpunkt zu senden.

Das Registrieren eines Geräts hier bedeutet nicht, dass es sich verbindet. Ein LoRaWAN-Gerät ist jeweils nur mit einem Netzwerk verbunden, daher bleibt ein Gerät, das zuvor anderswo in Betrieb genommen wurde — von einem anderen Standort zurückgegeben, gebraucht gekauft oder auf einer anderen Plattform betrieben — mit diesem Netzwerk verbunden, bis es zurückgesetzt wird und eine neue Join-Anfrage sendet. Werksneue Hardware verbindet sich von selbst; alles mit Vorgeschichte benötigt in der Regel zuerst einen Reset. Siehe [Bevor irgendetwas eintrifft: dem Netzwerk beitreten](/kilo-docs-de/kilo-iot-server/devices/device-diagnostics.md#before-anything-arrives-joining-the-network).

Wenn das Gerät registriert ist, aber keine Daten eintreffen, öffnen Sie seine **Verbindung** Registerkarte und lesen Sie den Empfangsstatus — er meldet, ob das Gerät das Netzwerk erreicht hat, ob Nachrichten empfangen werden und ob die Werte darin gespeichert werden, zusammen mit dem spezifischen nächsten Schritt für jeden Fall. Siehe [Gerätediagnose](/kilo-docs-de/kilo-iot-server/devices/device-diagnostics.md).

## Wie geht es weiter

* **Metrikvorlagen konfigurieren** vor oder nach der Registrierung, um zu steuern, wie Rohdaten normalisiert werden. Siehe [Messwerte](/kilo-docs-de/kilo-iot-server/devices/metric-templates.md).
* **Geräteeigenschaften bearbeiten** jederzeit über denselben Dialog. Siehe [Geräteverwaltung](/kilo-docs-de/kilo-iot-server/devices/device-management.md).
* **Ein stummes Gerät diagnostizieren** in seiner Registerkarte „Verbindung“. Siehe [Gerätediagnose](/kilo-docs-de/kilo-iot-server/devices/device-diagnostics.md).
* **Einen MIOTY-Endpunkt registrieren** und seine protokollspezifischen Felder. Siehe [MIOTY-Geräte](/kilo-docs-de/kilo-iot-server/devices/mioty-devices.md).
* **Ohne Hardware starten** und später zum echten Gerät wechseln, wenn es ankommt. Siehe [Emulierte Geräte](/kilo-docs-de/kilo-iot-server/devices/emulated-devices.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/devices/registering-devices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
