Extensión para Escornabot en mBlock5

Introducción

Cuando salió la versión de mBlock 5  ( entorno gráfico de programación basado en el editor Scratch 3.0 creado por la empresa Makeblock) dejé “aparcada” la actualización de la extensión que hice para mBlock 3 debido a que esta nueva versión inicialmente no tenía soporte para la placa Arduino Nano  (placa en la que se base nuestro querido Escornabot). Aunque  desde  Makeblock me informaron que en su plan de ruta estaba previsto incorporar dicha placa, no estaba claro cuándo sería. 

Pasó el tiempo y Makeblock incorporó soporte a la placa Arduino Nano pero la alegría me duró poco al descubrir que hacía referencia a la nueva placa Arduino Nano Every que sacó Arduino y no a las placas Arduino Nano “antiguas” que usan los Escornabots. La verdad es que ya no pensaba que darían soporte a éstas últimas pero al bajarme la última versión de la aplicación…¡premio!… había un dispositivo llamado “Arduino Nano (old)”. Por tanto había llegado la hora de actualizar la extensión que hice para que funcionara con esta nueva versión. 

Este manual refleja los pasos necesarios para la instalación y uso de la extensión creada específicamente para el robot Escornabot para poder utilizarla con la versión mBlock 5.

Instalación de la extensión

El problema que tenemos a la hora de crear la extensión es que debemos incorporar a ésta el fichero de configuración “Configuration.h” del robot que en cada usuario puede ser diferente. Esto implica que el usuario debe añadirlo antes de utilizarla en la aplicación. 

Por otro lado, actualmente solo es posible utilizar esta extensión para la aplicación mBlock 5 en su versión “mBlock PC version”.

Por tanto a la extensión que he creado necesitamos añadirle el fichero de configuración “Configuration.h” de nuestro Escornabot. Una vez añadido el fichero volveremos a generar la extensión y ya podremos instalarla y utilizarla en la aplicación mBlock5.

Para realizar este proceso realizaremos los siguientes pasos:

Paso 1. Descargar la extensión “escornabot_mblock5.mext” del siguiente enlace:

https://github.com/avilmaru/escornabot-extension-mblock5

Paso 2. Acceder a la plataforma Web de Makeblock mBlock 5 Extension Builder:

https://ext.mblock.cc/   

NOTA: Crear una cuenta es gratuito y no se paga nada.

Paso 3. Una vez logueados importaremos la extensión que previamente  hemos descargado para modificarla. Para ello seleccionaremos la opción “My Plugin →  My Extension” del menú izquierdo y posteriormente pulsaremos el botón “Import data” y seleccionamos la extensión descargada “escornabot_mblock5.mext”:

Paso 4. Una vez importada cerramos la ventana emergente. 

NOTA: Verificar que se ha importado correctamente.

Paso 5. Si la importación se ha realizado correctamente nos tiene que aparecer la extensión  “Escornabot mBlock 5” cargada en nuestra cuenta.  Ahora pulsaremos la opción “Edit” para modificarla:

Paso 6: Vamos a añadir el fichero de configuración “Configuration.h” de nuestro Escornabot a la extensión. Para ello iremos a la opción “Add source file” y pulsaremos el icono “+” para añadir el fichero.

IMPORTANTE: El fichero de configuración “Configuration.h” debe estar dentro de un directorio llamado “src”  (importante no cambiar este nombre) y será este directorio lo que seleccionaremos y no el fichero (solo se permite seleccionar directorios).

Paso 7. Una vez importado el directorio con el fichero de configuración pulsaremos el botón “Save” para guardar los cambios.

NOTA: Verificar que se ha importado correctamente el fichero con el siguiente nombre:  “src/Configuration.h”

Como podréis apreciar en esta sección existen 3 ficheros más que no teneis que quitar puesto que son las librerías en las que se basa la extensión.

Paso 8. En este punto ya hemos realizado la única acción que teníamos que hacer en nuestra extensión y podemos generarla nuevamente para posteriormente descargarla. Para ello pulsaremos el botón “Download”:

Paso 9. Una vez que se ha generado correctamente pulsaremos el botón “Download now” para descargarla.

NOTA: Se generará una extensión llamada escornabot_mblock5.mext” que ahora ya contiene nuestro fichero de configuración.

Paso 10. Ahora que ya tenemos la extensión la instalaremos en la aplicación. Para ello abriremos el programa mBlock 5 y arrastraremos y soltaremos la extensión escornabot_mblock5.mext” dentro de la aplicación:

Paso 11. Verificar que se ha importado correctamente:

Paso 12. Una vez importada la extensión debemos cerrar y volver a abrir la aplicación.

Paso 13.  Una vez abierta nuevamente la aplicación vamos a cargar la extensión para poder utilizarla. Para ello en la pestaña “Dispositivos” pulsaremos en el icono de “(+) Añadir”.

IMPORTANTE: Esta extensión sólo está disponible para los dispositivos “Arduino Nano” y “Arduino Nano (old)”. Se debe seleccionar la placa Arduino Nano (old) que hace referencia a las placas Arduino Nano que montan todos los Escornabots. Solo debéis seleccionar la placa Arduino Nano (sin el old) si estuvierais utilizando la nueva placa Arduino Nano Every de Arduino.

Una vez seleccionada la placa pulsaremos el botón “Aceptar”:

Paso 14. Una vez seleccionado el dispositivo pulsaremos sobre el icono “(+) Extension” para buscar la extensión:

Paso 15. Pondremos en el buscador que aparece la palabra escornabot para encontrar rápidamente la extensión y una vez encontrada pulsaremos en “(+) Añadir y ya tendremos todos los bloques disponibles para poder utilizarlos en la aplicación: