Material Prácticas Curso Node-RED Developer

Para el curso on-line “Node-RED Developer Nivel 1”, el material necesario por parte de los alumnos para realizarlo es:

• 1 PC o Portátil con conexión a internet.
• Para seguir el curso on-line es recomendable dos pantallas, una para seguir el vídeo y otra para programar en Node-RED.
• Una cuenta en github o bitbucket.
• Opcionalmente software de virtualización instalado para ejecutar Node-RED. p.e. VirtualBox, VMWare Fusion o Docker.
• Opcionalmente una Raspberry Pi conectada a Internet. Estas Raspberry Pi podrían ser proporcionadas por el Think TIC y configurarlas para acceso remoto desde casa del alumno a los dispositivos ubicados en el Think TIC.
• Opcionalmente los alumnos con dispositivos IoT podrían conectarse e interactuar con ellos.

Todo el software y documentación utilizado en el curso es libre con licencia creative commons o similar.

Toda la documentación generada para la impartición de este curso será liberada con licencia Creative Commons y podrá ser utilizada bajo sus términos. La documentación estará disponible en https://www.aprendiendoarduino.com/ 

Entorno On-Line de Prácticas

Arquitectura

Se dispone de tres servidores:

• enriquecrespo.com (S.O. CentOS 8)
  • Mosquitto
  • Grafana
  • Docker
  • Otros servicios públicos
• aprendiendoarduino.com
  • Documentación curso con WordPress
  • BBDD MySQL públicas

Servidor cloud con las siguientes características:

• 1 vCPU
• 2 GB RAM
• 20 GB SSD

Node-RED

Cada alumno debe tener al menos una instancia de Node-RED instalada en el S.O. o virtualización que desee.

Opcionalmente se puede proporcionar una instancia en enriquecrespo.com. El usuario y contraseña se enviará por correo.

Broker MQTT. Mosquitto

Se usará un broker común para comunicar todos los dispositivos en la dirección: mqtt://enriquecrespo.com:1883

Los alumnos recibirán usuario y contraseña para acceder al broker con permisos de lectura y escritura en aprendiendonodered21/#

Opcionalmente hay una dirección de MQTT seguro en: mqtts://enriquecrespo.com:8883 y MQTT sobre websocket en ws://enriquecrespo.com:9001

Servicios

Base de datos MySQL en https://qaej225.aprendiendoarduino.com/ donde los alumnos podrán usar para almacenar datos. Recibirán por correo las credenciales de acceso.

Grupo de telegram para comunicarse y programar bots.

Hardware Usado para Interactuar

Para interactuar en el curso disponemos de diversos HW conectados.

M5stack: https://m5stack.com/collections/m5-core/products/basic-core-iot-development-kit 

M5Stick-C con sensor ENV:

• https://m5stack.com/collections/m5-core/products/stick-c
• https://m5stack.com/collections/m5-hat/products/m5stickc-env-hat-sht30-bmp280-bmm150

Arduino UNO + GSM Shield con conexión móvil: https://store.arduino.cc/arduino-gsm-shield-2-integrated-antenna 

Raspberry Pi Zero: Instalada en local con cámara y programada con Node-RED, usada como dispositivo remoto.

Raspberry Pi 3B: Instalada en local con Node-RED, Mosquitto y BBDD, usada como servidor.

Wibeee instalado y publicando datos.

Si el alumno tiene algún HW con que quiera interactuar, puede presentarlo y lo integramos en las prácticas.

Configuración de las Instancias de Node-RED Alumnos

Las instancias de Node-RED de los alumnos están desplegadas con Docker y con configuración personalizada y una serie de configuraciones adicionales  ya hechas.

El acceso es a través de https://enriquecrespo.com:188xx/ siendo xx el número de alumno asignado.

Los puertos 88xx y 83xx también estarán disponibles para cada alumno para exponer una API/Websocket y MQTT respectivamente.

También hay una red interna para comunicar son servicios internos no expuestos como BBDD a las instancias de Node-RED

Comando para levantar el contenedor:

docker run –restart always -d -p 188xx:1880 -p 88xx:80 -p 83xx:1883 –network ‘alumnos’ -v /opt/docker_volumes/nodered_dataxx:/data –name noderedxx nodered/node-red

El fichero de configuración settings.js tiene estas modificaciones:

• password nodered:

 adminAuth: {
         type: "credentials",
         users: [{
             username: "admin",
             password: "password cifrada usando node-red admin hash-pw",
             permissions: "*"
         }]
     }, 

• password dahsboard y web estática

 httpNodeAuth: {user:"user",pass:"password cifrada usando node-red admin hash-pw"},
 httpStaticAuth: {user:"user",pass:"password cifrada usando node-red admin hash-pw"}, 

• activar SSL y certificados

 https: {
       key: require("fs").readFileSync('/data/certificates/privkey.pem'),
       cert: require("fs").readFileSync('/data/certificates/cert.pem')
     },
 requireHttps: true, 

• activar proyectos

 editorTheme: {
         projects: {
             enabled: true
         }
     } 

• activar grabar datos en local o en memoria (almacenamiento)

 contextStorage: {
         default: "memoryOnly",
         memoryOnly: { module: 'memory' },
         file: { module: 'localfilesystem' }
     }, 

Demo IoT

En esta demo se va a ver la potencia de IoT con la combinación de varias tecnologías open source. Se usará Arduino y dispositivos compatibles con Arduino, Raspberry Pi, Node-RED y otras tecnologías como Telegram.

Además, esta demo pretende ser interactiva, es decir, que una vez vista esta demostración, cualquiera con las herramientas y código proporcionado y los elementos hardware descritos, podrán interactuar con la plataforma IoT de la demo.

Descripción de la Demo

Esta demo consiste en conectar múltiples dispositivos basados en Arduino de cualquier persona del mundo e interactuar con la plataforma IoT instalada en una Raspberry Pi, así como usar un grupo de Telegram para recibir avisos y alertas.

Para conectar todos los dispositivos basados en Arduino usaremos un broker MQTT público, en nuestro caso será MyQttHub https://myqtthub.com/, pero también podría usarse CloudMQTT https://www.cloudmqtt.com/.

Es imprescindible tener el usuario y contraseña del broker para interactuar, si no las tienes puedes pedirlas en aprendiendoarduino@gmail.com

Para saber más de MQTT puedes ver: https://aprendiendoarduino.wordpress.com/2018/11/19/mqtt/

Esta es la estructura que vamos a usar:

Cada dispositivo Arduino publicará en el broker MQTT un dato en un topic y en función del topic, la plataforma IoT basada en Node-Red y ejecutándose en una Raspberry Pi, realizará una serie de acciones.

Además usaremos el grupo de telegram https://t.me/aprendiendoarduinocursoarduino para la recepción de alertas e interactuar con un bot en los dispositivos conectados. Únete al grupo de telegram para interactuar.

Cada dispositivo basado en Arduino conectado a Internet (p.e. basado en ESP8266) se conecta al broker MQTT público mandando o recibiendo datos y esos datos son recibidos en la plataforma IoT basada en Node-RED, instalada en una Raspberry Pi en la sede central.

El dispositivo puede publicar datos en unos topics determinados que se leerán desde Node-RED y se ejecutarán una serie de acciones.

También el dispositivo se puede suscribir a unos topics determinados y leer los datos recibidos, así como ejecutar una serie de acciones en función de los datos recibidos.

Funcionalidades de la Demo

Los dispositivos basados en Arduino podrán hacer las siguientes acciones:

• Mandar mensajes de alerta. Por ejemplo la apertura de un detector magnético. Cuando se reciba, se mandará un mensaje al grupo de Telegram con el estado del sensor y quien lo manda y se visualizará en https://www.aprendiendoarduino.com/servicios/mensajes/index.html
• También se mandará una foto al grupo de Telegram cuando se reciba el mensaje de alerta.
• Mandar mensajes de temperatura y/o humedad. Estos datos se almacenarán en una BBDD y se visualizarán en el Dashboard de Node Red y en https://www.aprendiendoarduino.com/servicios/datos/graficas.html
• También se puede configurar una alerta para enviar a Telegram y al panel de mensajes, en caso que se supere una temperatura o humedad determinada.
• Recibir mensaje de encendido o apagado del led integrado de Arduino

Para visualizar e interactuar se dispone de:

• Grupo de Telegram
• Dashboard de Node-RED, que solo se visualiza en local donde esté instalado
• Gráficas
• Alertas

Estructura de topics

Para poder interactuar con la plataforma los mensajes se deben mandar con una estructura de topic concreta:

• demo/temperatura/Z – envía un dato numérico de temperatura
• demo/humedad/Z – envía un dato numérico de humedad
• demo/reset/Z – envía un mensaje de reset al reinicarse
• demo/alerta/xx – envía un texto de alarma
• demo/led/xx – envía un dato ON/OFF para el estado del LED

Siendo xx un identificador del nodo que puede ser un nombre o un número y siendo Z un número del 2 al 20 para identificar la gráfica donde visualizar los datos en https://www.aprendiendoarduino.com/servicios/datos/graficas.html.

Elementos de Hardware Usado

Hardware Nodos Remotos

• Placa compatible con Arduino con conexión a Internet. Placas recomendadas:
  • wemos D1 mini https://www.amazon.es/AZDelivery-D1-Mini-desarrollo-compatible/dp/B0754W6Z2F
  • Node MCU: https://tienda.bricogeek.com/wifi/1033-nodemcu-v3-esp8266.html 
  • Arduino Uno + Ethernet shield: https://store.arduino.cc/arduino-ethernet-shield-2 
  • M5Stack o M5StickC: https://m5stack.com/ 
• Protoboard
• Pulsador o sensor magnético
• Sensor de temperatura. Recomendados:
  • DHT11 o DHT22
  • DS18B20

Hardware Nodo Central

Raspberry Pi 3 Model B o superior:  https://www.raspberrypi.org/products/raspberry-pi-3-model-b/. Esta Raspberry Pi tiene instalado Node-RED donde se ejecutará la plataforma y la programación IoT.

Para la fotos una Raspberry Pi conectada a Internet con cámara. Por ejemplo, unas Raspberry Pi Zero W con cámara

Adicionalmente un M5stack para visualizar datos en la pantalla y controlar dispositivos con los botones.

Código Usado

Todo el código usado en la demo está disponible en el repositorio: https://github.com/jecrespo/demo-iot

Interactúa con la Plataforma

Como ejercicio, puedes interactuar con la plataforma y ser parte de la demos

Para la interacción con la demo necesitarás:

• Conectar un dispositivo basado en Arduino a Internet
• Cargar la plantilla https://github.com/jecrespo/demo-iot/blob/master/plantilla-arduino/plantilla-arduino.ino adaptandola al HW utilizado
• Mandar mensajes al broker MQTT público de MyQTTHub usado en la demo. Para ello necesita un usuario y contraseña, solicitalo en aprendiendoarduino@gmail.com
• Enviar mensajes de temperatura y/o humedad
• Enviar mensajes de alerta, p.e. puerta abierta
• Recibir mensajes de encendido/apagado

Para poder interactuar con la plataforma los mensajes se deben mandar con una estructura de topic concreta:

• demo/temperatura/Z – envía un dato numérico de temperatura
• demo/humedad/Z – envía un dato numérico de humedad
• demo/reset/Z – envía un mensaje de reset al reinicarse
• demo/alerta/xx – envía un texto de alarma
• demo/led/xx – envía un dato ON/OFF para el estado del LED

Siendo xx un identificador del nodo que puede ser un nombre o un número y siendo Z un número del 2 al 20.

Los mensajes de alarma se publicarán en el grupo de Telegram https://t.me/aprendiendoarduinocursoarduino

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