Matter 가상 기기 개발 환경

기기 SDK

Matter Virtual Device Development Environment (MVD-DE)Matter Virtual Device (MVD)를 만들고 Virtual Device Controller (VDC) 데스크톱 앱을 사용하여 가상 Matter 기기의 상태를 제어하고 표시하는 그래픽 사용자 인터페이스를 제공할 수 있는 Docker 컨테이너입니다. 앱은 가상 기기를 시각적으로 표현하는 것은 물론 기기에서 지원하는 Matter 클러스터의 컨트롤을 제공합니다.

앱은 RPC 클라이언트를 사용하여 가상 기기의 RPC 서버와 통신하고, 작업 (전원 전환, 어둡게 하기, 밝게)을 반영하는 요청을 전송하고 1초에 한 번씩 폴링하여 상태를 가져옵니다.

지원되는 기기

현재 MVD-DE는 다음과 같은 Matter 기기 유형을 지원합니다.

Matter 기기 유형 애플리케이션 클러스터 홈 생태계 유형
접촉 센서 불리언 상태 센서
밝기 조절 가능 조명 사용/사용 안 함
수준 제어
약함
확장 컬러 조명 켜기/끄기
레벨 컨트롤
색상 관리
약함
유량 센서 흐름 측정 센서
습도 센서 상대 습도 측정 센서
조도 센서 조도 측정 센서
사람 감지 센서 사람 감지 센서
조명 켜기/끄기 사용/사용 중지 약함
콘센트 사용/사용 안 함
수준 제어
콘센트
압력 센서 압력 측정 센서
발표자 사용/사용 안 함
수준 제어
스피커
스위치 사용/사용 중지 Switch
온도 센서 온도 측정 센서

Matter 가상 기기 개발 환경 설정

MVD-DE는 Docker Hub에서 사용할 수 있는 사전 구성된 Docker 이미지입니다. 설치하려면 다음을 실행합니다.

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

이 작업을 완료하려면 몇 분 정도 걸릴 수 있습니다.

Matter 가상 기기 개발 환경 실행

  1. Docker 컨테이너를 시작합니다.

    user@host> xhost local:1000
    user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
    

    컨테이너를 시작하면 몇 가지 진단 출력이 표시된 후 컨테이너 구성이 올바르다는 메시지가 표시되고 마지막으로 컨테이너 셸 프롬프트가 표시됩니다.

    Environment looks good, you are ready to go!
    
  2. 두 번째 터미널 세션 인스턴스를 만듭니다.

    user@host> docker exec -it matter-container /bin/bash
    
  3. 가상 Matter 기기의 경우 기기가 실행되면 VDC를 시작하고 --s 인수와 기기에서 사용하는 IP 포트를 전달합니다.

    $ electron main.js --s=localhost:33000
    

    실제 기기의 경우 VDC를 시작하여 --d 인수에 그 뒤에 기기 직렬 포트를 전달합니다.

    $ electron main.js --d=/dev/ttyUSB0
    

인수를 제공하지 않고 VDC를 시작하면 localhost 포트 33000을 사용하여 기본적으로 네트워크 소켓 옵션이 설정됩니다.

VDC가 기기에 연결되면 기기 상태를 보여주는 화면이 표시됩니다.

가상 기기 그래픽 사용자 인터페이스

기기의 QR 코드 표시

VDC는 기기 커미셔닝 흐름의 일부로 QR 코드를 검색하는 데도 사용할 수 있습니다. 기기 이미지 옆에 있는 QR 코드 아이콘을 클릭하여 이 기기의 QR 코드를 표시합니다.

기기의 QR 코드를 표시하는 가상 기기 컨트롤러

이 QR 코드를 사용하여 기기를 커미셔닝할 수 있습니다.

Matter 가상 기기 개발 환경 중지

MVD-DE를 중지하려면 포커스가 VDC인 상태에서 Control-Q를 누르거나 앱을 시작한 터미널 세션에서 Control-C를 누릅니다.

의견

MVD-DE 사용 경험을 개선할 방법에 관한 생각이나 의견을 제출하려면 의견 양식을 작성하세요.

의견 보내기