1 /* SPDX-License-Identifier: GPL-2.0-only */
4  * Copyright 2005-2006 Fen Systems Ltd.
5  * Copyright 2006-2013 Solarflare Communications Inc.
15  * wide.  Since there is no native 128-bit datatype on most systems,
16  * and since 64-bit datatypes are inefficient on 32-bit systems and
20  * The NICs are PCI devices and therefore little-endian.  Since most
23  * efx_dword_t) to be little-endian.
46 /* Low bit number of the specified field */
51 #define EFX_HIGH_BIT(field) (EFX_LOW_BIT(field) + EFX_WIDTH(field) - 1)
60 	 (((((u64) 1) << (width))) - 1))
71 	 (((((u32) 1) << (width))) - 1))
73 /* A doubleword (i.e. 4 byte) datatype - little-endian in HW */
78 /* A quadword (i.e. 8 byte) datatype - little-endian in HW */
85 /* An octword (eight-word, i.e. 16 byte) datatype - little-endian in HW */
109  * Extract bit field portion [low,high) from the native-endian element
113  * 64-bit value, and we wish to extract the bits belonging to the bit
114  * field occupying bits 28-45 of this 64-bit value.
121  * [0,high-low), with garbage in bits [high-low+1,...).
123 #define EFX_EXTRACT_NATIVE(native_element, min, max, low, high)		\  argument
124 	((low) > (max) || (high) < (min) ? 0 :				\
125 	 (low) > (min) ?						\
126 	 (native_element) >> ((low) - (min)) :				\
127 	 (native_element) << ((min) - (low)))
130  * Extract bit field portion [low,high) from the 64-bit little-endian
133 #define EFX_EXTRACT64(element, min, max, low, high)			\  argument
134 	EFX_EXTRACT_NATIVE(le64_to_cpu(element), min, max, low, high)
137  * Extract bit field portion [low,high) from the 32-bit little-endian
140 #define EFX_EXTRACT32(element, min, max, low, high)			\  argument
141 	EFX_EXTRACT_NATIVE(le32_to_cpu(element), min, max, low, high)
143 #define EFX_EXTRACT_OWORD64(oword, low, high)				\  argument
144 	((EFX_EXTRACT64((oword).u64[0], 0, 63, low, high) |		\
145 	  EFX_EXTRACT64((oword).u64[1], 64, 127, low, high)) &		\
146 	 EFX_MASK64((high) + 1 - (low)))
148 #define EFX_EXTRACT_QWORD64(qword, low, high)				\  argument
149 	(EFX_EXTRACT64((qword).u64[0], 0, 63, low, high) &		\
150 	 EFX_MASK64((high) + 1 - (low)))
152 #define EFX_EXTRACT_OWORD32(oword, low, high)				\  argument
153 	((EFX_EXTRACT32((oword).u32[0], 0, 31, low, high) |		\
154 	  EFX_EXTRACT32((oword).u32[1], 32, 63, low, high) |		\
155 	  EFX_EXTRACT32((oword).u32[2], 64, 95, low, high) |		\
156 	  EFX_EXTRACT32((oword).u32[3], 96, 127, low, high)) &		\
157 	 EFX_MASK32((high) + 1 - (low)))
159 #define EFX_EXTRACT_QWORD32(qword, low, high)				\  argument
160 	((EFX_EXTRACT32((qword).u32[0], 0, 31, low, high) |		\
161 	  EFX_EXTRACT32((qword).u32[1], 32, 63, low, high)) &		\
162 	 EFX_MASK32((high) + 1 - (low)))
164 #define EFX_EXTRACT_DWORD(dword, low, high)			\  argument
165 	(EFX_EXTRACT32((dword).u32[0], 0, 31, low, high) &	\
166 	 EFX_MASK32((high) + 1 - (low)))
239  * Creates the portion of the bit field [low,high) that lies within
242 #define EFX_INSERT_NATIVE64(min, max, low, high, value)		\  argument
243 	(((low > max) || (high < min)) ? 0 :			\
244 	 ((low > min) ?						\
245 	  (((u64) (value)) << (low - min)) :		\
246 	  (((u64) (value)) >> (min - low))))
248 #define EFX_INSERT_NATIVE32(min, max, low, high, value)		\  argument
249 	(((low > max) || (high < min)) ? 0 :			\
250 	 ((low > min) ?						\
251 	  (((u32) (value)) << (low - min)) :		\
252 	  (((u32) (value)) >> (min - low))))
254 #define EFX_INSERT_NATIVE(min, max, low, high, value)		\  argument
255 	((((max - min) >= 32) || ((high - low) >= 32)) ?	\
256 	 EFX_INSERT_NATIVE64(min, max, low, high, value) :	\
257 	 EFX_INSERT_NATIVE32(min, max, low, high, value))
490  * Modify a named field within an already-populated structure.  Used
491  * for read-modify-write operations.
514 #define EFX_INSERT64(min, max, low, high, value)			\  argument
515 	cpu_to_le64(EFX_INSERT_NATIVE(min, max, low, high, value))
517 #define EFX_INSERT32(min, max, low, high, value)			\  argument
518 	cpu_to_le32(EFX_INSERT_NATIVE(min, max, low, high, value))
520 #define EFX_INPLACE_MASK64(min, max, low, high)				\  argument
521 	EFX_INSERT64(min, max, low, high, EFX_MASK64((high) + 1 - (low)))
523 #define EFX_INPLACE_MASK32(min, max, low, high)				\  argument
524 	EFX_INSERT32(min, max, low, high, EFX_MASK32((high) + 1 - (low)))
526 #define EFX_SET_OWORD64(oword, low, high, value) do {			\  argument
528 			   & ~EFX_INPLACE_MASK64(0,  63, low, high))	\
529 			  | EFX_INSERT64(0,  63, low, high, value));	\
531 			   & ~EFX_INPLACE_MASK64(64, 127, low, high))	\
532 			  | EFX_INSERT64(64, 127, low, high, value));	\
535 #define EFX_SET_QWORD64(qword, low, high, value) do {			\  argument
537 			   & ~EFX_INPLACE_MASK64(0, 63, low, high))	\
538 			  | EFX_INSERT64(0, 63, low, high, value));	\
541 #define EFX_SET_OWORD32(oword, low, high, value) do {			\  argument
543 			   & ~EFX_INPLACE_MASK32(0, 31, low, high))	\
544 			  | EFX_INSERT32(0, 31, low, high, value));	\
546 			   & ~EFX_INPLACE_MASK32(32, 63, low, high))	\
547 			  | EFX_INSERT32(32, 63, low, high, value));	\
549 			   & ~EFX_INPLACE_MASK32(64, 95, low, high))	\
550 			  | EFX_INSERT32(64, 95, low, high, value));	\
552 			   & ~EFX_INPLACE_MASK32(96, 127, low, high))	\
553 			  | EFX_INSERT32(96, 127, low, high, value));	\
556 #define EFX_SET_QWORD32(qword, low, high, value) do {			\  argument
558 			   & ~EFX_INPLACE_MASK32(0, 31, low, high))	\
559 			  | EFX_INSERT32(0, 31, low, high, value));	\
561 			   & ~EFX_INPLACE_MASK32(32, 63, low, high))	\
562 			  | EFX_INSERT32(32, 63, low, high, value));	\
565 #define EFX_SET_DWORD32(dword, low, high, value) do {			\  argument
567 			   & ~EFX_INPLACE_MASK32(0, 31, low, high))	\
568 			  | EFX_INSERT32(0, 31, low, high, value));	\