1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
|
/***********************license start***************
* Copyright (c) 2003-2010 Cavium Inc. (support@cavium.com). All rights
* reserved.
*
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
* * Neither the name of Cavium Inc. nor the names of
* its contributors may be used to endorse or promote products
* derived from this software without specific prior written
* permission.
* This Software, including technical data, may be subject to U.S. export control
* laws, including the U.S. Export Administration Act and its associated
* regulations, and may be subject to export or import regulations in other
* countries.
* TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE SOFTWARE IS PROVIDED "AS IS"
* AND WITH ALL FAULTS AND CAVIUM INC. MAKES NO PROMISES, REPRESENTATIONS OR
* WARRANTIES, EITHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, WITH RESPECT TO
* THE SOFTWARE, INCLUDING ITS CONDITION, ITS CONFORMITY TO ANY REPRESENTATION OR
* DESCRIPTION, OR THE EXISTENCE OF ANY LATENT OR PATENT DEFECTS, AND CAVIUM
* SPECIFICALLY DISCLAIMS ALL IMPLIED (IF ANY) WARRANTIES OF TITLE,
* MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR A PARTICULAR PURPOSE, LACK OF
* VIRUSES, ACCURACY OR COMPLETENESS, QUIET ENJOYMENT, QUIET POSSESSION OR
* CORRESPONDENCE TO DESCRIPTION. THE ENTIRE RISK ARISING OUT OF USE OR
* PERFORMANCE OF THE SOFTWARE LIES WITH YOU.
***********************license end**************************************/
/**
* @file
*
* Header file for the zip (deflate) block
*
* <hr>$Revision: 70030 $<hr>
*/
#ifndef __CVMX_ZIP_H__
#define __CVMX_ZIP_H__
#ifdef __cplusplus
extern "C" {
#endif
typedef union {
uint64_t u64;
struct {
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t unused : 5;
uint64_t full_block_write : 1;
uint64_t no_l2_alloc : 1;
uint64_t little_endian : 1;
uint64_t length : 16;
uint64_t ptr : 40;
#else
uint64_t ptr : 40;
uint64_t length : 16;
uint64_t little_endian : 1;
uint64_t no_l2_alloc : 1;
uint64_t full_block_write : 1;
uint64_t unused : 5;
#endif
} s;
} cvmx_zip_ptr_t;
#define CVMX_ZIP_PTR_MAX_LEN ((1 << 16) - 1)
typedef enum {
CVMX_ZIP_COMPLETION_NOTDONE = 0,
CVMX_ZIP_COMPLETION_SUCCESS = 1,
CVMX_ZIP_COMPLETION_OTRUNC = 2,
CVMX_ZIP_COMPLETION_STOP = 3,
CVMX_ZIP_COMPLETION_ITRUNC = 4,
CVMX_ZIP_COMPLETION_RBLOCK = 5,
CVMX_ZIP_COMPLETION_NLEN = 6,
CVMX_ZIP_COMPLETION_BADCODE = 7,
CVMX_ZIP_COMPLETION_BADCODE2 = 8,
CVMX_ZIP_COMPLETION_ZERO_LEN = 9,
CVMX_ZIP_COMPLETION_PARITY = 10,
CVMX_ZIP_COMPLETION_FATAL = 11
} cvmx_zip_completion_code_t;
typedef union {
uint64_t u64[3];
struct {
// WORD 0
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t crc32 : 32;
uint64_t adler : 32;
#else
uint64_t adler : 32;
uint64_t crc32 : 32;
#endif
// WORD 1
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t totalbyteswritten : 32;
uint64_t totalbytesread : 32;
#else
uint64_t totalbytesread : 32;
uint64_t totalbyteswritten : 32;
#endif
// WORD 2
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t totalbitsprocessed : 32; // decompression only
uint64_t unused20 : 5;
uint64_t exnum : 3; // compression only
uint64_t unused21 : 1;
uint64_t exbits : 7; // compression only
uint64_t unused22 : 7;
uint64_t eof : 1; // decompression only
cvmx_zip_completion_code_t completioncode : 8; // If polling, SW should set this to zero and wait for non-zero
#else
cvmx_zip_completion_code_t completioncode : 8; // If polling, SW should set this to zero and wait for non-zero
uint64_t eof : 1; // decompression only
uint64_t unused22 : 7;
uint64_t exbits : 7; // compression only
uint64_t unused21 : 1;
uint64_t exnum : 3; // compression only
uint64_t unused20 : 5;
uint64_t totalbitsprocessed : 32; // decompression only
#endif
} s;
} cvmx_zip_result_t;
typedef union {
uint64_t u64[8];
struct {
// WORD 0
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t unused00 : 8;
uint64_t totaloutputlength : 24;
uint64_t unused01 : 5;
uint64_t exnum : 3;
uint64_t unused02 : 1;
uint64_t exbits : 7;
uint64_t unused03 : 4;
uint64_t flush : 1;
uint64_t speed : 2;
uint64_t forcefixed : 1;
uint64_t forcedynamic : 1;
uint64_t eof : 1;
uint64_t bof : 1;
uint64_t compress : 1;
uint64_t unused04 : 1;
uint64_t dscatter : 1;
uint64_t dgather : 1;
uint64_t hgather : 1;
#else
uint64_t hgather : 1;
uint64_t dgather : 1;
uint64_t dscatter : 1;
uint64_t unused04 : 1;
uint64_t compress : 1;
uint64_t bof : 1;
uint64_t eof : 1;
uint64_t forcedynamic : 1;
uint64_t forcefixed : 1;
uint64_t speed : 2;
uint64_t flush : 1;
uint64_t unused03 : 4;
uint64_t exbits : 7;
uint64_t unused02 : 1;
uint64_t exnum : 3;
uint64_t unused01 : 5;
uint64_t totaloutputlength : 24;
uint64_t unused00 : 8;
#endif
// WORD 1
#ifdef __BIG_ENDIAN_BITFIELD
uint64_t historylength : 16;
uint64_t unused10 : 16;
uint64_t adler32 : 32;
#else
uint64_t adler32 : 32;
uint64_t unused10 : 16;
uint64_t historylength : 16;
#endif
// WORD 2
cvmx_zip_ptr_t ctx_ptr;
// WORD 3
cvmx_zip_ptr_t hist_ptr;
// WORD 4
cvmx_zip_ptr_t in_ptr;
// WORD 5
cvmx_zip_ptr_t out_ptr;
// WORD 6
cvmx_zip_ptr_t result_ptr;
// WORD 7
cvmx_zip_ptr_t wq_ptr;
} s;
} cvmx_zip_command_t;
/**
* Initialize the ZIP block
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_initialize(void);
/**
* Initialize the ZIP QUEUE buffer
*
* @param queue : ZIP instruction queue
* @param zcoremask : ZIP coremask to use for this queue
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_queue_initialize(int queue, int zcoremask);
/**
* Shutdown the ZIP block. ZIP must be idle when
* this function is called.
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_shutdown(void);
/**
* Shutdown the ZIP block for a queue. ZIP must be idle when
* this function is called.
*
* @param queue Zip instruction queue of the command
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_queue_shutdown(int queue);
/**
* Submit a command to the ZIP block
*
* @param command Zip command to submit
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_submit(cvmx_zip_command_t *command);
/**
* Submit a command to the ZIP block
*
* @param command Zip command to submit
* @param queue Zip instruction queue of the command
*
* @return Zero on success, negative on failure
*/
int cvmx_zip_queue_submit(cvmx_zip_command_t *command, int queue);
/* CSR typedefs have been moved to cvmx-zip-defs.h */
#ifdef __cplusplus
}
#endif
#endif /* __CVMX_ZIP_H__ */
|
