1 // SPDX-License-Identifier: GPL-2.0+
3 * CAAM/SEC 4.x transport/backend driver
4 * JobR backend functionality
6 * Copyright 2008-2012 Freescale Semiconductor, Inc.
10 #include <linux/of_irq.h>
11 #include <linux/of_address.h>
20 struct jr_driver_data
{
21 /* List of Physical JobR's with the Driver */
22 struct list_head jr_list
;
23 spinlock_t jr_alloc_lock
; /* jr_list lock */
24 } ____cacheline_aligned
;
26 static struct jr_driver_data driver_data
;
27 static DEFINE_MUTEX(algs_lock
);
28 static unsigned int active_devs
;
30 static void register_algs(struct device
*dev
)
32 mutex_lock(&algs_lock
);
34 if (++active_devs
!= 1)
37 caam_algapi_init(dev
);
38 caam_algapi_hash_init(dev
);
41 caam_qi_algapi_init(dev
);
44 mutex_unlock(&algs_lock
);
47 static void unregister_algs(void)
49 mutex_lock(&algs_lock
);
51 if (--active_devs
!= 0)
54 caam_qi_algapi_exit();
58 caam_algapi_hash_exit();
62 mutex_unlock(&algs_lock
);
65 static int caam_reset_hw_jr(struct device
*dev
)
67 struct caam_drv_private_jr
*jrp
= dev_get_drvdata(dev
);
68 unsigned int timeout
= 100000;
71 * mask interrupts since we are going to poll
72 * for reset completion status
74 clrsetbits_32(&jrp
->rregs
->rconfig_lo
, 0, JRCFG_IMSK
);
76 /* initiate flush (required prior to reset) */
77 wr_reg32(&jrp
->rregs
->jrcommand
, JRCR_RESET
);
78 while (((rd_reg32(&jrp
->rregs
->jrintstatus
) & JRINT_ERR_HALT_MASK
) ==
79 JRINT_ERR_HALT_INPROGRESS
) && --timeout
)
82 if ((rd_reg32(&jrp
->rregs
->jrintstatus
) & JRINT_ERR_HALT_MASK
) !=
83 JRINT_ERR_HALT_COMPLETE
|| timeout
== 0) {
84 dev_err(dev
, "failed to flush job ring %d\n", jrp
->ridx
);
90 wr_reg32(&jrp
->rregs
->jrcommand
, JRCR_RESET
);
91 while ((rd_reg32(&jrp
->rregs
->jrcommand
) & JRCR_RESET
) && --timeout
)
95 dev_err(dev
, "failed to reset job ring %d\n", jrp
->ridx
);
99 /* unmask interrupts */
100 clrsetbits_32(&jrp
->rregs
->rconfig_lo
, JRCFG_IMSK
, 0);
106 * Shutdown JobR independent of platform property code
108 static int caam_jr_shutdown(struct device
*dev
)
110 struct caam_drv_private_jr
*jrp
= dev_get_drvdata(dev
);
113 ret
= caam_reset_hw_jr(dev
);
115 tasklet_kill(&jrp
->irqtask
);
120 static int caam_jr_remove(struct platform_device
*pdev
)
123 struct device
*jrdev
;
124 struct caam_drv_private_jr
*jrpriv
;
127 jrpriv
= dev_get_drvdata(jrdev
);
130 * Return EBUSY if job ring already allocated.
132 if (atomic_read(&jrpriv
->tfm_count
)) {
133 dev_err(jrdev
, "Device is busy\n");
137 /* Unregister JR-based RNG & crypto algorithms */
140 /* Remove the node from Physical JobR list maintained by driver */
141 spin_lock(&driver_data
.jr_alloc_lock
);
142 list_del(&jrpriv
->list_node
);
143 spin_unlock(&driver_data
.jr_alloc_lock
);
146 ret
= caam_jr_shutdown(jrdev
);
148 dev_err(jrdev
, "Failed to shut down job ring\n");
153 /* Main per-ring interrupt handler */
154 static irqreturn_t
caam_jr_interrupt(int irq
, void *st_dev
)
156 struct device
*dev
= st_dev
;
157 struct caam_drv_private_jr
*jrp
= dev_get_drvdata(dev
);
161 * Check the output ring for ready responses, kick
162 * tasklet if jobs done.
164 irqstate
= rd_reg32(&jrp
->rregs
->jrintstatus
);
169 * If JobR error, we got more development work to do
170 * Flag a bug now, but we really need to shut down and
171 * restart the queue (and fix code).
173 if (irqstate
& JRINT_JR_ERROR
) {
174 dev_err(dev
, "job ring error: irqstate: %08x\n", irqstate
);
178 /* mask valid interrupts */
179 clrsetbits_32(&jrp
->rregs
->rconfig_lo
, 0, JRCFG_IMSK
);
181 /* Have valid interrupt at this point, just ACK and trigger */
182 wr_reg32(&jrp
->rregs
->jrintstatus
, irqstate
);
185 tasklet_schedule(&jrp
->irqtask
);
191 /* Deferred service handler, run as interrupt-fired tasklet */
192 static void caam_jr_dequeue(unsigned long devarg
)
194 int hw_idx
, sw_idx
, i
, head
, tail
;
195 struct device
*dev
= (struct device
*)devarg
;
196 struct caam_drv_private_jr
*jrp
= dev_get_drvdata(dev
);
197 void (*usercall
)(struct device
*dev
, u32
*desc
, u32 status
, void *arg
);
198 u32
*userdesc
, userstatus
;
200 u32 outring_used
= 0;
202 while (outring_used
||
203 (outring_used
= rd_reg32(&jrp
->rregs
->outring_used
))) {
205 head
= READ_ONCE(jrp
->head
);
207 sw_idx
= tail
= jrp
->tail
;
208 hw_idx
= jrp
->out_ring_read_index
;
210 for (i
= 0; CIRC_CNT(head
, tail
+ i
, JOBR_DEPTH
) >= 1; i
++) {
211 sw_idx
= (tail
+ i
) & (JOBR_DEPTH
- 1);
213 if (jr_outentry_desc(jrp
->outring
, hw_idx
) ==
214 caam_dma_to_cpu(jrp
->entinfo
[sw_idx
].desc_addr_dma
))
217 /* we should never fail to find a matching descriptor */
218 BUG_ON(CIRC_CNT(head
, tail
+ i
, JOBR_DEPTH
) <= 0);
220 /* Unmap just-run descriptor so we can post-process */
221 dma_unmap_single(dev
,
222 caam_dma_to_cpu(jr_outentry_desc(jrp
->outring
,
224 jrp
->entinfo
[sw_idx
].desc_size
,
227 /* mark completed, avoid matching on a recycled desc addr */
228 jrp
->entinfo
[sw_idx
].desc_addr_dma
= 0;
230 /* Stash callback params */
231 usercall
= jrp
->entinfo
[sw_idx
].callbk
;
232 userarg
= jrp
->entinfo
[sw_idx
].cbkarg
;
233 userdesc
= jrp
->entinfo
[sw_idx
].desc_addr_virt
;
234 userstatus
= caam32_to_cpu(jr_outentry_jrstatus(jrp
->outring
,
238 * Make sure all information from the job has been obtained
239 * before telling CAAM that the job has been removed from the
245 wr_reg32(&jrp
->rregs
->outring_rmvd
, 1);
247 jrp
->out_ring_read_index
= (jrp
->out_ring_read_index
+ 1) &
251 * if this job completed out-of-order, do not increment
252 * the tail. Otherwise, increment tail by 1 plus the
253 * number of subsequent jobs already completed out-of-order
255 if (sw_idx
== tail
) {
257 tail
= (tail
+ 1) & (JOBR_DEPTH
- 1);
258 } while (CIRC_CNT(head
, tail
, JOBR_DEPTH
) >= 1 &&
259 jrp
->entinfo
[tail
].desc_addr_dma
== 0);
264 /* Finally, execute user's callback */
265 usercall(dev
, userdesc
, userstatus
, userarg
);
269 /* reenable / unmask IRQs */
270 clrsetbits_32(&jrp
->rregs
->rconfig_lo
, JRCFG_IMSK
, 0);
274 * caam_jr_alloc() - Alloc a job ring for someone to use as needed.
276 * returns : pointer to the newly allocated physical
277 * JobR dev can be written to if successful.
279 struct device
*caam_jr_alloc(void)
281 struct caam_drv_private_jr
*jrpriv
, *min_jrpriv
= NULL
;
282 struct device
*dev
= ERR_PTR(-ENODEV
);
283 int min_tfm_cnt
= INT_MAX
;
286 spin_lock(&driver_data
.jr_alloc_lock
);
288 if (list_empty(&driver_data
.jr_list
)) {
289 spin_unlock(&driver_data
.jr_alloc_lock
);
290 return ERR_PTR(-ENODEV
);
293 list_for_each_entry(jrpriv
, &driver_data
.jr_list
, list_node
) {
294 tfm_cnt
= atomic_read(&jrpriv
->tfm_count
);
295 if (tfm_cnt
< min_tfm_cnt
) {
296 min_tfm_cnt
= tfm_cnt
;
304 atomic_inc(&min_jrpriv
->tfm_count
);
305 dev
= min_jrpriv
->dev
;
307 spin_unlock(&driver_data
.jr_alloc_lock
);
311 EXPORT_SYMBOL(caam_jr_alloc
);
314 * caam_jr_free() - Free the Job Ring
315 * @rdev - points to the dev that identifies the Job ring to
318 void caam_jr_free(struct device
*rdev
)
320 struct caam_drv_private_jr
*jrpriv
= dev_get_drvdata(rdev
);
322 atomic_dec(&jrpriv
->tfm_count
);
324 EXPORT_SYMBOL(caam_jr_free
);
327 * caam_jr_enqueue() - Enqueue a job descriptor head. Returns 0 if OK,
328 * -EBUSY if the queue is full, -EIO if it cannot map the caller's
330 * @dev: device of the job ring to be used. This device should have
331 * been assigned prior by caam_jr_register().
332 * @desc: points to a job descriptor that execute our request. All
333 * descriptors (and all referenced data) must be in a DMAable
334 * region, and all data references must be physical addresses
335 * accessible to CAAM (i.e. within a PAMU window granted
337 * @cbk: pointer to a callback function to be invoked upon completion
338 * of this request. This has the form:
339 * callback(struct device *dev, u32 *desc, u32 stat, void *arg)
341 * @dev: contains the job ring device that processed this
343 * @desc: descriptor that initiated the request, same as
344 * "desc" being argued to caam_jr_enqueue().
345 * @status: untranslated status received from CAAM. See the
346 * reference manual for a detailed description of
347 * error meaning, or see the JRSTA definitions in the
348 * register header file
349 * @areq: optional pointer to an argument passed with the
351 * @areq: optional pointer to a user argument for use at callback
354 int caam_jr_enqueue(struct device
*dev
, u32
*desc
,
355 void (*cbk
)(struct device
*dev
, u32
*desc
,
356 u32 status
, void *areq
),
359 struct caam_drv_private_jr
*jrp
= dev_get_drvdata(dev
);
360 struct caam_jrentry_info
*head_entry
;
361 int head
, tail
, desc_size
;
364 desc_size
= (caam32_to_cpu(*desc
) & HDR_JD_LENGTH_MASK
) * sizeof(u32
);
365 desc_dma
= dma_map_single(dev
, desc
, desc_size
, DMA_TO_DEVICE
);
366 if (dma_mapping_error(dev
, desc_dma
)) {
367 dev_err(dev
, "caam_jr_enqueue(): can't map jobdesc\n");
371 spin_lock_bh(&jrp
->inplock
);
374 tail
= READ_ONCE(jrp
->tail
);
376 if (!jrp
->inpring_avail
||
377 CIRC_SPACE(head
, tail
, JOBR_DEPTH
) <= 0) {
378 spin_unlock_bh(&jrp
->inplock
);
379 dma_unmap_single(dev
, desc_dma
, desc_size
, DMA_TO_DEVICE
);
383 head_entry
= &jrp
->entinfo
[head
];
384 head_entry
->desc_addr_virt
= desc
;
385 head_entry
->desc_size
= desc_size
;
386 head_entry
->callbk
= (void *)cbk
;
387 head_entry
->cbkarg
= areq
;
388 head_entry
->desc_addr_dma
= desc_dma
;
390 jr_inpentry_set(jrp
->inpring
, head
, cpu_to_caam_dma(desc_dma
));
393 * Guarantee that the descriptor's DMA address has been written to
394 * the next slot in the ring before the write index is updated, since
395 * other cores may update this index independently.
399 jrp
->head
= (head
+ 1) & (JOBR_DEPTH
- 1);
402 * Ensure that all job information has been written before
403 * notifying CAAM that a new job was added to the input ring
404 * using a memory barrier. The wr_reg32() uses api iowrite32()
405 * to do the register write. iowrite32() issues a memory barrier
406 * before the write operation.
409 wr_reg32(&jrp
->rregs
->inpring_jobadd
, 1);
411 jrp
->inpring_avail
--;
412 if (!jrp
->inpring_avail
)
413 jrp
->inpring_avail
= rd_reg32(&jrp
->rregs
->inpring_avail
);
415 spin_unlock_bh(&jrp
->inplock
);
419 EXPORT_SYMBOL(caam_jr_enqueue
);
422 * Init JobR independent of platform property detection
424 static int caam_jr_init(struct device
*dev
)
426 struct caam_drv_private_jr
*jrp
;
427 dma_addr_t inpbusaddr
, outbusaddr
;
430 jrp
= dev_get_drvdata(dev
);
432 error
= caam_reset_hw_jr(dev
);
436 jrp
->inpring
= dmam_alloc_coherent(dev
, SIZEOF_JR_INPENTRY
*
437 JOBR_DEPTH
, &inpbusaddr
,
442 jrp
->outring
= dmam_alloc_coherent(dev
, SIZEOF_JR_OUTENTRY
*
443 JOBR_DEPTH
, &outbusaddr
,
448 jrp
->entinfo
= devm_kcalloc(dev
, JOBR_DEPTH
, sizeof(*jrp
->entinfo
),
453 for (i
= 0; i
< JOBR_DEPTH
; i
++)
454 jrp
->entinfo
[i
].desc_addr_dma
= !0;
457 jrp
->out_ring_read_index
= 0;
461 wr_reg64(&jrp
->rregs
->inpring_base
, inpbusaddr
);
462 wr_reg64(&jrp
->rregs
->outring_base
, outbusaddr
);
463 wr_reg32(&jrp
->rregs
->inpring_size
, JOBR_DEPTH
);
464 wr_reg32(&jrp
->rregs
->outring_size
, JOBR_DEPTH
);
466 jrp
->inpring_avail
= JOBR_DEPTH
;
468 spin_lock_init(&jrp
->inplock
);
470 /* Select interrupt coalescing parameters */
471 clrsetbits_32(&jrp
->rregs
->rconfig_lo
, 0, JOBR_INTC
|
472 (JOBR_INTC_COUNT_THLD
<< JRCFG_ICDCT_SHIFT
) |
473 (JOBR_INTC_TIME_THLD
<< JRCFG_ICTT_SHIFT
));
475 tasklet_init(&jrp
->irqtask
, caam_jr_dequeue
, (unsigned long)dev
);
477 /* Connect job ring interrupt handler. */
478 error
= devm_request_irq(dev
, jrp
->irq
, caam_jr_interrupt
, IRQF_SHARED
,
481 dev_err(dev
, "can't connect JobR %d interrupt (%d)\n",
482 jrp
->ridx
, jrp
->irq
);
483 tasklet_kill(&jrp
->irqtask
);
489 static void caam_jr_irq_dispose_mapping(void *data
)
491 irq_dispose_mapping((unsigned long)data
);
495 * Probe routine for each detected JobR subsystem.
497 static int caam_jr_probe(struct platform_device
*pdev
)
499 struct device
*jrdev
;
500 struct device_node
*nprop
;
501 struct caam_job_ring __iomem
*ctrl
;
502 struct caam_drv_private_jr
*jrpriv
;
503 static int total_jobrs
;
508 jrpriv
= devm_kmalloc(jrdev
, sizeof(*jrpriv
), GFP_KERNEL
);
512 dev_set_drvdata(jrdev
, jrpriv
);
514 /* save ring identity relative to detection */
515 jrpriv
->ridx
= total_jobrs
++;
517 nprop
= pdev
->dev
.of_node
;
518 /* Get configuration properties from device tree */
519 /* First, get register page */
520 r
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
522 dev_err(jrdev
, "platform_get_resource() failed\n");
526 ctrl
= devm_ioremap(jrdev
, r
->start
, resource_size(r
));
528 dev_err(jrdev
, "devm_ioremap() failed\n");
532 jrpriv
->rregs
= (struct caam_job_ring __iomem __force
*)ctrl
;
534 error
= dma_set_mask_and_coherent(jrdev
, caam_get_dma_mask(jrdev
));
536 dev_err(jrdev
, "dma_set_mask_and_coherent failed (%d)\n",
541 /* Identify the interrupt */
542 jrpriv
->irq
= irq_of_parse_and_map(nprop
, 0);
544 dev_err(jrdev
, "irq_of_parse_and_map failed\n");
548 error
= devm_add_action_or_reset(jrdev
, caam_jr_irq_dispose_mapping
,
549 (void *)(unsigned long)jrpriv
->irq
);
553 /* Now do the platform independent part */
554 error
= caam_jr_init(jrdev
); /* now turn on hardware */
559 spin_lock(&driver_data
.jr_alloc_lock
);
560 list_add_tail(&jrpriv
->list_node
, &driver_data
.jr_list
);
561 spin_unlock(&driver_data
.jr_alloc_lock
);
563 atomic_set(&jrpriv
->tfm_count
, 0);
565 register_algs(jrdev
->parent
);
570 static const struct of_device_id caam_jr_match
[] = {
572 .compatible
= "fsl,sec-v4.0-job-ring",
575 .compatible
= "fsl,sec4.0-job-ring",
579 MODULE_DEVICE_TABLE(of
, caam_jr_match
);
581 static struct platform_driver caam_jr_driver
= {
584 .of_match_table
= caam_jr_match
,
586 .probe
= caam_jr_probe
,
587 .remove
= caam_jr_remove
,
590 static int __init
jr_driver_init(void)
592 spin_lock_init(&driver_data
.jr_alloc_lock
);
593 INIT_LIST_HEAD(&driver_data
.jr_list
);
594 return platform_driver_register(&caam_jr_driver
);
597 static void __exit
jr_driver_exit(void)
599 platform_driver_unregister(&caam_jr_driver
);
602 module_init(jr_driver_init
);
603 module_exit(jr_driver_exit
);
605 MODULE_LICENSE("GPL");
606 MODULE_DESCRIPTION("FSL CAAM JR request backend");
607 MODULE_AUTHOR("Freescale Semiconductor - NMG/STC");