Verbinden Sie Tulip ganz einfach mit ParticleIO-Geräten
Folgen Sie hier der Anleitung zur Community-Integration von Particle (identische Anleitung):Particle <> Tulip Community-Integration
Einrichtung
Einrichten des Tulip-Maschinen-Endpunkts
Zum Erstellen einer Maschine in Tulip sind folgende Angaben erforderlich:* API-Anmeldedaten* Maschinentyp* API-Anmeldedaten der Maschine
API-Anmeldedaten:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
Gehen Sie zu „Einstellungen“ --> „Tulip-API“, um ein Dienstkonto zu erstellen, das über Lese- und Schreibrechte für Maschinen und Attribute verfügt:
Maschinentyp Gehen Siezu „Fertigungsbereich“ → „Maschinen“ → „Maschinentypen“ und erstellen Sie einen neuen Maschinentyp. Legen Sie Maschinenattribute an, die die von ParticleIO veröffentlichten Ereignisse widerspiegeln. HINWEIS: Der Datentyp muss „Zeichenkette“ sein. 
Maschine: Erstellen Sieeine neue Maschine unter dem neu erstellten Maschinentyp; ordnen Sie unter „Konfiguration“ das Maschinenattribut der Tulip Machine API zu und notieren Sie sich die „MachineId“ und die „AttributeId“
Aktivieren der Integration
**Particle-Konsole:**Nachdem Sie alle erforderlichen Vorkonfigurationen vorgenommen haben, können Sie nun die Tulip-Integration in der Particle-Konsole aktivieren.
Rufen Sie zunächst den Integrations-Hub auf, indem Sie auf das Integrationssymbol in der Seitenleiste () klicken oder einfach diesem Link folgen. Wenn Sie die Integration für ein Produkt aktivieren möchten, müssen Sie den Integrations-Hub für das gewünschte Produkt aufrufen. Klicken Sie dazu auf das Produktsymbol () in der Seitenleiste, suchen Sie Ihr Produkt und klicken Sie anschließend im Produktkontext auf das Integrationssymbol ().
Klicken Sie im Integrations-Hub auf die Schaltfläche „Neue Integration“. Klicken Sie in der Liste der verfügbaren Integrationen auf „Webhook“.
Im nächsten Schritt konfigurieren Sie den Webhook. Füllen Sie die folgenden Felder aus:
- Ereignisname: Der Name des Ereignisses, das die Veröffentlichung eines Ereignisses an Tulip Machine auslöst. Dies ist der Name Ihres Ereignisses, wenn Sie in Ihrer Firmware
Particle.publish()aufrufen. - URL: Die vollständige URL der Tulip Machine-API. Beispiel: https://[instance].tulip.co/api/v3/attributes/report
- Anfragetyp: Der Tulip-Server erwartet eine POST-Anfrage; stellen Sie daher sicher, dass diese Option ausgewählt ist.
- Anfrageformat: Die Standardeinstellung ist „Webformular“, da wir jedoch JSON senden, stellen Sie sicher, dass Sie dies auf „JSON“ ändern.
Sie müssen auf den Bereich „Erweiterte Einstellungen“ klicken, um das benutzerdefinierte JSON-Format auszufüllen. Sie können dies wie folgt ausfüllen:
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
Authentifizierung Zuletzt müssen Sie sich bei Tulip mit dem API-Schlüssel und dem Secret authentifizieren. Siehe Beispiel-Screenshot unten.
In diesem Fall wird die Basic-Auth-Methode verwendet.
Klicken Sie auf „Webhook erstellen“. Sie haben nun die Particle-Cloud erfolgreich angewiesen, Daten über ihre MachineAPI an Tulip zu übertragen!
Nun geht es weiter mit Ihrer Firmware!
Firmware
Nachdem die Integration nun in der Particle-Cloud aktiviert ist, besteht der letzte Schritt, um Daten in Tulip zu streamen, darin, ein Gerät mit einer Firmware zu flashen, die das gewünschte Ereignis veröffentlicht. Öffne dazu die Particle Web-IDE, die lokale IDE oder die IDE, die du für die Firmware-Entwicklung verwendest.
Wenn Sie bereits an einer Firmware-Anwendung arbeiten, stellen Sie einfach sicher, dass Sie einen Aufruf von Particle.publish() einfügen, dessen Ereignisname mit dem Ereignis übereinstimmt, das oben zur Aktivierung der Google Cloud Platform-Integration verwendet wurde. Falls Sie eine Beispiel-Firmware benötigen, fügen Sie den folgenden Code in Ihre Firmware-Anwendung ein:
void loop() {
// Zufällige Daten String data = String((rand()%100)+1); // Integration auslösen Particle.publish("temperature", data, PRIVATE); // 6 Sekunden warten delay(6000);}```Der obige Code veröffentlicht alle 6 Sekunden ein Ereignis, bei dem eine Zufallszahl generiert und anschließend an das Webook-Ereignis gesendet wird.
Flashen Sie nun die Firmware mit der Funktion `Particle.publish()`, die die Integration mit einem Particle-Gerät auslöst.
Herzlichen Glückwunsch! Das ist alles, was du brauchst, damit die Integration durchgängig funktioniert. Dein Gerät beginnt nun, das gewünschte Ereignis zu veröffentlichen, was der Particle-Cloud signalisiert, den Inhalt des Ereignisses an deine Tulip-Instanz zu streamen.
### Überprüfen, ob die Daten Tulip erreichen
Um sicherzustellen, dass die Daten erfolgreich an Tulip veröffentlicht werden, können Sie die Maschinenaktualisierungen im Bereich „Shop Floor“ --> „Machines“ einsehen
{height="" width=""}
HINWEIS: Das Attribut muss möglicherweise im String-Format vorliegen und später konvertiert werden.
### Beispiel-Anwendungsfälle
Der Einsatz von ParticleIO-Boards wie dem Boron404x eignet sich hervorragend, wenn die WLAN-Verbindung schlecht ist und Mobilfunk eine schnellere Alternative für die Gerätekonnektivität darstellt. Zu den Anwendungsfällen gehören unter anderem:\* Materialverfolgung\* Maschinenüberwachung\* Echtzeit-Qualitätsaktualisierungen