기록
[GPT가 알려주는] Matter Virtual Device를 Android Studio에 연결하기 본문
matter virtual device를 wsl에서 띄웠는데
이거 android studio에 연결 어떻게 해?
네, WSL(Windows Subsystem for Linux)에서 띄운 Matter virtual device를
Android Studio의 Matter Controller 앱과 연결할 수 있습니다.
다만 몇 가지 설정이 필요해요. 아래 과정을 확인하세요:
✅ 1. WSL의 가상 디바이스 IP 확인
Matter virtual device는 WSL 내부에서 동작하므로,
WSL의 IP 주소가 Android 앱에서 접근 가능해야 합니다.
ip addr show eth0
위 명령으로 나온 IP 중 inet 항목 예: 172.20.117.58 등을 확인하세요.
✅ 2. Matter virtual device 실행 시 포트 확인
예를 들어 chip-tool로 디바이스를 띄울 때:
out/all-clusters-app/chip-all-clusters-app --secured-device-port 5540
- Matter 디바이스는 보통 5540 포트를 사용합니다.
- 이 포트가 **WSL 밖(Android 앱)**에서도 접근 가능해야 해요.
✅ 3. Android 앱(Android Studio)의 Commissioner 연결 대상 수정
Android에서 Matter 디바이스에 연결하려면 다음을 설정합니다:
- 연결할 IP: 위에서 확인한 WSL의 IP (예: 172.20.117.58)
- 포트: 디바이스 앱이 사용하는 포트 (예: 5540)
보통 Matter Controller 앱에서는 Manual Commissioning 기능이나 Network Scan 시 대상 IP와 포트를 설정할 수 있어야 합니다. 아니면 코드에서 직접 SetupPayload나 commissioning window 연결 시 정보를 수정해야 해요.
✅ 4. WSL 방화벽 설정 (필요시)
- WSL2는 가상 네트워크 인터페이스를 사용하므로 Windows에서 WSL2로의 포트 포워딩이 필요할 수 있습니다.
- 다음 명령어로 포트 포워딩을 설정할 수 있습니다:
netsh interface portproxy add v4tov4 listenport=5540 listenaddress=0.0.0.0 connectport=5540 connectaddress=<WSL_IP>
✅ 5. Android 기기와 WSL이 같은 네트워크에 있는지 확인
- 만약 Android Studio의 에뮬레이터 대신 실제 안드로이드 기기를 사용한다면, PC와 같은 Wi-Fi에 연결되어 있어야 WSL에 접근 가능해요.
🧪 테스트
- Android 앱에서 Commissioning 시도 → WSL의 디바이스 로그에서 연결 요청이 오는지 확인
추가 팁
- Matter 디바이스가 commissioning window를 열어야 연결 가능
- 예시:
chip-tool pairing onnetwork 1234 20202021 --commissioner-name my-commissioner
필요하면 디버그 로그나 연결 실패한 메시지 알려줘! 어디서 막히는지 함께 확인해줄게 🙂