零键集成套件

使用 Tulip 和 ZeroKey 连接亚毫米级精度的跟踪器，提高运营效率。

开始使用 ZeroKey

ZeroKey Inc. 是一家迅速崛起的技术公司，设计、设计和制造世界上最精确的大规模三维实时定位系统 (RTLS)。ZeroKey 和 Tulip 合作提供集成解决方案，将 ZeroKey 的 Quantum RTLS 技术与 Tulip 的前线运营平台相结合。传统的定位技术无法精确地大规模数字化以人为中心的流程，导致生产效率、工人安全、质量控制等方面的巨大价值尚未得到开发。 通过 ZeroKey 和 Tulip 的集成，客户可以获得从以人为本的制造到全设施订单跟踪等任何流程的完整可视性。

ZeroKey 小工具的目的是为您提供随时可用的小工具，这些小工具可以作为应用程序中的可用小工具，也可以作为利用 ZeroKey 的更多自定义小工具的起点。这些定制 widget 插件是位于 Tulip 平台之上的编码 widget，利用了 Zerokey 的空间智能平台，让您可以轻松在 Tulip 中开始使用 Zerokey。

Zerokey 位置部件

Zerokey 位置部件是一个可视化的 ZeroKey 设备位置跟踪器。该部件可实时更新，显示设备相对于绘图画布的位置。该 Widget 可放置在应用程序中的图像（如车间地图）上，以提供准确的现实世界位置信息。

视频演示

设置

自定义 Widget 插件为在应用程序中添加自定义 Widget 提供了强大的工具。小工具允许您编写 Javascript 来扩展和自定义小工具的功能。Zerokey 小工具利用 Javascript 和 Zerokeys API 提供了广泛的功能。Tulip Zerokey 小工具还提供系统 "模拟 "行为，因此您可以立即开始测试小工具。使用 Zerokey 部件需要具备以下条件：

• 您的 Zerokey Event Hub URL。
• 您的 Zerokey API 标记
• 位置宽度（以米为单位
• 位置高度（以米为单位
• 设备 ID 名称映射
• 模拟数据

关于 Zerokey Event Hub URL 和 API 令牌，请参阅 Zerokey 文档。Zerokey 信息直接添加到 Zerokey 空间系统的代码中。 位置宽度和高度是指您部署 Zerokey 空间系统的空间的物理宽度和高度。设备 ID 名称图是可选项。这允许您提供一个人可读的名称来映射到设备 ID。例如，设备 ID D8:FC:ED:EA:53:1C 可以映射为 "连接器小工具箱"。您可以提供一个 JSON 字符串对象作为 widget 的道具来映射 ID。下面是一个示例：{ "D8:FC:ED:EA:53:1C"："连接器 Widget Bin"，"AA:BB:CC:12:34:56"："操作员 X 站"， }

最后一步是确保窗口小部件画布尺寸设置为与物理空间的宽高比相同。这将确保 widget 输出的位置与物理空间相匹配。

在 widget 的 Javascript 代码中，您可以将模拟数据变量设置为 true 以接收模拟数据，或者设置为 false 以只接收真实数据。

如何使用

设置好 widget 后，您可以在 widget 编辑器中进行测试，也可以直接将其添加到应用程序中。无论哪种情况，您都需要在 Zerokey 空间区域激活 Zerokey 设备。任何在 Zerokey 空间区域激活的设备都会在 widget 中显示为一个圆圈，其中包含设备 ID 或映射名称。通常情况下，你会有一张映射物理空间的图片，你将把 widget 放在上面。在这种情况下，设备的位置将准确地绘制在地图上。请注意，地图图像的长宽比必须与物理空间和 widget 画布的长宽比相同。

Zerokey 区域部件

区 Widget 提供可视化列表输出，显示已报告进入区、退出区或占用区事件的任何区。可视化列表会显示相同的 ID 或名称，以及与防区相关联的任何设备的设备 ID 或名称。

视频演示

设置

自定义 Widget 插件为在应用程序中添加自定义 Widget 提供了强大的工具。小工具允许您编写 Javascript 来扩展和自定义小工具的功能。Zerokey 小工具利用 Javascript 和 Zerokeys API 提供了广泛的功能。Tulip Zerokey 小工具还提供系统 "模拟 "行为，因此您可以立即开始测试小工具。使用 Zerokey 部件需要具备以下条件：

• 您的 Zerokey Event Hub URL。
• 您的 Zerokey API 标记
• 区域 ID 名称映射
• 设备 ID 名称映射
• 将事件连接到应用程序
• 模拟数据

关于 Zerokey Event Hub URL 和 API 令牌，请参阅Zerokey 文档。

区域和设备 ID 映射

区域 ID 名称映射是可选的。这允许您提供一个人可读的名称来映射到区域 ID。例如，设备 ID "aae876a0-cb98-4c12-a16c-a56764aea4r "可以映射为 "Vision Station"。您可以向 widget 提供一个 JSON 字符串对象作为道具来映射 ID。下面是一个示例：{ "ffe434a0-cb29-4d22-a16c-70f764aedbcb"："零件室"， "aae876a0-cb98-4c12-a16c-a56764aea4r"："视觉站", }

设备 ID 名称映射是可选项。这允许您提供一个人可读的名称来映射到设备 ID。例如，设备 ID D8:FC:ED:EA:53:1C 可以映射为 "连接器小工具箱"。您可以提供一个 JSON 字符串对象，作为 Widget 映射 ID 的道具。下面是一个示例：

{ "d8:fc:ed:ea:53:1c"："连接器 Widget Bin"，"AA:BB:CC:12:34:56"："操作员 X 站"， }

最后一步是确保窗口小部件画布尺寸的设置与物理空间的宽高比相同。这将确保 widget 输出的位置与物理空间相匹配。

将事件连接到应用程序

Zerokey Zone 部件会触发区域进入、区域占用和区域清空事件。您可以创建触发器来监听这些事件，并在应用程序中做出响应。

模拟数据

在小工具的 Javascript 代码中，您可以将模拟数据变量设为 true 以接收模拟数据，或设为 false 以只接收真实数据。

如何工作

设置好 widget 后，您可以在 widget 编辑器中对其进行测试，也可以直接将其添加到应用程序中。无论哪种情况，您都需要在 Zerokey 空间区域中激活 Zerokey 设备，并配置好区域。该小工具将触发区域事件的区域列表信息，并触发区域事件让您的应用程序做出响应。请注意，您可以在应用程序中隐藏区域列表，方法是用形状覆盖它，或注释掉 widget HTML 中的以下代码： ````

## Zerokey 请求-响应小工具


Zerokey Request-Reponse 小工具为使用 Zerokey API 的其他非事件监听器元素提供了一个示例。该小工具会自动获取一个 Bearer 令牌，并在需要时刷新它。该小工具提供了一个仪表板用户界面，允许用户请求有关今天看到的设备、区域和特定设备详细信息的信息。虽然该 widget 可以在 Tulip 应用程序中立即使用，但它主要用于示例和构建其他自定义 widget。


### 视频演示



### 设置


自定义 Widget 插件为在应用程序中添加自定义 Widget 提供了强大的工具。小工具允许您编写 Javascript 来扩展和自定义小工具的功能。Zerokey 小工具利用 Javascript 和 Zerokeys API 提供了广泛的功能。Tulip Zerokey 小工具还提供系统 "模拟 "行为，因此您可以立即开始测试小工具。Zerokey 小工具需要具备以下条件：


* 您的 Zerokey API URL
* 用于 API 验证的 Zerokey 用户名和密码
* 模拟数据


*关于 Zerokey Event Hub URL 和 API 标记，请参阅[Zerokey 文档](https://api.zerokey.com/)。*


### 模拟数据


在 widget 的 Javascript 代码中，您可以将模拟数据变量设为 true 以接收模拟数据，或者设为 false 以只接收真实数据。 


### 工作原理


设置好 widget 后，您可以在 widget 编辑器中进行测试，也可以直接将其添加到应用程序中。无论哪种情况，如果您没有模拟数据，都需要在您的 Zerokey 空间区域激活 Zerokey 设备，并配置好区域。小部件用户界面仪表板上的按钮可让您请求今天看到的设备、区域状态和特定设备信息。如果有结果，它们将列在按钮下方。 


## Zerokey 工具跟踪器部件


Zerokey 工具跟踪器（Zerokey 设备跟踪器）小工具可检查特定设备是否位于用户定义的位置。这类似于检查设备是否在用户定义的区域内。用户可以通过部件道具定义区域。这可用于跟踪连接有 Zerokey 设备的扭矩驱动器的最近使用情况。在这种情况下，您可以检查是否拧紧了 "正确 "的螺丝。当扭矩驱动器向郁金香应用程序报告 "完成 "时，我们将使用该信号检查设备的位置，以确保 "正确 "的螺丝刚刚拧紧。


### 视频演示



### 设置


自定义 Widget 插件为在应用程序中添加自定义 Widget 提供了强大的工具。小工具允许您编写 Javascript 来扩展和自定义小工具的功能。Zerokey 小工具利用 Javascript 和 Zerokeys API 提供了广泛的功能。Tulip Zerokey 小工具还提供系统 "模拟 "行为，因此您可以立即开始测试小工具。Zerokey 小工具需要具备以下条件：


* 您的 Zerokey API URL
* 用于 API 身份验证的 Zerokey 用户名和密码
* 用户定义区域的中心 x
* 用户定义区域的中心 y
* 用户定义区域的宽度
* 用户定义区域的高度
* 将事件连接到应用程序
* 模拟数据


*关于 Zerokey Event Hub URL 和 API 标记，请参阅[Zerokey 文档](https://api.zerokey.com/)。*


### 用户定义区域


Zerokey Tool Tracker 部件可让您通过部件道具创建一个二维区域。您需要知道中心 x、y 位置以及区域的宽度和高度（以米为单位）。您可以使用 Zerokey 设备并将其放置在所需的中心位置，从而获得中心 x、y 位置。配置好用户定义的区域后，您就可以检查区域内是否有 Zerokey 设备。 


### 将事件连接到应用程序


要在郁金香应用程序中使用，您需要让硬件设备或机器触发一个事件。事件发生时，它应将**设备 ID**字符串写入一个变量。该变量应作为 Zerokey 工具跟踪器部件道具 "device\_id "的输入。


### 模拟数据


在小工具的 Javascript 代码中，您可以将模拟数据变量设为 true，以接收模拟数据；或设为 false，只接收真实数据。


### 如何使用


设置好 widget 后，您可以在 widget 编辑器中进行测试，也可以直接将其添加到应用程序中。在应用程序中配置好 widget 后，您就可以通过更新其 "device\_id "道具来触发 widget。通常情况下，这需要通过设备（物理工具）触发器来完成。设备触发器会将设备 ID 写入分配给 widget 的 "device\_id "道具的变量中。这将使 widget 向 Zerokey API 请求设备 ID 信息。如果设备的位置信息在用户定义的区域内，它将发送事件 "valid\_tool\_location"，如果在用户定义的区域内则为 true，否则为 false。