注意：我还需要展示动作功能呢！

通用无线数控悬挂控制器！

这款手持控制器可作为您机器的 Klipper 网页界面的专用实时物理扩展设备。

特点：

• 实时位置镜像功能：它能每秒多次自动探测并实时反馈你的设备在 X、Y、Z 方向上的精确位置信息。

• 交互式网络配置门户：配备内置的专有网络门户，拥有简洁的网页界面。可通过智能手机或个人电脑直接管理 Wi-Fi 网络。

• 触觉式菜单导航：通过配备平滑加速逻辑的增量式旋转编码器，实现响应式菜单浏览功能。

• 专用紧急超控装置：实体触摸按钮可直接映射至关键的机器功能：主页(G28)，不过，暂停，不过，简历，还有紧急停车(E-Stop / M112)。

• 高清 OLED 显示屏：采用 U8g2 库进行设计，布局简洁清晰，在车间照明条件下也能实现高对比度显示效果，优化用户体验。

• 两个C型连接器：正面是用于ESP32的接口，如果你想对其进行修改的话；背面则是用于充电的接口。

它的工作原理

1. 智能网络入网服务：首次启动时，如果未配置 WiFi，ESP32 会自动创建自己的安全接入点。只需用手机连接，界面就会自动弹出一个设计精美的深色主题配置页面。

2. 适应性通信引擎：吊坠与Moonraker API在7125端口进行直接通信，利用优化后的JSON对象轮询机制获取坐标状态(gcode_move、toolhead)，同时不会给树莓派带来过多负担。移动指令会通过HTTP POST G-code脚本立即发送出去。

3. 异步架构：屏幕刷新和按钮状态切换程序完全独立于网络请求运行，确保用户界面始终保持流畅，数据传输期间绝不会出现卡顿现象。

📦 物料清单(BOM)

若要搭建这个项目，你将需要以下电子元件：

• 微控制器： ESP32 Devki v1 Type-C 接口版(30针版本)。

• 显示屏： 128x128 OLED 显示屏(例如，Pimoroni SH1107或同等型号的I2C SSD1306/SH1107显示屏)。

• 导航： EC11 旋转式编码器，内置按钮功能。(我用的是B型20毫米版本)

• 触觉按钮：8个MX轴(与任何普通机械键盘的轴体相同)

• 附件五金件：用于固定3D打印外壳的M3x6螺丝。

• 6个M3型加热插片(规格：M3xL4xOD 4.2)

• 用于将吊坠固定在底座上的2个10x4毫米磁铁

• 用于更换电池的1块TP4056电池

• 2个10千欧姆电阻器(如果你使用的是两个并联连接的电池的话)

• 1 节或 2 节 18650 型电池

• 1 个 KCD11 开关

• 1个22毫米铝制旋钮(或者你也可以自行打印)

用于制作电池的材料如下：JonnieZG的电池支架

你只需要将支架安装在电池上，并按照图片所示，将其滑入机箱盖上的插槽即可。

至于机械键盘的按键开关，我用的是低剖面3D打印款，但这完全取决于你的个人喜好了。

💻 软件及刷机操作指南

1. 请在 [项目名称] 中打开提供的源代码文件夹。阿杜伊诺集成开发环境。

2. 通过库管理器安装所需的库：

   • U8g2(由奥利弗开发)

   • ArduinoJson

   • ESPAsyncWebServer 与 AsyncTCP

   • AiEsp32 旋转编码器

   • Adafruit_NeoPixel

3. 请在“工具”菜单下选择您的ESP32型号，并在pendant.ino文件中对应调整显示屏引脚配置，最后点击确认即可。上传。

🔧 首次配置指南

1. 打开吊坠的电源。屏幕上会显示以下信息：“配置门户已激活”或者显示一个热点提示。

2. 打开智能手机或电脑的 WiFi 设置，连接名为 的网络。“悬挂式数控机床”。

3. 网页应该会自动打开。如果没有，请在浏览器中访问 http://192.168.4.1。

1. 使用该界面选择您的 WiFi 网络，输入密码，并以相应的名称和本地网络 IP 地址添加您的 CNC 设备。

2. 点击保存并重启。该吊坠将加入您的网络，连接到您的设备，并检查镜像坐标。

如果您发现代码或设计方面存在任何缺陷，请告知我。若有人想对其进行修改，步骤文件已附上。但请注意，我的母语是西班牙语，因此代码中可能会有一些西班牙语词汇。

就我的情况而言，我使用了0层底层和5层顶层，并采用希尔伯特曲线设置了30%的填充率，以赋予模型更美观的外观。不过，如果你愿意的话，也可以尝试使用更高的填充率进行实验。

干杯！