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 caam_drv_private_jr *jrpriv,
33 mutex_lock(&algs_lock);
35 if (++active_devs != 1)
38 caam_algapi_init(dev);
39 caam_algapi_hash_init(dev);
41 jrpriv->hwrng = !caam_rng_init(dev);
42 caam_prng_register(dev);
43 caam_qi_algapi_init(dev);
46 mutex_unlock(&algs_lock);
49 static void unregister_algs(void)
51 mutex_lock(&algs_lock);
53 if (--active_devs != 0)
56 caam_qi_algapi_exit();
57 caam_prng_unregister(NULL);
59 caam_algapi_hash_exit();
63 mutex_unlock(&algs_lock);
66 static void caam_jr_crypto_engine_exit(void *data)
68 struct device *jrdev = data;
69 struct caam_drv_private_jr *jrpriv = dev_get_drvdata(jrdev);
71 /* Free the resources of crypto-engine */
72 crypto_engine_exit(jrpriv->engine);
75 static int caam_reset_hw_jr(struct device *dev)
77 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
78 unsigned int timeout = 100000;
81 * mask interrupts since we are going to poll
82 * for reset completion status
84 clrsetbits_32(&jrp->rregs->rconfig_lo, 0, JRCFG_IMSK);
86 /* initiate flush (required prior to reset) */
87 wr_reg32(&jrp->rregs->jrcommand, JRCR_RESET);
88 while (((rd_reg32(&jrp->rregs->jrintstatus) & JRINT_ERR_HALT_MASK) ==
89 JRINT_ERR_HALT_INPROGRESS) && --timeout)
92 if ((rd_reg32(&jrp->rregs->jrintstatus) & JRINT_ERR_HALT_MASK) !=
93 JRINT_ERR_HALT_COMPLETE || timeout == 0) {
94 dev_err(dev, "failed to flush job ring %d\n", jrp->ridx);
100 wr_reg32(&jrp->rregs->jrcommand, JRCR_RESET);
101 while ((rd_reg32(&jrp->rregs->jrcommand) & JRCR_RESET) && --timeout)
105 dev_err(dev, "failed to reset job ring %d\n", jrp->ridx);
109 /* unmask interrupts */
110 clrsetbits_32(&jrp->rregs->rconfig_lo, JRCFG_IMSK, 0);
116 * Shutdown JobR independent of platform property code
118 static int caam_jr_shutdown(struct device *dev)
120 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
123 ret = caam_reset_hw_jr(dev);
125 tasklet_kill(&jrp->irqtask);
130 static int caam_jr_remove(struct platform_device *pdev)
133 struct device *jrdev;
134 struct caam_drv_private_jr *jrpriv;
137 jrpriv = dev_get_drvdata(jrdev);
140 caam_rng_exit(jrdev->parent);
143 * Return EBUSY if job ring already allocated.
145 if (atomic_read(&jrpriv->tfm_count)) {
146 dev_err(jrdev, "Device is busy\n");
150 /* Unregister JR-based RNG & crypto algorithms */
153 /* Remove the node from Physical JobR list maintained by driver */
154 spin_lock(&driver_data.jr_alloc_lock);
155 list_del(&jrpriv->list_node);
156 spin_unlock(&driver_data.jr_alloc_lock);
159 ret = caam_jr_shutdown(jrdev);
161 dev_err(jrdev, "Failed to shut down job ring\n");
166 /* Main per-ring interrupt handler */
167 static irqreturn_t caam_jr_interrupt(int irq, void *st_dev)
169 struct device *dev = st_dev;
170 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
174 * Check the output ring for ready responses, kick
175 * tasklet if jobs done.
177 irqstate = rd_reg32(&jrp->rregs->jrintstatus);
182 * If JobR error, we got more development work to do
183 * Flag a bug now, but we really need to shut down and
184 * restart the queue (and fix code).
186 if (irqstate & JRINT_JR_ERROR) {
187 dev_err(dev, "job ring error: irqstate: %08x\n", irqstate);
191 /* mask valid interrupts */
192 clrsetbits_32(&jrp->rregs->rconfig_lo, 0, JRCFG_IMSK);
194 /* Have valid interrupt at this point, just ACK and trigger */
195 wr_reg32(&jrp->rregs->jrintstatus, irqstate);
198 tasklet_schedule(&jrp->irqtask);
204 /* Deferred service handler, run as interrupt-fired tasklet */
205 static void caam_jr_dequeue(unsigned long devarg)
207 int hw_idx, sw_idx, i, head, tail;
208 struct device *dev = (struct device *)devarg;
209 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
210 void (*usercall)(struct device *dev, u32 *desc, u32 status, void *arg);
211 u32 *userdesc, userstatus;
213 u32 outring_used = 0;
215 while (outring_used ||
216 (outring_used = rd_reg32(&jrp->rregs->outring_used))) {
218 head = READ_ONCE(jrp->head);
220 sw_idx = tail = jrp->tail;
221 hw_idx = jrp->out_ring_read_index;
223 for (i = 0; CIRC_CNT(head, tail + i, JOBR_DEPTH) >= 1; i++) {
224 sw_idx = (tail + i) & (JOBR_DEPTH - 1);
226 if (jr_outentry_desc(jrp->outring, hw_idx) ==
227 caam_dma_to_cpu(jrp->entinfo[sw_idx].desc_addr_dma))
230 /* we should never fail to find a matching descriptor */
231 BUG_ON(CIRC_CNT(head, tail + i, JOBR_DEPTH) <= 0);
233 /* Unmap just-run descriptor so we can post-process */
234 dma_unmap_single(dev,
235 caam_dma_to_cpu(jr_outentry_desc(jrp->outring,
237 jrp->entinfo[sw_idx].desc_size,
240 /* mark completed, avoid matching on a recycled desc addr */
241 jrp->entinfo[sw_idx].desc_addr_dma = 0;
243 /* Stash callback params */
244 usercall = jrp->entinfo[sw_idx].callbk;
245 userarg = jrp->entinfo[sw_idx].cbkarg;
246 userdesc = jrp->entinfo[sw_idx].desc_addr_virt;
247 userstatus = caam32_to_cpu(jr_outentry_jrstatus(jrp->outring,
251 * Make sure all information from the job has been obtained
252 * before telling CAAM that the job has been removed from the
258 wr_reg32(&jrp->rregs->outring_rmvd, 1);
260 jrp->out_ring_read_index = (jrp->out_ring_read_index + 1) &
264 * if this job completed out-of-order, do not increment
265 * the tail. Otherwise, increment tail by 1 plus the
266 * number of subsequent jobs already completed out-of-order
268 if (sw_idx == tail) {
270 tail = (tail + 1) & (JOBR_DEPTH - 1);
271 } while (CIRC_CNT(head, tail, JOBR_DEPTH) >= 1 &&
272 jrp->entinfo[tail].desc_addr_dma == 0);
277 /* Finally, execute user's callback */
278 usercall(dev, userdesc, userstatus, userarg);
282 /* reenable / unmask IRQs */
283 clrsetbits_32(&jrp->rregs->rconfig_lo, JRCFG_IMSK, 0);
287 * caam_jr_alloc() - Alloc a job ring for someone to use as needed.
289 * returns : pointer to the newly allocated physical
290 * JobR dev can be written to if successful.
292 struct device *caam_jr_alloc(void)
294 struct caam_drv_private_jr *jrpriv, *min_jrpriv = NULL;
295 struct device *dev = ERR_PTR(-ENODEV);
296 int min_tfm_cnt = INT_MAX;
299 spin_lock(&driver_data.jr_alloc_lock);
301 if (list_empty(&driver_data.jr_list)) {
302 spin_unlock(&driver_data.jr_alloc_lock);
303 return ERR_PTR(-ENODEV);
306 list_for_each_entry(jrpriv, &driver_data.jr_list, list_node) {
307 tfm_cnt = atomic_read(&jrpriv->tfm_count);
308 if (tfm_cnt < min_tfm_cnt) {
309 min_tfm_cnt = tfm_cnt;
317 atomic_inc(&min_jrpriv->tfm_count);
318 dev = min_jrpriv->dev;
320 spin_unlock(&driver_data.jr_alloc_lock);
324 EXPORT_SYMBOL(caam_jr_alloc);
327 * caam_jr_free() - Free the Job Ring
328 * @rdev: points to the dev that identifies the Job ring to
331 void caam_jr_free(struct device *rdev)
333 struct caam_drv_private_jr *jrpriv = dev_get_drvdata(rdev);
335 atomic_dec(&jrpriv->tfm_count);
337 EXPORT_SYMBOL(caam_jr_free);
340 * caam_jr_enqueue() - Enqueue a job descriptor head. Returns -EINPROGRESS
341 * if OK, -ENOSPC if the queue is full, -EIO if it cannot map the caller's
343 * @dev: struct device of the job ring to be used
344 * @desc: points to a job descriptor that execute our request. All
345 * descriptors (and all referenced data) must be in a DMAable
346 * region, and all data references must be physical addresses
347 * accessible to CAAM (i.e. within a PAMU window granted
349 * @cbk: pointer to a callback function to be invoked upon completion
350 * of this request. This has the form:
351 * callback(struct device *dev, u32 *desc, u32 stat, void *arg)
353 * dev: contains the job ring device that processed this
355 * desc: descriptor that initiated the request, same as
356 * "desc" being argued to caam_jr_enqueue().
357 * status: untranslated status received from CAAM. See the
358 * reference manual for a detailed description of
359 * error meaning, or see the JRSTA definitions in the
360 * register header file
361 * areq: optional pointer to an argument passed with the
363 * @areq: optional pointer to a user argument for use at callback
366 int caam_jr_enqueue(struct device *dev, u32 *desc,
367 void (*cbk)(struct device *dev, u32 *desc,
368 u32 status, void *areq),
371 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
372 struct caam_jrentry_info *head_entry;
373 int head, tail, desc_size;
376 desc_size = (caam32_to_cpu(*desc) & HDR_JD_LENGTH_MASK) * sizeof(u32);
377 desc_dma = dma_map_single(dev, desc, desc_size, DMA_TO_DEVICE);
378 if (dma_mapping_error(dev, desc_dma)) {
379 dev_err(dev, "caam_jr_enqueue(): can't map jobdesc\n");
383 spin_lock_bh(&jrp->inplock);
386 tail = READ_ONCE(jrp->tail);
388 if (!jrp->inpring_avail ||
389 CIRC_SPACE(head, tail, JOBR_DEPTH) <= 0) {
390 spin_unlock_bh(&jrp->inplock);
391 dma_unmap_single(dev, desc_dma, desc_size, DMA_TO_DEVICE);
395 head_entry = &jrp->entinfo[head];
396 head_entry->desc_addr_virt = desc;
397 head_entry->desc_size = desc_size;
398 head_entry->callbk = (void *)cbk;
399 head_entry->cbkarg = areq;
400 head_entry->desc_addr_dma = desc_dma;
402 jr_inpentry_set(jrp->inpring, head, cpu_to_caam_dma(desc_dma));
405 * Guarantee that the descriptor's DMA address has been written to
406 * the next slot in the ring before the write index is updated, since
407 * other cores may update this index independently.
411 jrp->head = (head + 1) & (JOBR_DEPTH - 1);
414 * Ensure that all job information has been written before
415 * notifying CAAM that a new job was added to the input ring
416 * using a memory barrier. The wr_reg32() uses api iowrite32()
417 * to do the register write. iowrite32() issues a memory barrier
418 * before the write operation.
421 wr_reg32(&jrp->rregs->inpring_jobadd, 1);
423 jrp->inpring_avail--;
424 if (!jrp->inpring_avail)
425 jrp->inpring_avail = rd_reg32(&jrp->rregs->inpring_avail);
427 spin_unlock_bh(&jrp->inplock);
431 EXPORT_SYMBOL(caam_jr_enqueue);
434 * Init JobR independent of platform property detection
436 static int caam_jr_init(struct device *dev)
438 struct caam_drv_private_jr *jrp;
439 dma_addr_t inpbusaddr, outbusaddr;
442 jrp = dev_get_drvdata(dev);
444 error = caam_reset_hw_jr(dev);
448 jrp->inpring = dmam_alloc_coherent(dev, SIZEOF_JR_INPENTRY *
449 JOBR_DEPTH, &inpbusaddr,
454 jrp->outring = dmam_alloc_coherent(dev, SIZEOF_JR_OUTENTRY *
455 JOBR_DEPTH, &outbusaddr,
460 jrp->entinfo = devm_kcalloc(dev, JOBR_DEPTH, sizeof(*jrp->entinfo),
465 for (i = 0; i < JOBR_DEPTH; i++)
466 jrp->entinfo[i].desc_addr_dma = !0;
469 jrp->out_ring_read_index = 0;
473 wr_reg64(&jrp->rregs->inpring_base, inpbusaddr);
474 wr_reg64(&jrp->rregs->outring_base, outbusaddr);
475 wr_reg32(&jrp->rregs->inpring_size, JOBR_DEPTH);
476 wr_reg32(&jrp->rregs->outring_size, JOBR_DEPTH);
478 jrp->inpring_avail = JOBR_DEPTH;
480 spin_lock_init(&jrp->inplock);
482 /* Select interrupt coalescing parameters */
483 clrsetbits_32(&jrp->rregs->rconfig_lo, 0, JOBR_INTC |
484 (JOBR_INTC_COUNT_THLD << JRCFG_ICDCT_SHIFT) |
485 (JOBR_INTC_TIME_THLD << JRCFG_ICTT_SHIFT));
487 tasklet_init(&jrp->irqtask, caam_jr_dequeue, (unsigned long)dev);
489 /* Connect job ring interrupt handler. */
490 error = devm_request_irq(dev, jrp->irq, caam_jr_interrupt, IRQF_SHARED,
493 dev_err(dev, "can't connect JobR %d interrupt (%d)\n",
494 jrp->ridx, jrp->irq);
495 tasklet_kill(&jrp->irqtask);
501 static void caam_jr_irq_dispose_mapping(void *data)
503 irq_dispose_mapping((unsigned long)data);
507 * Probe routine for each detected JobR subsystem.
509 static int caam_jr_probe(struct platform_device *pdev)
511 struct device *jrdev;
512 struct device_node *nprop;
513 struct caam_job_ring __iomem *ctrl;
514 struct caam_drv_private_jr *jrpriv;
515 static int total_jobrs;
520 jrpriv = devm_kzalloc(jrdev, sizeof(*jrpriv), GFP_KERNEL);
524 dev_set_drvdata(jrdev, jrpriv);
526 /* save ring identity relative to detection */
527 jrpriv->ridx = total_jobrs++;
529 nprop = pdev->dev.of_node;
530 /* Get configuration properties from device tree */
531 /* First, get register page */
532 r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
534 dev_err(jrdev, "platform_get_resource() failed\n");
538 ctrl = devm_ioremap(jrdev, r->start, resource_size(r));
540 dev_err(jrdev, "devm_ioremap() failed\n");
544 jrpriv->rregs = (struct caam_job_ring __iomem __force *)ctrl;
546 error = dma_set_mask_and_coherent(jrdev, caam_get_dma_mask(jrdev));
548 dev_err(jrdev, "dma_set_mask_and_coherent failed (%d)\n",
553 /* Initialize crypto engine */
554 jrpriv->engine = crypto_engine_alloc_init_and_set(jrdev, true, NULL,
556 CRYPTO_ENGINE_MAX_QLEN);
557 if (!jrpriv->engine) {
558 dev_err(jrdev, "Could not init crypto-engine\n");
562 error = devm_add_action_or_reset(jrdev, caam_jr_crypto_engine_exit,
567 /* Start crypto engine */
568 error = crypto_engine_start(jrpriv->engine);
570 dev_err(jrdev, "Could not start crypto-engine\n");
574 /* Identify the interrupt */
575 jrpriv->irq = irq_of_parse_and_map(nprop, 0);
577 dev_err(jrdev, "irq_of_parse_and_map failed\n");
581 error = devm_add_action_or_reset(jrdev, caam_jr_irq_dispose_mapping,
582 (void *)(unsigned long)jrpriv->irq);
586 /* Now do the platform independent part */
587 error = caam_jr_init(jrdev); /* now turn on hardware */
592 spin_lock(&driver_data.jr_alloc_lock);
593 list_add_tail(&jrpriv->list_node, &driver_data.jr_list);
594 spin_unlock(&driver_data.jr_alloc_lock);
596 atomic_set(&jrpriv->tfm_count, 0);
598 register_algs(jrpriv, jrdev->parent);
603 static const struct of_device_id caam_jr_match[] = {
605 .compatible = "fsl,sec-v4.0-job-ring",
608 .compatible = "fsl,sec4.0-job-ring",
612 MODULE_DEVICE_TABLE(of, caam_jr_match);
614 static struct platform_driver caam_jr_driver = {
617 .of_match_table = caam_jr_match,
619 .probe = caam_jr_probe,
620 .remove = caam_jr_remove,
623 static int __init jr_driver_init(void)
625 spin_lock_init(&driver_data.jr_alloc_lock);
626 INIT_LIST_HEAD(&driver_data.jr_list);
627 return platform_driver_register(&caam_jr_driver);
630 static void __exit jr_driver_exit(void)
632 platform_driver_unregister(&caam_jr_driver);
635 module_init(jr_driver_init);
636 module_exit(jr_driver_exit);
638 MODULE_LICENSE("GPL");
639 MODULE_DESCRIPTION("FSL CAAM JR request backend");
640 MODULE_AUTHOR("Freescale Semiconductor - NMG/STC");