# 기기 설정
Qualcomm Dragonwing^™^ RB3 Gen 2 개발 키트에는 설정 프로세스를 간소화하기 위해 미리 로드된 소프트웨어가 포함되어 있습니다. Ubuntu, Windows^®^ 또는 macOS^®^ 기반 호스트 컴퓨터를 사용하여 Dragonwing RB3 Gen 2 기기를 원활하게 구성할 수 있습니다.
참고
통합 애플리케이션 개발 환경을 사용하여 기기를 구성하려면 [Qualcomm Visual Studio Code Extension 참조 가이드](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html) 를 참조하세요.
다음 워크플로우를 사용하여 기기를 설정합니다.
**그림: Dragonwing RB3 Gen 2 개발 키트의 설정 워크플로우**
## 기기 전원 켜기
+12V 전원 어댑터를 연결하고 다음 중 하나를 수행합니다.
>
>
> - 전원 LED가 켜진 상태를 유지할 때까지 **Power** 버튼을 2~3초간 누릅니다.
> - USB Type-C를 USB Type-A 또는 Type-C 케이블에 연결하여 ADB 연결을 설정하고 소프트웨어를 플래시합니다.
## 디버그 UART 설정
디버그 UART는 진단 메시지를 표시하고 UART 셸을 통해 기기에 접근합니다. 호스트 컴퓨터 OS 기준으로 자세한 지침에 대한 옵션을 선택하세요.
Tab Ubuntu host
Tab Windows host
Tab macOS host
- *class* tabincludedirective
- 1. 마이크로 USB 케이블의 한쪽 끝을 개발 키트의 마이크로 USB 포트에 연결합니다.
**Figure: Location of the Micro USB port**
2. 마이크로 USB 케이블의 다른 쪽 끝을 호스트 컴퓨터에 연결합니다.
3. Ubuntu 호스트 컴퓨터에 `Screen` 애플리케이션을 설치하려면 다음 명령어를 실행합니다.
sudo apt update
Copy to clipboard
sudo apt install screen
Copy to clipboard
4. USB 포트를 확인하려면 다음 명령어를 실행합니다.
ls /dev/ttyUSB*
Copy to clipboard
**샘플 출력**
/dev/ttyUSB0
5. 디버그 UART를 열려면 다음 명령어를 실행합니다.
sudo screen
Copy to clipboard
**예시 명령어**: `sudo screen /dev/ttyUSB0 115200`
6. 디버그 UART를 연 후 **Enter** 키를 선택하여 인증 프롬프트를 표시합니다.
7. UART 콘솔에 로그인하려면 다음과 같이 지정합니다.
- **로그인**: `root`
- **비밀번호** : `oelinux123`
>
>
> 참고
>
>
> 인증 콘솔이 예상대로 표시되지 않으면 USB 연결을 확인하세요. 필요한 경우 마이크로 USB의 연결을 끊고 다시 연결하세요.
- *class* tabincludedirective
- 1. 마이크로 USB 케이블의 한쪽 끝을 개발 키트의 마이크로 USB 포트에 연결합니다.
**Figure: Location of the Micro USB port**
2. 마이크로 USB 케이블의 다른 쪽 끝을 호스트 컴퓨터에 연결합니다.
3. Windows 호스트 컴퓨터의 경우 [PuTTY](https://www.putty.org/) 를 다운로드합니다. 사용 중인 Windows(32비트 또는 64비트)에 맞는 버전을 선택하세요.
4. 설치 마법사를 실행하여 표시되는 안내에 따릅니다.
5. 설치 후 **Start** 메뉴의 설치된 프로그램 목록에서 PuTTY 애플리케이션을 열거나 작업 표시줄의 검색 표시줄을 사용하여 검색합니다.
6. **PuTTY Configuration** 대화 상자에서 다음을 수행합니다.
1. **Serial** 을 선택합니다.
2. **Windows Device Manager** 에서 감지된 UART 포트에 따라 **Serial line** 을 지정합니다.
참고
UART 포트가 감지되지 않으면 드라이버를 다운로드하고 Windows 장치 관리자를 사용하여 드라이버를 업데이트합니다.
- x86: [USB-to-UART 시리얼 드라이버](https://ftdichip.com/wp-content/uploads/2023/09/CDM-v2.12.36.4-WHQL-Certified.zip)
- Arm^®^: [https://oemdrivers.com/usb-ft232r-usb-uart-arm64](https://oemdrivers.com/usb-ft232r-usb-uart-arm64) 웹 페이지로 이동합니다. **Drivers** 섹션에서 **FTDI CDM VCP Drivers** 를 선택합니다.
3. 전송 속도를 **115200** 으로 설정합니다.
4. **Open** 을 클릭하여 PuTTY 세션을 시작합니다.
7. 시리얼 기기를 연 후 **Enter** 키를 선택하여 인증 프롬프트를 표시합니다.
8. UART 콘솔에 로그인하려면 다음 정보를 제공합니다.
- **로그인**: `root`
- **비밀번호** : `oelinux123`
- *class* tabincludedirective
- 1. 마이크로 USB 케이블의 한쪽 끝을 개발 키트의 마이크로 USB 포트에 연결합니다.
**Figure: Location of the Micro USB port**
2. 마이크로 USB 케이블의 다른 쪽 끝을 호스트 컴퓨터에 연결합니다.
3. macOS 호스트 컴퓨터에 연결된 시리얼 기기를 확인하려면 다음 명령어를 실행합니다.
ls /dev/cu.*
Copy to clipboard
4. 시리얼 기기 목록에서 시리얼 기기를 찾습니다. 이 기기는 목록에 표시됩니다.
5. 시리얼 기기를 열려면 다음 명령어를 실행합니다.
screen
Copy to clipboard
참고
- `` 를 기기 노드 이름으로 대체합니다.
- `` 를 적합한 전송 속도로 대체합니다.
**예시 명령어** `ceteam@Qualcomms-MacBook-Pro ~ % screen /dev/cu.usbserial-DM03SDQQ 115200`
6. 시리얼 기기를 연 후 **Enter** 키를 선택하여 인증 프롬프트를 표시합니다.
7. UART 콘솔에 로그인하려면 다음 정보를 제공합니다.
- **로그인**: `root`
- **비밀번호** : `oelinux123`
## Qualcomm Linux 버전 확인
Qualcomm Linux 버전을 확인하려면 기기 셸에서 다음 명령어 중 하나를 실행하세요.
- >
>
> uname -a
> Copy to clipboard
Qualcomm Linux 버전이 출력 결과로 표시됩니다.
>
>
> Linux qcs6490-rb3gen2-vision-kit 6.6.90-qli-1.5-ver.1.1-04509-gc4b8666c9a55-dirty #1 SMP PREEMPT Fri Jun 20 13:11:29 UTC 2025 aarch64 GNU/Linux
또는
- >
>
> cat /etc/os-release
> Copy to clipboard
Qualcomm Linux 버전이 출력 결과로 표시됩니다.
>
>
> ID=qcom-wayland
> NAME=”Qualcomm Linux”
> VERSION=”1.5-ver.1.1”S
> VERSION\_ID=1.5-ver.1.1
> PRETTY\_NAME=”Qualcomm Linux 1.5-ver.1.1”
> CPE\_NAME=”cpe:/o:openembedded:qcom-wayland:1.5-ver.1.1”
>
>
> 참고
>
>
> 이러한 명령어는 Qualcomm Linux 1.3 이상 버전에서만 지원됩니다.
>
>
> 이전 버전의 Qualcomm Linux를 사용 중이고 업그레이드가 필요한 경우 [소프트웨어 업데이트](https://docs.qualcomm.com/doc/80-70020-251K/topic/upgrade-rb3gen2-software.html#upgrade-rb3gen2-software) 를 참조하세요.
## 네트워크에 연결
인터넷 연결을 수립하고 다음 방법 중 하나를 사용하여 기기 IP 주소를 검색하세요.
### 이더넷을 사용하여 연결
1. 이더넷 케이블의 한쪽 끝을 Dragonwing RB3 Gen 2 기기의 이더넷 포트(RJ45)에 삽입하고 다른 쪽 끝을 네트워크 라우터에 연결합니다.
**Figure: Location of the Ethernet port**
2. 연결을 설정한 후 UART 시리얼 콘솔에서 다음 명령어를 실행하여 IP 주소를 가져옵니다.
ifconfig eth2
Copy to clipboard
참고
연결을 설정할 수 없는 경우 [USB 및 이더넷 컨트롤러 펌웨어 업데이트](https://docs.qualcomm.com/doc/80-70020-251K/topic/faqs.html#usb-firmware) 를 참조하세요.
### Wi-Fi를 사용하여 연결
기기가 스테이션 모드에서 Wi-Fi를 작동합니다. 장치가 부팅되면 Wi-Fi 호스트 드라이버를 초기화하고 네트워크 관리를 위해 인증합니다. `nmcli` 명령줄 도구를 사용하여 무선 연결을 설정할 수 있습니다.
1. 무선 액세스 포인트(Wi-Fi 라우터)에 연결하려면 다음 명령어를 실행합니다.
>
>
> nmcli dev wifi connect password
> Copy to clipboard
>
>
> **예시**
>
>
> root@qcs6490-rb3gen2-vision-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘d7b990bd-3b77-4b13-b239-b706553abaf8’.
2. 연결 및 기기 상태를 확인하려면 다음 명령어를 실행합니다.
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. WLAN 연결 상태 및 IP 주소를 확인하려면 다음 명령어를 실행합니다.
>
>
> ifconfig wlan0
> Copy to clipboard
>
> 
4. 연결이 활성화되었는지 확인하려면 퀄컴 같은 웹 사이트에 핑(ping)을 전송합니다.
>
>
> ping qualcomm.com
> Copy to clipboard
## SSH에 연결
SSH는 호스트 컴퓨터와 Dragonwing RB3 Gen 2 기기 간의 보안 파일 전송을 구현합니다.
SSH를 연결하려면 우선 기기가 네트워크에 연결되어 있는지 확인하세요.
1. 네트워크 연결 유형에 따라 Dragonwing RB3 Gen 2 기기의 IP 주소를 찾으려면 호스트 컴퓨터의 UART 콘솔에서 해당 명령어를 실행합니다.
이더넷:
ifconfig eth2
Copy to clipboard
Wi-Fi:
ifconfig wlan0
Copy to clipboard
2. 호스트 컴퓨터에서 다음 명령어를 실행하여 기기에 SSH 연결을 설정합니다. **1단계** 에서 가져온 IP 주소를 사용합니다.
ssh root@ip-address
Copy to clipboard
**예시**
`ssh root@192.168.0.222`
3. SSH 셸에 연결하려면 다음 비밀번호를 입력합니다.
oelinux123
Copy to clipboard
참고
원격 호스트와 기기가 같은 Wi-Fi 액세스 포인트에 연결되어 있어야 합니다.
## HDMI 디스플레이에 연결
연결된 디스플레이에서 샘플 애플리케이션의 출력을 보려면 다음 단계를 따릅니다.
1. HDMI 케이블의 한쪽 끝을 개발 키트의 HDMI 포트에 연결합니다.
2. HDMI 케이블의 다른 쪽 끝을 디스플레이 모니터에 연결합니다.
**그림: HDMI 포트 및 전원 버튼의 위치**
3. 기기의 전원을 켜고 HDMI 디스플레이를 확인합니다. 디스플레이 모니터에서 다음 패턴을 찾습니다.
**그림: Weston 꽃 패턴**
디스플레이가 예상대로 표시되지 않으면 **DIP\_SW\_0** 의 **Switch 4** 를 OFF로 전환합니다. 자세한 내용은 [DIP 스위치](https://docs.qualcomm.com/doc/80-70020-251K/topic/references.html#dip-switches) 를 참조하세요.
문제가 지속되면 [HDMI 디스플레이 디버그](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-18/debug.html#debug-hdmi-display) 를 참조하여 문제를 해결하세요.
## 다음 단계
- [호스트 컴퓨터를 사용하여 샘플 애플리케이션 실행](https://docs.qualcomm.com/doc/80-70020-251K/topic/run-apps-manually-on-host.html#run-apps-using-host-computer)
- [애플리케이션 개발](https://docs.qualcomm.com/bundle/publicresource/topics/80-79972-1/quick_start.html)
Last Published: Jan 28, 2026
[Previous Topic
하드웨어 개요](https://docs.qualcomm.com/bundle/publicresource/80-70020-251K/topics/rb3_hardware_overview.md) [Next Topic
샘플 애플리케이션 실행](https://docs.qualcomm.com/bundle/publicresource/80-70020-251K/topics/demo_app.md)