스마트싱스에 Xiaomi 제품 연동을 위한 SmartApp ‘KuKu Mi’ – Mi Remote 연동

‘KuKu Mi’ Mi Remote 연동

 

0. 준비

기본적으로 아래와 같은 환경이 필요

  • ‘MiHome’에서 ‘Mi Remote’ 제품 등록된 상태

  • ‘Docker’ 시스템 툴
  • NAS or Micro or Mini server

 

1. ‘KuKu Mi’ Web & API Server 실행

1-1) ‘KuKu Mi’ Docker Image 다운로드

[X86 Platform]
# docker pull turlvo/kukumi

[ARM Platform]
# docker pull turlvo/kukumi-rasp

 

1-2) 다운받은 Docker Image로 Container 실행
(–privileged 옵션을 넣어야 추후 ‘KuKu Mi’에서 BT시스템에 접근 가능)

[X86 Platform]
# docker run --name=KuKuMi --net=host --privileged turlvo/kukumi
[ARM Platform]
# docker run --name=KuKuMi --net=host --privileged turlvo/kukumi-rasp

 

1-3) 재부팅시마다 1-2)에서 생성한 ‘KuKu Mi’ Container를 재시작하도록 설정(Optional)

# sudo vim /etc/systemd/system/kukumi.service

    <kukumi.service 파일 내용>

    [Unit]
    Description=KuKuMi container
    Requires=docker.service
    After=docker.service

    [Service]
    Restart=always
    ExecStart=/usr/bin/docker start -a KuKuMi
    ExecStop=/usr/bin/docker stop -t 2 KuKuMi

    [Install]
    WantedBy=multi-user.target
# sudo systemctl enable /etc/systemd/system/kukumi.service

2. ‘KuKu Mi’ Web Server에서 ‘Mi Remote’ 설정

2-1) 웹브라우저로 아래 주소에 접속

‘http://[KuKu Mi api Server’s IP]:8484/’
ex) http://192.168.1.137:8484/

2-2) ‘Mi Remote’ 기기 등록

– ‘Mi Remote Device’ 선택
– ‘Auto Add’로 ‘Mi Remote’ device 검색 후 결과에서 원하는 Device 선택 후 Add
(Manual시에는 이름에 공백없이)

2-3) ‘Mi Remote’ 명령어 추가

(여기선 학습기능으로 설명)
– ‘Mi Remote’ device 중 학습 기능을 이용 할 device를 선택 후  ‘Learn’ 클릭

 

– 화면이 어두운 상태에서 위에서 선택한 ‘Mi Remote’ 기기에 리모콘 명령 발사
– 제한시간 10초안에 정상적으로 IR 신호를 받지 못 하면 Timeout 처리 됨

 

– 정상적으로 ‘Mi Remote’에서 수신이 되면 자동으로 ‘Code’ 부분에 입력됨
– ‘Name’은 공백 없이 원하는 값을 입력
(모든 기기에서 사용 할 수 있기 때문에, 아래와 같이 커맨드 기기 종류 + 명령어 이름 조합이 좋음)
ex) tv-volume-down
– ‘Add’ 버튼으로 저장

 

 

2-4) ‘Mi Remote’ 기기 추가 및 IR 명령어 추가 완료 모습

=> ‘KuKu Mi’ SmartApp에서 여기서 저장 된 기기 정보와 IR 명령어 정보를 사용한다.

3.’KuKu Mi’ DTH와 SmartApp 설치

3-1) ST IDE에서 ‘KuKu Mi’ DTH source 들을 추가

3-2) ST IDE에서 ‘KuKu Mi’ SmartApp source를 추가

https://github.com/turlvo/KuKuMi

GitHub Repository Integration
- Owner : turlvo
- Name : KuKuMi
- Branch : master

4. 스마트싱스 앱에서 ‘KuKu Mi’ SmartApp 설치

4-1) ‘KuKu Mi’ SmartApp 설치

– Add a SmartApp’ -> ‘My SmartApp’ ->  ‘KuKu Mi’ 선택

 

– ‘KuKu Mi’ container 실행 중인 Server 의 IP와 Port 8484 입력
ex) 192.168.1.137:8484
– 입력 완료 후 ‘Save’ 버튼 클릭으로 설치 완료

 

4-2) 원하는 타입의 기기 생성

– ‘Automation’ -> ‘SmartApps’ -> ‘KuKu Mi’ 진입
– ‘Add a device…’ 선택
– ‘Xiaomi Product Type’ 선택

 

– 추가할 기기의 타입 선택. (현재는 ‘Mi Remote’ 만 지원)
– ‘Mi Remote Device’ 메뉴에서 추가할 기기가 이용할 ‘Mi Remote’ 기기 선택
(‘KuKu Mi’ Web Server에서 추가했던 기기목록)

 

– ‘device name’ 에 원하는 이름 입력
– 이 기기의 ‘DTH Type’을 선택
(선택에 따라 홈킷 기기 종류  및 버튼 레이아웃이 달라짐)

 

– Next’선택하여 커맨드 맵핑화면으로 진입
– 이 기기에서 사용 할 버튼들에 IR 명령어 맵핑
(‘KuKu Mi’ Web Server에서 추가했던 명령어들)

 

– (선택사항) 추가로 이 기기의 상태 싱크를 위한 방법 선택
– ‘Save’ 버튼으로 설정을 완료
– 스마트앱 첫화면에 추가된 기기가 보임

 

4-3) 기기 목록에서의 설치 된 기기 모습과 세부 내부 모습(Custom DTH)

댓글 남기기

71 thoughts on “스마트싱스에 Xiaomi 제품 연동을 위한 SmartApp ‘KuKu Mi’ – Mi Remote 연동”