手持盒支持

WiXHC WBH04 手持盒支持已在 0.10.0 版本中添加

Community Controller 支持 WiXHC HB 系列的挂件来控制机器。它们可以从 AliExpress 或其他在线零售商处购买。该系列设备有多种变体，包括 4/6 轴型号（WHB04/WHB06），以及有线/无线（LHB04/LHB06）。所有这些预计都能与 Community Controller 一起工作。

此功能在 Windows、MacOS 和 Linux 上受支持。不适用于 iOS 或 Android。

图示为一台 4 轴无线 WBH04

配置

可能的配置选项

下面是挂件配置屏幕的截图，显示了所有可能的选项：

启用集成

要在 Controller 中启用 WBH04 挂件支持：

1. 将挂件接收器（如果是无线）或挂件 USB 线缆插入将运行 Controller 软件的计算机。不需要驱动程序。

2. 打开 Controller 并浏览到设置屏幕。

3. 在设置的挂件部分选择“使用硬件挂件”下拉菜单，并选择 WHB04 选项。只有当 WHB04 类型设备连接到计算机时才会出现此选项。

4. 应用该设置。现在可以使用挂件了。

在挂件上设置主要操作

WBH04 挂件设备具有可设置为运行宏的功能按钮。在挂件配置屏幕中有设置 主要按钮操作为 它定义了按下按钮时发生的事情。可以是 按键特定操作 或者 宏。此设置的相反情况是在按下该按钮的同时按下 FN 键时发生的事情。

例如如果 主要按钮操作为 设置为按键特定操作，按下键将使进给覆盖增加 10%。按下 + 将运行宏 #1。

例如如果 主要按钮操作为 设置为宏，按下键将运行宏 #1。按下 + 将使进给覆盖增加 10%

设置宏

挂件支持配置最多 10 个宏。这些宏是短的 gcode 片段，当对应的宏按钮被按下时将被执行。

可以在 设置->挂件 屏幕中点击 与宏编号对应的 UI 按钮 来进行配置。

这将调出宏编辑屏幕：

步进/连续 按钮

自机器固件版本 2.0.0 起 支持连续点动模式 。按下连续 或 步进 按钮可切换点动模式。当前模式在挂件 LCD 上显示为 STP 或 CON，并且也反映在 Controller 界面中。

如果速度/步进 旋钮 设置为 Lead 并且选择了连续模式，则移动速度将根据点动轮的速度和在 点动控制.

中选择的点动速度而变化。

使用 要使用挂件进行点动，必须在主控制屏幕上启用挂件点动切换 。当基于挂件的点动启用时，按钮为蓝色。动作/宏按钮将无论

是否启用 都会工作。

Linux 要在 Linux 中使用挂件，系统需要 libhidapi-hidraw0

包。

Linux 设备权限 要在 Linux 中使用挂件，您需要授予您的用户对该 USB 设备的访问权限。大多数 Linux 发行版（Ubuntu/Debian/Fedora）会自动将用户添加到 plugdev

组，因此最简单且最安全的方法是创建一个 udev 规则，授予该组对设备的访问权限。

运行此命令以创建 udev 规则：

sudo sh -c 'echo "SUBSYSTEM==\"hidraw\", ATTRS{idVendor}==\"10ce\", ATTRS{idProduct}==\"eb93\", GROUP=\"plugdev\", MODE=\"0660\"" > /etc/udev/rules.d/90-xhc.rules'

创建规则后，您可能需要重新加载 udev 规则：
sudo udevadm control --reload-rules

sudo udevadm trigger

已知限制

WBH04 挂件/集成存在若干已知限制。

在 LCD 上显示为 % 的移动步进

挂件 LCD 屏幕始终以 % 显示移动步进（STP），但每次旋转拨盘“点击”实际的移动尺寸由白色文本中的毫米数定义：

无效的轴值 在轴选择设置为关闭或 Controller 尚未连接到机器时，挂件屏幕上的轴位置值可能显示不正确的值。