Skip to the content
2 layers86 × 70 mmBasetta pedale, the printed circuit board in 3D

App personale per controllare e organizzare i preset di un Positive Grid Spark 2 via Bluetooth, dal browser. Più un pedale ESP32 che fa lo stesso col piede.

Size
86 × 70 mm
Copper layers
2
Thickness
1.6 mm
Parts
34
Nets
40
Pads
123
Tracks, vias
337, 67
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
12 Aug 2026
Updated
5 Nov 2026

Overview

Basetta pedale is an open-source printed circuit board by mazzrelaz, from the mazzrelaz/SparklingTones repository on GitHub. It is a 2-layer board of 86 × 70 mm with 34 parts on 40 nets, routed with 337 tracks and 67 vias.

It is built around the MCP23017-E/SS. Its parts include 15 resistors, 11 connectors, 2 capacitors and 2 ICs. It belongs with the ESP32 boards of this library.

Main components

1

README

README.md

SparklingTones

Italiano · English

App personale per controllare e organizzare i preset di un Positive Grid Spark 2 via Bluetooth, dal browser. Più un pedale ESP32 che fa lo stesso col piede.

→ mazzrelaz.github.io/SparklingTones · guida all'uso (anche dentro l'app: menu ⋯ → Guida)

Progetto personale, in pausa. È nato per risolvere un problema mio e funziona sul mio ampli. Il protocollo dello Spark 2 non è documentato da nessuna parte: qui è stato ricostruito osservando, misurando e verificando sull'hardware. Se stai cercando quello, la parte che ti serve è in docs/ — vedi in fondo.

L'app è in italiano e in inglese (la lingua si sceglie nel pannello «Altro»). La documentazione tecnica è in italiano, tranne il protocollo, che c'è anche in inglese.


Cosa fa

Organizza la libreria. Lo Spark 2 tiene otto preset alla volta; l'app tiene tutti quelli che vuoi, con nome, categorie, note e famiglia di suono, in un database nel browser. Legge i preset dall'ampli, importa il preset_backup.zip dell'app ufficiale, esporta e reimporta in JSON.

Suona. Una vista Live con banchi da otto pulsantoni grandi, pensata per essere usata mentre si suona invece che per catalogare. Un preset già caricato sull'ampli si attiva all'istante; uno che non c'è viene trasmesso per intero in circa un secondo.

Regola. Un editor della catena effetti che agisce sul suono che sta suonando: le manopole si muovono e l'ampli risponde. Legge sempre lo stato vero dall'ampli prima di aprirsi, perché la verità è lì e non nella libreria.

Funziona senza rete. È una PWA: installata, si apre e funziona anche offline — a un concerto la rete non c'è.

Cosa serve

Un browser con Web Bluetooth: Chrome o Edge su computer e Android. Su iPhone e iPad serve Bluefy («Bluefy – Web BLE Browser» nell'App Store), un browser gratuito che Web Bluetooth ce l'ha: Safari e gli altri no, perché su iOS ogni browser è obbligato a usare il motore di Apple. Provato su iPhone e iPad: va tutto. La libreria che sta in Safari non passa da sola in Bluefy: si esporta e si reimporta.

Niente altro. Niente account, niente server: la libreria sta nel tuo browser e non esce di lì.

Farlo girare

Non c'è niente da compilare e niente da installare.

text
git clone https://github.com/mazzrelaz/SparklingTones.git

Poi apri index.html con un doppio clic. Funziona da file:// — per questo i moduli sono classic script e non ES module.

Attenzione a una cosa: file:// e https:// sono due origini diverse, quindi due database diversi. La libreria non passa dall'una all'altra da sola: si esporta in JSON e si reimporta.

Il pedale

In pedale/ c'è il firmware per un ESP32-C3: prende i banchi dall'app via Bluetooth, se li tiene in memoria e poi è autonomo — si collega da solo all'ampli e cambia preset col piede, senza telefono.

Verificato sull'hardware, su una schedina nuda senza saldature:

misurato
un preset intero, intervallo di connessione di sistema1246 ms
lo stesso, chiedendo 7,5 ms326 ms
a regime178–215 ms

Il secondo che ci mette il telefono non è banda: sono sedici round-trip BLE. Web Bluetooth non lascia toccare l'intervallo di connessione, NimBLE sull'ESP32 sì, ed è tutta la differenza.

Il firmware non serializza niente. L'app produce i frame già pronti e il pedale corregge un byte solo — il sequence number, che il checksum non copre. L'encoder resta uno solo, in JavaScript, coperto dai test.

Il pedale è a metà: funziona su una devkit, l'hardware vero (cinque footswitch, due tasti, LED, display) non è ancora stato costruito. tools/pedale-sim.html ne simula la faccia in una pagina, con dentro la logica vera.

Il protocollo — la parte utile a qualcun altro

Questa è probabilmente la ragione per cui sei qui. Tutto in docs/protocollo-spark2.md, e le trappole più costose sono riassunte in CLAUDE.md.

GATT: service 0xFFC0, write 0xFFC1 (solo write without response), notify 0xFFC2. Messaggi F0 01 <seq> <checksum> <cmd> <sub> <dati impacchettati> F7, con i dati codificati 7/8 bit e i float in big endian.

Quello che è costato di più scoprire:

  • I comandi sugli effetti vogliono un byte 0x00 in coda. Senza, l'ampli risponde con un ack regolare e non applica il comando. Non è documentato da nessuna fonte, ed è una differenza dello Spark 2.
  • Chunk da 25 byte, non 128. Con 128 lo Spark 2 si disconnette.
  • Tutti i chunk di un preset vanno con lo stesso sequence number, altrimenti l'ampli li conferma tutti senza assemblarne nessuno.
  • 0x0127 non salva sullo Spark 2, in nessuna delle forme provate.
  • Far suonare un preset e salvarlo in uno slot sono due strade diverse, e la seconda vuole un giro via-e-ritorno che sembra decorazione e non lo è.
  • L'ack conferma la ricezione, non l'esecuzione. E writeWithoutResponse fa sembrare riuscita ogni scrittura: l'assenza di errori non è una verifica.

Il looper si comanda (0x0175), tranne la battuta di conteggio col click: quella è un'indagine chiusa, e tutto ciò che è stato escluso sta in docs/looper.md, così nessuno ripercorre sette strade già chiuse.

Le catture grezze dall'ampli sono in captures/.

Test

Aprire le pagine in test/. Girano contro catture reali dell'ampli, quindi intercettano una regressione nella codifica senza avere l'hardware a portata.

protocol-test.html125 test — encoder e decoder, round-trip byte per byte
transport-test.html48 test — coda di invio e riassemblaggio
store-test.html99 test — libreria, banchi, categorie
backup-test.html33 test — lettura dello zip dell'app ufficiale

Avvertenze

Scrivere in uno slot dell'ampli non si torna indietro. Quello che c'era prima è perso.

L'ampli si può piantare, e allora serve staccare la corrente. Succede coi comandi pesanti — ricostruire un blocco DSP, o girare le manopole più in fretta di quanto la radio riesca a portare.

L'elenco dei modelli di effetto non è verificato: viene da un catalogo di terzi, e chiedere all'ampli un modello che non ha è uno dei modi per piantarlo. L'app distingue quelli che ha visto uscire dal tuo ampli da quelli solo supposti.

Provato su un solo Spark 2. Con un altro esemplare, o un altro firmware, non so cosa succede.

Licenza e riconoscimenti

MIT, Massimo Togni. Vedi LICENSE e NOTICE.

  • I nomi di effetti e manopole vengono dal catalogo di Soundshed (MIT).
  • Il riferimento per il protocollo BLE è paulhamsh/Spark (Apache 2.0), i cui sorgenti stanno in reference/.
  • Ignitron di stangreg è un pedale ESP32 per lo Spark, ed è da lì che vengono i comandi del looper.

Nessun rapporto con Positive Grid Inc. Non è un prodotto ufficiale, non è approvato né supportato, e non usa loro codice. «Spark» e «Positive Grid» sono citati solo per dire con cosa funziona.

Parts

34
QtyValueFootprintReferences
6330R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR6, R7, R8, R10, R12, R14
4560R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR9, R11, R13, R15
4MountingHole_3.2mm_M3MountingHole_3.2mm_M3H1, H2, H3, H4
2100kR_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR4, R5
24k7R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR1, R2
1100nC_Disc_D5.0mm_W2.5mm_P2.50mmC1
110kR_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR3
110uCP_Radial_D5.0mm_P2.00mmC2
1BATJ8
1J1JST_XH_B5B-XH-A_1x05_P2.50mm_VerticalJ1
1J10PinHeader_1x08_P2.54mm_VerticalJ10
1J11JST_XH_B4B-XH-A_1x04_P2.50mm_VerticalJ11
1J2JST_XH_B4B-XH-A_1x04_P2.50mm_VerticalJ2
1J3JST_XH_B5B-XH-A_1x05_P2.50mm_VerticalJ3
1J4JST_XH_B5B-XH-A_1x05_P2.50mm_VerticalJ4
1J5JST_XH_B4B-XH-A_1x04_P2.50mm_VerticalJ5
1J6JST_XH_B2B-XH-A_1x02_P2.50mm_VerticalJ6
1J7JST_XH_B2B-XH-A_1x02_P2.50mm_VerticalJ7
1J9TerminalBlock_Phoenix_MKDS-1,5-2-5.08_1x02_P5.08mm_HorizontalJ9
1MCP23017DIP-28_W7.62mm_SocketU2
1XIAO ESP32-S3U1

More from mazzrelaz/SparklingTones

1
  • 2 layers95 × 60 mmPedale spark, the printed circuit board in 3D

    Pedale spark

    mazzrelaz/SparklingTones

    App personale per controllare e organizzare i preset di un Positive Grid Spark 2 via Bluetooth, dal browser. Più un pedale ESP32 che fa lo stesso col piede.

    19 parts2

Similar boards

  • 2 layers126.6 × 21.4 mmADBv2, the printed circuit board in 3D

    ADBv2

    mattchesters/zmk-apple-desktop-bus-keyboard

    ZMK shield for Apple Desktop Bus Keyboard

    17 parts168MIT
  • 2 layers40 × 100 mmBack pcb, the printed circuit board in 3D

    Back pcb

    ZeroPhone/ZeroPhone-PCBs

    PCB files for ZeroPhone - for gerbers and schematics, go to "Releases" tab!

    118 parts148GPL-3.0
  • 2 layers182.8 × 158.9 mmErgoDone, the printed circuit board in 3D

    ErgoDone

    ktec-hq/ErgoDone

    ErgoDox using pro micro. Original work by Dox. Brainhole association present

    152 parts123GPL-3.0
  • 2 layers100 × 100 mmWifi PB panel, the printed circuit board in 3D

    Wifi PB panel

    AntonioMR/Wifi-Play-Board

    Placa de experimentacion para el ESP12F (ESP8266)

    416 parts29
  • 2 layers137.5 × 78.5 mmCntrlr Turnout, the printed circuit board in 3D

    Cntrlr Turnout

    djbristow/RAILS

    RAILS is a software model and implementation of an automated system to assist the model railroader achieve realism in the operation of a model railroad. The model then drives the development of software.

    12 parts19
  • 2 layers176 × 82.6 mmHotAirGun, the printed circuit board in 3D

    HotAirGun

    raspibo/HotAirGun

    Hot Air Gun File, 3D, Sch, Pcb, C

    78 parts16
  • 2 layers115 × 57.2 mmTeensyBoardZ80, the printed circuit board in 3D

    TeensyBoardZ80

    mecparts/TeensyBoardZ80

    A Teensy 4.0 emulated Z80 ZCPR3.3/ZSDOS computer.

    42 parts13MIT
  • 2 layers100 × 49.7 mmNano PB, the printed circuit board in 3D

    Nano PB

    AntonioMR/Nano-Play-Board

    Placa para experimentar con el Arduino Nano

    142 parts12

Questions

How big is the Basetta pedale PCB?

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

What parts does the Basetta pedale use?

34 parts, built around the MCP23017-E/SS. 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 Basetta pedale KiCad files?

From the mazzrelaz/SparklingTones repository on GitHub, at the commit this page was made from: the board is pcb/basetta/basetta-pedale.kicad_pcb and its schematic pcb/pedale-spark.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Basetta pedale design in my own project?

Its repository states no licence, so its author keeps all rights: ask mazzrelaz before reusing the design.