====== Introduction ======

This project documents %%FreeBSD%% support for Apple Silicon (M1, M1 Max, M1 Pro, M1 Ultra).

----

====== Development Status ======

**Status**: Initial driver support & hardware bring-up.

%%FreeBSD%% can boot into the kernel via U-Boot. U-Boot >= 2022.01 is required. KyleEvans has patches adding sysutils/m1n1 and sysutils/u-boot-apple-m1 to the ports tree, but these will not land until the more interesting features are functional (USB, Ethernet, NVMe).

====== Feature Support ======

**Note**: this table is incomplete and is mostly focused on high-level features.

^ Feature ^ Functional? ^ In Progress? ^ Commit ^ Notes ^
| **%%SimpleFB%%** | ✔ |  |  |  |
| **SMP** | ✘ | ✔ |  |  |
| **Watchdog** | ✘ | ✔ |  |  |
| **PCIe** | ✘ | ✔ |  |  |
| **UART** | ✘ |  |  |  |
| **NVMe** | ✘ |  |  |  |
| **USB2** | ✘ |  |  |  |
| **USB3** | ✘ |  |  |  |
| **Ethernet** | ✘ |  |  |  |
| **WiFi** | ✘ |  |  |  |
| **Bluetooth** | ✘ |  |  |  |
| **Audio** | ✘ |  |  |  |

====== Hardware Support ======

**Note**: This table is incomplete and currently only lists hardware included/available in the development/test phase/

===== M1 =====

^ Device ^ Included? ^ Notes ^
| **Mac Mini (2020)** | ✔ |  |
| **MacBook Pro (13-inch, 2020)** | ✘ |  |
| **MacBook Air (13-inch, 2020)** | ✘ |  |
| **iMac (2020)** | ✘ |  |

===== M1 Pro / Max =====

^ Device ^ Included? ^ Notes ^
| **MacBook Pro (14/16-inch, Pro/Max, 2021)** | ✘ |  |
| **Mac Studio (Max, 2022)** | ✔ | Hardware not shipped yet, m1n1/u-boot status unknown |

===== M1 Ultra =====

^ Device ^ Included? ^ Notes ^
| **Mac Studio (2022)** | ✘ |  |

====== How can I help? ======

Current work focuses on creating and progressing driver support. If you have experience with C, kernel and driver development, please get in touch with KyleEvans for help getting a functional development set up and coordinating development.

If you're interested in testing, subscribe to this page for updates and keep an eye out on the mailing lists for calls for testing. We likely won't broadcast any milestones until that point.

----

{{tag>Apple}}
{{tag>Project}}