XOW를 사용하여 Linux에서 무선 Xbox One 컨트롤러를 사용하는 방법

XOW를 사용하여 Linux에서 Xbox One 컨트롤러를 무선으로 사용하려면 드라이버를 빌드 및 설치하고, 어댑터 펌웨어를 다운로드하고, 시스템d 서비스를 시작한 다음 컨트롤러를 Xbox 무선 USB 어댑터와 페어링해야 합니다. XOW는 USB 어댑터용이며 Bluetooth용이 아닙니다.

먼저 프로젝트 상태를 확인하세요. XOW 관리자는 해당 프로젝트를 유지보수 모드로 표시하고 xone 사용을 권장합니다. 기존 xone 프로젝트는 현재 활발히 개발 중인 포크를 가리키고 있습니다. 새로 설정하는 경우, 활발히 개발 중인 xone 포크를 검토하세요 . 아래 단계는 XOW의 공식 문서를 따릅니다.

호환성을 확인하세요

XOW는 사용자 공간 드라이버입니다. libusb를 통해 동글과 통신하고 Linux의 uinput 인터페이스를 통해 컨트롤러 입력을 제공합니다. 커널에 내장된 xpad 드라이버는 이 어댑터를 통한 Xbox One 무선 연결을 처리하지 않습니다.

XOW README에는 슬림형 및 오리지널 크기 어댑터와 Surface Book 2 내장 어댑터가 모두 나열되어 있습니다. 컨트롤러 모델 1537, 1697, 1698, 1708, 1797은 작동하는 것으로 표시되어 있으며, 모델 1914는 테스트되지 않았습니다. 최소 요구 사양은 Linux 커널 4.5 및 systemd 232입니다. 하드웨어 및 배포판에 따라 결과가 달라질 수 있습니다.

XOW를 설치하고 빌드합니다.

1. 필수 구성 요소를 설치합니다.

Ubuntu 또는 Debian에서 Git, 빌드 도구, curl, cabextract 및 libusb 개발 파일을 설치하십시오.

sudo apt update
sudo apt install git build-essential curl cabextract libusb-1.0-0-dev

Fedora, Arch, openSUSE 또는 다른 배포판에서는 해당 패키지 관리자를 사용하여 동등한 패키지를 설치하십시오. 패키지 이름은 다를 수 있습니다. Git, make, C++ 컴파일러, curl, cabextract, libusb 개발 파일 및 systemd를 찾으십시오.

2. 클론, 컴파일 및 설치

업스트림 소스 코드를 가져오고, 릴리스 바이너리를 빌드한 다음 설치하십시오.

git clone https://github.com/medusalix/xow
cd xow
make BUILD=RELEASE
sudo make install

설치하기 전에 원본 README 파일을 읽어보세요. 이 프로그램은 sudo make install시스템 파일을 작성하고 관리자 권한으로 실행되므로, 검증되지 않은 소스 아카이브나 포크보다는 공식 저장소를 사용하세요.

3. 어댑터 펌웨어를 가져옵니다.

XOW 헬퍼는 무선 어댑터에 필요한 펌웨어를 다운로드하고 압축을 해제합니다. 설치 후 실행하세요.

sudo xow-get-firmware.sh

프로젝트에서는 이 단계에 curl과 cabextract를 사용하도록 명시하고 있습니다. 만약 실패한다면, 관련 없는 펌웨어 파일을 사용하는 대신 오류 메시지와 최신 README 파일의 지침을 확인하십시오.

4. 서비스를 활성화하고 시작하십시오.

XOW를 부팅 시 활성화하고 지금 시작하세요:

sudo systemctl enable xow
sudo systemctl start xow
systemctl status xow --no-pager

XOW의 README 파일에는 수동 실행을 권장하지 않으며 설치 후 재부팅이 필요할 수 있다고 명시되어 있습니다. 서비스가 활성화되었지만 어댑터가 감지되지 않으면 한 번 재부팅한 후 상태를 다시 확인하십시오.

컨트롤러를 페어링하세요

1. Xbox 무선 어댑터를 컴퓨터에 연결하고 Xbox Online이 시작될 때까지 기다리세요.
2. 어댑터의 페어링 버튼을 표시등이 깜빡일 때까지 누르십시오.
3. 컨트롤러를 켠 다음 Xbox 버튼이 깜빡일 때까지 동기화 버튼을 길게 누르세요. 두 기기를 가까이 두세요.
4. 컨트롤러 표시등이 계속 켜져 있으면 게임이나 Linux 입력 테스트 유틸리티를 사용하여 스틱과 버튼을 테스트하십시오.

컨트롤러가 USB 또는 블루투스로 마지막으로 사용된 경우 어댑터에 자동으로 다시 연결되지 않을 수 있습니다. 동글과 다시 페어링하십시오. 블루투스 연결에는 블루투스 지원 설정과 별도의 드라이버가 필요하며, XOW는 블루투스 지원을 제공하지 않습니다.

일반적인 문제 해결

서비스 상태 및 현재 부팅 로그를 확인하십시오.

systemctl status xow --no-pager
journalctl -u xow -b --no-pager

• InputException: No such file or directoryXOW 에서 접근할 수 없습니다 /dev/uinput. uinput 모듈이 사용 가능한지 확인하십시오. 시도해 보고 sudo modprobe uinputXOW를 다시 시작하십시오.
• Permission denied또는 XOW와 함께 설치된 udev 규칙을 확인 LIBUSB_ERROR_ACCESS하고 충돌하는 규칙을 해결하십시오. 권한 문제를 해결한 후 어댑터를 다시 연결하십시오.
• LIBUSB_ERROR_BUSY또는 다른 프로세스나 드라이버가 동글을 사용 중일 수 있습니다. 중복된 XOW 인스턴스 LIBUSB_ERROR_NO_DEVICE를 중지하고 동일한 어댑터에 대해 다른 드라이버가 실행되지 않도록 하십시오.
• LIBUSB_ERROR_TIMEOUT다른 USB 포트를 사용해 보세요 . XOW는 일부 ASMedia USB 컨트롤러에서 문제가 발생한다고 보고했습니다. USB 허브를 사용하면 USB 3 전원 관리 시간 초과 문제를 해결하는 데 도움이 될 수 있습니다.
• 펌웨어 오류: 펌웨어 도우미가 완료되었는지 확인하십시오. 다른 드라이버가 펌웨어를 로드했을 수 있는 경우 어댑터를 분리했다가 다시 연결한 다음 실행하십시오 sudo systemctl restart xow.

XOW를 중지하거나 제거하세요.

서비스를 일시적으로 중지하려면 다음 명령을 실행하십시오 sudo systemctl stop xow. 부팅 시 자동 시작을 방지하려면 다음 명령을 실행하십시오 sudo systemctl disable xow. 완전히 제거하려면 서비스를 중지하고 비활성화한 다음 xow, 복제된 디렉터리로 돌아가 README 파일의 정리 지침(다음 명령 사용)을 따르십시오 sudo make uninstall. 드라이버를 전환하기 전에 XOW를 제거하여 어댑터를 두고 경쟁하지 않도록 하십시오.

최신 정보는 공식 XOW README , 원래 xone README 및 Linux 커널 xpad 문서를 참조하십시오 .