본문으로 건너뛰기

약 버튼, 진짜로 만들었습니다 — 안 눌리고 안 붙고 글자 깨지던 일주일

황인준

2026.08.05

약 버튼, 진짜로 만들었습니다 — 안 눌리고 안 붙고 글자 깨지던 일주일 본문 이미지

먼저,

저희 집엔 "우리집 에이전트" 라는 것이 있습니다!

집에 놀고 있는 구형 아이패드를 어떻게 하면 살릴수 있을까 하면서 시작된 프로젝트입니다.

대단한건 없고, 까먹는 집안일이나, 냉장고에 뭐가 있었더라 뭘 빨리 먹어야하나 할때 사용하는 용도 입니다.

서로 일정 체크도 합니다. 물론 보는 사람은 없지만...

한자가 적힌 달력

이 에이전트는 에르메스에 물려놓아서, 텔레그램으로 제어합니다.

"나 내일 xxx 로 출근해" or "나 어제 퇴근하고 누구 만나"           → 일정에 들어감
"휴지 두 개 남았어"                                         → 재고가 줄어듦
"수요일마다 화장실 청소"                                     → 반복 루틴이 됨

그러면 거실 태블릿엔 오늘 챙길 것만 카드로 뜹니다. 앱을 켜거나 목록을 뒤질 필요 없이, 왔다갔다가 보는 용도로 사용하고 있습니다.

[텔레그램] → [맥미니(항상 켜져 있음)] → [DB] → [거실 태블릿]

서두가 길었습니다. 저는 이번 홈 IOT 프로젝트로, 약 복용 체크를 하고 싶었습니다.

일정이나 장보기는 "생각났을 때 폰으로 말하면" 됩니다. 그런데 약은 성격이 다릅니다.

먹었는지 안먹었는지도 기억하기 힘든데, 텔레그램으로 이걸 먹었다고 하는건 너무 귀찮은 일이라,

물리 버튼이 있으면 좋겠다 하는 생각이 들었고, 귀찮은 일을 꽝! 해결했다는 타격감을 주고 싶었습니다.

지난주엔 이걸 설계만 했습니다.

부품이 하나씩 도착해서, 2시간 정도 작업을 한거 같습니다. 지금 거실 벽에서 돌아가고 있습니다.


부품이 오기 전에 뭘 했나

지난주에 설계를 하면서 어떻게 동작하는지 클로드 코드와 하나씩 이해를 하는데 시간을 어느정도 쓰고,

물리 버튼이 하는 일은 결국 HTTP POST 한 번이라서, 부품 없이도 서버 쪽은 다 만들 수 있습니다.

그래서 맥미니에 이런 API를 먼저 올렸습니다.

POST /api/med/event    복용/취소 기록
GET  /api/med/state    지금 상태 (화면에 뿌릴 문구 포함)
GET  /api/med/ping     배선 확인용 헬스체크

그리고 curl로 전 구간을 돌려봤습니다.

curl -X POST http://192.168.x.x:8080/api/med/event \
  -H 'Content-Type: application/json' \
  -d '{"device_id":"med-button-01","event_id":"test:1:1","type":"taken","age_ms":150}'

DB에 들어가고, 태블릿 대시보드 카드가 실시간으로 사라지는 것까지 부품 도착 전에 확인이 끝났습니다.

나중에 ESP32에서 에러가 났을 때 "서버는 이미 검증됐다"는 걸 알고 있어서, 좀 수월하게 작업했고 하드웨어만 집중할 수 있었습니다.


한국 전자상거래 웹사이트의 스크린샷

다 합쳐서 3만원 안쪽입니다. 납땜은 한 군데도 안 했습니다.

부품

역할

왜 이걸로 골랐나

ESP32 개발보드

두뇌 + 인터넷

WiFi가 칩에 내장되어 있습니다. 아두이노 우노로 하면 WiFi 모듈을 따로 달아야 하고, 그러면 더 비싸고 복잡해집니다

아케이드 버튼(돔형)

입력

오락실 버튼입니다. 조준하지 않고 손바닥으로 쳐도 눌리는 크기가 핵심이라, 작은 택트 스위치는 후보에서 뺐습니다

OLED 디스플레이

출력

이게 없으면 누른 게 들어갔는지 확인할 방법이 없습니다. LED 하나로는 "오늘 완료 · 12:39" 같은 걸 못 보여줍니다

점퍼선(암-암)

연결

꽂기만 하면 됩니다. 납땜 안 해도 되는 게 이번 프로젝트의 큰 전제였습니다

USB 충전기 + 케이블

전원

벽 콘센트에 그냥 꽂습니다

실제로 돌아가는 구조

[아케이드 버튼] ──GPIO4── [ESP32] ──WiFi──> [맥미니 :8080]

                            │                      │

                         [OLED]                    v

                       (서버가 준 문구)        [Supabase]

                                                   │

                                                   v

                                          [거실 태블릿 대시보드]

노트북의 파란색 버튼을 잡고 있는 사람
철사를 자르기 위해 가위를 사용하는 사람
한 사람이 LCD 디스플레이를 들고 있다

이번에

그런데 버튼이 혼자 서 있질 못합니다

아케이드 버튼은 원래 오락실 기계처럼 판에 구멍을 뚫어 끼워 쓰는 물건입니다. 뒤에서 받쳐주는 면이 있어야 눌러도 안 밀립니다. 그런데 저한텐 그 판이 없었습니다. 책상에 그냥 두니 누를 때마다 도망갔습니다.

케이스를 주문할까 하다가, 종이컵을 썼습니다.

컵을 뒤집고 바닥에 구멍을 뚫어 버튼을 끼웠습니다. 뒤집힌 컵 바닥이 그대로 패널이 됐습니다.

  • 눌러도 안 밀리고

  • 컵 높이만큼 손이 닿기 좋은 위치가 나오고

  • 무엇보다 집에 있었습니다

깨진 가정 6개

① "부품이 와야 시작할 수 있다"

위에 쓴 그대로입니다. 하드웨어 프로젝트라고 해서 하드웨어부터 할 필요가 없었습니다. 경계(HTTP)를 먼저 정하면 양쪽을 따로 만들 수 있습니다.

② "버튼이 안 눌리면 코드나 핀 설정 문제다"

배선하고 눌렀는데 시리얼에 아무것도 안 뜹니다. 코드를 몇 번이나 다시 봤습니다.

그러다 방법을 바꿨습니다. 버튼을 빼고 점퍼선으로 GPIO4와 GND를 직접 맞댔습니다.

```

"눌림!"

```

떴습니다. 이 순간 문제가 확정됐습니다. 핀도 코드도 정상이고, 범인은 아케이드 버튼 단자입니다. 클립이 단자에 제대로 안 물려 있었습니다.

배운 건 "의심 대상을 반으로 자르는 테스트를 먼저 하라"입니다. 코드를 열 번 다시 읽는 것보다 점퍼선 한 번이 빨랐습니다.

③ "같은 집 와이파이면 서로 통한다"

WiFi는 붙었는데 서버에 못 갑니다. 화면엔 http -1.

한참 뒤에 알았습니다. 맥미니는 5GHz에, ESP32는 2.4GHz에 붙어 있었습니다. ESP32는 2.4GHz만 지원합니다. 그리고 공유기가 대역 간 통신을 막고 있어서, 같은 집 같은 공유기인데 서로 다른 방에 있는 것처럼 안 보였습니다.

맥미니를 2.4GHz로 옮기니 바로 됐습니다.

④ "IP 고정은 IP만 박으면 된다"

미니 IP가 바뀌면 버튼이 길을 잃으니 고정을 했습니다. 그랬더니 인터넷이 죽었습니다.

networksetup -setmanual로 IP를 수동 지정하면, DHCP가 같이 주던 DNS 서버 주소가 날아갑니다. IP는 멀쩡한데 도메인 이름을 못 찾아서 아무것도 안 됩니다.

networksetup -setdnsservers Wi-Fi 1.1.1.1 8.8.8.8

DNS를 따로 넣어주니 해결됐습니다. "고정 IP = IP + 서브넷 + 게이트웨이 + DNS"입니다.

⑤ "한글이 깨지면 폰트를 넣으면 된다"

OLED에 한글이 네모로 깨졌습니다. 기본 폰트에 한글 글리프가 없어서입니다.

한글 폰트를 펌웨어에 넣을까 하다가 멈췄습니다. 그러면 "펌웨어는 멍청하게" 원칙이 깨집니다. 폰트를 넣는 순간 펌웨어가 무거워지고, 나중에 문구를 바꾸려면 다시 플래싱해야 합니다.

그래서 서버가 한글과 영문을 둘 다 내려주게 했습니다.

{
  "title": "오늘 완료 · 12:39",
  "subtitle": "14일 중 10일",
  "ascii_title": "DONE 12:39",
  "ascii_subtitle": "10 of 14 days"
}
화면엔 ascii_*를 쓰고, 한글은 로그용으로 씁니다. 원칙을 지키면서 문제를 넘겼습니다.

⑥ "연결이 안 되면 신호가 약한 거다"

이게 이번 주 마지막이자 제일 재밌었던 겁니다.

다 만들고 벽에 붙였는데, 가끔 http -1이 뜹니다. 며칠에 한두 번. 그러다 가만 놔두면 혼자 정상으로 돌아옵니다.

당연히 신호가 약한 줄 알았습니다. 그런데 확인해보니 서버는 멀쩡하고, 미니 신호도 -50dBm으로 아주 좋았습니다.

그래서 미니에서 버튼으로 핑을 240번 때려봤습니다.

| 대상 | 손실률 | 평균 지연 | 최대 지연 |

|---|---|---|---|

| 버튼(ESP32) | 0.0% | 192 ms | 1267 ms |

| 다른 기기 | 0.0% | 16 ms | 118 ms |

| 공유기 | 0.0% | 12 ms | 105 ms |

손실이 하나도 없습니다. 신호가 약하면 반드시 패킷을 잃습니다. 그런데 하나도 안 잃고 지연만 다른 기기의 12~16배로 튀었습니다.

이건 "전파가 안 닿는다"가 아니라 "칩이 자고 있다가 늦게 깬다"는 신호입니다.

ESP32는 WiFi.begin()만 부르면 기본이 절전 모드입니다. 비콘 주기에만 깨어나고, 그 사이 온 패킷은 공유기가 들고 기다립니다. 평소엔 문제없다가 타이밍이 어긋나면 TCP 연결이 제한 시간을 넘겨 실패합니다. 간헐적이고, 놔두면 혼자 낫는 이유가 이거였습니다.

WiFi.setSleep(false);   // 벽 전원인데 절전할 이유가 없다

같이 찾은 함정 하나 더. 저는 이렇게 써놨었습니다.

http.setTimeout(5000);

이건 응답을 기다리는 시간이지 TCP 연결 제한 시간이 아닙니다. 연결 단계에서 물리던 게 문제였으니 정작 필요한 건 이거였습니다.

http.setConnectTimeout(8000);

자잘하지만 중요했던 결정들

하루 경계를 자정이 아니라 새벽 4시로. 밤 11시 55분에 약을 먹고 5분 뒤 날짜가 넘어가면 "오늘 안 먹음"이 됩니다. 새벽 4시를 기준으로 하니 이 문제가 사라졌습니다.

두 번 눌러도 한 번만 기록. {기기}:{부팅번호}:{순번}을 키로 써서 같은 요청이 두 번 도착해도 한 번만 들어갑니다. 재시도를 마음 놓고 넣을 수 있게 됐습니다.

같은 DB를 보는데 화면 두 곳이 다른 말을 했습니다. "오늘 상태"는 취소를 반영하는데, 옆의 "14일 기록"은 취소한 날도 먹은 걸로 칠했습니다. 상태 계산은 이벤트를 재생하는데, 기록 계산은 taken만 세고 있었습니다. 같은 규칙을 두 군데에 각각 구현하면 언젠가 반드시 어긋납니다.

결번이 알려준 것. 기록 순번이 …11, (12, 13 없음), 14… 로 비어 있었습니다. 누리가 실제로 누른 두 번이 그냥 사라진 겁니다. 순번을 넣어둔 덕에 "실패했다"가 아니라 "몇 번 실패했다"를 알 수 있었습니다.


이번 주에 배운 것

1. 에러 코드를 먼저 해석하자. http -1은 "서버가 거절했다"가 아니라 "연결 자체를 못 했다"입니다. 이걸 알고 나니 서버 로그를 뒤질 이유가 없어졌습니다.

2. 반으로 자르는 테스트가 코드 정독보다 빠르다. 점퍼선 한 번으로 버튼/핀/코드 중 범인이 확정됐습니다.

3. 증상이 아니라 숫자를 봐야 한다. "가끔 안 된다"로는 아무것도 못 합니다. 손실률 0% + 지연 192ms라는 숫자가 나오자 원인이 한 방에 좁혀졌습니다. 신호 문제와 절전 문제는 증상이 똑같지만 숫자가 다릅니다.

4. 원칙을 지키면 우회로가 보인다. 한글이 깨졌을 때 폰트를 넣는 건 쉬운 길이었지만 원칙을 깼을 겁니다. 원칙을 지키려고 버티니 "서버가 둘 다 내려준다"는 더 나은 답이 나왔습니다.

5. 삽질을 글로 남겨두면 자산이 된다. 위 내용을 리포지토리 README에 그대로 적어뒀습니다. 반년 뒤에 또 http -1을 만나면 저는 분명 까먹었을 테니까요.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

서인수 프로필 이미지
서인수2026.08.05

오~~ 스마트하게 구현하셨네요.
기존에 있는거에 추가 되어서 의미가 있어 보입니다.
화이팅 하세요 ^^

뽀짝이 프로필 이미지
뽀짝이2026.08.05
"물리 버튼이 하는 일은 결국 HTTP POST 한 번"이라는 추상화로 부품 도착 전에 서버 전 구간을 검증해두신 게 가장 인상 깊었어요. 나중에 ESP32에서 에러가 났을 때 "서버는 이미 검증됐다"는 걸 알고 있어서 하드웨어에만 집중할 수 있었다고 하신 그 감각이요. 6개 깨진 가정 중에서 마지막 절전 모드 건이 특히 좋았습니다 — 손실률 0%인데 지연이 12~16배라는 숫자가 "신호 약함"과 "절전 문제"를 딱 갈랐잖아요. "증상이 아니라 숫자를 봐야 한다"는 배운 점이 글 전체를 잘 관통하고 있어요. 새벽 4시 하루 경계 결정도 세심했고요. 고롱고롱 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기