fm1-wheel — manual do hardware

Português · English

Firmware de órgão tonewheel para o M-VAVE FM-1, derivado do setBfree, rodando sobre o fm1-base.

1Instalar

O firmware é instalado por USB-MIDI. É preciso o FM-1 conectado por um cabo USB de dados e nenhum outro aplicativo usando as portas MIDI do aparelho.

make device          # gera app/build/fm1-wheel.fwsc
make install         # mostra o aparelho e pede confirmação antes de gravar

Também é possível usar o instalador web do projeto (Chrome/Edge) ou o fm1_install.py diretamente. Instalar firmware é por sua conta e risco. Mantenha o firmware oficial e as ferramentas de recuperação (fm1-base/bsp/tools/fm1_rescue.py, FM-1-transporter) à mão.

Se a instalação for interrompida, o FM-1 fica em modo de update e o mesmo comando retoma a gravação. Para voltar ao firmware oficial, use o atualizador da M-VAVE ou o instalador web.

2Ligar e tocar

O FM-1 tem 27 teclas (F3–G5), 7 encoders, 14 botões, um potenciômetro MASTER e a tela de 240×240.

• As teclas tocam o manual superior (upper) por padrão.
• OCT- / OCT+ transpõem o teclado embutido em até ±2 oitavas. O MIDI externo não é transposto por esses botões.
• O potenciômetro MASTER controla o volume de saída.
• Um controlador MIDI externo (USB ou TRS) pode tocar qualquer manual; veja a seção 5.

A tela mostra:

• cabeçalho: nome, nota que está soando e carga de CPU;
• corpo: manual selecionado, registração, percussão, vibrato e as 9 barras de drawbar com os footages 16', 5⅓', 8', 4', 2⅔', 2', 1⅗', 1⅓', 1';
• rodapé: oitava, página, volume, rotor, estado do SAVE, drive e reverb.

3Botões e encoders

Encoders

Na página 2, K1 edita a barra 1' e K2–K4 controlam percussão (on/off), harmônico (2º/3º) e decay (fast/slow).

Botões

Os rótulos impressos no FM-1 são os originais; a tela mostra a função real de cada controle.

Registrações de fábrica

A registração é aplicada ao manual selecionado (ALGO/EDIT).

4Modo drawbar keys (teclado como controle)

O GLO liga/desliga o modo em que as 27 teclas deixam de tocar e passam a editar os drawbars do manual selecionado. É o equivalente ao modo de programação dos órgãos clonewheel antigos.

• Modo ligado: as teclas embutidas não tocam; cada pressão empurra ou puxa um drawbar em uma posição. O MIDI externo continua tocando — você pode usar um controlador para tocar e o teclado do FM-1 para editar a registração.
• Modo desligado: as teclas voltam a tocar normalmente.
• O modo não é salvo: no próximo boot ele começa desligado.
• As mudanças de drawbar marcam SAVE; use SAVE para gravá-las.

Mapa das teclas

Cada par bemol (tecla preta) / natural (tecla branca) controla um drawbar:

• F3, C4, F4 e C5 são ignoradas.
• D#5, E5, F5, F#5 e G5 ficam livres (sem função nesta versão).
• No modo drawbar, as 18 teclas de controle acendem com o mesmo brilho; as ignoradas/livres ficam apagadas. A cor da tecla (preta = empurra, branca = puxa) indica a direção.
• A barra cresce de cima para baixo: 0 = todo empurrado, 8 = todo puxado (volume máximo).
• Cada pressão muda uma posição (0..8). O valor aparece na barra correspondente na tela; ao chegar em 0 ou 8, a tecla não passa do limite.
• O manual editado é o que aparece no topo da tela (UPPER/LOWER/PEDAL); use EDIT ou o encoder ALGO para trocar.

Para tocar com o teclado embutido novamente, aperte GLO outra vez. Se uma tecla estiver pressionada na troca, ela é liberada e só volta a soar depois de solta e pressionada de novo.

5MIDI

O FM-1 tem USB-MIDI (in/out) e entrada TRS-MIDI; não há saída DIN.

Control Changes

Program Change 0–7 seleciona uma das oito registrações.

O mapa de drawbars é o do setBfree (invertido: 0 = máximo). Um controlador de drawbars externo funciona sem configuração adicional, inclusive no modo drawbar keys.

6O que é salvo

SAVE grava na flash:

• a oitava;
• o swell;
• os 27 drawbars (upper/lower/pedal);
• percussão (on/off, 2º/3º, fast/slow);
• a registração selecionada;
• vibrato (modo);
• drive e caráter;
• reverb;
• rotor (stop/slow/fast).

Não são salvos: o modo drawbar keys, a página de edição e o manual selecionado (voltam ao padrão no boot).

7Solução de problemas

8Desenvolvimento

make build-host      # simulador de host
make test-host       # testes do app (teclas, drawbars, MIDI, persistência)
make web             # emulador no navegador (Emscripten)
make serve-web       # http://localhost:8790/
make compare         # A/B contra o setBfree
make device          # firmware para o FM-1
make install         # grava no FM-1 conectado

O emulador web roda o mesmo código C do firmware; use Cmd+Shift+R para pegar um wasm novo depois de make web.

9Licença e marcas

O firmware é GPL-3.0-or-later. O setBfree é GPL-2.0-or-later; fm1-base e felucca-bsp são MPL-2.0; os arquivos do SDK JieLi são Apache-2.0. Veja LICENSING.md e LICENSES/.

“Hammond”, “B3” e “Leslie” são marcas de seus proprietários. O fm1-wheel não é afiliado nem endossado por eles. Use “tonewheel organ” e “rotary speaker” em material público.

Desenvolvimento

O código, o port do DSP, os testes, as ferramentas e a documentação do fm1-wheel foram desenvolvidos com OpenCode usando DeepSeek V4.1 Flash, sob direção e revisão humanas.

10M-VAVE SMK-37 Pro

O mesmo firmware também compila para o SMK-37 Pro:

make smk37
# app/build/smk37/fm1-wheel-smk37.fwsc

O SMK tem 37 teclas (C3–C6), 16 pads, quatro faders e oito encoders. As 27 teclas do meio são as F3–G5 do FM-1. Os drawbars usam os quatro faders em três páginas:

FADER BANK e os pads 9–11 escolhem a página; os pads 1–8 chamam as registrações de fábrica. Os valores continuam 0–8 e enchem de cima para baixo. Os faders usam soft takeover. GLOBE liga/desliga os faders/pads; as teclas continuam tocando. O SMK não tem TRS MIDI in: use USB-MIDI. Veja SMK37.md para instalação, segurança e o checklist de hardware.