[GUIDA] Webcam FaceTime HD funzionante su MacBook Air con UfficioZero
Hardware testato: MacBook Air 7,2 (Early 2015)
Sistema: UfficioZero 11
Kernel: 6.17
Difficoltà: Principiante
Il problema
Chi installa Linux su un MacBook Air si accorge subito che la webcam non funziona. Il motivo è che si tratta di hardware proprietario Apple: Linux non include il driver di serie e la webcam non viene riconosciuta.
Come funziona la soluzione
Per far funzionare la webcam servono due cose:
- Un driver scritto dalla community open source (progetto
facetimehd) - Un firmware estratto automaticamente da un vecchio installer Apple
Il driver va compilato dal codice sorgente, ma non preoccupatevi: i comandi sono semplici e non serve sapere programmare.
Prerequisiti
Installiamo gli strumenti necessari per compilare il driver:
sudo apt install git dkms build-essential linux-headers-$(uname -r)
Passo 1 — Scarica il codice sorgente del driver
cd ~
wget https://github.com/patjak/bcwc_pcie/archive/refs/heads/master.zip -O bcwc.zip
unzip bcwc.zip
cd facetimehd-master
Passo 2 — Scarica e installa il firmware
Il firmware viene estratto automaticamente da un installer Apple grazie a uno script del progetto facetimehd-firmware:
cd ~
git clone https://github.com/patjak/facetimehd-firmware.git
cd facetimehd-firmware
make
sudo make install
Se tutto va bene vedrete un messaggio simile a questo:
Found matching hash from OS X, El Capitan 10.11.5
==> Extracting firmware...
--> Extracted firmware version 1.43.0
Copying firmware into '//usr/lib/firmware/facetimehd'
Passo 3 — Compila e installa il driver
cd ~/facetimehd-master
make
sudo make install
Durante la compilazione potrebbero apparire alcuni avvisi (warning). Non sono errori e non compromettono il risultato.
Passo 4 — Carica il driver
sudo depmod -a
sudo modprobe facetimehd
Passo 5 — Verifica
ls /dev/video*
Se vedete /dev/video0 la webcam è riconosciuta correttamente.
Per testarla visivamente installate ffmpeg e avviate la preview:
sudo apt install ffmpeg
ffplay /dev/video0
Si aprirà una finestra con l'immagine in tempo reale dalla webcam.
Passo 6 — Caricamento automatico all'avvio
Senza questo passaggio il driver va ricaricato a mano dopo ogni riavvio. Per evitarlo:
echo "facetimehd" | sudo tee /etc/modules-load.d/facetimehd.conf
Da questo momento il driver si carica automaticamente.
Passo 7 — Installazione con DKMS (importante!)
Senza questo passaggio, ogni volta che il kernel si aggiorna il driver smette di funzionare e va ricompilato a mano. DKMS risolve il problema ricompilando il driver automaticamente ad ogni aggiornamento del kernel.
sudo cp -r ~/facetimehd-master /usr/src/facetimehd-0.1
sudo dkms install facetimehd/0.1
Da questo momento non dovrete più preoccuparvi degli aggiornamenti del kernel.
Bonus — Webcam su Discord (Flatpak)
Se usate Discord installato tramite Flatpak, la webcam potrebbe non essere visibile perché le app Flatpak girano in un ambiente isolato dal sistema. Per dare a Discord il permesso di accedere alla webcam:
flatpak override --user --device=all com.discordapp.Discord
Riavviate Discord e la webcam sarà disponibile.
Riepilogo comandi
| Cosa fare | Comando |
|---|---|
| Installare i prerequisiti | sudo apt install git dkms build-essential linux-headers-$(uname -r) |
| Scaricare il driver | wget https://github.com/patjak/bcwc_pcie/archive/refs/heads/master.zip -O bcwc.zip |
| Installare il firmware | cd ~/facetimehd-firmware && make && sudo make install |
| Compilare il driver | cd ~/facetimehd-master && make && sudo make install |
| Caricare il driver | sudo depmod -a && sudo modprobe facetimehd |
| Verificare la webcam | ls /dev/video* |
| Caricamento automatico | echo "facetimehd" \| sudo tee /etc/modules-load.d/facetimehd.conf |
| Installare con DKMS | sudo cp -r ~/facetimehd-master /usr/src/facetimehd-0.1 && sudo dkms install facetimehd/0.1 |
| Fix Discord Flatpak | flatpak override --user --device=all com.discordapp.Discord |
Spero sia utile a chi come me ha recuperato un vecchio MacBook e ci ha installato UfficioZero. Se avete domande o problemi scrivete nei commenti.
