Skip to the content
2 layers65 × 70 mmViBravo September 2024, the printed circuit board in 3D

ViBravo September 2024

udellc/Vibrosonics6

Documentation (Doxygen) \ Hardware: Adafruit ESP32 Feather, MAX9744 Amplifier board, TT25-8 puck transducer, 3.5mm audio jack cable \ Dependencies: AudioLab · AudioPrism · Fast4ier

Size
65 × 70 mm
Copper layers
2
Thickness
1.6 mm
Parts
54
Nets
57
Pads
168
Tracks, vias
195, 46
Pours
1
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
18 Nov 2022
Updated
5 Jun 2026

Overview

ViBravo September 2024 is an open-source printed circuit board by udellc, from the udellc/Vibrosonics repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 65 × 70 mm with 54 parts on 57 nets, routed with 195 tracks and 46 vias.

It is built around the LMV358IDR, MAX7403CSA+ and MAX7480ESA+. Its parts include 19 resistors, 18 capacitors, 7 connectors and 4 ICs.

Main components

3

README

README.md

Vibrosonics

Experience audio through vibration

Vibrosonics is a real-time audio-to-haptics system with an interactive web interface that allows deaf, hard-of-hearing, and sensory-focused users feel sound through vibrarions.

Documentation (Doxygen)
Hardware: Adafruit ESP32 Feather, MAX9744 Amplifier board, TT25-8 puck transducer, 3.5mm audio jack cable
Dependencies: AudioLab · AudioPrism · Fast4ier

Table of Contents

Why Vibrosonics Matters

Millions of people experience barriers when it comes to audio-based media such as music, games, alerts, or live events. Vibrosoncis transforms those experiences by converting sound into meaningful tactile feedback.

Instead of hearing a beat, you feel it.

Built in collaboration with Cymaspace, an organization whose goal is to make culture and arts accessible for the deaf and hard-of-hearing community, Vibrosonics is designed to make music, entertainment, and environments more inclusive while also opening up new immersive experiences for everyone. This group makes up our primary audience, as haptic feedback can be used to replace or enhance audio. Some secondary users would be employers whose work environments make pure audio based communication difficult. They could instead receive important audio cues through haptics.

Key Features

Real-Time Audio Conversion Transforms live audio input directly into haptic vibration with minimal latency.

Configurable Settings Through Web Application A browser-based app allows users to adjust haptic feedback in real-time with no recompiling or device flashing required.

Frequency-Aware Feedback Different pitches and intensities map to distinct vibration patterns, preserving musical structure and adding depth.

Accessible by Design Built specifically for deaf and hard-of-hearing users, while also enhancing experiences for others.

View the most stable version on GitHub

Arduino Setup

1. Install Arduino IDE and ESP32 Board Support

  • Download Arduino IDE
  • Go to Tools > Boards > Boards Manager
  • Search and install esp32 by Espressif Systems

Installing the board manager

2. Set Board and Ports

  • Plug in the board (you may need to install USB drivers)
  • Go to the top drop down menu and click Select other board and port...
  • In the pop up window, search for Adafruit ESP32 Feather and select it along with COMX for port where X is a number 0-6
    • You may need to download a driver to see the port (Windows Tutorial)
    • On Linux, this is the ch341 driver

The other board and port drop down

3. Add Libraries

Navigate to the Arduino libraries folder. This is usually located in Documents/Arduino/libraries/ for Windows and ~/Arduino/libraries/ for Mac and Linux.

Clone the repositories into the libraries folder:

bash
cd "/path/to/Arduino/libraries/"
git clone https://github.com/synytsim/AudioLab.git
git clone https://github.com/udellc/AudioPrism.git
git clone https://github.com/jmerc77/Fast4ier.git

Verify that the libraries are installed by opening Arduino IDE and going to Sketch > Include Library > Manage Libraries.... You should see AudioLab, AudioPrism, and Fast4ier in the list.

4. Upload a Sketch

You should be ready to use the example sketches or create your own! To upload a sketch to the Vibrosonics hardware:

  • Plug in the ESP32 via USB
  • Open your own sketch or one of our examples from File > Examples > Vibrosonics > [Example Name]
  • Press the upload (➜) in the top left to compile and upload your sketch

Uploading a sketch to the arduino

Web Development Setup

1. Install Node.js and npm

  • Download and install Node.js through your prefered web browser. This will also install npm.

2. Install Dependencies

  • Open a terminal and navigate to the WebApp/ directory of the repository.

  • Run the following command to install the required dependencies:

bash
npm install

3. Start the Development Server

  • Run the following command to start the development server:
bash
# This will start the server and provide a local URL at localhost. Once the server is running,
npm run dev

# Opens the application in your default web browser.
o

# Manually restarts the server
r

# Stops the server
q

4. Additional Commands

Production Build: To build the application for production, run:

bash
# This will produce optimized files in the `dist/` directory
npm run build

# This will preview the production build locally
npm run preview

Run Linter Tool: To run ESLint for .js and .jsx files, run:

bash
# This will scan the target files for any syntax issues or potential bugs
npm run lint

# This will automatically fix any fixable issues found by ESLint
npm run lint.fix

5. Troubleshooting

If you encounter any issues during setup or development, consider the following steps:

  • Ensure that Node.js and npm are correctly installed by running node -v and npm -v in your terminal.
  • Check for any error messages in the terminal and refer to the documentation of the specific tools or libraries being used.
  • Make sure all dependencies are installed correctly by running npm ci for a clean install. If issues still persist, try deleting the node_modules/ directory and running npm install again.

ESP32 Web Server Setup

SD File System Setup: To deploy the WiFi web app onto the ESP32, we'll need to store the web app onto a micro SD card connected to the ESP32. View WebApp/main/fileSys.h for the pin connections, these directions assume that the pins are connected properly.

Note: Uploading the web app onto the SD card only needs to be done everytime a new build of the web app is needed.

1. Setup Upload Mode (Necessary if web app is not on the ESP32, otherwise skip)

  • Navigate to the WebApp/main/config.h file and uncomment the following line to setup the ESP32 in upload mode
cpp
#define DEV_MODE_EN
  • Build and upload main.ino in the ArduinoIDE once connected to a COM port.
  • Connect to the Wi-Fi access point on your device, name of the network is Vibrosonics-Dev.
  • Open a web browser and open http://vibrosonics/dev.
  • Enter the directory you want to write to and select the file to upload.
  • Click the upload button to write the file. Note: Open the Serial monitor in ArduinoIDE to view the files on the SD card.
  • Once successful, exit the web app, comment out the DEV_MODE_EN macro and rebuild and upload main.ino.

2. Connect to the Web App

  • Connect to the Wi-Fi access point on your device, name of the network is Vibrosonics-Unsecure.
  • Open a web browser and navigate to http://vibrosonics.
  • Follow the directions provided by the web app

Developer Notes

Library Architecture

The Vibrosonics library aims to streamline three processes to enable translating audio into the haptic range: audio signal processing, audio analysis and finally audio synthesis. We utilize a few libraries to achieve this.

The first is AudioLab, which handles the audio signals between the external hardware and the processor. It reads audio from the analog-to-digital converters (ADC) and writes signals to the digital-to-analog converters (DAC) for synthesis. The captured audio signals from the ADC are analyzed using the other two library dependencies.

Fast4ier is used to perform the Fast Fourier Transform (FFT) on the signal data, which converts it from a representation of the signal over time (time domain) to a representation of how the signal is distributed over a range of frequency bands (frequency domain). The bandwidth of the frequency domain, or the max frequency, is equal to half of the sample rate of the ADC. Similarly, the number of different frequency bands is equal to half of the window size of the ADC.

AudioPrism is a library which analyzes the frequency domain data using various algorithms. By filtering this data for different AudioPrism analysis modules, we can detect certain elements of the audio signal. With music, this allows us to detect percussion, isolate prominent vocals and melodies, and more. With this analysis, distinct vibrations can be made to model elements of music by re-synthesizing these findings through AudioLab translated down into the haptic frequency range (0-230Hz).

Web App Architecture

The VibroSonics application utilizes both cores on the ESP32 for efficient real-time audio processing and web-based configuration.

System Overview
  • Core 0: Handles the web server and HTTP request processing
  • Core 1: Runs the real-time audio analysis and haptic synthesis loop
Architecture Components
Frontend (Web App)
  • Framework: React/Preact application built with Vite
  • Location: Served from SD card on ESP32
  • Access: Available at http://vibrosonics when connected to the device's WiFi AP
  • Pages:
    • Landing page for global settings
    • Network configuration page
    • Analysis modules configuration page
  • Communication: Makes HTTP API calls to the ESP32 web server
Backend (ESP32 Web Server)
  • Server: WebServer library running on Core 0
  • Endpoints: RESTful API for configuration and real-time updates
  • Key Functions:
    • /network/*: WiFi network scanning and connection
    • /analysis/*: Audio analysis configuration management
    • File serving for static web assets
  • Rate Limiting: 500ms minimum interval for real-time setting updates
Inter-Core Communication
  • Mechanism: Thread-safe message queue via HapticSettings singleton
  • Flow:
    1. Web app sends HTTP request to ESP32 server
    2. Server parses request and creates QueueMessage
    3. Message added to queue in HapticSettings
    4. Audio loop (Core 1) checks for pending messages
    5. Messages processed to update AnalysisConfig
    6. Configuration changes applied to audio processing pipeline
Audio Analysis Loop (Core 1)
  • Real-time Processing: Continuous audio input → analysis → haptic output
  • Configuration: Uses shared AnalysisConfig updated via message queue
  • Modules: Dynamic analysis modules (percussion detection, frequency analysis, etc.)
  • Synthesis: Generates haptic feedback through AudioLab library
Data Flow
text
Web App (Browser) → HTTP Request → Web Server (Core 0) → Message Queue → Audio Loop (Core 1) → Haptic Output
Key Design Decisions
  • Dual-Core Utilization: Separates web serving from real-time audio processing for reliability
  • Message Queue: Thread-safe communication between cores without blocking
  • SD Card Storage: Web app files stored on SD card for easy updates
  • Rate Limiting: Prevents web interface from overwhelming the audio processing
  • Atomic Configuration Updates: Ensures consistent state during real-time processing

Web App Architecture Diagram

API Classes

  • VibrosonicsAPI: This is the core class; it is a unified interface for audio processing, analysis and synthesis
  • Grain, GrainList, and GrainNode: These are the components for granular synthesis. Grain is the main grain class, and the list and node classes provide a way to manage a linked list of grains.

Examples

We have an examples folder which contains individual programs that each showcase a different feature or technique possible using Vibrosonics and AudioPrism.

  • Start with the Template example to see basic use of the API and for a starting point for your own program.
  • The Grains example demonstrates using the provided classes for granular synthesis with a frequency and amplitude sweep, duration changes and wave shape variations.
  • Percussion showcases our current percussion detection method, which uses a specially filtered frequency domain representation as input for an AudioPrism percussion module. It utilizes grains to create haptic feedback corresponding to the detected percussive hits.
  • Melody is a similar example of strategic frequency domain processing, but to bring out melodic elements of music. These elements are resynthesized by translating the most prominent frequency peaks into the haptic range.
  • Vibrosonics is our example demonstrating a combination of multiple techniques (Percussion and Melody) to provide a real-time translation of music to tactile feedback. Look here for an in-depth example utilizing the full capabilities of our library.

Contributors

2025-26 Software Team

2024-25 Software Team

LinkedIn Pages

Special Thanks

  • Dr. Chet Udell (Project leader and manager)
  • Nick Synytsia (Developed AudioLab and advised software development for 2024-25)
  • Alex Synytsia (Participated in hardware development during 2022-23)
  • Vincent Vaughn (Advised software and hardware development)
  • Hans Bestel (Project manager for software and hardware development during 2025-26)

Parts

54
QtyValueFootprintReferences
1010kResistor_SMD:R_1206_3216MetricR1, R2, R3, R4, R7, R8, R12, R13, R18, R19
70.1uFCapacitor_SMD:C_0805_2012MetricC3, C4, C12, C13, C15, C16, C18
710uFCapacitor_SMD:C_0805_2012MetricC1, C2, C6, C7, C8, C10, C11
4Screw_Terminal_01x03TerminalBlock_TE-Connectivity:TerminalBlock_TE_282834-3_1x03_P2.54mm_HorizontalJ1, J3, J4, J8
21.5kResistor_SMD:R_1206_3216MetricR16, R17
23.3kResistor_SMD:R_1206_3216MetricR14, R15
2LMV358IDRfootprints:21-0041B_8_MXMIC1, IC3
1100nFCapacitor_SMD:C_0805_2012MetricC9
1100pFCapacitor_SMD:C_0805_2012MetricC5
1150Resistor_SMD:R_1206_3216MetricR11
122kResistor_SMD:R_1206_3216MetricR9
15kResistor_SMD:R_1206_3216MetricR6
16.2kResistor_SMD:R_1206_3216MetricR10
16.8nFCapacitor_SMD:C_0805_2012MetricC14
17.5kResistor_SMD:R_1206_3216MetricR5
1C_PolarizedCapacitor_THT:CP_Radial_D8.0mm_P3.50mmC17
1Conn_01x12_SocketConnector_PinSocket_2.54mm:PinSocket_1x12_P2.54mm_VerticalJ7
1Conn_01x16_SocketConnector_PinSocket_2.54mm:PinSocket_1x16_P2.54mm_VerticalJ6
1MAX7403CSA+footprints:21-0041B_8_MXMIC2
1MAX7480ESA+MAX7403CSA:21-0041B_8_MXMIC4
1Screw_Terminal_01x02TerminalBlock_TE-Connectivity:TerminalBlock_TE_282834-2_1x02_P2.54mm_HorizontalJ5
1Screw_Terminal_01x04TerminalBlock_TE-Connectivity:TerminalBlock_TE_282834-4_1x04_P2.54mm_HorizontalAUD_OUT
1~adafruit_1660_microsd:CONN_1660_ADASD1

The 50 most common of 54 parts.

More from udellc/Vibrosonics

1
  • 2 layers65 × 70 mmAudioLux, the printed circuit board in 3D

    AudioLux

    udellc/Vibrosonics

    Documentation (Doxygen) \ Hardware: Adafruit ESP32 Feather, MAX9744 Amplifier board, TT25-8 puck transducer, 3.5mm audio jack cable \ Dependencies: AudioLab · AudioPrism · Fast4ier

    41 parts6GPL-3.0

Similar boards

  • 2 layers93.6 × 55 mmNeurolab, the printed circuit board in 3D

    Neurolab

    fossasia/neurolab-hardware

    Neurolab Hardware

    174 parts1.6kApache-2.0
  • 2 layers100 × 100 mmZxevo1010 main, the printed circuit board in 3D

    Zxevo1010 main

    UzixLS/zxevo1010-board

    10x10cm PCB variant of ZX-Evolution project for G738/G706 enclosure

    252 parts26
  • 2 layers100 × 100 mmZxuno1010, the printed circuit board in 3D

    Zxuno1010

    UzixLS/zxuno1010-board

    10x10cm PCB variant of ZX-UNO project for G738/G706 enclosure

    233 parts23MIT
  • 4 layers99.2 × 94.2 mmESP32 ind EVB V3, the printed circuit board in 3D

    ESP32 ind EVB V3

    gmarocco/ESP32indEVB

    ESP32indEVB

    271 parts4
  • 2 layers83.8 × 61 mmModule, the printed circuit board in 3D

    Module

    KAVIRAJec/Smart-Water-Quaity-Measurement-Kit

    🚰 Smart Water Quality Monitoring System Real-time insights into drinking water quality! This repository contains the code and documentation for our innovative water quality monitoring system.

    93 parts2
  • 2 layers93.5 × 61 mm01232330B, the printed circuit board in 3D

    01232330B

    JUSTICE2330/Arduino-uno-PCB

    61 parts
  • 2 layers100 × 125 mmDSP Regulator RevC, the printed circuit board in 3D

    DSP Regulator RevC

    Phil-CIA/Development-Station-Power-Supply

    3 channel bench supply with current and voltage plotting

    235 parts

Questions

How big is the ViBravo September 2024 PCB?

It measures 65 × 70 mm and has 2 copper layers, 1.6 mm thick.

What parts does the ViBravo September 2024 use?

54 parts, built around the LMV358IDR, MAX7403CSA+ and MAX7480ESA+. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the ViBravo September 2024 KiCad files?

From the udellc/Vibrosonics repository on GitHub, at the commit this page was made from: the board is schematics/ViBravo_September_2024/ViBravo_September_2024.kicad_pcb and its schematic fmRadio/FMRadio Schematic/FMRadio Schematic.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the ViBravo September 2024 design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).