개발자라면 라즈베리파이(Raspberry Pi)는 이미 익숙할 것입니다. 하지만 라즈베리파이의 강력한 대안 중 하나인 리브레 컴퓨터(Libre Computer)의 AML-S905X-CC, 일명 '르 포테이토(Le Potato)'에 대해서는 잘 모르는 분들이 많습니다.
팬데믹 기간 반도체 칩 부족 사태가 발생하면서 라즈베리파이 가격이 크게 상승했습니다. 이후에도 여러 세계적 이슈로 인해 가격이 더욱 폭등했고, 일부 모델은 아예 생산이 중단되기도 했습니다.
이러한 상황 속에서 저는 진행하려던 프로젝트를 위해 라즈베리파이 대신 다른 보드로 갈아타는 것이 좋은 선택이라고 판단했습니다.
Le Potato는 외형과 구성 면에서 라즈베리파이와 매우 유사합니다. 우분투(Ubuntu), 데비안(Debian), 라스비안(Raspbian), 안드로이드(Android) 등 다양한 운영체제를 구동할 수 있다는 점도 큰 장점입니다.
하지만 안타깝게도 라즈베리파이와 달리 Le Potato에는 Wi-Fi 모듈이 기본 탑재되어 있지 않습니다.
이 글에서는 우분투(Ubuntu)가 설치된 Le Potato에 외장 Wi-Fi 어댑터 드라이버를 설치하는 과정을 명확한 단계별 가이드로 소개합니다. 다른 운영체제를 사용하시는 분들도 아래 방법을 시도해 볼 수 있지만, 반드시 동작한다고 보장하기는 어렵습니다.
먼저 제가 사용한 장비를 간단히 살펴보겠습니다.
사용한 장비
Le Potato 본체
Le Potato 디바이스
제브로닉스(Zebronics) 외장 Wi-Fi 어댑터
Zebronics 외장 Wi-Fi 어댑터
시행착오 — 실패했던 방법들
최종 해결책을 찾아 Wi-Fi 드라이버를 성공적으로 설치하고 무선 인터넷에 연결하기까지, 저는 여러 가지 방법을 시도했지만 모두 실패했습니다.
제가 시도했던 방법들은 다음과 같습니다.
- Wi-Fi 어댑터와 함께 동봉된 CD에 담긴 드라이버를 설치해 보았습니다. 하지만 안내된 설치 절차를 이해하기 어려웠고, 결국 수많은 오류만 마주하게 되었습니다.
- 제브로닉스 공식 사이트에서 해당 기기용 드라이버를 정확히 찾아 다운로드해 설치했지만, 역시 만족스러운 결과를 얻지 못했습니다.
- Realtek 소스 코드를 포크해 GitHub에 공개된 여러 오픈소스 드라이버를 설치해 보았지만, 기대한 대로 동작하지 않았습니다.
결국 우분투 Q&A 포럼에서 해답을 찾았고, 처음 시도 만에 드라이버를 성공적으로 설치할 수 있었습니다. 처음에는 절차가 다소 불분명했지만 제가 직접 하나씩 파악했고, 그 내용을 이곳에 정리해 공유합니다.
우분투에서 Le Potato용 Wi-Fi 어댑터 드라이버 설치하기
아래 단계를 순서대로 따라 하면 드라이버를 설치할 수 있습니다.
1. 필수 의존 패키지 설치
첫 번째 단계는 필요한 소프트웨어를 설치하는 것입니다.
시스템 아키텍처에 맞는 git, dkms, build-essential, linux-headers를 설치해야 합니다.
다음 명령어 한 줄로 모두 설치할 수 있습니다:
sudo apt-get install -y build-essential git dkms linux-headers-$(uname -r)
명령 실행 중 (yes/no) 확인 메시지가 나타나면 y를 입력하세요. 시스템에 소프트웨어를 설치하는 것에 동의한다는 의미입니다.
2. 드라이버 소스 코드 다운로드
일부 장치의 드라이버는 설치형·실행형 파일 형태로 제공되지 않습니다. 이 경우 소스 코드를 직접 다운로드한 뒤 컴파일하고 설치해야 합니다. 안타깝게도 이 드라이버도 해당됩니다.
GitHub에서 드라이버 소스 코드를 받을 수 있습니다. 터미널에서 다음 명령어를 실행하세요:
git clone https://github.com/kelebek333/rtl8188fu
3. 드라이버 빌드 및 설치
본격적인 빌드와 설치에 앞서 Linux의 dkms 명령어를 간단히 짚고 넘어가겠습니다. 이미 잘 안다면 이 부분은 건너뛰어도 좋습니다.
DKMS(Dynamic Kernel Module Support)는 커널 모듈의 추가 버전을 설치할 수 있게 해주는 프로그램이자 프레임워크입니다. 패키지를 컴파일해 커널 트리에 설치할 수 있으며, 새로운 우분투 커널 이미지 패키지가 설치될 때 DKMS가 자동으로 호출되므로 DKMS에 등록된 모듈은 커널 업데이트 이후에도 자동으로 유지됩니다.
앞 단계에서 다운로드한 소스 패키지를 커널 트리에 등록(add), 컴파일(build), 설치(install)해야 합니다. 다음 명령어를 순서대로 실행하세요.
커널에 소스 등록
sudo dkms add ./rtl8188fu
소스 패키지 컴파일
sudo dkms build rtl8188fu/1.0
커널 트리에 패키지 설치
sudo dkms install rtl8188fu/1.0
펌웨어 복사
컴파일된 바이너리 펌웨어 파일을 Linux의 기본 펌웨어 위치인 /lib/firmware로 복사해야 합니다.
펌웨어(Firmware)는 하드웨어와 소프트웨어 간의 통신을 가능하게 하는 소프트웨어로, 하드웨어가 정상적으로 동작하도록 기계에 명령을 전달하는 역할을 합니다.
다음 명령어로 컴파일된 펌웨어를 복사하세요:
sudo cp ./rtl8188fu/firmware/rtl8188fufw.bin /lib/firmware/rtlwifi/
4. 커널의 절전 모드 및 자동 서스펜드 비활성화
Wi-Fi 드라이버의 절전 모드(power saving)와 자동 서스펜드(auto suspend) 기능은 비활성화하는 것이 좋습니다. 또한 커널이 업데이트되더라도 설정이 유지되도록 기본 옵션으로 지정해 두어야 합니다. 이 설정은 /etc/modprobe.d/ 디렉터리의 .conf 파일에 추가할 수 있습니다.
이 위치에 설정 파일을 만드는 이유는, 사용자가 지정한 모듈 옵션이 영구적으로 적용된 상태로 로드되도록 하기 위함입니다.
절전 모드는 rtw_power_mgnt 플래그로 제어합니다:
- 0 — 절전 모드 비활성화
- 1 — minPS로 절전 모드 활성화
- 2 — maxPS로 절전 모드 활성화
자동 서스펜드는 rtw_enusbss 플래그로 제어합니다:
- 0 — 자동 서스펜드 비활성화
- 1 — 자동 서스펜드 활성화
다음 명령어로 .conf 파일을 생성하고 옵션을 저장하세요:
sudo mkdir -p /etc/modprobe.d/
sudo touch /etc/modprobe.d/rtl8188fu.conf
echo "options rtl8188fu rtw_power_mgnt=0 rtw_enusbss=0" | sudo tee /etc/modprobe.d/rtl8188fu.conf
5. 기존 모듈 블랙리스트 처리
이전에 설치를 시도했던 모듈이 있다면 블랙리스트에 등록해야 합니다.
참고: 모듈을 블랙리스트에 넣으면 자동 로드는 차단되지만, 다른 블랙리스트에 없는 모듈이 해당 모듈에 의존하거나 사용자가 수동으로 로드하는 경우에는 여전히 로드될 수 있습니다.
예를 들어 rtl8188au라는 모듈을 설치했다면, /etc/modprobe.d/blacklist.conf 파일 끝에 다음 줄을 추가해 블랙리스트 처리하세요.
blacklist rtl8188au
이처럼 설치했던 모듈이 없다면 블랙리스트 작업은 건너뛰어도 됩니다.
6. 모듈 재적재
모듈이 정상 동작하도록 다시 로드(reload)해야 합니다.
방금 추가한 모듈을 재적재하는 명령어는 다음과 같습니다:
sudo modprobe -rv rtl8188fu && sudo modprobe -v rtl8188fu
이제 모든 과정이 끝났습니다! 우분투가 설치된 Le Potato에서 Wi-Fi가 활성화된 것을 확인할 수 있을 것입니다. 만약 목록에 보이지 않는다면 시스템을 재부팅하면 됩니다.
드라이버 설치 후 네트워크 연결 시도 화면
Wi-Fi 네트워크에 성공적으로 연결된 모습
마무리
이번 글에서는 외장 Wi-Fi 어댑터용 드라이버를 설치하는 전 과정을 단계별로 살펴보았습니다.
여기서 소개한 절차는 임의의 외부 모듈을 커널에 추가할 때 따르게 되는 기본적인 흐름이기도 합니다. 다른 장치의 드라이버를 설치할 때도 같은 방식으로 응용할 수 있으니 참고하시기 바랍니다.