Pendant CNC HID Personalizado com Arduino Leonardo: Controle DIY de Baixo Custo
Componentes e Materiais
- Arduino Leonardo (ou Arduino Micro — chip ATmega32u4 obrigatório) — 1 unid.
- Botões momentâneos iluminados (com tampa transparente para etiquetas) — 23 unid.
- Volante manual (handwheel) 100 PPR, 6 terminais — 1 unid.
- Madeira (mogno) para gabinete — peças usinadas em CNC
- Resistores 1 kΩ (pull-down para LEDs dos botões) — 23 unid.
- Etiquetas adesivas polivinílicas (impressora laser/inkjet)
- Verniz acrílico (várias demãos)
Sobre o Projeto
Pendentes comerciais para CNC custam ~100 € e oferecem apenas 2 botões + handwheel. Como já construí minha própria fresadora CNC de madeira, decidi fazer meu próprio pendente: 23 botões com até 6 funções cada (clique simples, duplo, triplo, segurar simples/duplo/triplo) + handwheel.
Por que Arduino Leonardo / Micro?
O chip ATmega32u4 tem USB nativo e pode emular teclado/mouse (HID). Ao conectar no PC, o sistema reconhece um teclado. Cada pressionamento de botão envia atalhos de teclado (keystrokes) para o software de controle da CNC (no caso, EdingCNC).
Biblioteca ClickButton
A chave para múltiplas funções por botão é a biblioteca ClickButton (incluída nos arquivos do projeto). Ela fornece:
- Detecção de clique simples, duplo, triplo
- Detecção de "clique e segurar" (simples, duplo, triplo)
- Debounce embutido (padrão: ≥250 ms para clique, ≥1000 ms para hold)
Exemplo de Mapeamento (Botão Eixo X — pino 13)
if (button[13].clicks != 0) {
switch (button[13].clicks) {
case 1: shortcut_HANDWHEEL_X(); break; // Handwheel no eixo X
case 2: shortcut_ZERO_X(); break; // Zerar X
case 3: break; // Reservado
case -1: // Single click + hold → Macro usuário 18 (G0 X0)
press_ESC(); goto_MAIN_MENU(); user_MACRO_18(); break;
case -2: break;
case -3: break;
}
}
Gabinete em Madeira
Usinagem em CNC (software Vectric Cut2D) — madeira mogno 21 mm (tampa + base). Após lixamento, várias demãos de verniz. Espessura final ≈ 36,5 mm. Os botões exigem essa altura por serem "altos".
Botões e Etiquetas
- Botões momentâneos com LED interno (2 mA @ 5 V via resistor 1 kΩ).
- Ligação simples: um lado de todos os botões no GND, outro nos pinos de entrada do Arduino (pull-up interno ativado).
- Etiquetas impressas em vinil polivinílico (não use papel comum — a textura aparece com LED aceso). Ícones copiados do software EdingCNC.
Handwheel
Modelo padrão 60 mm, 100 pulsos/rotação, 6 terminais (A, /A, B, /B, VCC, GND). Configurável no software CNC.
Eletrônica
Arduino Leonardo (descontinuado, mas disponível; Micro é alternativa direta). 23 pinos de entrada suficientes. Consumo total ~150 mA com LEDs acesos.
Programação
O pendente permanece ligado à fonte da CNC durante a programação. Conecte o USB no PC, compile e faça upload pela Arduino IDE. Para programar em outro PC, basta mover o cabo USB (mantendo a alimentação da CNC ligada).
Código Principal (estrutura)
O sketch completo é longo (≈600 linhas); aqui a estrutura essencial:
#include "ClickButton.h"
#include "Keyboard.h"
const int buttons = 20; // 20 botões usados (pinos 0-13, A0-A5)
ClickButton button[21]; // array indexado de 1 a 20
void setup() {
for (int i = 1; i <= buttons; i++) {
button[i].debounceTime = 20;
button[i].multiclickTime = 250;
button[i].longClickTime = 1000;
}
}
void loop() {
for (int i = 1; i <= buttons; i++) button[i].Update();
// Botão 1: Reset (F1) / ESC / Desliga drives (hold)
// Botão 2: Menu Principal (Alt+F1)
// Botão 3: Home all axes (Ctrl+H) [hold]
// Botão 4: Toggle MDI (Ctrl+F6)
// Botão 5: Macro Set Z Height (Alt+1)
// Botão 6: Menu Auto (Alt+F4)
// Botão 7: Redraw Graphics (F3)
// Botão 8: Load File (F2)
// Botão 9: Toggle Aux1 (Vacuum) (Ctrl+M) c/ debounce 1s
// Botão 10: Toggle Mist/Light (Ctrl+L)
// Botão 11: Go to P1 / G28 (Macro 16)
// Botão 12: Go to P2 / G30 (Macro 17)
// Botão 13: Handwheel X / Zero X / Go X0 (hold)
// Botão 14: Handwheel Y / Zero Y / Go Y0 (hold)
// Botão 15: Handwheel Z / Zero Z / Go Z Machine Up (hold)
// Botão 16: (Eixo A - reservado)
// Botão 17: Handwheel 1x (Ctrl+N)
// Botão 18: Handwheel 10x (Ctrl+O)
// Botão 19: Handwheel 100x (Ctrl+P)
// Botão 20: Toggle Machine/Work Coords (Ctrl+W)
// ... funções auxiliares: press_RESET(), press_ESC(), goto_MAIN_MENU(),
// shortcut_HANDWHEEL_X(), shortcut_ZERO_X(), user_MACRO_1(), etc.
}
Cada função auxiliar usa Keyboard.press() / Keyboard.releaseAll() com modificadores (KEY_LEFT_CTRL, KEY_LEFT_ALT, KEY_LEFT_SHIFT, KEY_F1…KEY_F12).
Arquivos do Projeto
clickbutton_hq5qeT4toX.zip— biblioteca ClickButton (essencial)cnc_pendant_SenmxC8UCj.zip— arquivos CAD (Vectric Cut2D) do gabinete
Esquemático
Resumo de Vantagens
- Custo muito inferior ao comercial
- Totalmente personalizável (funções, layout, ícones)
- Feedback tátil e visual (LEDs nos botões)
- Peso e tamanho dão estabilidade ao girar o handwheel
- Fácil manutenção e expansão
Processo de manufatura
- O Botão: De Fixador Antigo à Inovação Moderna
- Controle de Brilho de LED com PWM via Botão no Arduino Mega
- Construa um Spybot Controlado por Bluetooth com Arduino
- FlickMote: Controle Remoto IR por Gestos para Casa Inteligente
- DIY Arduino TV B-Gone: Controle Remoto Universal para Todas as TVs
- Construa um Relógio Mestre LED Personalizado com Alarme – Visível a 12 Metros
- Find Me: Localizador Inteligente de Objetos com Arduino e Bluetooth
- Crie um Botão de Teclado "Socável" Personalizado com Arduino: Guia Passo a Passo
- OPENwiTP da Osai USA: Pendant de Ensino Sem Fio para Controle CNC Eficiente
- Entendendo o Botão Reset no Painel do Operador CNC: Função e Uso