Stream Deck CNC: controla tu fresadora con UGS sin ratón

¿Por qué montar un Stream Deck CNC en el taller?

La respuesta rápida es «por comodidad», pero eso se queda corto y además no es lo importante. La razón de peso es la seguridad.

Piensa en lo que haces cuando estás afinando el cero de pieza. Bajas la Z de dos en dos décimas, buscando el momento exacto en que la fresa toca el material. En ese momento quieres tener los ojos en la punta de la herramienta, no en la pantalla del ordenador buscando dónde estaba el botón de Z-. Cada vez que apartas la vista para localizar un control, estás moviendo la máquina a ciegas durante ese instante.

Eso es exactamente lo que arregla un Stream Deck CNC: las teclas están siempre en el mismo sitio, tienen relieve, y las localizas con el tacto y con el color periférico sin necesidad de leer nada. Puedes tener la mirada clavada en la fresa mientras la mano encuentra sola la tecla de Z-.

Hay tres problemas concretos que un Stream Deck CNC resuelve en el día a día:

• Los controles críticos están repartidos por la interfaz. En UGS, el desbloqueo de alarma, el home y el paro no están juntos ni tienen el mismo tamaño. En el panel los pones donde tú quieras.
• El ratón y el teclado sufren en el taller. Viruta metálica, refrigerante y polvo de MDF no perdonan. Un panel de teclas de silicona o plástico duro aguanta bastante mejor y se limpia de una pasada.
• Las secuencias repetitivas se comen el día. Ir a posición de cambio de herramienta son cuatro o cinco operaciones si lo haces a mano. Con un Stream Deck CNC es una tecla.

Y hay un cuarto beneficio que no esperaba: reduce los errores por prisa. Cuando una operación cuesta una sola pulsación, dejas de improvisar atajos peligrosos para ahorrarte pasos.

¿Qué modelo necesitas para tu Stream Deck CNC?

Aquí la pregunta real no es «cuál es el mejor», sino cuántas teclas vas a necesitar de verdad. Y la respuesta depende de una decisión previa: si quieres que cada acción tenga su tecla propia o si aceptas navegar por carpetas.

Mi criterio es claro. La ventaja de un Stream Deck CNC es que una tecla es una acción, sin pensar. En cuanto tienes que entrar en una carpeta para encontrar el botón, has recuperado parte del problema que querías eliminar. Por eso yo prefiero ir sobrado de teclas y reservar las carpetas para agrupar por tipo de trabajo (fresado, taladrado, palpado), no para exprimir un panel pequeño.

Estas son las cuatro opciones que considero razonables, de menos a más:

Stream Deck Mini (6 teclas) — Se queda muy justo para controlar una CNC. Solo entre jog, ceros y control de programa ya te pasas. Lo veo únicamente como panel secundario dedicado a una función concreta, por ejemplo solo palpado, o como primer contacto barato para probar si el concepto te convence antes de gastar más.
👉 Ver precio en Amazon

Stream Deck MK.2 (15 teclas) — El punto dulce si tu uso es sencillo y no vas a montar macros de palpado ni posiciones guardadas. Con 15 teclas te dan para jog en tres ejes, ceros, home, unlock y control de programa, pero ya sin margen para crecer. Si sabes que tu flujo de trabajo es estable, es una compra muy sensata.
👉 Ver precio en Amazon

Stream Deck XL (32 teclas) — Es el que uso yo y el que recomendaría si te lo puedes permitir. La diferencia no es tener el doble de botones: es poder dejar espacios vacíos a propósito entre grupos de teclas. Ese hueco físico entre el bloque de jog y el bloque de «arrancar programa» es lo que evita que pulses lo que no querías. En un panel pequeño, todo está pegado a todo.
👉 Ver precio en Amazon

Alternativa económica (Ajazz / paneles compatibles) — Existen paneles con pantallas LCD por tecla a una fracción del precio de Elgato. Funcionan con su propio software y, para lo que necesitamos aquí —mandar combinaciones de teclado—, cumplen. La contrapartida es soporte, calidad de construcción y actualizaciones menos fiables. Si el presupuesto manda, es una entrada válida al concepto.
👉 Ver precio en AliExpress

Las dos formas de conectar el panel con UGS

Esto es lo que casi nadie explica y es la clave de todo el montaje. Hay dos caminos para que tu Stream Deck CNC hable con UGS, y el segundo es infinitamente más potente.

Camino 1: atajos de teclado nativos

El panel manda una combinación de teclas y UGS la interpreta. En UGS Platform vas a Tools → Options → Keymap, buscas la acción que quieras (jog en un eje, home, desbloqueo) y le asignas una combinación. Luego, en el software del panel, creas un botón de tipo «Hotkey» con esa misma combinación.

Es simple y funciona a la primera. Sus dos limitaciones: solo puedes disparar acciones que UGS ya tenga programadas, y UGS tiene que estar en primer plano. Si tienes el CAM abierto encima, el atajo se lo come el CAM.

Camino 2: macros de UGS

Aquí es donde un Stream Deck CNC deja de ser un mando a distancia y se convierte en una herramienta seria. Creas una macro dentro de UGS (en Machine → Macros) con el G-code que tú quieras, le asignas un atajo desde el mismo Keymap, y el panel dispara ese atajo.

La diferencia conceptual es importante y merece que la entiendas bien: el panel no sabe nada de tu máquina. El panel solo manda una combinación de teclas. Toda la inteligencia está en la macro de UGS. Eso significa que el día que cambies de panel, o que quieras disparar lo mismo desde un teclado numérico USB de doce euros, tus macros siguen valiendo. No estás atado al hardware.

El truco que casi nadie usa: variables dentro de las macros

Esto es lo que separa un Stream Deck CNC decente de uno realmente útil, y está documentado en el propio código de UGS aunque casi nadie lo mencione. Las macros admiten sustituciones interactivas: puedes meter la posición actual de la máquina dentro del G-code, o hacer que UGS te pregunte un valor al pulsar la tecla.

Un ejemplo tonto pero que uso a diario: una tecla que baja la Z a la profundidad que yo le diga en ese momento, con -1 mm ya puesto por defecto.

G90 G1 Z{prompt|Profundidad|-1} F200

Y el valor que te pide se puede reutilizar en la misma macro: si escribes X{prompt|pos} Y{pos}, te pregunta una sola vez y aplica ese número a los dos ejes.

¿Cómo se configura el jog en un Stream Deck CNC?

Esta es la parte donde yo me equivoqué al planteármelo, así que te ahorro el rodeo.

Mi idea inicial era tener una tecla que cambiase el tamaño de paso: la pulsas y va rotando entre fino, medio y basto. Parece lo lógico. Es mala idea.

El motivo es que UGS no tiene acciones para fijar un paso concreto; lo que existe son acciones para aumentar, disminuir, multiplicar o dividir el paso actual. Todo relativo. Eso significa que después de pulsar esa tecla no sabes en qué paso estás sin mirar la pantalla. Y mirar la pantalla es justo lo que estábamos intentando evitar. Has movido el problema, no lo has resuelto.

La solución buena es meter el tamaño de paso dentro de la propia macro y usar las carpetas del panel como selector visual:

Dentro de cada carpeta tienes el mismo dibujo de flechas, pero disparando macros distintas. Y lo mejor: el paso activo lo ves en el propio panel, en el color de la carpeta en la que estás. No hay estado oculto. Además, si estás en la página principal no puedes hacer jog por accidente, lo cual es una ventaja de seguridad que no había buscado pero que agradezco.

La macro de jog, línea por línea

Para mover X un milímetro en positivo, la macro es esta:

$J=G91 G21 X1 F1000

Desglosada:

• $J= — Comando de jog de GRBL 1.1. No es un G1. Es cancelable en cualquier momento, no altera el estado modal de tu programa y no se queda encolado de forma peligrosa. Usar G1 para hacer jog es un error clásico.
• G91 — Movimiento incremental: «muévete 1 mm desde donde estás», no «vete a la coordenada 1».
• G21 — Milímetros, declarado explícitamente. No des por supuestas las unidades en una macro que va a moverte la máquina.
• X1 — La distancia. Aquí es donde codificas el tamaño de paso de cada carpeta: 0.1, 1 o 10.
• F1000 — Avance del jog en mm/min. Bájalo en la carpeta de paso fino.

Un detalle de la documentación oficial de GRBL que casi nadie sabe: el avance F de un comando de jog se interpreta siempre en unidades por minuto, aunque tu programa estuviera en G93. Y el jog solo se acepta si la máquina está en estado Idle o Jog.

Necesitas una macro por cada combinación de eje, sentido y paso. Con tres pasos, tres ejes y dos sentidos son 18 macros. Suena a mucho, pero se copian y se cambia un número. Nómbralas con un patrón tipo JOG_X+_1 para encontrarlas luego en el Keymap. Si solo quieres paso fino en Z y normal en XY, con doce te sobra.

Para los atajos, usa combinaciones que no vayas a pulsar nunca por accidente: Ctrl+Alt+Shift+F1, F2, F3… Nada de teclas sueltas ni flechas. Si un día apoyas el codo en el teclado, no quieres que la máquina se mueva.

El recetario: las macros que la comunidad usa de verdad

Aquí está lo que de verdad justifica montar un Stream Deck CNC. Estas son las macros que aparecen una y otra vez en los foros de OpenBuilds, Shapeoko, Sienci e Inventables, contrastadas con la documentación oficial de GRBL. Todas se copian y se pegan tal cual en Machine → Macros.

Salvo donde se indique lo contrario, funcionan igual en GRBL 1.1, grblHAL y FluidNC.

1. Fijar el cero de pieza (la que más se usa)

G10 L20 P1 X0 Y0 Z0

G10 L20 significa «haz que la posición en la que estoy ahora valga esto». P1 es el sistema G54 (P2 sería G55, y así). Para ceros individuales, la misma macro pero con un solo eje:

G10 L20 P1 X0
G10 L20 P1 Y0
G10 L20 P1 Z0

2. Palpar el cero de Z con placa de tacto

Requiere placa de tacto conectada al pin de sonda de tu controladora y una pinza al portafresas. Esta es la versión estándar, con compensación del espesor de la placa:

G91
G38.2 Z-25 F100
G10 L20 P1 Z1.50
G90
G0 Z10

• G91 — relativo, para que el palpado sea «baja hasta 25 mm desde aquí».
• G38.2 Z-25 F100 — baja despacio hasta que la sonda hace contacto. Si no toca en 25 mm, da alarma.
• G10 L20 P1 Z1.50 — cambia 1.50 por el espesor real de tu placa. Este es el número que todo el mundo se olvida de ajustar.
• G90 + G0 Z10 — vuelve a absoluto y retira la herramienta 10 mm.

Las variantes de palpado, por si las necesitas: G38.2 da alarma si no toca (la que quieres normalmente), G38.3 no da error si falla, y G38.4/G38.5 palpan alejándose de la pieza en vez de acercándose.

3. Palpar el cero en X (y en Y)

G21
G91
G38.2 X50 F100
G10 L20 P1 X-11.6
G1 X-5 F300
G0 Z15
G90

El número clave es X-11.6: es el radio de tu fresa más el espesor de la pared de la placa. Cámbialo por el tuyo o el cero saldrá desplazado. Para el eje Y es la misma macro cambiando las X por Y.

Para palpado de esquina completo (XYZ de una vez) no merece la pena pelearse con macros: UGS Platform trae una ventana de palpado con asistente de esquina exterior que lo hace solo.

4. Volver al cero de pieza sin romper nada

Esta macro es de las que más disgustos evita, y la clave está en el orden: Z arriba primero, siempre.

G53 G0 Z-1
G0 X0 Y0

G53 mueve en coordenadas de máquina, ignorando los offsets de trabajo. Eso es exactamente lo que quieres para subir la Z: da igual dónde tengas el cero de pieza o lo alta que sea la pieza, G53 Z-1 sube al tope de la máquina y punto. Luego, ya arriba, mueve X e Y al cero de pieza.

5. Ir a posición de cambio de herramienta

M5
G53 G0 Z-1
G0 X0 Y0
G4 P5

Apaga el husillo, sube la Z a lo seguro, se acerca a un punto cómodo para llegar con la mano y espera 5 segundos. Ajusta las coordenadas XY a lo que te venga bien en tu máquina.

6. Desbloqueo, homing y reset

Si no tienes finales de carrera, esta es la alternativa de «homing» usando una posición guardada, muy común en máquinas tipo 3018:

G91 G28 Z0;G91 G28 X0 Y0

7. Línea de seguridad para reanudar tras cancelar

Cuando cancelas un trabajo a media ejecución, la máquina se queda con estados modales impredecibles. Esta macro los resetea antes de volver a arrancar:

G90 G21 G54 G17

Absoluto, milímetros, sistema de coordenadas 1, plano XY. Cuatro palabras que evitan que el siguiente movimiento sea una sorpresa.

8. Husillo, refrigerante y aspiración

M3 S8000    (husillo ON a 8000 rpm)
M5          (husillo OFF)
M8          (refrigerante / aspiración ON)
M9          (refrigerante / aspiración OFF)

Muchos makers cablean un relé a la salida de refrigerante precisamente para encender la aspiración con M8 desde el panel. Ojo: M7 (niebla) viene desactivado por defecto en GRBL de serie, hay que habilitarlo al compilar.

Y una macro que agradece el husillo en talleres fríos, calentándolo por escalones antes de trabajar:

M3 S1000
G4 P10
M3 S5000
G4 P10
M3 S8000

9. Recuperar un trabajo tras rotura de fresa o corte de luz

UGS Platform tiene la función Machine → Start From, que permite arrancar el G-code desde la línea que tú elijas. No es una macro, pero es la herramienta que salva el día y merece estar aquí.

El dato clave que casi nadie explica: los ceros G54–G59 se guardan en memoria no volátil y sobreviven a un apagón. Lo que no sobrevive es G92, la compensación de longitud de herramienta G43.1 y los datos del último palpado. Por eso el procedimiento seguro es:

1. No muevas la pieza. Anota la última línea que se ejecutó.
2. Haz homing ($H) para recuperar la referencia de máquina.
3. Verifica el cero G54. Si cambiaste la fresa, vuelve a palpar la Z.
4. Enciende el husillo a mano — Start From no lo hace por ti.
5. Arranca desde la línea elegida.

Cuatro errores que cometí montando mi Stream Deck CNC

1. Poner teclas peligrosas junto a teclas de uso constante. Tenía «arrancar programa» pegada al jog de Y. Se explica solo. Las críticas, a una esquina o con un hueco vacío de por medio.

2. Elegir iconos bonitos en vez de códigos de color. Con las manos ocupadas y la vista en la fresa, no reconoces un dibujo pequeño: reconoces un color. Asigna un color por función —movimiento, ceros, programa, peligro— y hazlo consistente en todas las carpetas.

3. Confundir coordenadas máquina y coordenadas pieza en una macro. Un G53 olvidado o de más cambia por completo dónde acaba la herramienta. Cada macro de movimiento absoluto debe declarar explícitamente en qué sistema trabaja.

4. No meter retardos en las multiacciones. Si encadenas varios comandos sin pausa, la controladora puede perderse alguno. Un retardo de 100–200 ms entre pasos lo arregla.

¿Qué más puedes controlar desde el mismo panel?

Aquí viene la parte que no esperaba cuando compré el mío: la CNC acabó siendo una carpeta del panel. Si ya vas a tener un Stream Deck CNC en la mesa, estas son las cosas que la gente le acaba enchufando.

¿Y si no quiero gastarme el dinero en un Elgato?

Te lo digo con honestidad porque creo que ayuda más que vender humo: para controlar UGS por atajos, un macropad barato con firmware QMK o VIA hace el 90% del trabajo. También sirve un teclado numérico USB reprogramado por veinte euros. Las teclas mecánicas incluso se localizan mejor al tacto.

Lo que no te da un macropad es la pantalla por tecla. Y ahí está el argumento real a favor del Stream Deck CNC: poder ver el paso de jog activo en el color de la carpeta, que el botón de aspiración cambie de aspecto según esté encendida o apagada, o que la tecla te muestre el avance de la impresora 3D. Si vas a usar ese estado visual, el panel se paga solo. Si solo quieres disparar seis atajos fijos, ahorra el dinero y ponlo en fresas.

¿Merece la pena montar un Stream Deck CNC?

Si usas la máquina de forma esporádica, probablemente no lo necesites. Si la usas todas las semanas y te pasas el rato afinando ceros y cambiando herramientas, la diferencia es notable desde el primer día.

Y hay un matiz que quiero dejar claro para no vender humo: un Stream Deck CNC no te hace ir más rápido. Las operaciones tardan lo mismo. Lo que hace es dejarte trabajar sin apartar la vista de la máquina, y eso se traduce en menos sustos, no en menos minutos. Para mí ese es el argumento de compra real.

Si quieres seguir profundizando en este tipo de montajes y trucos de taller, tienes más contenido de mecanizado en la sección de mecanizado del blog.

Fuentes y documentación para seguir

Todo lo técnico de este artículo está contrastado con documentación oficial y con hilos de foros donde la gente lo ha probado en su máquina. Si quieres ir a la fuente:

• Wiki oficial de GRBL 1.1 — listado completo de comandos
• Wiki de GRBL — documentación del comando de jog $J=
• Repositorio oficial de Universal Gcode Sender
• grblHAL — diferencias respecto a GRBL 1.1
• Documentación de LightBurn sobre atajos personalizables
• Bitfocus Companion — software libre para control avanzado del panel