SUPPORT / PROTOTYPE GUIDE

Set up.
Then play.

A demonstration guide for teachers and team members: connect, lower the volume, complete a note, and finish with care.

For the current Xunova_Audio firmware and companion Xunova_BLE.html. Check the installed version first. This is not a manual for independent use by children or a production product.

FIRST, EVERY TIME YOU POWER ON

Lower the volume.

The current firmware starts at the maximum volume, 30/30, and does not save volume settings. After connecting, move the Fingering Guide volume slider (0–100) fully left, then let a teacher raise it slowly to a low level before any playback or blowing. The console’s 0–30 scale controls the same volume.

01 / CONNECT & PREPARE

Make the connection.

Check the mouthpiece, wiring and touch contacts, and identify how this unit is actually powered off. Do not assume the side button is a power switch; unplugging USB may not turn off a battery-powered unit.

PRIMARY / BLUETOOTH WEB CONTROL

Connect from the companion page.

Power on with hands off the contacts, no blowing and an unobstructed air path, so the pressure sensor can zero.
Open the companion Xunova_BLE.html in a verified compatible browser. Click Connect and select Xunova in the device picker.
Open Fingering Guide, check touch and pressure readings, and lower the volume before starting.

BLE carries controls and status; this is not a Bluetooth speaker connection. Web Bluetooth requires a compatible browser, a secure context and user permission. Do not assume every phone supports it.

ALTERNATIVE / DEVICE WI-FI

Join the prototype’s network.

Join ESP32_MPR121. The current prototype password is 12345678; this demonstration configuration is not intended for public deployment.
Stay connected even if the network has no internet access. Enter 192.168.4.1 in the browser for the console; Fingering Guide is at /guide.
Check the readings and lower the volume. Use one operator and one control page at a time to avoid conflicting commands.

These addresses work only while connected to the device hotspot. Prefer Wi-Fi for bulk sample uploads. Do not share an untreated mouthpiece between users.

02 / YOUR FIRST NOTE

Begin with C5.

This example uses electrodes E1 and E6. Locate them using the numbering of the actual prototype, not an assumed left-to-right order.

01 / SELECT & TOUCH

Choose, then follow the cue.

Select C5 in Fingering Guide. Without blowing, touch only E1 and E6 and release every other electrode. Selecting a target does not automatically demonstrate its sound.

02 / REST, THEN BLOW

Match the fingering. Add a breath.

Let the pressure settle, then blow gently. Exact fingering and pressure above the threshold turn off the target lights and request playback. Verify that the correct note is actually heard; lights alone do not confirm audio.

03 / SELECT AGAIN

A new task for each guided note.

To play C5 again in single-note guidance, select C5 again, rest, then blow. Resting and blowing alone does not restart the task. Songs load the next repeated note automatically, but still require a fresh breath.

The breath threshold defaults to 30 Pa and can be adjusted from 5–200 Pa. Start gently; do not keep increasing effort to force a trigger. The firmware uses absolute pressure difference, so inhaling can also trigger it; demonstrations should use blowing only.

03 / SONGS & SOUNDS

A score sets the notes.
A sample sets the sound.

MIDI describes pitches and timing; WAV contains recorded sound. They serve different purposes. Prepare material before the demonstration and begin with a short task.

How do I import a MIDI song?

Choose a .mid file in the device’s Score Converter (/convert). Prefer a single melody and check that the converted notes fit G3–D5.
Check note order, count and repetitions. Preserve rest entries where needed and inspect the preview. Complex polyphonic files may not become suitable practice material automatically.
Use a name of up to 32 characters with letters, numbers, underscores or hyphens. Save to ESP32 and check the stored name. Keep needed songs before overwriting a duplicate, and use appropriately licensed or public-domain material.

How does cumulative practice progress?

Set an increment, for example N=4. The first round plays the first 4 notes, the next starts from the beginning and plays 8, then 12. It does not skip to a new block of 4. Rest between rounds and choose Next round, Repeat this round or finish. Self-paced practice waits for each note; rhythm performance uses timing windows.

How do I replace the 20 pitch samples?

Back up the originals and stop practice and playback first. Files 01–20 map to 20 consecutive semitones from G3–D5; each replaces one pitch slot. These are not 20 sound banks, and one recording does not automatically generate all pitches.

Prefer Wi-Fi. Select files in the console’s Samples area, inspect the conversion, then upload. The device accepts 16 kHz, mono, 16-bit PCM WAV, up to 86,000 bytes per file. The browser can convert decodable formats, but check compatibility and pitch manually. An already compliant WAV may be uploaded unchanged, even when automatic tuning is selected.

Upload missing can also replace slots whose size or checksum differs from local files; upload all rewrites the selected slots. Do not play, change settings or power off during upload. Afterwards, check each pitch, volume, noise and source licence.

04 / FINISH THE SESSION

Stop the mode. Stop the audio.
Then disconnect.

Stop blowing. In Fingering Guide, use Stop practice, Stop performance or Stop free play for the active mode. Stop practice also clears an unfinished single-note target.
Go to the console and press Stop to end song playback, residual audio or test notes.
Check that target lights are off and sound has stopped, then disconnect Bluetooth or close the page. A teacher should use the verified power-off method before putting the unit away.

Closing the page or disconnecting Bluetooth does not automatically stop the device. Muting alone does not exit a practice mode. If the page cannot respond, a teacher should turn off the verified power supply without altering internal wiring while powered.

COMMON QUESTIONS

A few useful checks.

Try the web illustration ↗

What if the browser cannot find Xunova?

Check Bluetooth, browser compatibility and page permissions. Close connections from other devices and wait for advertising. Do not disable browser security; use a configured localhost / HTTPS entry or the device’s Wi-Fi if the Bluetooth page is restricted. Web Bluetooth is not supported by every phone browser.

The lights are on, but the task will not complete. What should I check?

Check for extra or missing touches, rest before blowing again, and inspect sensor readings and the threshold. Select the note again to restart a single-note task. D5 requires all electrodes released, so no target lights is normal for that note.

The lights went out but there is no sound. Did it work?

A complete success is not yet confirmed. Check volume, the relevant sample slot and audio state. A teacher can use a low-volume test note to check the sample, amplifier and speaker. A sent command or playback request does not prove that audible sound occurred.

Does this website control the device or store learning records?

No. The website interaction is a silent illustration and does not access Bluetooth or a microphone. Use the firmware’s companion page for device control. The current version has no per-student accounts, long-term progress records or cloud sync.

Set up.Then play.