Loading...
1/*
2 * linux/drivers/char/hpilo.h
3 *
4 * Copyright (C) 2008 Hewlett-Packard Development Company, L.P.
5 * David Altobelli <david.altobelli@hp.com>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
10 */
11#ifndef __HPILO_H
12#define __HPILO_H
13
14#define ILO_NAME "hpilo"
15
16/* max number of open channel control blocks per device, hw limited to 32 */
17#define MAX_CCB 24
18/* min number of open channel control blocks per device, hw limited to 32 */
19#define MIN_CCB 8
20/* max number of supported devices */
21#define MAX_ILO_DEV 1
22/* max number of files */
23#define MAX_OPEN (MAX_CCB * MAX_ILO_DEV)
24/* total wait time in usec */
25#define MAX_WAIT_TIME 10000
26/* per spin wait time in usec */
27#define WAIT_TIME 10
28/* spin counter for open/close delay */
29#define MAX_WAIT (MAX_WAIT_TIME / WAIT_TIME)
30
31/*
32 * Per device, used to track global memory allocations.
33 */
34struct ilo_hwinfo {
35 /* mmio registers on device */
36 char __iomem *mmio_vaddr;
37
38 /* doorbell registers on device */
39 char __iomem *db_vaddr;
40
41 /* shared memory on device used for channel control blocks */
42 char __iomem *ram_vaddr;
43
44 /* files corresponding to this device */
45 struct ccb_data *ccb_alloc[MAX_CCB];
46
47 struct pci_dev *ilo_dev;
48
49 /*
50 * open_lock serializes ccb_cnt during open and close
51 * [ irq disabled ]
52 * -> alloc_lock used when adding/removing/searching ccb_alloc,
53 * which represents all ccbs open on the device
54 * --> fifo_lock controls access to fifo queues shared with hw
55 *
56 * Locks must be taken in this order, but open_lock and alloc_lock
57 * are optional, they do not need to be held in order to take a
58 * lower level lock.
59 */
60 spinlock_t open_lock;
61 spinlock_t alloc_lock;
62 spinlock_t fifo_lock;
63
64 struct cdev cdev;
65};
66
67/* offset from mmio_vaddr for enabling doorbell interrupts */
68#define DB_IRQ 0xB2
69/* offset from mmio_vaddr for outbound communications */
70#define DB_OUT 0xD4
71/* DB_OUT reset bit */
72#define DB_RESET 26
73
74/*
75 * Channel control block. Used to manage hardware queues.
76 * The format must match hw's version. The hw ccb is 128 bytes,
77 * but the context area shouldn't be touched by the driver.
78 */
79#define ILOSW_CCB_SZ 64
80#define ILOHW_CCB_SZ 128
81struct ccb {
82 union {
83 char *send_fifobar;
84 u64 send_fifobar_pa;
85 } ccb_u1;
86 union {
87 char *send_desc;
88 u64 send_desc_pa;
89 } ccb_u2;
90 u64 send_ctrl;
91
92 union {
93 char *recv_fifobar;
94 u64 recv_fifobar_pa;
95 } ccb_u3;
96 union {
97 char *recv_desc;
98 u64 recv_desc_pa;
99 } ccb_u4;
100 u64 recv_ctrl;
101
102 union {
103 char __iomem *db_base;
104 u64 padding5;
105 } ccb_u5;
106
107 u64 channel;
108
109 /* unused context area (64 bytes) */
110};
111
112/* ccb queue parameters */
113#define SENDQ 1
114#define RECVQ 2
115#define NR_QENTRY 4
116#define L2_QENTRY_SZ 12
117
118/* ccb ctrl bitfields */
119#define CTRL_BITPOS_L2SZ 0
120#define CTRL_BITPOS_FIFOINDEXMASK 4
121#define CTRL_BITPOS_DESCLIMIT 18
122#define CTRL_BITPOS_A 30
123#define CTRL_BITPOS_G 31
124
125/* ccb doorbell macros */
126#define L2_DB_SIZE 14
127#define ONE_DB_SIZE (1 << L2_DB_SIZE)
128
129/*
130 * Per fd structure used to track the ccb allocated to that dev file.
131 */
132struct ccb_data {
133 /* software version of ccb, using virtual addrs */
134 struct ccb driver_ccb;
135
136 /* hardware version of ccb, using physical addrs */
137 struct ccb ilo_ccb;
138
139 /* hardware ccb is written to this shared mapped device memory */
140 struct ccb __iomem *mapped_ccb;
141
142 /* dma'able memory used for send/recv queues */
143 void *dma_va;
144 dma_addr_t dma_pa;
145 size_t dma_size;
146
147 /* pointer to hardware device info */
148 struct ilo_hwinfo *ilo_hw;
149
150 /* queue for this ccb to wait for recv data */
151 wait_queue_head_t ccb_waitq;
152
153 /* usage count, to allow for shared ccb's */
154 int ccb_cnt;
155
156 /* open wanted exclusive access to this ccb */
157 int ccb_excl;
158};
159
160/*
161 * FIFO queue structure, shared with hw.
162 */
163#define ILO_START_ALIGN 4096
164#define ILO_CACHE_SZ 128
165struct fifo {
166 u64 nrents; /* user requested number of fifo entries */
167 u64 imask; /* mask to extract valid fifo index */
168 u64 merge; /* O/C bits to merge in during enqueue operation */
169 u64 reset; /* set to non-zero when the target device resets */
170 u8 pad_0[ILO_CACHE_SZ - (sizeof(u64) * 4)];
171
172 u64 head;
173 u8 pad_1[ILO_CACHE_SZ - (sizeof(u64))];
174
175 u64 tail;
176 u8 pad_2[ILO_CACHE_SZ - (sizeof(u64))];
177
178 u64 fifobar[1];
179};
180
181/* convert between struct fifo, and the fifobar, which is saved in the ccb */
182#define FIFOHANDLESIZE (sizeof(struct fifo) - sizeof(u64))
183#define FIFOBARTOHANDLE(_fifo) \
184 ((struct fifo *)(((char *)(_fifo)) - FIFOHANDLESIZE))
185
186/* the number of qwords to consume from the entry descriptor */
187#define ENTRY_BITPOS_QWORDS 0
188/* descriptor index number (within a specified queue) */
189#define ENTRY_BITPOS_DESCRIPTOR 10
190/* state bit, fifo entry consumed by consumer */
191#define ENTRY_BITPOS_C 22
192/* state bit, fifo entry is occupied */
193#define ENTRY_BITPOS_O 23
194
195#define ENTRY_BITS_QWORDS 10
196#define ENTRY_BITS_DESCRIPTOR 12
197#define ENTRY_BITS_C 1
198#define ENTRY_BITS_O 1
199#define ENTRY_BITS_TOTAL \
200 (ENTRY_BITS_C + ENTRY_BITS_O + \
201 ENTRY_BITS_QWORDS + ENTRY_BITS_DESCRIPTOR)
202
203/* extract various entry fields */
204#define ENTRY_MASK ((1 << ENTRY_BITS_TOTAL) - 1)
205#define ENTRY_MASK_C (((1 << ENTRY_BITS_C) - 1) << ENTRY_BITPOS_C)
206#define ENTRY_MASK_O (((1 << ENTRY_BITS_O) - 1) << ENTRY_BITPOS_O)
207#define ENTRY_MASK_QWORDS \
208 (((1 << ENTRY_BITS_QWORDS) - 1) << ENTRY_BITPOS_QWORDS)
209#define ENTRY_MASK_DESCRIPTOR \
210 (((1 << ENTRY_BITS_DESCRIPTOR) - 1) << ENTRY_BITPOS_DESCRIPTOR)
211
212#define ENTRY_MASK_NOSTATE (ENTRY_MASK >> (ENTRY_BITS_C + ENTRY_BITS_O))
213
214#endif /* __HPILO_H */
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * linux/drivers/char/hpilo.h
4 *
5 * Copyright (C) 2008 Hewlett-Packard Development Company, L.P.
6 * David Altobelli <david.altobelli@hp.com>
7 */
8#ifndef __HPILO_H
9#define __HPILO_H
10
11#define ILO_NAME "hpilo"
12
13/* max number of open channel control blocks per device, hw limited to 32 */
14#define MAX_CCB 24
15/* min number of open channel control blocks per device, hw limited to 32 */
16#define MIN_CCB 8
17/* max number of supported devices */
18#define MAX_ILO_DEV 1
19/* max number of files */
20#define MAX_OPEN (MAX_CCB * MAX_ILO_DEV)
21/* total wait time in usec */
22#define MAX_WAIT_TIME 10000
23/* per spin wait time in usec */
24#define WAIT_TIME 10
25/* spin counter for open/close delay */
26#define MAX_WAIT (MAX_WAIT_TIME / WAIT_TIME)
27
28/*
29 * Per device, used to track global memory allocations.
30 */
31struct ilo_hwinfo {
32 /* mmio registers on device */
33 char __iomem *mmio_vaddr;
34
35 /* doorbell registers on device */
36 char __iomem *db_vaddr;
37
38 /* shared memory on device used for channel control blocks */
39 char __iomem *ram_vaddr;
40
41 /* files corresponding to this device */
42 struct ccb_data *ccb_alloc[MAX_CCB];
43
44 struct pci_dev *ilo_dev;
45
46 /*
47 * open_lock serializes ccb_cnt during open and close
48 * [ irq disabled ]
49 * -> alloc_lock used when adding/removing/searching ccb_alloc,
50 * which represents all ccbs open on the device
51 * --> fifo_lock controls access to fifo queues shared with hw
52 *
53 * Locks must be taken in this order, but open_lock and alloc_lock
54 * are optional, they do not need to be held in order to take a
55 * lower level lock.
56 */
57 spinlock_t open_lock;
58 spinlock_t alloc_lock;
59 spinlock_t fifo_lock;
60
61 struct cdev cdev;
62};
63
64/* offset from mmio_vaddr for enabling doorbell interrupts */
65#define DB_IRQ 0xB2
66/* offset from mmio_vaddr for outbound communications */
67#define DB_OUT 0xD4
68/* DB_OUT reset bit */
69#define DB_RESET 26
70
71/*
72 * Channel control block. Used to manage hardware queues.
73 * The format must match hw's version. The hw ccb is 128 bytes,
74 * but the context area shouldn't be touched by the driver.
75 */
76#define ILOSW_CCB_SZ 64
77#define ILOHW_CCB_SZ 128
78struct ccb {
79 union {
80 char *send_fifobar;
81 u64 send_fifobar_pa;
82 } ccb_u1;
83 union {
84 char *send_desc;
85 u64 send_desc_pa;
86 } ccb_u2;
87 u64 send_ctrl;
88
89 union {
90 char *recv_fifobar;
91 u64 recv_fifobar_pa;
92 } ccb_u3;
93 union {
94 char *recv_desc;
95 u64 recv_desc_pa;
96 } ccb_u4;
97 u64 recv_ctrl;
98
99 union {
100 char __iomem *db_base;
101 u64 padding5;
102 } ccb_u5;
103
104 u64 channel;
105
106 /* unused context area (64 bytes) */
107};
108
109/* ccb queue parameters */
110#define SENDQ 1
111#define RECVQ 2
112#define NR_QENTRY 4
113#define L2_QENTRY_SZ 12
114
115/* ccb ctrl bitfields */
116#define CTRL_BITPOS_L2SZ 0
117#define CTRL_BITPOS_FIFOINDEXMASK 4
118#define CTRL_BITPOS_DESCLIMIT 18
119#define CTRL_BITPOS_A 30
120#define CTRL_BITPOS_G 31
121
122/* ccb doorbell macros */
123#define L2_DB_SIZE 14
124#define ONE_DB_SIZE (1 << L2_DB_SIZE)
125
126/*
127 * Per fd structure used to track the ccb allocated to that dev file.
128 */
129struct ccb_data {
130 /* software version of ccb, using virtual addrs */
131 struct ccb driver_ccb;
132
133 /* hardware version of ccb, using physical addrs */
134 struct ccb ilo_ccb;
135
136 /* hardware ccb is written to this shared mapped device memory */
137 struct ccb __iomem *mapped_ccb;
138
139 /* dma'able memory used for send/recv queues */
140 void *dma_va;
141 dma_addr_t dma_pa;
142 size_t dma_size;
143
144 /* pointer to hardware device info */
145 struct ilo_hwinfo *ilo_hw;
146
147 /* queue for this ccb to wait for recv data */
148 wait_queue_head_t ccb_waitq;
149
150 /* usage count, to allow for shared ccb's */
151 int ccb_cnt;
152
153 /* open wanted exclusive access to this ccb */
154 int ccb_excl;
155};
156
157/*
158 * FIFO queue structure, shared with hw.
159 */
160#define ILO_START_ALIGN 4096
161#define ILO_CACHE_SZ 128
162struct fifo {
163 u64 nrents; /* user requested number of fifo entries */
164 u64 imask; /* mask to extract valid fifo index */
165 u64 merge; /* O/C bits to merge in during enqueue operation */
166 u64 reset; /* set to non-zero when the target device resets */
167 u8 pad_0[ILO_CACHE_SZ - (sizeof(u64) * 4)];
168
169 u64 head;
170 u8 pad_1[ILO_CACHE_SZ - (sizeof(u64))];
171
172 u64 tail;
173 u8 pad_2[ILO_CACHE_SZ - (sizeof(u64))];
174
175 u64 fifobar[1];
176};
177
178/* convert between struct fifo, and the fifobar, which is saved in the ccb */
179#define FIFOHANDLESIZE (sizeof(struct fifo) - sizeof(u64))
180#define FIFOBARTOHANDLE(_fifo) \
181 ((struct fifo *)(((char *)(_fifo)) - FIFOHANDLESIZE))
182
183/* the number of qwords to consume from the entry descriptor */
184#define ENTRY_BITPOS_QWORDS 0
185/* descriptor index number (within a specified queue) */
186#define ENTRY_BITPOS_DESCRIPTOR 10
187/* state bit, fifo entry consumed by consumer */
188#define ENTRY_BITPOS_C 22
189/* state bit, fifo entry is occupied */
190#define ENTRY_BITPOS_O 23
191
192#define ENTRY_BITS_QWORDS 10
193#define ENTRY_BITS_DESCRIPTOR 12
194#define ENTRY_BITS_C 1
195#define ENTRY_BITS_O 1
196#define ENTRY_BITS_TOTAL \
197 (ENTRY_BITS_C + ENTRY_BITS_O + \
198 ENTRY_BITS_QWORDS + ENTRY_BITS_DESCRIPTOR)
199
200/* extract various entry fields */
201#define ENTRY_MASK ((1 << ENTRY_BITS_TOTAL) - 1)
202#define ENTRY_MASK_C (((1 << ENTRY_BITS_C) - 1) << ENTRY_BITPOS_C)
203#define ENTRY_MASK_O (((1 << ENTRY_BITS_O) - 1) << ENTRY_BITPOS_O)
204#define ENTRY_MASK_QWORDS \
205 (((1 << ENTRY_BITS_QWORDS) - 1) << ENTRY_BITPOS_QWORDS)
206#define ENTRY_MASK_DESCRIPTOR \
207 (((1 << ENTRY_BITS_DESCRIPTOR) - 1) << ENTRY_BITPOS_DESCRIPTOR)
208
209#define ENTRY_MASK_NOSTATE (ENTRY_MASK >> (ENTRY_BITS_C + ENTRY_BITS_O))
210
211#endif /* __HPILO_H */