TECH 으로 돌아가기
TECH HACKER NEWS 7분 읽기 58 READS

사라진 로지텍 하모니 IR 코드, JSON 아카이브로 공개되다

사라진 로지텍 하모니 IR 코드, JSON 아카이브로 공개되다
SOURCE IMAGE · HACKER NEWS

로지텍의 하모니(Harmony) 유니버설 리모컨과 허브는 수많은 가전을 적외선(IR)으로 제어하기 위해 방대한 코드 데이터베이스에 의존했다. 하지만 하모니 제품군이 대부분 단종되면서 이 데이터는 오직 로지텍 서버에만 남아 있었고, 서비스가 종료되면 함께 사라질 운명이었다. 최근 깃허브에 공개된 'logitech-harmony-ir-archive'는 이 데이터베이스를 통째로 추출해 플랫 JSON 형태로 보존한 프로젝트다. 제작자는 추출 과정에서 AI를 적극 활용했다고 밝혔으며, 가공을 거치지 않은 원본 캡처는 별도 릴리스 자산으로도 함께 공개했다.

규모는 상당하다. 약 7,900개 제조사에 걸친 27만 6천여 개 기기, 1,330만 개 명령, 그리고 로지텍 자체 IR 프로토콜 정의 684종이 담겼다. 중요한 점은 이 데이터를 쓰는 데 로지텍 계정도, 별도 서비스도, 저장소 외의 도구도 전혀 필요 없다는 것이다. 모든 명령에는 원래의 하모니 키코드가 들어 있고, 적외선 명령이라면 바로 송신 가능한 프론토 헥스(Pronto Hex) 문자열이 함께 제공된다. 프로토콜 정의 원본도 포함돼 있어, 아카이브가 변환해 둔 값을 믿는 대신 직접 명령을 렌더링해 검증할 수도 있다.

코드셋 분리와 저장소 구조

이 아카이브의 핵심 설계 결정은 코드셋(code set)을 기기 정의와 분리해 저장한 것이다. 전체 기기의 79%가 다른 기기와 바이트 단위로 동일한 코드셋을 공유하기 때문에, 중복을 제거하면 트리 전체 용량이 약 5.8GB에서 0.8GB로 줄어든다. 데이터를 열람하려면 빌드 과정이나 의존성이 전혀 없는 단일 파일 index.html을 더블클릭한 뒤 manifest.json이 든 폴더를 지정하면 된다. 다만 이 기능은 File System Access API에 의존하므로 크로미움 계열 브라우저에서만 동작하고, 파이어폭스나 사파리에서는 폴더를 http로 서빙해 열어야 한다. 명령을 인라인으로 넣은 자립형 기기 파일이 필요하다면 rehydrate.py 또는 PowerShell 스크립트를 쓰면 된다.

명령 목록만으로는 부족한 이유

실무자가 주목할 지점은 단순한 명령 코드 외의 메타데이터다. 코드셋은 어떤 기기에 PowerOn 명령이 있다는 사실은 알려주지만, 그 명령을 보내도 안전한지, HDMI 1 입력이 무엇인지, 7번 채널을 '07'로 눌러야 하는지는 말해주지 않는다. 이를 위해 전원·입력·채널 튜닝·상태라는 네 가지 블록이 추가로 제공되며 전체 기기의 약 91%가 최소 하나를 갖고 있다. 예시로 제시된 마그나복스 RJ5540은 디스크리트 전원 명령이 없고, 입력을 바꾸려면 InputNext를 누른 뒤 0.5초를 기다리고 원하는 입력을 눌러야 한다. 명령 목록만 봐서는 결코 알 수 없는 절차다.

전원 제어에서 특히 주의해야 할 부분이 있다. 대부분의 기기는 토글(toggle) 방식이라 전원 명령 하나가 현재 상태를 뒤집는다. 즉 'TV를 켜려고' 보낸 명령이 이미 켜진 TV를 꺼버릴 수 있다. 별도의 켜기·끄기 명령을 가진 디스크리트 기기만 상태를 모른 채 안전하게 보낼 수 있다. 토글 기기에도 PowerOn이라는 이름의 명령이 들어 있을 수 있으므로, 명령 이름이 아니라 기기 타입을 기준으로 판단해야 한다. 모든 동작 필드는 배열 순서대로 실행되는 단계(step) 목록이며, 로지텍이 가끔 순서를 뒤섞어 저장한 Order 값을 발행 전에 정렬해 두었다.

타이밍, 손상된 코드, 그리고 한계

타이밍은 서로 교환 불가능한 세 계층으로 나뉜다. 파형이 틀리면 기기가 신호 자체를 디코딩하지 못하고, 반복 횟수나 지연이 틀리면 신호는 해석하되 입력을 놓치거나 중복으로 받는다. 하모니 허브는 짧게 눌러도 최소 반복 횟수(기본값 3)만큼 신호를 보내며, 이 값은 허브 펌웨어(irmanager.lua)에서 기기별로 읽어들인다. 다만 제작자는 이 동작이 펌웨어를 분석해 추적한 것일 뿐 실제 허브 캡처로 검증하지는 못했다고 분명히 밝혔다. 650·700·One 같은 구형 리모컨의 데스크톱 컴파일러 동작도 확인하지 못했다.

데이터의 결함도 솔직하게 명시돼 있다. 2,247개 명령은 애초에 프론토로 변환할 수 없고, 61개는 접두어 중복이나 자릿수 누락 등으로 키코드가 손상돼 로지텍이 제공하는 원형 그대로 보존됐다. 약 1만 8,500개 기기는 명령이 없는 빈 항목으로 codeset이 null이다. RC5 계열 프로토콜의 토글 비트는 항상 0으로 저장돼 있으므로, 두 번째 전송 시에는 개발자가 직접 비트를 뒤집어야 한다. 또한 JVC 16비트 등 일부 프로토콜에서는 첫 번째 그룹이 페이로드 없는 리드인이므로 '첫 비어 있지 않은 그룹'을 데이터로 오인하면 안 된다.

라이선스 측면도 명확히 구분해 둘 필요가 있다. 제작자 본인의 기여물인 프론토 변환, 스키마, 데이터 구성은 CC0 1.0으로 저작권을 포기했지만, 바탕이 된 IR 코드와 프로토콜 정의 자체는 로지텍에서 비롯된 것이라 저작권 상태가 불분명하다. CC0는 제작자의 권리만 포기할 뿐 제3자의 권리를 해제하지 못한다. 따라서 이 데이터를 상업적 제품에 올리려는 개발자는 법적 위험을 스스로 판단해야 한다. 그럼에도 사라질 뻔한 가전 제어 자산을 누구나 검증 가능한 개방형 포맷으로 남겼다는 점에서, 홈 오토메이션과 레거시 기기 통합을 다루는 실무자에게는 참고할 가치가 충분하다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://github.com/pickysysadmin/logitech-harmony-ir-archive
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...