Módulos

Los módulos son la parte de JARU que habla con el mundo: la pantalla, el sonido, los botones, los pines de la placa, la red y los ficheros. Cada uno reúne sus funciones, propiedades y constantes bajo un nombre, que se escribe delante: Display.open, GPIO.write, Math.PI.

Cómo se usan

Un programa dice qué módulos usa con use, uno por línea o varios separados por comas:

use Math, GPIO
use Display

println(Math.sqrt(16))   // 4

• Un nombre que no es de ningún módulo no compila: use Nada da el error Module not found.
• Si usas un módulo sin su use, el programa compila, pero se para al llegar a esa línea con ERR_MODULE_NOT_FOUND (Module 'Math' not found or not imported.).
• use es para los módulos de JARU; los ficheros de tu proyecto se traen con import. La diferencia está en Programas de varios ficheros.

Los módulos son los mismos en Windows y en todas las placas. Lo que cambia de una plataforma a otra lo cuenta cada página en su apartado «Plataformas».

Hay funciones que no son de ningún módulo y no necesitan use, como println, pause, clock o random: están en la Librería estándar. Los métodos de las cadenas, las listas y los mapas están en Cadenas y en Listas, mapas y arrays.

Los módulos

Gráficos y juegos

Módulo	Para qué
Display	Abrir la pantalla o la ventana, su tamaño y su fondo, y el ritmo del juego
Draw	Dibujar puntos, líneas, rectángulos, círculos, texto, imágenes y mapas de tiles
Bitmap	Cargar imágenes BMP y trabajar con ellas
Sprite	Sprites con animación, colisiones y física
GridMap	Rejillas 2D: mapas de tiles, choques con el mapa y búsqueda de caminos
Scene	La escena: sus sprites, la cámara, la física y el mapa
Sound	Sonidos sintetizados, muestras PCM y música

Entrada

Módulo	Para qué
Input	El teclado, los botones y el mando, como acciones del juego

Hardware

Módulo	Para qué
GPIO	Los pines de entrada y salida, el PWM y las interrupciones
I2C	Sensores y otros aparatos conectados por I2C
LED	Tiras y matrices de LEDs de colores WS2812
Power	Dormir la placa para ahorrar energía, y despertarla

Comunicaciones

Módulo	Para qué
MQTT	Publicar y recibir mensajes MQTT
Http	Peticiones HTTP a APIs y servicios web

Datos y ficheros

Módulo	Para qué
File	Ficheros y carpetas, en la flash, en la tarjeta SD o en el PC
Bytes	Bloques de bytes para datos binarios
JSON	Leer y escribir JSON

Sistema

Módulo	Para qué
Timer	Llamar a una función pasado un tiempo, una vez o cada cierto tiempo
Math	Funciones y constantes matemáticas
GC	El recolector de basura, que libera la memoria que ya no se usa