Notes to install Ubuntu 22.04.4LTS (Upgraded to 24.04LTS) up and running on my 2017 MacBook Pro 15 inch (MacBookPro14,3).
Now everything except the TouchID (Fingerprint), Suspend and Hibernation seems to work for me.
About Ubuntu 24.04LTS: I tried to install Ubuntu 24.04 and didn't have success. There was a crash issue during installation. https://bugs.launchpad.net/subiquity/+bug/2065310 But I installed 22.04 and upgraded it to the 24.04LTS later and it working same as 22.04.4.
- [Rob Hills's original Gist] - https://gist.github.com/rob-hills/9134b7352ee7471c4d4f4fbd6454c4b9 - very helpful
A lot of online info about running Ubuntu on MBP indicated that you needed to build drivers and install them just to get the basics running. For Ubuntu 22.04LTS and my MBP a1707, this was not the case. Things that worked for me with the standard Ubuntu 22.04LTS Live USB and after initial installation included:
- The basic keyboard (not the Touchbar with Esc and Function keys though);
- The touchpad;
- My SSK USB-C multi-port adapter, provides important infrastructure such as LAN connection, external monitor, and external storage;
- Bluetooth. Connected external Bluetooth keyboard and Apple mouse 2.
- Wifi: It was partly functional, but was not fully usable. Only 2.4Ghz access points shown with poor level and can be connected;
- Touchbar;
- Sound;
- Camera;
- Suspend (Can not resume many hardware); 2016 version seems to work with following method: https://ubuntuforums.org/showthread.php?t=2492426 But, 2017 version seems doesn't work.
- Hibernation (When I execute
systemctl hibernate, it seems shutting down); - TouchID (It seems diffucult. There might have possibility. Please see this: Dunedan/mbp-2016-linux#71 (comment));
The following notes mostly document what worked to get Wifi, Touchbar, Camera, and Sound working.
The Macbook's EFI partition seems to need to be kept. Please see the following comment for more information.
Just creating the configuration file /usr/lib/firmware/brcm/brcmfmac43602-pcie.txt was enough for my hardware.
Andy Holst's example configuration file final iteration here was ideal and only required a little tweaking for my system.
I made the following changes to Andy Holst's /usr/lib/firmware/brcm/brcmfmac43602-pcie.txt
macaddr=00:90:4c:0d:f5:30
ccode=ALL
- macaddr - set to the mac address of my WiFi card (I got it with the command
ip addr) - ccode - I just simply set it to ALL, (ALL (Channel 1-14), US, EU etc.)
Become the superuser
sudo su
Ubuntu uses initramfs so add our new modules to the list to be loaded
cat <<EOF | tee -a /etc/initramfs-tools/modules
# drivers for keyboard+touchpad
applespi
apple_ib_tb
intel_lpss_pci
spi_pxa2xx_platform
EOF
Build and install drivers from the source code.
apt install dkms
cd {your preferred source download folder}
git clone https://github.com/almas/macbook12-spi-driver
cd macbook12-spi-driver
git checkout touchbar-driver-hid-driver
ln -s `pwd` /usr/src/applespi-0.1
dkms install applespi/0.1 --force
Test the drivers by loading them and their dependencies
modprobe intel_lpss_pci spi_pxa2xx_platform applespi apple_ib_tb
An empty output indicates success
Reboot
At this point of the process, my touchbar was not working. More Googling led me to someone else logging this as [an issue on RoadRunner2's Driver repository[(roadrunner2/macbook12-spi-driver#42] and in the discussion I found a workaround. The following commands:
echo '1-3' | sudo tee /sys/bus/usb/drivers/usb/unbind
echo '1-3' | sudo tee /sys/bus/usb/drivers/usb/bind
caused my touchbar to light up!!
To save having to run these commands each time I start the computer, I needed to create a "macbook-quirks.service" and have it start up with the computer:
sudo su
cat <<EOF | tee /etc/systemd/system/macbook-quirks.service
[Unit]
Description=Re-enable MacBook 14,3 TouchBar
Before=display-manager.service
[Service]
Type=oneshot
ExecStartPre=/bin/sleep 2
ExecStart=/bin/sh -c "echo '1-3' > /sys/bus/usb/drivers/usb/unbind"
ExecStart=/bin/sh -c "echo '1-3' > /sys/bus/usb/drivers/usb/bind"
RemainAfterExit=yes
TimeoutSec=0
[Install]
WantedBy=multi-user.target
EOF
Now enable with systemctl enable macbook-quirks.service and reboot to check.
My MBP now boots up with the Touchbar working!
From the discussion in the link above, it appears this may be due to a bug in Linux and the usbmuxd system so hopefully will be able to remove the workaround in the future, so keep an eye on the relevant issue discussion.
Personally, I don't like this. But, if you want the Function keys to appear by default (instead of the brightness and sound keys), then you need to pass some parameters to the apple_ib_tb module. 'modinfo apple_ib_tb' lists the parameters and what they do.
sudo su
cat <<EOF | tee /etc/modprobe.d/apple_ib_tb.conf
options apple_ib_tb fnmode=2 # Default to Function Keys, Fn key toggles to "special"
options apple_ib_tb idle_timeout=60 # Turn off the Touchbar after 60 seconds.
EOF
After reloading the module with the following command, the Function keys will be shown by default.
sudo modprobe -r apple_ib_tb
sudo modprobe apple_ib_tb
I found the resolution from the Rade0nFighter's answer from the following QA: https://askubuntu.com/questions/1475091/sound-macbook-pro-ubuntu-22-04
sudo su
apt install wget make gcc linux-headers-generic
git clone https://github.com/davidjo/snd_hda_macbookpro.git
cd snd_hda_macbookpro/
bash install.cirrus.driver.sh
# It will give you instructions to install package linux-source-XXXXX. Install it.
apt install linux-source-XXXXX
# Then re-run install script.
bash install.cirrus.driver.sh
bash dkms.sh
reboot
Now the sound should work.
Execute the following command and reboot.
echo "options uvcvideo quirks=0x100" > /etc/modprobe.d/uvcvideo.conf
Now the camera should work too.
@almas thank you for this guide it helped me a lot. I've installed EndeavourOS v25-1 on my MacBookPro 13,3 and wanted to share what I had to do to get it working in case it would help someone else as well.
How I Got WiFi Working on my MacBookPro 13,3 (EndeavourOS v25-1 - 6.12.10-arch1-1)
This guide explains how to get WiFi working on a MacBookPro 13,3 running EndeavourOS v25-1. It covers downgrading wpa_supplicant, adjusting firmware configuration for brcmfmac43602, and creating a systemd service to load the driver later in the boot process.
Step 1: Downgrade wpa_supplicant to Version 2.10-8
Some users have found that wpa_supplicant 2.10-8 is the last version that reliably works with this hardware.
Install the downgrade utility:
Downgrade wpa_supplicant:
Restart Networking:
Either restart your networking services or reboot the system:
Step 2: Adjust the Firmware for brcmfmac43602
The driver expects specific firmware files and configuration. You may need to modify the configuration file so that the correct settings are applied.
Verify the Firmware File Exists:
Check for the generic firmware file:
Edit the Configuration File:
Open the configuration file in your favorite text editor (here we use nano):
Update the MAC Address: - If you're missing this get it here - https://gist.github.com/MikeRatcliffe/9614c16a8ea09731a9d5e91685bd8c80
Find the line starting with
macaddr=and change it to match your WiFi adapter’s MAC address.Example:
Set the Country Code:
Change the
ccode=line to:Save and Exit:
In nano, press Ctrl+O (then Enter) to save, then Ctrl+X to exit.
Test the Configuration Manually:
Unload and reload the module to test the changes:
Verify that WiFi comes up (even if signal strength seems low).
Step 3: Create a Systemd Service to Load the Driver Later in Boot
Sometimes the driver loads too early during boot. Creating a systemd service to load it after other services start can resolve this.
Create the Service File:
Open a new file for the systemd service:
Paste the Following Content:
Save and Exit:
Save the file (Ctrl+O, then Enter) and exit (Ctrl+X).
Reload systemd and Enable the Service:
sudo systemctl daemon-reload sudo systemctl enable load-brcmfmac.serviceReboot the System:
After reboot, the service should load the brcmfmac module automatically and your WiFi should come up.
Additional Notes
Signal Strength:
Some users report that while the connection works (even on 5GHz), the signal strength might be low. Further tweaks (such as antenna configuration or additional firmware adjustments) may be necessary if this becomes a problem.
Feedback & Updates:
Feel free to share this guide online. If you or others find improvements or encounter issues, consider updating the guide to help the community.
Summary
To recap, the steps to get WiFi working on your MacBookPro 13,3 running EndeavourOS v25-1 are:
wpa_supplicantto version 2.10-8./lib/firmware/brcm/brcmfmac43602-pcie.txtfile to update your MAC address and setccode=ALL.Happy hacking!