Referencia de programación SoundBlocks Configurator
Cada línea del script comienza con el ID del módulo que se va a configurar. El siguiente elemento de la línea define el comportamiento del módulo, indicando si va a enviar o recibir información.
Envía
Si el elemento contiene -> significa que el módulo va a enviar información.
Sintaxis:
módulo_que_envía -> sensores_a_enviar : modulo_que_recibenSensores
Los sensores deben separarse por comas y solo pueden ser seleccionados de la siguiente lista:
- t1 a t7: sensores táctiles (7 en total)
- ax, ay, az: valores del acelerómetro (ejes X, Y y Z)
- aax, aay, aaz: valores absolutos del acelerómetro (ejes X, Y y Z)
- gx, gy, gz: velocidad angular (giroscopio)
- agx, agy, agz: velocidad angular absoluta (giroscopio)
- rx, ry, rz: orientación (rumbo, elevación y alabeo)
Módulos que reciben
Se pueden definir hasta tres rangos numéricos de módulos destino. Los rangos se separan por comas, y un guión indica un rango continuo. Para enviar a un solo módulo, simplemente se indica su número. El módulo destino 255 está reservado para enviar información a todos los módulos (broadcast). Se puede especificar un máximo de cinco módulos destino por cada envío.
Ejemplo:
122->t1,ax:102,105-108El módulo 122 envía los datos del sensor t1 y el eje ax del acelerómetro a los módulos 102, 105, 106, 107 y 108.
Recibe
Si el elemento es <- significa que el módulo recibe información de otro módulo.
Sintaxis:
módulo_que_recibe <- sensor : módulo_que_envía @ actuador [mapeo]Detalle de Parámetros
- Sensor: El sensor específico desde el cual se recibe información.
- Módulo que envía: ID del módulo que envía la información.
Acciones / Actuadores
Dispositivo o función que se activa en base a la información recibida. Opciones disponibles:
- Reproducir: reproduce un sample (rango: 1 a 127).
- Pausar: pausa el sample.
- Detener: detiene el sample.
- Reanudar: reanuda el sample.
- EQ: configura el ecualizador (valores: 0=Off, 1=Pop, 2=Rock, 3=Jazz, 4=Classic, 5=Bass).
- Vol: ajusta el volumen (rango: 1 a 30).
- ReproDetener: alterna entre reproducir y detener (rango: 1 a 127).
- ReproReanudar: alterna entre reproducir (o reanudar) y pausar (rango: 1 a 127).
- ReproTactil: reproduce mientras se mantiene presionado el touch (rango: 1 a 127).
- ReproBarrido: reproduce un barrido de samples (rango: 1 a 127).
- Onda1: forma de onda del oscilador nro 1 (valores: 1=triangular, 2=diente de sierra, 3=cuadrada).
- Frec1: frecuencia del oscilador nro 1 (rango: 1 a 127).
- Vol1: volumen del oscilador nro 1 (rango: 1 a 127).
- Onda2: forma de onda del oscilador nro 2 (valores: 1=triangular, 2=diente de sierra, 3=cuadrada).
- Frec2: frecuencia del oscilador nro 2 (rango: 1 a 127).
- Vol2: volumen del oscilador nro 2 (rango: 1 a 127).
- Onda3: forma de onda del oscilador nro 3 (valores: 1=triangular, 2=diente de sierra, 3=cuadrada).
- Frec3: frecuencia del oscilador nro 3 (rango: 1 a 127).
- Vol3: volumen del oscilador nro 3 (rango: 1 a 127).
- VolRuido: volumen del ruido blanco (rango: 1 a 127).
Mapeo
Se utiliza para ajustar el rango de valores que recibe el actuador. Puede ser un valor único (máximo) o dos (mínimo y máximo). Si no se especifica, el valor por defecto es [0,0].
Ejemplo:
108<-ax:122@Vol[0,15]
102<-t7:108@Reproducir[3]Comentarios
Los comentarios se agregan anteponiendo # al inicio de la línea o al final de una instrucción.
Ejemplo:
122->ax:102,105-108 # El módulo 122 envía ax a los módulos 102 y del 105 al 108
# 102 <- ax : 122 @ Vol [0,15]