2 * CAAM/SEC 4.x transport/backend driver
3 * JobR backend functionality
5 * Copyright 2008-2012 Freescale Semiconductor, Inc.
14 struct jr_driver_data {
15 /* List of Physical JobR's with the Driver */
16 struct list_head jr_list;
17 spinlock_t jr_alloc_lock; /* jr_list lock */
18 } ____cacheline_aligned;
20 static struct jr_driver_data driver_data;
22 static int caam_reset_hw_jr(struct device *dev)
24 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
25 unsigned int timeout = 100000;
28 * mask interrupts since we are going to poll
29 * for reset completion status
31 setbits32(&jrp->rregs->rconfig_lo, JRCFG_IMSK);
33 /* initiate flush (required prior to reset) */
34 wr_reg32(&jrp->rregs->jrcommand, JRCR_RESET);
35 while (((rd_reg32(&jrp->rregs->jrintstatus) & JRINT_ERR_HALT_MASK) ==
36 JRINT_ERR_HALT_INPROGRESS) && --timeout)
39 if ((rd_reg32(&jrp->rregs->jrintstatus) & JRINT_ERR_HALT_MASK) !=
40 JRINT_ERR_HALT_COMPLETE || timeout == 0) {
41 dev_err(dev, "failed to flush job ring %d\n", jrp->ridx);
47 wr_reg32(&jrp->rregs->jrcommand, JRCR_RESET);
48 while ((rd_reg32(&jrp->rregs->jrcommand) & JRCR_RESET) && --timeout)
52 dev_err(dev, "failed to reset job ring %d\n", jrp->ridx);
56 /* unmask interrupts */
57 clrbits32(&jrp->rregs->rconfig_lo, JRCFG_IMSK);
63 * Shutdown JobR independent of platform property code
65 int caam_jr_shutdown(struct device *dev)
67 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
68 dma_addr_t inpbusaddr, outbusaddr;
71 ret = caam_reset_hw_jr(dev);
73 tasklet_kill(&jrp->irqtask);
75 /* Release interrupt */
76 free_irq(jrp->irq, dev);
79 inpbusaddr = rd_reg64(&jrp->rregs->inpring_base);
80 outbusaddr = rd_reg64(&jrp->rregs->outring_base);
81 dma_free_coherent(dev, sizeof(dma_addr_t) * JOBR_DEPTH,
82 jrp->inpring, inpbusaddr);
83 dma_free_coherent(dev, sizeof(struct jr_outentry) * JOBR_DEPTH,
84 jrp->outring, outbusaddr);
90 static int caam_jr_remove(struct platform_device *pdev)
94 struct caam_drv_private_jr *jrpriv;
97 jrpriv = dev_get_drvdata(jrdev);
100 * Return EBUSY if job ring already allocated.
102 if (atomic_read(&jrpriv->tfm_count)) {
103 dev_err(jrdev, "Device is busy\n");
107 /* Remove the node from Physical JobR list maintained by driver */
108 spin_lock(&driver_data.jr_alloc_lock);
109 list_del(&jrpriv->list_node);
110 spin_unlock(&driver_data.jr_alloc_lock);
113 ret = caam_jr_shutdown(jrdev);
115 dev_err(jrdev, "Failed to shut down job ring\n");
116 irq_dispose_mapping(jrpriv->irq);
121 /* Main per-ring interrupt handler */
122 static irqreturn_t caam_jr_interrupt(int irq, void *st_dev)
124 struct device *dev = st_dev;
125 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
129 * Check the output ring for ready responses, kick
130 * tasklet if jobs done.
132 irqstate = rd_reg32(&jrp->rregs->jrintstatus);
137 * If JobR error, we got more development work to do
138 * Flag a bug now, but we really need to shut down and
139 * restart the queue (and fix code).
141 if (irqstate & JRINT_JR_ERROR) {
142 dev_err(dev, "job ring error: irqstate: %08x\n", irqstate);
146 /* mask valid interrupts */
147 setbits32(&jrp->rregs->rconfig_lo, JRCFG_IMSK);
149 /* Have valid interrupt at this point, just ACK and trigger */
150 wr_reg32(&jrp->rregs->jrintstatus, irqstate);
153 tasklet_schedule(&jrp->irqtask);
159 /* Deferred service handler, run as interrupt-fired tasklet */
160 static void caam_jr_dequeue(unsigned long devarg)
162 int hw_idx, sw_idx, i, head, tail;
163 struct device *dev = (struct device *)devarg;
164 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
165 void (*usercall)(struct device *dev, u32 *desc, u32 status, void *arg);
166 u32 *userdesc, userstatus;
169 while (rd_reg32(&jrp->rregs->outring_used)) {
171 head = ACCESS_ONCE(jrp->head);
173 spin_lock(&jrp->outlock);
175 sw_idx = tail = jrp->tail;
176 hw_idx = jrp->out_ring_read_index;
178 for (i = 0; CIRC_CNT(head, tail + i, JOBR_DEPTH) >= 1; i++) {
179 sw_idx = (tail + i) & (JOBR_DEPTH - 1);
181 smp_read_barrier_depends();
183 if (jrp->outring[hw_idx].desc ==
184 jrp->entinfo[sw_idx].desc_addr_dma)
187 /* we should never fail to find a matching descriptor */
188 BUG_ON(CIRC_CNT(head, tail + i, JOBR_DEPTH) <= 0);
190 /* Unmap just-run descriptor so we can post-process */
191 dma_unmap_single(dev, jrp->outring[hw_idx].desc,
192 jrp->entinfo[sw_idx].desc_size,
195 /* mark completed, avoid matching on a recycled desc addr */
196 jrp->entinfo[sw_idx].desc_addr_dma = 0;
198 /* Stash callback params for use outside of lock */
199 usercall = jrp->entinfo[sw_idx].callbk;
200 userarg = jrp->entinfo[sw_idx].cbkarg;
201 userdesc = jrp->entinfo[sw_idx].desc_addr_virt;
202 userstatus = jrp->outring[hw_idx].jrstatus;
205 wr_reg32(&jrp->rregs->outring_rmvd, 1);
207 jrp->out_ring_read_index = (jrp->out_ring_read_index + 1) &
211 * if this job completed out-of-order, do not increment
212 * the tail. Otherwise, increment tail by 1 plus the
213 * number of subsequent jobs already completed out-of-order
215 if (sw_idx == tail) {
217 tail = (tail + 1) & (JOBR_DEPTH - 1);
218 smp_read_barrier_depends();
219 } while (CIRC_CNT(head, tail, JOBR_DEPTH) >= 1 &&
220 jrp->entinfo[tail].desc_addr_dma == 0);
225 spin_unlock(&jrp->outlock);
227 /* Finally, execute user's callback */
228 usercall(dev, userdesc, userstatus, userarg);
231 /* reenable / unmask IRQs */
232 clrbits32(&jrp->rregs->rconfig_lo, JRCFG_IMSK);
236 * caam_jr_alloc() - Alloc a job ring for someone to use as needed.
238 * returns : pointer to the newly allocated physical
239 * JobR dev can be written to if successful.
241 struct device *caam_jr_alloc(void)
243 struct caam_drv_private_jr *jrpriv, *min_jrpriv = NULL;
244 struct device *dev = NULL;
245 int min_tfm_cnt = INT_MAX;
248 spin_lock(&driver_data.jr_alloc_lock);
250 if (list_empty(&driver_data.jr_list)) {
251 spin_unlock(&driver_data.jr_alloc_lock);
252 return ERR_PTR(-ENODEV);
255 list_for_each_entry(jrpriv, &driver_data.jr_list, list_node) {
256 tfm_cnt = atomic_read(&jrpriv->tfm_count);
257 if (tfm_cnt < min_tfm_cnt) {
258 min_tfm_cnt = tfm_cnt;
266 atomic_inc(&min_jrpriv->tfm_count);
267 dev = min_jrpriv->dev;
269 spin_unlock(&driver_data.jr_alloc_lock);
273 EXPORT_SYMBOL(caam_jr_alloc);
276 * caam_jr_free() - Free the Job Ring
277 * @rdev - points to the dev that identifies the Job ring to
280 void caam_jr_free(struct device *rdev)
282 struct caam_drv_private_jr *jrpriv = dev_get_drvdata(rdev);
284 atomic_dec(&jrpriv->tfm_count);
286 EXPORT_SYMBOL(caam_jr_free);
289 * caam_jr_enqueue() - Enqueue a job descriptor head. Returns 0 if OK,
290 * -EBUSY if the queue is full, -EIO if it cannot map the caller's
292 * @dev: device of the job ring to be used. This device should have
293 * been assigned prior by caam_jr_register().
294 * @desc: points to a job descriptor that execute our request. All
295 * descriptors (and all referenced data) must be in a DMAable
296 * region, and all data references must be physical addresses
297 * accessible to CAAM (i.e. within a PAMU window granted
299 * @cbk: pointer to a callback function to be invoked upon completion
300 * of this request. This has the form:
301 * callback(struct device *dev, u32 *desc, u32 stat, void *arg)
303 * @dev: contains the job ring device that processed this
305 * @desc: descriptor that initiated the request, same as
306 * "desc" being argued to caam_jr_enqueue().
307 * @status: untranslated status received from CAAM. See the
308 * reference manual for a detailed description of
309 * error meaning, or see the JRSTA definitions in the
310 * register header file
311 * @areq: optional pointer to an argument passed with the
313 * @areq: optional pointer to a user argument for use at callback
316 int caam_jr_enqueue(struct device *dev, u32 *desc,
317 void (*cbk)(struct device *dev, u32 *desc,
318 u32 status, void *areq),
321 struct caam_drv_private_jr *jrp = dev_get_drvdata(dev);
322 struct caam_jrentry_info *head_entry;
323 int head, tail, desc_size;
326 desc_size = (*desc & HDR_JD_LENGTH_MASK) * sizeof(u32);
327 desc_dma = dma_map_single(dev, desc, desc_size, DMA_TO_DEVICE);
328 if (dma_mapping_error(dev, desc_dma)) {
329 dev_err(dev, "caam_jr_enqueue(): can't map jobdesc\n");
333 spin_lock_bh(&jrp->inplock);
336 tail = ACCESS_ONCE(jrp->tail);
338 if (!rd_reg32(&jrp->rregs->inpring_avail) ||
339 CIRC_SPACE(head, tail, JOBR_DEPTH) <= 0) {
340 spin_unlock_bh(&jrp->inplock);
341 dma_unmap_single(dev, desc_dma, desc_size, DMA_TO_DEVICE);
345 head_entry = &jrp->entinfo[head];
346 head_entry->desc_addr_virt = desc;
347 head_entry->desc_size = desc_size;
348 head_entry->callbk = (void *)cbk;
349 head_entry->cbkarg = areq;
350 head_entry->desc_addr_dma = desc_dma;
352 jrp->inpring[jrp->inp_ring_write_index] = desc_dma;
356 jrp->inp_ring_write_index = (jrp->inp_ring_write_index + 1) &
358 jrp->head = (head + 1) & (JOBR_DEPTH - 1);
360 wr_reg32(&jrp->rregs->inpring_jobadd, 1);
362 spin_unlock_bh(&jrp->inplock);
366 EXPORT_SYMBOL(caam_jr_enqueue);
369 * Init JobR independent of platform property detection
371 static int caam_jr_init(struct device *dev)
373 struct caam_drv_private_jr *jrp;
374 dma_addr_t inpbusaddr, outbusaddr;
377 jrp = dev_get_drvdata(dev);
379 tasklet_init(&jrp->irqtask, caam_jr_dequeue, (unsigned long)dev);
381 /* Connect job ring interrupt handler. */
382 error = request_irq(jrp->irq, caam_jr_interrupt, IRQF_SHARED,
385 dev_err(dev, "can't connect JobR %d interrupt (%d)\n",
386 jrp->ridx, jrp->irq);
387 irq_dispose_mapping(jrp->irq);
392 error = caam_reset_hw_jr(dev);
396 jrp->inpring = dma_alloc_coherent(dev, sizeof(dma_addr_t) * JOBR_DEPTH,
397 &inpbusaddr, GFP_KERNEL);
399 jrp->outring = dma_alloc_coherent(dev, sizeof(struct jr_outentry) *
400 JOBR_DEPTH, &outbusaddr, GFP_KERNEL);
402 jrp->entinfo = kzalloc(sizeof(struct caam_jrentry_info) * JOBR_DEPTH,
405 if ((jrp->inpring == NULL) || (jrp->outring == NULL) ||
406 (jrp->entinfo == NULL)) {
407 dev_err(dev, "can't allocate job rings for %d\n",
412 for (i = 0; i < JOBR_DEPTH; i++)
413 jrp->entinfo[i].desc_addr_dma = !0;
416 jrp->inp_ring_write_index = 0;
417 jrp->out_ring_read_index = 0;
421 wr_reg64(&jrp->rregs->inpring_base, inpbusaddr);
422 wr_reg64(&jrp->rregs->outring_base, outbusaddr);
423 wr_reg32(&jrp->rregs->inpring_size, JOBR_DEPTH);
424 wr_reg32(&jrp->rregs->outring_size, JOBR_DEPTH);
426 jrp->ringsize = JOBR_DEPTH;
428 spin_lock_init(&jrp->inplock);
429 spin_lock_init(&jrp->outlock);
431 /* Select interrupt coalescing parameters */
432 setbits32(&jrp->rregs->rconfig_lo, JOBR_INTC |
433 (JOBR_INTC_COUNT_THLD << JRCFG_ICDCT_SHIFT) |
434 (JOBR_INTC_TIME_THLD << JRCFG_ICTT_SHIFT));
441 * Probe routine for each detected JobR subsystem.
443 static int caam_jr_probe(struct platform_device *pdev)
445 struct device *jrdev;
446 struct device_node *nprop;
447 struct caam_job_ring __iomem *ctrl;
448 struct caam_drv_private_jr *jrpriv;
449 static int total_jobrs;
453 jrpriv = kmalloc(sizeof(struct caam_drv_private_jr),
458 dev_set_drvdata(jrdev, jrpriv);
460 /* save ring identity relative to detection */
461 jrpriv->ridx = total_jobrs++;
463 nprop = pdev->dev.of_node;
464 /* Get configuration properties from device tree */
465 /* First, get register page */
466 ctrl = of_iomap(nprop, 0);
468 dev_err(jrdev, "of_iomap() failed\n");
472 jrpriv->rregs = (struct caam_job_ring __force *)ctrl;
474 if (sizeof(dma_addr_t) == sizeof(u64))
475 if (of_device_is_compatible(nprop, "fsl,sec-v5.0-job-ring"))
476 dma_set_mask(jrdev, DMA_BIT_MASK(40));
478 dma_set_mask(jrdev, DMA_BIT_MASK(36));
480 dma_set_mask(jrdev, DMA_BIT_MASK(32));
482 /* Identify the interrupt */
483 jrpriv->irq = of_irq_to_resource(nprop, 0, NULL);
485 /* Now do the platform independent part */
486 error = caam_jr_init(jrdev); /* now turn on hardware */
493 spin_lock(&driver_data.jr_alloc_lock);
494 list_add_tail(&jrpriv->list_node, &driver_data.jr_list);
495 spin_unlock(&driver_data.jr_alloc_lock);
497 atomic_set(&jrpriv->tfm_count, 0);
502 static struct of_device_id caam_jr_match[] = {
504 .compatible = "fsl,sec-v4.0-job-ring",
507 .compatible = "fsl,sec4.0-job-ring",
511 MODULE_DEVICE_TABLE(of, caam_jr_match);
513 static struct platform_driver caam_jr_driver = {
516 .owner = THIS_MODULE,
517 .of_match_table = caam_jr_match,
519 .probe = caam_jr_probe,
520 .remove = caam_jr_remove,
523 static int __init jr_driver_init(void)
525 spin_lock_init(&driver_data.jr_alloc_lock);
526 INIT_LIST_HEAD(&driver_data.jr_list);
527 return platform_driver_register(&caam_jr_driver);
530 static void __exit jr_driver_exit(void)
532 platform_driver_unregister(&caam_jr_driver);
535 module_init(jr_driver_init);
536 module_exit(jr_driver_exit);
538 MODULE_LICENSE("GPL");
539 MODULE_DESCRIPTION("FSL CAAM JR request backend");
540 MODULE_AUTHOR("Freescale Semiconductor - NMG/STC");