El MakeCode de Microsoft para Adafruit es un editor de código basado en web para computación física. Tiene un editor de bloques, similar a Scratch o a Code.org, y también un editor de JavaScript para usuarios avanzados. ¡Pruébalo ahora en https://makecode.adafruit.com/ !

Algunas características claves de MakeCode son:

• editor basado en web: no hay que instalar nada
• multi platforma: trabaja en la mayoría de navegadores modernos desde un teléfono pequeño, a una pantalla táctil gigante
• compilado en el navegador: el compilador corre en tu navegador, es rápido y trabaja sin conexión
• bloques + JavaScript: arrastra y suelta bloques o escribe JavaScript, MakeCode te permite cambiar fácilmente entre los dos
• trabaja fuera de línea: una vez que has cargado el editor, se mantiene en el caché de tu navegador
• ejecución basada en evento: responda fácilmente a presionados de botón, gestos de batido y más

MakeCode por el momento trabaja con la Circuit Playground Express de Adafruit. Para otras tarjetas como las Metro M0 de Adafruit, usa https://maker.makecode.com.

Partes requeridas

El editor de bloques es la forma más sencilla de comenzar con MakeCode. Puedes arrastrar y soltar bloques de la lista de categorías. Cada vez que realizas un cambio a los bloques, el simulador se reinicia automáticamente y ejecuta tu código. ¡Puedes probar tu programa en el browser!

• prueba nuestro tutorial para comenzar que te ayuda a construir un programa de sirena
• prueba uno de nuestros proyectos para aprender sobre las características de la Circuit Playground
• nuestra forma preferida de aprender, es viendo la lista de videos de MakeCode Live con John Park, así como ver el show en vivo, los Martes a las 20:00 GMT en el canal de Adafruit
• puedes entrar a revisar la documentación

¿Quieres seleccionar o cambiar los colores? El bloque de show ring tiene una herramienta integrada para seleccionar el color. Selecciona el color de la paleta de colores, y luego click a uno de los diez NeoPixeles del anillo, para modificar su color.

¿Como deshabilito un Neopixel? El punto gris en el medio de la paleta de colores, indica que el pixel está apagado. Selecciona el gris de la paleta de colores y realiza un click sobre un Neopixel del anillo. 

Puedes ver el programa Blinky hecho en bloques, trabajando en el editor MakeCode abajo. Puedes ver como los bloques encajan juntos. Si realizas un click sobre los signos de pregunta encima de la caja, te va a aparecer un comentario que explica lo que hace el bloque.

En la siguiente sección, ¡vamos a cargar el código de Blinky hacia la Circuit Playground Express! 

Cuando la Circuit Playground Express está en modo de gestor de arranque, todos los LEDs se van a prender en rojo brevemente y luego verde. Verifica que tu LED rojo de estado también está parpadeando. Tu computadora ahora debería estar viendo la unidad externa de disco llamada "CPLAYBOOT".

Si todos los LEDs están rojos: Es posible que tu computadora todavía esté instalando controladores (Favor esperar un minutor, Windows toma algo de tiempo para instalar actualizaciones), o tienes una mala conexión USB. Si todavía tienes LEDs rojos, trata con un cable USB nuevo (y asegurarte que no sea un cable para solo cargar, necesita poder transferir datos) o en un puerto USB diferente.

Una vez que todos los LEDs estén en verde, vas a poder ver a la unidad de disco CPLAYBOOT aparecer en la lista de unidades de tu navegador de archivos.

¡Ya estamos listos para compilar nuestro código de blinkly, y subirlo a nuestra tarjeta!

Primero vamos a verificar que nuestro código compila apropiadamente en MakeCode.

MakeCode tiene un simulador integrado que re-cargue y re-ejecuta el código cuando se reinicia. Esta es una forma sencilla de asegurarte que tu código compile y para simularlo antes de pasarlo a la tarjeta. El botón de "refresh" re-carga el simulador con la última versión de nuestro código.

Si tu tarjeta funciona bien en el simulador, ¡es hora de descargarlo a tu tarjeta real! Presiona el botón de "Download". Va a generar un archivo de tipo .uf2 y a descargarlo a tu computadora. (UF2 es un formato de archivo diseñado para programar microcontroladoras por USB).

Pasos para copiar tu programa (no específicos para sistemas operativos)

1. Asegúrate que tu tarjeta esté en modo de gestor de arranque.
2. Encuentra el archivo .uf2 que fue generado por MakeCode con tu navegador de archivos. Cópialo hacia la unidad de disco "CPLAYBOOT"
3. El LED de estado de la tarjeta va a parpadear mientras transfiere el archivo. Una vez que termine de transferir tu archivo, la tarjeta se va a reiniciar y comenzar a ejecutar tu código (¡Al igual que en el simulador!)

En Windows: Abra el Windows Explorer (tecla Windows + tecla E) y busque el archivo "blinky.uf2" que generaste. ¡Probablemente está en tu carpeta de Descargas!

Puedes copiar y pegar el archivo hacia tu unidad de disco CPLAYBOOT o lo puedes arrastrar y soltar como en el GIF a continuación.

En macOS: Abres el Finder y buscas el archivo "blinky.uf2". Puedes copiar y pegar el archivo hacia la unidad de disco CPLAYBOOT o arrastrar y soltarlo en la misma ventana del Finder.

Si deseas omitir el proceso de copia: Puedes cargar los programas directamente a tu tarjeta. Para realizar esto, cambia la ubicación donde se descarga el archivo en Chrome, Firefox, Safari, u Opera para que caigan en la raíz de la unidad de disco "CPLAYBOOT".

Corriendo el MakeCode que ya está Cargado

Si desconectas tu tarjeta y luego la reconectas a tu computadora, puede que no ejecute automáticamente el programa de nuevo. Si a su vez lo que muestra son todos los NeoPixeles en verde, solo presiona el botón de reset y tu programa va a comenzar a correr.

¿Quieres cambiar el programa de Blinky para que pueda mostrar diferentes colores o para que haga sonidos? ¡Editar el programa en tu Circuit Playground es muy sencillo!

Sacando tu código de la Circuit Playground

El archivo .u2 (CURRENT.UF2) que has creado al hacer click al botón de "Compile", ¡también contiene el código fuente de tu programa!

Puedes abrir este archivo en MakeCode al arrastrarlo y soltarlo en la ventana del navegador para editarlo.

También puedes cambiar entre bloques y JavaScript, haciendo click en el botón de la parte superior.

Programado de Un-Click

¿Ya te cansaste de arrastrar y soltar tus archivos UF2 una y otra vez? ¡Pues el programado por WebUSB es para ti! Con WebUSB, puedes subir el código directamente a tu tarjeta sin necesidad de salvar el archivo UF2 y luego tener que soltarlo hacia tu volumen de disco. Solo mantén el cable USB conectado a tu computador y ¡puedes subir el código cuantas veces necesites!

¡Requerimientos!

Vas a necesitar hacer un par de cosas antes de poder usar WebUSB

• Necesitas descargar la última versión del navegador Google Chrome. Firefox, Safari, Opera, Edge, etc todavía no tienen capacidades de WebUSB. Solo Chrome, ¡En versiones 68 o posteriores!
• Corra Windows 10, o las últimas versiones de Mac OS X de Linux. ¡Windows 7 u 8 no van a funcionar!

Actualice el Gestor de Arranque

También vas a necesitar la última versión del firmware para tu Circuit Playground Express (esto solo lo debes hacer una vez). Nosotros empacamos las Circuit Playground Express con la última versión del gestor de arranque, desde Julio del 2018, pero en caso que tengas una anterior a esta fecha, ¡no le hace malo!

Actualizando el gestor de arranque es tan sencillo como lo es subir aplicaciones en MakeCode. Simplemente entras al modo de gestor de arranque presionando el botón de Reset una vez (o dos) para que te muestre un anillo de NeoPixeles. Una unidad de disco llamada CPLAYBOOT va a ser mostrada en el navegador de archivos de tu sistema operativo. Arrastra el archivo de actualización de gestor de arranque en formato UF2 que has descargado al hacer click en el botón verde, hacia la unidad de disco CPLAYBOOT. Este uf2 contiene un programa que va a permitirte abrir la sección de gestor de arranque, actualizarlo y cerrarla de nuevo. Esto le va a caer encima a cualquier código de CircuitPython o Arduino, así que ¡asegúrate de tener todo respaldado!

URL Especial para MakeCode

Una vez que ya la tienes arriba y corriendo, vas a necesitar ir a un enlace especial de MakeCode el cual tiene WebUSB activado. Utiliza el botón verde que sigue a continuación o realiza una copia y pegado del URL completo hacia tu navegador: https://makecode.adafruit.com/?webusb=1#editor

Proyectos y Extensiones

Tus proyectos existentes van a quedar en el sitio de MakeCode por lo que no necesitas copiar nada. Sin embargo, si tienes extensiones instaladas, vas a tener que reinstalarlas. Esto se hace con un click en el menú de extensiones y seleccionando la extensión.

Esto es necesario para poder acceder a la funcionalidad de WebUSB desde tu Google Chrome. Solo necesitas realizar esto una vez, ¡la primera vez!. Luego de copiar este archivo UF2, ¡ojalá sea la última vez que necesitas arrastrar y solar uno hacia tu dispositivo!