Esta sección describe la forma recomendada de descargar y hacer una nueva instalación de LinuxCNC. Para los mas atrevidos, también hay métodos alternativos de instalación. Si su máquina tiene una instalación existente que desea actualizar, vaya a la sección Actualizando LinuxCNC.

Nota
Para operar maquinaria, LinuxCNC requiere un kernel especial con extensiones para tiempo real. Existen tres posibilidades: preempt-rt, RTAI o Xenomai. Además hay dos versiones de LinuxCNC que funcionan con estos kernels. Para más detalles, vea la tabla mas abajo. No obstante, para pruebas de código y simulaciones es posible ejecutar la aplicación linux-uspace en un kernel de stock de la distribución.

Las instalaciones nuevas de LinuxCNC se crean fácilmente utilizando una imagen Live/Install. Esta es una imagen ISO híbrida del sistema de archivos que se puede grabar en un dispositivo de almacenamiento USB o un DVD para arrancar una computadora. En el momento del arranque se le dará la opción de arrancar el sistema "Live" (para ejecutar LinuxCNC sin hacer ningún cambio permanente en tu computadora) o arrancar un Instalador (para instalar LinuxCNC y su sistema operativo en el disco duro de tu computadora).

A grandes razgos, el proceso es como:

  1. Descargar la imagen Live/Install.

  2. Grabar la imagen en un dispositivo de almacenamiento USB o DVD.

  3. Arrancar el sistema Live para probar LinuxCNC.

  4. Arrancar el instalador para instalar LinuxCNC.

1. Descargar la imagen

Esta sección describe algunos métodos para descargar una imagen Live/Install.

1.1. Descarga normal

Software for LinuxCNC to download is presented on the project’s Downloads page. Most users will aim for the disk image for Intel/AMD PCs, the URL will resemble https://www.linuxcnc.org/iso/linuxcnc_2.9.8-amd64.hybrid.iso.

Para la Raspberry Pi, se proporcionan múltiples imágenes para manejar las diferencias entre las RPi4 y RPi5.

Nota
No uses la distribución normal de Raspbian para LinuxCNC que pudiera estar incluida en tu kit de inicio de RPi, esa no tendrá el núcleo de tiempo real y no podrás migrar desde Raspbian a la imagen del kernel de Debian.

1.2. Descargar usando zsync

zsync es una aplicación de descarga que reanuda eficientemente descargas interrumpidas y transfiere de manera eficiente archivos de gran tamaño con pequeñas modificaciones (si tienes una copia local anterior). Considera que necesita usar el protocolo http y no https. Usa zsync si tu descarga de la imagen se interrumpe frecuentemente usando el método de descarga normal.

zsync en Linux
  1. Instalar zsync usando Synaptic o ejecutando lo siguiente en una terminal

    sudo apt-get install zsync
  2. Luego, ejecute este comando para descargar el iso a tu computadora

    zsync https://www.linuxcnc.org/iso/linuxcnc_2.9.8-amd64.hybrid.iso

Por favor, no olvides confirmar la suma de verificación (checksum) del iso descargado como se describe a continuación, ya que no se garantiza la autenticidad del servidor con el protocolo http.

zsync en Windows

Hay una versión para Windows de zsync. Funciona como una aplicación de consola y puede descargarse desde https://www.assembla.com/spaces/zsync-windows/documents .

1.3. Verificar la imagen

(Este paso no es necesario si usaste zsync)

  1. Después de la descarga, verifique la suma de comprobación de la imagen para garantizar su integridad.

md5sum linuxcnc-2.9.8-amd64.iso

ó

sha256sum linuxcnc-2.9.8-amd64.iso
  1. Luego, compare las sumas de verificación

amd64 (PC)
md5sum: cf77d61fcba9641d7205ac33751e5f38
sha256sum: 72eab92d7c34c238b0429054dc52d240df8dc5f083e769a39194cfac3e4984e8
arm64 (Pi)
md5sum: 4547e8a72433efb033f0a5cf166a5cd2
sha256sum: ff3ba9b8dfb93baf1e2232746655f8521a606bc0fab91bffc04ba74cc3be6bf0
Verificar md5sum en Windows o Mac

Windows does not come with an md5sum program, but there are alternatives. More information can be found at: How To MD5SUM

2. Escribir la imagen en un dispositivo de arranque

La imagen LinuxCNC Live/Install es una imagen ISO híbrida que se puede grabar directamente a un dispositivo de almacenamiento USB (unidad flash) o un DVD y se usa para arrancar un ordenador. La imagen es demasiado grande para caber en un CD.

2.1. Imagen para Raspberry Pi

The Raspbery Pi image is a complete SD card image and should be written to an SD card with the [Raspberry Pi Imager App](https://www.raspberrypi.com/software/). Note that the imager app can open the .zip file directly, no need to expand.

2.2. Imagen para AMD-64 (x86-64, PC) usando herramientas de GUI

Descarga e instala Balena Etcher desde https://etcher.balena.io/#download-etcher (Linux, Windows, Mac) y escribe la imagen descargada en una unidad USB.

Si tu imagen no arranca, por favor intenta también con Rufus. Se ve más complicado pero parece ser más compatible con varios BIOS.

2.3. Línea de comandos - Linux

  1. Conecte un dispositivo de almacenamiento USB (por ejemplo, una unidad flash o un dispositivo similar).

  2. Determine the device file corresponding to the USB flash drive. This information can be found in the output of sudo dmesg after connecting the device. cat /proc/partitions may also be helpful.

  3. Use el comando dd para escribir la imagen en su dispositivo de almacenamiento USB. Por ejemplo, si su dispositivo de almacenamiento aparece como /dev/sde, use este comando:

    dd if=linuxcnc_2.9.8-amd64.hybrid.iso of=/dev/sde bs=4k status=progress

2.4. Línea de comandos - MacOS

  1. Abra una ventana de terminal teclee

    diskutil list
  2. Inserte el USB y anote el nombre del nuevo disco que aparece, p. Ej. /dev/disk5.

  3. Desmonte el USB. El número encontrado arriba debe ser sustituido en lugar de la N.

    diskutil unmountDisk /dev/diskN
  4. Transfiera los datos con dd, como en Linux. Tenga en cuenta que el nombre del disco tiene una "r" agregada al principio.

    sudo dd if=linuxcnc_2.9.8-amd64.hybrid.iso of=/dev/rdiskN bs=1m status=progress
Grabar la imagen en un DVD en Linux
  1. Inserte un DVD en blanco en su grabadora. Aparecerá una ventana con CD/DVD Creator o Choose Disc Type. Cierre eso, ya que no lo usaremos.

  2. Busque la imagen descargada con el navegador de archivos.

  3. Haga clic con el botón derecho en el archivo de imagen ISO y elija Escribir en Disco.

  4. Seleccione la velocidad de escritura. Se recomienda que escriba a la menor velocidad posible.

  5. Comience el proceso de grabación.

  6. Si aparece una ventana para elegir un nombre de archivo para la imagen del disco, simplemente elija Aceptar.

Escribir la imagen en un DVD en Windows
  1. Descargue e instale Infra Recorder, un programa de grabación de imagen gratuito de codigo abierto: https://infrarecorder.org/ .

  2. Inserte un DVD en blanco en la unidad y seleccione No hacer nada o Cancelar si aparece el diálogo de ejecución automática.

  3. Abra Infra Recorder, y seleccione el menú Acciones, luego Grabar imagen.

Escribir la imagen en un DVD en Mac OSX
  1. Descargue el archivo .iso

  2. Haga clic derecho en el archivo en la ventana Finder y seleccione "Grabar en disco" (La opción de grabar en disco solo aparecerá si la máquina tiene un unidad óptica instalada o conectada)

3. Probando LinuxCNC

Con el dispositivo de almacenamiento USB conectado o el DVD en la unidad de DVD, apague el ordenador y vuelva a encenderlo. Esto arrancará el ordenador con la imagen Live/Install y elija la opción de arranque Live.

Nota
Si el sistema no se inicia desde el DVD o la memoria USB, podría ser necesario cambiar el orden de arranque en el BIOS de la PC.

Una vez que el ordenador se haya iniciado, puede probar LinuxCNC sin instalarlo. No puede crear configuraciones personalizadas o modificar la mayoría de ajustes del sistema en una sesión en vivo, pero puede (y debe) correr el test de latencia.

Para probar LinuxCNC: desde el menú Aplicaciones/CNC, seleccione LinuxCNC. Se abrirá un cuadro de diálogo desde el cual puede elegir una de entre muchas configuraciones de muestra. En este punto, solo tiene sentido elegir una configuración "sim". Algunas de las configuraciones de muestra incluyen en pantalla máquinas simuladas en 3D, busque "Vismach" para verlas.

Para ver si su ordenador es adecuado para la generación de pulsos de pasos por software ejecute la prueba de latencia como se muestra aquí.

Hasta el momento en que se escribió este documento, la imagen en vivo solo esta disponible con el kernel preempt-rt y su correspondiente LinuxCNC. En algún hardware podría no dar una latencia suficientemente buena. Una versión experimental esta disponible usando el kernel en tiempo real RTAI que suele dar una mejor latencia.

4. Installing LinuxCNC

Para instalar LinuxCNC desde el LiveCD, seleccione Instalación (Gráfica) al arrancar.

5. Actualizando LinuxCNC

Con la instalación normal, si tiene conexión a internet, el Administrador de actualizaciones le notificará de las actualizaciones de LinuxCNC y le permitirá actualizar fácilmente sin conocimientos de Linux. Está bien actualizar todo, excepto el sistema operativo, cuando se le pida.

Aviso
No actualices el sistema operativo a una nueva versión mayor (upgrade) si se solicita hacerlo. En cambio, debes aceptar las actualizaciones menores de versión (updates), especialmente las de seguridad.

6. Problemas de instalación

In rare cases you might have to reset the BIOS to default settings if during the Live CD install it cannot recognize the hard drive during the boot up.

7. Métodos alternos de instalación

La manera más fácil y preferida de instalar LinuxCNC es usar la imagen Live/Install tal como se ha descrito arriba. Ese método es tan simple y confiable como hemos podido, y es adecuado tanto para usuarios principiantes como para usuarios experimentados. Sin embargo, esto normalmente reemplazará cualquier sistema operativo existente. Si tienes archivos en la PC destino que quieras mantener, entonces usa uno de los métodos descritos en esta sección.

Además, para usuarios experimentados que estén familiarizados con la administración de sistemas Debian (encontrar imágenes de instalación, manipular fuentes apt, cambiar variantes del kernel, etc.), las nuevas instalaciones son compatibles con las siguientes plataformas: ("amd64" significa "64 bits", y no es específico de los procesadores AMD; funcionará en cualquier sistema x86 de 64 bits)

Debian Trixie amd64 y arm64 preempt-rt linuxcnc-uspace machine control & simulation

Debian Troxie

amd64

RTAI

linuxcnc

control de máquina

Distribution

Architecture

Kernel

Package name

Typical use

Debian Bookworm

amd64 y arm64

preempt-rt

linuxcnc-uspace

machine control & simulation

Debian Bookworm

amd64

RTAI

linuxcnc

control de máquina

Debian Bullseye

amd64

preempt-rt

linuxcnc-uspace

machine control & simulation

Cualquiera

Cualquiera

Stock

linuxcnc-uspace

SOLO simulación

Nota
LinuxCNC v2.9 no es compatible con Debian 9 o versiones anteriores.
Kernels preempt-RT

Los kernels Preempt-rt están disponibles para Debian desde el archivero regular de debian.org. El paquete se llama linux-image-rt-*. Simplemente instale el paquete de la misma manera que cualquier otro paquete desde al administrador de paquetes Synaptic o con apt-get en la línea de comandos.

Kernels RTAI

Los kernels RTAI están disponibles para su descarga desde el archivador debian en linuxcnc.org. Las fuentes de apt son:

  • Debian Trixie: deb http://linuxcnc.org trixie base

  • Debian Bookworm: deb http://linuxcnc.org bookworm base

  • Debian Bullseye: deb http://linuxcnc.org bullseye base

  • Debian Buster: deb http://linuxcnc.org buster base

LinuxCNC con el kernel RTAI ahora está disponible para sistemas operativos de 64 bits, pero hay unos pocos sistemas sobrevivientes que no pueden correr un sistema operativo de 64 bits.

7.1. Installing on Debian Trixie (with Preempt-RT kernel)

  1. Install Debian Trixie (Debian 13), amd64 version. You can download the installer here: https://www.debian.org/distrib/

  2. Después de quemar el iso y arrancar, si no quiere el escritorio Gnome, seleccione Opciones avanzadas > Entornos de escritorio alternativos y elija el que le guste. Luego seleccione Instalar o ' Instalación gráfica'.

    Aviso
    No ingrese una contraseña de root; si lo hace, sudo queda deshabilitado y no podrá completar los siguientes pasos.
  3. Ejecute lo siguiente en una terminal para actualizar la máquina con los paquetes más recientes.

    sudo apt-get update
    sudo apt-get dist-upgrade
    Nota
    It is possible to download a version of LinuxCNC directly from Debian (currently version 2.9.4) but a more up-to-date version (2.9.8) can be installed from the LinuxCNC repository.
  4. Instale el kernel y los módulos Preempt-RT

    sudo apt-get install linux-image-rt-amd64
  5. Reinicie y seleccione el kernel de Linux 6.1.0-10-rt-amd64. La versión exacta del kernel podría ser diferente, observe el sufijo "-rt". Esto podría estar oculto en el submenú "Opciones avanzadas para Debian Bookworm" en Grub. Cuando usted inicie sesión, verifique que el siguiente comando informe PREEMPT RT.

    uname -v
  6. Abra el menú de Aplicaciones > Sistema > Administrador de Paquetes Synaptic, busque linux-image y haga clic derecho en el original no rt y seleccione Marcar para eliminación completa. Reinicie. Esto es para forzar al sistema a arrancar desde el kernel RT. Si prefiere retener ambos kernels, no es necesario eliminar los otros, pero se necesitarán cambios de la configuración de arranque de Grub que van más allá del alcance de este documento.

  7. Agrega la llave de firma del archivero de LinuxCNC a tu llavero apt descargando [el script de instalación de LinuxCNC](https://www.linuxcnc.org/linuxcnc-install.sh). Necesitarás hacer al script ejecutable para correrlo:

    chmod +x linuxcnc-install.sh
    Entonces podrás ejecutar el instalador:
    sudo ./linuxcnc-install.sh

7.2. Installing on Debian Trixie (with experimental RTAI kernel)

  1. This kernel and LinuxCNC version can be installed on top of the Live DVD install, or alternatively on a fresh Install of Debian Trixie 64-bit as described above.

  2. Puedes agregar la llave de firma del archivero de LinuxCNC e información del repositorio descargando y ejecutando el script de instalación como se describió arriba. Si se detecta un kernel RTAI se detendrá antes de instalar algún paquete.

  3. Actualice la lista de paquetes desde linuxcnc.org

    sudo apt-get update
  4. Remove the existing uspace version of LinuxCNC and install the new realtime kernel, RTAI and the RTAI-version of LinuxCNC.

    sudo apt-get purge linuxcnc-uspace
    sudo apt-get purge linuxcnc-doc*
    sudo apt-get install linuxcnc

Reinicia la máquina, asegurándote que el sistema arranque desde el nuevo kernel 5.4.258-rtai.

7.3. Instalación en Raspbian 12

No lo hagas. Las latencias son muy malas con el kernel predeterminado; y el kernel PREEMPT_RT (la RT es importante) de Debian no arranca en la Pi (a partir de 1/2024). Por favor refiérase a las imágenes .iso proporcionadas en línea con la página de descargas de LinuxCNC. Puedes crearlas por ti mismo siguiendo los scripts proporcionados en línea.