Skip to content

acf1210/TUSB

Repository files navigation

TUSB logo

TUSB - ToneX One USB Controller

Controle Android nativo via USB-C para ToneX One.
Native Android USB-C controller for ToneX One.
Controlador Android nativo por USB-C para ToneX One.

version platform license status

🇧🇷 Português Brasil  |  🇺🇸 English US  |  🇪🇸 Español


📦 APK V1.0.4 / VirusTotal

🇧🇷 Português Brasil

Baixe o APK oficial da release: 👉 TUSB-v1.0.4.apk

Verificação VirusTotal: 0 malicioso, 0 suspeito, 67 não detectado, 6 não suportado SHA-256: 1E9BA58AA027165C32169A53794287FEA883C3CBF4E923710BC354827A0D16F6 Relatório: VirusTotal · VIRUSTOTAL.md

Regra para novas versões: toda nova release com APK deve atualizar o VirusTotal automaticamente via release automation.

🇺🇸 English US

Download the official release APK: 👉 TUSB-v1.0.4.apk

VirusTotal scan: 0 malicious, 0 suspicious, 67 undetected, 6 unsupported SHA-256: 1E9BA58AA027165C32169A53794287FEA883C3CBF4E923710BC354827A0D16F6 Report: VirusTotal · VIRUSTOTAL.md

Rule for new versions: every new release with an APK must update VirusTotal automatically via release automation.

🇪🇸 Español

Descarga el APK oficial de la release: 👉 TUSB-v1.0.4.apk

Verificación VirusTotal: 0 malicioso, 0 sospechoso, 67 no detectado, 6 no soportado SHA-256: 1E9BA58AA027165C32169A53794287FEA883C3CBF4E923710BC354827A0D16F6 Informe: VirusTotal · VIRUSTOTAL.md

Regla para nuevas versiones: cada nueva release con APK debe actualizar VirusTotal automáticamente mediante release automation.


Connection screen Editor Presets Effect detail Menu


🇧🇷 Português Brasil

Destaques da V1.0.4

  • Seletor de modo do CAB no detalhe do efeito: Tone Model, VIR e Off.
  • Cadeia de efeitos respeita a posição Pre/Post dos blocos mapeados.
  • Temas locais Classic, Stage e Ocean no Menu.
  • Correções de sincronização de estado para bypass, modo do pedal e parâmetros do preset.

Destaques da V1.0.3

  • Editor TUSB redesenhado com knobs pretos 3D, fundo escuro texturizado e cadeia de efeitos visual.
  • Controles reais de amp/efeitos validados no ToneX One: Gain, EQ, Volume, toggles e detalhes de efeito via 0x0309.
  • Volume do Editor ajustado para o parametro capturado no hardware (paramIndex=8) e serial/FW completos na barra superior.
  • Presets com personalizacao local de amp/cab e telas Connect, Editor, Presets e Detalhe alinhadas ao novo visual.

Destaques da V1.0.2

  • Suporte a footswitches MIDI por Bluetooth LE (M-Vave Chocolate e similares) e USB MIDI (via hub OTG).
  • Mapa padrão pronto para uso: Program Change 0–19 carrega os presets 1–20 e CCs controlam slots, bypass, efeitos da cadeia e knobs do amp.
  • MIDI Learn para remapear qualquer ação direto no app (Menu → MIDI).

Destaques da V1.0.1

  • Idioma automático para Português Brasil, Inglês EUA e Espanhol.
  • Afinador completo por microfone, com leitura de cents e atalhos para Standard, Drop D, meio tom abaixo, D Standard, Open G e DADGAD.
  • Nota de conexão inicial destacada no app: coloque o ToneX One em modo Stomp e pressione o pedal três vezes para conectar.
  • Nota em destaque: versão para iOS em desenvolvimento. Em breve.
  • Documentação de instalação e uso em três idiomas.

O que é

O TUSB é um app Android comunitário que conecta diretamente ao ToneX One por cabo USB-C OTG. Ele usa comunicação serial USB nativa para editar presets, alternar slots, controlar efeitos e manter o app sincronizado com o pedal em tempo real.

Recursos

  • Conexão USB-C direta, sem Bluetooth e sem computador.
  • Troca de preset e slot A/B/C.
  • Alternância entre modo A/B e modo Stomp.
  • Bypass geral e bypass IR/Cab.
  • Knobs de amplificador em tempo real.
  • Cadeia de efeitos editável: Gate, Compressor, EQ, Mod, Delay, Reverb e Cab.
  • Metrônomo local.
  • Afinador por microfone com afinações comuns.
  • Controle por footswitch MIDI (BLE e USB) com MIDI Learn.
  • Captura JSONL para diagnóstico.

Instalação e uso

Build local

git clone https://github.com/acf1210/TUSB.git
cd TUSB
./gradlew assembleDebug
./gradlew test

O APK debug fica em app/build/outputs/apk/debug/app-debug.apk.


🇺🇸 English US

V1.0.4 highlights

  • CAB mode selector in the effect detail screen: Tone Model, VIR, and Off.
  • Effect chain now follows mapped Pre/Post block positions.
  • Local Classic, Stage, and Ocean themes in Menu.
  • State synchronization fixes for bypass, pedal mode, and preset parameters.

V1.0.3 highlights

  • TUSB editor redesign with black 3D knobs, darker textured background, and visual effect chain.
  • Real ToneX One amp/effect controls validated on hardware: Gain, EQ, Volume, toggles, and effect details over 0x0309.
  • Editor Volume mapped to the hardware-captured parameter (paramIndex=8) and full serial/FW display in the top bar.
  • Local amp/cab preset customization and Connect, Editor, Presets, and Effect Detail screens aligned with the new look.

V1.0.2 highlights

  • MIDI footswitch support over Bluetooth LE (M-Vave Chocolate and similar) and USB MIDI (through an OTG hub).
  • Ready-to-use default map: Program Change 0–19 loads presets 1–20 and CCs control slots, bypass, effect chain blocks, and amp knobs.
  • MIDI Learn to remap any action right in the app (Menu → MIDI).

V1.0.1 highlights

  • Automatic language support for Brazilian Portuguese, US English, and Spanish.
  • Full microphone tuner with cents reading and shortcuts for Standard, Drop D, half-step down, D Standard, Open G, and DADGAD.
  • Highlighted initial connection note in the app: put ToneX One in Stomp mode and press the pedal three times to connect.
  • Highlighted note: iOS version in development. Coming soon.
  • Install and user guides in three languages.

What it is

TUSB is a community Android app that connects directly to ToneX One over a USB-C OTG cable. It uses native USB serial communication to edit presets, switch slots, control effects, and keep the app synchronized with the pedal in real time.

Features

  • Direct USB-C connection, no Bluetooth and no computer required.
  • Preset and A/B/C slot switching.
  • A/B and Stomp mode switching.
  • Global bypass and IR/Cab bypass.
  • Real-time amp knobs.
  • Editable effect chain: Gate, Compressor, EQ, Mod, Delay, Reverb, and Cab.
  • Local metronome.
  • Microphone tuner with common tunings.
  • MIDI footswitch control (BLE and USB) with MIDI Learn.
  • JSONL capture for diagnostics.

Install and use

Local build

git clone https://github.com/acf1210/TUSB.git
cd TUSB
./gradlew assembleDebug
./gradlew test

The debug APK is generated at app/build/outputs/apk/debug/app-debug.apk.


🇪🇸 Español

Novedades de la V1.0.4

  • Selector de modo CAB en el detalle del efecto: Tone Model, VIR y Off.
  • La cadena de efectos respeta las posiciones Pre/Post de los bloques mapeados.
  • Temas locales Classic, Stage y Ocean en el Menu.
  • Correcciones de sincronizacion de estado para bypass, modo del pedal y parametros del preset.

Novedades de la V1.0.3

  • Editor TUSB redisenado con knobs negros 3D, fondo oscuro texturizado y cadena visual de efectos.
  • Controles reales de amp/efectos validados en ToneX One: Gain, EQ, Volume, toggles y detalle de efectos via 0x0309.
  • Volume del Editor ajustado al parametro capturado en hardware (paramIndex=8) y serial/FW completos en la barra superior.
  • Personalizacion local de amp/cab por preset y pantallas Connect, Editor, Presets y Detalle de Efecto alineadas al nuevo visual.

Novedades de la V1.0.2

  • Soporte de footswitches MIDI por Bluetooth LE (M-Vave Chocolate y similares) y USB MIDI (mediante hub OTG).
  • Mapa por defecto listo para usar: Program Change 0–19 carga los presets 1–20 y los CCs controlan slots, bypass, bloques de efectos y knobs del amplificador.
  • MIDI Learn para reasignar cualquier acción directamente en la app (Menú → MIDI).

Novedades de la V1.0.1

  • Idioma automático para Portugués Brasil, Inglés EUA y Español.
  • Afinador completo por micrófono, con lectura de cents y accesos rápidos para Standard, Drop D, medio tono abajo, D Standard, Open G y DADGAD.
  • Nota destacada de conexión inicial en la app: pon el ToneX One en modo Stomp y presiona el pedal tres veces para conectar.
  • Nota destacada: versión para iOS en desarrollo. Próximamente.
  • Guías de instalación y uso en tres idiomas.

Qué es

TUSB es una app Android comunitaria que se conecta directamente al ToneX One con un cable USB-C OTG. Usa comunicación serial USB nativa para editar presets, cambiar slots, controlar efectos y mantener la app sincronizada con el pedal en tiempo real.

Funciones

  • Conexión USB-C directa, sin Bluetooth y sin ordenador.
  • Cambio de preset y slots A/B/C.
  • Cambio entre modo A/B y modo Stomp.
  • Bypass general y bypass IR/Cab.
  • Knobs de amplificador en tiempo real.
  • Cadena de efectos editable: Gate, Compressor, EQ, Mod, Delay, Reverb y Cab.
  • Metrónomo local.
  • Afinador por micrófono con afinaciones comunes.
  • Control por footswitch MIDI (BLE y USB) con MIDI Learn.
  • Captura JSONL para diagnóstico.

Instalación y uso

Build local

git clone https://github.com/acf1210/TUSB.git
cd TUSB
./gradlew assembleDebug
./gradlew test

El APK debug se genera en app/build/outputs/apk/debug/app-debug.apk.


Créditos e fontes / Credits and sources / Créditos y fuentes

🇧🇷 Português Brasil

Este projeto foi construído de forma independente e validado de maneira cruzada contra projetos open-source da comunidade. Agradecemos às seguintes fontes:

  • vit3k/tonex_controller — firmware ESP32 open-source usado como referência para validar o framing HDLC/CRC e os offsets de slot/preset.
  • Builty/TonexOneController — firmware ESP32 open-source; segunda validação independente do protocolo (Hello/wake, RequestState, baud 115200) e tabela de ranges de parâmetros (tonex_params.c).
  • Android MIDI API (android.media.midi) e a especificação BLE MIDI da MIDI Association para o suporte a footswitches na V1.0.2.

🇺🇸 English US

This project was built independently and cross-validated against community open-source projects. We thank the following sources:

  • vit3k/tonex_controller — open-source ESP32 firmware used as a reference to validate HDLC/CRC framing and slot/preset offsets.
  • Builty/TonexOneController — open-source ESP32 firmware; a second independent validation of the protocol (Hello/wake, RequestState, baud 115200) and parameter-range table (tonex_params.c).
  • Android MIDI API (android.media.midi) and the MIDI Association BLE MIDI specification for the V1.0.2 footswitch support.

🇪🇸 Español

Este proyecto se construyó de forma independiente y se validó de forma cruzada contra proyectos open-source de la comunidad. Agradecemos a las siguientes fuentes:

  • vit3k/tonex_controller — firmware ESP32 open-source usado como referencia para validar el framing HDLC/CRC y los offsets de slot/preset.
  • Builty/TonexOneController — firmware ESP32 open-source; segunda validación independiente del protocolo (Hello/wake, RequestState, baud 115200) y tabla de rangos de parámetros (tonex_params.c).
  • Android MIDI API (android.media.midi) y la especificación BLE MIDI de la MIDI Association para el soporte de footswitches en la V1.0.2.

Legal

This is an independent community interoperability project. It is not affiliated with, endorsed by, or sponsored by any trademark owner. The original source code in this repository is distributed under the MIT license.

About

TUSB — unofficial Android control for the ToneX One via direct USB. Real-time control of presets, the effects chain, and knobs.

Topics

Resources

License

Stars

7 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors