Manual de Usuario: Configurador SoundBlocks

1. Introducción

Configurador SoundBlocks es el entorno de software diseñado para definir la comunicación interactiva y la síntesis de sonido entre los módulos de hardware SoundBlocks a través de una red inalámbrica local.

Cada módulo físico posee un identificador numérico único (ID) dentro del rango de 2 a 254. Un módulo transmite las lecturas de sus sensores a la red o actúa como receptor, activando muestras de audio y parámetros de síntesis sonora.

2. Inicio Rápido

Un script de configuración de SoundBlocks consta de reglas declaradas concisamente línea por línea. A continuación se presenta un script de configuración interactivo completo:

# Configuración básica: Control de audio mediante sensor táctil
# 1. El Módulo 10 transmite la señal del sensor táctil t1 al Módulo 20
10->t1:20

# 2. El Módulo 20 escucha al Módulo 10 y reproduce la muestra de audio nº 3 al activarse t1
20<-t1:10@Play[3]

3. Reglas de Envío (->)

Especifica qué sensores integrados emite un módulo local a la red y define los módulos de destino autorizados.

Estructura de la Regla de Envío

Especificaciones Estructurales

• ID_EMISOR: Identificador del módulo transmisor (rango: 2 a 254).
• SENSORES: Códigos de sensor separados por comas (ej. t1,ax,gz).
• DESTINOS: Módulos receptores autorizados:
  • Módulos explícitos: 102,105
  • Rangos continuos mediante guiones: 105-108 (abarca 105, 106, 107 y 108).
  • Modo Broadcast (Difusión): Usa el ID 255 para transmitir a todos los nodos de la red.

Ejemplo Práctico de Envío

# El Módulo 122 transmite el sensor táctil t1 y el acelerómetro ax a los módulos 102, 105, 106, 107 y 108
122->t1,ax:102,105-108

# El Módulo 50 transmite la velocidad angular gx a TODOS los módulos conectados (Broadcast)
50->gx:255

4. Reglas de Recepción (<-)

Configura la acción de audio o el parámetro de síntesis ejecutado por el módulo local al recibir datos de sensor desde un nodo emisor.

Estructura de la Regla de Recepción

Mapeo de Valores [Mín, Máx]

El parámetro entre corchetes [...] define el rango de escalado de control:

• Dos parámetros [mín, máx]: Escala proporcionalmente los datos del sensor entrante. Ej., Vol[0,15] escala el volumen entre 0 y 15.
• Un parámetro [valor]: Establece un parámetro selector fijo. Ej., Play[5] selecciona estrictamente la muestra de audio nº 5.
• Sin parámetros / Por defecto: Asume [0,0] si se omite. Comandos como Stop, Pause o Resume no requieren corchetes.

Ejemplo Práctico de Recepción

# El Módulo 108 escala el volumen (rango 0-15) según la aceleración 'ax' del Módulo 122
108<-ax:122@Vol[0,15]

# El Módulo 102 activa la muestra nº 3 al recibir la señal táctil 't7' del Módulo 108
102<-t7:108@Play[3]

# El Módulo 40 detiene la reproducción al recibir 't1' del Módulo 10
40<-t1:10@Stop

5. Referencia de Sensores

Índice interactivo de sensores integrados en el hardware:

6. Referencia de Acciones

Comandos de reproducción y parámetros de síntesis sonora:

7. Solución de Problemas (Consola y Errores)

Diagnósticos basados en los mensajes de error devueltos por el verificador del compilador: