Łatwe połączenie Tulip z urządzeniami ParticleIO
Zapoznaj się z integracją społecznościową Particle (identyczny przewodnik) tutaj:Integracja społecznościowa Particle <> Tulip
Konfiguracja
Konfiguracja punktu końcowego urządzenia w Tulip
Utworzenie maszyny w Tulip wymaga następujących elementów:* Dane uwierzytelniające API* Typ maszyny* Maszyna
Dane uwierzytelniające API:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
Przejdź do ustawień --> Tulip API, aby utworzyć konto serwisowe z uprawnieniami do odczytu i zapisu w maszynach oraz atrybutach
Typ maszyny Przejdźdo sekcji „Hala produkcyjna” → „Maszyny” → „Typy maszyn” i utwórz nowy typ maszyny. Utwórz atrybuty maszyny odzwierciedlające zdarzenia publikowane przez ParticleIO. UWAGA: Typ danych musi być typu string. 
Maszyna: Utwórznową maszynę w ramach nowo utworzonego typu maszyny; w sekcji konfiguracji przypisz atrybut maszyny do interfejsu API Tulip Machine i zanotuj identyfikatory MachineId oraz AttributeId
Włączanie integracji
Konsola Particle: Po wykonaniu wszystkich wymaganych czynności wstępnych możesz teraz włączyć integrację z Tulip w konsoli Particle.
Zacznij od przejścia do centrum integracji, klikając ikonę integracji na pasku bocznym () lub po prostu klikając ten link. Jeśli chcesz włączyć integrację dla konkretnego produktu, musisz przejść do centrum integracji dla wybranego produktu. Zrób to, klikając ikonę produktów () na pasku bocznym, znajdując swój produkt, a następnie klikając ikonę integracji () w kontekście produktu.
Po wejściu do centrum integracji kliknij przycisk „Nowa integracja”. Z listy dostępnych integracji wybierz „Webhook”.
Następnym krokiem jest skonfigurowanie webhooka. Wypełnij następujące pola:
- Nazwa zdarzenia: Nazwa zdarzenia, które spowoduje opublikowanie zdarzenia w Tulip Machine. Jest to nazwa zdarzenia, które wywołujesz, wywołując funkcję Particle.publish() w swoim oprogramowaniu układowym.
- URL: Pełny adres URL interfejsu API Tulip Machine. Przykład: https://[instance].tulip.co/api/v3/attributes/report
- Typ żądania: Serwer Tulip oczekuje żądania POST, więc upewnij się, że ta opcja jest zaznaczona.
- Format żądania: Domyślnym ustawieniem jest „Formularz internetowy”, ale będziemy wysyłać dane w formacie JSON, więc upewnij się, że zmieniłeś to ustawienie na „JSON”.
Aby wypełnić niestandardowy format JSON, należy kliknąć obszar „Ustawienia zaawansowane”. Można to zrobić w następujący sposób:
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
Uwierzytelnianie Na koniec musisz uwierzytelnić się w Tulip za pomocą klucza API i tajnego kodu. Przykładowy zrzut ekranu znajduje się poniżej.
W tym przypadku stosowane jest uwierzytelnianie podstawowe (Basic Auth).
Kliknij „Utwórz webhook”. Pomyślnie poinformowałeś chmurę Particle, aby przesyłała dane do Tulip za pośrednictwem MachineAPI!
Czas przejść do oprogramowania układowego!
Oprogramowanie układowe
Teraz, gdy integracja jest włączona w chmurze Particle, ostatnim krokiem wymaganym do rozpoczęcia przesyłania danych do Tulip jest wgranie do urządzenia oprogramowania układowego, które publikuje docelowe zdarzenie. Przejdź do Particle Web IDE, Local IDE lub dowolnego środowiska IDE, którego używasz do tworzenia oprogramowania układowego.
Jeśli już pracujesz nad aplikacją oprogramowania układowego, upewnij się, że zawiera ona funkcję Particle.publish() z nazwą zdarzenia zgodną ze zdarzeniem używanym do włączenia integracji z Google Cloud Platform, jak opisano powyżej. W przeciwnym razie, jeśli potrzebujesz przykładowego oprogramowania układowego, wklej poniższy kod do swojej aplikacji:
void loop() {
// dane losowe String data = String((rand()%100)+1); // Uruchom integrację Particle.publish("temperature", data, PRIVATE); // Odczekaj 6 sekund delay(6000);}```Powyższy kod będzie publikował zdarzenie co 6 sekund, generując losową liczbę, a następnie wysyłając ją do zdarzenia webook.
Przejdź do wgrania oprogramowania układowego z funkcją Particle.publish(), która uruchomi integrację z urządzeniem Particle.
Gratulacje! To wszystko, czego potrzebujesz, aby integracja działała od początku do końca. Twoje urządzenie zacznie teraz publikować docelowe zdarzenie, co zasygnalizuje chmurze Particle, aby przesyłała zawartość zdarzenia do Twojej instancji Tulip.
### Sprawdzanie, czy dane docierają do Tulip
Aby upewnić się, że dane są pomyślnie publikowane w Tulip, możesz wyświetlić aktualizacje maszyn w obszarze „Shop Floor” --> „Machines”
{height="" width=""}
UWAGA: Atrybut może wymagać zapisania w formacie ciągu znaków, a następnie późniejszej konwersji.
### Przykładowe zastosowania
Korzystanie z płyt ParticleIO, takich jak Boron404x, sprawdza się doskonale, gdy zasięg Wi-Fi jest słaby, a sieć komórkowa stanowi szybsze rozwiązanie zapewniające łączność urządzeń. Przykłady zastosowań mogą obejmować:\* Śledzenie materiałów\* Monitorowanie maszyn\* Aktualizacje jakości w czasie rzeczywistym