A Tulip egyszerűen összekapcsolható a ParticleIO-eszközökkel
Kövesse nyomon a Particle közösségi integrációját (azonos útmutató) itt:Particle <> Tulip közösségi integráció
Beállítás
A Tulip Machine Endpoint beállítása
A Tulipban egy gép létrehozásához a következőkre van szükség:* API-hitelesítő adatok* Géptípus* Gép
API-hitelesítő adatok:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
Lépjen a Beállítások --> Tulip API menüpontba, és hozzon létre egy szolgáltatási fiókot, amely olvasási és írási jogosultsággal rendelkezik a gépekhez és az attribútumokhoz:
Gép típus Lépjena Gyártócsarnok --> Gépek --> Gép típusok menüpontra, és hozzon létre egy új gép típust. Hozzon létre olyan gépattribútumokat, amelyek tükrözik a ParticleIO által közzétett eseményeket. MEGJEGYZÉS: Az adattípusnak karakterláncnak kell lennie. 
Gép:Hozzon létreegy új gépet az újonnan létrehozott géptípus alatt; a konfigurációban rendelje hozzá a gépattribútumot a Tulip Machine API-hoz, és jegyezze fel a MachineId és az AttributeId azonosítókat
Az integráció engedélyezése
**Particle Console:**Miután elvégezte az összes szükséges előzetes konfigurációt, készen áll a Tulip-integráció engedélyezésére a Particle Console-on.
Először lépjen az integrációs központba az oldalsávon található integrációs ikonra () kattintva, vagy egyszerűen kövesse ezt a linket. Ha egy termékhez szeretné engedélyezni az integrációt, akkor a kívánt termék integrációs központját kell felkeresnie. Ehhez kattintson az oldalsávon található termékikonra (), keresse meg a termékét, majd kattintson a termék kontextusában található integrációs ikonra ().
Az integrációs központban kattintson az „Új integráció” gombra. A rendelkezésre álló integrációk listájából válassza ki a „Webhook” lehetőséget.
A következő lépés a Webhook konfigurálása. Töltse ki a következő mezőket:
- Esemény neve: Az esemény neve, amely a Tulip Machine-be történő közzétételt indítja el. Ez az esemény neve, amikor a firmware-ben meghívja a Particle.publish() függvényt.
- URL: A Tulip Machine API teljes URL-címe. Példa: https://[instance].tulip.co/api/v3/attributes/report
- Kérés típusa: A Tulip-szerver POST-kérést vár, ezért győződjön meg róla, hogy ez van kiválasztva.
- Kérés formátuma: Az alapértelmezett beállítás a Web Form, de mi JSON-t fogunk küldeni, ezért győződjön meg róla, hogy ezt JSON-ra állítja át.
Kattintson a „Speciális beállítások” területre az egyéni JSON-formátum kitöltéséhez. A következőképpen töltheti ki:
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
Hitelesítés Végül hitelesítenie kell magát a Tulip rendszerben az API-kulccsal és a titkos kulccsal. Példaként lásd az alábbi képernyőképet.
Ebben az esetben a Basic Auth hitelesítést használjuk.
Kattintson a „Create Webhook” gombra. Ezzel sikeresen utasította a Particle felhőt, hogy a MachineAPI-n keresztül továbbítsa az adatokat a Tulip-nak!
Ideje továbblépni a firmware-re!
Firmware
Most, hogy az integráció engedélyezve van a Particle felhőben, az utolsó lépés az adatok Tulipba történő továbbításához az, hogy a készülékre olyan firmware-t írjon, amely közzéteszi a kívánt eseményt. Lépjen át a Particle Web IDE-be, a Local IDE-be, vagy bármelyik IDE-be, amelyet a firmware-fejlesztéshez használ.
Ha már dolgozik egy firmware-alkalmazáson, csak győződjön meg arról, hogy tartalmazza a Particle.publish() parancsot, amelynek eseményneve megegyezik a fenti Google Cloud Platform-integráció engedélyezéséhez használt esemény nevével. Ellenkező esetben, ha szüksége van egy firmware-minta kódra, illessze be az alábbi kódot a firmware-alkalmazásába:
void loop() {
// véletlenszerű adat String data = String((rand()%100)+1); // Indítsa el az integrációt Particle.publish("temperature", data, PRIVATE); // Várjon 6 másodpercet delay(6000);}```A fenti kód 6 másodpercenként közzétesz egy eseményt, amelynek során véletlenszerű számot generál, majd azt közzéteszi a webook eseményben.
Most írja be a firmware-be a Particle.publish() parancsot, amely elindítja az integrációt egy Particle eszközhöz.
Gratulálunk! Ennyi elég ahhoz, hogy az integráció végpontok között működjön. Az eszköz mostantól elkezd közzétenni a célzott eseményt, ami jelzi a Particle felhőnek, hogy továbbítsa az esemény tartalmát a Tulip-példányához.
### Az adatok Tulipba való beérkezésének ellenőrzése
Annak ellenőrzéséhez, hogy az adatok sikeresen közzétételre kerültek-e a Tulipba, megtekintheti a gépfrissítéseket a „Shop Floor” --> „Machines” területen
{height="" width=""}
MEGJEGYZÉS: Előfordulhat, hogy az attribútumnak karakterlánc formátumban kell lennie, majd később konvertálni kell.
### Példák a felhasználásra
A Boron404x-hez hasonló ParticleIO-kártyák kiválóan használhatók olyan helyzetekben, amikor a Wi-Fi-jel gyenge, és a mobilhálózat gyorsabb megoldást kínál az eszközök csatlakoztatására. A felhasználási példák között szerepelhetnek:\* Anyagkövetés\* Gépfelügyelet\* Valós idejű minőségi frissítések