Open Electronics publicó el 22 de noviembre una guía para desarrollar aplicaciones de audio sobre un módulo con ESP32-S3 capaz de aplicar efectos DSP en tiempo real. El ejemplo práctico es un ecualizador estéreo de siete bandas con control de volumen, montado en formato pedal para guitarra.

La plataforma está pensada para el procesamiento digital de sonido (DSP), es decir, convertir y procesar audio en tiempo real con capacidad de cómputo suficiente para intervenir la señal muestra por muestra. Trabajar a ese nivel permite construir cualquier aplicación del ámbito musical, desde un reproductor simple hasta efectos de modulación, distorsión, delay y reverberación. El centro del proyecto es el VoidX DSP Module, un módulo de hardware que nació para entregarle a quien desarrolla todas las herramientas necesarias para trabajar con sonido.

Hardware y software, el ecosistema VoidX

El módulo integra en una sola placa una CPU (ESP32-S3), los convertidores de audio (ADC y DAC) y periféricos accesorios, como MIDI, USB y numerosas interfaces de entrada y salida. Según sus autores, su desempeño de audio es comparable o superior al de productos profesionales comerciales, con una relación señal a ruido sobre 110 dB.

Una vez definida la arquitectura física, el equipo armó un entorno de software con todos los drivers que el sistema necesita ya integrados y configurados. El resultado es VoidX Library, un framework de desarrollo para aplicaciones de audio en tiempo real que deja a quien programa concentrado solo en la lógica de su aplicación.

El procesamiento de la señal no es lo único que importa en un proyecto real. Puede hacer falta cambiar parámetros como el volumen, actualizar el firmware, conectarse a un PC o a un celular. El framework cubre esas necesidades con un conjunto de primitivas (nodos) para manipular datos y parámetros, y los expone a través de un protocolo de comunicación diseñado para eso.

Para el control remoto existe la app VoidX Control, gratuita para Android e iOS. Como caso práctico, el artículo construye un ecualizador gráfico de siete bandas para guitarra en formato pedal. Junto al módulo principal hay una placa de expansión con las conexiones necesarias, y desde el ejemplo entregado se puede construir el efecto que uno prefiera.

Cómo está armado el VoidX DSP Module

Es una placa pequeña con dos conectores. El principal, de 2×20 pines, lleva la alimentación y las interfaces de entrada y salida. El de audio, de 2×5 pines, se encarga de la conexión de alta fidelidad. La alimentación puede llegar por USB o por el conector principal.

Adentro hay una fuente conmutada que acepta voltajes de 5 V a 15 V. La figura 2 muestra el pinout de la placa y sus características principales. Hay más detalles en el sitio www.voidxdevteam.com.

Fig. 2. Pinout del VoidX DSP Module.

La placa anfitriona del pedal

La Mini Stomp-X Dev-Board aloja al VoidX DSP Module y es la que permite construir el ecualizador estéreo de siete bandas con control de volumen en formato stomp-box (figura 3). Los autores fabricaron también una caja metálica para esta placa. Las fuentes completas del hardware están en este repositorio.

github.com/voidxdevteam/VoidX-Mini-Stomp-X](https://github.com/voidxdevteam/VoidX-Mini-Stomp-X)

Fig. 3. Diagrama de bloques de la Mini Stomp-X Dev-Board.

La Mini Stomp-X tiene la circuitería analógica que conecta con el ADC y el DAC del VoidX DSP Module. Expone conectores MIDI (IN y OUT/THRU), una salida de audífonos y una entrada para pedal de expresión, todos en jacks TRS de 3,5 mm. Se alimenta por USB o por el clásico conector de 9 V DC de los pedales de efecto.

La interfaz de usuario tiene un encoder para navegar, una pantalla OLED de 128×64, un footswitch y un LED RGB. El pedal también se puede controlar a distancia con la app VoidX Control.

¿Qué hace la aplicación de ejemplo?

Es un ecualizador estéreo de siete bandas con control de volumen, y la curva de ecualización es la misma para los dos canales (izquierdo y derecho). Cada banda usa un filtro PeakingEQ, definido por tres parámetros (figura 4).

  • Frecuencia central, alrededor de la cual el filtro realza o atenúa.
  • Amplitud, el realce (o corte) en dB alrededor de la frecuencia central.
  • Q (factor de calidad), la selectividad del filtro.

Para esta aplicación se eligieron frecuencias de 100 Hz a 6,4 kHz espaciadas por octavas (100 Hz, 200 Hz, 400 Hz, 800 Hz, 1,6 kHz, 3,2 kHz y 6,4 kHz). El Q es 1,4 en todos los filtros, la elección clásica para bancos espaciados por octava (figura 5).

Fig. 4. Filtro Peaking EQ con su frecuencia, amplitud y factor de calidad.
Fig. 5. Ecualizador estéreo de siete bandas.

ESP-IDF y VoidX Library

El entorno usado es ESP-IDF, el framework de desarrollo de la familia ESP32 basado en el sistema operativo de tiempo real FreeRTOS. VoidX Library se configura como un ESP-IDF Component, en la práctica una biblioteca estática y un conjunto de encabezados que se instancian dentro de un proyecto. La aplicación completa, desarrollada con Visual Studio Code, está en GitHub junto con instrucciones detalladas para enlazar la biblioteca.

github.com/voidxdevteam/voidx-public-app](https://github.com/voidxdevteam/voidx-public-app)

El esqueleto de la aplicación lo entrega VoidX Library, que permite desarrollar aplicaciones completas con una interfaz simple y se encarga de varios aspectos de bajo nivel de manera transparente. El primero de ellos es el manejo de los hilos de audio en tiempo real con prioridad muy alta. La biblioteca trae además numerosos drivers de hardware.

El arranque y la clase Eq7

El flujo del código parte en main (listado 1). Primero se inicializan los drivers de hardware, la expansión de entradas y salidas por registro de desplazamiento, I2S e I2C para comunicarse con los convertidores y el periférico de pantalla. Después arranca el framework VoidX.

  • system_initialize() inicia las tareas del sistema y crea los nodos fundamentales, como el nodo raíz y los que exponen el nombre y el autor de la aplicación.
  • syst->adoptApplication(*) asocia la aplicación, contenida en el objeto Eq7(), con el sistema. syst representa el objeto global del sistema.

Con el framework instanciado, se inicia la tarea de comunicación Bluetooth con VoidX Control, y como parámetro se pasa el nombre que se expondrá como identificador Bluetooth. Desde ahí quien desarrolla solo trabaja dentro de Eq7, la clase madre de la aplicación, que hereda de las superclases AudioBlock y Listener. De la primera hereda el manejo de audio y de la segunda el de eventos. El listado 2 describe el encabezado Eq7.h, y en el constructor se crean los nodos de la aplicación (listado 3).

Código fuente de la aplicación.
Encabezado de la clase Eq7.
Constructor de Eq7.

La estructura de nodos

Al comienzo se fijan los nodos del nombre y el autor de la aplicación, que se recuperan por su ruta, conocida de antemano dentro del árbol del sistema. Bajo el nodo app, hijo de root, se crean los nodos propios de la aplicación. Cada uno tiene un nombre de sistema (por ejemplo on_off) y un nombre visible (por ejemplo "Enable").

Los nodos onoff y mode son de tipo Enum, o sea, tienen un número finito de opciones. En este caso "ON"/"OFF" y "Mono"/"Stereo", con "OFF" y "Stereo" por defecto.

Los nodos band_level[*] y gain son de tipo Float y contienen un número real. Su rango va de -15 a +15 dB, con 0 por defecto y curva lineal. En las últimas líneas los nodos se agregan al motor de almacenamiento (Storage), así que su valor se conserva entre reinicios. Tras la inicialización, la estructura de nodos queda como en la figura 6.

Fig. 6. Estructura de nodos de una aplicación VoidX.

El árbol tiene como raíz el nodo root. Bajo sys están los nodos de sistema creados en system_initialize(), comunes a toda aplicación VoidX, y bajo app van los nodos propios de la aplicación. En la figura, los nodos Float aparecen en azul, los Enum en verde y los de otros tipos en amarillo. El framework permite modelar la información con mucha flexibilidad. Un sistema para guardar y recuperar presets, por ejemplo, se arma con solo instanciar los nodos adecuados.

La app VoidX Control

La representación de los nodos bajo sys no es exhaustiva. Hay otros elementos de menor peso por ahora, como el color principal de la aplicación, la versión o el identificador del dispositivo. La app VoidX Control recorre los nodos y genera una interfaz "semipersonalizada" en el celular o en el PC. La figura 7 muestra cómo se ve en un teléfono Android.

Las funciones de la clase Eq7

Las funciones heredadas por la clase Eq7 son cuatro.

  • exec(*), heredada de AudioBlock. Corre 3.000 veces por segundo con prioridad muy alta y procesa 16 muestras por vez a una frecuencia de muestreo de 48 kHz, lo que asegura un procesamiento de audio de latencia muy baja. Es ahí donde el código DSP tiene que correr de la forma más eficiente posible. El parámetro de entrada apunta al flujo de muestras de audio de entrada y salida (un arreglo de 2×16 floats).
  • compile(), heredada de AudioBlock. Corre en forma cíclica con prioridad media alta. Su tarea principal es traducir los parámetros del usuario, es decir, los valores de los nodos, a coeficientes de DSP. exec(*) no puede hacerlo directamente por razones de eficiencia.
  • onEvent(*), heredada de Listener. Se ejecuta cuando ocurre un evento, identificado por un número entero, y su función es manejar los eventos y actualizar el modelo interno.
  • draw(), heredada de Listener. Corre en forma cíclica con una prioridad menor que compile() y contiene el código de la interfaz de usuario.
Fig. 7. Control desde el celular o el PC con VoidX Control.

Visto como MVC (Modelo, Vista, Controlador), el modelo es la estructura de nodos, la vista la maneja draw() y el control queda en onEvent(*) y compile(). Quien desarrolla puede crear tareas adicionales, por ejemplo para implementar drivers nuevos, que se comunican con el framework VoidX mediante la lógica de eventos.