hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
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
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
/* SPDX-License-Identifier: GPL-2.0 */
/*
 * NAND Flash Controller Device Driver
 * Copyright (c) 2009 - 2010, Intel Corporation and its suppliers.
 */
 
#ifndef __DENALI_H__
#define __DENALI_H__
 
#include <linux/bits.h>
#include <linux/completion.h>
#include <linux/list.h>
#include <linux/mtd/rawnand.h>
#include <linux/spinlock_types.h>
#include <linux/types.h>
 
#define DEVICE_RESET                0x0
#define     DEVICE_RESET__BANK(bank)            BIT(bank)
 
#define TRANSFER_SPARE_REG            0x10
#define     TRANSFER_SPARE_REG__FLAG            BIT(0)
 
#define LOAD_WAIT_CNT                0x20
#define     LOAD_WAIT_CNT__VALUE            GENMASK(15, 0)
 
#define PROGRAM_WAIT_CNT            0x30
#define     PROGRAM_WAIT_CNT__VALUE            GENMASK(15, 0)
 
#define ERASE_WAIT_CNT                0x40
#define     ERASE_WAIT_CNT__VALUE            GENMASK(15, 0)
 
#define INT_MON_CYCCNT                0x50
#define     INT_MON_CYCCNT__VALUE            GENMASK(15, 0)
 
#define RB_PIN_ENABLED                0x60
#define     RB_PIN_ENABLED__BANK(bank)            BIT(bank)
 
#define MULTIPLANE_OPERATION            0x70
#define     MULTIPLANE_OPERATION__FLAG            BIT(0)
 
#define MULTIPLANE_READ_ENABLE            0x80
#define     MULTIPLANE_READ_ENABLE__FLAG        BIT(0)
 
#define COPYBACK_DISABLE            0x90
#define     COPYBACK_DISABLE__FLAG            BIT(0)
 
#define CACHE_WRITE_ENABLE            0xa0
#define     CACHE_WRITE_ENABLE__FLAG            BIT(0)
 
#define CACHE_READ_ENABLE            0xb0
#define     CACHE_READ_ENABLE__FLAG            BIT(0)
 
#define PREFETCH_MODE                0xc0
#define     PREFETCH_MODE__PREFETCH_EN            BIT(0)
#define     PREFETCH_MODE__PREFETCH_BURST_LENGTH    GENMASK(15, 4)
 
#define CHIP_ENABLE_DONT_CARE            0xd0
#define     CHIP_EN_DONT_CARE__FLAG            BIT(0)
 
#define ECC_ENABLE                0xe0
#define     ECC_ENABLE__FLAG                BIT(0)
 
#define GLOBAL_INT_ENABLE            0xf0
#define     GLOBAL_INT_EN_FLAG                BIT(0)
 
#define TWHR2_AND_WE_2_RE            0x100
#define     TWHR2_AND_WE_2_RE__WE_2_RE            GENMASK(5, 0)
#define     TWHR2_AND_WE_2_RE__TWHR2            GENMASK(13, 8)
 
#define TCWAW_AND_ADDR_2_DATA            0x110
/* The width of ADDR_2_DATA is 6 bit for old IP, 7 bit for new IP */
#define     TCWAW_AND_ADDR_2_DATA__ADDR_2_DATA        GENMASK(6, 0)
#define     TCWAW_AND_ADDR_2_DATA__TCWAW        GENMASK(13, 8)
 
#define RE_2_WE                    0x120
#define     RE_2_WE__VALUE                GENMASK(5, 0)
 
#define ACC_CLKS                0x130
#define     ACC_CLKS__VALUE                GENMASK(3, 0)
 
#define NUMBER_OF_PLANES            0x140
#define     NUMBER_OF_PLANES__VALUE            GENMASK(2, 0)
 
#define PAGES_PER_BLOCK                0x150
#define     PAGES_PER_BLOCK__VALUE            GENMASK(15, 0)
 
#define DEVICE_WIDTH                0x160
#define     DEVICE_WIDTH__VALUE                GENMASK(1, 0)
 
#define DEVICE_MAIN_AREA_SIZE            0x170
#define     DEVICE_MAIN_AREA_SIZE__VALUE        GENMASK(15, 0)
 
#define DEVICE_SPARE_AREA_SIZE            0x180
#define     DEVICE_SPARE_AREA_SIZE__VALUE        GENMASK(15, 0)
 
#define TWO_ROW_ADDR_CYCLES            0x190
#define     TWO_ROW_ADDR_CYCLES__FLAG            BIT(0)
 
#define MULTIPLANE_ADDR_RESTRICT        0x1a0
#define     MULTIPLANE_ADDR_RESTRICT__FLAG        BIT(0)
 
#define ECC_CORRECTION                0x1b0
#define     ECC_CORRECTION__VALUE            GENMASK(4, 0)
#define     ECC_CORRECTION__ERASE_THRESHOLD        GENMASK(31, 16)
 
#define READ_MODE                0x1c0
#define     READ_MODE__VALUE                GENMASK(3, 0)
 
#define WRITE_MODE                0x1d0
#define     WRITE_MODE__VALUE                GENMASK(3, 0)
 
#define COPYBACK_MODE                0x1e0
#define     COPYBACK_MODE__VALUE            GENMASK(3, 0)
 
#define RDWR_EN_LO_CNT                0x1f0
#define     RDWR_EN_LO_CNT__VALUE            GENMASK(4, 0)
 
#define RDWR_EN_HI_CNT                0x200
#define     RDWR_EN_HI_CNT__VALUE            GENMASK(4, 0)
 
#define MAX_RD_DELAY                0x210
#define     MAX_RD_DELAY__VALUE                GENMASK(3, 0)
 
#define CS_SETUP_CNT                0x220
#define     CS_SETUP_CNT__VALUE                GENMASK(4, 0)
#define     CS_SETUP_CNT__TWB                GENMASK(17, 12)
 
#define SPARE_AREA_SKIP_BYTES            0x230
#define     SPARE_AREA_SKIP_BYTES__VALUE        GENMASK(5, 0)
 
#define SPARE_AREA_MARKER            0x240
#define     SPARE_AREA_MARKER__VALUE            GENMASK(15, 0)
 
#define DEVICES_CONNECTED            0x250
#define     DEVICES_CONNECTED__VALUE            GENMASK(2, 0)
 
#define DIE_MASK                0x260
#define     DIE_MASK__VALUE                GENMASK(7, 0)
 
#define FIRST_BLOCK_OF_NEXT_PLANE        0x270
#define     FIRST_BLOCK_OF_NEXT_PLANE__VALUE        GENMASK(15, 0)
 
#define WRITE_PROTECT                0x280
#define     WRITE_PROTECT__FLAG                BIT(0)
 
#define RE_2_RE                    0x290
#define     RE_2_RE__VALUE                GENMASK(5, 0)
 
#define MANUFACTURER_ID                0x300
#define     MANUFACTURER_ID__VALUE            GENMASK(7, 0)
 
#define DEVICE_ID                0x310
#define     DEVICE_ID__VALUE                GENMASK(7, 0)
 
#define DEVICE_PARAM_0                0x320
#define     DEVICE_PARAM_0__VALUE            GENMASK(7, 0)
 
#define DEVICE_PARAM_1                0x330
#define     DEVICE_PARAM_1__VALUE            GENMASK(7, 0)
 
#define DEVICE_PARAM_2                0x340
#define     DEVICE_PARAM_2__VALUE            GENMASK(7, 0)
 
#define LOGICAL_PAGE_DATA_SIZE            0x350
#define     LOGICAL_PAGE_DATA_SIZE__VALUE        GENMASK(15, 0)
 
#define LOGICAL_PAGE_SPARE_SIZE            0x360
#define     LOGICAL_PAGE_SPARE_SIZE__VALUE        GENMASK(15, 0)
 
#define REVISION                0x370
#define     REVISION__VALUE                GENMASK(15, 0)
 
#define ONFI_DEVICE_FEATURES            0x380
#define     ONFI_DEVICE_FEATURES__VALUE            GENMASK(5, 0)
 
#define ONFI_OPTIONAL_COMMANDS            0x390
#define     ONFI_OPTIONAL_COMMANDS__VALUE        GENMASK(5, 0)
 
#define ONFI_TIMING_MODE            0x3a0
#define     ONFI_TIMING_MODE__VALUE            GENMASK(5, 0)
 
#define ONFI_PGM_CACHE_TIMING_MODE        0x3b0
#define     ONFI_PGM_CACHE_TIMING_MODE__VALUE        GENMASK(5, 0)
 
#define ONFI_DEVICE_NO_OF_LUNS            0x3c0
#define     ONFI_DEVICE_NO_OF_LUNS__NO_OF_LUNS        GENMASK(7, 0)
#define     ONFI_DEVICE_NO_OF_LUNS__ONFI_DEVICE        BIT(8)
 
#define ONFI_DEVICE_NO_OF_BLOCKS_PER_LUN_L    0x3d0
#define     ONFI_DEVICE_NO_OF_BLOCKS_PER_LUN_L__VALUE    GENMASK(15, 0)
 
#define ONFI_DEVICE_NO_OF_BLOCKS_PER_LUN_U    0x3e0
#define     ONFI_DEVICE_NO_OF_BLOCKS_PER_LUN_U__VALUE    GENMASK(15, 0)
 
#define FEATURES                0x3f0
#define     FEATURES__N_BANKS                GENMASK(1, 0)
#define     FEATURES__ECC_MAX_ERR            GENMASK(5, 2)
#define     FEATURES__DMA                BIT(6)
#define     FEATURES__CMD_DMA                BIT(7)
#define     FEATURES__PARTITION                BIT(8)
#define     FEATURES__XDMA_SIDEBAND            BIT(9)
#define     FEATURES__GPREG                BIT(10)
#define     FEATURES__INDEX_ADDR            BIT(11)
 
#define TRANSFER_MODE                0x400
#define     TRANSFER_MODE__VALUE            GENMASK(1, 0)
 
#define INTR_STATUS(bank)            (0x410 + (bank) * 0x50)
#define INTR_EN(bank)                (0x420 + (bank) * 0x50)
/* bit[1:0] is used differently depending on IP version */
#define     INTR__ECC_UNCOR_ERR                BIT(0)    /* new IP */
#define     INTR__ECC_TRANSACTION_DONE            BIT(0)    /* old IP */
#define     INTR__ECC_ERR                BIT(1)    /* old IP */
#define     INTR__DMA_CMD_COMP                BIT(2)
#define     INTR__TIME_OUT                BIT(3)
#define     INTR__PROGRAM_FAIL                BIT(4)
#define     INTR__ERASE_FAIL                BIT(5)
#define     INTR__LOAD_COMP                BIT(6)
#define     INTR__PROGRAM_COMP                BIT(7)
#define     INTR__ERASE_COMP                BIT(8)
#define     INTR__PIPE_CPYBCK_CMD_COMP            BIT(9)
#define     INTR__LOCKED_BLK                BIT(10)
#define     INTR__UNSUP_CMD                BIT(11)
#define     INTR__INT_ACT                BIT(12)
#define     INTR__RST_COMP                BIT(13)
#define     INTR__PIPE_CMD_ERR                BIT(14)
#define     INTR__PAGE_XFER_INC                BIT(15)
#define     INTR__ERASED_PAGE                BIT(16)
 
#define PAGE_CNT(bank)                (0x430 + (bank) * 0x50)
#define ERR_PAGE_ADDR(bank)            (0x440 + (bank) * 0x50)
#define ERR_BLOCK_ADDR(bank)            (0x450 + (bank) * 0x50)
 
#define ECC_THRESHOLD                0x600
#define     ECC_THRESHOLD__VALUE            GENMASK(9, 0)
 
#define ECC_ERROR_BLOCK_ADDRESS            0x610
#define     ECC_ERROR_BLOCK_ADDRESS__VALUE        GENMASK(15, 0)
 
#define ECC_ERROR_PAGE_ADDRESS            0x620
#define     ECC_ERROR_PAGE_ADDRESS__VALUE        GENMASK(11, 0)
#define     ECC_ERROR_PAGE_ADDRESS__BANK        GENMASK(15, 12)
 
#define ECC_ERROR_ADDRESS            0x630
#define     ECC_ERROR_ADDRESS__OFFSET            GENMASK(11, 0)
#define     ECC_ERROR_ADDRESS__SECTOR            GENMASK(15, 12)
 
#define ERR_CORRECTION_INFO            0x640
#define     ERR_CORRECTION_INFO__BYTE            GENMASK(7, 0)
#define     ERR_CORRECTION_INFO__DEVICE            GENMASK(11, 8)
#define     ERR_CORRECTION_INFO__UNCOR            BIT(14)
#define     ERR_CORRECTION_INFO__LAST_ERR        BIT(15)
 
#define ECC_COR_INFO(bank)            (0x650 + (bank) / 2 * 0x10)
#define     ECC_COR_INFO__SHIFT(bank)            ((bank) % 2 * 8)
#define     ECC_COR_INFO__MAX_ERRORS            GENMASK(6, 0)
#define     ECC_COR_INFO__UNCOR_ERR            BIT(7)
 
#define CFG_DATA_BLOCK_SIZE            0x6b0
 
#define CFG_LAST_DATA_BLOCK_SIZE        0x6c0
 
#define CFG_NUM_DATA_BLOCKS            0x6d0
 
#define CFG_META_DATA_SIZE            0x6e0
 
#define DMA_ENABLE                0x700
#define     DMA_ENABLE__FLAG                BIT(0)
 
#define IGNORE_ECC_DONE                0x710
#define     IGNORE_ECC_DONE__FLAG            BIT(0)
 
#define DMA_INTR                0x720
#define DMA_INTR_EN                0x730
#define     DMA_INTR__TARGET_ERROR            BIT(0)
#define     DMA_INTR__DESC_COMP_CHANNEL0        BIT(1)
#define     DMA_INTR__DESC_COMP_CHANNEL1        BIT(2)
#define     DMA_INTR__DESC_COMP_CHANNEL2        BIT(3)
#define     DMA_INTR__DESC_COMP_CHANNEL3        BIT(4)
#define     DMA_INTR__MEMCOPY_DESC_COMP            BIT(5)
 
#define TARGET_ERR_ADDR_LO            0x740
#define     TARGET_ERR_ADDR_LO__VALUE            GENMASK(15, 0)
 
#define TARGET_ERR_ADDR_HI            0x750
#define     TARGET_ERR_ADDR_HI__VALUE            GENMASK(15, 0)
 
#define CHNL_ACTIVE                0x760
#define     CHNL_ACTIVE__CHANNEL0            BIT(0)
#define     CHNL_ACTIVE__CHANNEL1            BIT(1)
#define     CHNL_ACTIVE__CHANNEL2            BIT(2)
#define     CHNL_ACTIVE__CHANNEL3            BIT(3)
 
/**
 * struct denali_chip_sel - per-CS data of Denali NAND
 *
 * @bank:                  bank id of the controller this CS is connected to
 * @hwhr2_and_we_2_re:     value of timing register HWHR2_AND_WE_2_RE
 * @tcwaw_and_addr_2_data: value of timing register TCWAW_AND_ADDR_2_DATA
 * @re_2_we:               value of timing register RE_2_WE
 * @acc_clks:              value of timing register ACC_CLKS
 * @rdwr_en_lo_cnt:        value of timing register RDWR_EN_LO_CNT
 * @rdwr_en_hi_cnt:        value of timing register RDWR_EN_HI_CNT
 * @cs_setup_cnt:          value of timing register CS_SETUP_CNT
 * @re_2_re:               value of timing register RE_2_RE
 */
struct denali_chip_sel {
   int bank;
   u32 hwhr2_and_we_2_re;
   u32 tcwaw_and_addr_2_data;
   u32 re_2_we;
   u32 acc_clks;
   u32 rdwr_en_lo_cnt;
   u32 rdwr_en_hi_cnt;
   u32 cs_setup_cnt;
   u32 re_2_re;
};
 
/**
 * struct denali_chip - per-chip data of Denali NAND
 *
 * @chip:  base NAND chip structure
 * @node:  node to be used to associate this chip with the controller
 * @nsels: the number of CS lines of this chip
 * @sels:  the array of per-cs data
 */
struct denali_chip {
   struct nand_chip chip;
   struct list_head node;
   unsigned int nsels;
   struct denali_chip_sel sels[];
};
 
/**
 * struct denali_controller - Denali NAND controller data
 *
 * @controller:     base NAND controller structure
 * @dev:            device
 * @chips:          the list of chips attached to this controller
 * @clk_rate:       frequency of core clock
 * @clk_x_rate:     frequency of bus interface clock
 * @reg:            base of Register Interface
 * @host:           base of Host Data/Command interface
 * @complete:       completion used to wait for interrupts
 * @irq:            interrupt number
 * @irq_mask:       interrupt bits the controller is waiting for
 * @irq_status:     interrupt bits of events that have happened
 * @irq_lock:       lock to protect @irq_mask and @irq_status
 * @dma_avail:      set if DMA engine is available
 * @devs_per_cs:    number of devices connected in parallel
 * @oob_skip_bytes: number of bytes in OOB skipped by the ECC engine
 * @active_bank:    active bank id
 * @nbanks:         the number of banks supported by this controller
 * @revision:       IP revision
 * @caps:           controller capabilities that cannot be detected run-time
 * @ecc_caps:       ECC engine capabilities
 * @host_read:      callback for read access of Host Data/Command Interface
 * @host_write:     callback for write access of Host Data/Command Interface
 * @setup_dma:      callback for setup of the Data DMA
 */
struct denali_controller {
   struct nand_controller controller;
   struct device *dev;
   struct list_head chips;
   unsigned long clk_rate;
   unsigned long clk_x_rate;
   void __iomem *reg;
   void __iomem *host;
   struct completion complete;
   int irq;
   u32 irq_mask;
   u32 irq_status;
   spinlock_t irq_lock;
   bool dma_avail;
   int devs_per_cs;
   int oob_skip_bytes;
   int active_bank;
   int nbanks;
   unsigned int revision;
   unsigned int caps;
   const struct nand_ecc_caps *ecc_caps;
   u32 (*host_read)(struct denali_controller *denali, u32 addr);
   void (*host_write)(struct denali_controller *denali, u32 addr,
              u32 data);
   void (*setup_dma)(struct denali_controller *denali, dma_addr_t dma_addr,
             int page, bool write);
};
 
#define DENALI_CAP_HW_ECC_FIXUP            BIT(0)
#define DENALI_CAP_DMA_64BIT            BIT(1)
 
int denali_calc_ecc_bytes(int step_size, int strength);
int denali_chip_init(struct denali_controller *denali,
            struct denali_chip *dchip);
int denali_init(struct denali_controller *denali);
void denali_remove(struct denali_controller *denali);
 
#endif /* __DENALI_H__ */