나는 $15 의 WiFi 조명을, 16 개의 컬러 버튼을 가진 MIDI 컨트롤 테이블과 Kiro CLI 를 결합하여 물리적 컬러 컨트롤러를 만들었습니다. 주말에 재미로 할 프로젝트입니다! 여러분 안녕하세요! 15 년 전에는 저가 Arduino 와 당시의 Java 를 기반으로 한 jHome Automation 라는 홈 자동화 시스템을 만들었습니다. 그때는 인터넷 오브 thing 을 아직 부르지도 않았던 시절입니다. 그 이후로 많은 변화가 있었습니다. WiFi 모듈이 대중화되었고, 가격이 급격히 떨어졌으며, 인공지능은 우리가 hack 하는 속도를 완전히 바꾸었습니다. 이번 포스트에서는 $15 의 WiFi 조명, 16 개의 컬러 버튼을 가진 MIDI 컨트롤 테이블과 Kiro CLI 를 결합하여 물리적 컬러 컨트롤러를 만드는 방법을 자세히 보여드리겠습니다. 주말에 복제할 수 있는 작은 프로젝트입니다.

Hardware Kauf Bulb — $15 스마트 조명
Kauf Bulb 는 Amazon 에서 약 $15 의 WiFi 조명으로, 일반적인 WiFi 조명보다 약 $4 더 비쌉니다. 그 차이점은 ESP32 가 내장되어 있고 ESPHome firmware 를 이미 실행한다는 것입니다. 이는 다음을 의미합니다:

• REST 를 통해 로컬 네트워크에서 제어할 수 있습니다 (클라우드 없이!)
• MQTT 브로커를 구성하고 원격으로 제어할 수 있습니다
• 더 커스터마이징하려면 firmware 를 교체할 수 있습니다
• 소유권 앱에 의존하지 않고, 클라우드가 필수적이지 않습니다.
  WiFi 에 연결되어 바로 API REST 가 준비되었습니다.

Prenous ATOM — 16 개의 패드 컨트롤 테이블
Prenous ATOM (~$136) 은 원래 음악 프로덕션/DJ 를 위해 제작된 인터페이스이지만, 일반적인 제어 인터페이스로 완벽하게 작동합니다. 그것은 다음을 가지고 있습니다:

• 속도 감지 LED RGB 프로그램 가능한 16 개의 패드
• 4 개의 회전식 노브 (상대적 인코더)
• USB 연결성 — 플러그 앤 플레이, 드라이버 없음
• MIDI 를 통한 통신 — 보편적이고 간단한 프로토콜
  저가 그것을 사용했습니다:
• 각 패드는 하나의 색상이 되었습니다.
• 4 개의 노브는 조명의 밝기 (brightness) 와 Red, Green, Blue 채널을 제어합니다.

ESPHome 로 조명 구성
처음으로 한 일은 Kauf Bulb 를 MQTT 브로커에 연결하는 것이었습니다. ESPHome 은 YAML 설정 파일을 사용합니다. 기본적으로 다음을 정의합니다:

• WiFi 네트워크
• MQTT 브로커 주소
• 메시지용 topic prefix
  wifi : ssid : " YourWiFiNetwork" password : " YourPassword"
  mqtt : broker : broker.hivemq.com port : 1883 topic_prefix : playground/bulb1
  ESPHome CLI 로 이 설정을 조명에 올렸습니다:
  esphome run kauf_bulb.yaml
  그 후, 조명은 REST 로컬 명령어와 MQTT 를 모두 받습니다. ESPHome 문서법은 매우 직관적이며, 만약 어떤 문제가 있다면 Kiro CLI 가 도와줍니다 — 저 또한 설정 파일을 생성하기 위해 그것을 사용했습니다. "set up my ESPHome MQTT config" 라고 요청했고, 그것은 바로 할 수 있었습니다.

코드: Python 으로 조명 제어
16 가지 컬러 팔레트
16 개의 패드 각각에 색상이 할당되었습니다. 패드의 LED 를 위한 RGB 값을 정의하고 (범위 0-127, 표준 MIDI) 조명을 위한 값을 정의했습니다 (범위 0-255):
COLORS = [
(" Red ", 127, 0, 0, 255, 0, 0),
(" Orange ", 127, 40, 0, 255, 80, 0),
(" Yellow ", 127, 127, 0, 255, 255, 0),
(" Lime ", 64, 127, 0, 128, 255, 0),
(" Green ", 0, 127, 0, 0, 255, 0),
(" Mint ", 0, 127, 64, 0, 255, 128),
(" Cyan ", 0, 127, 127, 0, 255, 255),
(" Sky ", 0, 64, 127, 0, 128, 255),
(" Blue ", 0, 0, 127, 0, 0, 255),
(" Purple ", 64, 0, 127, 128, 0, 255),
(" Magenta ", 127, 0, 127, 255, 0, 255),
(" Pink ", 127, 0, 64, 255, 0, 128),
(" White ", 1,

27, 127, 127, 255, 255, 255), ("Warm White", 127, 90, 40, 255, 180, 80), ("Cool White", 80, 100, 127, 160, 200, 255), ("Coral", 127, 50, 40, 255, 100, 80)], Quando o programa inicia, todos os pads acendem com suas cores — você tem uma paleta física na sua mesa: Red Orange Yellow Lime Green Mint Cyan Sky Blue Purple Magenta Pink White Warm Wh Cool Wh Coral Apertou um pad, a lâmpada muda pra aquela cor. Simples assim.

Versão REST (Rede Local)
A primeira versão controla a lâmpada via HTTP direto na rede local:
def bulb_color(r, g, b):
url = f"{BULB}/{LIGHT}/turn_on?r={r}&g={g}&b={b}"
urllib.request.urlopen(urllib.request.Request(url, method='POST'), timeout=2)
def bulb_brightness(bright):
url = f"{BULB}/{LIGHT}/turn_on?brightness={bright}"
urllib.request.urlopen(urllib.request.Request(url, method='POST'), timeout=2)
Funciona muito bem quando a lâmpada e o computador estão na mesma rede. Zero latência perceptível.

Versão MQTT (Controle Remoto)
Depois troquei para MQTT, o que abre possibilidades de controle remoto e integração com outros sistemas:
import paho.mqtt.client as mqtt
MQTT_BROKER = "broker.hivemq.com"
MQTT_PORT = 1883
MQTT_TOPIC = "playground/bulb1/light/kauf_bulb/command"
client = mqtt.Client()
client.connect(MQTT_BROKER, MQTT_PORT)
client.loop_start()
def bulb_color(r, g, b):
payload = json.dumps({"state": "ON", "color": {"r": r, "g": g, "b": b}})
client.publish(MQTT_TOPIC, payload)
def bulb_brightness(bright):
payload = json.dumps({"state": "ON", "brightness": bright})
client.publish(MQTT_TOPIC, payload)
A mesma interface, os mesmos pads, os mesmos knobs — mas agora os comandos viajam via MQTT. Você pode controlar a lâmpada de qualquer lugar, ter múltiplas lâmpadas no mesmo topic, ou integrar com Home Assistant, Node-RED, etc.

Os Desafios (e como o Kiro resolveu)
Desafio 1: Encoder Relativo vs. Absoluto
O Kiro gerou a primeira versão rapidinho. Funcionou de primeira para as cores dos pads. Mas quando fui controlar a intensidade com o knob, o comportamento era estranho — a intensidade ficava travada em ~50% e parecia invertida.
O problema: o Kiro tratou o knob como um controlador absoluto (valores de 0 a 127), mas a Presonus ATOM usa encoders relativos. Cada tick do knob manda:
value = 1 → sentido horário (aumentar)
value = 65 → sentido anti-horário (diminuir)
A correção foi manter o estado da intensidade manualmente e incrementar/decrementar a cada tick:
brightness = 255 # estado inicial: máximo
STEP = 8
def knob_delta(value):
if value == 1:
return STEP # clockwise → aumenta
if value == 65:
return -STEP # counter-clockwise → diminui
return 0

No loop MIDI:

brightness = clamp(brightness + knob_delta(msg.value))
Esse é o tipo de detalhe que só se descobre rodando no hardware real. Expliquei o comportamento pro Kiro e ele corrigiu na hora.

Desafio 2: Debounce — a lâmpada piscando
Com o encoder corrigido, a intensidade funcionava perfeitamente... até eu girar o knob rápido. A lâmpada ficava piscando porque cada tick disparava uma requisição HTTP/MQTT, e a lâmpada não conseguia processar tão rápido.
A solução é uma técnica clássica da eletrônica chamada debounce: ao invés de enviar a cada tick, você espera uns 200ms sem atividade e só então envia. Se o usuário continua girando, o timer reseta.
_brightness_timer = None
_time

r_lock = threading.Lock()
def schedule_brightness_update():
global _brightness_timer
with _timer_lock:
if _brightness_timer:
_brightness_timer.cancel()
_brightness_timer = threading.Timer(0.1, lambda: bulb_brightness(brightness))
_brightness_timer.daemon = True
_brightness_timer.start()

O estado atualiza instantaneamente na memória, mas a chamada de rede é coalesced. Resultado: giro suave, sem flicker.

Desafio 3: De REST para MQTT
A primeira versão usava REST direto na rede local. Quando configurei o broker MQTT na lâmpada, precisei trocar o transporte no código Python. Falei pro Kiro: "troca de REST pra MQTT" e ele substituiu as chamadas HTTP por client.publish() mantendo toda a lógica de MIDI e debounce intacta.

O Resultado Final
O programa roda no terminal. Quando inicia:

• Conecta ao broker MQTT
• Abre a interface MIDI
• Acende todos os 16 pads com suas cores
• Inicializa a lâmpada em branco, intensidade máxima
  A partir daí:
• Aperta um pad → lâmpada muda pra aquela cor instantaneamente
• Gira o Knob 1 → controla a intensidade (brightness)
• Gira o Knob 2 → ajusta o canal Red
• Gira o Knob 3 → ajusta o canal Green
• Gira o Knob 4 → ajusta o canal Blue
  Você pode escolher uma cor base no pad e depois refinar com os knobs. Quer um pink? Aperta o vermelho, depois aumenta um pouco de blue no knob 4. Quer um verde mais escuro? Aperta o green, depois diminui a intensidade no knob 1.
  É uma delícia de apertar botão. 😄

Por que Interfaces Minimalistas?
Eu estou pirando nessa ideia de interfaces minimalistas — e tem um motivo. Com a computação agêntica e AI, a gente vai conseguir comandar computadores com poucos botões. Muitas das operações que hoje exigem mouse, teclado, navegar em menus — acessar conta bancária, ver saldo, abrir aplicativos — o agente de AI já vai fazer pra gente. Na minha visão, não vamos precisar de computadores completos com teclado e monitor para tudo.
Você pode juntar um Raspberry Pi, uma interface dessas, um audiozinho e ter um sistema completo para controlar a automação da sua casa.

O projeto re:Button já faz muito mais do que controlar lâmpada:

• Demos de palestra — botão 1 é uma demo, botão 2 é outra, botão 3 toca um áudio, botão 4 roda um vídeo
• Atalhos de sistema — volume, screenshots, respostas rápidas em reuniões
• Lançar projetos — cada pad abre um workspace diferente no Kiro
• Smart home — controlar lâmpadas, ventiladores, cenas

Como Rodar
Dependências:
pip install mido python-rtmidi paho-mqtt
Versão REST (rede local)

Edite o IP da lâmpada no arquivo python3 rebutton-lamp.py

Versão MQTT
python3 rebutton-lamp-mqtt.py

Não precisa ser uma Presonus ATOM — qualquer controlador MIDI com pads funciona, basta ajustar os números das notas.
Não precisa ser uma Kauf Bulb — qualquer lâmpada compatível com ESPHome ou MQTT serve.

O Papel do Kiro CLI
O Kiro CLI foi meu parceiro em todo o processo:

• Gerou a primeira versão completa — listener MIDI, chamadas REST, mapeamento de cores, setup dos LEDs dos pads
• Ajudou a configurar o ESPHome — gerou os arquivos YAML de configuração do MQTT
• Corrigiu o bug do encoder — expliquei o sintoma, ele entendeu e reescreveu a lógica
• Implementou o debounce — descrevi o problema do flicker, ele escolheu o padrão correto com threading.Timer
• Portou de REST para MQTT — trocou a camada de transporte preservando toda a lógica existente
• Adicionou os 4 knobs — generalizou o padrão de um knob para quatro com debounce independente

Nos dias de hoje, a gente consegue fazer as coisas muito rápido. O temp

총 네 가지 버전의 개발 시간은 1 시간 미만이었습니다.

결론: 금요일 프로젝트: $15 의 WiFi 램프, MIDI 테이블, Python 과 Kiro CLI. 결과는 앱을 열지 않고도 집의 조명을 제어하는 물리적, 촉각적, 컬러 있는 인터페이스입니다. 주말에 가족과 함께 즐기고 집을 기술적인 공원으로 바꾸는 프로젝트의 종류입니다. 🚀 여러분이 구축한다면 댓글로 알려주세요!