WSL로 Asus PE1000N Xavier NX 셋팅하기!!

 

엣지 디바이스 Xavier NX를 셋팅하면서 생겼던 이슈와 해결 방법들, 참고한 가이드를 저장해두고 보려고 글을 정리해본다

 

이번에 셋팅해본 디바이스는 Asus PE1000N Xavier NX 이다

전에 만져본 Nvidia AGX Xaiver과는 또 다른 점들이 있었는데 블로그 글과 공식 문서 가이드대로 따라가도 중간에 막히는 부분들이 있었다

 

SDK 매니저를 이용해 셋팅할 경우 우분투 환경이 필요한데 WSL 환경을 이용하였다. 

 

 

Asus PE1000N Xavier NX 해당 기종에 대해 외부 및 내부 구성을 잘 설명한 블로그 글을 참고하면 좋을 것 같다

아래의 블로그에서 디바이스에 대해 자세하게 설명을 잘 해두었다

• 외부 구성 : https://blog.naver.com/insunglab/222870244847
• 내부 구성 : https://blog.naver.com/insunglab/222874441448

 

아래 글은 WSL에서 Jetson OS Flash 에 관한 엔비디아 공식 문서이다. 이 글도 많이 참고하였다

• Nvidia Jetson OS Flash on WSL : https://docs.nvidia.com/sdk-manager/wsl-systems/index.html#wsl-systems-flash-jetson

Windows Subsystem for Linux (WSL) — SDK Manager 2.1.0 documentation

 

 

 

아래 글은 Asus PE1000N Xavier NX 공식 위키 문서이다.

해당 기기 리커버리 모드 진입은 아래에서 한글로 적겠지만 여기 내용을 가져왔다

• PE1000N : https://github.com/ASUS-IPC/ASUS-IPC/wiki/PE1000N

PE1000N

 

 

 

 

 

아래 글은 Asus 공식 사이트의 PE1000N 페이지이다

영문으로 된 메뉴얼과 OS 이미지 등 디바이스와 관련된 여러 정보들을 제공한다

• PE1000N : https://www.asus.com/kr/networking-iot-servers/aiot-industrial-solutions/embedded-computers-edge-ai-systems/pe1000n/helpdesk_manual?model2Name=PE1000N
• Manual : https://dlcdnets.asus.com/pub/ASUS/mb/Embedded_IPC/PE1000N/E21995_PE1000N_UM_V2_WEB.pdf?model=PE1000N

PE1000N｜AIoT & 산업용 솔루션｜ASUS 한국

 

 

 

 

 

WSL로 설치하는 과정, 중간에 발생하는 이슈와 USB연결 등에 대한 내용들은 아래의 블로그글이 많은 도움이 되었다

• https://dnai-deny.tistory.com/63

[NVIDIA] 윈도우에서 가상머신(WSL)으로 Jetson AGX Xavier 부팅하기

 

 

 

 

 

1. 설치 전 필요한 셋팅

 

1-1. WSL2 우분투 셋업 

SDK 매니저를 사용하려면 우분투 환경이 필요하다. 버젼은 18.04나 20.04면 충분하다

 

윈도우 환경에서 디바이스 셋팅을 진행했기에 WSL2를 사용하였다

이전에는 많은 명령어를 실행하고 설정에 들어가서 체크하는 등 복잡하던 WSL 셋팅이 굉장히 간단하고 편리해졌다. 

 

 

 

명령 프롬프트에서 wsl --list --online 을 실행하고 wsl.exe --install Ubuntu-18.04 이렇게 실행하면 윈도우에서 우분투 환경을 간단하게 셋팅할 수 있다

 

 

1-2. Xavier NX SSD 장착

이 부분은 나중에 언급할 이슈와 관련된 부분이다.

디바이스 OS 부팅 후 JetPack을 설치하는 도중 용량 부족 이슈가 발생했었는데 그래서 중간에 멈추고 뜯어서 SSD를 조립하였다. 

장착 후에도 진행이 안되서 어떻게 해결했는지는 뒤에서 자세하게 다루겠다

SSD 장착 방법은 위의 소개한 내부 구성 설명글과 공식 메뉴얼을 참고한다

 

디바이스 뒷판의 6개 볼트를 해제하여 하판을 연다

 

PE1000N Manual

 

 

아래처럼 내부가 구성 되어 있는데 오른쪽에 위치한 볼트를 풀고 

PE1000N Manual

 

SSD를 장착한 뒤 볼트로 고정시켜준다

PE1000N Manual

 

 

 

1-3. 리커버리 모드

Jetson은 디바이스마다 차이가 있지만 OS 부팅 등을 위한 리커버리 모드가 존재한다

기기별로 리커버리 모드 진입 방법은 조금씩 차이가 있다

 

Xavier NX에서 리커버리 모드 진입을 하려면 옆면을 먼저 따줘야한다

Host PC와 micro USB로 연결하는데도 필요하다

 

PE1000N Manual

 

 

옆면을 따면 아래와 같은 구성이 되어 있는데 리커버리 모드에는 5번, 리셋 버튼을 사용한다

리셋 버튼의 구멍 크기가 매우 작은데 샤프심 정도면 누르기 충분하다

 

PE1000N Manual

 

 

공식 문서의 리커버리 모드 진입 방법은 아래와 같다

 

Please perform the following steps to force the PE1000N to enter force recovery mode:

[PE1000N]

1. Power off the PE1000N and remove the power cable.
2. Connect Host Computer and PE1000N Flash Port (number ❸) with Micro USB cable.
3. Press and hold the Force Recovery Button (number ❺).
4. Connect the power cable and Power ON the PE1000N.
5. After 3s release the Force Recovery Button.

 

1. 먼저 전원 케이블은 분리한 상태로 둔다
2. Host PC와 디바이스를 Micro USB (5핀)으로 연결한다
3. 리셋 버튼을 샤프로 누르고 유지한다
4. 그 상태에서 전원 케이블을 연결하면 디바이스가 자동으로 켜진다
5. 전원 연결 후 리셋 버튼을 3초 더 누른뒤 뗀다

++ 디바이스와 모니터를 연결하고 전원을 켰는데 안켜져서 왜 이러지 싶기도 했었는데.. OS가 셋팅이 안된 초기 상태라면 안켜지는 게 맞다.. 나중에 진행하다보면 OS Flash 한 뒤에 모니터가 켜지니 안심하자..

 

 

 

2. 필요 라이브러리 설치

2-1. WSL에 필요한 라이브러리 설치

이전에 설치한 WSL 우분투에서 진행한다

 

WSL에서 Jetson을 셋팅하려면 설치해야 하는 라이브러리들이 존재한다

SDK 매니저를 실행할 때 GUI로 보면 편리하므로 관련된 라이브러리들을 설치할 것이다

 

엔비디아 Windows Subsystem for Linux (WSL) 공식 문서 에서

• To use the SDK Manager GUI, you need to verify WSL GUI is set with the instructions found at Run Linux GUI apps with WSL. This requires Windows 11 (Build 22000 or later).

MS 문서로 넘어가는데 진행해보니 가이드에 있는 모든 라이브러리를 설치할 필요는 없었다

SDK매니저를 실행하는데 충분한 명령어만 아래에 정리해보았다

 

 

업데이트 먼저 해주기

sudo apt update

 

 

Nautilus 설치 (얘는 음.. 굳이?)

sudo apt install nautilus -y

 

X11 앱 설치

sudo apt install x11-apps -y

 

 

Linux용 Google Chrome 설치 (SDK매니저를 실행할 경우 크롬으로 열리게 된다)

cd /tmp
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install --fix-missing ./google-chrome-stable_current_amd64.deb

 

++다른 글에서는 파이어폭스를 설치해서 사용했는데 진행한 PC에서는 파이어폭스가 제대로 설치되지 않아서 크롬을 사용했다

 

wslu 패키지 설치

sudo apt update && sudo apt install wslu -y

 

 

리눅스 배포 환경 설정을 위한 설치

sudo apt install iputils-ping iproute2 netcat iptables dnsutils network-manager usbutils net-tools python3-yaml dosfstools libgetopt-complete-perl openssh-client binutils xxd cpio udev dmidecode -y

 

 

USB를 통해 연결된 NVIDIA 장치를 플래시하기 위한 설치

sudo apt install linux-tools-virtual hwdata

sudo update-alternatives --install /usr/local/bin/usbip usbip `ls /usr/lib/linux-tools/*/usbip | tail -n1` 20

 

 

2-2. SDK 매니저 설치

다음은 WSL에 SDK 매니저를 설치한다

Nvidia SDK Manager : https://developer.nvidia.com/sdk-manager

SDK Manager

 

 

 

우분투용 deb 파일을 다운받아서 WSL로 옮겨준다

WSL을 설치하면 아래 사진처럼 Linux가 새로 생기고 내가 설치한 우분투 버젼의 디렉토리가 생긴다

들어가서 home/user/와 같은 편한 위치로 복사해준다

 

 

 

복사한 WSL 위치에서 SDK 매니저를 설치한다.

SDK 설치 deb 파일명을 넣어준다

sudo dpkg -i sdkmanager_2.2.0-12021_amd64.deb

 

위의 명령어 실행 시 다음과 같은 에러가 발생할 수 있다

Selecting previously unselected package sdkmanager.
(Reading database ... 56802 files and directories currently installed.)
Preparing to unpack sdkmanager_2.2.0-12021_amd64.deb ...
Unpacking sdkmanager (2.2.0-12021) ...
dpkg: dependency problems prevent configuration of sdkmanager:
sdkmanager depends on libcanberra-gtk-module; however:
Package libcanberra-gtk-module is not installed.
sdkmanager depends on libcanberra-gtk3-module; however:
Package libcanberra-gtk3-module is not installed.

dpkg: error processing package sdkmanager (--install):
dependency problems - leaving unconfigured
Processing triggers for desktop-file-utils (0.24-1ubuntu3) ...
Processing triggers for mime-support (3.64ubuntu1) ...
Processing triggers for hicolor-icon-theme (0.17-2) ...
Errors were encountered while processing:
sdkmanager

 

이런 에러가 발생한다면 아래의 명령어를 실행하고 sudo dpkg -i sdkmanager_2.2.0-12021_amd64.deb 를 다시 실행해본다

(관련 참고 자료 : https://askubuntu.com/questions/1115626/dpkg-error-processing-package-install)

sudo apt --fix-broken install

 

실행 후 sdkmanager 를 실행했을 때 크롬으로 GUI 창이 뜬다면 정상적으로 설치된 것이다

 

++가끔 GUI 창이 제대로 안뜨는 경우도 있는데 그런 경우에는 sdkmanager 실행 시 CLI로 실행할 것을 물어보므로 CLI로도 설치할 수 있다

 

 

 

2-3. 윈도우 uspid 설치 및 USB 잡아주기

윈도우 usbipd 설치

Ubuntu 환경인 Host PC에서는 필요없는 부분이지만 WSL로 셋팅한다면 필요한 과정이다

윈도우 PC에 연결된 USB를 WSL로 잡아주는 역할을 한다

이 셋팅이 없으면 WSL이 연결된 디바이스를 인식하지 못하여 SDK 매니저로 설치를 할 수 없다

 

usbipd 라는 라이브러리를 사용하는데 자세한 내용은 깃허브에서 확인할 수 있다

관리자 권한으로 터미널을 연 다음 아래의 명령어를 실행하여 설치한다

winget install usbipd

 

설치 후 usbipd list를 실행해보면 현재 PC의 USB 연결 상태를 출력해준다

 

윈도우 연결된 USB, WSL로 잡아주기

관리자 모드로 실행된 윈도우 터미널에서 usb 리스트를 확인한다

usbipd list

 

usbipd list를 실행하면 윈도우에 연결된 USB 리스트들이 나오는데 여기서 봐야할 것은 BUSID와 DEVICE이다

리스트를 보면 DEVICE 중 APX가 있는데 Jetson 디바이스는 APX로 표기된다

이전에 리커버리 모드로 연결한 디바이스가 잘 연결되어 있음을 알 수 있다

 

Xavier NX의 BUSID가 몇인지 기억해둔다  (BUSID는 PC마다 다를 수 있음)

ex) 2-2. 

 

아래의 명령어를 실행하여 디바이스 USB를 WSL로 잡아준다

usbipd bind -b 2-2

usbipd attach --wsl --busid 2-2 --auto-attach

 

참고한 블로그글에 자세히 나와있지만 auto-attach 옵션이 중요하다.

SDK 매니저로 설치시 잡아준 USB 연결이 분리되기도 하는데 이 때 자동으로 다시 잡아주는 것이 바로 auto-attach이다

실제로 설치를 진행해보면 SDK 매니저에서 WSL attached, WSL deattached가 반복하면서 뜨는 것을 볼 수 있다

 

연결이 잘 되었는지 확인해보려면 WSL에서 lsusb 명령어를 실행해본다

lsusb

Bus 001 Device 000: ID 3ksb:0001 Linux Foundation 3.0 root hub
Bus 002 Device 001: ID 1832:7ic0 NVidia Corp.
Bus 003 Device 003: ID 2j9s:0003 Linux Foundation 2.0 root hub

 

리스트에서 NVidia Corp.이 있으면 리커버리 모드의 디바이스가 WSL에 정상적으로 연결되었음을 의미한다. 

 

 

 

 

3. OS 부팅 및 JetPack 설치

지금까지 잘 진행해왔다면

• SDK 매니저 등 라이브러리들이 설치된 WSL 우분투
• 리커버리 모드 진입한 Xavier NX
• WSL로 연결 및 인식된 디바이스

이렇게 갖춰졌을 것이다

이제 SDK매니저를 통해 Xavier NX의 OS를 부팅하고 JetPack을 설치하도록 하겠다

 

WSL에서 SDK 매니저를 실행한다

sdkmanager

 

 

실행하면 크롬 창에서 아래의 화면이 뜬다

 

 

 

로그인을 하면 SDK매니저가 연결된 디바이스를 인식하여 아래와 같은 팝업 창이 뜬다

 

 

원하는 버젼을 선택하고 JetPack 버젼과 DeepStream 설치 여부를 선택한다

Xavier NX는 JetPack을 5.xx 버젼까지만 지원하며 설치 가능한 최신 버젼은 5.1.3이다

DeepStream도 필요하다면 같이 설치해도 되지만 도커로 돌릴 생각이므로 DeepStream은 제외하였다

 

 

이 이후의 설치 이미지 및 순서는 아래의 블로그글을 참고하면 좋다

https://makingrobot.tistory.com/177

Jetson Xavier NX : SDK Manager를 이용한 Jetpack 5.1.3 설치(micro SD 카드에 설치)

 

 

OS를 부팅하는 부분이 주요 분기점이다

이전에 설치한 SSD를 통해 OS를 부팅하고 JetPack을 설치할 수 있는데 이는 Flash 단계에서 2. Storage Device : NVMe로 설정하여 진행할 수 있다

Jetson 자체 용량은 EMMC이다. SD카드를 통해 용량을 늘려서 진행하는 것도 가능하다

 

 

 

2. Storage Device를 EMMC(default)로 설정하고 디바이스로 넘어가서 OS 부팅 및 초기 설정까지 마무리한 뒤에 JetPack 설치 부분에서 아래와 같은 이슈로 중단되었다

 

Disk space. Disk space check failure

https://forums.developer.nvidia.com/t/target-disk-space-check-failure-while-flashing-by-sdk-manager/291207

 

이미지를 발췌한 관련 이슈글을 살펴보면

The internal 16GB eMMC is not enough for both L4T OS and JetPack SDK.
You need an extra storage device like NVMe SSD or USB drive for them.

Jetson의 기본 용량 만으로는 설치가 힘들다고 언급하고 있다

그래서 SD카드나 SSD를 통해 용량을 확보하는 것이 필요하다. 이 때 디바이스를 뜯어서 SSD를 추가했었다..

 

Jetson으로 넘어가서 SSD를 마운트 한 뒤에 OS Flash 스킵하고 설치만 다시 해보거나 SSD OS 부팅인 NVMe를 선택하여 OS 부팅부터 다시 시작해보기도 했으나 같은 이슈가 발생하거나 또는 부팅에서 막혀버렸다.

 

NVMe로 설정하여 잘 진행되었으면 좋았겠지만... 슬프게도 OS Flash 도중에 멈췄고 그 원인은 아직도 찾지 못했다

따라서 뒤에서 적을 내용은 2. Storage Device를 EMMC(default)로 설정하여 진행하는 과정이다.

NVMe로 OS Flash가 잘 진행된다면 아래의 내용은 스킵하고 바로 위의 블로그글을 따라 디바이스의 초기 우분투 설정 및 JetPack 설치를 쭉 진행하면 된다

 

3-1. SSD로 진행이 안될 경우 (NVMe)

이 단계는 안오는게 베스트지만... 2. Storage Device : NVMe로 진행이 안될 경우 한번 시도해볼 것을 추천한다

 

아래는 비슷한 사례를 담은 포럼 글이다

해당 글의 방법대로 시도해보진 않았지만 같은 이슈를 겪고 있다면 참고해봐도 좋을 것 같다

 

https://forums.developer.nvidia.com/t/xavier-nx-sdk-installation-on-emmc-out-of-storage/232964

Xavier NX - SDK installation on eMMC, out of storage

 

 

내가 해결한 방법은 Xavier NX의 rootfs를 SSD로 변경하는 것이다

아래의 소스를 사용하였다

 

https://github.com/jetsonhacks/rootOnNVMe

GitHub - jetsonhacks/rootOnNVMe: Switch the rootfs to a NVMe SSD on the Jetson Xavier NX and Jetson AGX Xavier

 

 

현재 시점에서 Xavier NX의 OS는 부팅 및 설치되었으나 이후의 JetPack 설치가 안되는 상황

즉, Xavier NX에 모니터 연결시 화면이 들어오며 인터넷 연결 또한 가능하다

Xavier NX로 넘어가서 위의 깃헙 소스를 다운받고 실행한다. 깃헙의 설명대로 하나씩 쉘 스크립트를 실행하면 된다

 

소스 다운

https://github.com/jetsonhacks/rootOnNVMe.git

 

 

쉘스크립트 순서대로 실행

eMMC/SD 카드의 rootfs를 SSD로 복사

$ ./copy-rootfs-ssd.sh

 

서비스 설정. 실행 시 .service 파일이 올바른 위치에 복사되고 rootfs를 SSD로 설정하는 시작 스크립트가 설치됨

$ ./setup-service.sh

 

 

이렇게 쭉 실행 후 디바이스에서 df -h 를 통해 용량을 확인해보면 기본 용량이 16GB로 잡히던게 SSD 용량으로 변경되서 뜬다

 

이제 막혔던 디스크 이슈에서 JetPack 설치가 정상적으로 진행된다

JetPack 설치하면서 Xavier NX에서 df -h를 주기적으로 실행해서 용량을 확인해보면 설치된 파일들로 용량이 늘어나는 것을 확인할 수 있다

 

 

아래와 같은 화면이 뜬다면 Xavier NX의 셋팅이 마무리 된다

INSTALLATION COMPLETED SUCCESSFULLY. 

 

 

 

---

 

 

 

3-2. 번외편 (공식 위키 가이드)

 

깃헙에 정리된 Asus PE1000N 공식 문서와 공식 사이트에서 받은 OS 파일로 셋팅하는 방법도 있다

 

 

• PE1000N : https://github.com/ASUS-IPC/ASUS-IPC/wiki/PE1000N

 

공식 사이트에서는 아래의 OS 파일을 다운로드 받을 수 있다

• https://www.asus.com/ph/supportonly/pe1000n/helpdesk_download/

 

 

깃헙 문서를 보면 우분투와 윈도우(WSL)에서 Flash Image를 하는 가이드가 존재한다

 

 

여기서 1번과 2번, 우분투와 윈도우 가이드대로 진행해봤으나 sh 파일이 없거나 하는 등 여러 이슈들로 제대로 진행되지 않았다

 

하지만 지금 다시 자세히 살펴보니 적절한 방법은 3. Startup from external storage 인데 이 부분을 놓쳤던 것 같다

3번까지는 시도해보지 않아서 되는지는 알 수 없으나.. 시도해볼 가치가 있다고 생각한다

 

 

 

---

 

 

 

지금까지 Asus에서 빌드한 PE1000N Xavier NX 셋팅에 대해 쭉 살펴보았다

SDK 매니저를 통해 부팅 및 설치하는 부분은 많은 자료들이 있으므로 자세하게 다루지 않았고 설치하면서 발생한 이슈와 해결 과정 위주로 정리하였다