Robótica con M5StickC, JoyC, RoverC y BugC

Control RoverC HAT con JoyC HAT

Vídeo completo del taller de 1 hora:

Veamos los pasos para programar el control de BugC HAT con JoyC HAT.

Antes de empezar con este tutorial, deberías leer los siguientes artículos:

• Dispositivos M5Stack: https://aprendiendoarduino.wordpress.com/2020/04/25/dispositivos-m5stack/
• Programación Dispositivos M5Stack con UIFlow: https://aprendiendoarduino.wordpress.com/2020/04/25/programacion-dispositivos-m5stack-con-uiflow/

Hardware necesario:

• 2x M5StickC https://docs.m5stack.com/#/en/core/m5stickc
• 1x RoverC HAT: https://docs.m5stack.com/#/en/hat/hat-roverc
• 1x JoyC HAT: https://docs.m5stack.com/#/en/hat/hat-joyc

Cada módulo M5StickC programable se conecta a los HATs del Rover y el JoyStick. Lo que vamos a programar con los M5StickC.

RoverC es una base de robot móvil omnidireccional programable compatible con M5stickC, y puede iniciarse insertando el M5stickC. El controlador principal de la base es el microcontrolador stm32f030f4. La base viene con motores de engranaje helicoidal N20 que son accionados directamente por un controlador de motor de cuatro canales. Estos motores están conectados a ruedas mecanum que pueden moverse en todas las direcciones. Además, se proporcionan dos puertos I2C compatibles con grove para facilitar la expansión de otros módulos. La base también es compatible con los bloques de LEGO y puede expandirse en su estructura. Se instala una batería 16340 en la parte posterior de la base para cumplir con los requisitos de potencia y resistencia del automóvil y se puede controlar mediante un interruptor independiente.

I2C Address 0x38

Para moverlo:

Antes de usar, asegúrese de que el RoverC está completamente cargado. Método de carga: inserte m5stickc en el roverc y conecte el cable USB para cargar.

JoyC es un módulo basculante diseñado para el M5StickC. Admite la operación con las dos manos. Chip de control principal STM32F030F4 integrado, que utiliza el protocolo de comunicación I2C y el host M5StickC para la transmisión de datos. El rango del joystick es 0 ~ 200, hay 12 LED RGB debajo de los joysticks izquierdo y derecho, y la parte inferior del joystick está equipada con una base de batería 16340 para una vida útil continua de la batería.

I2C Address 0x38

Como vamos a programar con UIFLow, lo primero es cargar el firmware de UIFlow con el M5Burner, que puede descargarse en: https://m5stack.com/pages/download. Cargar en ambos M5StickC.

Ejemplo básico control RoverC:

Código: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/Basic_RoverC.m5f

Vídeo:

Ejemplo básico control JoyC:

Código: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/Basic_JoyC.m5f

Código con todos los datos del JoyC: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/M5StickC_JoyStick_Control.m5f

Vídeo:

Para comunicar ambos módulos voy a usar el protocolo ESP-NOW: https://docs.m5stack.com/#/en/uiflow/advanced?id=esp-now

ESP-NOW es un protocolo de comunicación de corto alcance y baja potencia que permite que múltiples dispositivos se comuniquen sin Wi-Fi. Este protocolo es similar a la conexión inalámbrica de 2,4 GHz de baja potencia que se encuentra en los ratones inalámbricos: los dispositivos se emparejan antes de comunicarse. Después del emparejamiento, las conexiones entre dispositivos son continuas, de igual a igual, y no requieren un protocolo de protocolo de enlace.

Para emparejar ambos dispositivos necesito saber su dirección.

Ejemplo básico receptor:

Ejemplo básico emisor:

En un M5Stack lo uso de receptor de ESP-NOW para ver lo que llega: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/M5/M5Stack_Receptor.m5f

Código:

• Emisor: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/ESP-NOW_Basic_Emisor.m5f
• Receptor: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/ESP-NOW_Basic_Receptor.m5f

Vídeo:

Los códigos finales con comunicación ESP-NOW:

• JoyStick: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/C%C3%B3digo%20Final/M5StickC_JoyStick_ESPNOW.m5f
• Rover: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/C%C3%B3digo%20Final/M5StickC_Rover_ESPNOW.m5f
• M5Stack: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20RoverC%20y%20JoyC/C%C3%B3digo%20Final/M5Stack_Receptor.m5f

Comentarios del código:

• La conexión es uno a uno y cifrada con contraseña
• Uso un M5Stack que recibe los datos y los muestra por pantalla
• Los datos que mando son: Velocidad, Dirección y Ángulo, añadiendo el caracter V, D o A delante del valor.
• Solo mando el valor si cambia más de 5 unidades sobre el valor anteriormente enviado. Ahorrando el envío de datos y mejorando la experiencia con el Joystick
• Si el valor del Joystick es menor de 30 lo dejo en 0, porque sino los motores apenas se mueven y hace ruido.
• Uso en cada receptor un contador para saber cuantos mensajes llegan
• El M5Stick del rover lee el dato recibido, analiza si es Velocidad, Dirección y Ángulo y aplica el valor a los motores del rover.

Vídeo:

Control BugC HAT

Vamos a hacer andar el BugC.

Material:

• 1x M5StickC https://docs.m5stack.com/#/en/core/m5stickc
• 1x BugC Hat: https://docs.m5stack.com/#/en/hat/hat-bugc

BugC es una base de robot programable compatible con el M5StickC. Esto tiene cuatro motores de CC, controlador de motor, dos LED RGB, soporte de batería y un interruptor. La base Bugc debe usarse junto con el controlador M5StickC. La base viene con un microcontrolador STM32F030F4 que controla todos los motores y LED y esto es controlado a través del protocolo I2C (0x38) por el M5StickC que se encuentra en la parte superior de la base.

Ejemplo básico de uso:

Código: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20BugC/Basic_BugC.m5f

Vídeo:

Una vez hecho el ejemplo básico, para aprender cómo se mueve hacemos tres movimientos que cambian al pulsar el botón A.

Código: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20BugC/M5StickC_BugC_Demo.m5f

Vídeo:

Por último vamos a hacerlo andar, moviendo de un lado a otro.

Código: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/Proyecto%20BugC/M5StickC_BugC_Anda.m5f

Vídeo:

Programación Dispositivos M5Stack con UIFLOW

UIFlow es una plataforma Web de programación usando Blockly y Python

Web: http://flow.m5stack.com/

UIFlow: https://m5stack.com/pages/uiflow

Foro UIFlow: http://forum.m5stack.com/category/5/uiflow

UIFlow Doc: https://m5stack.github.io/UIFlow_doc/en/

Tutorial: https://docs.m5stack.com/#/en/uiflow/uiflow_home_page

Manual de UIFlow: http://flow.m5stack.com/download/M5GO_User_Manual_en.pdf

Vídeos:

• Introducción a UIFlow
• Configuración Wifi
• Actualizar Firmware
• IDE Offline

Quick Start UIFlow:

• https://docs.m5stack.com/#/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow
• https://docs.makerfactory.io/m5stack/core/quickstart/uiflow/

UIFlow-Desktop-IDE: https://m5stack.com/pages/download (UIFlow en local sin acceso a Internet)

Cargar Firmware UIFlow

Lo primero es cargar el firmware de UIFlow en M5Stack para poder programarlo con UIFlow, para ello debemos usar el programa M5Burner: https://docs.m5stack.com/#/en/quick_start/m5stickc/m5stickc_quick_start_with_uiflow que se puede descargar desde https://m5stack.com/pages/download

En caso que no nos reconozca el puerto serie M5Burner, habrá que instalar el driver como hemos hablado anteriormente desde: https://m5stack.com/pages/download 

El Driver Oficial para la interfaz serie CP210X se puede descargar en: https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers

A la hora de cargar el firmware, seleccionar la versión de UIFlow que se va a usar en http://flow.m5stack.com/ y en caso que no aparezca resaltada, descargarla.

Luego seleccionar el puerto serie y el modelo de M5Stack que vamos a usar y por último configurar la wifi a la que se va a conectar para programar on-line.

Y pulsar el botón burn, si da fallo probar a reducir el baudrate por defecto o borrar la flash con el botón erase.

En caso que no se haya configurado la wifi o no esté disponible la wifi, el M5Stack se configura como un AP Hotspot donde abre una red wifi a la que me puedo conectar y entrar a la web para configurar la wifi.

Modo Programación en Red

El modo de programación de red es un modo de acoplamiento entre el dispositivo M5Stack y la plataforma de programación web UIFlow. La pantalla mostrará el estado actual de la conexión de red del dispositivo. Cuando el indicador está en verde, significa que puede recibir un programa push en cualquier momento. Después de la primera configuración exitosa de la red WiFi, el dispositivo se reiniciará automáticamente e ingresará al modo de programación de red. 

Una vez que el M5Stack tiene cargado el firmware y se inicia, se conectará a la wifi configurada y nos mostrará en pantalla el API KEY:

Una vez conectado y con el icono en verde, ya puedo entrar en http://flow.m5stack.com/ y emparejar el dispositivo M5 para programarlo. Para ello debo indicar el APIKEY y el dispositivo.

Una vez hecho esto ya se puede comenzar a programar con UIFlow. Lo siguiente le mostrará un programa simple para manejar M5StickC.

Para encender el indicador LED:

• Arrastre el LED para iluminar el bloque de programa.
• Empalme con el programa de inicialización de configuración.
• Haga clic en el botón Ejecutar en la esquina superior derecha

Modo Programación USB

UIFlow Desktop IDE es una versión offline del programador UIFlow que no requiere conexión de red y puede ser una alternativa en caso de no tener acceso a Internet o una conexión lenta . Haga clic en la versión correspondiente de UIFlow-Desktop-IDE para descargar de acuerdo con su sistema operativo en https://m5stack.com/pages/download

Una vez instalado, detectará automáticamente si su ordenador tiene un controlador USB (CP210X), haga clic en Instalar y siga las instrucciones para finalizar la instalación. M5StickC no requiere un controlador CP210X, por lo que los usuarios pueden elegir instalar u omitir.

Cuando se inicie la aplicación, ya podemos conectar nuestro dispositivo M5

Para poder programar como USB, debemos entrar en modo USB, para ello: Haga clic en el botón de encendido en el lado izquierdo del dispositivo para reiniciar. Seleccione rápidamente Configuración después de ingresar al menú, ingrese a la página de configuración y seleccione el modo USB.

Y por último seleccionar el puerto serie y el dispositivo en el programa para empezar a usarlo.

Más información:

• https://jejo.es/posts/esp32/m5stack/m5stickc_primeros_pasos/
• https://jejo.es/posts/esp32/m5stack/m5stickc_primeros_pasos2/

Entorno de Programación

Independientemente si usamos la versión online o la versión offline, la programación es igual.

El entorno de programación se compone de 5 partes principales:

• Coding Area:  Arrastre los bloques de código de la lista de bloques al área de codificación y conéctelos para crear un programa
• Barra de menús: La barra de menú contiene la mayoría de las funciones importantes de la interfaz, como (Ejemplo,Deshacer y rehacer, cargar, ejecutar código, descargar código, guardar código, etc.
• Blockly/Python: Todo el código que creamos en bloques se puede convertir a Python presionando este interruptor
• Diseñador de UI: Arrastre los elementos de la interfaz de usuario (título, etiqueta, etc.) hacia la pantalla de para diseñar un avatar o interfaz de interfaz de usuario.
• Unidades: Las unidades son sensores y actuadores que se pueden conectar y aquí es donde los configuramos.

Funciones de los botones:

Programación con Blockly:

Programación Básica

Para la programación vamos a usar estas tres documentaciones oficiales:

• Tutorial: https://docs.m5stack.com/#/en/uiflow/uiflow_home_page
• Manual de operación educación: http://m5edu.com/m5doc/
• Uso de UIFlow: https://m5stack.github.io/UIFlow_doc/en/

Setup: Cuando abra UIFlow, encontrará que ya hay un bloque de Configuración al principio. Cada programa debe tener un bloque de configuración. El programa se ejecuta desde el bloque de Configuración y solo se ejecutará una vez. Puedes considerarlo como un bloque de inicialización del programa

Loop: Loop es un bloque de bucle infinito. Cuando se ejecuta, ejecutará el programa contenido en el bloque indefinidamente hasta que ocurra algún evento que lo detenga, por ejemplo un reset o apagado. No tiene que existir en el programa, pero para que el programa ejecute funciones cíclicas debe usarse.

Los ficheros generados tienen la extensión .m5f, aquí puedes descargar un ejemplo de test: https://raw.githubusercontent.com/jecrespo/M5StickC-UIFlow/master/M5/Test.m5f

Primero hagamos un “Hola Mundo” con M5Stack. Que muestre por pantalla Hola mundo y haga blink el led.

Puedes descargar el código en: https://raw.githubusercontent.com/jecrespo/M5StickC-UIFlow/master/M5/Hola%20Mundo.m5f

Otros ejemplos:

• RGB: http://m5edu.com/documentation/1-rgb-lcd-light/
• Speaker: http://m5edu.com/documentation/3-speaker/
• Servo: http://m5edu.com/documentation/mirco-servo/

¿Cuál es la diferencia entre ejecutar y descargar un programa? El botón de reproducción coloca nuestro código en la memoria volátil de su M5stack. Lo que significa que se perderá una vez que apague el M5stack. Sin embargo, la función de descarga almacenará su programa en la memoria flash de su dispositivo que no se borrará al reiniciar. Cada vez que enciende el M5stack después de descargar un programa, ese programa se ejecutará automáticamente, y también puede seleccionarlo de la lista de aplicaciones a la que se accede presionando el botón central al iniciar.

Ejecutar un programa: Una vez que haya terminado de programar, presione el botón de reproducción en la esquina superior derecha para ejecutar su código.

Descargar un programa: almacenará su programa en la memoria flash de su dispositivo que no se borrará al reiniciar.

La aplicación grabada se podrá seleccionar desde el menú de aplicaciones del dispositivo M5 y se ejecutará en el inicio cada vez que se resetee. Para volver al entorno de programación y cambiar el programa, si tengo una aplicacion en modo permanente, reiniciar y pulsar el botón mientras arranca para entrar en modo programación cloud o USB.

Unidades y HATs

La unidad o HAT es un módulo hardware de expansión de funciones proporcionado por el sistema M5. Estas deben conectarse al módulo M5 antes de programarlas.

Los módulos y faces de M5Stack ya aparecen automáticamente al seleccionar el HW Core.

Las unidades deben se añadidas en UIFlow para que aparezcan sus bloques de programación. Haga clic en la opción Units debajo del Simulador de UI, marque el módulo de Unidad que desea agregar y haga clic en Aceptar. Algunas unidades tienen configuraciones iniciales de parámetros.

Programación de Units: https://docs.m5stack.com/#/en/uiflow/Units

Programación de los módulos: https://docs.m5stack.com/#/en/uiflow/Modules

Programación de las faces: https://docs.m5stack.com/#/en/uiflow/FACES

Programación Hardware

Ver: https://docs.m5stack.com/#/en/uiflow/hardware

Boton: https://m5stack.github.io/UIFlow_doc/en/en/Start_programming/Button.html

Speaker:

• https://docs.m5stack.com/#/en/uiflow/hardware?id=speaker
• https://m5stack.github.io/UIFlow_doc/en/en/Hardwares/Speaker.html

IMU:

• https://docs.m5stack.com/#/en/uiflow/hardware?id=imu-internal-measurement-unit
• https://m5stack.github.io/UIFlow_doc/en/en/Hardwares/IMU.html

Power:

• M5Stack: https://docs.m5stack.com/#/en/uiflow/hardware?id=power-m5stack
• M5StickC: https://docs.m5stack.com/#/en/uiflow/hardware?id=power-m5stickc

Ejemplo power en M5StickC: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/M5/M5StickC_Power_Control.m5f

Display UI

Elementos del display: https://docs.m5stack.com/#/en/uiflow/ui_simulator?id=ui-elements

Display UI: https://m5stack.github.io/UIFlow_doc/en/en/Display/UI.html

Emoji: https://docs.m5stack.com/#/en/uiflow/ui_simulator?id=emoji

Pantalla: https://docs.m5stack.com/#/en/uiflow/ui_simulator?id=screen

Imágenes:

• https://docs.m5stack.com/#/en/uiflow/ui_simulator?id=displaying-images
• https://m5stack.github.io/UIFlow_doc/en/en/Display/image.html

Gráficos:

• https://docs.m5stack.com/#/en/uiflow/ui_simulator?id=graphic
• https://m5stack.github.io/UIFlow_doc/en/en/Display/Graphic.html

Ejemplo que muestra un logo: https://raw.githubusercontent.com/jecrespo/M5StickC-UIFlow/master/M5/Logo%20M5Stack.m5f

Lógica

If:

• https://docs.m5stack.com/#/en/uiflow/logic?id=if-condition
• https://m5stack.github.io/UIFlow_doc/en/en/Logic/if.html

Loop Condicional:

• https://docs.m5stack.com/#/en/uiflow/logic?id=conditional-loop
• https://m5stack.github.io/UIFlow_doc/en/en/Loops/repeatA.html

Iteración de datos:

• https://docs.m5stack.com/#/en/uiflow/logic?id=data-iteration
• https://m5stack.github.io/UIFlow_doc/en/en/Loops/repeatB.html

Variables

Variables:

• https://docs.m5stack.com/#/en/uiflow/data_structure?id=introducing-variables
• https://m5stack.github.io/UIFlow_doc/en/en/Operation/Variables.html

Operaciones básicas: https://docs.m5stack.com/#/en/uiflow/data_structure?id=basic-operation

Función map (diccionario en Python): https://docs.m5stack.com/#/en/uiflow/data_structure?id=introducing-a-map

Listas o arrays: https://m5stack.github.io/UIFlow_doc/en/en/Operation/List.html

JSON: https://docs.m5stack.com/#/en/uiflow/data_structure?id=introducing-json

Strings/Text: https://docs.m5stack.com/#/en/uiflow/data_structure?id=introducing-text

Funciones

Las funciones son una herramienta que nos ayuda a envolver nuestro código en un paquete ordenado al que podemos asignarle un nombre, y luego llamarlo en cualquier parte de nuestro programa y ejecutará el código que contiene. Las funciones pueden ayudar a mantener nuestro código ordenado y conciso y evitar repetir las mismas cosas una y otra vez.

Funciones:

• https://docs.m5stack.com/#/en/uiflow/logic?id=functions
• https://m5stack.github.io/UIFlow_doc/en/en/Functions/Functions.html

Control Remoto

Control remoto de los dispositivos M5 mediante una web:

• https://docs.m5stack.com/#/en/uiflow/advanced?id=remote-control
• https://m5stack.github.io/UIFlow_doc/en/en/Remote/Remote.html

Página de control: https://docs.m5stack.com/#/en/uiflow/advanced?id=control-page

Dashboard: https://docs.m5stack.com/#/en/uiflow/advanced?id=dashboard

Lo carga en http://flow-remote.m5stack.com/

Bloques Personalizados

Es posible crear bloques personalizados.

Para crear un nuevo bloque, debemos proporcionar:

• nombre del grupo: el nombre del grupo en el que se coloca el bloque personalizado
• color del bloque: color de apariencia del bloque
• Etiqueta de bloque: solo se permiten letras, números, guiones bajos
• Tipo de bloque: defina el tipo de bloque como Valor (valor) o Ejecutar (ejecutar)
• Número de bloques: posibilidad de agregar múltiples bloques al mismo tiempo y guardarlos en un archivo .m5b al mismo tiempo

Block Maker: http://block-maker.m5stack.com/

Haga clic en la opción Agregar en Parámetro, agregue una propiedad del programa, ingrese el nombre que se muestra en el bloque y seleccione el tipo de propiedad. Ingrese el código contenido en el bloque personalizado en el cuadro de opción Código de bloque.

Program API: https://github.com/m5stack/UIFlow-Code/wiki

Una vez programado descargar el .m5b

Para usar los bloques creados hacer open .m5b en UIFlow

Más información:

• https://docs.m5stack.com/#/en/uiflow/blockly_custom
• https://docs.m5stack.com/#/en/related_documents/blockly_custom
• http://m5edu.com/doc/7-custom-block/ (Bloques de prueba)

Comunicaciones

ESP-NOW: https://docs.m5stack.com/#/en/uiflow/advanced?id=esp-now

MQTT: https://docs.m5stack.com/#/en/uiflow/advanced?id=mqtt-communication

Wifi: https://docs.m5stack.com/#/en/uiflow/advanced?id=wifi 

P2P: https://docs.m5stack.com/#/en/uiflow/advanced?id=p2p

HTTP Request: https://docs.m5stack.com/#/en/uiflow/advanced?id=http 

Control Avanzado de Pines

Easy IO: https://docs.m5stack.com/#/en/uiflow/advanced?id=easy-io

PIN: https://docs.m5stack.com/#/en/uiflow/advanced?id=pin

PWM: https://docs.m5stack.com/#/en/uiflow/advanced?id=pwm

ADC: https://docs.m5stack.com/#/en/uiflow/advanced?id=adc

DAC: https://docs.m5stack.com/#/en/uiflow/advanced?id=dac

UART: https://docs.m5stack.com/#/en/uiflow/advanced?id=uart

I2C: https://docs.m5stack.com/#/en/uiflow/advanced?id=i2c

SD Card: https://docs.m5stack.com/#/en/uiflow/advanced?id=sdcard

Execute: https://docs.m5stack.com/#/en/uiflow/advanced?id=execute

Dispositivos M5Stack

El M5Stack ofrece una serie de dispositivos para hacer desarrollos sobre la plataforma ESP32 (compatible con Arduino).

El M5Stack es un dispositivo de tamaño mínimo, que cuenta con una carcasa, un display a color de dos pulgadas, conectividad usb-c para su programación y alimentación (también cuenta con una conexión de batería), conectividad I2C y un montón de puertos GPIO para conectarle todo tipo de dispositivos. Dispone de numerosas opciones de conectividad y posibilidades de desarrollo.

También cuenta con tres botones programables, un altavoz de 1W, la pantalla LED a color y con resolución 320 x 240, un zócalo para agregar una tarjeta de memoria, conector para baterías LiPo de hasta 2A y muchas otras opciones, como una base con imanes para poder dejarlo colgado de la nevera o en la pared o contar con un acelerómetro y giroscopio. Para mayor compatibilidad con todo tipo de sensores y actuadores M5Stack tiene conectividad a 3,3 y 5 V. El diseño es modular, de forma que en su parte inferior podremos conectarle distintos elementos como placas de desarrollo, sensores, baterías, etc. 

Otros aspecto importante, es la interfaz de desarrollo de aplicaciones gráfica al estilo de Scratch en http://flow.m5stack.com/ que más adelante trataremos.

Web: https://m5stack.com/

Github: https://github.com/m5stack/M5Stack

Docs: https://docs.m5stack.com/#/

Tienda: https://m5stack.com/collections/all

Tienda oficial en AliExpress: https://m5stack.es.aliexpress.com/store/3226069

Proyectos: https://m5stack.hackster.io/

Comunidad: http://community.m5stack.com/

Buena web con mucha información: https://docs.makerfactory.io/m5stack/overview/

Más información: https://www.prometec.net/m5stack/arduino/introduccion/

Hardware M5Core

M5Stack no solo es el hardware inicial que apareció, sino que hay muchos dispositivos, hats y módulos de la familia M5Stack. A estos módulos se les denomina M5Core.

Core:

• Basic: https://docs.m5stack.com/#/en/core/basic
• Gray: https://docs.m5stack.com/#/en/core/gray
• Fire: https://docs.m5stack.com/#/en/core/fire
• M5Go: https://docs.m5stack.com/#/en/core/m5go
• Faces Kit: https://docs.m5stack.com/#/en/core/face_kit
• M5Stick: https://docs.m5stack.com/#/en/core/m5stick
• M5StickC: https://docs.m5stack.com/#/en/core/m5stickc
• M5StickV: https://docs.m5stack.com/#/en/core/m5stickv
• M5StickT: https://docs.m5stack.com/#/en/core/m5stickt
• Atom Lite: https://docs.m5stack.com/#/en/core/atom_lite
• Atom Matrix: https://docs.m5stack.com/#/en/core/atom_matrix

Módulos M5Stack: https://docs.m5stack.com/#/

• Módulos de comunicación
• Módulos de expansión
• Módulos de driver motores
• Módulos de faces

Bases: https://docs.m5stack.com/#/

• Bases para los M5Stack
• Bases para los Atom

Sensores: https://docs.m5stack.com/#/

• Diverso tipos de módulos de cámara
• Sensores I2C de todo tipo con conector grove
• Extensiones de I/O
• Comunicaciones
• LEDs

C-HATs para M5Stick: https://docs.m5stack.com/#/

• Diversos HATs para los M5StickC
• BugC: https://docs.m5stack.com/#/en/hat/hat-bugc
• RoverC: https://docs.m5stack.com/#/en/hat/hat-roverc
• JoyC: https://docs.m5stack.com/#/en/hat/hat-joyc
• 18650C: https://docs.m5stack.com/#/en/hat/hat-18650

Application: https://docs.m5stack.com/#/

• Diversos complementos y aplicaciones

Lista de productos: https://docs.m5stack.com/#/

Comparativa de productos: https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/Product_compared.pdf

Tabla de I2C addresses: https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/I2C_Address.pdf

Getting Started

Para empezar con los dispositivos de la familia M5Stack lo primero conectar al ordenador. Todos ellos tienen interfaz USB-C y es necesario instalar el driver 

Antes de grabar el programa, los usuarios de M5Core (incluidos BASIC / GREY / M5GO / FIRE / FACES) deben descargar el driver CP210X correspondiente según el sistema operativo que estén utilizando.

El soporte de la serie M5StickC/V/T/ATOM se puede utilizar sin driver, los usuarios pueden omitir este paso de instalación del controlador.

Drivers:

• Windows: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_Windows.zip 
• MacOS: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_MacOS.zip 
• Linux: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/drivers/CP210x_VCP_Linux.zip 

Establecer conexión serie:

• https://docs.m5stack.com/#/en/arduino/arduino_development
• https://docs.m5stack.com/#/en/related_documents/establish_serial_connection

EasyLoader es un programador simple y rápido, que tiene un programa de demo incorporado relacionado con el producto a programar. Se puede grabar para realizar una serie de verificación de funciones del módulo.

Easyloader:

• Windows: https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/Windows/CORE/EasyLoader_M5Core_FactoryTest.exe
• MacOs: https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/MacOS/CORE/EasyLoader_FACES_FactoryTest.dmg 

La programación de la familia M5Core se puede hacer de las siguientes formas y trataremos cada una de ellas más adelante:

• UIFlow – Para usuarios novatos
• MicroPython – Para quien ya tiene conocimientos de programación general
• IDE Arduino – Para usuarios avanzados o conocimientos de Arduino
• Free RTOS – Para usarios avanzados

Documentación para programación:

• Arduino: https://docs.m5stack.com/#/en/arduino/arduino_home_page
• UIFlow: https://docs.m5stack.com/#/en/uiflow/uiflow_home_page
• MicroPython: https://github.com/m5stack/M5Stack_MicroPython

Quick Start: https://docs.m5stack.com/#/en/quick_start/m5stickc/m5stickc_quick_start

M5 Education

Web http://m5edu.com/ 

M5 Understanding: http://m5edu.com/kb/1-m5-stack-understanding/

Manual básico de operación: http://m5edu.com/kb/2-basic-operation-manual/

Uso de Hardware: http://m5edu.com/kb/3-hardware-operation/

Operaciones: http://m5edu.com/kb/4-units-operation/

Operaciones Avanzadas: http://m5edu.com/kb/5-advanced-operation/

Video Tutorial: http://m5edu.com/doc/documentation-m5-video-tutorial/

M5Stack

Descripción del HW https://docs.m5stack.com/#/en/core/basic

Primera version del M5Core: https://www.youtube.com/watch?v=l-PnOi3tM1w

Es un dispositivo modular, apilable, escalable y portátil que funciona con un núcleo ESP-32, lo que lo hace de código abierto, de bajo costo, con todas las funciones y fácil para que los desarrolladores manejen el desarrollo de nuevos productos en todas las etapas.

M5Stack Basic consta de dos partes separables. La parte positiva tiene todo tipo de procesadores, chips y algunos otros componentes de ranura. La parte inferior tiene una batería de litio, toma M-BUS y clavijas extensibles en ambos lados.

M5Stack BASIC:

• https://docs.m5stack.com/#/en/core/basic
• https://docs.makerfactory.io/m5stack/core/black/

Características:

• ESP32-based: 240MHz dual core, 600 DMIPS, 520KB SRAM, Wi-Fi, dual mode Bluetooth
• 4MB Flash of SPI Flash
• Built-in Speaker  1W, 3x Buttons,Color LCD, Power/Reset button
• IPS Screen: 2 inch, 320×240 Colorful TFT LCD, ILI9342C, max brightness 853nit
• TF card slot (16G Maximum size)
• Magnetic suction at back
• Extendable Pins & Holes
• M-Bus Socket & Pins
• Battery 110mAh @3.7V

Pinout:

Esquemático: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/schematic/Core/M5-Core-Schematic(20171206).pdf

Además de la versión Basic hay otras versiones con alguna característica adicional.

M5Stack GRAY: 

• https://docs.m5stack.com/#/en/core/gray
• https://docs.makerfactory.io/m5stack/core/gray/
• Gray kit provides an extra IMU sensor, BMM150 + MPU6886
• 16MB of SPI Flash

M5Stack Fire:

• https://docs.m5stack.com/#/en/core/fire
• https://docs.makerfactory.io/m5stack/core/fire/
• 9-Axis IMU sensor(6-Axis posture acceleration measurement + 3-Axis magnetic measurement)
• 16M Flash + 4M PSRAM
• enhanced Base (M5GO Base and M5GO CHG Base) and larger battery 500 mAh
• microphone
• LED bar and three more GROVE Ports

M5GO:

• https://docs.m5stack.com/#/en/core/m5go
• https://docs.makerfactory.io/m5stack/kit/m5go/
• This M5GO kit is specifically designed for STEM education
• Guia M5Go: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/M5GO_Guide_English.pdf
• User Manual: http://flow.m5stack.com/download/M5GO_User_Manual_en.pdf

Faces Kit:

• https://docs.m5stack.com/#/en/core/face_kit
• https://docs.makerfactory.io/m5stack/kit/faces/
• Faces Base: https://docs.makerfactory.io/m5stack/base/faces/

Vídeo: https://www.youtube.com/watch?v=l-PnOi3tM1w

Más información:

• https://www.prometec.net/m5stack/arduino/introduccion/
• https://www.xatakahome.com/trucos-y-bricolaje-smart/el-m5stack-core-development-puede-ser-lo-que-estaban-esperando-los-maker-y-lo-que-necesita-la-internet-de-las-cosas
• https://www.hackster.io/news/m5stack-is-a-stackable-modular-dev-kit-with-an-aluminum-shell-2c6215eaf471
• https://hackaday.io/project/14524-m5stack-an-open-source-enclosed-modular-toolkit
• https://www.instructables.com/id/How-to-Make-a-Commercial-Product-Quickly-and-Low-c/

Módulos M5Stack

Algunos ejemplos de uso de módulos de M5Stack:

GPS:

• https://docs.m5stack.com/#/en/module/gps
• https://docs.makerfactory.io/m5stack/module/gps/

Battery:

• https://docs.m5stack.com/#/en/module/battery
• https://docs.makerfactory.io/m5stack/module/battery/

M5 Camera:

• https://docs.makerfactory.io/m5stack/module/battery/
• https://docs.m5stack.com/#/en/unit/m5camera
• https://docs.m5stack.com/#/en/unit/m5camera_x

Más módulos: https://docs.m5stack.com/#/

M5StickC

El M5Stick-C es un mini M5Stack, basado en el microcontrolador ESP32. Es una placa de desarrollo de IoT portátil, fácil de usar y de código abierto. Además es muy económica costando menos de 10$.

M5StickC es una tarjeta de desarrollo ESP32 con una pantalla a color de 0.96 pulgadas TFT (resolución 80×160), LED rojo, 2x botones, Micrófono, transmisor IR, IMU de 6-ejes (SH200Q) y una batería de 80 mAh. El módulo ESP32 ESP32-Pico en el M5StickC tiene incluído 4MB de memoria flash. EL M5StickC también está equipado con una base y una correa para reloj, para que lo puedas usar en tu muñeca como un wearable.

Dispositivo:

• https://m5stack.com/products/stick-c
• https://docs.m5stack.com/#/en/core/m5stickc

Librería: https://github.com/m5stack/M5StickC 

Este pequeño bloque es capaz de realizar tu idea, iluminar tu creatividad, y ayudar con tu prototipo de IoT en muy poco tiempo. Eliminará muchos de los problemas del proceso de desarrollo.

M5stickC es uno de los dispositivos principales de la serie de productos M5Stack, que se construye en un ecosistema de hardware y software en continuo crecimiento. Tiene una gran cantidad de módulos y unidades compatibles, así como la comunidad de código abierto y de ingeniería que le ayudará a maximizar su beneficio en cada paso del proceso de desarrollo.

M5StickC Book: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/UIFlow-StickC-Book-English.pdf

M5StickC usa un chip USB FTDI por lo que no hace falta instalar driver en Windows, Linux y MAC. En caso de necesitarlo, el driver es: https://www.ftdichip.com/Drivers/VCP.htm.

Características:

• 5V DC power supply
• LCD screen – 0.96 inch, 80*160 Colorful TFT LCD, ST7735S
• USB Type-C
• ESP32-based (Wifi + Bluetooth)
• 4 MByte Flash + 520K RAM
• 6-Axis IMU MPU6886
• Red LED
• IR transmitter
• Microphone – SPM1423
• RTC – BM8563
• PMU (Power Management Unit) – AXP192
• 2 Buttons, LCD(0.96 inch), 1 Reset Button
• 2.4G Antenna: Proant 440
• 95 mAh @ 3.7V Lipo Battery
• Extendable Socket
• Grove Port
• Wearable & Wall mounted
• Development Platform UIFlow, MicroPython, Arduino

Esquemático: https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/schematic/Core/M5StickC/20191118__StickC_A04_3110_Schematic_Rebuild_PinMap.pdf

Datasheets:

• ESP32-PICO – Microcontrolador: https://www.hackster.io/news/introducing-the-new-esp32-pico-d4-sip-99476238bc07
• ST7735S – TFT Controller
• BM8563 – RTC
• MPU6886 – MPU 6DOF
• SH200Q
• AXP192 – Gestor de Batería y cargador para baterías Li-Ion y Li-Po. Gestiona el modo sleep.
• SPM1423 – Micrófono

Un buen resumen sobre M5StickC: http://tinkerfarm.net/projects/the-m5stickc/

Cuidado con usar 5V en M5StickC: http://tinkerfarm.net/projects/the-m5stickc/the-5-volt-danger-with-the-m5stickc/

Accesorios M5StickC: http://tinkerfarm.net/projects/the-m5stickc/m5stickc-hardware-accessories/

Direcciones I2C en M5StickC: https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/m5-docs_table/I2C_Address.pdf

• 0x34 AXP192
• 0x6C SH200Q
• 0x51 BM8563
• 0x68 MPU6886

M5StickC Pinout

Pinout:

Módulo AXP192 (Gestor de Energía)

Este dispositivo gestiona la batería interna del M5stick y se puede ver la carga y temperatura.

Datasheet: https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet%20v1.13_cn.pdf

Datasheet: http://www.x-powers.com/en.php/Info/down1/id/29 

Librería: https://github.com/m5stack/M5StickC/blob/master/src/AXP192.h

Interesante: https://github.com/m5stack/M5StickC/blob/master/examples/Advanced/AXP192/PowerWake/PowerWake.ino, lee los valores y muestra por pantalla: voltaje batería, aps (el voltaje de carga) y el nivel de carga. También en caso de WarningLevel, avisa de baja batería por el display y al tercer aviso lo pone en modo sleep desde el módulo AXP192

Más interesante: https://github.com/m5stack/M5StickC/blob/master/examples/Basics/AXP192/AXP192.ino da toda la información de alimentación.

Esquema de bloques del módulo:

También gestiona la carga de otros dispositivos y se puede regular la corriente de carga.
Ver ejemplo hecho con UIFlow: https://github.com/jecrespo/M5StickC-UIFlow/blob/master/M5/M5StickC_Power_Control.m5f

Hats M5StickC

SPK Hat (Speaker): https://docs.m5stack.com/#/en/hat/hat-spk

ENV Hat (sensores ambientales): https://docs.m5stack.com/#/en/hat/hat-env

BugC HAT: https://docs.m5stack.com/#/en/hat/hat-bugc

RoverC HAT: https://docs.m5stack.com/#/en/hat/hat-roverc

JoyC HAT: https://docs.m5stack.com/#/en/hat/hat-joyc

18650C HAT: https://docs.m5stack.com/#/en/hat/hat-18650