xref: /linux/include/linux/mtd/sh_flctl.h (revision 44f57d78)
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 
124 enum flctl_ecc_res_t {
125 	FL_SUCCESS,
126 	FL_REPAIRABLE,
127 	FL_ERROR,
128 	FL_TIMEOUT
129 };
130 
131 struct dma_chan;
132 
133 struct 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 
163 struct 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 
175 static 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