📋 COMPONENTES DEL SISTEMA

⚡ FRECUENCIA DE MUESTREO

El sistema está optimizado para captura en tiempo real con visualización fluida:

• Frecuencia mínima teórica: Hasta 1000 Hz (1 ms entre muestras)
• Frecuencia práctica recomendada: 10-100 Hz (10-100 ms entre muestras)
• Limitaciones principales:
• Puerto serial USB: 115200 baudios (límite de ~11 KB/s)
• Procesamiento de micro:bit: Los sensores internos tienen sus propias limitaciones
• Renderizado del navegador: Optimizado para actualizar cada 50ms

📊 Frecuencias recomendadas por tipo de experimento:

💡 Tip: Usa basic.pause(X) en JavaScript o sleep(X) en Python, donde X es el tiempo en milisegundos entre muestras.

🚀 FLUJO DE TRABAJO - UNA VARIABLE

1 Conecta tu micro:bit por USB a la computadora

2 Haz clic en CONECTAR y selecciona el puerto USB

3 (Opcional) Activa la CÁMARA para grabar video

4 Haz clic en CAPTURAR para iniciar

5 Realiza tu experimento

6 Haz clic en DETENER cuando termines

7 Analiza los datos:

• Click en puntos para seleccionar
• Botón ▶ en tabla para ver video en ese momento
• Configura ejes y establece tiempo cero
• Exporta resultados

💻 CÓDIGO PARA MICRO:BIT - UNA VARIABLE

Tu micro:bit debe enviar datos por serial. Aquí tienes ejemplos básicos:

// Enviar valor del acelerómetro
basic.forever(function () {
    serial.writeNumber(input.acceleration(Dimension.X))
    serial.writeLine("")
    basic.pause(100)  // 100ms = 10 datos/segundo
})

# Enviar valor de temperatura
from microbit import *

while True:
    valor = temperature()
    print(valor)
    sleep(100)

⚠️ IMPORTANTE:

• Envía SOLO EL NÚMERO, sin texto adicional
• Usa serial.writeNumber() en JavaScript o print() en Python
• Termina cada valor con salto de línea (serial.writeLine("") o automático con print())
• Ajusta basic.pause() o sleep() según la frecuencia deseada

📹 VIDEO SINCRONIZADO

El sistema graba video del experimento y lo sincroniza con los datos:

• Activa la cámara ANTES de capturar datos
• Al hacer clic en CAPTURAR, inicia video + datos simultáneamente
• Cada dato tiene un timestamp asociado al video
• Click en botón ▶ en la tabla para ver ese momento exacto
• El video se reproduce desde el instante del punto seleccionado

🎯 EJEMPLOS DE SENSORES

basic.forever(function () {
    serial.writeNumber(input.acceleration(Dimension.X))
    serial.writeLine("")
    basic.pause(50)
})

basic.forever(function () {
    serial.writeNumber(input.lightLevel())
    serial.writeLine("")
    basic.pause(100)
})

basic.forever(function () {
    serial.writeNumber(input.compassHeading())
    serial.writeLine("")
    basic.pause(100)
})

basic.forever(function () {
    let valor = pins.analogReadPin(AnalogPin.P0)
    serial.writeNumber(valor)
    serial.writeLine("")
    basic.pause(100)
})

🚀 FUNCIONES AVANZADAS - MÚLTIPLES VARIABLES

Esta versión PRO incluye capacidades avanzadas:

• Múltiples Variables: Captura hasta 3 variables simultáneamente
• Múltiples Gráficas: Visualiza 1, 2 o 3 gráficas independientes
• Ejes Personalizables: Grafica variable vs variable, no solo vs tiempo
• Colores Personalizados: Asigna colores a cada variable
• Toggle de Líneas: Activa/desactiva líneas conectoras

📡 CÓDIGO MÚLTIPLES VARIABLES - FORMATO DE DATOS

Para enviar múltiples variables, tu micro:bit debe enviar los valores separados por comas en una sola línea.

Pasos para configurar:

1. En el panel "VARIABLES", selecciona cuántas variables usar (1, 2 o 3)
2. Personaliza el nombre y color de cada variable
3. Haz clic en "APLICAR CONFIGURACIÓN"
4. Programa tu micro:bit para enviar valores separados por comas

💻 EJEMPLOS - 2 VARIABLES

// Ejemplo: Acelerómetro X e Y
basic.forever(function () {
    let accelX = input.acceleration(Dimension.X)
    let accelY = input.acceleration(Dimension.Y)

    // Enviar separados por coma
    serial.writeLine("" + accelX + "," + accelY)

    basic.pause(100)  // 100ms entre lecturas
})

# Ejemplo: Temperatura y nivel de luz
from microbit import *

while True:
    temp = temperature()
    light = display.read_light_level()

    # Enviar separados por coma
    print(str(temp) + "," + str(light))

    sleep(100)

💻 EJEMPLOS - 3 VARIABLES

// Ejemplo: Acelerómetro X, Y, Z
basic.forever(function () {
    let accelX = input.acceleration(Dimension.X)
    let accelY = input.acceleration(Dimension.Y)
    let accelZ = input.acceleration(Dimension.Z)

    // Enviar separados por coma
    serial.writeLine("" + accelX + "," + accelY + "," + accelZ)

    basic.pause(50)  // 50ms = 20 lecturas/segundo
})

# Ejemplo: Acelerómetro completo
from microbit import *

while True:
    x = accelerometer.get_x()
    y = accelerometer.get_y()
    z = accelerometer.get_z()

    # Enviar separados por coma
    print("{},{},{}".format(x, y, z))

    sleep(50)

🎯 EJEMPLOS PRÁCTICOS MULTI-VARIABLE

// Usando sensor ultrasónico HC-SR04 en P0
basic.forever(function () {
    let distancia = pins.pulseIn(DigitalPin.P0, PulseValue.High)
    let temp = input.temperature()

    serial.writeLine("" + distancia + "," + temp)
    basic.pause(200)
})

basic.forever(function () {
    let sensorP0 = pins.analogReadPin(AnalogPin.P0)
    let luz = input.lightLevel()
    let direccion = input.compassHeading()

    serial.writeLine("" + sensorP0 + "," + luz + "," + direccion)
    basic.pause(100)
})

⚙️ REQUISITOS DEL SISTEMA

• Navegador: Chrome, Edge u Opera (con Web Serial API)
• Sistema: Windows, macOS o Linux
• Hardware: micro:bit v1 o v2 con cable USB
• Webcam: Opcional, para grabación de video
• Conexión: No requiere internet una vez cargada la página

❓ SOLUCIÓN DE PROBLEMAS

No aparece el puerto al conectar:

• Verifica que el cable USB esté bien conectado
• Prueba con otro puerto USB
• Reinicia el navegador

No llegan datos:

• Asegúrate de que el código esté corriendo en la micro:bit
• Verifica que uses serial.writeNumber() + serial.writeLine("")
• No envíes texto, solo números

La cámara no funciona:

• Permite el acceso a la cámara cuando el navegador lo solicite
• Verifica que otra aplicación no esté usando la cámara
• Prueba en modo incógnito del navegador

El video y los datos no coinciden:

• Activa la cámara ANTES de capturar datos
• Ambos deben iniciar con el mismo botón CAPTURAR