1 /*
2   This file is provided under a dual BSD/GPLv2 license.  When using or
3   redistributing this file, you may do so under either license.
4 
5   GPL LICENSE SUMMARY
6   Copyright(c) 2014 Intel Corporation.
7   This program is free software; you can redistribute it and/or modify
8   it under the terms of version 2 of the GNU General Public License as
9   published by the Free Software Foundation.
10 
11   This program is distributed in the hope that it will be useful, but
12   WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14   General Public License for more details.
15 
16   Contact Information:
17   qat-linux@intel.com
18 
19   BSD LICENSE
20   Copyright(c) 2014 Intel Corporation.
21   Redistribution and use in source and binary forms, with or without
22   modification, are permitted provided that the following conditions
23   are met:
24 
25     * Redistributions of source code must retain the above copyright
26       notice, this list of conditions and the following disclaimer.
27     * Redistributions in binary form must reproduce the above copyright
28       notice, this list of conditions and the following disclaimer in
29       the documentation and/or other materials provided with the
30       distribution.
31     * Neither the name of Intel Corporation nor the names of its
32       contributors may be used to endorse or promote products derived
33       from this software without specific prior written permission.
34 
35   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
36   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
37   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
38   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
39   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
42   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
43   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
44   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
45   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
46 */
47 #ifndef ADF_ACCEL_DEVICES_H_
48 #define ADF_ACCEL_DEVICES_H_
49 #include <linux/module.h>
50 #include <linux/list.h>
51 #include <linux/proc_fs.h>
52 #include <linux/io.h>
53 #include "adf_cfg_common.h"
54 
55 #define ADF_DH895XCC_DEVICE_NAME "dh895xcc"
56 #define ADF_DH895XCC_PCI_DEVICE_ID 0x435
57 #define ADF_PCI_MAX_BARS 3
58 #define ADF_DEVICE_NAME_LENGTH 32
59 #define ADF_ETR_MAX_RINGS_PER_BANK 16
60 #define ADF_MAX_MSIX_VECTOR_NAME 16
61 #define ADF_DEVICE_NAME_PREFIX "qat_"
62 
63 enum adf_accel_capabilities {
64 	ADF_ACCEL_CAPABILITIES_NULL = 0,
65 	ADF_ACCEL_CAPABILITIES_CRYPTO_SYMMETRIC = 1,
66 	ADF_ACCEL_CAPABILITIES_CRYPTO_ASYMMETRIC = 2,
67 	ADF_ACCEL_CAPABILITIES_CIPHER = 4,
68 	ADF_ACCEL_CAPABILITIES_AUTHENTICATION = 8,
69 	ADF_ACCEL_CAPABILITIES_COMPRESSION = 32,
70 	ADF_ACCEL_CAPABILITIES_LZS_COMPRESSION = 64,
71 	ADF_ACCEL_CAPABILITIES_RANDOM_NUMBER = 128
72 };
73 
74 struct adf_bar {
75 	resource_size_t base_addr;
76 	void __iomem *virt_addr;
77 	resource_size_t size;
78 } __packed;
79 
80 struct adf_accel_msix {
81 	struct msix_entry *entries;
82 	char **names;
83 } __packed;
84 
85 struct adf_accel_pci {
86 	struct pci_dev *pci_dev;
87 	struct adf_accel_msix msix_entries;
88 	struct adf_bar pci_bars[ADF_PCI_MAX_BARS];
89 	uint8_t revid;
90 	uint8_t sku;
91 } __packed;
92 
93 enum dev_state {
94 	DEV_DOWN = 0,
95 	DEV_UP
96 };
97 
98 enum dev_sku_info {
99 	DEV_SKU_1 = 0,
100 	DEV_SKU_2,
101 	DEV_SKU_3,
102 	DEV_SKU_4,
103 	DEV_SKU_UNKNOWN,
104 };
105 
get_sku_info(enum dev_sku_info info)106 static inline const char *get_sku_info(enum dev_sku_info info)
107 {
108 	switch (info) {
109 	case DEV_SKU_1:
110 		return "SKU1";
111 	case DEV_SKU_2:
112 		return "SKU2";
113 	case DEV_SKU_3:
114 		return "SKU3";
115 	case DEV_SKU_4:
116 		return "SKU4";
117 	case DEV_SKU_UNKNOWN:
118 	default:
119 		break;
120 	}
121 	return "Unknown SKU";
122 }
123 
124 struct adf_hw_device_class {
125 	const char *name;
126 	const enum adf_device_type type;
127 	uint32_t instances;
128 } __packed;
129 
130 struct adf_cfg_device_data;
131 struct adf_accel_dev;
132 struct adf_etr_data;
133 struct adf_etr_ring_data;
134 
135 struct adf_hw_device_data {
136 	struct adf_hw_device_class *dev_class;
137 	uint32_t (*get_accel_mask)(uint32_t fuse);
138 	uint32_t (*get_ae_mask)(uint32_t fuse);
139 	uint32_t (*get_misc_bar_id)(struct adf_hw_device_data *self);
140 	uint32_t (*get_etr_bar_id)(struct adf_hw_device_data *self);
141 	uint32_t (*get_num_aes)(struct adf_hw_device_data *self);
142 	uint32_t (*get_num_accels)(struct adf_hw_device_data *self);
143 	enum dev_sku_info (*get_sku)(struct adf_hw_device_data *self);
144 	void (*hw_arb_ring_enable)(struct adf_etr_ring_data *ring);
145 	void (*hw_arb_ring_disable)(struct adf_etr_ring_data *ring);
146 	int (*alloc_irq)(struct adf_accel_dev *accel_dev);
147 	void (*free_irq)(struct adf_accel_dev *accel_dev);
148 	void (*enable_error_correction)(struct adf_accel_dev *accel_dev);
149 	int (*init_admin_comms)(struct adf_accel_dev *accel_dev);
150 	void (*exit_admin_comms)(struct adf_accel_dev *accel_dev);
151 	int (*init_arb)(struct adf_accel_dev *accel_dev);
152 	void (*exit_arb)(struct adf_accel_dev *accel_dev);
153 	void (*enable_ints)(struct adf_accel_dev *accel_dev);
154 	const char *fw_name;
155 	uint32_t pci_dev_id;
156 	uint32_t fuses;
157 	uint32_t accel_capabilities_mask;
158 	uint16_t accel_mask;
159 	uint16_t ae_mask;
160 	uint16_t tx_rings_mask;
161 	uint8_t tx_rx_gap;
162 	uint8_t instance_id;
163 	uint8_t num_banks;
164 	uint8_t num_accel;
165 	uint8_t num_logical_accel;
166 	uint8_t num_engines;
167 } __packed;
168 
169 /* CSR write macro */
170 #define ADF_CSR_WR(csr_base, csr_offset, val) \
171 	__raw_writel(val, csr_base + csr_offset)
172 
173 /* CSR read macro */
174 #define ADF_CSR_RD(csr_base, csr_offset) __raw_readl(csr_base + csr_offset)
175 
176 #define GET_DEV(accel_dev) ((accel_dev)->accel_pci_dev.pci_dev->dev)
177 #define GET_BARS(accel_dev) ((accel_dev)->accel_pci_dev.pci_bars)
178 #define GET_HW_DATA(accel_dev) (accel_dev->hw_device)
179 #define GET_MAX_BANKS(accel_dev) (GET_HW_DATA(accel_dev)->num_banks)
180 #define GET_MAX_ACCELENGINES(accel_dev) (GET_HW_DATA(accel_dev)->num_engines)
181 #define accel_to_pci_dev(accel_ptr) accel_ptr->accel_pci_dev.pci_dev
182 
183 struct adf_admin_comms;
184 struct icp_qat_fw_loader_handle;
185 struct adf_fw_loader_data {
186 	struct icp_qat_fw_loader_handle *fw_loader;
187 	const struct firmware *uof_fw;
188 };
189 
190 struct adf_accel_dev {
191 	struct adf_etr_data *transport;
192 	struct adf_hw_device_data *hw_device;
193 	struct adf_cfg_device_data *cfg;
194 	struct adf_fw_loader_data *fw_loader;
195 	struct adf_admin_comms *admin;
196 	struct list_head crypto_list;
197 	unsigned long status;
198 	atomic_t ref_count;
199 	struct dentry *debugfs_dir;
200 	struct list_head list;
201 	struct module *owner;
202 	struct adf_accel_pci accel_pci_dev;
203 	uint8_t accel_id;
204 } __packed;
205 #endif
206