Contents
see List맥북은 덮개가 닫혀 있거나 화면이 꺼진 상태에서도 ‘나의 찾기’, 네트워크 연결, 시스템 관리 작업을 위해 잠깐 깨어날 수 있습니다. macOS에서는 이를 DarkWake라고 하며 정상적인 기능입니다.
다만 이 과정에서 QK Alice Duo가 USB 연결을 재개하면서 LED를 켜거나, 실제로 누르지 않은 키 입력 신호를 보내 맥북의 절전이 완전히 풀리는 현상(Full Wake)이 발생할 수 있습니다. 거기에 qk alice duo 가 잦은 darkwake 를 일으켜 실제로는 꺼진상태에서 수십번씩 darkwake 로인한
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 동작만 제어하도록 개발했습니다.
다만 led 의 경우는 host,left,right 펌웨어도 수정을 해야해서 현재는 darkwake 때 키보드 led가 들어오는것은 따로 막지 않았습니다.
tool
| No | 작성일 | Title |
|---|---|---|
| 3368 | 2026. 08. 17. | Docker 이미지 용량과 보안 위험을 함께 줄이는 멀티 스테이지 빌드 실전 가이드 |
| 3336 | 2026. 08. 08. | GitHub Actions 빌드 시간을 줄이는 방법: 의존성 캐시와 변경 경로 분리 실전 가이드 |
| 3304 | 2026. 07. 31. | Git worktree로 여러 기능 브랜치를 동시에 작업하는 실전 가이드 |
| 3273 | 2026. 07. 23. | Docker 이미지 용량과 보안 함께 줄이기: 멀티 스테이지 빌드 실전 가이드 |
| 3244 | 2026. 07. 15. | Git pre-commit 훅으로 코드 품질 검사 자동화하기: Husky와 lint-staged 실전 설정 |
| 3227 | 2026. 07. 11. | QK Alice Duo v1.0.6 맥북 잠자기 개선 펌웨어 — DarkWake LED·오입력 차단, 실제 키 입력 시 복구 (4개 구성 세트) |
| 3226 | 2026. 07. 11. | QK Alice Duo v1.0.6 Firmware Fixes for Mac Background Wake-Ups (DarkWake) |
| 3190 | 2026. 07. 06. | Playwright 테스트 안정화 가이드: flaky 테스트를 줄이는 locator, trace, retry 설계 |
| 3151 | 2026. 06. 28. | GitHub Actions OIDC 배포: 장기 클라우드 키 없이 AWS 권한 연결하기 |
| 3095 | 2026. 06. 20. | Docker Buildx 캐시 운영 가이드: GitHub Actions 이미지 빌드 시간을 줄이는 레이어 설계 |