2026년 6월 5일 금요일

Fluid Ardule, 케이스 가조립을 시작하다

 

라즈베리 파이와 TFT-LCD를 연결하는 리본 케이블(20cm)이 너무 길다. 10cm짜리로 구입했어도 될 것을. 양 말단 커넥터를 female-female로 구입한 것도 실수였다. 

훌륭하게 가공을 거친 Fluid Ardule의 전후 패널(두께 3mm, 무광 마감)이 도착하였다. 도면에 매우 충실하게 만들어졌지만, 보다 신중하게 설계하여 가공 의뢰를 하지 못한 것에 대한 후회가 밀물과 같이 밀려오기 시작하였다.

  • 5-button keypad 모듈은 무척 애를 써서 구멍 간격 측정을 한 뒤 도면을 그렸음에도 불구하고 잘 맞지 않았다. 어긋난 구멍은 드릴로 넓힐 수 있지만, 패널 뒤에 모듈을 고정하게 되니 거리가 너무 멀어져서 기존의 tactile switch의 버튼 캡을 쓸 수 없었다. 그래서 갖고 있던 패널 고정형 누름버튼 스위치(다섯 개!)를 쓰기로 하였다. 신뢰성은 높지만 누를 때 '딸깍'하는 느낌이 없고 저항 사다리를 이용한 회로를 꾸며야 한다.
  • 볼륨 포텐셔미터와 인코더의 간격을 너무 좁게 만들어서 노브 선택의 폭이 좁아졌다. 인코더는 D-shaft 노브를 쓰는데, 이것을 생각하지 않고 저품질 spline knob만 잔뜩 구입해 놓았다. 축간 간격이 22mm이므로 이보다 직경이 작은 노브를 다시 골라야 한다.
  • DXF 파일의 dimension layer에 참고용 텍스트를 달아 두었는데 너무나 충실하게 가공에 반영되었다. 실제로 새겨 넣지는 말아 달라고 부탁을 했어야 하는데... 그나마 후면판의 경우 내부에 새겨져 있어서 보이지 않는다. 실제로 글자가 필요했다면 올바른 면에 새겨달라고 했었을 것이다.
  • 뒷면의 퓨즈-파워소켓-전원 스위치의 배치가 마음에 들지 않는다. 파워 스위치를 모서리에 가깝게 배치한 것은 작동의 편의성을 위한 것이나, 파워소켓으로부터 퓨즈를 거쳐서 배선이 가로질러야 하니 보기에는 별로 좋지 않다.

고정 전의 부품을 케이스 안에 담아 보았다. 생각보다 공간이 좁다. 바닥 면적이 A4 용지보다는 넓어서는 안 된다는 생각으로 설계를 했기 때문이다. 덕분에 적당히 아담하고 전체적인 중량도 적게 나가겠지만, 조립이 까다로울 것 같다.

라즈베리 파이와 아두이노 우노를 고정할 방법도 생각해 봐야 한다. 바닥이 나무판이라고 하여 단순하게 나사못을 박아서 고정할 수 있는 것도 아니기 때문이다. 온갖 시나리오를 머리에 떠올리면서 고민에 고민을 거듭하고 있다.

오늘은 별로 고민하지 않고 마무리할 수 있는 전원부 재구성부터 손을 대야 되겠다.

2026년 6월 4일 목요일

Fluid Ardule, 콤비(Combi) 기능을 구현하다

음악 신시사이저에서 '콤비(Combi)'란 여러 음색을 조합하여 하나의 연주 환경을 만드는 기능을 말한다. 가장 흔한 예는 피아노와 현악기 앙상블을 동시에 울리는 경우이다. 이를 위해 내장 음원의 서로 다른 MIDI 채널에 각 음색을 배치하고, 키보드에서 들어오는 연주 정보를 여러 채널로 복제하여 전달한다. 이렇게 여러 음색을 겹쳐 연주하는 방식을 레이어(layer)라고 한다.



콤비에는 스플릿(split)도 포함된다. 예를 들어 건반의 왼쪽 영역은 베이스, 오른쪽 영역은 피아노를 연주하도록 설정하면 마치 한 사람이 두 악기를 동시에 연주하는 것 같은 효과를 얻을 수 있다. 이 경우 들어오는 노트 정보를 음높이에 따라 구분하여 각 파트로 전달한다. 따라서 레이어가 동일한 연주 정보를 여러 파트에 복제하는 방식이라면, 스플릿은 연주 정보를 건반 영역에 따라 분배하는 방식이라고 할 수 있다.

Fluid Ardule 개발의 마지막 단계는 바로 콤비 음색 활용까지를 구현하는 것이다. '전원을 켠 뒤 건반을 연결하여 연주하면 소리가 난다'는 겉보기에 단순한 목표를 달성하는 것은 결코 쉽지 않았다. 이 때에는 콤비까지는 크게 생각하지 않았었다. 버튼과 인코더를 이용하여 매끄럽게 돌아가면서도 직관적이면서 안정적인 UI를 만드는 과정은 참으로 힘겨웠다. 게다가 순수히 재미 삼아 시도한 음원 파일(MP3, OGG, WMA...) 재생 기능 및 인터넷 라디오 기능이 이렇게까지 자잘한 재미를 더해 줄지 누가 알았겠는가?

엄밀히 말하자면 소프트웨어적으로 원하는 기능을 구현하는 것보다 모든 부품을 견고한 케이스에 넣어서 '음악 감상 및 공연장에서도 라이브용으로 쓸 만하게' 만드는 것이 더 중요할 수도 있다. 나무틀은 제작 완료되었고, CAD로 설계한 전후판은 가공을 마치고 오늘 집으로 배송될 것이다. 이를 기다리는 동안 콤비 기능을 몇 시간에 걸쳐 구현한 셈이다.

가장 먼저 한 일은 콤비 음색을 JSON 파일로 정의한 것이다. 현대적 신시사이저에서는 직접 프리셋을 한 레이어씩 쌓아서 콤비를 만드는 일은 흔하지 않다. 이미 마련된 콤비를 불러서 쓰다가 적절히 편집한 뒤 유저 영역에 저장하는 것이 일반적이다. 이번에 정의한 JSON 파일 역시 ChatGPT의 도움을 받아 초안을 만들었다. 우선은 단일 사운드폰트 파일(FluidR_GM.sf2)를 이용하는 것으로 단순한 체계로 구축하였다.

전체 파이썬 스크립트가 이제 1만 라인에 육박하고 있다. 콤비 기능은 별도의 스크립트 파일로 분리해야 하는지 약간 고민을 하였었는데, 지금까지 큰 문제 없이 기능 구현이 된 것을 생각하면 아직 그럴 필요는 없다고 생각한다. 콤비의 편집 및 저장까지 마치면 더 이상 바랄 것이 없는 수준이 되는 것이다. 

Fluid Ardule을 케이스에 넣는 과정에서 예상하지 못한 문제가 또 발생할 것이다. 미국 출장을 앞두고 있어서 금주 안에 마무리 작업을 하는 것은 너무 성급하다. 7월이 오기 전에 외관과 소리 모두 완성된 모습을 만들도록 하겠다.

2026년 5월 29일 금요일

Fluid Ardule, LCD의 외계어 표시를 없애다 - 10uF 전해 커패시터의 힘

Fluid Ardule의 UI 컨트롤러에 해당하는 아두이노 우노에는 I2C LCD 모듈이 연결되어 있다. 이것이 이따금 '외계어'를 표시하는 문제가 있었다. 가끔 일어나는 노이즈 문제라고 생각하기에는 그 빈도가 너무 잦았다. USB 커넥터를 뽑았다가 다시 연결해도 완벽하게 해결되지 않았다. 만약 내가 만드는 물건이 '상품'을 목표로 한다면, 도저히 시장에 내놓기 부끄러운 상태였다.


이 모습은 영화 <프레데터>에 나오는 Yautja 알파벳을 닮았다. 작년에 개봉한 <프레데터: 죽음의 땅> 관련 기사(LA Times 링크)에서는 이 문자와 언어 체계에 대한 상세한 정보가 담겨 있다. 



문제는 이것이 단순한 미관상의 문제가 아니라는 점이다. LCD는 Fluid Ardule의 보조 진단 장치 역할을 한다. 전원을 넣은 직후 상태를 알려주고, Raspberry Pi와 연결되었는지 여부도 표시한다. 따라서 화면이 깨진다는 것은 사용자가 장비를 신뢰하기 어렵다는 뜻이다. 설령 실제 기능은 정상이라 하더라도 말이다.

처음에는 I2C 통신 자체를 의심했다. 하지만 곧 이상한 사실을 발견했다. 외계어 현상은 Raspberry Pi와의 통신이 시작되기 전에도 발생한 적이 있었다. 그렇다면 원인이 Serial 통신에만 있는 것은 아니었다.

ChatGPT와 더불어 온갖 가설 수립과 실험을 해 보면서 생각이 조금씩 바뀌었다. 

문제는 LCD가 아니라 초기화 순서일 수 있었다.

UNO, PCF8574 I2C backpack, HD44780 LCD 컨트롤러는 전원이 들어온 뒤 각각 안정화되는 시간이 조금씩 다르다. 만약 Arduino가 너무 빨리 실행되어 lcd.init()를 호출한다면 LCD 쪽이 아직 완전히 준비되지 않았을 가능성이 있다.

전원을 넣으면 아두이노 우노가 켜지면서('cold start') LCD 모듈(컨트롤러 포함)에도 전원이 인가되어 자연스럽게 화면이 나온다. 이 때에도 외계어가 발생한 사례가 있었지만 매우 드물었다.

그러나 라즈베리 파이가 완전히 부팅되고 Fluid Ardule 서비스가 시작되면서 아두이노 우노와 USB를 통한 시리얼 통신을 수립하는 과정에서 우노는 다시 재시작될 수 있다. Arduino Uno의 기본 자동 리셋(auto-reset) 기능 때문이다.

이 경우 LCD는 계속 전원이 공급되고 있는데 우노만 다시 시작되는 상황이 발생한다. ChatGPT는 이러한 비대칭적인 재시작 과정이 LCD 상태 불안정의 한 원인일 가능성을 제기하였다. 다만 이것이 유일한 원인인지는 아직 단정할 수 없다.

그래서 RESET-GND 사이에 10µF 전해 콘덴서를 추가하는 실험을 했다.

이 콘덴서는 전원 안정화용이 아니다. RESET 핀의 상승 시간을 약간 늦추어 Arduino가 조금 더 늦게 시작하도록 만든다. 즉 LCD와 PCF8574가 충분히 준비된 뒤 초기화가 이루어질 가능성을 높이는 것이다.

놀랍게도 효과가 있는 것으로 보였다. 외계어 발생 빈도가 눈에 띄게 감소하였다.

그런데 이번에는 예상치 못한 부작용이 나타났다.

Arduino IDE에서 펌웨어를 업로드하려고 하자 갑자기 다음과 같은 오류가 발생했다.

not in sync: resp=0x55

한참 원인을 찾다가 문득 깨달았다. 10µF 콘덴서가 Arduino의 자동 리셋 기능까지 방해하고 있었던 것이다. 실제로 콘덴서를 제거하면 업로드가 정상적으로 이루어졌고, 다시 연결하면 동일한 문제가 재현되었다. 이는 콘덴서가 RESET 타이밍에 실제 영향을 주고 있음을 보여주는 간접적인 증거이기도 했다.

결국 콘덴서는 납땜된 상태로 두지 않고, 필요할 때 꽂았다 뺄 수 있는 탈착식 구조로 변경했다. 다음과 같은 프로토타입 실드(Keys 5.1 Proto Shield, 패턴 설명)를 쓰고 있기 때문에 소켓 헤더(아래 사진에서 보이는 맨 아래 가운데 부품)의 Rst와 GND에 전해 콘덴서를 필요한 때에 꽂는 것으로 충분하였다. 어제는 리셋 버튼 스위치 근처에 납땜을 하여 테스트를 했기 때문에 펌웨어 업로드 시에 뺄 수가 없었다.


소켓 헤더에 10uF 전해 콘덴서를 꽂은 사진. 6월 3일 현재 프로토타입 실드는 제거해 버렸다. 전원을 연결할 수 있는 작은 확장 보드를 만들어 대신하였기 때문이다. 단순한 것이 좋다.



그 과정에서 또 하나의 개선점을 발견했다.

현재 UNO-1 펌웨어는 전원 투입 시 LCD를 초기화하지만, Raspberry Pi와 처음 연결되는 순간에는 LCD를 다시 초기화하지 않는다. 그래서 최초 HELLO 메시지를 수신할 때 LCD를 한 번 더 재초기화하는 코드를 추가했다. 일종의 복구 계층을 만든 셈이다(Commit 0380f4a).

하지만 이번 실험에서 중요한 사실이 확인되었다. 펌웨어에서 HELLO 수신 시 LCD를 재초기화하더라도, RESET-GND 사이의 10µF 콘덴서를 제거하면 전원 투입 직후 LCD에 다시 외계어가 나타났다. 즉 소프트웨어 재초기화만으로는 이 문제를 완전히 막을 수 없었다.

정리하면 현재 구조는 다음과 같다.

  • RESET-GND 10µF 콘덴서 → 예방 계층
  • HELLO 수신 시 LCD 재초기화 → 복구 계층

하나는 문제가 발생하지 않도록 돕고, 다른 하나는 혹시 문제가 생겨도 다시 정렬해 준다.

10µF 콘덴서는 UNO-1의 리셋 해제 시점을 늦추어 LCD와 I2C 주변 회로가 안정된 뒤 초기화가 이루어지도록 돕는다. 반면 HELLO 수신 시 LCD 재초기화는 Raspberry Pi와의 연결이 수립된 뒤 화면 상태를 다시 정렬하는 보조적인 안전장치에 가깝다.

수정 후에는 서비스 재시작을 25회 이상 반복했지만 외계어 현상은 관찰되지 않았다. 물론 원래도 매우 낮은 빈도로 나타나던 문제였기 때문에 완전 해결을 선언하기는 이르다. 그러나 적어도 지금까지의 결과는 상당히 고무적이다.

돌이켜보면 이번 사건은 단순히 LCD 글자가 깨지는 문제를 해결한 것이 아니었다. 오히려 시스템의 초기화 시퀀스를 이해하게 된 과정에 가까웠다. 전원 투입, RESET 해제, LCD 초기화, Raspberry Pi와의 링크 수립이 서로 어떤 관계를 갖는지 다시 생각하게 만들었다.

가끔은 가장 작은 부품 하나가 가장 큰 교훈을 준다.


질문에 독이 있다

모르는 것을 상대에게 묻는 것을 질문이라 한다. 자신이 모르는 정보를 알아내고 싶거나, 이해와 설명을 구하기 위함이다. 따라서 질문이란 나의 무지를 전제로 하며, 질문하는 태도에는 겸손함이 따라야 한다. 그러나 많은 경우에 질문자는 답변을 통해서 상대를 평가하려는 숨은 의도가 있다. 그리고 그러한 의도를 굳이 숨기려고 하지도 않는다. 좋은 점이 드러나면 다행이지만, 망신을 당하기도 한다. 선거를 앞두고 벌어지는 토론회가 그러한 사례가 될 것이다. 토론회는 원래 그런 목적으로 열리는 것이니까.

이러한 의도를 품은 질문은 미처 방어할 준비를 하지 못한 상대를 당혹스럽게 만든다. 질타하거나 비난거리를 찾기 위한 질문이 바로 그러한 질문이다. 질문자가 '갑'의 위치에 있을 때, 그리고 그 대화가 이루어지는 자리에 다른 사람들이 많이 모여 있을 때 그러한 질문은 더욱 위력을 발휘한다. 자신의 영향력이나 지위를 과시하기 위해 던지는 질문도 흔하다.

"내가 몰라서 묻는 줄 아세요?"

이렇게 질문을 하고 의기양양하게 좌우를 둘러보는 사람도 있었다.

이 말과 제스쳐는 사실 질문의 목적을 스스로 폭로하는 것이다. 자신이 알고 있는 것을 이미 정답으로 정해 놓았음을 선언하는 것이며, 정보를 얻기 위함이 아니라 상대를 시험하고 압박하고 있음을 보여주는 행위이다.

질문이 압박의 도구가 되면 심문으로 바뀐다. 그러면 올바른 답변이 나오지 않는다. 흔히 'garbage in, garbage out'이라 한다. 질문도 이에 비유할 수 있다. 올바르지 않은 질문에는 좋은 답변이 나오지 않는 법이다. 잘못된 전제를 깔고 있는 질문, 어떤 답변을 하든 상대를 불리하게 만드는 질문, 원하는 곳으로 결론을 끌고 가기 위한 질문...

그래서 나는 독이 든 질문에 답하고 싶지 않다. 그걸 잘 알면서도... 오늘도 당했다.

2026년 5월 27일 수요일

Fluid Ardule, Wi-Fi 설정 기능까지 밀어넣다

인터넷 라디오 기능까지 넣고 나니, 이 기기를 다른 장소에 가져갔을 때 휴대폰 핫스팟에 연결하여 음악을 듣고 싶어졌다. 하지만 키보드나 터치 입력이 원활하지 않은 환경에서 Wi-Fi 암호를 직접 입력하는 UI를 만드는 것은 꽤 번거로운 일이다. 그래서 이미 알고 있는 네트워크 정보를 별도의 설정 파일(/etc/wpa_supplicant/wpa_supplicant-wlan0.conf)에 저장해 두고, 현재 검출되는 SSID 중에서 하나를 선택하는 단순한 방식을 구현해 보았다.

Wi-Fi 선택 화면. '설정'이라고까지는 이야기하지 못하겠다. 암호를 입력하지는 못하므로. 상판으로 사용할 아크릴판도 오늘 도착하였다. 가공을 의뢰한 전후판만 배송되면, 수일 내로 완성품을 만들게 될 것이다. 

개발을 이어가면서 네트워킹 가이드 문서도 함께 정리하였다. Raspberry Pi OS의 실제 동작 방식과 systemd 기반 Wi-Fi 설정 구조를 반영하여 내용을 다듬었는데, 일반적인 라즈베리 파이 네트워크 설정 가이드로 보아도 크게 어색하지 않을 정도로 완성도가 높아진 것 같다.

가끔 Raspberry Pi 3 Model B 와 Arduino Uno 의 연결 상태가 끊어져 기기가 통제 불능 상태에 빠지기도 한다. 대부분은 아두이노 우노를 리셋하면 문제가 해결되지만, 그렇지 않은 경우에는 라즈베리 파이에 SSH로 접속하여 서비스를 재시작해야 한다. 또한 CP2102 기반의 시리얼 콘솔(PuTTY 등)을 이용하면 네트워크가 동작하지 않는 상황에서도 시스템 복구가 가능하다. 시리얼 콘솔은 이미 지금도 사용하고 있다. 

사실 사운드 모듈이라는 본래 목적에만 충실하다면 네트워킹 기능은 전혀 필요하지 않다. MIDI 입력과 음원 재생만으로도 독립적인 전자 악기처럼 동작할 수 있기 때문이다. 하지만 인터넷 라디오 기능까지 추가하다 보니, 결국 외부 세계와 연결되는 최소한의 통로는 유지할 수밖에 없다. Wi-Fi는 가장 일상적인 통로이고, 비상 사태에 쓰기 위한 통로는 다음의 글을 참고하라.

휴대폰을 비상 콘솔로 쓰기

라즈베리 파이 기반 장비를 헤드리스(headless)로 운영하다 보면, 가끔 SSH 접속조차 불가능한 상황이 발생한다. 특히 Fluid Ardule처럼 TFT-LCD와 아두이노 우노 기반의 전용 UI를 사용하는 시스템에서는 입력 장치 연결이 끊어지면 사실상 조작이 불가능해질 수도 있다.

이럴 때 라즈베리 파이의 UART 시리얼 콘솔은 매우 강력한 비상 복구 수단이 된다. 나는 GPIO UART에 연결된 CP2102 USB-UART 모듈을 항상 장착해 두고 있으며, 평소에는 노트북에서 PuTTY를 이용하여 접속한다. 그런데 같은 작업은 휴대폰만으로도 가능하다고 한다.

준비물

  • Android 스마트폰
  • USB OTG 어댑터
  • CP2102 USB-UART 모듈
  • 시리얼 터미널 앱(예: Serial USB Terminal)

연결 구조

Raspberry Pi UART
        ↓
      CP2102
        ↓ USB
 Android Phone

휴대폰에 OTG 어댑터를 연결한 뒤 CP2102를 꽂고, 시리얼 터미널 앱을 실행한다. 보통 baud rate는 115200bps로 설정하면 된다. 연결이 성공하면 라즈베리 파이의 Linux 콘솔 로그인 프롬프트가 휴대폰 화면에 나타난다.

간단한 복구 명령

sudo systemctl restart fluid_ardule.service
journalctl -u fluid_ardule.service -n 3

이 방식의 장점

가장 큰 장점은 네트워크 상태와 무관하다는 점이다. Wi-Fi가 죽었거나 SSH가 동작하지 않아도, UART 콘솔만 살아 있으면 시스템 복구가 가능하다. 서비스를 재시작하거나 로그를 확인하는 정도의 유지보수는 휴대폰만으로도 충분히 수행할 수 있다.

또한 Bluetooth나 VNC 같은 무거운 기능을 다시 활성화하지 않아도 된다. 최소 기능만 유지한 경량 appliance 스타일의 시스템에서는, 이런 단순한 UART 콘솔 방식이 오히려 가장 안정적이고 확실한 유지보수 수단인지도 모른다.

2026년 5월 26일 화요일

Fluid Ardule, 인터넷 라디오 기능까지 구현하다

 

가공을 의뢰한 전후판과 상판이 수일 내로 도착할 것이다.

잠시 동작이 불안정했던 아두이노 우노 펌웨어를 다시 손보고, 드디어 인터넷 라디오 기능까지 넣어 보았다. 방송국 목록은 json 파일 형태로 직접 제공하는 단순한 방식을 택했다. 기능 자체는 잘 작동하지만, 인터넷 라디오를 원활하게 쓰려면 결국 Wi-Fi 설정 문제가 따라온다.

그렇다고 Wi-Fi 설정까지 장비의 작은 UI 안에 넣으려 하면 일이 지나치게 복잡해진다. 버튼과 인코더만으로 암호를 입력하는 일은 생각보다 번거롭다. 그래서 이 부분은 장비 안에서 억지로 해결하기보다, 필요할 때 터미널에서 설정하는 편이 낫다고 보았다. 아무런 네트워크가 잡히지 않은 상태에서도 라즈베리 파이에 접근할 수 있는 방법, 즉 USB 시리얼 콘솔이 남아 있다는 점은 이럴 때 큰 장점이 된다.

위에서 소개한 사진에서는 Fluid Ardule이 SomaFM의 방송국 중 하나를 재생하고 있다. SomaFM은 미국 샌프란시스코 기반의 독립 인터넷 라디오 서비스이다. 2000년부터 운영되어 왔으며, 광고 없이(listener-supported) 운영되는 채널이 많다는 점이 특징이다. 

이 서비스는 단순히 음악을 자동 재생하는 스트리밍 사이트라기보다, 각 채널마다 뚜렷한 분위기와 선곡 철학을 가진 ‘큐레이션 라디오’에 가깝다. 특히 앰비언트, 다운템포, 드론, 전자음악, 라운지, 재즈 계열 채널이 강하며, 오랫동안 DIY 오디오 애호가와 개발자들 사이에서도 잘 알려져 있다. 

Fluid Ardule에는 우선 몇 개의 대표 채널만 시험적으로 넣어 보았다. 예를 들어 Groove Salad는 다운템포와 칠아웃 계열 음악 중심이며, Drone Zone은 느린 드론·앰비언트 음악 위주의 채널이다. Deep Space One은 우주적인 분위기의 실험적 앰비언트 전자음악을 제공한다. 

이들 방송은 공개 스트림 URL 형태로 제공되므로 별도의 웹브라우저나 계정 없이도 mpv 같은 플레이어에서 직접 재생할 수 있다. Raspberry Pi 기반의 소형 오디오 장비와 잘 어울리는 이유도 여기에 있다. 

오늘의 Fluid Ardule 파이썬 스크립트(260526b)는 7687라인이다. '미디어 스테이션'으로 복잡하게 진화하려는 욕망을 억제하는 것도 어렵다. '불편하고 작은 PC'를 만드는 것이 나의 최종 목표는 아니기 때문이다.

2026년 5월 24일 일요일

새벽의 성공, 이어지는 hotfix

원래의 제목은 '어제의 성공, 오늘의 hotfix'로 하려고 했었다. 그러나 실제로는 어제 밤늦게 작업을 한 뒤 자정을 넘겨 '성공'에 대한 포스팅을 했기 때문에 지금  hotfix에 관한 글을 쓰는 시점과 날짜는 같다. 그래서 '새벽의 성공, 이어지는 hotfix'라고 제목을 지었다. Hotfix란 급하게 수정해야 하는 버그 잡기 정도라고 정의하면 된다. 중요한 기능을 구현했다고 김칫국부터 마시면서 릴리즈했다가 치명적인 문제가 포함되었음을 깨닫고 다시 급하게 수정본을 배포하는 행위에 해당한다.

어제 Fluid Ardule의 UNO-1 입력 컨트롤러에 자동 캘리브레이션 기능을 넣고 꽤 뿌듯해하고 있었다(관련 글 링크). 저항 사다리(resistor ladder) 방식의 5-버튼 키패드는 단 하나의 아날로그 입력만 사용하기 때문에 구조가 단순하고 배선도 간결하다. 비용도 적게 든다. DIY 프로젝트에서는 꽤 매력적인 방식이다.

이번에 구현한 기능은 각 버튼의 ADC 중심값을 자동으로 측정해 EEPROM에 저장하는 방식이었다. 사용자가 LEFT, UP, DOWN, RIGHT, SELECT 버튼을 차례대로 누르면 시스템이 직접 기준값을 계산해 주는 구조다. 저항 편차나 전원 상태 변화에도 좀 더 유연하게 대응할 수 있을 것 같았다. 실제로 처음 테스트했을 때는 제법 그럴듯하게 동작했다. 이제는 펌웨어 자체를 수정하여 컴파일 후 업로드하지 않아도 작동 중에 보정치를 구해서 직접 적용할 수 있으니 정말 영리하게 목표를 달성했다고 자부하고 있었다.

하지만 늘 그렇듯, 진짜 문제는 “잘 되는 것처럼 보인 뒤”에 나타난다.

테스트를 반복하던 중 이상한 현상이 보였다. 캘리브레이션 모드에 진입한 직후 아직 LEFT 버튼을 누르지도 않았는데 시스템이 이미 LEFT 입력을 받은 것처럼 다음 단계로 넘어가 버리는 경우가 생긴 것이다. 처음에는 threshold 계산 문제인가 싶었다. 그런데 원인을 추적해 보니 더 흥미로운 곳에 문제가 숨어 있었다.

문제는 캘리브레이션 진입 자체에 사용했던 롱프레스 입력이었다.

사실 인코더 롱프레스는 원래 인코더 회전 가속(acceleration) 단계를 변경하는 기능에 이미 할당되어 있었다. 따라서 캘리브레이션 진입을 같은 롱프레스 동작에 연결하자 메뉴 의미가 충돌하기 시작했다. 결국 캘리브레이션은 인코더와 SELECT 버튼을 동시에 길게 누르는 조합 입력으로 변경하였다. 일반적인 조작과 유지보수 기능을 분리하기 위한 선택이었다.

그런데 시스템은 아직 그 입력 상태의 “잔향” 속에 있었는데도 이미 다음 단계로 넘어가 LEFT 입력을 기다리고 있었다. resistor ladder 방식에서는 버튼을 떼는 순간 ADC 값이 잠깐 불안정한 영역을 지나간다. 그 transient 값이 우연히 LEFT 버튼 영역을 스치면서 실제로는 누르지도 않은 LEFT가 눌린 것처럼 보인 셈이다.

결국 이번 hotfix에서는 캘리브레이션 state machine 자체를 손보게 되었다.

캘리브레이션 진입 직후에는 먼저 모든 버튼이 완전히 해제된 안정 상태를 확인하도록 바꾸었고, 단순히 “현재 눌려 있는 상태”가 아니라 NONE 상태 이후 새롭게 발생한 press edge만 유효 입력으로 인정하도록 수정하였다. 각 단계 사이마다 반드시 버튼 release를 확인하는 과정도 추가했다.

사실 이런 문제를 겪다 보면 임베디드 시스템에서 가장 어려운 것은 화려한 기능이 아니라 상태 전이(state transition)라는 생각이 든다. 특히 아날로그 입력, 롱프레스, 노이즈, 실시간 이벤트가 한꺼번에 얽히기 시작하면 예상하지 못한 모서리(edge case)가 끝없이 나타난다.

그래도 이런 시행착오가 재미있다. “왜 이런 일이 생겼지?”를 추적하다 보면 회로와 펌웨어가 실제 세계와 어떻게 부딪히는지가 조금씩 보이기 때문이다.

한편으로는 현재의 resistor ladder 구조를 계속 유지할지에 대한 고민도 다시 하게 된다. 장기적으로는 PCF8574 같은 I2C 기반 GPIO 확장 칩도 검토해 보고 싶다. 버튼마다 독립적인 디지털 입력을 사용하면 threshold drifting 같은 문제에서는 훨씬 자유로워질 수 있기 때문이다. 물론 배선은 조금 복잡해지겠지만 말이다.

자작나무 합판이 도착하여 드디어 케이스 만들기에 착수하였다. 목공용 플램프가 없어서 이번에도 접합 후에 단차가 약간 발생하였다. 충분히 주의하면서 위치를 잡은 후 무거운 것으로 눌러 두었음에도 불구하고... 만약 PCF8574 확장 칩을 쓴다면 사진 가운데에서 보이고 있는 패널용 누름 버튼 스위치 5개를 이용하여 약간은 수고스럽게 배선 작업을 해야 한다. 


어쩌면 이번 경험은 단순한 버그 수정이라기보다, “입력 장치를 만든다”는 것이 생각보다 훨씬 깊은 세계라는 사실을 다시 배우는 과정인지도 모르겠다.


2026년 5월 26일 업데이트

자작나무 합판으로 만든 틀에 다이소 바니시를 발라서 잘 말렸다. 전후판(알루미늄 3T)도 가공을 맡겼다. 재단한 합판을 접착해 놓고 보니 단차가 발생하여 매우 아쉽고, 겉으로 살짝 흘러나온 목공본드를 바니시 도포 전에 깨끗하게 닦아내지 못한 것은 더더욱 아쉽다.



지금은 약간 사족과 같은 '인터넷 라디오' 재생 기능을 추가해 보고 있다. 그 과정에서 UNO-1 버튼 입력 검출의 문제가 다시 드러나서 이를 수정하기 위해 적잖이 골머리를 앓고 있다. 엊그제 구현한 self-calibration 기능도 아직 완벽하지 못하다. 이를 자세히 알아보자.

현재 입력 처리 로직에서는 롱프레스가 발생한 뒤 사용자가 버튼을 실제로 떼기 전에, 여전히 눌린 상태의 입력이 새로운 버튼 이벤트로 다시 해석되는 문제가 발생할 수 있다. 특히 아날로그 저항 사다리 방식의 5-key 입력에서는 ADC 값이 잠시 유지되거나 흔들리기 때문에, 롱프레스 처리 직후 동일 버튼이 다시 short press나 다른 명령으로 인식되어 메뉴 이동, 중복 실행, 의도하지 않은 동작이 연속적으로 발생한다. 따라서 롱프레스 이벤트가 발생한 이후에는 버튼이 완전히 릴리즈되고 입력값이 안정된 것이 확인될 때까지 추가 입력을 무시하는 “wait-for-release” 상태 처리가 반드시 필요하다.

모든 불만을 저항 사다리 방식의 5-버튼 키패드 모듈 안정성 탓으로 돌리고 싶지만, 이러한 판단이 정말 공정한지는 아직도 잘 모르겠다. 하드웨어의 편차, 펌웨어의 판정 로직, 릴리즈 감지 기준, 그리고 라즈베리 파이와의 통신 구조가 서로 복잡하게 얽혀 있기 때문이다.

취미 수준으로 만족할 것이 아니라 제품 수준의 완성도를 목표로 하려면 얼마나 많은 고민과 시행착오를 거쳐야 하는지 조금은 알 것 같다.

나머지 안정성 개선은 각자의 하드웨어 환경과 시행착오 속에서 계속 다듬어질 수밖에 없을 것이다. 어쩌면 그것이 DIY 프로젝트의 한계이자, 동시에 매력인지도 모른다. 그렇다 하더라도 최초의 '기발자'(기획자 + 개발자)로서, 적어도 내가 겪은 문제와 해결 과정만큼은 끝까지 책임지고 다듬어 나가고 싶다.