Meikian LivePublicación 1.0

10 de August de 2015

Índice general

1. Meikian Live 31.1. ¿Qué es una distribución “Live”? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2. Base tecnológica . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3. Recursos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.4. Requisitos de hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.5. Hardware probado con la distribución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2. Usando Meikian Live 72.1. Grabación a DVD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2. Copia a un dispositivo de almacenamiento USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.3. Uso de persistencia para los datos del usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.4. Usuarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3. Programas específicos incluidos en Meikian Live 113.1. Diseño 2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2. Diseño de circuitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.3. CNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.4. Control de impresoras 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.5. Herramientas para trabajar con objetos 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.6. Laminado de objetos 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.7. Modelado 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.8. Programación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.9. Programación de Arduino . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4. Construyendo una imagen de Meikian live 134.1. Acceso de superusuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.2. Utilidades necesarias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.3. Repositorio de Meikian Live en GitHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.4. Modificación del script de creación de Meikian Live . . . . . . . . . . . . . . . . . . . . . . . . . . 144.5. Aplicar parche a Live-Build 3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.6. Creación de la iso de Meikian Live . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

5. Contribuciones 175.1. Tipos de contribuciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175.2. ¡Comenzar! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185.3. Instrucciones para efectuar un “pull request” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

6. Versiones 216.1. 2015.04.25 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

I

6.2. 2014.11.07 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216.3. 2014.09.28 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226.4. 2014.07.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226.5. 2014.03.23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236.6. 2014.02.19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236.7. 2014.02.13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236.8. 2014.02.01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246.9. 2014.01.14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246.10. 2014.01.09 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

7. Licencias 257.1. Sistema de creación de la distribución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257.2. Distribución Meikian Live . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

8. Créditos 298.1. Desarrollador principal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298.2. Colaboradores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298.3. Beta testers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298.4. Proyectos que han hecho posible Meikian Live . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

II

Meikian Live, Publicación 1.0

Contenido:

Índice general 1

Meikian Live, Publicación 1.0

2 Índice general

CAPÍTULO 1

Meikian Live

Meikian Live nació originalmente como CW-Live dentro de la comunidad de usuarios del Proyecto Clone Wars.

La idea detrás del origen de Meikian Live es la de proporcionar un entorno de trabajo con las herramientas máshabituales para el trabajo con impresoras 3D (diseño de piezas e impresión), Arduino, circuitos electrónicos, CNC,RC, robótica, etc, así como recursos y documentación relacionada.

Los puntos principales que se han tenido en cuenta en su desarrollo son:

Que sea un sistema libre. Ha de permitir su libre uso, modificación y redistribución a cualquier persona intere-sada en su utilización.

Un bajo consumo de recursos. Es importante que los recursos necesarios para su funcionamiento sean bajos,ya que esto posibilitará su uso en una mayor cantidad de equipos y al mismo tiempo permite la reutilización yaprovechamiento de máquinas más antiguas.

1.1 ¿Qué es una distribución “Live”?

Una distribución Live es un conjunto formado por un sistema operativo, programas adicionales y configuraciones, queestá preparado para arrancar y ejecutarse desde un dispositivo extraible (CD/DVD-ROM, memoria o disco duro USB,etc.), permitiendo trabajar con él sin afectar al sistema operativo y a los programas o configuraciones del equipo en elque se ejecuta.

1.2 Base tecnológica

Para el desarrollo de la distribución se ha empleado Debian GNU/Linux como sistema operativo base. Es una de lasdistribuciones GNU/Linux más antiguas que existen en la actualidad y que goza de una salud excelente, tal y como lodemuestra el hecho de que se siga usando como base para muchas otras distribuciones, algunas de ellas muy populares,como es el caso de Ubuntu o LinuxMint.

El sistema utilizado para su desarrollo es DebianLive, un sistema propio de Debian para la creación de sistemas Livepersonalizados.

1.3 Recursos

La página web de Meikian.

3

Meikian Live, Publicación 1.0

El código y archivos necesarios para generar una imagen de la distribución partiendo de cero están disponiblesen el repositorio meikian-dev de GitHub.

La documentación completa del proyecto está incluida en la propia distribución y también se encuentra dispo-nible online a través de la dirección docs-es.meikian.eu.

Una lista de correo / grupo de usuarios alojado en Google Groups.

1.4 Requisitos de hardware

Los requisitos necesarios para hacer funcionar Meikian Live son relativamente modestos si se comparan con los re-cursos de hardware de los que dispone cualquier equipo actual. A su vez, el consumo total de recursos también estádeterminado por las tareas que se vayan a llevar a cabo, por lo que no es aconsejable utilizar la distribución con menosrecursos de los especificados para que sea posible trabajar con un mínimo de soltura en la mayoría de los programasincluidos:

Memoria: cantidad mínima recomendada de 512MB de memoria RAM

Nota: Si se dispone de espacio libre no particionado en el disco duro del equipo, o en el dispositivo desde el quese está arrancando, puede mejorarse el rendimiento creando particiones para memoria de intercambioo swap y/o para persistencia de datos. De esta manera se libera parte de la memoria RAM utilizada yse deja disponible para poder ser usada por el sistema operativo y los programas.

Procesador: procesador mínimo recomendado Intel Pentium4 o equivalente.

1.5 Hardware probado con la distribución

1.5.1 Equipos

Acer Aspire 7220: OK

Acer Aspire 5610Z: OK

Acer Aspire 7750G: OK

Apple MacBook 2007 A1181: El arranque desde dispositivos USB no funciona, pero arranca correctamentedesde la unidad de DVD. OK

Apple MacBook Air 11” 2011: OK

Apple MacBook Pro 5.1 15” late 2008: No detecta el arranque. KO

Apple MacBook Pro Retina 11.2 15” late 2013: Arranca con algunos problemas, aunque no detecta la tarjetaWiFi

Apple MacMini 2012: Arranca con algunos problemas, aunque no detecta la tarjeta WiFi

Asus A55VD: OK

Asus EeePC T101MT: OK

Asus X54H: —

Clevo D400E: OK

Dell Inspiron 1564-4730: La tarjeta WiFi es una Broadcom Corporation BCM4312 802.11b/g LP-PHY que usael módulo b43 (necesita firmware). OK

4 Capítulo 1. Meikian Live

Meikian Live, Publicación 1.0

Dell Inspiron n5050: OK

Dell Latitude D610: Interfaz WiFi es “eth*” no “wlan*”. OK

Dell Latitude E6400: OK

Dell XPS L521X: OK

HP 500B MT: OK

HP Compaq NX9030: Interfaz WiFi es “eth*” no “wlan*”. OK

Lenovo Ideapad u430 Touch: Sin soporte para la WiFi. OK

Lenovo n500: OK

Lenovo t430s: OK

Lenovo x200s: OK

PackardBell EasyNote A7738: Interfaz WiFi es “eth*” no “wlan*”. OK

PackardBell S1300: Probado arrancando desde la unidad de DVD. OK

Toshiba PORTEGE Z930-145: OK

Toshiba Satellite A300: OK

1.5.2 Tarjetas controladoras

Arduino Mega 2560 + RAMPS 1.4

Gen7 1.4.1

Gen7 1.5

Megatronics v2.0

Megatronics v3.0

Sanguinololu 1.3a

SAV MKI + SAV 3D LCD

1.5. Hardware probado con la distribución 5

Meikian Live, Publicación 1.0

6 Capítulo 1. Meikian Live

CAPÍTULO 2

Usando Meikian Live

La descarga de la distribución Meikian Live puede hacerse a través de los enlaces que figuran en el apartado dedescargas de la página www.meikian.eu.

Una vez descargado el archivo iso conteniendo la distribución, se necesita transferir su contenido a un medio físico.Los procedimientos para realizar dicha operación dependerán tanto del medio físico, como del sistema operativoutilizados.

2.1 Grabación a DVD

No plantea ningún problema en cuanto a la plataforma o el sistema operativo utilizados, puesto que cualquier programade grabación a CD/DVD que permita la grabación de imágenes iso servirá para realizar esta operación.

2.2 Copia a un dispositivo de almacenamiento USB

2.2.1 Utilizando GNU/Linux

Utilizando el comando dd:

El primer paso será conectar la unidad de almacenamiento que quiere emplearse para la copia de la distribución,debiendo tener ésta el tamaño suficiente como para poder albergar el archivo iso descargado. En caso dequerer crear una o más particiones adicionales para utilizar persistencia de los datos, el tamaño necesario habráde aumentarse en función del tamaño que se quiera para dichas particiones.

Una vez conectada la unidad de almacenamiento, desde una consola de comandos puede utilizarse el comandodmesg para ver las últimas líneas de mensajes del kernel y obtener así el identificador de dispositivo que elsistema le ha asignado.

Para realizar la copia del archivo iso pueden emplearse dos métodos diferentes:

• El primero, más correcto, será utilizando los comandos isoinfo y dd:

Por ejemplo, para obtener la información del archivo meikian-live_beta1.iso se ejecutará el si-guiente comando:

user@meikian-dev:~$ isoinfo -d -i meikian-live_beta1.iso

CD-ROM is in ISO 9660 formatSystem id:Volume id: Meikian_20140915

7

Meikian Live, Publicación 1.0

Volume set id:Publisher id: MEIKIANData preparer id: LIVE-BUILD 3.0.5-1; HTTP://PACKAGES.QA.DEBIAN.ORG/LIVE-BUILDApplication id: MEIKIAN LIVECDCopyright File id:Abstract File id:Bibliographic File id:Volume set size is: 1Volume set sequence number is: 1Logical block size is: 2048Volume size is: 749984El Torito VD version 1 found, boot catalog is in sector 76Joliet with UCS level 3 foundRock Ridge signatures version 1 foundEltorito validation header:

Hid 1Arch 0 (x86)ID ’’Key 55 AAEltorito defaultboot header:Bootid 88 (bootable)Boot media 0 (No Emulation Boot)Load segment 0Sys type 0Nsect 4Bootoff 19B32 105266

De la información que devuelve el comando se necesitan los valores de los campos Logical blocksize y Volume size.

Advertencia: El siguiente proceso elimina la tabla de particiones y toda la información contenida en eldispositivo que se indique, por eso es imprescindible asegurarse de que se trata del dispositivo correcto

El comando que debe ejecutarse es:

dd if="ruta al archivo descargado" bs="Logical block size" count="Volume size" of=/dev/"dispositivo de sistema del destino"

Usando los datos del ejemplo anterior para un pendrive al que se le ha asignado un identificador de dis-positivo sdb, se ejecutará el siguiente comando con permisos de superusuario, ya sea mediante el uso delcomando su o de sudo:

user@meikian-dev:~$ sudo dd if=meikian-live_beta1.iso bs=2048 count=749984 of=/dev/sdb

• El segundo, más rápido y que normalmente suele ser suficiente, usando únicamente el comando dd:

Advertencia: El siguiente proceso elimina la tabla de particiones y toda la información contenida en eldispositivo que se indique, por eso es imprescindible asegurarse de que se trata del dispositivo correcto

El comando que debe ejecutarse es:

dd if="ruta al archivo descargado" of=/dev/"dispositivo de sistema del destino"

Usando los datos del ejemplo anterior para un pendrive al que se le ha asignado un identificador de dis-positivo sdb, se ejecutará el siguiente comando con permisos de superusuario, ya sea mediante el uso delcomando su o de sudo:

8 Capítulo 2. Usando Meikian Live

Meikian Live, Publicación 1.0

user@meikian-dev:~$ sudo dd if=meikian-live_beta1.iso of=/dev/sdb

Una vez el comando devuelve el control a la consola, y si no se ha producido ningún error durante el proceso,la copia ya estará realizada. Para arrancar la distribución es necesario asegurarse de que el equipo permita elarranque desde dispositivos USB y que en la BIOS del equipo esté seleccionado correctamente el orden de lasecuencia de arranque.

Con la utilidad UNetbootin:

Al igual que en el apartado anterior, el primer paso será conectar la unidad de almacenamiento que sequiere emplear para copiar la distribución en élla. Es necesario que contenga una partición con sistema deficheros FAT32 con espacio suficiente para albergar el archivo iso descargado. Dicha partición tambiéndeberá estar montada. En caso de no ser así, habrá que crearla y montarla previamente.

Se necesita conocer el identificador de dispositivo asignado por el sistema a dicha partición para que sepueda seleccionar posteriormente en UNetbootin. Si la partición ya existía antes de conectar la unidad,puede conseguirse desde una consola de comandos utilizando el comando dmesg para ver las últimaslíneas de mensajes del kernel. Si en cambio se ha creado posteriormente, este dato ya lo sabremos.

A continuación se procederá a ejecutar la utilidad UNetbootin. Los pasos a seguir una vez se ha lanzadola aplicación son:

Seleccionar DiscoImagen, formato ISO e introducir la ubicación del archivo iso con la ima-gen de la distribución. Esto último puede hacerse a través del explorador de archivos de la propiaaplicación.

Seleccionar el tipo Unidad USB y como Unidad el identificador de dispositivo asignado a lapartición en donde se va a instalar. Esto último normalmente es posible hacerlo desde el propiobotón desplegable.

Pulsar el botón Aceptar y esperar a que termine el proceso.

La utilidad UNetbootin modifica la configuración del menú de arranque de la distribución haciendo queno funcione correctamente, por lo que para restaurarlo a su estado normal se necesita realizar la siguienteoperación:

Dentro del directorio raíz de la unidad de almacenamiento en donde se ha volcado la distribución,existe un directorio con nombre syslinux que contiene un archivo llamado syslinux.cfg.Es necesario borrar dicho archivo para, a continuación, proceder a renombrar el archivosyslinux.cfg.orig a syslinux.cfg.

A partir de este momento la distribución ya estará transferida a la unidad de almacenamiento. A la horade arrancarla es necesario asegurarse de que el equipo permita el arranque desde dispositivos USB y queen la “BIOS” del equipo esté seleccionado correctamente el orden de la secuencia de arranque.

2.2.2 Utilizando MAC OSX

En equipos con MAC OSX es posible emplear los mismos métodos que para GNU/Linux, variando únicamente elnombre del dispositivo en el que se va a volcar el contenido de la imagen.

Nota: Es importante comentar que trás haber realizado múltiples pruebas con diferentes equipos Apple,los pendrives generados con UNetbootin no siempre arrancan en dichos equipos, por lo que se recomiendautilizar el comando dd desde una consola de comandos para copiar la imagen de la distribución.

Para facilitar la utilización del comando dd puede emplearse la utilidad dd-gui , que permite utilizar un interfaz gráficopara realizar las operaciones.

2.2. Copia a un dispositivo de almacenamiento USB 9

Meikian Live, Publicación 1.0

2.2.3 Utilizando MS Windows

Al igual que en el caso de MAC OSX, para los equipos con MS Windows también es posible recurrir al empleo deUNetbootin. La única diferencia importante respecto a lo mencionado para GNU/Linux, será el nombre de la unidada la que vamos a transferir la imagen de la distribución.

Otra utilidad para realizar la operación, similar al comando dd de GNU/Linux pero usando un interfaz gráfico, eswin32diskimager.

2.3 Uso de persistencia para los datos del usuario

Para conservar la información, archivos, configuraciones, etc. o los cambios que se realicen entre reinicios de ladistribución Live, puede recurrirse al uso de particiones auxiliares en las que la información quede almacenada demanera permanente. Para ello Puede elegirse entre dos tipos diferentes de persistencia de la información:

De datos de sistema en la que se almacenan todos los cambios que se realicen en el sistema, incluidos los de eldirectorio del usuario.

De datos de usuario en la que se almacenan únicamente los cambios que se realicen en el directorio del usuario.

No son excluyentes, por lo que pueden crearse ambas o cualquiera de las dos por separado.

Para que se active la persistencia de datos es necesario crear una o ambas particiones adicionales en el espacio libredel dispositivo USB o en el disco duro y usar para éllas un sistema de ficheros de tipo ext3 o ext4 con las siguientesetiquetas de volumen:

live-rw para tener persistencia de datos de sistema.

home-rw para tener persistencia de datos de usuario.

Si se crean desde la propia distribución Live, será necesario reiniciar el sistema para que las nuevas particiones sereconozcan en el arranque y se genere la estructura de directorios y archivos necesaria para su funcionamiento.

2.4 Usuarios

Los usuarios definidos por defecto en la distribución son los siguientes:

root es el usuario administrador y se encuentra deshabilitado por defecto, por lo que para ejecutar acciones ocomandos con privilegios de superusuario habrá que recurrir al uso de los comandos su, sudo o gksudo.

user es el usuario de uso habitual con la distribución y su contraseña es live.

Nota: Cuando la distribución esté instalada en disco duro sera necesario introducir la contraseña del usuariopara la ejecución de ciertos comandos o acciones que necesitan privilegios de superusuario, no siendo así en elmodo Live.

10 Capítulo 2. Usando Meikian Live

CAPÍTULO 3

Programas específicos incluidos en Meikian Live

3.1 Diseño 2D

Inkscape 0.48

GcodeTools 1.7

Paths2OpenSCAD 0.9

3.2 Diseño de circuitos

Fritzing 0.9.2b

gEDA 1.6.2-4.3

KiCAD 2012-04.16.27

PCB Designer 20110918

3.3 CNC

FlatCAM 8.3

LinuxCNC 2.6.5

Universal Gcode Sender 1.0.7

3.4 Control de impresoras 3D

Cura 15.02

Printrun 2014.01.26

3.5 Herramientas para trabajar con objetos 3D

MeshLab 1.3.0

11

Meikian Live, Publicación 1.0

Tatlin 2012.11.16

3.6 Laminado de objetos 3D

Cura 15.02

Skeinforge 2012.03.15

Slic3r 1.1.7

3.7 Modelado 3D

Blender 2.63

FreeCAD 0.14

BOLTS for FreeCAD

OpenSCAD 2014.03

BOLTS for OpenSCAD

Wings 3D 1.4.1

3.8 Programación

Processing 2.2.1

Scratch 1.4

3.9 Programación de Arduino

Arduino IDE 1.0.5

S4A 1.6

12 Capítulo 3. Programas específicos incluidos en Meikian Live

CAPÍTULO 4

Construyendo una imagen de Meikian live

Meikian Live es desarrollada con Debian GNU/Linux 7.x Wheezy para arquitectura x86 utilizando para ello De-bianLive, el sistema de creación de sistemas live propio de dicha distribución. Es posible utilizar otras versiones oarquitecturas, o incluso usar distribuciones derivadas, pero en dichos casos ya no se puede garantizar que funcione elproceso detallado a continuación o que sea el mismo.

Para generar una imagen de Meikian Live partiendo de cero se necesitan previamente una serie de requisitos.

4.1 Acceso de superusuario

El script de creación necesita ejecutarse con permisos de susperusuario, ya sea mediante el uso del comando su ode sudo.

4.2 Utilidades necesarias

Se necesitan una serie de utilidades instaladas previamente, para lo que puede recurrirse al siguiente comando:

user@meikian-dev:~$ sudo apt-get install apt-utils debootstrap dosfstools debian-keyring fakeroot genisoimage genext2fs gnu-fdisk loadlin mtd-utils parted squashfs-tools syslinux uuid-runtime win32-loader xorriso

También es necesario que esté instalado el conjunto de utilidades de DebianLive en su rama 3.x que es la que seencuentra actualmente disponible en Debian GNU/Linux 7.x Wheezy. Para ello también puede utilizarse el comando:

user@meikian-dev:~$ sudo apt-get install live-build

4.3 Repositorio de Meikian Live en GitHub

Se necesita disponer de una copia del contenido del repositorio de Meikian Live en GitHub. Esto puede hacerse de dosmaneras diferentes, clonando el repositorio o descargándose el archivo zip con su contenido desde la propia páginade GitHub.

Para clonar el repositorio se necesita tener instalado git. En caso de que no esté disponible en elsistema, puede instalarse con el siguiente comando:

user@meikian-dev:~$ sudo apt-get install git

A continuación necesita crearse un directorio para almacenarlo y proceder a clonar el contenidodel repositorio en él, para lo que pueden utilizarse los siguientes comandos:

13

Meikian Live, Publicación 1.0

user@meikian-dev:~$ mkdir my_meikianuser@meikian-dev:~$ git clone https://github.com/ctemescw/meikian-dev.git my_meikian

Si en cambio se descarga el archivo comprimido con el contenido del repositorio, es necesario tenerinstalado un descompresor para archivos en formato zip como puede ser unzip. En caso de noestar disponible en el sistema, puede instalarse ejecutando el siguiente comando:

user@meikian-dev:~$ sudo apt-get install unzip

A continuación se descomprime el archivo zip descargado previamente y se renombra paratrabajar más fácilmente con él:

user@meikian-dev:~$ unzip develop.zipuser@meikian-dev:~$ mv meikian-dev-development my_meikian

4.4 Modificación del script de creación de Meikian Live

Es necesario modificar un par de parámetros dentro del script de creación de la distribución para especificar la rutaen la que se ha copiado el contenido del repositorio de Meikian Live.

Dentro del directorio utilizado para albergar el contenido del repositorio se encuentra el script make-live.sh,en el cual se modificarán las líneas 14 y 15 para especificar las rutas correspondientes.

El contenido original de dichas líneas es:

## default valuesHOME_DIR="/home/debian-live/"BUILD_DIR="${HOME_DIR}/meikian-live"

HOME_DIR representa la ruta al directorio padre del directorio con los contenidos del repositorio

BUILD_DIR representa la ruta completa al directorio con los contenidos del repositorio

Como ejemplo para el caso de un usuario user que tiene su directorio de usuario en /home/user y que creadentro de él un directorio my_meikian para los datos del repositorio de Meikian Live, los valores por los que han desustituirse los originales son:

## default valuesHOME_DIR="/home/user/"BUILD_DIR="${HOME_DIR}/my_meikian"

4.5 Aplicar parche a Live-Build 3.x

Dentro del repositorio de Meikian Live en GitHub existe un directorio patches y dentro de él un parche necesariopara la rama 3.x de Live-Build que permite que puedan crearse imágenes con más de dos kernels diferentes.

Si se utiliza el mismo caso de ejemplo que en apartados anteriores, los comandos a ejecutar para aplicar el parche sonlos siguientes:

user@meikian-dev:~$ cd my_meikian/patchesuser@meikian-dev:~/my_meikian$ sudo patch -p0 < live_build-3.x_binary_syslinux.patch

14 Capítulo 4. Construyendo una imagen de Meikian live

Meikian Live, Publicación 1.0

4.6 Creación de la iso de Meikian Live

El script de creación de la distribución permite generar varios tipos de imágenes con finalidades diferentes. Lostipos disponibles son:

iso imagen en formato ISO9660 estándar destinada a la grabación en DVD

iso-hybrid imagen iso híbrida que permite la grabación a DVD o la copia a una memoria USB

usb-hdd imagen para la copia a un disco duro USB

tar genera un archivo que contiene todo el sistema de ficheros de la distribución

Una vez se han cumplido todos los requisitos especificados en los apartados anteriores, puede procederse a crear unaimagen de Meikian Live.

Nota: Factores que deben tenerse en cuenta:

El proceso puede durar entre una y varias horas dependiendo de los recursos del equipo en el que serealice

Es necesario disponer de al menos 15GB de espacio libre en el disco duro

Es necesario que el equipo disponga de conexión a Internet durante el proceso

El comando para la creación de la imagen de la distribución es:

make-live.sh <"tipo de imagen a crear">

Si se utiliza el mismo caso de ejemplo que en apartados anteriores, los comandos necesarios para generar una imagende tipo híbrido de la distribución son los siguientes:

user@meikian-dev:~$ cd my_meikianuser@meikian-dev:~/my_meikian$ sudo ./make-live.sh iso-hybrid

4.6. Creación de la iso de Meikian Live 15

Meikian Live, Publicación 1.0

16 Capítulo 4. Construyendo una imagen de Meikian live

CAPÍTULO 5

Contribuciones

Las contribuciones son bienvenidas y muy apreciadas. Todo pequeño aporte ayuda y siempre tendrá el reconocimientocorrespondiente.

Se puede contribuir de muchas maneras:

5.1 Tipos de contribuciones

5.1.1 Comunicación de errores

Pueden comunicarse los errores encontrados creando nuevas entradas para ellos en el apartado issues del repositoriode GitHub.

Cuando se esté comunicando un error, es conveniente incluir:

El nombre del sistema operativo y su versión.

Cualquier detalle relacionado con su configuración local que pueda ser útil en la resolución del problema.

Pasos detallados para poder reproducir el error.

5.1.2 Corrección de errores

Dentro del listado de entradas que aparecen en el apartado issues del repositorio de GitHub, todas aquellas que apare-cen etiquetadas como bug están disponibles para cualquiera que quiera solucionarlas.

5.1.3 Implementación de funcionalidades

Dentro del listado de entradas que aparecen en el apartado issues del repositorio de GitHub, todas aquellas que apare-cen etiquetadas como feature están disponibles para cualquiera que quiera implementarlas.

5.1.4 Escritura de documentación

Meikian Live siempre puede beneficiarse de más documentación, ya sea como parte de la documentación oficial, comocomentarios dentro del código o incluso en la web, como entradas de blog, artículos y similares.

17

Meikian Live, Publicación 1.0

5.1.5 Envío de comentarios

La mejor manera de proporcionar retroalimentación al proyecto es añadiendo comentarios y nuevas entradas en elapartado issues del repositorio de GitHub.

Si se está proponiendo una funcionalidad, es conveniente tener en cuenta:

Incluir una explicación detallada de como funcionaría.

Mantener su campo de aplicación tan reducido como sea posible, para que sea más fácil de implementar.

Recordar que se trata de un proyecto mantenido por voluntarios y que toda contribución es bienvenida :)

5.2 ¡Comenzar!

¿Preparado para contribuir? a continuación se detalla cómo preparar Meikian Live para poder hacer desarrollo local-mente.

1. Hacer un fork del repositorio meikian-dev en GitHub.

2. Clonar el repositorio que se acaba de crear, localmente:

$ git clone git@github.com:"nombre de usuario"/meikian-dev.git

3. ToDo

4. Crear una rama para el desarrollo en el repositorio local:

$ git flow feature start "nombre de la corrección del error o de la funcionalidad"

A partir de este momento ya pueden hacerse los cambios localmente.

5. ToDo

6. Confirmar los cambios y sincronizar el repositorio local con GitHub:

$ git add .$ git commit -m "descripción detallada de los cambios."$ git flow feature publish

7. Hacer una solicitud de “pull request” a traves del interfaz web de GitHub.

5.3 Instrucciones para efectuar un “pull request”

Antes de solicitar un “pull request” debe comprobarse que cumple con las siguientes pautas:

meikian-dev utiliza git-flow para la gestión de sus ramas.

1. Implementar cambios en nuevas ramas de git siguiendo el modelo de git-flow:

Los cambios centrados en la rama develop serán aceptados más fácilmente.

Los cambios centrados en la rama de una release (en caso de que exista) tenderán a considerarse, especial-mente para pequeñas correcciones de errores que afecten a dicha versión. No se aceptarán en cambio nuevasfuncionalidades en la rama de una release.

Los cambios centrados en la rama master o en las de versiones anterior difícilmente serán aceptados. En ciertoscasos es posible que se tengan en cuenta parches para solucionar errores graves en versiones anteriores, pero espreferible que dichos cambios sigan el proceso normal de git-flow.

18 Capítulo 5. Contribuciones

Meikian Live, Publicación 1.0

En ningún caso se aceptarán nuevas funcionalidades centradas en la rama master o en las de versiones anteriores.

2. Limitar el alcance de los cambios a una sola corrección de errores o funcionalidad por rama.

3. Tratar la documentación como una parte esencial de cualquier cambio.

4. Actualizar el registro de cambios de manera apropiada.

5.3. Instrucciones para efectuar un “pull request” 19

Meikian Live, Publicación 1.0

20 Capítulo 5. Contribuciones

CAPÍTULO 6

Versiones

6.1 2015.04.25

Version 1.1

Actualización de los bookmarks de los navegadores Chromium e Iceweasel

Arreglada la configuración de los navegadores Chromium e Iceweasel

Actualización de FreeCAD a la versión 0.14.3702 del repositorio de backports de Debian

Actualización de Fritzing a la versión 0.9.2b version

Actualización de Cura a la versión 15.02

Actualización de S4A a la versión 1.6

Eliminado el firmware de S4A del paquete meikian-misc y creado un paquete independiente para él

Eliminado LibreCAD

Cambiada la localización de las imágenes de fondo del escritorio

Actualización de LinuxCNC a la versión 2.6.5

Añadido Abiword

Añadido Gnumeric

Añadido FlatCAM 8.3

Añadido Universal Gcode Sender 1.0.7

Reemplazado el gestor de escritorios remotos Vinagre con Remmina

Añadido Avrdude

6.2 2014.11.07

Primera versión ‘estable’

Actualización de Cura a la versión 14.09

Cambiado el navegador Firefox por Iceweasel

Actualizado el paquete meikian-arduino-extras con nuevas bibliotecas

Eliminado Repetier-host debido a problemas con la licencia

21

Meikian Live, Publicación 1.0

Añadidas FreeCAD Library, Printbot part library y Printbots library para usar con FreeCAD

Añadida la traducción al inglés de la documentación

Cambiadas las imágenes del menú de arranque y del fondo del escritorio

6.3 2014.09.28

Primera versión beta

Empaquetados los binarios de Arduino de arduino.cc por varios problemas en los paquetes de Debian testing

Cambio de la imagen de arranque de isolinux

Cambio de nombre del proyecto a Meikian Live

Añadido un segundo kernel con soporte para PAE y SMP como opción por defecto en el menú de arranque

Añadido un tercer kernel con extensiones de tiempo real para LinuxCNC

Añadida opción en el menú de arranque para equipos antiguos que utiliza el kernel de las versiones anterioresde la distro

Migrado el sistema de documentación a RST y readthedocs.org

Actualización de Fritzing a la versión 0.9.0b

Actualización de Slic3r a la versión 1.1.7 stable

Añadido LinuxCNC 2.6.3

Añadido MeshLab 1.3.0

Añadido Scratch 1.4

Añadido S4A 1.5

Añadidas reglas de UDEV del proyecto OpenOCD

Añadidos paquetes con bibliotecas y macros extra para FreeCAD

Agregado directorio para acceso fácil a configuraciones de utilidades de impresión 3D

Agregados varios enlaces al administrador de archivos

Sustituido oracle-java7-installer por openjdk-7-jre debido a problemas con la licencia

Eliminada la imagen de memtest86 debido a problemas con la licencia

Eliminadas las imágenes de Balder y gPXE

Eliminado Netfabb Basic por problemas con la licencia

6.4 2014.07.12

Séptima versión alpha

Migrado todo el sistema de generación de la distro a GitHub

Empaquetado todo el software necesario que no estaba disponible en paquetes .deb

Restructuración del menú de arranque para hacerlo multi-idioma

Cambio en scripts de arranque para permitir personalizaciones en función del idioma elegido

22 Capítulo 6. Versiones

Meikian Live, Publicación 1.0

Desactivación del instalador a disco duro

Eliminado directorio de ejemplos

Actualización de Printrun a la versión 2014.01.26

Actualización de Cura a la versión 14.7

Actualización de Netfabb Basic a la versión 5.1.1

Actualización de Slic3r a la versión 1.1.6

Actualización de FreeCAD a la versión 0.14.3692

Añadido Fritzing 0.8.7b

Inclusión de Graphviz para poder ver las dependencias de los objetos en FreeCAD

Backport de PySerial desde Debian testing. Incluido un parche para permitir conexiones serie a cualquier velo-cidad

Añadido soporte de Adobe Flash para el navegador chromium

Corrección en la instalación del firmware para las tarjetas wireless Intel IPW

6.5 2014.03.23

Sexta versión alpha.

Añadido directorio con el código de los firmwares “/usr/local/share/firmwares”

Añadido directorio con ejemplos y objetos de calibración “/usr/local/share/examples”

Añadida versión del firmware Marlin de F.Malpartida para el soporte del LCD en la SAV

Añadida librería v1.2.1 New LiquidCrystal v1.2.1 de F.Malpartida para su uso con el LCD de la SAV MKI

Actualización de OpenSCAD a la versión 2014.03

Añadida extensión Gcodetools v1.7 para InkScape

Actualización de Cura a la versión 14.03

6.6 2014.02.19

Quinta versión alpha

Añadido Netfabb Basic 5.1.0

Actualización de Slic3r a la versión 1.0.0RC3

Añadidos los siguientes paquetes: unetbootin, unetbootin-translations, vinagre, x11vnc

Creado directorio para poder acceder a archivos de configuración desde el escritorio

6.7 2014.02.13

Cuarta versión alpha.

Añadida una entrada en el menú de arranque para el Debian-installer

6.5. 2014.03.23 23

Meikian Live, Publicación 1.0

Actualización de RepetierHost a la versión 0.95F

Añadidos los siguentes paquetes: chromium, chromium-l10n, geda-xgsch2pcb, xchat

Desterrados los siguientes paquetes: htop, mc

Eliminados los siguientes paquetes: dia, firefox, gigolo, thunderbird

Corregido el soporte de las controladoras Sanguinololu y Rambo en el IDE de Arduino

6.8 2014.02.01

Tercera versión alpha.

6.9 2014.01.14

Segunda versión alpha.

6.10 2014.01.09

Primera versión alpha.

24 Capítulo 6. Versiones

CAPÍTULO 7

Licencias

Meikian Live es Software Libre. Está compuesta por 2 elementos principalmente, el sistema de creación de la dis-tribución y la propia distribución en si, contando cada uno de ellos con particularidades específicas en cuanto a suscorrespondientes licencias.

El código fuente de todos los programas incluidos en ambos casos, y que es necesario hacer accesible públicamentepara cumplir con los requisitos de las diferente licencias, se encuentra disponible a través de los siguientes medios:

Los repositorios de paquetes oficiales de Debian GNU/Linux

Las páginas oficiales de empresas o desarrolladores que publican dichos programas

El repositorio oficial en GitHub de Meikian Live

7.1 Sistema de creación de la distribución

El sistema de creación de la distribución está basado en DebianLive, un sistema propio de Debian GNU/Linux para lacreación de sistemas Live personalizados:

Copyright © 2006-2013 Debian Live Project

This program is free software: you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation, eitherversion 3 of the License, or (at your option) any later version.

Enlace a la GNU General Public License

7.1.1 Scripts propios y contenido personalizado

Los scripts y otros contenidos propios realizados específicamente para Meikian Live:

Copyright © 2014 The Meikian Project

This program is free software: you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation, eitherversion 3 of the License, or (at your option) any later version.

Enlace a la GNU General Public License

25

Meikian Live, Publicación 1.0

7.1.2 Otros ficheros o proyectos incluidos

Grub Legacy

Copyright © 1996 Erich Boleyn <erich@uruk.org>Copyright © 1999-2000 Free Software Foundation, Inc.

This program is free software; you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation; eitherversion 3 of the License, or (at your option) any later version.

Enlace a la GNU General Public License

Grub

Copyright © 1999-2009 Free Software Foundation, Inc.

This program is free software; you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation; eitherversion 3 of the License, or (at your option) any later version.

Enlace a la GNU General Public License

Memtest86+

Copyright © 2004,2005,2007,2009 by Samuel Demeulemeester <memtest@memtest.org>, based onmemtest86 by Chris Brady <cbrady@sgi.com>, and various contributors.

This program is free software; you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation; version2 dated June, 1991.

Enlace a la GNU General Public License v2

pci.ids

Maintained by Martin Mares <mj@ucw.cz> and other volunteers from the PCI ID Project athttp://pci-ids.ucw.cz/.

This file can be distributed under either the GNU General Public License (version 2 orhigher) or the 3-clause BSD License.

Enlace a la 3-clause BSD License

Enlace a la GNU General Public License v2

Syslinux

Copyright © 1994-2011 H. Peter Anvin <hpa@zytor.com>

This program is free software; you can redistribute it and/or modify it under the termsof the GNU General Public License as published by the Free Software Foundation; eitherversion 2 of the License, or (at your option) any later version.

Enlace a la GNU General Public License v2

7.2 Distribución Meikian Live

Todos los programas incluidos en la distribución hacen uso de licencias libres.

26 Capítulo 7. Licencias

Meikian Live, Publicación 1.0

7.2.1 Programas contenidos en los repositorios de Debian GNU/Linux

Todos los programas de la distribución que están incluidos en los repositorios oficiales de Debian GNU/Linux, guar-dan la información correspondiente a copyright y a las licencias a las que están sujetos dentro del directorio dedocumentación de cada paquete.

Desde la propia distribución puede consultarse dicha información accediendo al directorio/usr/share/doc/"nombre del paquete".

7.2.2 Programas empaquetados específicamente para la distribución

Todos los programas empaquetados específicamente para la distribución, guardan la información correspondiente acopyright y a las licencias a las que están sujetos dentro del directorio del propio programa o del de la documen-tación de cada paquete.

En la mayoría de los casos está disponible desde la propia distribución accediendo al directorio/usr/local/doc/"nombre del paquete".

7.2.3 Otros programas o proyectos incluidos

LinuxCNC

Most of LinuxCNC is covered by the GNU General Public License. Some portions arecovered by the GNU Lesser General Public License (mostly interface definitions).

Enlace a la GNU General Public License v2

Enlace a la GNU Lesser General Public License v2.1

7.2. Distribución Meikian Live 27

Meikian Live, Publicación 1.0

28 Capítulo 7. Licencias

CAPÍTULO 8

Créditos

8.1 Desarrollador principal

Carlos Temes https://github.com/ctemescw

8.2 Colaboradores

Andrés Diz https://github.com/pepdiz Aportando ideas y desarrollando el script de gestión de los bookmarkspara los navegadores

Francisco Molina https://github.com/furanshishouco Aportando ideas, modificaciones a Gcodetools, locali-zando el parche para Py-Serial y probando la distro

Javier Collado https://github.com/fuseprods Traduciendo documentación al idioma inglés

Luigi Pirelli https://github.com/luipir Aportando ideas y probando la distro

Luis Morales https://github.com/lacion Aportando ideas, configurando el sistema de documentación y mi-grando a él inicialmente la documentación existente

Pablo Gutiérrez https://github.com/Scraw Aportando ideas y revisando el primer borrador de la documenta-ción de la distro

Rafa Couto https://github.com/rafacouto Aportando ideas, reglas de UDEV y probando la distro

Xoán Sampaiño https://github.com/xoan Aportando ideas, diseño del logo, mostrando y utilizando la distroen los eventos en los que participa como ponente

8.3 Beta testers

WeSo https://github.com/WeSoRz

Xarpe Serpe https://github.com/XarpeSerpe

8.4 Proyectos que han hecho posible Meikian Live

GNU http://www.gnu.org

Linux http://www.linuxfoundation.org

29

Meikian Live, Publicación 1.0

Debian GNU/Linux https://www.debian.org

Open Source Hardware http://www.oshwa.org/definition/spanish

RepRap http://reprap.org/wiki/RepRap/es

Clone Wars http://www.reprap.org/wiki/Proyecto_Clone_Wars

BricoLabs http://bricolabs.cc

GPUL http://gpul.org

30 Capítulo 8. Créditos