Linux Audio

Check our new training course

Loading...
v6.8
  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 * CAAM/SEC 4.x driver backend
  4 * Private/internal definitions between modules
  5 *
  6 * Copyright 2008-2011 Freescale Semiconductor, Inc.
  7 * Copyright 2019, 2023 NXP
  8 */
  9
 10#ifndef INTERN_H
 11#define INTERN_H
 12
 13#include "ctrl.h"
 14#include <crypto/engine.h>
 15
 16/* Currently comes from Kconfig param as a ^2 (driver-required) */
 17#define JOBR_DEPTH (1 << CONFIG_CRYPTO_DEV_FSL_CAAM_RINGSIZE)
 18
 19/*
 20 * Maximum size for crypto-engine software queue based on Job Ring
 21 * size (JOBR_DEPTH) and a THRESHOLD (reserved for the non-crypto-API
 22 * requests that are not passed through crypto-engine)
 23 */
 24#define THRESHOLD 15
 25#define CRYPTO_ENGINE_MAX_QLEN (JOBR_DEPTH - THRESHOLD)
 26
 27/* Kconfig params for interrupt coalescing if selected (else zero) */
 28#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_INTC
 29#define JOBR_INTC JRCFG_ICEN
 30#define JOBR_INTC_TIME_THLD CONFIG_CRYPTO_DEV_FSL_CAAM_INTC_TIME_THLD
 31#define JOBR_INTC_COUNT_THLD CONFIG_CRYPTO_DEV_FSL_CAAM_INTC_COUNT_THLD
 32#else
 33#define JOBR_INTC 0
 34#define JOBR_INTC_TIME_THLD 0
 35#define JOBR_INTC_COUNT_THLD 0
 36#endif
 37
 38/*
 39 * Storage for tracking each in-process entry moving across a ring
 40 * Each entry on an output ring needs one of these
 41 */
 42struct caam_jrentry_info {
 43	void (*callbk)(struct device *dev, u32 *desc, u32 status, void *arg);
 44	void *cbkarg;	/* Argument per ring entry */
 45	u32 *desc_addr_virt;	/* Stored virt addr for postprocessing */
 46	dma_addr_t desc_addr_dma;	/* Stored bus addr for done matching */
 47	u32 desc_size;	/* Stored size for postprocessing, header derived */
 48};
 49
 50struct caam_jr_state {
 51	dma_addr_t inpbusaddr;
 52	dma_addr_t outbusaddr;
 53};
 54
 55struct caam_jr_dequeue_params {
 56	struct device *dev;
 57	int enable_itr;
 58};
 59
 60/* Private sub-storage for a single JobR */
 61struct caam_drv_private_jr {
 62	struct list_head	list_node;	/* Job Ring device list */
 63	struct device		*dev;
 64	int ridx;
 65	struct caam_job_ring __iomem *rregs;	/* JobR's register space */
 66	struct tasklet_struct irqtask;
 67	struct caam_jr_dequeue_params tasklet_params;
 68	int irq;			/* One per queue */
 69	bool hwrng;
 70
 71	/* Number of scatterlist crypt transforms active on the JobR */
 72	atomic_t tfm_count ____cacheline_aligned;
 73
 74	/* Job ring info */
 
 75	struct caam_jrentry_info *entinfo;	/* Alloc'ed 1 per ring entry */
 76	spinlock_t inplock ____cacheline_aligned; /* Input ring index lock */
 77	u32 inpring_avail;	/* Number of free entries in input ring */
 78	int head;			/* entinfo (s/w ring) head index */
 79	void *inpring;			/* Base of input ring, alloc
 80					 * DMA-safe */
 81	int out_ring_read_index;	/* Output index "tail" */
 82	int tail;			/* entinfo (s/w ring) tail index */
 83	void *outring;			/* Base of output ring, DMA-safe */
 84	struct crypto_engine *engine;
 85
 86	struct caam_jr_state state;	/* State of the JR during PM */
 87};
 88
 89struct caam_ctl_state {
 90	struct masterid deco_mid[16];
 91	struct masterid jr_mid[4];
 92	u32 mcr;
 93	u32 scfgr;
 94};
 95
 96/*
 97 * Driver-private storage for a single CAAM block instance
 98 */
 99struct caam_drv_private {
100	/* Physical-presence section */
101	struct caam_ctrl __iomem *ctrl; /* controller region */
102	struct caam_deco __iomem *deco; /* DECO/CCB views */
103	struct caam_assurance __iomem *assure;
104	struct caam_queue_if __iomem *qi; /* QI control region */
105	struct caam_job_ring __iomem *jr[4];	/* JobR's register space */
106
107	struct iommu_domain *domain;
 
 
 
 
 
 
 
 
 
108
109	/*
110	 * Detected geometry block. Filled in from device tree if powerpc,
111	 * or from register-based version detection code
112	 */
113	u8 total_jobrs;		/* Total Job Rings in device */
114	u8 qi_present;		/* Nonzero if QI present in device */
115	u8 blob_present;	/* Nonzero if BLOB support present in device */
116	u8 mc_en;		/* Nonzero if MC f/w is active */
117	u8 optee_en;		/* Nonzero if OP-TEE f/w is active */
118	bool pr_support;        /* RNG prediction resistance available */
119	int secvio_irq;		/* Security violation interrupt number */
120	int virt_en;		/* Virtualization enabled in CAAM */
121	int era;		/* CAAM Era (internal HW revision) */
122
123#define	RNG4_MAX_HANDLES 2
124	/* RNG4 block */
125	u32 rng4_sh_init;	/* This bitmap shows which of the State
126				   Handles of the RNG4 block are initialized
127				   by this driver */
 
128
129	struct clk_bulk_data *clks;
130	int num_clks;
131	/*
132	 * debugfs entries for developer view into driver/device
133	 * variables at runtime.
134	 */
135#ifdef CONFIG_DEBUG_FS
 
136	struct dentry *ctl; /* controller dir */
 
 
 
 
 
137	struct debugfs_blob_wrapper ctl_kek_wrap, ctl_tkek_wrap, ctl_tdsk_wrap;
 
138#endif
139
140	int caam_off_during_pm;		/* If the CAAM is reset after suspend */
141	struct caam_ctl_state state;	/* State of the CTL during PM */
142};
143
144#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_CRYPTO_API
145
146int caam_algapi_init(struct device *dev);
147void caam_algapi_exit(void);
148
149#else
150
151static inline int caam_algapi_init(struct device *dev)
152{
153	return 0;
154}
155
156static inline void caam_algapi_exit(void)
157{
158}
159
160#endif /* CONFIG_CRYPTO_DEV_FSL_CAAM_CRYPTO_API */
161
162#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_AHASH_API
163
164int caam_algapi_hash_init(struct device *dev);
165void caam_algapi_hash_exit(void);
166
167#else
168
169static inline int caam_algapi_hash_init(struct device *dev)
170{
171	return 0;
172}
173
174static inline void caam_algapi_hash_exit(void)
175{
176}
177
178#endif /* CONFIG_CRYPTO_DEV_FSL_CAAM_AHASH_API */
179
180#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_PKC_API
181
182int caam_pkc_init(struct device *dev);
183void caam_pkc_exit(void);
184
185#else
186
187static inline int caam_pkc_init(struct device *dev)
188{
189	return 0;
190}
191
192static inline void caam_pkc_exit(void)
193{
194}
195
196#endif /* CONFIG_CRYPTO_DEV_FSL_CAAM_PKC_API */
197
198#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_RNG_API
199
200int caam_rng_init(struct device *dev);
201void caam_rng_exit(struct device *dev);
202
203#else
204
205static inline int caam_rng_init(struct device *dev)
206{
207	return 0;
208}
209
210static inline void caam_rng_exit(struct device *dev) {}
211
212#endif /* CONFIG_CRYPTO_DEV_FSL_CAAM_RNG_API */
213
214#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_PRNG_API
215
216int caam_prng_register(struct device *dev);
217void caam_prng_unregister(void *data);
218
219#else
220
221static inline int caam_prng_register(struct device *dev)
222{
223	return 0;
224}
225
226static inline void caam_prng_unregister(void *data) {}
227#endif /* CONFIG_CRYPTO_DEV_FSL_CAAM_PRNG_API */
228
229#ifdef CONFIG_CAAM_QI
230
231int caam_qi_algapi_init(struct device *dev);
232void caam_qi_algapi_exit(void);
233
234#else
235
236static inline int caam_qi_algapi_init(struct device *dev)
237{
238	return 0;
239}
240
241static inline void caam_qi_algapi_exit(void)
242{
243}
244
245#endif /* CONFIG_CAAM_QI */
246
247static inline u64 caam_get_dma_mask(struct device *dev)
248{
249	struct device_node *nprop = dev->of_node;
250
251	if (caam_ptr_sz != sizeof(u64))
252		return DMA_BIT_MASK(32);
253
254	if (caam_dpaa2)
255		return DMA_BIT_MASK(49);
256
257	if (of_device_is_compatible(nprop, "fsl,sec-v5.0-job-ring") ||
258	    of_device_is_compatible(nprop, "fsl,sec-v5.0"))
259		return DMA_BIT_MASK(40);
260
261	return DMA_BIT_MASK(36);
262}
263
264
265#endif /* INTERN_H */
v3.1
 
  1/*
  2 * CAAM/SEC 4.x driver backend
  3 * Private/internal definitions between modules
  4 *
  5 * Copyright 2008-2011 Freescale Semiconductor, Inc.
  6 *
  7 */
  8
  9#ifndef INTERN_H
 10#define INTERN_H
 11
 12#define JOBR_UNASSIGNED 0
 13#define JOBR_ASSIGNED 1
 14
 15/* Currently comes from Kconfig param as a ^2 (driver-required) */
 16#define JOBR_DEPTH (1 << CONFIG_CRYPTO_DEV_FSL_CAAM_RINGSIZE)
 17
 
 
 
 
 
 
 
 
 18/* Kconfig params for interrupt coalescing if selected (else zero) */
 19#ifdef CONFIG_CRYPTO_DEV_FSL_CAAM_INTC
 20#define JOBR_INTC JRCFG_ICEN
 21#define JOBR_INTC_TIME_THLD CONFIG_CRYPTO_DEV_FSL_CAAM_INTC_TIME_THLD
 22#define JOBR_INTC_COUNT_THLD CONFIG_CRYPTO_DEV_FSL_CAAM_INTC_COUNT_THLD
 23#else
 24#define JOBR_INTC 0
 25#define JOBR_INTC_TIME_THLD 0
 26#define JOBR_INTC_COUNT_THLD 0
 27#endif
 28
 29/*
 30 * Storage for tracking each in-process entry moving across a ring
 31 * Each entry on an output ring needs one of these
 32 */
 33struct caam_jrentry_info {
 34	void (*callbk)(struct device *dev, u32 *desc, u32 status, void *arg);
 35	void *cbkarg;	/* Argument per ring entry */
 36	u32 *desc_addr_virt;	/* Stored virt addr for postprocessing */
 37	dma_addr_t desc_addr_dma;	/* Stored bus addr for done matching */
 38	u32 desc_size;	/* Stored size for postprocessing, header derived */
 39};
 40
 
 
 
 
 
 
 
 
 
 
 41/* Private sub-storage for a single JobR */
 42struct caam_drv_private_jr {
 43	struct device *parentdev;	/* points back to controller dev */
 
 44	int ridx;
 45	struct caam_job_ring __iomem *rregs;	/* JobR's register space */
 46	struct tasklet_struct irqtask[NR_CPUS];
 
 47	int irq;			/* One per queue */
 48	int assign;			/* busy/free */
 
 
 
 49
 50	/* Job ring info */
 51	int ringsize;	/* Size of rings (assume input = output) */
 52	struct caam_jrentry_info *entinfo;	/* Alloc'ed 1 per ring entry */
 53	spinlock_t inplock ____cacheline_aligned; /* Input ring index lock */
 54	int inp_ring_write_index;	/* Input index "tail" */
 55	int head;			/* entinfo (s/w ring) head index */
 56	dma_addr_t *inpring;	/* Base of input ring, alloc DMA-safe */
 57	spinlock_t outlock ____cacheline_aligned; /* Output ring index lock */
 58	int out_ring_read_index;	/* Output index "tail" */
 59	int tail;			/* entinfo (s/w ring) tail index */
 60	struct jr_outentry *outring;	/* Base of output ring, DMA-safe */
 
 
 
 
 
 
 
 
 
 
 61};
 62
 63/*
 64 * Driver-private storage for a single CAAM block instance
 65 */
 66struct caam_drv_private {
 
 
 
 
 
 
 67
 68	struct device *dev;
 69	struct device **jrdev; /* Alloc'ed array per sub-device */
 70	spinlock_t jr_alloc_lock;
 71	struct platform_device *pdev;
 72
 73	/* Physical-presence section */
 74	struct caam_ctrl *ctrl; /* controller region */
 75	struct caam_deco **deco; /* DECO/CCB views */
 76	struct caam_assurance *ac;
 77	struct caam_queue_if *qi; /* QI control region */
 78
 79	/*
 80	 * Detected geometry block. Filled in from device tree if powerpc,
 81	 * or from register-based version detection code
 82	 */
 83	u8 total_jobrs;		/* Total Job Rings in device */
 84	u8 qi_present;		/* Nonzero if QI present in device */
 
 
 
 
 85	int secvio_irq;		/* Security violation interrupt number */
 
 
 86
 87	/* which jr allocated to scatterlist crypto */
 88	atomic_t tfm_count ____cacheline_aligned;
 89	int num_jrs_for_algapi;
 90	struct device **algapi_jr;
 91	/* list of registered crypto algorithms (mk generic context handle?) */
 92	struct list_head alg_list;
 93
 
 
 94	/*
 95	 * debugfs entries for developer view into driver/device
 96	 * variables at runtime.
 97	 */
 98#ifdef CONFIG_DEBUG_FS
 99	struct dentry *dfs_root;
100	struct dentry *ctl; /* controller dir */
101	struct dentry *ctl_rq_dequeued, *ctl_ob_enc_req, *ctl_ib_dec_req;
102	struct dentry *ctl_ob_enc_bytes, *ctl_ob_prot_bytes;
103	struct dentry *ctl_ib_dec_bytes, *ctl_ib_valid_bytes;
104	struct dentry *ctl_faultaddr, *ctl_faultdetail, *ctl_faultstatus;
105
106	struct debugfs_blob_wrapper ctl_kek_wrap, ctl_tkek_wrap, ctl_tdsk_wrap;
107	struct dentry *ctl_kek, *ctl_tkek, *ctl_tdsk;
108#endif
 
 
 
109};
110
111void caam_jr_algapi_init(struct device *dev);
112void caam_jr_algapi_remove(struct device *dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
113#endif /* INTERN_H */