MENU
    Интеграция ParticleIO
    • 03 Nov 2023
    • 3 Минуты для чтения
    • Авторы

    Интеграция ParticleIO


    Вводный текст

    Простое подключение Tulip к устройствам ParticleIO

    Ознакомьтесь с интеграцией сообщества Particle (идентичное руководство) здесь:Particle <> Интеграция сообщества Tulip

    Настройка

    Настройка конечной точки машины Tulip

    Для создания машины в Tulip требуется следующее: * Учетные данные API * Тип машины * Машина

    Учетные данные APIПерейдите в раздел Настройки --> Токены API, чтобы создать токен API с возможностью чтения / записи в машины и атрибутыimage.png

    Тип станкаПерейдите в раздел Shop Floor --> Machines --> Machine Types и создайте новый тип станка. Создайте атрибуты машины, отражающие события, публикуемые ParticleIO. ПРИМЕЧАНИЕ: Тип данных должен быть строковым.
    image.png

    МашинаСоздайте новую машину в рамках только что созданного типа машины; в разделе конфигурации сопоставьте атрибут машины с Tulip Machine API и укажите MachineId и AttributeId.image.png

    Включение интеграции

    Консоль Particle ConsoleТеперь, когда вы выполнили все необходимые предварительные настройки, вы готовы включить интеграцию Tulip в консоли Particle Console.

    Для этого перейдите в центр интеграций, нажав на значок интеграции в боковой панели (), или просто перейдите по этой ссылке. Если вы хотите включить интеграцию для какого-либо продукта, то вам необходимо посетить концентрацию интеграций для нужного продукта. Для этого щелкните на значке продуктов () в боковой панели, найдите свой продукт, а затем щелкните на значке интеграций () в контексте продукта.

    Находясь в центре интеграций, нажмите на кнопку "Новая интеграция". В списке доступных интеграций выберите "Webhook".

    Следующим шагом будет настройка Webhook. Заполните следующие поля:

    • Event Name (Имя события): Имя события, которое будет инициировать публикацию события в Tulip Machine. Это имя события, когда вы вызываете Particle.publish() в своей прошивке.
    • URL: Полный адрес API Tulip Machine Пример: https://[instance].tulip.co/api/v3/attributes/report.
    • Тип запроса: Сервер Tulip ожидает POST, поэтому убедитесь, что выбран именно этот тип.
    • Формат запроса: По умолчанию используется Web Form, но мы будем отправлять JSON, поэтому убедитесь, что вы изменили это значение на JSON.

    Для заполнения пользовательского формата JSON необходимо перейти в область дополнительных настроек. Вы можете заполнить его следующим образом:

    { "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{PARTICLE_EVENT_VALUE}}" } } }.

    Аутентификация Наконец, необходимо аутентифицироваться в Tulip с помощью api ключа и секрета. Для примера ниже приведен скриншот.tulip_api_auth.jpg

    В данном случае используется Basic Auth.

    Нажмите кнопку "Create Webhook". Теперь вы успешно передали облаку Particle команду на передачу данных в Tulip через его MachineAPI!

    Пора переходить к прошивке!

    Прошивка

    Теперь, когда интеграция в облако Particle включена, последний шаг, необходимый для обеспечения потоковой передачи данных в Tulip, заключается в прошивке устройства с помощью микропрограммы, которая публикует целевое событие. Перейдите в Particle Web IDE, Local IDE или любую другую IDE, которую вы используете для разработки микропрограмм.

    Если вы уже работаете над приложением для прошивки, просто убедитесь, что вы включили Particle.publish() с именем события, совпадающим с именем события, использованного для включения интеграции с Google Cloud Platform выше. В противном случае, если вам нужен пример прошивки, вставьте приведенный ниже код в ваше приложение для прошивки:

    void loop() {
    
    
    // случайные данные String data = String((rand()%100)+1); // запускаем интеграцию Particle.publish("temperature", data, PRIVATE); // ждем 6 секунд delay(6000); } ``Приведенный выше код будет публиковать событие каждые 6 секунд, в котором генерируется случайное число, а затем публикуется в событие webook.
    
    
    Переходим к прошивке с помощью команды Particle.publish(), которая запустит интеграцию в устройство Particle.
    
    
    Поздравляем! Это все, что нужно для обеспечения сквозной интеграции. Теперь ваше устройство начнет публиковать целевое событие, что послужит сигналом для облака Particle, которое передаст содержимое события в ваш экземпляр Tulip.
    
    
    ### Подтверждение того, что данные попадают в Tulip
    
    
    Чтобы убедиться в том, что данные успешно публикуются в Tulip, вы можете просмотреть обновления станков в области Shop Floor --> Machines.
    
    
    ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28202%29.png){height="" width=""}
    
    
    ПРИМЕЧАНИЕ: Атрибут может быть представлен в строковом формате с последующим преобразованием.
    
    
    ### Примеры использования
    
    
    Использование плат ParticleIO, таких как Boron404x, очень удобно, когда Wi-Fi не работает, а сотовая связь является более быстрым обходным решением для подключения устройств. Примеры использования могут включать: \* Отслеживание материалов \* Мониторинг оборудования \* Обновление качества в реальном времени
    Void

    Была ли эта статья полезной?