맥북은 덮개가 닫혀 있거나 화면이 꺼진 상태에서도 ‘나의 찾기’, 네트워크 연결, 시스템 관리 작업을 위해 잠깐 깨어날 수 있습니다. macOS에서는 이를 DarkWake라고 하며 정상적인 기능입니다.

다만 이 과정에서 QK Alice Duo가 USB 연결을 재개하면서 LED를 켜거나, 실제로 누르지 않은 키 입력 신호를 보내 맥북의 절전이 완전히 풀리는 현상(Full Wake)이 발생할 수 있습니다.

이 문제로 인해,  특정 서비스들이(LogiOptions+ 등등) 죽거나,오류가 생겨서 재부팅을 해야하거나 다시 실행해야하는 일이 생깁니다.

저는 QK Alice Duo를 직접 사용하는 개발자로서 이 문제를 실제로 재현하고, macOS 절전 로그와 QK Alice Duo v1.0.6 master 펌웨어의 USB 및 키보드 입력 처리 구조를 분석해 두 가지 개선 펌웨어를 개발했습니다.

두 펌웨어 모두 원본 UF2 구조와 무결성, 변경 범위, USB 장치 정보 보존, 키보드 입력 처리, Cortex-M4 에뮬레이션을 검증했습니다. 이후 실제 QK Alice Duo에 직접 플래시해 macOS DarkWake와 정상 사용 환경을 시험했으며, 두 버전 모두 계획한 대로 정상 작동하는 것을 확인했습니다.

DarkWake 자체는 macOS의 정상 기능이므로 차단하지 않습니다. 대신 DarkWake 중 QK Alice Duo에서 발생하는 불필요한 키 입력과 LED 동작만 제어하도록 개발했습니다.

1. DarkWake Guard — 기존 LED 동작 유지·실기기 검증판

파일명:

qk_alice_master_v1.0.6_darkwake_guard.uf2

SHA-256:

73e4f2a34a45820f9a38ea7cd4a0ff0cf43e4ce6d955abd1918e43380cea739f

맥북이 백그라운드 작업을 위해 잠깐 깨어나는 DarkWake 중 QK Alice Duo에서 발생하는 잘못된 키 입력 신호를 일시적으로 차단합니다. 키보드 LED 동작은 기존 펌웨어와 동일하게 유지됩니다.

실제 QK Alice Duo에 적용한 후 ‘나의 찾기’를 이용해 DarkWake를 두 차례 발생시켜 시험했습니다. 시험 결과 QK 키보드에서 잘못된 키 입력이나 사용자 활동 신호가 발생하지 않았으며, 키보드 때문에 맥북의 절전이 완전히 풀리는 현상도 관찰되지 않았습니다.

장점

  • 원본 펌웨어의 동작을 최대한 유지하면서 잘못된 키 입력만 차단합니다.
  • 기존 LED 동작과 사용 방식을 그대로 유지합니다.
  • 실제 QK Alice Duo에서 DarkWake 시험을 완료했습니다.
  • 최소한의 동작 변경을 원하는 사용자에게 적합합니다.
  • 별도의 macOS 프로그램이나 백그라운드 에이전트가 필요하지 않습니다.

한계

  • DarkWake 중 키보드 LED가 켜질 수 있습니다.
  • 맥북 덮개를 연 직후 너무 빠르게 누른 첫 키가 드물게 인식되지 않을 수 있습니다.

2. DarkWake Press & LED Guard — 실제 키 활성화·실기기 검증판

파일명:

qk_alice_master_v1.0.6_press_led_guard.uf2

SHA-256:

248df749c37a3e95a3300d89396bc4699f42138cf30c674724828cca7b80f69b

DarkWake 중 QK Alice Duo의 LED가 켜지지 않도록 유지하면서, 실제로 누르지 않은 잘못된 키 입력 신호도 계속 차단합니다.

맥북 덮개를 여는 것만으로는 키보드 LED가 켜지지 않습니다. 실제 QK 키를 누르면 해당 키 입력이 정상적으로 전달되고, 잠들기 전에 LED가 켜져 있었다면 LED도 함께 복구됩니다. 사용자가 잠들기 전에 LED를 꺼두었다면 계속 꺼진 상태를 유지합니다.

정적 검증과 Cortex-M4 펌웨어 에뮬레이션을 마친 뒤 실제 QK Alice Duo에 직접 플래시해 시험했습니다. 시험 결과 DarkWake 중 LED가 꺼진 상태로 유지되고 잘못된 키 입력이 차단됐으며, 실제 키를 누르면 LED와 정상 키 입력이 복구되는 것을 확인했습니다.

장점

  • DarkWake 중 LED와 잘못된 키 입력을 모두 차단합니다.
  • 반복해서 발생하는 잘못된 키 입력도 계속 차단합니다.
  • 실제로 누른 첫 키 입력은 정상적으로 전달됩니다.
  • 잠들기 전 LED가 켜져 있었을 때만 LED를 복구합니다.
  • 실제 QK Alice Duo에서 정상 작동을 확인했습니다.
  • 별도의 macOS 프로그램이나 백그라운드 에이전트가 필요하지 않습니다.

한계

  • 맥북 덮개를 연 후 실제 QK 키를 누르기 전까지 키보드 LED가 꺼져 있습니다.
  • 덮개를 여는 것만으로 LED가 자동 복구되는 기존 동작을 원하는 사용자에게는 적합하지 않을 수 있습니다.

적용 대상 및 주의사항

두 파일 모두 QK Alice Duo v1.0.6 master 전용으로 개발하고 검증했습니다.

다음 항목은 변경하지 않습니다.

  • VIA 키맵 및 사용자 설정
  • VIA Raw HID 통신
  • 마우스 입력
  • 미디어키 및 시스템 제어키
  • RGB 밝기, 색상 및 효과 설정
  • USB 장치 정보와 펌웨어 버전 정보

적용하기 전에 공식 원본 펌웨어와 VIA 키맵을 백업하는 것을 권장합니다.

QK Modified VIA의 master Local Upgrade 기능에서 선택한 UF2 파일을 적용해야 합니다. 이 파일을 host, left, right 장치에 적용하면 안 됩니다.

전체 메모리를 삭제하는 mass erase 방식은 사용하지 마세요.