Bluetooth Low Energy (BLE) en MicroPython

import bluetooth
import time
from machine import Pin
from micropython import const

# --- Definiciones y Constantes ---
# Eventos del sistema BLE (IRQ)
_IRQ_CENTRAL_CONNECT = const(1)
_IRQ_CENTRAL_DISCONNECT = const(2)
_IRQ_GATTS_WRITE = const(3)

# Definimos nuestros UUIDs (Generados aleatoriamente)
# Servicio: 12345678-1234-5678-1234-56789abcdef0
_MI_SERVICIO_UUID = bluetooth.UUID("12345678-1234-5678-1234-56789abcdef0")
# Característica (LED): 12345678-1234-5678-1234-56789abcdef1
_MI_CHAR_UUID = bluetooth.UUID("12345678-1234-5678-1234-56789abcdef1")

# Flags de permisos: Se puede leer (READ) y escribir (WRITE)
_FLAG_READ = const(0x0002)
_FLAG_WRITE = const(0x0008)
_FLAG_NOTIFY = const(0x0010)

# --- Clase del Periférico BLE ---
class BLELedPeripheral:
    def __init__(self, ble, name="Mi-ESP32"):
        self._ble = ble
        self._ble.active(True)
        self._ble.irq(self._irq_handler)
        
        # Configurar el LED
        self._led = Pin(2, Pin.OUT)
        self._led.value(0)

        # Registrar el servicio y la característica
        # ((UUID, FLAGS),) -> Tupla de características
        SERVICES = (
            (_MI_SERVICIO_UUID, ((_MI_CHAR_UUID, _FLAG_READ | _FLAG_WRITE),)),
        )
        
        # gatts_register_services devuelve los "handles" (manejadores)
        # Necesitamos guardarlos para saber a qué característica escribe el móvil
        ((self._handle,),) = self._ble.gatts_register_services(SERVICES)
        
        self._conn_handle = None
        self._payload = self._create_advertising_payload(name=name)
        self._advertise()

    def _irq_handler(self, event, data):
        # Esta función se ejecuta automáticamente cuando pasa algo
        
        if event == _IRQ_CENTRAL_CONNECT:
            conn_handle, _, _ = data
            print("¡Móvil conectado!", conn_handle)
            self._conn_handle = conn_handle
            
        elif event == _IRQ_CENTRAL_DISCONNECT:
            conn_handle, _, _ = data
            print("Móvil desconectado.")
            self._conn_handle = None
            # Importante: Volver a anunciarse para que otro pueda conectar
            self._advertise()
            
        elif event == _IRQ_GATTS_WRITE:
            conn_handle, value_handle = data
            # Verificamos si escribieron en nuestra característica del LED
            if conn_handle == self._conn_handle and value_handle == self._handle:
                # Leemos el valor que han escrito
                val = self._ble.gatts_read(self._handle)
                self._update_led(val)

    def _update_led(self, data):
        # Si recibimos un '1' o 'ON', encendemos
        try:
            texto = data.decode().strip()
            print("Recibido:", texto)
            if texto == "1" or texto == "ON":
                self._led.value(1)
            elif texto == "0" or texto == "OFF":
                self._led.value(0)
        except:
            pass

    def _advertise(self, interval_us=500000):
        print("Anunciando...")
        self._ble.gap_advertise(interval_us, adv_data=self._payload)

    # Función auxiliar para crear el paquete de anuncio (GAP)
    # Esto es técnico, básicamente empaqueta el nombre en bytes
    def _create_advertising_payload(self, limited_disc=False, br_edr=False, name=None, services=None, appearance=0):
        import struct
        payload = bytearray()

        def _append(adv_type, value):
            payload.append(len(value) + 1)
            payload.append(adv_type)
            payload.extend(value)

        _append(0x01, struct.pack("B", (0x02 if limited_disc else 0x06) + (0x00 if br_edr else 0x04)))

        if name:
            _append(0x09, name)
            
        return payload

# --- Ejecución ---
ble = bluetooth.BLE()
p = BLELedPeripheral(ble)

while True:
    time.sleep(1)