4# How to Code Potentiometers (Complete Guide) - MIDI Programming for the Arduino
Veja como ligar um potenciômetro a uma entrada analógica Arduino e transformar a leitura em uma mensagem MIDI Control Change.
Um potenciômetro dá ao controlador MIDI um knob físico cuja posição pode ser lida como uma entrada analógica. Este tutorial conecta essa leitura a mensagens MIDI Control Change (CC). Ele cobre o circuito e os conceitos de programação; não inclui um sketch completo nem o procedimento de montagem.
Componentes e circuito do exemplo
Use um Arduino Leonardo, ou outra placa compatível com USB MIDI, um potenciômetro linear de 10 kΩ (frequentemente marcado B10K), uma protoboard e fios jumper. Ligue um terminal externo do potenciômetro ao GND, o outro aos 5 V e o terminal central — o cursor — à entrada analógica A0.
Ao girar o knob, a posição do cursor altera a tensão percebida pela entrada analógica. Os limites elétricos e a adequação do pino dependem da placa; consulte a documentação do hardware específico antes de montar um circuito físico.
Da entrada analógica ao MIDI CC
Use analogRead() para obter o valor da entrada analógica e map() para ajustar essa leitura a uma faixa adequada ao MIDI. A biblioteca MIDIUSB pode então enviar uma mensagem Control Change com o canal MIDI e o número de controlador escolhidos.
Assim, um movimento físico contínuo pode virar uma mensagem MIDI que o software usa para alterar um parâmetro. O instrumento ou DAW receptor ainda precisa interpretar ou mapear essa mensagem CC para o controle desejado. Escolha o número CC, o canal e qualquer limiar de filtragem para seu setup; essas opções dependem do software receptor e não são especificadas aqui.
Ideias relacionadas
analogWrite() e Pulse Width Modulation (PWM) podem aproximar uma saída analógica em pinos digitais compatíveis, por exemplo para controlar o brilho de um LED ou a velocidade de um motor. A saída PWM é um uso separado dos pinos Arduino em relação à leitura do potenciômetro e ao envio de MIDI CC.
ResponsiveAnalogRead é uma biblioteca para suavizar leituras analógicas ruidosas. Suas configurações dependem do circuito e do projeto; este guia não prescreve valores específicos.
Escopo e limitações
Este guia cobre o circuito com potenciômetro, leitura analógica, ajuste de faixa, suavização opcional e saída MIDI CC. Não inclui um sketch completo, etapas de instalação da biblioteca nem um procedimento de verificação. Adapte essas etapas à placa escolhida e teste o circuito e a saída MIDI antes de usar em uma apresentação.
