Resumen de la API

La API pública de wedopy está diseñada bajo principios de consistencia, claridad didáctica y seguridad. Todos los símbolos esenciales pueden importarse directamente desde el paquete raíz:

from wedopy import (
    Hub,
    Motor,
    MotorGroup,
    DistanceSensor,
    TiltSensor,
    LED,
    Button,
    task,
    running_time,
)

📑 Módulos y Clases

Módulo / Clase	Descripción	Documentación
`Hub`	Punto de entrada principal. Administra la conexión BLE, ciclo de vida, descubrimiento de puertos y acceso a dispositivos.	Ver API de Hub
`Motor`	Control de velocidad (-100 a 100), arranque y frenado en un puerto específico.	Ver API de Motores
`MotorGroup`	Control sincronizado de dos motores (A y B) con orden determinista.	Ver API de Motores
`DistanceSensor`	Lectura de distancia (0..10) y métodos de umbral `is_near()` e `is_far()`.	Ver API de Sensores
`TiltSensor`	Sensor de inclinación: lectura de dirección (`read_direction()`) y ángulo 2D (`read_angle()`).	Ver API de Sensores
`LED`	Control del LED RGB integrado (colores indexados 0..10 o RGB directo).	Ver API de Periféricos
`Button`	Consulta de estado del botón físico integrado (`is_pressed`, `is_released`).	Ver API de Periféricos
`task` y `tasks`	Sistema de multitarea cooperativa ligera (`task.sleep`, `task.yield_now`, `hub.tasks.wait`).	Ver API de Tareas
`Excepciones`	Jerarquía completa de errores de comunicación, conexión y estado.	Ver Excepciones
`running_time`	Utilidad sencilla para medir milisegundos transcurridos desde el inicio del programa.	Ver API de Tiempo

💡 Patrón de uso fundamental

from wedopy import Hub

# Conexión automática mediante context manager
with Hub() as hub:
    # Obtener dispositivos
    motor = hub.motor("A")
    distancia = hub.distance_sensor("B")

    # Operaciones
    hub.led.index(5) # Verde
    motor.run(80)

    while not distancia.is_near(3):
        pass

    motor.stop()