¶ CYD Dial Pendant
This is a pendant using a 2432S028 "Cheap Yellow Display" (with built-in ESP32) and a CNC Handwheel encoder. It has the same capabilities and the same user interface as the M5 Dial Pendant. Compared to the M5 Dial Pendant, the CYD Dial Pendant
- Costs about the same
- Has a metal dial with better "action" and detents than the M5's plastic dial
- Has on-screen touch buttons instead of the M5's physical switches.
- Is physically larger; the M5 version can be made quite compact
- Uses most of the same code
Refer to the M5 Dial Pendant wiki page for user interface documentation.
¶ Info & Sourcing
¶ Material Sourcing
¶ Cheap Yellow Display
The part number for the display and ESP32 is 2432S028, sometimes called 2432S028R. If you search for that number you will find several listing on AliExpress, Amazon, EBay, Banggood, etc. The typical price is $10 from AliExpress and $20+ from Amazon or EBay.
There are similar devices in various sizes and with various microprocessors. The code supports the 2.8" version with ESP32. There is also a variant with a USB-C connector in addition to the Micro-USB connector. Either will work.
¶ CNC Handwheel Encoder
Search for "CNC Handwheel Encoder". You want a 60mm, 100PPR, 5V unit. Either the 4-terminal or 6-terminal version will work. They cost about $7 on AliExpress and about $18 on Amazon. You can also get them in black instead of silver.
¶ Connectors for CYD ports
There are three 4-pin ports on the CYD board. The mating connectors are JST-1.25 4-pin, also known as PicoBlade.
You can buy them with pigtails already attached, and you can also get them with Dupont connectors on the other end (recommended). When you buy the Cheap Yellow Display, it will come with one such connector with Duponts on the other end. Unfortunately, you need a total of 3 such connectors, so you will have to buy two more.
AliExpress
¶ RJ11 / RJ12 Breakout
A nice way to connect back to the FluidNC controller is with a 6-pin RJ12 data cable. That is directly supported by some newer interface boards at the FluidNC side. The 3D printed case is designed to accept this connector.
This breakout board is very convenient.
Amazon
This breakout comes with the socket and the breakout board separate, so you will have to solder the socket to the board. It does not come with Dupont pins so you might want to purchase them separately. If you solder Dupont pins into the breakout you can make the connection to the CYD board with the Dupont females on the JST cables recommended above. Or you could solder pigtails from the JST connectors directly to the breakout.
You can use this breakout on both ends, as the pinout is designed to plug directly into a 6-pack module socket.
Note that pin 6 is not populated in this picture, since neither pin 2 nor pin 6 is used for this wiring scheme. You can populate them or omit them, at your option.
¶ Alternatives
You could also use an RJ45 socket and use only the middle 6 pins, but you would have to modify the case. If you get an RJ45 breakout with screw terminals, you could avoid any soldering. Or you could hardwire the cable.
¶ Cable to FluidNC (6 conductor RJ12 straight-wired data cable)
Be sure to get straight wired, not crossover. The colors should match up in the orientation shown.
Amazon.com
¶ 3D files for case
Fusion 360 Design for the CYD case Use this is you want to remix it.
¶ Screws
The case is held together with four M3x12mm self-tapping screws that go through the mounting holes on the CYD board. The bottom of the case has alignment ridges to hold the CYD board in place while attaching the top with the screws. There is some leeway as to the screw length - anything between 8 and 16 mm will work, but the longer the screw, the harder it will be to screw in.
¶ RJ11/RJ12 Connector Mounting
The specified connector slides into guides in the bottom of the case. Then you can glue it to the case to hold it in place. I used hot glue.
¶ Wiring
¶ Installing Firmware
¶ For the latest code you need:
Use Visual Studio Code with PlatformIO to compile and upload the code. Connect your display to the computer via a USB cable.
- Source code FluidDial (main branch)
Be sure to do all three tasks below.
¶ Compile and upload the firmware
- Click on the Platformio icon on the left column
- Click on Upload under PROJECT TASKS/cyd/Upload
¶ Build the filesystem image
This creates the file system with the icons and images.
- Click on the Platformio icon on the left column
- Click on Build Filesystem Image under PROJECT TASKS/cyd/Platform
¶ Upload the filesystem image
- Click on the Platformio icon on the left column
- Click on Upload Filesystem Image under PROJECT TASKS/cyd/Platform
¶ FluidNC Config Example
See the config example for FluidDial
¶ Usage
See the usage instructions for FluidDial
Use the on-screen red, green, and yellow touch buttons in place of FluidDial's physical switches and its dial switch.
¶ Orientation
To change the display orientation so you can use the CYC Dial Pendant with the handwheel in different positions relative to the screen, go to the About screen and rotate the handwheel. The orientation will change with each click of the wheel. The orientation will be saved so the pendant will start in the chosen orientation. The default orientation has the handwheel on top and the red/green/yellow buttons on the bottom.