Como usar controles sem fio do Xbox One no Linux com o XOW

Para usar um controle do Xbox One sem fio no Linux com o XOW, compile e instale o driver, obtenha o firmware do adaptador, inicie o serviço systemd correspondente e, em seguida, emparelhe o controle com o adaptador USB sem fio do Xbox. O XOW é para o adaptador USB, não para Bluetooth.

Verifique primeiro o status do projeto: os mantenedores do XOW o marcaram como em modo de manutenção e recomendam o xone. O projeto xone original agora aponta para um fork em desenvolvimento ativo. Se esta for uma nova instalação, revise o fork xone ativo . Os passos abaixo seguem a documentação do próprio XOW.

Verificar compatibilidade

O XOW é um driver de espaço do usuário: ele se comunica com o dongle através da libusb e expõe a entrada do controle por meio da interface uinput do Linux. O driver xpad integrado ao kernel não lida com conexões sem fio do Xbox One através deste adaptador.

O arquivo README do XOW lista adaptadores finos e de tamanho original, além do adaptador integrado do Surface Book 2. Ele indica que os modelos de controlador 1537, 1697, 1698, 1708 e 1797 funcionam; o modelo 1914 não foi testado. Os requisitos mínimos declarados são o kernel Linux 4.5 e o systemd 232. Diferenças de hardware e distribuição ainda podem afetar os resultados.

Instale e compile o XOW.

1. Instale os pré-requisitos

No Ubuntu ou Debian, instale o Git, as ferramentas de compilação, o curl, o cabextract e os arquivos de desenvolvimento do libusb:

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

No Fedora, Arch, openSUSE ou outra distribuição, instale os pacotes equivalentes usando o gerenciador de pacotes. Os nomes variam; procure por Git, make, um compilador C++, curl, cabextract, arquivos de desenvolvimento do libusb e systemd.

2. Clone, compile e instale

Obtenha o código-fonte original, compile o binário da versão de lançamento e instale-o:

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

Leia o arquivo README original antes da instalação. sudo make installO programa grava arquivos de sistema e é executado com privilégios de administrador, portanto, use o repositório oficial em vez de um arquivo de código-fonte não revisado ou um fork.

3. Obtenha o firmware do adaptador.

O auxiliar do XOW baixa e extrai o firmware necessário para o adaptador sem fio. Execute-o após a instalação:

sudo xow-get-firmware.sh

O projeto lista o curl e o cabextract para esta etapa. Se falhar, verifique o erro e as instruções atuais do arquivo README em vez de usar um arquivo de firmware não relacionado.

4. Ative e inicie o serviço.

Habilite o XOW na inicialização e inicie-o agora:

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

O arquivo README do XOW desaconselha a inicialização manual e observa que uma reinicialização pode ser necessária após a instalação. Se o serviço estiver ativo, mas o adaptador não for detectado, reinicie o sistema e verifique o status novamente.

Emparelhe o controlador

1. Conecte o adaptador sem fio do Xbox ao computador e aguarde o XOW iniciar.
2. Pressione o botão de emparelhamento do adaptador até que o indicador pisque.
3. Ligue o controle e, em seguida, pressione e segure o botão de sincronização até que o botão Xbox pisque. Mantenha os dispositivos próximos.
4. Quando a luz do controle permanecer acesa, teste os analógicos e os botões em um jogo ou em um utilitário de teste de entrada do Linux.

Um controlador pode não se reconectar automaticamente ao adaptador se tiver sido usado pela última vez via USB ou Bluetooth. Emparelhe-o novamente com o dongle. As conexões Bluetooth exigem um dispositivo compatível com Bluetooth e um driver diferente; o XOW não oferece suporte a Bluetooth.

Solucionar problemas comuns

Verifique o estado do serviço e o registro de inicialização atual:

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

• InputException: No such file or directoryO XOW não consegue acessar /dev/uinput. Verifique se o módulo uinput está disponível; tente sudo modprobe uinputnovamente e reinicie o XOW.
• Permission deniedOu então LIBUSB_ERROR_ACCESS: verifique as regras udev instaladas com o XOW e resolva as regras conflitantes. Reconecte o adaptador após corrigir as permissões.
• LIBUSB_ERROR_BUSYOu LIBUSB_ERROR_NO_DEVICE: outro processo ou driver pode estar usando o dongle. Interrompa instâncias duplicadas do XOW e evite executar outro driver no mesmo adaptador.
• LIBUSB_ERROR_TIMEOUTTente outra porta USB. O XOW relata problemas com alguns controladores USB da ASMedia; um hub pode ajudar com os tempos limite de gerenciamento de energia do USB 3.
• Erros de firmware: confirme se o auxiliar de firmware foi concluído. Se outro driver puder ter carregado o firmware, desconecte o adaptador, reconecte-o e execute o comando novamente sudo systemctl restart xow.

Pare ou remova o XOW

Pare o serviço temporariamente com sudo systemctl stop xow. Para impedir a inicialização na inicialização do sistema, execute sudo systemctl disable xow. Para remover, pare e desative o serviço, retorne ao xowdiretório clonado e siga as instruções de limpeza do arquivo README, que utilizam sudo make uninstall. Remova o XOW antes de trocar os drivers para que não haja competição pelo adaptador.

Para obter detalhes atualizados, consulte o arquivo README oficial do XOW , o arquivo README original do xone e a documentação do xpad no kernel do Linux .