[lkml]   [2022]   [Mar]   [21]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
Subject[PATCH 0/9] Apple M1 (Pro/Max) NVMe driver

This series includes everything[*] required to get NVMe up and running on
Apple's M1, M1 Pro and M1 Max SoCs.

The NVMe controller on these machines is not attached to a PCI bus and
this driver originally started out when Arnd added platform support to
pci.c and I added the required Apple quirks. Christoph Hellwig stumbled
upon an early version and suggested to instead rewrite it as a
stand-alone driver since some of these quirks are rather awkward to
implement and would affect the hot path otherwise [1].

Here's the first version that creates apple.c to handle these weird NVMe
controllers. The following parts are included:

- Device tree bindings: Since this is the first and probably only
SoC that has NVMe outside of a PCIe bus I've put them into
soc/apple. The same bindings are also used by u-boot and OpenBSD

- SART address filter: Some of the buffers required by the NVMe
controller sit behind a simple DMA address filter Apple calls
SART. It allows to specify up to 16 physical address ranges
that are allowed and will reject access to anything else.
Unlike a real IOMMU there's no way to setup pagetables and
also not all buffers are subject to this filtering. Most
buffers used by the NVMe commands themselves use an integrated
IOMMU instead.

- RTKit IPC protocol: The NVMe controller is running a proprietary
RTOS Apple calls RTKit and we need to communicate with it in order
to bring up and use the NVMe controller. This communication happens
over a mailbox interface that is already upstream. This protocol
is also used for various other drivers present on these SoCs
(SMC, display controller, Thunderbolt/USB4).

- And finally the NVMe driver itself: The driver registers a platform
device and is mainly based on pci.c with a few special Apple quirks.
The biggest difference to normal NVMe (except for the missing PCI
bus) is that command submission works differently: The SQ is
replaced with a simple array and a command is triggered by writing
its tag to a MMIO register. Additionally, the command must also be
setup in the proprietary NVMMU before it can be submitted.
There is some code duplication with pci.c for the setup of the PRPs.
Depending on what you prefer this could be moved to a common file
shared between pci.c and apple.c.

The hardware here is the same hardware that's already used in T2 Macs.
The only difference is that the T2 chip itself initializes the
controller, disable some quirks (the NVMMU and the weird submission
array) and then exposes it over a PCIe interface.

The driver itself has been successfully used by multiple people as
their daily driver for weeks at this point and no major issues have
been reported.
A smaller issue is that flushes on the devices take *much* longer than
expected. Jens Axboe has a workaround where the flushes are delayed but
that one isn't ready for submission yet.



[*] The only missing part in this series are the device tree updates
but since these will go through arm-soc anyway I haven't included
them here but will instead submit them once this series is in a shape
where it can be merged.

Hector Martin (2):
nvme-apple: Add support for multiple power domains
nvme-apple: Add support for suspend/resume

Jens Axboe (1):
nvme-apple: Serialize command issue

Sven Peter (6):
dt-bindings: soc: apple: Add Apple SART
dt-bindings: soc: apple: Add ANS NVMe
soc: apple: Always include Makefile
soc: apple: Add SART driver
soc: apple: Add RTKit IPC library
nvme-apple: Add initial Apple SoC NVMe driver

.../bindings/soc/apple/apple,nvme-ans.yaml | 75 +
.../bindings/soc/apple/apple,sart.yaml | 52 +
drivers/nvme/host/Kconfig | 12 +
drivers/nvme/host/Makefile | 3 +
drivers/nvme/host/apple.c | 1568 +++++++++++++++++
drivers/soc/Makefile | 2 +-
drivers/soc/apple/Kconfig | 24 +
drivers/soc/apple/Makefile | 6 +
drivers/soc/apple/rtkit-crashlog.c | 147 ++
drivers/soc/apple/rtkit-internal.h | 76 +
drivers/soc/apple/rtkit.c | 842 +++++++++
drivers/soc/apple/sart.c | 318 ++++
include/linux/soc/apple/rtkit.h | 203 +++
include/linux/soc/apple/sart.h | 77 +
15 files changed, 3407 insertions(+), 1 deletion(-)
create mode 100644 Documentation/devicetree/bindings/soc/apple/apple,nvme-ans.yaml
create mode 100644 Documentation/devicetree/bindings/soc/apple/apple,sart.yaml
create mode 100644 drivers/nvme/host/apple.c
create mode 100644 drivers/soc/apple/rtkit-crashlog.c
create mode 100644 drivers/soc/apple/rtkit-internal.h
create mode 100644 drivers/soc/apple/rtkit.c
create mode 100644 drivers/soc/apple/sart.c
create mode 100644 include/linux/soc/apple/rtkit.h
create mode 100644 include/linux/soc/apple/sart.h


 \ /
  Last update: 2022-03-21 17:53    [W:0.273 / U:1.648 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site