xref: /openbmc/linux/drivers/nvme/host/apple.c (revision a2cab953)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Apple ANS NVM Express device driver
4  * Copyright The Asahi Linux Contributors
5  *
6  * Based on the pci.c NVM Express device driver
7  * Copyright (c) 2011-2014, Intel Corporation.
8  * and on the rdma.c NVMe over Fabrics RDMA host code.
9  * Copyright (c) 2015-2016 HGST, a Western Digital Company.
10  */
11 
12 #include <linux/async.h>
13 #include <linux/blkdev.h>
14 #include <linux/blk-mq.h>
15 #include <linux/device.h>
16 #include <linux/dma-mapping.h>
17 #include <linux/dmapool.h>
18 #include <linux/interrupt.h>
19 #include <linux/io-64-nonatomic-lo-hi.h>
20 #include <linux/io.h>
21 #include <linux/iopoll.h>
22 #include <linux/jiffies.h>
23 #include <linux/mempool.h>
24 #include <linux/module.h>
25 #include <linux/of.h>
26 #include <linux/of_platform.h>
27 #include <linux/once.h>
28 #include <linux/platform_device.h>
29 #include <linux/pm_domain.h>
30 #include <linux/soc/apple/rtkit.h>
31 #include <linux/soc/apple/sart.h>
32 #include <linux/reset.h>
33 #include <linux/time64.h>
34 
35 #include "nvme.h"
36 
37 #define APPLE_ANS_BOOT_TIMEOUT	  USEC_PER_SEC
38 #define APPLE_ANS_MAX_QUEUE_DEPTH 64
39 
40 #define APPLE_ANS_COPROC_CPU_CONTROL	 0x44
41 #define APPLE_ANS_COPROC_CPU_CONTROL_RUN BIT(4)
42 
43 #define APPLE_ANS_ACQ_DB  0x1004
44 #define APPLE_ANS_IOCQ_DB 0x100c
45 
46 #define APPLE_ANS_MAX_PEND_CMDS_CTRL 0x1210
47 
48 #define APPLE_ANS_BOOT_STATUS	 0x1300
49 #define APPLE_ANS_BOOT_STATUS_OK 0xde71ce55
50 
51 #define APPLE_ANS_UNKNOWN_CTRL	 0x24008
52 #define APPLE_ANS_PRP_NULL_CHECK BIT(11)
53 
54 #define APPLE_ANS_LINEAR_SQ_CTRL 0x24908
55 #define APPLE_ANS_LINEAR_SQ_EN	 BIT(0)
56 
57 #define APPLE_ANS_LINEAR_ASQ_DB	 0x2490c
58 #define APPLE_ANS_LINEAR_IOSQ_DB 0x24910
59 
60 #define APPLE_NVMMU_NUM_TCBS	  0x28100
61 #define APPLE_NVMMU_ASQ_TCB_BASE  0x28108
62 #define APPLE_NVMMU_IOSQ_TCB_BASE 0x28110
63 #define APPLE_NVMMU_TCB_INVAL	  0x28118
64 #define APPLE_NVMMU_TCB_STAT	  0x28120
65 
66 /*
67  * This controller is a bit weird in the way command tags works: Both the
68  * admin and the IO queue share the same tag space. Additionally, tags
69  * cannot be higher than 0x40 which effectively limits the combined
70  * queue depth to 0x40. Instead of wasting half of that on the admin queue
71  * which gets much less traffic we instead reduce its size here.
72  * The controller also doesn't support async event such that no space must
73  * be reserved for NVME_NR_AEN_COMMANDS.
74  */
75 #define APPLE_NVME_AQ_DEPTH	   2
76 #define APPLE_NVME_AQ_MQ_TAG_DEPTH (APPLE_NVME_AQ_DEPTH - 1)
77 
78 /*
79  * These can be higher, but we need to ensure that any command doesn't
80  * require an sg allocation that needs more than a page of data.
81  */
82 #define NVME_MAX_KB_SZ 4096
83 #define NVME_MAX_SEGS  127
84 
85 /*
86  * This controller comes with an embedded IOMMU known as NVMMU.
87  * The NVMMU is pointed to an array of TCBs indexed by the command tag.
88  * Each command must be configured inside this structure before it's allowed
89  * to execute, including commands that don't require DMA transfers.
90  *
91  * An exception to this are Apple's vendor-specific commands (opcode 0xD8 on the
92  * admin queue): Those commands must still be added to the NVMMU but the DMA
93  * buffers cannot be represented as PRPs and must instead be allowed using SART.
94  *
95  * Programming the PRPs to the same values as those in the submission queue
96  * looks rather silly at first. This hardware is however designed for a kernel
97  * that runs the NVMMU code in a higher exception level than the NVMe driver.
98  * In that setting the NVMe driver first programs the submission queue entry
99  * and then executes a hypercall to the code that is allowed to program the
100  * NVMMU. The NVMMU driver then creates a shadow copy of the PRPs while
101  * verifying that they don't point to kernel text, data, pagetables, or similar
102  * protected areas before programming the TCB to point to this shadow copy.
103  * Since Linux doesn't do any of that we may as well just point both the queue
104  * and the TCB PRP pointer to the same memory.
105  */
106 struct apple_nvmmu_tcb {
107 	u8 opcode;
108 
109 #define APPLE_ANS_TCB_DMA_FROM_DEVICE BIT(0)
110 #define APPLE_ANS_TCB_DMA_TO_DEVICE   BIT(1)
111 	u8 dma_flags;
112 
113 	u8 command_id;
114 	u8 _unk0;
115 	__le16 length;
116 	u8 _unk1[18];
117 	__le64 prp1;
118 	__le64 prp2;
119 	u8 _unk2[16];
120 	u8 aes_iv[8];
121 	u8 _aes_unk[64];
122 };
123 
124 /*
125  * The Apple NVMe controller only supports a single admin and a single IO queue
126  * which are both limited to 64 entries and share a single interrupt.
127  *
128  * The completion queue works as usual. The submission "queue" instead is
129  * an array indexed by the command tag on this hardware. Commands must also be
130  * present in the NVMMU's tcb array. They are triggered by writing their tag to
131  * a MMIO register.
132  */
133 struct apple_nvme_queue {
134 	struct nvme_command *sqes;
135 	struct nvme_completion *cqes;
136 	struct apple_nvmmu_tcb *tcbs;
137 
138 	dma_addr_t sq_dma_addr;
139 	dma_addr_t cq_dma_addr;
140 	dma_addr_t tcb_dma_addr;
141 
142 	u32 __iomem *sq_db;
143 	u32 __iomem *cq_db;
144 
145 	u16 cq_head;
146 	u8 cq_phase;
147 
148 	bool is_adminq;
149 	bool enabled;
150 };
151 
152 /*
153  * The apple_nvme_iod describes the data in an I/O.
154  *
155  * The sg pointer contains the list of PRP chunk allocations in addition
156  * to the actual struct scatterlist.
157  */
158 struct apple_nvme_iod {
159 	struct nvme_request req;
160 	struct nvme_command cmd;
161 	struct apple_nvme_queue *q;
162 	int npages; /* In the PRP list. 0 means small pool in use */
163 	int nents; /* Used in scatterlist */
164 	dma_addr_t first_dma;
165 	unsigned int dma_len; /* length of single DMA segment mapping */
166 	struct scatterlist *sg;
167 };
168 
169 struct apple_nvme {
170 	struct device *dev;
171 
172 	void __iomem *mmio_coproc;
173 	void __iomem *mmio_nvme;
174 
175 	struct device **pd_dev;
176 	struct device_link **pd_link;
177 	int pd_count;
178 
179 	struct apple_sart *sart;
180 	struct apple_rtkit *rtk;
181 	struct reset_control *reset;
182 
183 	struct dma_pool *prp_page_pool;
184 	struct dma_pool *prp_small_pool;
185 	mempool_t *iod_mempool;
186 
187 	struct nvme_ctrl ctrl;
188 	struct work_struct remove_work;
189 
190 	struct apple_nvme_queue adminq;
191 	struct apple_nvme_queue ioq;
192 
193 	struct blk_mq_tag_set admin_tagset;
194 	struct blk_mq_tag_set tagset;
195 
196 	int irq;
197 	spinlock_t lock;
198 };
199 
200 static_assert(sizeof(struct nvme_command) == 64);
201 static_assert(sizeof(struct apple_nvmmu_tcb) == 128);
202 
203 static inline struct apple_nvme *ctrl_to_apple_nvme(struct nvme_ctrl *ctrl)
204 {
205 	return container_of(ctrl, struct apple_nvme, ctrl);
206 }
207 
208 static inline struct apple_nvme *queue_to_apple_nvme(struct apple_nvme_queue *q)
209 {
210 	if (q->is_adminq)
211 		return container_of(q, struct apple_nvme, adminq);
212 	else
213 		return container_of(q, struct apple_nvme, ioq);
214 }
215 
216 static unsigned int apple_nvme_queue_depth(struct apple_nvme_queue *q)
217 {
218 	if (q->is_adminq)
219 		return APPLE_NVME_AQ_DEPTH;
220 	else
221 		return APPLE_ANS_MAX_QUEUE_DEPTH;
222 }
223 
224 static void apple_nvme_rtkit_crashed(void *cookie)
225 {
226 	struct apple_nvme *anv = cookie;
227 
228 	dev_warn(anv->dev, "RTKit crashed; unable to recover without a reboot");
229 	nvme_reset_ctrl(&anv->ctrl);
230 }
231 
232 static int apple_nvme_sart_dma_setup(void *cookie,
233 				     struct apple_rtkit_shmem *bfr)
234 {
235 	struct apple_nvme *anv = cookie;
236 	int ret;
237 
238 	if (bfr->iova)
239 		return -EINVAL;
240 	if (!bfr->size)
241 		return -EINVAL;
242 
243 	bfr->buffer =
244 		dma_alloc_coherent(anv->dev, bfr->size, &bfr->iova, GFP_KERNEL);
245 	if (!bfr->buffer)
246 		return -ENOMEM;
247 
248 	ret = apple_sart_add_allowed_region(anv->sart, bfr->iova, bfr->size);
249 	if (ret) {
250 		dma_free_coherent(anv->dev, bfr->size, bfr->buffer, bfr->iova);
251 		bfr->buffer = NULL;
252 		return -ENOMEM;
253 	}
254 
255 	return 0;
256 }
257 
258 static void apple_nvme_sart_dma_destroy(void *cookie,
259 					struct apple_rtkit_shmem *bfr)
260 {
261 	struct apple_nvme *anv = cookie;
262 
263 	apple_sart_remove_allowed_region(anv->sart, bfr->iova, bfr->size);
264 	dma_free_coherent(anv->dev, bfr->size, bfr->buffer, bfr->iova);
265 }
266 
267 static const struct apple_rtkit_ops apple_nvme_rtkit_ops = {
268 	.crashed = apple_nvme_rtkit_crashed,
269 	.shmem_setup = apple_nvme_sart_dma_setup,
270 	.shmem_destroy = apple_nvme_sart_dma_destroy,
271 };
272 
273 static void apple_nvmmu_inval(struct apple_nvme_queue *q, unsigned int tag)
274 {
275 	struct apple_nvme *anv = queue_to_apple_nvme(q);
276 
277 	writel(tag, anv->mmio_nvme + APPLE_NVMMU_TCB_INVAL);
278 	if (readl(anv->mmio_nvme + APPLE_NVMMU_TCB_STAT))
279 		dev_warn_ratelimited(anv->dev,
280 				     "NVMMU TCB invalidation failed\n");
281 }
282 
283 static void apple_nvme_submit_cmd(struct apple_nvme_queue *q,
284 				  struct nvme_command *cmd)
285 {
286 	struct apple_nvme *anv = queue_to_apple_nvme(q);
287 	u32 tag = nvme_tag_from_cid(cmd->common.command_id);
288 	struct apple_nvmmu_tcb *tcb = &q->tcbs[tag];
289 
290 	tcb->opcode = cmd->common.opcode;
291 	tcb->prp1 = cmd->common.dptr.prp1;
292 	tcb->prp2 = cmd->common.dptr.prp2;
293 	tcb->length = cmd->rw.length;
294 	tcb->command_id = tag;
295 
296 	if (nvme_is_write(cmd))
297 		tcb->dma_flags = APPLE_ANS_TCB_DMA_TO_DEVICE;
298 	else
299 		tcb->dma_flags = APPLE_ANS_TCB_DMA_FROM_DEVICE;
300 
301 	memcpy(&q->sqes[tag], cmd, sizeof(*cmd));
302 
303 	/*
304 	 * This lock here doesn't make much sense at a first glace but
305 	 * removing it will result in occasional missed completetion
306 	 * interrupts even though the commands still appear on the CQ.
307 	 * It's unclear why this happens but our best guess is that
308 	 * there is a bug in the firmware triggered when a new command
309 	 * is issued while we're inside the irq handler between the
310 	 * NVMMU invalidation (and making the tag available again)
311 	 * and the final CQ update.
312 	 */
313 	spin_lock_irq(&anv->lock);
314 	writel(tag, q->sq_db);
315 	spin_unlock_irq(&anv->lock);
316 }
317 
318 /*
319  * From pci.c:
320  * Will slightly overestimate the number of pages needed.  This is OK
321  * as it only leads to a small amount of wasted memory for the lifetime of
322  * the I/O.
323  */
324 static inline size_t apple_nvme_iod_alloc_size(void)
325 {
326 	const unsigned int nprps = DIV_ROUND_UP(
327 		NVME_MAX_KB_SZ + NVME_CTRL_PAGE_SIZE, NVME_CTRL_PAGE_SIZE);
328 	const int npages = DIV_ROUND_UP(8 * nprps, PAGE_SIZE - 8);
329 	const size_t alloc_size = sizeof(__le64 *) * npages +
330 				  sizeof(struct scatterlist) * NVME_MAX_SEGS;
331 
332 	return alloc_size;
333 }
334 
335 static void **apple_nvme_iod_list(struct request *req)
336 {
337 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
338 
339 	return (void **)(iod->sg + blk_rq_nr_phys_segments(req));
340 }
341 
342 static void apple_nvme_free_prps(struct apple_nvme *anv, struct request *req)
343 {
344 	const int last_prp = NVME_CTRL_PAGE_SIZE / sizeof(__le64) - 1;
345 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
346 	dma_addr_t dma_addr = iod->first_dma;
347 	int i;
348 
349 	for (i = 0; i < iod->npages; i++) {
350 		__le64 *prp_list = apple_nvme_iod_list(req)[i];
351 		dma_addr_t next_dma_addr = le64_to_cpu(prp_list[last_prp]);
352 
353 		dma_pool_free(anv->prp_page_pool, prp_list, dma_addr);
354 		dma_addr = next_dma_addr;
355 	}
356 }
357 
358 static void apple_nvme_unmap_data(struct apple_nvme *anv, struct request *req)
359 {
360 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
361 
362 	if (iod->dma_len) {
363 		dma_unmap_page(anv->dev, iod->first_dma, iod->dma_len,
364 			       rq_dma_dir(req));
365 		return;
366 	}
367 
368 	WARN_ON_ONCE(!iod->nents);
369 
370 	dma_unmap_sg(anv->dev, iod->sg, iod->nents, rq_dma_dir(req));
371 	if (iod->npages == 0)
372 		dma_pool_free(anv->prp_small_pool, apple_nvme_iod_list(req)[0],
373 			      iod->first_dma);
374 	else
375 		apple_nvme_free_prps(anv, req);
376 	mempool_free(iod->sg, anv->iod_mempool);
377 }
378 
379 static void apple_nvme_print_sgl(struct scatterlist *sgl, int nents)
380 {
381 	int i;
382 	struct scatterlist *sg;
383 
384 	for_each_sg(sgl, sg, nents, i) {
385 		dma_addr_t phys = sg_phys(sg);
386 
387 		pr_warn("sg[%d] phys_addr:%pad offset:%d length:%d dma_address:%pad dma_length:%d\n",
388 			i, &phys, sg->offset, sg->length, &sg_dma_address(sg),
389 			sg_dma_len(sg));
390 	}
391 }
392 
393 static blk_status_t apple_nvme_setup_prps(struct apple_nvme *anv,
394 					  struct request *req,
395 					  struct nvme_rw_command *cmnd)
396 {
397 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
398 	struct dma_pool *pool;
399 	int length = blk_rq_payload_bytes(req);
400 	struct scatterlist *sg = iod->sg;
401 	int dma_len = sg_dma_len(sg);
402 	u64 dma_addr = sg_dma_address(sg);
403 	int offset = dma_addr & (NVME_CTRL_PAGE_SIZE - 1);
404 	__le64 *prp_list;
405 	void **list = apple_nvme_iod_list(req);
406 	dma_addr_t prp_dma;
407 	int nprps, i;
408 
409 	length -= (NVME_CTRL_PAGE_SIZE - offset);
410 	if (length <= 0) {
411 		iod->first_dma = 0;
412 		goto done;
413 	}
414 
415 	dma_len -= (NVME_CTRL_PAGE_SIZE - offset);
416 	if (dma_len) {
417 		dma_addr += (NVME_CTRL_PAGE_SIZE - offset);
418 	} else {
419 		sg = sg_next(sg);
420 		dma_addr = sg_dma_address(sg);
421 		dma_len = sg_dma_len(sg);
422 	}
423 
424 	if (length <= NVME_CTRL_PAGE_SIZE) {
425 		iod->first_dma = dma_addr;
426 		goto done;
427 	}
428 
429 	nprps = DIV_ROUND_UP(length, NVME_CTRL_PAGE_SIZE);
430 	if (nprps <= (256 / 8)) {
431 		pool = anv->prp_small_pool;
432 		iod->npages = 0;
433 	} else {
434 		pool = anv->prp_page_pool;
435 		iod->npages = 1;
436 	}
437 
438 	prp_list = dma_pool_alloc(pool, GFP_ATOMIC, &prp_dma);
439 	if (!prp_list) {
440 		iod->first_dma = dma_addr;
441 		iod->npages = -1;
442 		return BLK_STS_RESOURCE;
443 	}
444 	list[0] = prp_list;
445 	iod->first_dma = prp_dma;
446 	i = 0;
447 	for (;;) {
448 		if (i == NVME_CTRL_PAGE_SIZE >> 3) {
449 			__le64 *old_prp_list = prp_list;
450 
451 			prp_list = dma_pool_alloc(pool, GFP_ATOMIC, &prp_dma);
452 			if (!prp_list)
453 				goto free_prps;
454 			list[iod->npages++] = prp_list;
455 			prp_list[0] = old_prp_list[i - 1];
456 			old_prp_list[i - 1] = cpu_to_le64(prp_dma);
457 			i = 1;
458 		}
459 		prp_list[i++] = cpu_to_le64(dma_addr);
460 		dma_len -= NVME_CTRL_PAGE_SIZE;
461 		dma_addr += NVME_CTRL_PAGE_SIZE;
462 		length -= NVME_CTRL_PAGE_SIZE;
463 		if (length <= 0)
464 			break;
465 		if (dma_len > 0)
466 			continue;
467 		if (unlikely(dma_len < 0))
468 			goto bad_sgl;
469 		sg = sg_next(sg);
470 		dma_addr = sg_dma_address(sg);
471 		dma_len = sg_dma_len(sg);
472 	}
473 done:
474 	cmnd->dptr.prp1 = cpu_to_le64(sg_dma_address(iod->sg));
475 	cmnd->dptr.prp2 = cpu_to_le64(iod->first_dma);
476 	return BLK_STS_OK;
477 free_prps:
478 	apple_nvme_free_prps(anv, req);
479 	return BLK_STS_RESOURCE;
480 bad_sgl:
481 	WARN(DO_ONCE(apple_nvme_print_sgl, iod->sg, iod->nents),
482 	     "Invalid SGL for payload:%d nents:%d\n", blk_rq_payload_bytes(req),
483 	     iod->nents);
484 	return BLK_STS_IOERR;
485 }
486 
487 static blk_status_t apple_nvme_setup_prp_simple(struct apple_nvme *anv,
488 						struct request *req,
489 						struct nvme_rw_command *cmnd,
490 						struct bio_vec *bv)
491 {
492 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
493 	unsigned int offset = bv->bv_offset & (NVME_CTRL_PAGE_SIZE - 1);
494 	unsigned int first_prp_len = NVME_CTRL_PAGE_SIZE - offset;
495 
496 	iod->first_dma = dma_map_bvec(anv->dev, bv, rq_dma_dir(req), 0);
497 	if (dma_mapping_error(anv->dev, iod->first_dma))
498 		return BLK_STS_RESOURCE;
499 	iod->dma_len = bv->bv_len;
500 
501 	cmnd->dptr.prp1 = cpu_to_le64(iod->first_dma);
502 	if (bv->bv_len > first_prp_len)
503 		cmnd->dptr.prp2 = cpu_to_le64(iod->first_dma + first_prp_len);
504 	return BLK_STS_OK;
505 }
506 
507 static blk_status_t apple_nvme_map_data(struct apple_nvme *anv,
508 					struct request *req,
509 					struct nvme_command *cmnd)
510 {
511 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
512 	blk_status_t ret = BLK_STS_RESOURCE;
513 	int nr_mapped;
514 
515 	if (blk_rq_nr_phys_segments(req) == 1) {
516 		struct bio_vec bv = req_bvec(req);
517 
518 		if (bv.bv_offset + bv.bv_len <= NVME_CTRL_PAGE_SIZE * 2)
519 			return apple_nvme_setup_prp_simple(anv, req, &cmnd->rw,
520 							   &bv);
521 	}
522 
523 	iod->dma_len = 0;
524 	iod->sg = mempool_alloc(anv->iod_mempool, GFP_ATOMIC);
525 	if (!iod->sg)
526 		return BLK_STS_RESOURCE;
527 	sg_init_table(iod->sg, blk_rq_nr_phys_segments(req));
528 	iod->nents = blk_rq_map_sg(req->q, req, iod->sg);
529 	if (!iod->nents)
530 		goto out_free_sg;
531 
532 	nr_mapped = dma_map_sg_attrs(anv->dev, iod->sg, iod->nents,
533 				     rq_dma_dir(req), DMA_ATTR_NO_WARN);
534 	if (!nr_mapped)
535 		goto out_free_sg;
536 
537 	ret = apple_nvme_setup_prps(anv, req, &cmnd->rw);
538 	if (ret != BLK_STS_OK)
539 		goto out_unmap_sg;
540 	return BLK_STS_OK;
541 
542 out_unmap_sg:
543 	dma_unmap_sg(anv->dev, iod->sg, iod->nents, rq_dma_dir(req));
544 out_free_sg:
545 	mempool_free(iod->sg, anv->iod_mempool);
546 	return ret;
547 }
548 
549 static __always_inline void apple_nvme_unmap_rq(struct request *req)
550 {
551 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
552 	struct apple_nvme *anv = queue_to_apple_nvme(iod->q);
553 
554 	if (blk_rq_nr_phys_segments(req))
555 		apple_nvme_unmap_data(anv, req);
556 }
557 
558 static void apple_nvme_complete_rq(struct request *req)
559 {
560 	apple_nvme_unmap_rq(req);
561 	nvme_complete_rq(req);
562 }
563 
564 static void apple_nvme_complete_batch(struct io_comp_batch *iob)
565 {
566 	nvme_complete_batch(iob, apple_nvme_unmap_rq);
567 }
568 
569 static inline bool apple_nvme_cqe_pending(struct apple_nvme_queue *q)
570 {
571 	struct nvme_completion *hcqe = &q->cqes[q->cq_head];
572 
573 	return (le16_to_cpu(READ_ONCE(hcqe->status)) & 1) == q->cq_phase;
574 }
575 
576 static inline struct blk_mq_tags *
577 apple_nvme_queue_tagset(struct apple_nvme *anv, struct apple_nvme_queue *q)
578 {
579 	if (q->is_adminq)
580 		return anv->admin_tagset.tags[0];
581 	else
582 		return anv->tagset.tags[0];
583 }
584 
585 static inline void apple_nvme_handle_cqe(struct apple_nvme_queue *q,
586 					 struct io_comp_batch *iob, u16 idx)
587 {
588 	struct apple_nvme *anv = queue_to_apple_nvme(q);
589 	struct nvme_completion *cqe = &q->cqes[idx];
590 	__u16 command_id = READ_ONCE(cqe->command_id);
591 	struct request *req;
592 
593 	apple_nvmmu_inval(q, command_id);
594 
595 	req = nvme_find_rq(apple_nvme_queue_tagset(anv, q), command_id);
596 	if (unlikely(!req)) {
597 		dev_warn(anv->dev, "invalid id %d completed", command_id);
598 		return;
599 	}
600 
601 	if (!nvme_try_complete_req(req, cqe->status, cqe->result) &&
602 	    !blk_mq_add_to_batch(req, iob, nvme_req(req)->status,
603 				 apple_nvme_complete_batch))
604 		apple_nvme_complete_rq(req);
605 }
606 
607 static inline void apple_nvme_update_cq_head(struct apple_nvme_queue *q)
608 {
609 	u32 tmp = q->cq_head + 1;
610 
611 	if (tmp == apple_nvme_queue_depth(q)) {
612 		q->cq_head = 0;
613 		q->cq_phase ^= 1;
614 	} else {
615 		q->cq_head = tmp;
616 	}
617 }
618 
619 static bool apple_nvme_poll_cq(struct apple_nvme_queue *q,
620 			       struct io_comp_batch *iob)
621 {
622 	bool found = false;
623 
624 	while (apple_nvme_cqe_pending(q)) {
625 		found = true;
626 
627 		/*
628 		 * load-load control dependency between phase and the rest of
629 		 * the cqe requires a full read memory barrier
630 		 */
631 		dma_rmb();
632 		apple_nvme_handle_cqe(q, iob, q->cq_head);
633 		apple_nvme_update_cq_head(q);
634 	}
635 
636 	if (found)
637 		writel(q->cq_head, q->cq_db);
638 
639 	return found;
640 }
641 
642 static bool apple_nvme_handle_cq(struct apple_nvme_queue *q, bool force)
643 {
644 	bool found;
645 	DEFINE_IO_COMP_BATCH(iob);
646 
647 	if (!READ_ONCE(q->enabled) && !force)
648 		return false;
649 
650 	found = apple_nvme_poll_cq(q, &iob);
651 
652 	if (!rq_list_empty(iob.req_list))
653 		apple_nvme_complete_batch(&iob);
654 
655 	return found;
656 }
657 
658 static irqreturn_t apple_nvme_irq(int irq, void *data)
659 {
660 	struct apple_nvme *anv = data;
661 	bool handled = false;
662 	unsigned long flags;
663 
664 	spin_lock_irqsave(&anv->lock, flags);
665 	if (apple_nvme_handle_cq(&anv->ioq, false))
666 		handled = true;
667 	if (apple_nvme_handle_cq(&anv->adminq, false))
668 		handled = true;
669 	spin_unlock_irqrestore(&anv->lock, flags);
670 
671 	if (handled)
672 		return IRQ_HANDLED;
673 	return IRQ_NONE;
674 }
675 
676 static int apple_nvme_create_cq(struct apple_nvme *anv)
677 {
678 	struct nvme_command c = {};
679 
680 	/*
681 	 * Note: we (ab)use the fact that the prp fields survive if no data
682 	 * is attached to the request.
683 	 */
684 	c.create_cq.opcode = nvme_admin_create_cq;
685 	c.create_cq.prp1 = cpu_to_le64(anv->ioq.cq_dma_addr);
686 	c.create_cq.cqid = cpu_to_le16(1);
687 	c.create_cq.qsize = cpu_to_le16(APPLE_ANS_MAX_QUEUE_DEPTH - 1);
688 	c.create_cq.cq_flags = cpu_to_le16(NVME_QUEUE_PHYS_CONTIG | NVME_CQ_IRQ_ENABLED);
689 	c.create_cq.irq_vector = cpu_to_le16(0);
690 
691 	return nvme_submit_sync_cmd(anv->ctrl.admin_q, &c, NULL, 0);
692 }
693 
694 static int apple_nvme_remove_cq(struct apple_nvme *anv)
695 {
696 	struct nvme_command c = {};
697 
698 	c.delete_queue.opcode = nvme_admin_delete_cq;
699 	c.delete_queue.qid = cpu_to_le16(1);
700 
701 	return nvme_submit_sync_cmd(anv->ctrl.admin_q, &c, NULL, 0);
702 }
703 
704 static int apple_nvme_create_sq(struct apple_nvme *anv)
705 {
706 	struct nvme_command c = {};
707 
708 	/*
709 	 * Note: we (ab)use the fact that the prp fields survive if no data
710 	 * is attached to the request.
711 	 */
712 	c.create_sq.opcode = nvme_admin_create_sq;
713 	c.create_sq.prp1 = cpu_to_le64(anv->ioq.sq_dma_addr);
714 	c.create_sq.sqid = cpu_to_le16(1);
715 	c.create_sq.qsize = cpu_to_le16(APPLE_ANS_MAX_QUEUE_DEPTH - 1);
716 	c.create_sq.sq_flags = cpu_to_le16(NVME_QUEUE_PHYS_CONTIG);
717 	c.create_sq.cqid = cpu_to_le16(1);
718 
719 	return nvme_submit_sync_cmd(anv->ctrl.admin_q, &c, NULL, 0);
720 }
721 
722 static int apple_nvme_remove_sq(struct apple_nvme *anv)
723 {
724 	struct nvme_command c = {};
725 
726 	c.delete_queue.opcode = nvme_admin_delete_sq;
727 	c.delete_queue.qid = cpu_to_le16(1);
728 
729 	return nvme_submit_sync_cmd(anv->ctrl.admin_q, &c, NULL, 0);
730 }
731 
732 static blk_status_t apple_nvme_queue_rq(struct blk_mq_hw_ctx *hctx,
733 					const struct blk_mq_queue_data *bd)
734 {
735 	struct nvme_ns *ns = hctx->queue->queuedata;
736 	struct apple_nvme_queue *q = hctx->driver_data;
737 	struct apple_nvme *anv = queue_to_apple_nvme(q);
738 	struct request *req = bd->rq;
739 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
740 	struct nvme_command *cmnd = &iod->cmd;
741 	blk_status_t ret;
742 
743 	iod->npages = -1;
744 	iod->nents = 0;
745 
746 	/*
747 	 * We should not need to do this, but we're still using this to
748 	 * ensure we can drain requests on a dying queue.
749 	 */
750 	if (unlikely(!READ_ONCE(q->enabled)))
751 		return BLK_STS_IOERR;
752 
753 	if (!nvme_check_ready(&anv->ctrl, req, true))
754 		return nvme_fail_nonready_command(&anv->ctrl, req);
755 
756 	ret = nvme_setup_cmd(ns, req);
757 	if (ret)
758 		return ret;
759 
760 	if (blk_rq_nr_phys_segments(req)) {
761 		ret = apple_nvme_map_data(anv, req, cmnd);
762 		if (ret)
763 			goto out_free_cmd;
764 	}
765 
766 	blk_mq_start_request(req);
767 	apple_nvme_submit_cmd(q, cmnd);
768 	return BLK_STS_OK;
769 
770 out_free_cmd:
771 	nvme_cleanup_cmd(req);
772 	return ret;
773 }
774 
775 static int apple_nvme_init_hctx(struct blk_mq_hw_ctx *hctx, void *data,
776 				unsigned int hctx_idx)
777 {
778 	hctx->driver_data = data;
779 	return 0;
780 }
781 
782 static int apple_nvme_init_request(struct blk_mq_tag_set *set,
783 				   struct request *req, unsigned int hctx_idx,
784 				   unsigned int numa_node)
785 {
786 	struct apple_nvme_queue *q = set->driver_data;
787 	struct apple_nvme *anv = queue_to_apple_nvme(q);
788 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
789 	struct nvme_request *nreq = nvme_req(req);
790 
791 	iod->q = q;
792 	nreq->ctrl = &anv->ctrl;
793 	nreq->cmd = &iod->cmd;
794 
795 	return 0;
796 }
797 
798 static void apple_nvme_disable(struct apple_nvme *anv, bool shutdown)
799 {
800 	u32 csts = readl(anv->mmio_nvme + NVME_REG_CSTS);
801 	bool dead = false, freeze = false;
802 	unsigned long flags;
803 
804 	if (apple_rtkit_is_crashed(anv->rtk))
805 		dead = true;
806 	if (!(csts & NVME_CSTS_RDY))
807 		dead = true;
808 	if (csts & NVME_CSTS_CFS)
809 		dead = true;
810 
811 	if (anv->ctrl.state == NVME_CTRL_LIVE ||
812 	    anv->ctrl.state == NVME_CTRL_RESETTING) {
813 		freeze = true;
814 		nvme_start_freeze(&anv->ctrl);
815 	}
816 
817 	/*
818 	 * Give the controller a chance to complete all entered requests if
819 	 * doing a safe shutdown.
820 	 */
821 	if (!dead && shutdown && freeze)
822 		nvme_wait_freeze_timeout(&anv->ctrl, NVME_IO_TIMEOUT);
823 
824 	nvme_stop_queues(&anv->ctrl);
825 
826 	if (!dead) {
827 		if (READ_ONCE(anv->ioq.enabled)) {
828 			apple_nvme_remove_sq(anv);
829 			apple_nvme_remove_cq(anv);
830 		}
831 
832 		if (shutdown)
833 			nvme_shutdown_ctrl(&anv->ctrl);
834 		nvme_disable_ctrl(&anv->ctrl);
835 	}
836 
837 	WRITE_ONCE(anv->ioq.enabled, false);
838 	WRITE_ONCE(anv->adminq.enabled, false);
839 	mb(); /* ensure that nvme_queue_rq() sees that enabled is cleared */
840 	nvme_stop_admin_queue(&anv->ctrl);
841 
842 	/* last chance to complete any requests before nvme_cancel_request */
843 	spin_lock_irqsave(&anv->lock, flags);
844 	apple_nvme_handle_cq(&anv->ioq, true);
845 	apple_nvme_handle_cq(&anv->adminq, true);
846 	spin_unlock_irqrestore(&anv->lock, flags);
847 
848 	nvme_cancel_tagset(&anv->ctrl);
849 	nvme_cancel_admin_tagset(&anv->ctrl);
850 
851 	/*
852 	 * The driver will not be starting up queues again if shutting down so
853 	 * must flush all entered requests to their failed completion to avoid
854 	 * deadlocking blk-mq hot-cpu notifier.
855 	 */
856 	if (shutdown) {
857 		nvme_start_queues(&anv->ctrl);
858 		nvme_start_admin_queue(&anv->ctrl);
859 	}
860 }
861 
862 static enum blk_eh_timer_return apple_nvme_timeout(struct request *req)
863 {
864 	struct apple_nvme_iod *iod = blk_mq_rq_to_pdu(req);
865 	struct apple_nvme_queue *q = iod->q;
866 	struct apple_nvme *anv = queue_to_apple_nvme(q);
867 	unsigned long flags;
868 	u32 csts = readl(anv->mmio_nvme + NVME_REG_CSTS);
869 
870 	if (anv->ctrl.state != NVME_CTRL_LIVE) {
871 		/*
872 		 * From rdma.c:
873 		 * If we are resetting, connecting or deleting we should
874 		 * complete immediately because we may block controller
875 		 * teardown or setup sequence
876 		 * - ctrl disable/shutdown fabrics requests
877 		 * - connect requests
878 		 * - initialization admin requests
879 		 * - I/O requests that entered after unquiescing and
880 		 *   the controller stopped responding
881 		 *
882 		 * All other requests should be cancelled by the error
883 		 * recovery work, so it's fine that we fail it here.
884 		 */
885 		dev_warn(anv->dev,
886 			 "I/O %d(aq:%d) timeout while not in live state\n",
887 			 req->tag, q->is_adminq);
888 		if (blk_mq_request_started(req) &&
889 		    !blk_mq_request_completed(req)) {
890 			nvme_req(req)->status = NVME_SC_HOST_ABORTED_CMD;
891 			nvme_req(req)->flags |= NVME_REQ_CANCELLED;
892 			blk_mq_complete_request(req);
893 		}
894 		return BLK_EH_DONE;
895 	}
896 
897 	/* check if we just missed an interrupt if we're still alive */
898 	if (!apple_rtkit_is_crashed(anv->rtk) && !(csts & NVME_CSTS_CFS)) {
899 		spin_lock_irqsave(&anv->lock, flags);
900 		apple_nvme_handle_cq(q, false);
901 		spin_unlock_irqrestore(&anv->lock, flags);
902 		if (blk_mq_request_completed(req)) {
903 			dev_warn(anv->dev,
904 				 "I/O %d(aq:%d) timeout: completion polled\n",
905 				 req->tag, q->is_adminq);
906 			return BLK_EH_DONE;
907 		}
908 	}
909 
910 	/*
911 	 * aborting commands isn't supported which leaves a full reset as our
912 	 * only option here
913 	 */
914 	dev_warn(anv->dev, "I/O %d(aq:%d) timeout: resetting controller\n",
915 		 req->tag, q->is_adminq);
916 	nvme_req(req)->flags |= NVME_REQ_CANCELLED;
917 	apple_nvme_disable(anv, false);
918 	nvme_reset_ctrl(&anv->ctrl);
919 	return BLK_EH_DONE;
920 }
921 
922 static int apple_nvme_poll(struct blk_mq_hw_ctx *hctx,
923 			   struct io_comp_batch *iob)
924 {
925 	struct apple_nvme_queue *q = hctx->driver_data;
926 	struct apple_nvme *anv = queue_to_apple_nvme(q);
927 	bool found;
928 	unsigned long flags;
929 
930 	spin_lock_irqsave(&anv->lock, flags);
931 	found = apple_nvme_poll_cq(q, iob);
932 	spin_unlock_irqrestore(&anv->lock, flags);
933 
934 	return found;
935 }
936 
937 static const struct blk_mq_ops apple_nvme_mq_admin_ops = {
938 	.queue_rq = apple_nvme_queue_rq,
939 	.complete = apple_nvme_complete_rq,
940 	.init_hctx = apple_nvme_init_hctx,
941 	.init_request = apple_nvme_init_request,
942 	.timeout = apple_nvme_timeout,
943 };
944 
945 static const struct blk_mq_ops apple_nvme_mq_ops = {
946 	.queue_rq = apple_nvme_queue_rq,
947 	.complete = apple_nvme_complete_rq,
948 	.init_hctx = apple_nvme_init_hctx,
949 	.init_request = apple_nvme_init_request,
950 	.timeout = apple_nvme_timeout,
951 	.poll = apple_nvme_poll,
952 };
953 
954 static void apple_nvme_init_queue(struct apple_nvme_queue *q)
955 {
956 	unsigned int depth = apple_nvme_queue_depth(q);
957 
958 	q->cq_head = 0;
959 	q->cq_phase = 1;
960 	memset(q->tcbs, 0,
961 	       APPLE_ANS_MAX_QUEUE_DEPTH * sizeof(struct apple_nvmmu_tcb));
962 	memset(q->cqes, 0, depth * sizeof(struct nvme_completion));
963 	WRITE_ONCE(q->enabled, true);
964 	wmb(); /* ensure the first interrupt sees the initialization */
965 }
966 
967 static void apple_nvme_reset_work(struct work_struct *work)
968 {
969 	unsigned int nr_io_queues = 1;
970 	int ret;
971 	u32 boot_status, aqa;
972 	struct apple_nvme *anv =
973 		container_of(work, struct apple_nvme, ctrl.reset_work);
974 
975 	if (anv->ctrl.state != NVME_CTRL_RESETTING) {
976 		dev_warn(anv->dev, "ctrl state %d is not RESETTING\n",
977 			 anv->ctrl.state);
978 		ret = -ENODEV;
979 		goto out;
980 	}
981 
982 	/* there's unfortunately no known way to recover if RTKit crashed :( */
983 	if (apple_rtkit_is_crashed(anv->rtk)) {
984 		dev_err(anv->dev,
985 			"RTKit has crashed without any way to recover.");
986 		ret = -EIO;
987 		goto out;
988 	}
989 
990 	if (anv->ctrl.ctrl_config & NVME_CC_ENABLE)
991 		apple_nvme_disable(anv, false);
992 
993 	/* RTKit must be shut down cleanly for the (soft)-reset to work */
994 	if (apple_rtkit_is_running(anv->rtk)) {
995 		dev_dbg(anv->dev, "Trying to shut down RTKit before reset.");
996 		ret = apple_rtkit_shutdown(anv->rtk);
997 		if (ret)
998 			goto out;
999 	}
1000 
1001 	writel(0, anv->mmio_coproc + APPLE_ANS_COPROC_CPU_CONTROL);
1002 
1003 	ret = reset_control_assert(anv->reset);
1004 	if (ret)
1005 		goto out;
1006 
1007 	ret = apple_rtkit_reinit(anv->rtk);
1008 	if (ret)
1009 		goto out;
1010 
1011 	ret = reset_control_deassert(anv->reset);
1012 	if (ret)
1013 		goto out;
1014 
1015 	writel(APPLE_ANS_COPROC_CPU_CONTROL_RUN,
1016 	       anv->mmio_coproc + APPLE_ANS_COPROC_CPU_CONTROL);
1017 	ret = apple_rtkit_boot(anv->rtk);
1018 	if (ret) {
1019 		dev_err(anv->dev, "ANS did not boot");
1020 		goto out;
1021 	}
1022 
1023 	ret = readl_poll_timeout(anv->mmio_nvme + APPLE_ANS_BOOT_STATUS,
1024 				 boot_status,
1025 				 boot_status == APPLE_ANS_BOOT_STATUS_OK,
1026 				 USEC_PER_MSEC, APPLE_ANS_BOOT_TIMEOUT);
1027 	if (ret) {
1028 		dev_err(anv->dev, "ANS did not initialize");
1029 		goto out;
1030 	}
1031 
1032 	dev_dbg(anv->dev, "ANS booted successfully.");
1033 
1034 	/*
1035 	 * Limit the max command size to prevent iod->sg allocations going
1036 	 * over a single page.
1037 	 */
1038 	anv->ctrl.max_hw_sectors = min_t(u32, NVME_MAX_KB_SZ << 1,
1039 					 dma_max_mapping_size(anv->dev) >> 9);
1040 	anv->ctrl.max_segments = NVME_MAX_SEGS;
1041 
1042 	dma_set_max_seg_size(anv->dev, 0xffffffff);
1043 
1044 	/*
1045 	 * Enable NVMMU and linear submission queues.
1046 	 * While we could keep those disabled and pretend this is slightly
1047 	 * more common NVMe controller we'd still need some quirks (e.g.
1048 	 * sq entries will be 128 bytes) and Apple might drop support for
1049 	 * that mode in the future.
1050 	 */
1051 	writel(APPLE_ANS_LINEAR_SQ_EN,
1052 	       anv->mmio_nvme + APPLE_ANS_LINEAR_SQ_CTRL);
1053 
1054 	/* Allow as many pending command as possible for both queues */
1055 	writel(APPLE_ANS_MAX_QUEUE_DEPTH | (APPLE_ANS_MAX_QUEUE_DEPTH << 16),
1056 	       anv->mmio_nvme + APPLE_ANS_MAX_PEND_CMDS_CTRL);
1057 
1058 	/* Setup the NVMMU for the maximum admin and IO queue depth */
1059 	writel(APPLE_ANS_MAX_QUEUE_DEPTH - 1,
1060 	       anv->mmio_nvme + APPLE_NVMMU_NUM_TCBS);
1061 
1062 	/*
1063 	 * This is probably a chicken bit: without it all commands where any PRP
1064 	 * is set to zero (including those that don't use that field) fail and
1065 	 * the co-processor complains about "completed with err BAD_CMD-" or
1066 	 * a "NULL_PRP_PTR_ERR" in the syslog
1067 	 */
1068 	writel(readl(anv->mmio_nvme + APPLE_ANS_UNKNOWN_CTRL) &
1069 		       ~APPLE_ANS_PRP_NULL_CHECK,
1070 	       anv->mmio_nvme + APPLE_ANS_UNKNOWN_CTRL);
1071 
1072 	/* Setup the admin queue */
1073 	aqa = APPLE_NVME_AQ_DEPTH - 1;
1074 	aqa |= aqa << 16;
1075 	writel(aqa, anv->mmio_nvme + NVME_REG_AQA);
1076 	writeq(anv->adminq.sq_dma_addr, anv->mmio_nvme + NVME_REG_ASQ);
1077 	writeq(anv->adminq.cq_dma_addr, anv->mmio_nvme + NVME_REG_ACQ);
1078 
1079 	/* Setup NVMMU for both queues */
1080 	writeq(anv->adminq.tcb_dma_addr,
1081 	       anv->mmio_nvme + APPLE_NVMMU_ASQ_TCB_BASE);
1082 	writeq(anv->ioq.tcb_dma_addr,
1083 	       anv->mmio_nvme + APPLE_NVMMU_IOSQ_TCB_BASE);
1084 
1085 	anv->ctrl.sqsize =
1086 		APPLE_ANS_MAX_QUEUE_DEPTH - 1; /* 0's based queue depth */
1087 	anv->ctrl.cap = readq(anv->mmio_nvme + NVME_REG_CAP);
1088 
1089 	dev_dbg(anv->dev, "Enabling controller now");
1090 	ret = nvme_enable_ctrl(&anv->ctrl);
1091 	if (ret)
1092 		goto out;
1093 
1094 	dev_dbg(anv->dev, "Starting admin queue");
1095 	apple_nvme_init_queue(&anv->adminq);
1096 	nvme_start_admin_queue(&anv->ctrl);
1097 
1098 	if (!nvme_change_ctrl_state(&anv->ctrl, NVME_CTRL_CONNECTING)) {
1099 		dev_warn(anv->ctrl.device,
1100 			 "failed to mark controller CONNECTING\n");
1101 		ret = -ENODEV;
1102 		goto out;
1103 	}
1104 
1105 	ret = nvme_init_ctrl_finish(&anv->ctrl);
1106 	if (ret)
1107 		goto out;
1108 
1109 	dev_dbg(anv->dev, "Creating IOCQ");
1110 	ret = apple_nvme_create_cq(anv);
1111 	if (ret)
1112 		goto out;
1113 	dev_dbg(anv->dev, "Creating IOSQ");
1114 	ret = apple_nvme_create_sq(anv);
1115 	if (ret)
1116 		goto out_remove_cq;
1117 
1118 	apple_nvme_init_queue(&anv->ioq);
1119 	nr_io_queues = 1;
1120 	ret = nvme_set_queue_count(&anv->ctrl, &nr_io_queues);
1121 	if (ret)
1122 		goto out_remove_sq;
1123 	if (nr_io_queues != 1) {
1124 		ret = -ENXIO;
1125 		goto out_remove_sq;
1126 	}
1127 
1128 	anv->ctrl.queue_count = nr_io_queues + 1;
1129 
1130 	nvme_start_queues(&anv->ctrl);
1131 	nvme_wait_freeze(&anv->ctrl);
1132 	blk_mq_update_nr_hw_queues(&anv->tagset, 1);
1133 	nvme_unfreeze(&anv->ctrl);
1134 
1135 	if (!nvme_change_ctrl_state(&anv->ctrl, NVME_CTRL_LIVE)) {
1136 		dev_warn(anv->ctrl.device,
1137 			 "failed to mark controller live state\n");
1138 		ret = -ENODEV;
1139 		goto out_remove_sq;
1140 	}
1141 
1142 	nvme_start_ctrl(&anv->ctrl);
1143 
1144 	dev_dbg(anv->dev, "ANS boot and NVMe init completed.");
1145 	return;
1146 
1147 out_remove_sq:
1148 	apple_nvme_remove_sq(anv);
1149 out_remove_cq:
1150 	apple_nvme_remove_cq(anv);
1151 out:
1152 	dev_warn(anv->ctrl.device, "Reset failure status: %d\n", ret);
1153 	nvme_change_ctrl_state(&anv->ctrl, NVME_CTRL_DELETING);
1154 	nvme_get_ctrl(&anv->ctrl);
1155 	apple_nvme_disable(anv, false);
1156 	nvme_kill_queues(&anv->ctrl);
1157 	if (!queue_work(nvme_wq, &anv->remove_work))
1158 		nvme_put_ctrl(&anv->ctrl);
1159 }
1160 
1161 static void apple_nvme_remove_dead_ctrl_work(struct work_struct *work)
1162 {
1163 	struct apple_nvme *anv =
1164 		container_of(work, struct apple_nvme, remove_work);
1165 
1166 	nvme_put_ctrl(&anv->ctrl);
1167 	device_release_driver(anv->dev);
1168 }
1169 
1170 static int apple_nvme_reg_read32(struct nvme_ctrl *ctrl, u32 off, u32 *val)
1171 {
1172 	*val = readl(ctrl_to_apple_nvme(ctrl)->mmio_nvme + off);
1173 	return 0;
1174 }
1175 
1176 static int apple_nvme_reg_write32(struct nvme_ctrl *ctrl, u32 off, u32 val)
1177 {
1178 	writel(val, ctrl_to_apple_nvme(ctrl)->mmio_nvme + off);
1179 	return 0;
1180 }
1181 
1182 static int apple_nvme_reg_read64(struct nvme_ctrl *ctrl, u32 off, u64 *val)
1183 {
1184 	*val = readq(ctrl_to_apple_nvme(ctrl)->mmio_nvme + off);
1185 	return 0;
1186 }
1187 
1188 static int apple_nvme_get_address(struct nvme_ctrl *ctrl, char *buf, int size)
1189 {
1190 	struct device *dev = ctrl_to_apple_nvme(ctrl)->dev;
1191 
1192 	return snprintf(buf, size, "%s\n", dev_name(dev));
1193 }
1194 
1195 static void apple_nvme_free_ctrl(struct nvme_ctrl *ctrl)
1196 {
1197 	struct apple_nvme *anv = ctrl_to_apple_nvme(ctrl);
1198 
1199 	if (anv->ctrl.admin_q)
1200 		blk_put_queue(anv->ctrl.admin_q);
1201 	put_device(anv->dev);
1202 }
1203 
1204 static const struct nvme_ctrl_ops nvme_ctrl_ops = {
1205 	.name = "apple-nvme",
1206 	.module = THIS_MODULE,
1207 	.flags = 0,
1208 	.reg_read32 = apple_nvme_reg_read32,
1209 	.reg_write32 = apple_nvme_reg_write32,
1210 	.reg_read64 = apple_nvme_reg_read64,
1211 	.free_ctrl = apple_nvme_free_ctrl,
1212 	.get_address = apple_nvme_get_address,
1213 };
1214 
1215 static void apple_nvme_async_probe(void *data, async_cookie_t cookie)
1216 {
1217 	struct apple_nvme *anv = data;
1218 
1219 	flush_work(&anv->ctrl.reset_work);
1220 	flush_work(&anv->ctrl.scan_work);
1221 	nvme_put_ctrl(&anv->ctrl);
1222 }
1223 
1224 static void devm_apple_nvme_put_tag_set(void *data)
1225 {
1226 	blk_mq_free_tag_set(data);
1227 }
1228 
1229 static int apple_nvme_alloc_tagsets(struct apple_nvme *anv)
1230 {
1231 	int ret;
1232 
1233 	anv->admin_tagset.ops = &apple_nvme_mq_admin_ops;
1234 	anv->admin_tagset.nr_hw_queues = 1;
1235 	anv->admin_tagset.queue_depth = APPLE_NVME_AQ_MQ_TAG_DEPTH;
1236 	anv->admin_tagset.timeout = NVME_ADMIN_TIMEOUT;
1237 	anv->admin_tagset.numa_node = NUMA_NO_NODE;
1238 	anv->admin_tagset.cmd_size = sizeof(struct apple_nvme_iod);
1239 	anv->admin_tagset.flags = BLK_MQ_F_NO_SCHED;
1240 	anv->admin_tagset.driver_data = &anv->adminq;
1241 
1242 	ret = blk_mq_alloc_tag_set(&anv->admin_tagset);
1243 	if (ret)
1244 		return ret;
1245 	ret = devm_add_action_or_reset(anv->dev, devm_apple_nvme_put_tag_set,
1246 				       &anv->admin_tagset);
1247 	if (ret)
1248 		return ret;
1249 
1250 	anv->tagset.ops = &apple_nvme_mq_ops;
1251 	anv->tagset.nr_hw_queues = 1;
1252 	anv->tagset.nr_maps = 1;
1253 	/*
1254 	 * Tags are used as an index to the NVMMU and must be unique across
1255 	 * both queues. The admin queue gets the first APPLE_NVME_AQ_DEPTH which
1256 	 * must be marked as reserved in the IO queue.
1257 	 */
1258 	anv->tagset.reserved_tags = APPLE_NVME_AQ_DEPTH;
1259 	anv->tagset.queue_depth = APPLE_ANS_MAX_QUEUE_DEPTH - 1;
1260 	anv->tagset.timeout = NVME_IO_TIMEOUT;
1261 	anv->tagset.numa_node = NUMA_NO_NODE;
1262 	anv->tagset.cmd_size = sizeof(struct apple_nvme_iod);
1263 	anv->tagset.flags = BLK_MQ_F_SHOULD_MERGE;
1264 	anv->tagset.driver_data = &anv->ioq;
1265 
1266 	ret = blk_mq_alloc_tag_set(&anv->tagset);
1267 	if (ret)
1268 		return ret;
1269 	ret = devm_add_action_or_reset(anv->dev, devm_apple_nvme_put_tag_set,
1270 					&anv->tagset);
1271 	if (ret)
1272 		return ret;
1273 
1274 	anv->ctrl.admin_tagset = &anv->admin_tagset;
1275 	anv->ctrl.tagset = &anv->tagset;
1276 
1277 	return 0;
1278 }
1279 
1280 static int apple_nvme_queue_alloc(struct apple_nvme *anv,
1281 				  struct apple_nvme_queue *q)
1282 {
1283 	unsigned int depth = apple_nvme_queue_depth(q);
1284 
1285 	q->cqes = dmam_alloc_coherent(anv->dev,
1286 				      depth * sizeof(struct nvme_completion),
1287 				      &q->cq_dma_addr, GFP_KERNEL);
1288 	if (!q->cqes)
1289 		return -ENOMEM;
1290 
1291 	q->sqes = dmam_alloc_coherent(anv->dev,
1292 				      depth * sizeof(struct nvme_command),
1293 				      &q->sq_dma_addr, GFP_KERNEL);
1294 	if (!q->sqes)
1295 		return -ENOMEM;
1296 
1297 	/*
1298 	 * We need the maximum queue depth here because the NVMMU only has a
1299 	 * single depth configuration shared between both queues.
1300 	 */
1301 	q->tcbs = dmam_alloc_coherent(anv->dev,
1302 				      APPLE_ANS_MAX_QUEUE_DEPTH *
1303 					      sizeof(struct apple_nvmmu_tcb),
1304 				      &q->tcb_dma_addr, GFP_KERNEL);
1305 	if (!q->tcbs)
1306 		return -ENOMEM;
1307 
1308 	/*
1309 	 * initialize phase to make sure the allocated and empty memory
1310 	 * doesn't look like a full cq already.
1311 	 */
1312 	q->cq_phase = 1;
1313 	return 0;
1314 }
1315 
1316 static void apple_nvme_detach_genpd(struct apple_nvme *anv)
1317 {
1318 	int i;
1319 
1320 	if (anv->pd_count <= 1)
1321 		return;
1322 
1323 	for (i = anv->pd_count - 1; i >= 0; i--) {
1324 		if (anv->pd_link[i])
1325 			device_link_del(anv->pd_link[i]);
1326 		if (!IS_ERR_OR_NULL(anv->pd_dev[i]))
1327 			dev_pm_domain_detach(anv->pd_dev[i], true);
1328 	}
1329 }
1330 
1331 static int apple_nvme_attach_genpd(struct apple_nvme *anv)
1332 {
1333 	struct device *dev = anv->dev;
1334 	int i;
1335 
1336 	anv->pd_count = of_count_phandle_with_args(
1337 		dev->of_node, "power-domains", "#power-domain-cells");
1338 	if (anv->pd_count <= 1)
1339 		return 0;
1340 
1341 	anv->pd_dev = devm_kcalloc(dev, anv->pd_count, sizeof(*anv->pd_dev),
1342 				   GFP_KERNEL);
1343 	if (!anv->pd_dev)
1344 		return -ENOMEM;
1345 
1346 	anv->pd_link = devm_kcalloc(dev, anv->pd_count, sizeof(*anv->pd_link),
1347 				    GFP_KERNEL);
1348 	if (!anv->pd_link)
1349 		return -ENOMEM;
1350 
1351 	for (i = 0; i < anv->pd_count; i++) {
1352 		anv->pd_dev[i] = dev_pm_domain_attach_by_id(dev, i);
1353 		if (IS_ERR(anv->pd_dev[i])) {
1354 			apple_nvme_detach_genpd(anv);
1355 			return PTR_ERR(anv->pd_dev[i]);
1356 		}
1357 
1358 		anv->pd_link[i] = device_link_add(dev, anv->pd_dev[i],
1359 						  DL_FLAG_STATELESS |
1360 						  DL_FLAG_PM_RUNTIME |
1361 						  DL_FLAG_RPM_ACTIVE);
1362 		if (!anv->pd_link[i]) {
1363 			apple_nvme_detach_genpd(anv);
1364 			return -EINVAL;
1365 		}
1366 	}
1367 
1368 	return 0;
1369 }
1370 
1371 static void devm_apple_nvme_mempool_destroy(void *data)
1372 {
1373 	mempool_destroy(data);
1374 }
1375 
1376 static int apple_nvme_probe(struct platform_device *pdev)
1377 {
1378 	struct device *dev = &pdev->dev;
1379 	struct apple_nvme *anv;
1380 	int ret;
1381 
1382 	anv = devm_kzalloc(dev, sizeof(*anv), GFP_KERNEL);
1383 	if (!anv)
1384 		return -ENOMEM;
1385 
1386 	anv->dev = get_device(dev);
1387 	anv->adminq.is_adminq = true;
1388 	platform_set_drvdata(pdev, anv);
1389 
1390 	ret = apple_nvme_attach_genpd(anv);
1391 	if (ret < 0) {
1392 		dev_err_probe(dev, ret, "Failed to attach power domains");
1393 		goto put_dev;
1394 	}
1395 	if (dma_set_mask_and_coherent(dev, DMA_BIT_MASK(64))) {
1396 		ret = -ENXIO;
1397 		goto put_dev;
1398 	}
1399 
1400 	anv->irq = platform_get_irq(pdev, 0);
1401 	if (anv->irq < 0) {
1402 		ret = anv->irq;
1403 		goto put_dev;
1404 	}
1405 	if (!anv->irq) {
1406 		ret = -ENXIO;
1407 		goto put_dev;
1408 	}
1409 
1410 	anv->mmio_coproc = devm_platform_ioremap_resource_byname(pdev, "ans");
1411 	if (IS_ERR(anv->mmio_coproc)) {
1412 		ret = PTR_ERR(anv->mmio_coproc);
1413 		goto put_dev;
1414 	}
1415 	anv->mmio_nvme = devm_platform_ioremap_resource_byname(pdev, "nvme");
1416 	if (IS_ERR(anv->mmio_nvme)) {
1417 		ret = PTR_ERR(anv->mmio_nvme);
1418 		goto put_dev;
1419 	}
1420 
1421 	anv->adminq.sq_db = anv->mmio_nvme + APPLE_ANS_LINEAR_ASQ_DB;
1422 	anv->adminq.cq_db = anv->mmio_nvme + APPLE_ANS_ACQ_DB;
1423 	anv->ioq.sq_db = anv->mmio_nvme + APPLE_ANS_LINEAR_IOSQ_DB;
1424 	anv->ioq.cq_db = anv->mmio_nvme + APPLE_ANS_IOCQ_DB;
1425 
1426 	anv->sart = devm_apple_sart_get(dev);
1427 	if (IS_ERR(anv->sart)) {
1428 		ret = dev_err_probe(dev, PTR_ERR(anv->sart),
1429 				    "Failed to initialize SART");
1430 		goto put_dev;
1431 	}
1432 
1433 	anv->reset = devm_reset_control_array_get_exclusive(anv->dev);
1434 	if (IS_ERR(anv->reset)) {
1435 		ret = dev_err_probe(dev, PTR_ERR(anv->reset),
1436 				    "Failed to get reset control");
1437 		goto put_dev;
1438 	}
1439 
1440 	INIT_WORK(&anv->ctrl.reset_work, apple_nvme_reset_work);
1441 	INIT_WORK(&anv->remove_work, apple_nvme_remove_dead_ctrl_work);
1442 	spin_lock_init(&anv->lock);
1443 
1444 	ret = apple_nvme_queue_alloc(anv, &anv->adminq);
1445 	if (ret)
1446 		goto put_dev;
1447 	ret = apple_nvme_queue_alloc(anv, &anv->ioq);
1448 	if (ret)
1449 		goto put_dev;
1450 
1451 	anv->prp_page_pool = dmam_pool_create("prp list page", anv->dev,
1452 					      NVME_CTRL_PAGE_SIZE,
1453 					      NVME_CTRL_PAGE_SIZE, 0);
1454 	if (!anv->prp_page_pool) {
1455 		ret = -ENOMEM;
1456 		goto put_dev;
1457 	}
1458 
1459 	anv->prp_small_pool =
1460 		dmam_pool_create("prp list 256", anv->dev, 256, 256, 0);
1461 	if (!anv->prp_small_pool) {
1462 		ret = -ENOMEM;
1463 		goto put_dev;
1464 	}
1465 
1466 	WARN_ON_ONCE(apple_nvme_iod_alloc_size() > PAGE_SIZE);
1467 	anv->iod_mempool =
1468 		mempool_create_kmalloc_pool(1, apple_nvme_iod_alloc_size());
1469 	if (!anv->iod_mempool) {
1470 		ret = -ENOMEM;
1471 		goto put_dev;
1472 	}
1473 	ret = devm_add_action_or_reset(anv->dev,
1474 			devm_apple_nvme_mempool_destroy, anv->iod_mempool);
1475 	if (ret)
1476 		goto put_dev;
1477 
1478 	ret = apple_nvme_alloc_tagsets(anv);
1479 	if (ret)
1480 		goto put_dev;
1481 
1482 	ret = devm_request_irq(anv->dev, anv->irq, apple_nvme_irq, 0,
1483 			       "nvme-apple", anv);
1484 	if (ret) {
1485 		dev_err_probe(dev, ret, "Failed to request IRQ");
1486 		goto put_dev;
1487 	}
1488 
1489 	anv->rtk =
1490 		devm_apple_rtkit_init(dev, anv, NULL, 0, &apple_nvme_rtkit_ops);
1491 	if (IS_ERR(anv->rtk)) {
1492 		ret = dev_err_probe(dev, PTR_ERR(anv->rtk),
1493 				    "Failed to initialize RTKit");
1494 		goto put_dev;
1495 	}
1496 
1497 	ret = nvme_init_ctrl(&anv->ctrl, anv->dev, &nvme_ctrl_ops,
1498 			     NVME_QUIRK_SKIP_CID_GEN);
1499 	if (ret) {
1500 		dev_err_probe(dev, ret, "Failed to initialize nvme_ctrl");
1501 		goto put_dev;
1502 	}
1503 
1504 	anv->ctrl.admin_q = blk_mq_init_queue(&anv->admin_tagset);
1505 	if (IS_ERR(anv->ctrl.admin_q)) {
1506 		ret = -ENOMEM;
1507 		goto put_dev;
1508 	}
1509 
1510 	if (!blk_get_queue(anv->ctrl.admin_q)) {
1511 		nvme_start_admin_queue(&anv->ctrl);
1512 		blk_mq_destroy_queue(anv->ctrl.admin_q);
1513 		anv->ctrl.admin_q = NULL;
1514 		ret = -ENODEV;
1515 		goto put_dev;
1516 	}
1517 
1518 	nvme_reset_ctrl(&anv->ctrl);
1519 	async_schedule(apple_nvme_async_probe, anv);
1520 
1521 	return 0;
1522 
1523 put_dev:
1524 	put_device(anv->dev);
1525 	return ret;
1526 }
1527 
1528 static int apple_nvme_remove(struct platform_device *pdev)
1529 {
1530 	struct apple_nvme *anv = platform_get_drvdata(pdev);
1531 
1532 	nvme_change_ctrl_state(&anv->ctrl, NVME_CTRL_DELETING);
1533 	flush_work(&anv->ctrl.reset_work);
1534 	nvme_stop_ctrl(&anv->ctrl);
1535 	nvme_remove_namespaces(&anv->ctrl);
1536 	apple_nvme_disable(anv, true);
1537 	nvme_uninit_ctrl(&anv->ctrl);
1538 
1539 	if (apple_rtkit_is_running(anv->rtk))
1540 		apple_rtkit_shutdown(anv->rtk);
1541 
1542 	apple_nvme_detach_genpd(anv);
1543 
1544 	return 0;
1545 }
1546 
1547 static void apple_nvme_shutdown(struct platform_device *pdev)
1548 {
1549 	struct apple_nvme *anv = platform_get_drvdata(pdev);
1550 
1551 	apple_nvme_disable(anv, true);
1552 	if (apple_rtkit_is_running(anv->rtk))
1553 		apple_rtkit_shutdown(anv->rtk);
1554 }
1555 
1556 static int apple_nvme_resume(struct device *dev)
1557 {
1558 	struct apple_nvme *anv = dev_get_drvdata(dev);
1559 
1560 	return nvme_reset_ctrl(&anv->ctrl);
1561 }
1562 
1563 static int apple_nvme_suspend(struct device *dev)
1564 {
1565 	struct apple_nvme *anv = dev_get_drvdata(dev);
1566 	int ret = 0;
1567 
1568 	apple_nvme_disable(anv, true);
1569 
1570 	if (apple_rtkit_is_running(anv->rtk))
1571 		ret = apple_rtkit_shutdown(anv->rtk);
1572 
1573 	writel(0, anv->mmio_coproc + APPLE_ANS_COPROC_CPU_CONTROL);
1574 
1575 	return ret;
1576 }
1577 
1578 static DEFINE_SIMPLE_DEV_PM_OPS(apple_nvme_pm_ops, apple_nvme_suspend,
1579 				apple_nvme_resume);
1580 
1581 static const struct of_device_id apple_nvme_of_match[] = {
1582 	{ .compatible = "apple,nvme-ans2" },
1583 	{},
1584 };
1585 MODULE_DEVICE_TABLE(of, apple_nvme_of_match);
1586 
1587 static struct platform_driver apple_nvme_driver = {
1588 	.driver = {
1589 		.name = "nvme-apple",
1590 		.of_match_table = apple_nvme_of_match,
1591 		.pm = pm_sleep_ptr(&apple_nvme_pm_ops),
1592 	},
1593 	.probe = apple_nvme_probe,
1594 	.remove = apple_nvme_remove,
1595 	.shutdown = apple_nvme_shutdown,
1596 };
1597 module_platform_driver(apple_nvme_driver);
1598 
1599 MODULE_AUTHOR("Sven Peter <sven@svenpeter.dev>");
1600 MODULE_LICENSE("GPL");
1601