XHC-WHB04B-04 Got it working

I spent hours upon hours on trying to get the new xhc wireless pendant working. While all the forum posts helped it wasn't until I started trying to match pins signals and tracking down errors that I realized the only thing throwing errors was the halui already connected mesage so instead of commenting out that line I just deleted the halui part of each of those connections and it viola. It is working for both my QTdragon and QTPlasma configs next step is to start assigning the macros, and buttons hope this helps someone.

I will have to take a look, because I ran out of patience last year with it and walkd away.

and thank you

I should also mention I changed machine.is.on to machine-is-on, and i had to edit the udev rules so that the pendant was seen by my system,besides that, I just deleted the halui connection to all the startup errors one by one. All the functions seem to be working and the pendant is displaying the positional information. Remember to press continuous to allow it to jog, if you don't it will adjust the feedrate if you spin the pendant.

[SOLVED] XHC-WHB04B-6 on LinuxCNC 2.9.6 (QtDragonHD + 7i96S) — Beginner notes
(I am sharing the exact steps I followed, written simply. Many threads assume advanced users; I am a beginner.)My machine / system

• Gantry router XYYZ (dual Y motors), work area approx. 1300 x 1210 mm
• Controller: Mesa 7i96S (Ethernet, step/dir)
• Spindle: 2.2 kW, 24,000 RPM
• UI: QtVCP / QtDragon_HD
• OS: Raspberry Pi 5, Debian 12 (Bookworm)
• LinuxCNC 2.9.6

What actually fixed it (short version)

1. Load the pendant HAL file as a HALFILE (before the post-GUI), same as the donor machine.
2. Add MDI_COMMAND lines under [HALUI] so pins halui.mdi-command-XX exist.
3. Keep qtvcp_postgui.hal clean (only GUI signals, no pendant driver).
4. In my case, moving the WHB USB dongle to another port made the wheel/jog and DRO updates work.

STEP 1 — Copy the pendant HAL file
Place xhc-whb04b-6.hal in your config folder (the same folder that has your .ini and main .hal), e.g.: STEP 2 — Load the pendant before the post-GUI
Open your .ini and in the [HAL] section add this line and keep this exact order: Important: do not load the WHB driver inside qtvcp_postgui.hal.STEP 3 — Create MDI pins under [HALUI]
In the same .ini, find (or create) the [HALUI] section and paste this block right under it: This creates halui.mdi-command-00..07 (indexes follow the order above).
Add more MDI_COMMAND lines if your xhc-whb04b-6.hal uses higher indices.Notes so jogging actually works

• E-STOP released, Machine ON
• Manual mode
• Fully homed (for XYYZ: X, Y1, Y2, Z)
• On the pendant, use Continuous, or Step + Step size
• If the wheel does nothing or DRO does not update: try a different USB port/dongle (this was the final fix for me)

Thanks and request
Many thanks to the original thread’s author for sharing files and guidance.
If possible, could you post a short summary of the final button mapping (what each macro-N does, Continuous/Step, ABS/REL, etc.)? That would help beginners keep their configs consistent.If anyone needs it, I can share my final .ini, xhc-whb04b-6.hal, and a minimal qtvcp_postgui.hal exactly as they ended up.

I don't use the pendant anymore and rely on a touch screen and wireless keyboard because my machine is a dual-use plasma /router, and I couldn't get plasmac.comp to play nice with the pendant. But once I get the table put back together, I will revisit and see if the berry is worth the squeeze.

First of all, thank you so much for your effort and for sharing your files—without them I never would have gotten mine working.
I learned the hard way that it’s not practical to have one machine serve as both a router and a plasma cutter, so I developed a very affordable “plasma router” that works perfectly, and now I keep the two machines separate.
I’m leaving a video so you can see it running in case it helps, and a link where you can download the 3D model and wiring diagrams. I’m sharing it as open-hardware to give back a little of the much that the community—and generous acts like yours—have given me.


3D model and wiring files here
opencnc.mx/wordpress/index.php/elementor-420/