Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Simulieren der Device Shadow-Servicekommunikation

In diesem Thema wird veranschaulicht, wie der Device Shadow-Service als Vermittler fungiert und es Geräten und Apps ermöglicht, einen Schatten zum Aktualisieren, Speichern und Abrufen des Status eines Geräts zu verwenden.

Um die in diesem Thema beschriebene Interaktion zu demonstrieren und sie weiter zu untersuchen, benötigen Sie ein AWS-Konto und ein System, auf dem Sie das AWS CLI ausführen können. Wenn Sie diese nicht haben, können Sie die Interaktion immer anhand der Codebeispiele untersuchen.

In diesem Beispiel steht die AWS IoT Konsole für das Gerät. Das AWS CLI steht für die App oder den Dienst, der über den Shadow auf das Gerät zugreift. Die AWS CLI Schnittstelle ist der, mit AWS IoT der API eine App möglicherweise kommuniziert, sehr ähnlich. Das Gerät in diesem Beispiel ist eine intelligente Glühlampe, und die App zeigt den Status der Glühlampe an und kann ihren Status ändern.

Einrichten der Simulation

Diese Verfahren initialisieren die Simulation, indem Sie die AWS IoT -Konsole öffnen, die Ihr Gerät simuliert, und das Befehlszeilenfenster, das Ihre App simuliert.

Sie sollten zwei Fenster geöffnet haben: eines mit der AWS IoT Konsole auf der Testseite und eines mit einer Befehlszeilenaufforderung.

Initialisieren des Geräts

In dieser Simulation arbeiten wir mit einem Dingobjekt mit dem Namen mySimulatedThing, und seinem Schatten mit dem Namen simShadow1.

Erstellen des Objekts und seiner IoT-Richtlinie

Um ein Objekt zu erstellen, gehen Sie in der AWS IoT Konsole wie folgt vor:

Erstellen Sie einen benannten Schatten für das Objekt.

Sie können einen benannten Schatten für ein Objekt erstellen, indem Sie eine Aktualisierungsanfrage für das Thema $aws/things/mySimulatedThing/shadow/name/simShadow1/update, wie unten beschrieben, veröffentlichen.

Oder, um einen benannten Schatten zu erstellen:

Abonnieren und veröffentlichen Sie reservierte MQTT Themen

Abonnieren Sie in der Konsole die reservierten MQTT Shadow-Themen. Diese Themen sind die Antworten auf die Aktionen get, update und delete, damit Ihr Gerät bereit ist, die Antworten zu empfangen, nachdem es eine Aktion veröffentlicht hat.

Um zu einem MQTT Thema im MQTTClient zu veröffentlichen

Nachdem ein Gerät sich selbst initialisiert und die Antwortthemen abonniert hat, sollte Abfragen nach den unterstützten Schatten durchführen. Diese Simulation unterstützt nur einen Schatten, nämlich den Schatten, der ein Dingobjekt mit dem Namen, mySimulatedThing, benannt, simShadow1 unterstützt.

Wenn Sie eine Nachricht zum Thema erhalten:

Senden einer Aktualisierung von der App

In diesem Abschnitt wird anhand von demonstriert, wie eine App mit einem Schatten interagieren kann. AWS CLI

Um den aktuellen Status des Schattens mit dem zu ermitteln AWS CLI

Geben Sie in der Befehlszeile den folgenden Befehl ein.

aws iot-data get-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 /dev/stdout

Auf Windows-Plattformen können Sie con anstelle von /dev/stdout verwenden.

aws iot-data get-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 con

Da der Schatten vorhanden ist und vom Gerät initialisiert wurde, um seinen aktuellen Zustand wiederzugeben, sollte das folgende Schattendokument zurückgegeben werden.

{
  "state": {
    "reported": {
      "ID": "SmartLamp21",
      "ColorRGB": [
        128,
        128,
        128
      ]
    }
  },
  "metadata": {
    "reported": {
      "ID": {
        "timestamp": 1591140517
      },
      "ColorRGB": [
        {
          "timestamp": 1591140517
        },
        {
          "timestamp": 1591140517
        },
        {
          "timestamp": 1591140517
        }
      ]
    }
  },
  "version": 3,
  "timestamp": 1591141111
}

Die App kann diese Antwort verwenden, um die Darstellung des Gerätestatus zu initialisieren.

Wenn die App den Status aktualisiert, z. B. wenn ein Endbenutzer die Farbe unserer intelligenten Glühlampe zu Gelb ändert, sendet die App einen update-thing-shadow-Befehl. Dieser Befehl entspricht dem UpdateThingShadow RESTAPI.

So aktualisieren Sie einen Schatten aus einer App:

Geben Sie in der Befehlszeile den folgenden Befehl ein.

AWS CLI v2.x

aws iot-data update-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 \
    --cli-binary-format raw-in-base64-out \
    --payload '{"state":{"desired":{"ColorRGB":[255,255,0]}},"clientToken":"21b21b21-bfd2-4279-8c65-e2f697ff4fab"}' /dev/stdout

AWS CLI v1.x

aws iot-data update-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 \
    --payload '{"state":{"desired":{"ColorRGB":[255,255,0]}},"clientToken":"21b21b21-bfd2-4279-8c65-e2f697ff4fab"}' /dev/stdout

Wenn dieser Befehl erfolgreich ist, sollte das folgende Schattendokument zurückgegeben werden.

{
  "state": {
    "desired": {
      "ColorRGB": [
        255,
        255,
        0
      ]
    }
  },
  "metadata": {
    "desired": {
      "ColorRGB": [
        {
          "timestamp": 1591141596
        },
        {
          "timestamp": 1591141596
        },
        {
          "timestamp": 1591141596
        }
      ]
    }
  },
  "version": 4,
  "timestamp": 1591141596,
  "clientToken": "21b21b21-bfd2-4279-8c65-e2f697ff4fab"
}

Reaktion auf eine Aktualisierung im Gerät

Wenn Sie in der AWS Konsole zum MQTTClient zurückkehren, sollten Sie die Meldungen sehen, die AWS IoT veröffentlicht wurden, um den im vorherigen Abschnitt ausgegebenen Aktualisierungsbefehl widerzuspiegeln.

Um die Aktualisierungsnachrichten auf dem MQTTClient anzuzeigen

Wählen Sie im MQTTClient in der Spalte Abonnements $aws/things/ mySimulatedThing /shadow/name/ 1/update/delta simShadow aus. Wenn der Themenname abgeschnitten wird, können Sie ihn anhalten, um das vollständige Thema anzuzeigen. Im Themenprotokoll zu diesem Thema sollten Sie eine /delta Meldung sehen, die dieser ähnelt.

{
  "version": 4,
  "timestamp": 1591141596,
  "state": {
    "ColorRGB": [
      255,
      255,
      0
    ]
  },
  "metadata": {
    "ColorRGB": [
      {
        "timestamp": 1591141596
      },
      {
        "timestamp": 1591141596
      },
      {
        "timestamp": 1591141596
      }
    ]
  },
  "clientToken": "21b21b21-bfd2-4279-8c65-e2f697ff4fab"
}

Ihr Gerät verarbeitet den Inhalt dieser Nachricht, um den Gerätestatus so festzulegen, dass er mit dem desired-Status in der Nachricht übereinstimmt.

Nachdem das Gerät den Status aktualisiert hat, sodass er dem Status in der Nachricht entspricht, muss es den neu gemeldeten desired Status durch Veröffentlichung einer Aktualisierungsnachricht an den neu gemeldeten Status zurücksenden. AWS IoT Dieses Verfahren simuliert dies im MQTTClient.

Eine erfolgreiche Aktualisierung des gemeldeten Status des Geräts führt auch AWS IoT dazu, dass eine umfassende Beschreibung des Shadow-Status in einer Nachricht an das Thema gesendet wird, z. B. dieser Nachrichtentext, der aus dem Shadow-Update resultierte, das das Gerät im vorherigen Verfahren durchgeführt hat.

{
  "previous": {
    "state": {
      "desired": {
        "ColorRGB": [
          255,
          255,
          0
        ]
      },
      "reported": {
        "ID": "SmartLamp21",
        "ColorRGB": [
          128,
          128,
          128
        ]
      }
    },
    "metadata": {
      "desired": {
        "ColorRGB": [
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          }
        ]
      },
      "reported": {
        "ID": {
          "timestamp": 1591140517
        },
        "ColorRGB": [
          {
            "timestamp": 1591140517
          },
          {
            "timestamp": 1591140517
          },
          {
            "timestamp": 1591140517
          }
        ]
      }
    },
    "version": 4
  },
  "current": {
    "state": {
      "desired": {
        "ColorRGB": [
          255,
          255,
          0
        ]
      },
      "reported": {
        "ID": "SmartLamp21",
        "ColorRGB": [
          255,
          255,
          0
        ]
      }
    },
    "metadata": {
      "desired": {
        "ColorRGB": [
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          }
        ]
      },
      "reported": {
        "ID": {
          "timestamp": 1591140517
        },
        "ColorRGB": [
          {
            "timestamp": 1591142747
          },
          {
            "timestamp": 1591142747
          },
          {
            "timestamp": 1591142747
          }
        ]
      }
    },
    "version": 5
  },
  "timestamp": 1591142747,
  "clientToken": "a4dc2227-9213-4c6a-a6a5-053304f60258"
}

Beobachten Sie das Update in der App

Die App kann jetzt den Schatten nach dem aktuellen Status abfragen, wie vom Gerät gemeldet.

Über die Simulation hinaus

Experimentieren Sie mit der Interaktion zwischen der AWS CLI (für die App) und der Konsole (für das Gerät), um Ihre IoT-Lösung zu modellieren.