ZeroKey Integration Suite

Связь с трекерами субмиллиметровой точности для повышения эффективности операций с помощью Tulip и ZeroKey.

Начало работы с ZeroKey

ZeroKey Inc. - быстро развивающаяся технологическая компания, которая разрабатывает, проектирует и производит самую точную в мире крупномасштабную трехмерную систему определения местоположения в реальном времени (RTLS). ZeroKey и Tulip объединили свои усилия, чтобы предложить интегрированное решение, сочетающее технологию Quantum RTLS от ZeroKey с платформой Frontline Operations Platform от Tulip. Традиционные технологии определения местоположения не могут точно оцифровать человеко-ориентированные процессы в больших масштабах, что приводит к значительным неиспользованным преимуществам в эффективности производства, безопасности работников, контроле качества и т.д. Благодаря интеграции ZeroKey и Tulip заказчики получают полную видимость любого процесса - от производства, ориентированного на человека, до отслеживания заказов в масштабах предприятия.

Виджеты ZeroKey Widgets предназначены для предоставления готовых к использованию виджетов, которые могут служить в качестве полезного виджета в приложении или быть отправной точкой для более специализированных виджетов, использующих Zerokey. Эти плагины для пользовательских виджетов представляют собой кодированные виджеты, которые устанавливаются поверх платформы Tulip и используют платформу пространственного интеллекта Zerokey, что позволяет легко начать работу с Zerokey в Tulip.

Виджет местоположения Zerokey

Виджет Zerokey Location представляет собой визуальный трекер местоположения устройства ZeroKey. Виджет обновляется в режиме реального времени и отображает местоположение устройств относительно холста рисунка. Этот виджет может быть наложен на изображение, например, на карту цеха, в приложении для получения точной информации о местоположении в реальном мире.

Видеоинструкция

Настройка

Плагины Custom Widget Plugins предоставляют мощный инструмент для добавления в приложение настраиваемых виджетов. Виджеты позволяют писать Javascript для расширения и настройки функциональности виджета. Виджеты Zerokey используют Javascript и API Zerokeys для предоставления широкого спектра возможностей. Виджеты Tulip Zerokey также обеспечивают системное поведение "mocking", что позволяет сразу же приступить к тестированию виджетов. Для работы с виджетами Zerokey необходимо следующее:

• URL-адрес вашего концентратора событий Zerokey.
• Ваш API-токен Zerokey
• Ширина местоположения в метрах
• Высота местоположения в метрах
• Карта имен идентификаторов устройств
• имитационные данные

Что касается URL-адреса Zerokey Event Hub и API-токена, то мы отсылаем вас к документации Zerokey. Информация Zerokey добавляется непосредственно в код системы Ширина и высота местоположения означают физическую ширину и высоту помещения, в котором развернута пространственная система Zerokey. Карта имен Device ID является необязательной. Она позволяет задать человекочитаемое имя для сопоставления с идентификатором устройства. Например, идентификатор устройства D8:FC:ED:EA:53:1C можно сопоставить с "Connector Widget Bin". Для сопоставления идентификаторов можно предоставить виджету строковый объект JSON в качестве реквизита. Ниже приведен пример:{"D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Станция оператора X", }

Последний шаг - убедиться, что размер холста виджета имеет то же соотношение сторон, что и физическое пространство. Это обеспечит соответствие отображения местоположений виджета его физическому пространству.

В Javascript-коде виджета можно установить переменную mock data в true, чтобы получать имитированные данные, или false, чтобы получать только реальные данные.

Как это работает

После настройки виджета можно протестировать его в редакторе виджетов или добавить непосредственно в приложение. В любом случае необходимо, чтобы устройства Zerokey были активны в вашей пространственной области Zerokey. Любое устройство, активное в пространственной области Zerokey, будет отображаться в виджете в виде круга с идентификатором устройства или сопоставленным именем. Как правило, в качестве карты физического пространства используется изображение, на которое помещается виджет. В этом случае местоположение устройства будет точно отображено на карте. Обратите внимание, что изображение карты должно иметь то же соотношение сторон, что и физическое пространство и холст виджета.

Виджет Zerokey Zone Widget

Виджет Zone обеспечивает вывод визуального списка всех зон, в которых произошло событие "Вход в зону", "Выход из зоны" или "Занятие зоны". В визуальном списке отображается тот же идентификатор или имя, а также идентификатор или имя устройства для всех устройств, связанных с этой зоной.

Видеоинструкция

Настройка

Пользовательские виджеты Плагины предоставляют мощный инструмент для добавления пользовательских виджетов в ваше приложение. Виджеты позволяют написать Javascript для расширения и настройки функциональности виджета. Виджеты Zerokey используют Javascript и API Zerokeys для предоставления широкого спектра возможностей. Виджеты Tulip Zerokey также обеспечивают системное поведение "mocking", что позволяет сразу же приступить к тестированию виджетов. Для работы с виджетами Zerokey необходимо следующее:

• URL-адрес вашего концентратора событий Zerokey.
• Ваш API-токен Zerokey
• Карта имен идентификаторов зон
• Карта имен идентификаторов устройств
• Передача событий в приложение
• Имитация данных

Что касается URL-адреса и API-токена Zerokey Event Hub, то мы отсылаем вас к документации Zerokey.

Карты идентификаторов зон и устройств

Карта имен идентификаторов зон является необязательной. Она позволяет указать человекочитаемое имя для сопоставления с идентификатором зоны. Например, идентификатор устройства "aae876a0-cb98-4c12-a16c-a56764aea4r" может быть сопоставлен с "Vision station". Для сопоставления идентификаторов можно предоставить виджету строковый объект JSON в качестве параметра. Ниже приведен пример:{"ffe434a0-cb29-4d22-a16c-70f764aedbcb": "Parts room", "aae876a0-cb98-4c12-a16c-a56764aea4r": "Станция технического зрения", }

Карта имен идентификаторов устройств является необязательной. Она позволяет задать человекочитаемое имя для сопоставления с идентификатором устройства. Например, идентификатор устройства D8:FC:ED:EA:53:1C может быть сопоставлен с "Connector Widget Bin". Для сопоставления идентификаторов можно предоставить виджету строковый объект JSON в качестве реквизита. Ниже приведен пример:

{ "D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Станция оператора X", }

Последний шаг - убедиться, что размер холста виджета имеет то же соотношение сторон, что и физическое пространство. Это обеспечит вывод местоположений виджета в соответствии с физическим пространством.

Подключение событий к приложению

Виджет Zerokey Zone формирует события для зон "вошла", "занята" и "пуста". Вы можете создать триггеры, которые будут прослушивать эти события и реагировать на них в вашем приложении.

Имитация данных

В Javascript-коде виджета можно установить переменную mock data в true, чтобы получать имитацию данных, или false, чтобы получать только реальные данные.

Как это работает

После настройки виджета можно протестировать его в редакторе виджетов или добавить непосредственно в приложение. В любом случае необходимо, чтобы устройства Zerokey были активны в вашей пространственной области Zerokey и чтобы у вас были настроены зоны. Виджет будет выдавать информацию о зонах в виде списка для получения событий зон, а также будет выдавать события зон для реагирования вашего приложения. Обратите внимание, что вы можете скрыть список зон в своем приложении, закрыв его формой или закомментировав следующий код в HTML виджета: ```

## Виджет Zerokey Request-Response Widget


Виджет Zerokey Request-Reponse является примером использования других элементов API Zerokey, не являющихся приемниками событий. Виджет автоматически получает токен Bearer и обновляет его по мере необходимости. Виджет представляет собой пользовательскую панель, позволяющую запрашивать информацию об устройствах, которые были замечены сегодня, зонах и конкретных деталях устройства. Хотя этот виджет можно сразу использовать в приложении Tulip, в основном он используется для примера и создания на его основе других пользовательских виджетов.


### Видеообзор


![Video](https://tulipinterfaces.wistia.com/medias/8lj0k7ipaq){height="480" width="640"}


### Настройка


Плагины пользовательских виджетов предоставляют мощный инструмент для добавления пользовательских виджетов в ваше приложение. Виджеты позволяют писать Javascript для расширения и настройки функциональности виджета. Виджеты Zerokey используют Javascript и API Zerokeys для предоставления широкого спектра возможностей. Виджеты Tulip Zerokey также обеспечивают системное поведение "mocking", что позволяет сразу же приступить к тестированию виджетов. Для работы с виджетами Zerokey необходимо следующее:


* URL-адрес вашего API Zerokey
* Имя пользователя и пароль Zerokey для аутентификации API
* Имитируемые данные


*Что касается URL-адреса Zerokey Event Hub и API-токена, то мы отсылаем вас к [документации Zerokey](https://api.zerokey.com/).*


### Макетные данные


В Javascript-коде виджета можно установить переменную mock data в true, чтобы получать имитированные данные, или false, чтобы получать только реальные данные. 


### Как это работает


После настройки виджета вы можете протестировать его в редакторе виджетов или добавить непосредственно в приложение. В любом случае, если вы не имитируете данные, вам необходимо иметь устройства Zerokey, активные в вашей пространственной области Zerokey, и настроить зоны. На приборной панели виджета UI имеются кнопки, позволяющие запросить данные о замеченных сегодня устройствах, состоянии зоны и информацию о конкретном устройстве. Если есть результаты, они будут перечислены под кнопками. 


## Виджет Zerokey Tool Tracker


Виджет Zerokey Tool Tracker (Zerokey device tracker) проверяет, находится ли определенное устройство в заданном пользователем месте. Это аналогично проверке нахождения устройства в заданной пользователем зоне. Пользователь может определить зону через реквизит виджета. Это может быть использовано для отслеживания последнего использования динамометрического привода с подключенным к нему устройством Zerokey. В этом случае можно проверить, был ли затянут "правильный" винт. Когда динамометрический ключ сообщает "готово" приложению Tulip App, мы используем этот сигнал для проверки местоположения устройства, чтобы убедиться, что только что был затянут "правильный" винт.


### Видеоинструкция


![Video](https://tulipinterfaces.wistia.com/medias/lr4ntrf1vu){height="480" width="640"}


### Настройка


Плагины Custom Widget Plugins предоставляют мощный инструмент для добавления в приложение настраиваемых виджетов. Виджеты позволяют написать Javascript для расширения и настройки функциональности виджета. Виджеты Zerokey используют Javascript и API Zerokeys для предоставления широкого спектра возможностей. Виджеты Tulip Zerokey также обеспечивают системное поведение "mocking", что позволяет сразу же приступить к тестированию виджетов. Для работы с виджетами Zerokey необходимо следующее:


* URL-адрес вашего API Zerokey
* Имя пользователя и пароль Zerokey для аутентификации в API
* Центр x определяемой пользователем зоны
* Центр y определяемой пользователем зоны
* Ширина определяемой пользователем зоны
* Высота определяемой пользователем зоны
* Передача событий в приложение
* Имитация данных


*Что касается URL-адреса и API-токена Zerokey Event Hub, то мы отсылаем вас к [документации Zerokey](https://api.zerokey.com/).*


### Зона, определяемая пользователем


Виджет Zerokey Tool Tracker позволяет создать двухмерную зону с помощью реквизитов виджета. Для этого необходимо знать положение центра x,y, а также ширину и высоту зоны в метрах. Центр x,y можно получить, используя устройство Zerokey и поместив его в нужное место. После настройки пользовательской зоны можно проверить, находится ли устройство Zerokey в зоне действия зоны. 


### Передача событий в приложение


Для использования в приложении Tulip необходимо, чтобы аппаратное устройство или машина запускали событие. По этому событию оно должно записывать строку **ID устройства** в переменную. Эта переменная должна быть входной для свойства "device\_id" виджета Zerokey Tool Tracker.


### Имитация данных


В Javascript-коде виджета можно установить переменную mock data в true, чтобы получать имитированные данные, или false, чтобы получать только реальные данные.


### Как это работает


После настройки виджета можно протестировать его в редакторе виджетов или добавить непосредственно в приложение. После настройки виджета в приложении вы сможете запустить его, обновив параметр "device\_id". Обычно это делается с помощью триггера на устройстве (физическом инструменте). При срабатывании устройства идентификатор устройства записывается в переменную, которая присваивается реквизиту "device\_id" виджета. Это заставит виджет запросить информацию об идентификаторе устройства у Zerokey API. Если информация о местоположении устройства находится в пределах заданной пользователем зоны, то будет отправлено событие "valid\_tool\_location", true, если устройство находится в заданной пользователем зоне, и false в противном случае.