1/* SPDX-License-Identifier: GPL-2.0
2 *
3 * SuperH FLCTL nand controller
4 *
5 * Copyright © 2008 Renesas Solutions Corp.
6 */
7
8#ifndef __SH_FLCTL_H__
9#define __SH_FLCTL_H__
10
11#include <linux/completion.h>
12#include <linux/mtd/mtd.h>
13#include <linux/mtd/rawnand.h>
14#include <linux/mtd/partitions.h>
15#include <linux/pm_qos.h>
16
17/* FLCTL registers */
18#define FLCMNCR(f) (f->reg + 0x0)
19#define FLCMDCR(f) (f->reg + 0x4)
20#define FLCMCDR(f) (f->reg + 0x8)
21#define FLADR(f) (f->reg + 0xC)
22#define FLADR2(f) (f->reg + 0x3C)
23#define FLDATAR(f) (f->reg + 0x10)
24#define FLDTCNTR(f) (f->reg + 0x14)
25#define FLINTDMACR(f) (f->reg + 0x18)
26#define FLBSYTMR(f) (f->reg + 0x1C)
27#define FLBSYCNT(f) (f->reg + 0x20)
28#define FLDTFIFO(f) (f->reg + 0x24)
29#define FLECFIFO(f) (f->reg + 0x28)
30#define FLTRCR(f) (f->reg + 0x2C)
31#define FLHOLDCR(f) (f->reg + 0x38)
32#define FL4ECCRESULT0(f) (f->reg + 0x80)
33#define FL4ECCRESULT1(f) (f->reg + 0x84)
34#define FL4ECCRESULT2(f) (f->reg + 0x88)
35#define FL4ECCRESULT3(f) (f->reg + 0x8C)
36#define FL4ECCCR(f) (f->reg + 0x90)
37#define FL4ECCCNT(f) (f->reg + 0x94)
38#define FLERRADR(f) (f->reg + 0x98)
39
40/* FLCMNCR control bits */
41#define _4ECCCNTEN (0x1 << 24)
42#define _4ECCEN (0x1 << 23)
43#define _4ECCCORRECT (0x1 << 22)
44#define SHBUSSEL (0x1 << 20)
45#define SEL_16BIT (0x1 << 19)
46#define SNAND_E (0x1 << 18) /* SNAND (0=512 1=2048)*/
47#define QTSEL_E (0x1 << 17)
48#define ENDIAN (0x1 << 16) /* 1 = little endian */
49#define FCKSEL_E (0x1 << 15)
50#define ACM_SACCES_MODE (0x01 << 10)
51#define NANWF_E (0x1 << 9)
52#define SE_D (0x1 << 8) /* Spare area disable */
53#define CE1_ENABLE (0x1 << 4) /* Chip Enable 1 */
54#define CE0_ENABLE (0x1 << 3) /* Chip Enable 0 */
55#define TYPESEL_SET (0x1 << 0)
56
57/*
58 * Clock settings using the PULSEx registers from FLCMNCR
59 *
60 * Some hardware uses bits called PULSEx instead of FCKSEL_E and QTSEL_E
61 * to control the clock divider used between the High-Speed Peripheral Clock
62 * and the FLCTL internal clock. If so, use CLK_8_BIT_xxx for connecting 8 bit
63 * and CLK_16_BIT_xxx for connecting 16 bit bus bandwith NAND chips. For the 16
64 * bit version the divider is seperate for the pulse width of high and low
65 * signals.
66 */
67#define PULSE3 (0x1 << 27)
68#define PULSE2 (0x1 << 17)
69#define PULSE1 (0x1 << 15)
70#define PULSE0 (0x1 << 9)
71#define CLK_8B_0_5 PULSE1
72#define CLK_8B_1 0x0
73#define CLK_8B_1_5 (PULSE1 | PULSE2)
74#define CLK_8B_2 PULSE0
75#define CLK_8B_3 (PULSE0 | PULSE1 | PULSE2)
76#define CLK_8B_4 (PULSE0 | PULSE2)
77#define CLK_16B_6L_2H PULSE0
78#define CLK_16B_9L_3H (PULSE0 | PULSE1 | PULSE2)
79#define CLK_16B_12L_4H (PULSE0 | PULSE2)
80
81/* FLCMDCR control bits */
82#define ADRCNT2_E (0x1 << 31) /* 5byte address enable */
83#define ADRMD_E (0x1 << 26) /* Sector address access */
84#define CDSRC_E (0x1 << 25) /* Data buffer selection */
85#define DOSR_E (0x1 << 24) /* Status read check */
86#define SELRW (0x1 << 21) /* 0:read 1:write */
87#define DOADR_E (0x1 << 20) /* Address stage execute */
88#define ADRCNT_1 (0x00 << 18) /* Address data bytes: 1byte */
89#define ADRCNT_2 (0x01 << 18) /* Address data bytes: 2byte */
90#define ADRCNT_3 (0x02 << 18) /* Address data bytes: 3byte */
91#define ADRCNT_4 (0x03 << 18) /* Address data bytes: 4byte */
92#define DOCMD2_E (0x1 << 17) /* 2nd cmd stage execute */
93#define DOCMD1_E (0x1 << 16) /* 1st cmd stage execute */
94
95/* FLINTDMACR control bits */
96#define ESTERINTE (0x1 << 24) /* ECC error interrupt enable */
97#define AC1CLR (0x1 << 19) /* ECC FIFO clear */
98#define AC0CLR (0x1 << 18) /* Data FIFO clear */
99#define DREQ0EN (0x1 << 16) /* FLDTFIFODMA Request Enable */
100#define ECERB (0x1 << 9) /* ECC error */
101#define STERB (0x1 << 8) /* Status error */
102#define STERINTE (0x1 << 4) /* Status error enable */
103
104/* FLTRCR control bits */
105#define TRSTRT (0x1 << 0) /* translation start */
106#define TREND (0x1 << 1) /* translation end */
107
108/*
109 * FLHOLDCR control bits
110 *
111 * HOLDEN: Bus Occupancy Enable (inverted)
112 * Enable this bit when the external bus might be used in between transfers.
113 * If not set and the bus gets used by other modules, a deadlock occurs.
114 */
115#define HOLDEN (0x1 << 0)
116
117/* FL4ECCCR control bits */
118#define _4ECCFA (0x1 << 2) /* 4 symbols correct fault */
119#define _4ECCEND (0x1 << 1) /* 4 symbols end */
120#define _4ECCEXST (0x1 << 0) /* 4 symbols exist */
121
122#define LOOP_TIMEOUT_MAX 0x00010000
123
124enum flctl_ecc_res_t {
125 FL_SUCCESS,
126 FL_REPAIRABLE,
127 FL_ERROR,
128 FL_TIMEOUT
129};
130
131struct dma_chan;
132
133struct sh_flctl {
134 struct nand_chip chip;
135 struct platform_device *pdev;
136 struct dev_pm_qos_request pm_qos;
137 void __iomem *reg;
138 resource_size_t fifo;
139
140 uint8_t done_buff[2048 + 64]; /* max size 2048 + 64 */
141 int read_bytes;
142 unsigned int index;
143 int seqin_column; /* column in SEQIN cmd */
144 int seqin_page_addr; /* page_addr in SEQIN cmd */
145 uint32_t seqin_read_cmd; /* read cmd in SEQIN cmd */
146 int erase1_page_addr; /* page_addr in ERASE1 cmd */
147 uint32_t erase_ADRCNT; /* bits of FLCMDCR in ERASE1 cmd */
148 uint32_t rw_ADRCNT; /* bits of FLCMDCR in READ WRITE cmd */
149 uint32_t flcmncr_base; /* base value of FLCMNCR */
150 uint32_t flintdmacr_base; /* irq enable bits */
151
152 unsigned page_size:1; /* NAND page size (0 = 512, 1 = 2048) */
153 unsigned hwecc:1; /* Hardware ECC (0 = disabled, 1 = enabled) */
154 unsigned holden:1; /* Hardware has FLHOLDCR and HOLDEN is set */
155 unsigned qos_request:1; /* QoS request to prevent deep power shutdown */
156
157 /* DMA related objects */
158 struct dma_chan *chan_fifo0_rx;
159 struct dma_chan *chan_fifo0_tx;
160 struct completion dma_complete;
161};
162
163struct sh_flctl_platform_data {
164 struct mtd_partition *parts;
165 int nr_parts;
166 unsigned long flcmncr_val;
167
168 unsigned has_hwecc:1;
169 unsigned use_holden:1;
170
171 unsigned int slave_id_fifo0_tx;
172 unsigned int slave_id_fifo0_rx;
173};
174
175static inline struct sh_flctl *mtd_to_flctl(struct mtd_info *mtdinfo)
176{
177 return container_of(mtd_to_nand(mtdinfo), struct sh_flctl, chip);
178}
179
180#endif /* __SH_FLCTL_H__ */
181

source code of linux/include/linux/mtd/sh_flctl.h