mtd: mxc-nand: Implement support for PARAM command
[deliverable/linux.git] / drivers / mtd / nand / mxc_nand.c
CommitLineData
34f6e157
SH
1/*
2 * Copyright 2004-2007 Freescale Semiconductor, Inc. All Rights Reserved.
3 * Copyright 2008 Sascha Hauer, kernel@pengutronix.de
4 *
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License
7 * as published by the Free Software Foundation; either version 2
8 * of the License, or (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
17 * MA 02110-1301, USA.
18 */
19
20#include <linux/delay.h>
21#include <linux/slab.h>
22#include <linux/init.h>
23#include <linux/module.h>
24#include <linux/mtd/mtd.h>
25#include <linux/mtd/nand.h>
26#include <linux/mtd/partitions.h>
27#include <linux/interrupt.h>
28#include <linux/device.h>
29#include <linux/platform_device.h>
30#include <linux/clk.h>
31#include <linux/err.h>
32#include <linux/io.h>
63f1474c
SH
33#include <linux/irq.h>
34#include <linux/completion.h>
d367e37e 35#include <linux/of.h>
6436356b
UKK
36#include <linux/of_device.h>
37#include <linux/of_mtd.h>
34f6e157
SH
38
39#include <asm/mach/flash.h>
82906b13 40#include <linux/platform_data/mtd-mxc_nand.h>
34f6e157
SH
41
42#define DRIVER_NAME "mxc_nand"
43
44/* Addresses for NFC registers */
1bc99180
SH
45#define NFC_V1_V2_BUF_SIZE (host->regs + 0x00)
46#define NFC_V1_V2_BUF_ADDR (host->regs + 0x04)
47#define NFC_V1_V2_FLASH_ADDR (host->regs + 0x06)
48#define NFC_V1_V2_FLASH_CMD (host->regs + 0x08)
49#define NFC_V1_V2_CONFIG (host->regs + 0x0a)
50#define NFC_V1_V2_ECC_STATUS_RESULT (host->regs + 0x0c)
51#define NFC_V1_V2_RSLTMAIN_AREA (host->regs + 0x0e)
52#define NFC_V1_V2_RSLTSPARE_AREA (host->regs + 0x10)
53#define NFC_V1_V2_WRPROT (host->regs + 0x12)
54#define NFC_V1_UNLOCKSTART_BLKADDR (host->regs + 0x14)
55#define NFC_V1_UNLOCKEND_BLKADDR (host->regs + 0x16)
d178e3e8
BS
56#define NFC_V21_UNLOCKSTART_BLKADDR0 (host->regs + 0x20)
57#define NFC_V21_UNLOCKSTART_BLKADDR1 (host->regs + 0x24)
58#define NFC_V21_UNLOCKSTART_BLKADDR2 (host->regs + 0x28)
59#define NFC_V21_UNLOCKSTART_BLKADDR3 (host->regs + 0x2c)
60#define NFC_V21_UNLOCKEND_BLKADDR0 (host->regs + 0x22)
61#define NFC_V21_UNLOCKEND_BLKADDR1 (host->regs + 0x26)
62#define NFC_V21_UNLOCKEND_BLKADDR2 (host->regs + 0x2a)
63#define NFC_V21_UNLOCKEND_BLKADDR3 (host->regs + 0x2e)
1bc99180
SH
64#define NFC_V1_V2_NF_WRPRST (host->regs + 0x18)
65#define NFC_V1_V2_CONFIG1 (host->regs + 0x1a)
66#define NFC_V1_V2_CONFIG2 (host->regs + 0x1c)
67
6e85dfdc 68#define NFC_V2_CONFIG1_ECC_MODE_4 (1 << 0)
1bc99180
SH
69#define NFC_V1_V2_CONFIG1_SP_EN (1 << 2)
70#define NFC_V1_V2_CONFIG1_ECC_EN (1 << 3)
71#define NFC_V1_V2_CONFIG1_INT_MSK (1 << 4)
72#define NFC_V1_V2_CONFIG1_BIG (1 << 5)
73#define NFC_V1_V2_CONFIG1_RST (1 << 6)
74#define NFC_V1_V2_CONFIG1_CE (1 << 7)
b8db2f51
SH
75#define NFC_V2_CONFIG1_ONE_CYCLE (1 << 8)
76#define NFC_V2_CONFIG1_PPB(x) (((x) & 0x3) << 9)
77#define NFC_V2_CONFIG1_FP_INT (1 << 11)
1bc99180
SH
78
79#define NFC_V1_V2_CONFIG2_INT (1 << 15)
80
81/*
82 * Operation modes for the NFC. Valid for v1, v2 and v3
83 * type controllers.
84 */
85#define NFC_CMD (1 << 0)
86#define NFC_ADDR (1 << 1)
87#define NFC_INPUT (1 << 2)
88#define NFC_OUTPUT (1 << 3)
89#define NFC_ID (1 << 4)
90#define NFC_STATUS (1 << 5)
34f6e157 91
71ec5155
SH
92#define NFC_V3_FLASH_CMD (host->regs_axi + 0x00)
93#define NFC_V3_FLASH_ADDR0 (host->regs_axi + 0x04)
94
95#define NFC_V3_CONFIG1 (host->regs_axi + 0x34)
96#define NFC_V3_CONFIG1_SP_EN (1 << 0)
97#define NFC_V3_CONFIG1_RBA(x) (((x) & 0x7 ) << 4)
98
99#define NFC_V3_ECC_STATUS_RESULT (host->regs_axi + 0x38)
100
101#define NFC_V3_LAUNCH (host->regs_axi + 0x40)
102
103#define NFC_V3_WRPROT (host->regs_ip + 0x0)
104#define NFC_V3_WRPROT_LOCK_TIGHT (1 << 0)
105#define NFC_V3_WRPROT_LOCK (1 << 1)
106#define NFC_V3_WRPROT_UNLOCK (1 << 2)
107#define NFC_V3_WRPROT_BLS_UNLOCK (2 << 6)
108
109#define NFC_V3_WRPROT_UNLOCK_BLK_ADD0 (host->regs_ip + 0x04)
110
111#define NFC_V3_CONFIG2 (host->regs_ip + 0x24)
112#define NFC_V3_CONFIG2_PS_512 (0 << 0)
113#define NFC_V3_CONFIG2_PS_2048 (1 << 0)
114#define NFC_V3_CONFIG2_PS_4096 (2 << 0)
115#define NFC_V3_CONFIG2_ONE_CYCLE (1 << 2)
116#define NFC_V3_CONFIG2_ECC_EN (1 << 3)
117#define NFC_V3_CONFIG2_2CMD_PHASES (1 << 4)
118#define NFC_V3_CONFIG2_NUM_ADDR_PHASE0 (1 << 5)
119#define NFC_V3_CONFIG2_ECC_MODE_8 (1 << 6)
71718a8e 120#define NFC_V3_CONFIG2_PPB(x, shift) (((x) & 0x3) << shift)
71ec5155
SH
121#define NFC_V3_CONFIG2_NUM_ADDR_PHASE1(x) (((x) & 0x3) << 12)
122#define NFC_V3_CONFIG2_INT_MSK (1 << 15)
123#define NFC_V3_CONFIG2_ST_CMD(x) (((x) & 0xff) << 24)
124#define NFC_V3_CONFIG2_SPAS(x) (((x) & 0xff) << 16)
125
126#define NFC_V3_CONFIG3 (host->regs_ip + 0x28)
127#define NFC_V3_CONFIG3_ADD_OP(x) (((x) & 0x3) << 0)
128#define NFC_V3_CONFIG3_FW8 (1 << 3)
129#define NFC_V3_CONFIG3_SBB(x) (((x) & 0x7) << 8)
130#define NFC_V3_CONFIG3_NUM_OF_DEVICES(x) (((x) & 0x7) << 12)
131#define NFC_V3_CONFIG3_RBB_MODE (1 << 15)
132#define NFC_V3_CONFIG3_NO_SDMA (1 << 20)
133
134#define NFC_V3_IPC (host->regs_ip + 0x2C)
135#define NFC_V3_IPC_CREQ (1 << 0)
136#define NFC_V3_IPC_INT (1 << 31)
137
138#define NFC_V3_DELAY_LINE (host->regs_ip + 0x34)
34f6e157 139
e4303b25
UKK
140struct mxc_nand_host;
141
142struct mxc_nand_devtype_data {
143 void (*preset)(struct mtd_info *);
144 void (*send_cmd)(struct mxc_nand_host *, uint16_t, int);
145 void (*send_addr)(struct mxc_nand_host *, uint16_t, int);
146 void (*send_page)(struct mtd_info *, unsigned int);
147 void (*send_read_id)(struct mxc_nand_host *);
148 uint16_t (*get_dev_status)(struct mxc_nand_host *);
149 int (*check_int)(struct mxc_nand_host *);
150 void (*irq_control)(struct mxc_nand_host *, int);
6d38af25 151 u32 (*get_ecc_status)(struct mxc_nand_host *);
6dcdf99d 152 struct nand_ecclayout *ecclayout_512, *ecclayout_2k, *ecclayout_4k;
5e05a2d6 153 void (*select_chip)(struct mtd_info *mtd, int chip);
69d023be
UKK
154 int (*correct_data)(struct mtd_info *mtd, u_char *dat,
155 u_char *read_ecc, u_char *calc_ecc);
f48d0f9a
UKK
156
157 /*
158 * On i.MX21 the CONFIG2:INT bit cannot be read if interrupts are masked
159 * (CONFIG1:INT_MSK is set). To handle this the driver uses
160 * enable_irq/disable_irq_nosync instead of CONFIG1:INT_MSK
161 */
162 int irqpending_quirk;
163 int needs_ip;
164
165 size_t regs_offset;
166 size_t spare0_offset;
167 size_t axi_offset;
168
169 int spare_len;
170 int eccbytes;
171 int eccsize;
71718a8e 172 int ppb_shift;
e4303b25
UKK
173};
174
34f6e157
SH
175struct mxc_nand_host {
176 struct mtd_info mtd;
177 struct nand_chip nand;
34f6e157
SH
178 struct device *dev;
179
4b6f05e1
UKK
180 void __iomem *spare0;
181 void __iomem *main_area0;
c6de7e1b
SH
182
183 void __iomem *base;
34f6e157 184 void __iomem *regs;
71ec5155
SH
185 void __iomem *regs_axi;
186 void __iomem *regs_ip;
34f6e157 187 int status_request;
34f6e157
SH
188 struct clk *clk;
189 int clk_act;
190 int irq;
94f77e50 191 int eccsize;
d178e3e8 192 int active_cs;
34f6e157 193
63f1474c 194 struct completion op_completion;
34f6e157 195
f8f9608d
SH
196 uint8_t *data_buf;
197 unsigned int buf_start;
5f97304e 198
e4303b25 199 const struct mxc_nand_devtype_data *devtype_data;
6436356b 200 struct mxc_nand_platform_data pdata;
34f6e157
SH
201};
202
34f6e157 203/* OOB placement block for use with hardware ecc generation */
9467114e 204static struct nand_ecclayout nandv1_hw_eccoob_smallpage = {
34f6e157
SH
205 .eccbytes = 5,
206 .eccpos = {6, 7, 8, 9, 10},
8c1fd89a 207 .oobfree = {{0, 5}, {12, 4}, }
bd3fd62e
VB
208};
209
9467114e 210static struct nand_ecclayout nandv1_hw_eccoob_largepage = {
bd3fd62e
VB
211 .eccbytes = 20,
212 .eccpos = {6, 7, 8, 9, 10, 22, 23, 24, 25, 26,
213 38, 39, 40, 41, 42, 54, 55, 56, 57, 58},
214 .oobfree = {{2, 4}, {11, 10}, {27, 10}, {43, 10}, {59, 5}, }
34f6e157
SH
215};
216
9467114e
SH
217/* OOB description for 512 byte pages with 16 byte OOB */
218static struct nand_ecclayout nandv2_hw_eccoob_smallpage = {
219 .eccbytes = 1 * 9,
220 .eccpos = {
221 7, 8, 9, 10, 11, 12, 13, 14, 15
222 },
223 .oobfree = {
224 {.offset = 0, .length = 5}
225 }
226};
227
228/* OOB description for 2048 byte pages with 64 byte OOB */
229static struct nand_ecclayout nandv2_hw_eccoob_largepage = {
230 .eccbytes = 4 * 9,
231 .eccpos = {
232 7, 8, 9, 10, 11, 12, 13, 14, 15,
233 23, 24, 25, 26, 27, 28, 29, 30, 31,
234 39, 40, 41, 42, 43, 44, 45, 46, 47,
235 55, 56, 57, 58, 59, 60, 61, 62, 63
236 },
237 .oobfree = {
238 {.offset = 2, .length = 4},
239 {.offset = 16, .length = 7},
240 {.offset = 32, .length = 7},
241 {.offset = 48, .length = 7}
242 }
243};
244
2c1c5f19
BS
245/* OOB description for 4096 byte pages with 128 byte OOB */
246static struct nand_ecclayout nandv2_hw_eccoob_4k = {
247 .eccbytes = 8 * 9,
248 .eccpos = {
249 7, 8, 9, 10, 11, 12, 13, 14, 15,
250 23, 24, 25, 26, 27, 28, 29, 30, 31,
251 39, 40, 41, 42, 43, 44, 45, 46, 47,
252 55, 56, 57, 58, 59, 60, 61, 62, 63,
253 71, 72, 73, 74, 75, 76, 77, 78, 79,
254 87, 88, 89, 90, 91, 92, 93, 94, 95,
255 103, 104, 105, 106, 107, 108, 109, 110, 111,
256 119, 120, 121, 122, 123, 124, 125, 126, 127,
257 },
258 .oobfree = {
259 {.offset = 2, .length = 4},
260 {.offset = 16, .length = 7},
261 {.offset = 32, .length = 7},
262 {.offset = 48, .length = 7},
263 {.offset = 64, .length = 7},
264 {.offset = 80, .length = 7},
265 {.offset = 96, .length = 7},
266 {.offset = 112, .length = 7},
267 }
268};
269
b2ac0376 270static const char * const part_probes[] = {
740bb0c4 271 "cmdlinepart", "RedBoot", "ofpart", NULL };
34f6e157 272
096bcc23
SH
273static void memcpy32_fromio(void *trg, const void __iomem *src, size_t size)
274{
275 int i;
276 u32 *t = trg;
277 const __iomem u32 *s = src;
278
279 for (i = 0; i < (size >> 2); i++)
280 *t++ = __raw_readl(s++);
281}
282
33a87a15 283static inline void memcpy32_toio(void __iomem *trg, const void *src, int size)
096bcc23 284{
33a87a15
KV
285 /* __iowrite32_copy use 32bit size values so divide by 4 */
286 __iowrite32_copy(trg, src, size / 4);
096bcc23
SH
287}
288
71ec5155
SH
289static int check_int_v3(struct mxc_nand_host *host)
290{
291 uint32_t tmp;
292
293 tmp = readl(NFC_V3_IPC);
294 if (!(tmp & NFC_V3_IPC_INT))
295 return 0;
296
297 tmp &= ~NFC_V3_IPC_INT;
298 writel(tmp, NFC_V3_IPC);
299
300 return 1;
301}
302
7aaf28ac
SH
303static int check_int_v1_v2(struct mxc_nand_host *host)
304{
305 uint32_t tmp;
306
1bc99180
SH
307 tmp = readw(NFC_V1_V2_CONFIG2);
308 if (!(tmp & NFC_V1_V2_CONFIG2_INT))
7aaf28ac
SH
309 return 0;
310
f48d0f9a 311 if (!host->devtype_data->irqpending_quirk)
63f1474c 312 writew(tmp & ~NFC_V1_V2_CONFIG2_INT, NFC_V1_V2_CONFIG2);
7aaf28ac
SH
313
314 return 1;
315}
316
63f1474c
SH
317static void irq_control_v1_v2(struct mxc_nand_host *host, int activate)
318{
319 uint16_t tmp;
320
321 tmp = readw(NFC_V1_V2_CONFIG1);
322
323 if (activate)
324 tmp &= ~NFC_V1_V2_CONFIG1_INT_MSK;
325 else
326 tmp |= NFC_V1_V2_CONFIG1_INT_MSK;
327
328 writew(tmp, NFC_V1_V2_CONFIG1);
329}
330
331static void irq_control_v3(struct mxc_nand_host *host, int activate)
332{
333 uint32_t tmp;
334
335 tmp = readl(NFC_V3_CONFIG2);
336
337 if (activate)
338 tmp &= ~NFC_V3_CONFIG2_INT_MSK;
339 else
340 tmp |= NFC_V3_CONFIG2_INT_MSK;
341
342 writel(tmp, NFC_V3_CONFIG2);
343}
344
8556958a
UKK
345static void irq_control(struct mxc_nand_host *host, int activate)
346{
f48d0f9a 347 if (host->devtype_data->irqpending_quirk) {
8556958a
UKK
348 if (activate)
349 enable_irq(host->irq);
350 else
351 disable_irq_nosync(host->irq);
352 } else {
e4303b25 353 host->devtype_data->irq_control(host, activate);
8556958a
UKK
354 }
355}
356
6d38af25
UKK
357static u32 get_ecc_status_v1(struct mxc_nand_host *host)
358{
359 return readw(NFC_V1_V2_ECC_STATUS_RESULT);
360}
361
362static u32 get_ecc_status_v2(struct mxc_nand_host *host)
363{
364 return readl(NFC_V1_V2_ECC_STATUS_RESULT);
365}
366
367static u32 get_ecc_status_v3(struct mxc_nand_host *host)
368{
369 return readl(NFC_V3_ECC_STATUS_RESULT);
370}
371
8556958a
UKK
372static irqreturn_t mxc_nfc_irq(int irq, void *dev_id)
373{
374 struct mxc_nand_host *host = dev_id;
375
e4303b25 376 if (!host->devtype_data->check_int(host))
8556958a
UKK
377 return IRQ_NONE;
378
379 irq_control(host, 0);
380
381 complete(&host->op_completion);
382
383 return IRQ_HANDLED;
384}
385
34f6e157
SH
386/* This function polls the NANDFC to wait for the basic operation to
387 * complete by checking the INT bit of config2 register.
388 */
e35d1d8a 389static int wait_op_done(struct mxc_nand_host *host, int useirq)
34f6e157 390{
e35d1d8a
UKK
391 int ret = 0;
392
393 /*
394 * If operation is already complete, don't bother to setup an irq or a
395 * loop.
396 */
397 if (host->devtype_data->check_int(host))
398 return 0;
34f6e157
SH
399
400 if (useirq) {
e35d1d8a
UKK
401 unsigned long timeout;
402
403 reinit_completion(&host->op_completion);
404
405 irq_control(host, 1);
406
407 timeout = wait_for_completion_timeout(&host->op_completion, HZ);
408 if (!timeout && !host->devtype_data->check_int(host)) {
409 dev_dbg(host->dev, "timeout waiting for irq\n");
410 ret = -ETIMEDOUT;
34f6e157
SH
411 }
412 } else {
e35d1d8a
UKK
413 int max_retries = 8000;
414 int done;
7aaf28ac 415
e35d1d8a 416 do {
34f6e157 417 udelay(1);
e35d1d8a
UKK
418
419 done = host->devtype_data->check_int(host);
420 if (done)
421 break;
422
423 } while (--max_retries);
424
425 if (!done) {
426 dev_dbg(host->dev, "timeout polling for completion\n");
427 ret = -ETIMEDOUT;
34f6e157 428 }
34f6e157 429 }
e35d1d8a
UKK
430
431 WARN_ONCE(ret < 0, "timeout! useirq=%d\n", useirq);
432
433 return ret;
34f6e157
SH
434}
435
71ec5155
SH
436static void send_cmd_v3(struct mxc_nand_host *host, uint16_t cmd, int useirq)
437{
438 /* fill command */
439 writel(cmd, NFC_V3_FLASH_CMD);
440
441 /* send out command */
442 writel(NFC_CMD, NFC_V3_LAUNCH);
443
444 /* Wait for operation to complete */
445 wait_op_done(host, useirq);
446}
447
34f6e157
SH
448/* This function issues the specified command to the NAND device and
449 * waits for completion. */
5f97304e 450static void send_cmd_v1_v2(struct mxc_nand_host *host, uint16_t cmd, int useirq)
34f6e157 451{
289c0522 452 pr_debug("send_cmd(host, 0x%x, %d)\n", cmd, useirq);
34f6e157 453
1bc99180
SH
454 writew(cmd, NFC_V1_V2_FLASH_CMD);
455 writew(NFC_CMD, NFC_V1_V2_CONFIG2);
34f6e157 456
f48d0f9a 457 if (host->devtype_data->irqpending_quirk && (cmd == NAND_CMD_RESET)) {
a47bfd2e
IC
458 int max_retries = 100;
459 /* Reset completion is indicated by NFC_CONFIG2 */
460 /* being set to 0 */
461 while (max_retries-- > 0) {
1bc99180 462 if (readw(NFC_V1_V2_CONFIG2) == 0) {
a47bfd2e
IC
463 break;
464 }
465 udelay(1);
466 }
467 if (max_retries < 0)
0a32a102 468 pr_debug("%s: RESET failed\n", __func__);
a47bfd2e
IC
469 } else {
470 /* Wait for operation to complete */
471 wait_op_done(host, useirq);
472 }
34f6e157
SH
473}
474
71ec5155
SH
475static void send_addr_v3(struct mxc_nand_host *host, uint16_t addr, int islast)
476{
477 /* fill address */
478 writel(addr, NFC_V3_FLASH_ADDR0);
479
480 /* send out address */
481 writel(NFC_ADDR, NFC_V3_LAUNCH);
482
483 wait_op_done(host, 0);
484}
485
34f6e157
SH
486/* This function sends an address (or partial address) to the
487 * NAND device. The address is used to select the source/destination for
488 * a NAND command. */
5f97304e 489static void send_addr_v1_v2(struct mxc_nand_host *host, uint16_t addr, int islast)
34f6e157 490{
289c0522 491 pr_debug("send_addr(host, 0x%x %d)\n", addr, islast);
34f6e157 492
1bc99180
SH
493 writew(addr, NFC_V1_V2_FLASH_ADDR);
494 writew(NFC_ADDR, NFC_V1_V2_CONFIG2);
34f6e157
SH
495
496 /* Wait for operation to complete */
c110eaf4 497 wait_op_done(host, islast);
34f6e157
SH
498}
499
71ec5155
SH
500static void send_page_v3(struct mtd_info *mtd, unsigned int ops)
501{
502 struct nand_chip *nand_chip = mtd->priv;
503 struct mxc_nand_host *host = nand_chip->priv;
504 uint32_t tmp;
505
506 tmp = readl(NFC_V3_CONFIG1);
507 tmp &= ~(7 << 4);
508 writel(tmp, NFC_V3_CONFIG1);
509
510 /* transfer data from NFC ram to nand */
511 writel(ops, NFC_V3_LAUNCH);
512
513 wait_op_done(host, false);
514}
515
6d38af25
UKK
516static void send_page_v2(struct mtd_info *mtd, unsigned int ops)
517{
518 struct nand_chip *nand_chip = mtd->priv;
519 struct mxc_nand_host *host = nand_chip->priv;
520
521 /* NANDFC buffer 0 is used for page read/write */
522 writew(host->active_cs << 4, NFC_V1_V2_BUF_ADDR);
523
524 writew(ops, NFC_V1_V2_CONFIG2);
525
526 /* Wait for operation to complete */
527 wait_op_done(host, true);
528}
529
530static void send_page_v1(struct mtd_info *mtd, unsigned int ops)
34f6e157 531{
2d69c7fa
SH
532 struct nand_chip *nand_chip = mtd->priv;
533 struct mxc_nand_host *host = nand_chip->priv;
c5d23f1b 534 int bufs, i;
34f6e157 535
6d38af25 536 if (mtd->writesize > 512)
c5d23f1b
SH
537 bufs = 4;
538 else
539 bufs = 1;
34f6e157 540
c5d23f1b 541 for (i = 0; i < bufs; i++) {
34f6e157 542
c5d23f1b 543 /* NANDFC buffer 0 is used for page read/write */
d178e3e8 544 writew((host->active_cs << 4) | i, NFC_V1_V2_BUF_ADDR);
34f6e157 545
1bc99180 546 writew(ops, NFC_V1_V2_CONFIG2);
34f6e157 547
c5d23f1b 548 /* Wait for operation to complete */
c110eaf4 549 wait_op_done(host, true);
34f6e157 550 }
34f6e157
SH
551}
552
71ec5155
SH
553static void send_read_id_v3(struct mxc_nand_host *host)
554{
555 /* Read ID into main buffer */
556 writel(NFC_ID, NFC_V3_LAUNCH);
557
558 wait_op_done(host, true);
559
096bcc23 560 memcpy32_fromio(host->data_buf, host->main_area0, 16);
71ec5155
SH
561}
562
34f6e157 563/* Request the NANDFC to perform a read of the NAND device ID. */
5f97304e 564static void send_read_id_v1_v2(struct mxc_nand_host *host)
34f6e157 565{
34f6e157 566 /* NANDFC buffer 0 is used for device ID output */
d178e3e8 567 writew(host->active_cs << 4, NFC_V1_V2_BUF_ADDR);
34f6e157 568
1bc99180 569 writew(NFC_ID, NFC_V1_V2_CONFIG2);
34f6e157
SH
570
571 /* Wait for operation to complete */
c110eaf4 572 wait_op_done(host, true);
34f6e157 573
096bcc23 574 memcpy32_fromio(host->data_buf, host->main_area0, 16);
34f6e157
SH
575}
576
71ec5155
SH
577static uint16_t get_dev_status_v3(struct mxc_nand_host *host)
578{
579 writew(NFC_STATUS, NFC_V3_LAUNCH);
580 wait_op_done(host, true);
581
582 return readl(NFC_V3_CONFIG1) >> 16;
583}
584
34f6e157
SH
585/* This function requests the NANDFC to perform a read of the
586 * NAND device status and returns the current status. */
5f97304e 587static uint16_t get_dev_status_v1_v2(struct mxc_nand_host *host)
34f6e157 588{
c29c607a 589 void __iomem *main_buf = host->main_area0;
34f6e157 590 uint32_t store;
f06368f7 591 uint16_t ret;
34f6e157 592
d178e3e8 593 writew(host->active_cs << 4, NFC_V1_V2_BUF_ADDR);
34f6e157 594
c29c607a
SH
595 /*
596 * The device status is stored in main_area0. To
597 * prevent corruption of the buffer save the value
598 * and restore it afterwards.
599 */
34f6e157 600 store = readl(main_buf);
34f6e157 601
1bc99180 602 writew(NFC_STATUS, NFC_V1_V2_CONFIG2);
c110eaf4 603 wait_op_done(host, true);
34f6e157 604
34f6e157 605 ret = readw(main_buf);
c29c607a 606
34f6e157
SH
607 writel(store, main_buf);
608
609 return ret;
610}
611
612/* This functions is used by upper layer to checks if device is ready */
613static int mxc_nand_dev_ready(struct mtd_info *mtd)
614{
615 /*
616 * NFC handles R/B internally. Therefore, this function
617 * always returns status as ready.
618 */
619 return 1;
620}
621
622static void mxc_nand_enable_hwecc(struct mtd_info *mtd, int mode)
623{
624 /*
625 * If HW ECC is enabled, we turn it on during init. There is
626 * no need to enable again here.
627 */
628}
629
94f77e50 630static int mxc_nand_correct_data_v1(struct mtd_info *mtd, u_char *dat,
34f6e157
SH
631 u_char *read_ecc, u_char *calc_ecc)
632{
633 struct nand_chip *nand_chip = mtd->priv;
634 struct mxc_nand_host *host = nand_chip->priv;
635
636 /*
637 * 1-Bit errors are automatically corrected in HW. No need for
638 * additional correction. 2-Bit errors cannot be corrected by
639 * HW ECC, so we need to return failure
640 */
6d38af25 641 uint16_t ecc_status = get_ecc_status_v1(host);
34f6e157
SH
642
643 if (((ecc_status & 0x3) == 2) || ((ecc_status >> 2) == 2)) {
289c0522 644 pr_debug("MXC_NAND: HWECC uncorrectable 2-bit ECC error\n");
34f6e157
SH
645 return -1;
646 }
647
648 return 0;
649}
650
94f77e50
SH
651static int mxc_nand_correct_data_v2_v3(struct mtd_info *mtd, u_char *dat,
652 u_char *read_ecc, u_char *calc_ecc)
653{
654 struct nand_chip *nand_chip = mtd->priv;
655 struct mxc_nand_host *host = nand_chip->priv;
656 u32 ecc_stat, err;
657 int no_subpages = 1;
658 int ret = 0;
659 u8 ecc_bit_mask, err_limit;
660
661 ecc_bit_mask = (host->eccsize == 4) ? 0x7 : 0xf;
662 err_limit = (host->eccsize == 4) ? 0x4 : 0x8;
663
664 no_subpages = mtd->writesize >> 9;
665
6d38af25 666 ecc_stat = host->devtype_data->get_ecc_status(host);
94f77e50
SH
667
668 do {
669 err = ecc_stat & ecc_bit_mask;
670 if (err > err_limit) {
671 printk(KERN_WARNING "UnCorrectable RS-ECC Error\n");
672 return -1;
673 } else {
674 ret += err;
675 }
676 ecc_stat >>= 4;
677 } while (--no_subpages);
678
94f77e50
SH
679 pr_debug("%d Symbol Correctable RS-ECC Error\n", ret);
680
681 return ret;
682}
683
34f6e157
SH
684static int mxc_nand_calculate_ecc(struct mtd_info *mtd, const u_char *dat,
685 u_char *ecc_code)
686{
687 return 0;
688}
689
690static u_char mxc_nand_read_byte(struct mtd_info *mtd)
691{
692 struct nand_chip *nand_chip = mtd->priv;
693 struct mxc_nand_host *host = nand_chip->priv;
f8f9608d 694 uint8_t ret;
34f6e157
SH
695
696 /* Check for status request */
697 if (host->status_request)
e4303b25 698 return host->devtype_data->get_dev_status(host) & 0xFF;
34f6e157 699
3f410690
UKK
700 if (nand_chip->options & NAND_BUSWIDTH_16) {
701 /* only take the lower byte of each word */
702 ret = *(uint16_t *)(host->data_buf + host->buf_start);
703
704 host->buf_start += 2;
705 } else {
706 ret = *(uint8_t *)(host->data_buf + host->buf_start);
707 host->buf_start++;
708 }
34f6e157 709
3f410690 710 pr_debug("%s: ret=0x%hhx (start=%u)\n", __func__, ret, host->buf_start);
34f6e157
SH
711 return ret;
712}
713
714static uint16_t mxc_nand_read_word(struct mtd_info *mtd)
715{
716 struct nand_chip *nand_chip = mtd->priv;
717 struct mxc_nand_host *host = nand_chip->priv;
f8f9608d 718 uint16_t ret;
34f6e157 719
f8f9608d
SH
720 ret = *(uint16_t *)(host->data_buf + host->buf_start);
721 host->buf_start += 2;
34f6e157
SH
722
723 return ret;
724}
725
726/* Write data of length len to buffer buf. The data to be
727 * written on NAND Flash is first copied to RAMbuffer. After the Data Input
728 * Operation by the NFC, the data is written to NAND Flash */
729static void mxc_nand_write_buf(struct mtd_info *mtd,
730 const u_char *buf, int len)
731{
732 struct nand_chip *nand_chip = mtd->priv;
733 struct mxc_nand_host *host = nand_chip->priv;
f8f9608d
SH
734 u16 col = host->buf_start;
735 int n = mtd->oobsize + mtd->writesize - col;
34f6e157 736
f8f9608d 737 n = min(n, len);
34f6e157 738
f8f9608d 739 memcpy(host->data_buf + col, buf, n);
34f6e157 740
f8f9608d 741 host->buf_start += n;
34f6e157
SH
742}
743
744/* Read the data buffer from the NAND Flash. To read the data from NAND
745 * Flash first the data output cycle is initiated by the NFC, which copies
746 * the data to RAMbuffer. This data of length len is then copied to buffer buf.
747 */
748static void mxc_nand_read_buf(struct mtd_info *mtd, u_char *buf, int len)
749{
750 struct nand_chip *nand_chip = mtd->priv;
751 struct mxc_nand_host *host = nand_chip->priv;
f8f9608d
SH
752 u16 col = host->buf_start;
753 int n = mtd->oobsize + mtd->writesize - col;
34f6e157 754
f8f9608d 755 n = min(n, len);
34f6e157 756
5d9d9936 757 memcpy(buf, host->data_buf + col, n);
34f6e157 758
5d9d9936 759 host->buf_start += n;
34f6e157
SH
760}
761
34f6e157
SH
762/* This function is used by upper layer for select and
763 * deselect of the NAND chip */
5e05a2d6 764static void mxc_nand_select_chip_v1_v3(struct mtd_info *mtd, int chip)
34f6e157
SH
765{
766 struct nand_chip *nand_chip = mtd->priv;
767 struct mxc_nand_host *host = nand_chip->priv;
768
d178e3e8 769 if (chip == -1) {
34f6e157
SH
770 /* Disable the NFC clock */
771 if (host->clk_act) {
97c3213f 772 clk_disable_unprepare(host->clk);
34f6e157
SH
773 host->clk_act = 0;
774 }
d178e3e8
BS
775 return;
776 }
777
778 if (!host->clk_act) {
34f6e157 779 /* Enable the NFC clock */
97c3213f 780 clk_prepare_enable(host->clk);
d178e3e8
BS
781 host->clk_act = 1;
782 }
5e05a2d6 783}
34f6e157 784
5e05a2d6
UKK
785static void mxc_nand_select_chip_v2(struct mtd_info *mtd, int chip)
786{
787 struct nand_chip *nand_chip = mtd->priv;
788 struct mxc_nand_host *host = nand_chip->priv;
789
790 if (chip == -1) {
791 /* Disable the NFC clock */
792 if (host->clk_act) {
3d059693 793 clk_disable_unprepare(host->clk);
5e05a2d6
UKK
794 host->clk_act = 0;
795 }
796 return;
797 }
34f6e157 798
5e05a2d6
UKK
799 if (!host->clk_act) {
800 /* Enable the NFC clock */
3d059693 801 clk_prepare_enable(host->clk);
5e05a2d6 802 host->clk_act = 1;
34f6e157 803 }
5e05a2d6
UKK
804
805 host->active_cs = chip;
806 writew(host->active_cs << 4, NFC_V1_V2_BUF_ADDR);
34f6e157
SH
807}
808
f8f9608d
SH
809/*
810 * Function to transfer data to/from spare area.
811 */
812static void copy_spare(struct mtd_info *mtd, bool bfrom)
34f6e157 813{
f8f9608d
SH
814 struct nand_chip *this = mtd->priv;
815 struct mxc_nand_host *host = this->priv;
816 u16 i, j;
817 u16 n = mtd->writesize >> 9;
818 u8 *d = host->data_buf + mtd->writesize;
4b6f05e1 819 u8 __iomem *s = host->spare0;
f48d0f9a 820 u16 t = host->devtype_data->spare_len;
f8f9608d
SH
821
822 j = (mtd->oobsize / n >> 1) << 1;
823
824 if (bfrom) {
825 for (i = 0; i < n - 1; i++)
096bcc23 826 memcpy32_fromio(d + i * j, s + i * t, j);
f8f9608d
SH
827
828 /* the last section */
096bcc23 829 memcpy32_fromio(d + i * j, s + i * t, mtd->oobsize - i * j);
f8f9608d
SH
830 } else {
831 for (i = 0; i < n - 1; i++)
096bcc23 832 memcpy32_toio(&s[i * t], &d[i * j], j);
34f6e157 833
f8f9608d 834 /* the last section */
096bcc23 835 memcpy32_toio(&s[i * t], &d[i * j], mtd->oobsize - i * j);
34f6e157 836 }
f8f9608d 837}
34f6e157 838
c4ca3997
UKK
839/*
840 * MXC NANDFC can only perform full page+spare or spare-only read/write. When
841 * the upper layers perform a read/write buf operation, the saved column address
842 * is used to index into the full page. So usually this function is called with
843 * column == 0 (unless no column cycle is needed indicated by column == -1)
844 */
a3e65b64
SH
845static void mxc_do_addr_cycle(struct mtd_info *mtd, int column, int page_addr)
846{
847 struct nand_chip *nand_chip = mtd->priv;
848 struct mxc_nand_host *host = nand_chip->priv;
34f6e157
SH
849
850 /* Write out column address, if necessary */
851 if (column != -1) {
c4ca3997
UKK
852 host->devtype_data->send_addr(host, column & 0xff,
853 page_addr == -1);
2d69c7fa 854 if (mtd->writesize > 512)
34f6e157 855 /* another col addr cycle for 2k page */
c4ca3997
UKK
856 host->devtype_data->send_addr(host,
857 (column >> 8) & 0xff,
858 false);
34f6e157
SH
859 }
860
861 /* Write out page address, if necessary */
862 if (page_addr != -1) {
863 /* paddr_0 - p_addr_7 */
e4303b25 864 host->devtype_data->send_addr(host, (page_addr & 0xff), false);
34f6e157 865
2d69c7fa 866 if (mtd->writesize > 512) {
bd3fd62e
VB
867 if (mtd->size >= 0x10000000) {
868 /* paddr_8 - paddr_15 */
e4303b25
UKK
869 host->devtype_data->send_addr(host,
870 (page_addr >> 8) & 0xff,
871 false);
872 host->devtype_data->send_addr(host,
873 (page_addr >> 16) & 0xff,
874 true);
bd3fd62e
VB
875 } else
876 /* paddr_8 - paddr_15 */
e4303b25
UKK
877 host->devtype_data->send_addr(host,
878 (page_addr >> 8) & 0xff, true);
34f6e157
SH
879 } else {
880 /* One more address cycle for higher density devices */
881 if (mtd->size >= 0x4000000) {
882 /* paddr_8 - paddr_15 */
e4303b25
UKK
883 host->devtype_data->send_addr(host,
884 (page_addr >> 8) & 0xff,
885 false);
886 host->devtype_data->send_addr(host,
887 (page_addr >> 16) & 0xff,
888 true);
34f6e157
SH
889 } else
890 /* paddr_8 - paddr_15 */
e4303b25
UKK
891 host->devtype_data->send_addr(host,
892 (page_addr >> 8) & 0xff, true);
34f6e157
SH
893 }
894 }
a3e65b64
SH
895}
896
6e85dfdc
SH
897/*
898 * v2 and v3 type controllers can do 4bit or 8bit ecc depending
899 * on how much oob the nand chip has. For 8bit ecc we need at least
900 * 26 bytes of oob data per 512 byte block.
901 */
902static int get_eccsize(struct mtd_info *mtd)
903{
904 int oobbytes_per_512 = 0;
905
906 oobbytes_per_512 = mtd->oobsize * 512 / mtd->writesize;
907
908 if (oobbytes_per_512 < 26)
909 return 4;
910 else
911 return 8;
912}
913
6d38af25 914static void preset_v1(struct mtd_info *mtd)
d4840180
IC
915{
916 struct nand_chip *nand_chip = mtd->priv;
917 struct mxc_nand_host *host = nand_chip->priv;
b8db2f51
SH
918 uint16_t config1 = 0;
919
1f42adc8 920 if (nand_chip->ecc.mode == NAND_ECC_HW && mtd->writesize)
b8db2f51
SH
921 config1 |= NFC_V1_V2_CONFIG1_ECC_EN;
922
f48d0f9a 923 if (!host->devtype_data->irqpending_quirk)
6d38af25
UKK
924 config1 |= NFC_V1_V2_CONFIG1_INT_MSK;
925
926 host->eccsize = 1;
927
928 writew(config1, NFC_V1_V2_CONFIG1);
929 /* preset operation */
930
931 /* Unlock the internal RAM Buffer */
932 writew(0x2, NFC_V1_V2_CONFIG);
933
934 /* Blocks to be unlocked */
935 writew(0x0, NFC_V1_UNLOCKSTART_BLKADDR);
936 writew(0xffff, NFC_V1_UNLOCKEND_BLKADDR);
937
938 /* Unlock Block Command for given address range */
939 writew(0x4, NFC_V1_V2_WRPROT);
940}
941
942static void preset_v2(struct mtd_info *mtd)
d4840180
IC
943{
944 struct nand_chip *nand_chip = mtd->priv;
945 struct mxc_nand_host *host = nand_chip->priv;
b8db2f51
SH
946 uint16_t config1 = 0;
947
6d38af25 948 config1 |= NFC_V2_CONFIG1_FP_INT;
b8db2f51 949
f48d0f9a 950 if (!host->devtype_data->irqpending_quirk)
b8db2f51 951 config1 |= NFC_V1_V2_CONFIG1_INT_MSK;
6e85dfdc 952
6d38af25 953 if (mtd->writesize) {
b8db2f51
SH
954 uint16_t pages_per_block = mtd->erasesize / mtd->writesize;
955
1f42adc8
UKK
956 if (nand_chip->ecc.mode == NAND_ECC_HW)
957 config1 |= NFC_V1_V2_CONFIG1_ECC_EN;
958
6e85dfdc
SH
959 host->eccsize = get_eccsize(mtd);
960 if (host->eccsize == 4)
b8db2f51
SH
961 config1 |= NFC_V2_CONFIG1_ECC_MODE_4;
962
963 config1 |= NFC_V2_CONFIG1_PPB(ffs(pages_per_block) - 6);
d4840180 964 } else {
6e85dfdc 965 host->eccsize = 1;
d4840180 966 }
6e85dfdc 967
b8db2f51 968 writew(config1, NFC_V1_V2_CONFIG1);
d4840180
IC
969 /* preset operation */
970
971 /* Unlock the internal RAM Buffer */
1bc99180 972 writew(0x2, NFC_V1_V2_CONFIG);
d4840180
IC
973
974 /* Blocks to be unlocked */
6d38af25
UKK
975 writew(0x0, NFC_V21_UNLOCKSTART_BLKADDR0);
976 writew(0x0, NFC_V21_UNLOCKSTART_BLKADDR1);
977 writew(0x0, NFC_V21_UNLOCKSTART_BLKADDR2);
978 writew(0x0, NFC_V21_UNLOCKSTART_BLKADDR3);
979 writew(0xffff, NFC_V21_UNLOCKEND_BLKADDR0);
980 writew(0xffff, NFC_V21_UNLOCKEND_BLKADDR1);
981 writew(0xffff, NFC_V21_UNLOCKEND_BLKADDR2);
982 writew(0xffff, NFC_V21_UNLOCKEND_BLKADDR3);
d4840180
IC
983
984 /* Unlock Block Command for given address range */
1bc99180 985 writew(0x4, NFC_V1_V2_WRPROT);
d4840180
IC
986}
987
71ec5155
SH
988static void preset_v3(struct mtd_info *mtd)
989{
990 struct nand_chip *chip = mtd->priv;
991 struct mxc_nand_host *host = chip->priv;
992 uint32_t config2, config3;
993 int i, addr_phases;
994
995 writel(NFC_V3_CONFIG1_RBA(0), NFC_V3_CONFIG1);
996 writel(NFC_V3_IPC_CREQ, NFC_V3_IPC);
997
998 /* Unlock the internal RAM Buffer */
999 writel(NFC_V3_WRPROT_BLS_UNLOCK | NFC_V3_WRPROT_UNLOCK,
1000 NFC_V3_WRPROT);
1001
1002 /* Blocks to be unlocked */
1003 for (i = 0; i < NAND_MAX_CHIPS; i++)
1004 writel(0x0 | (0xffff << 16),
1005 NFC_V3_WRPROT_UNLOCK_BLK_ADD0 + (i << 2));
1006
1007 writel(0, NFC_V3_IPC);
1008
1009 config2 = NFC_V3_CONFIG2_ONE_CYCLE |
1010 NFC_V3_CONFIG2_2CMD_PHASES |
1011 NFC_V3_CONFIG2_SPAS(mtd->oobsize >> 1) |
1012 NFC_V3_CONFIG2_ST_CMD(0x70) |
63f1474c 1013 NFC_V3_CONFIG2_INT_MSK |
71ec5155
SH
1014 NFC_V3_CONFIG2_NUM_ADDR_PHASE0;
1015
71ec5155
SH
1016 addr_phases = fls(chip->pagemask) >> 3;
1017
1018 if (mtd->writesize == 2048) {
1019 config2 |= NFC_V3_CONFIG2_PS_2048;
1020 config2 |= NFC_V3_CONFIG2_NUM_ADDR_PHASE1(addr_phases);
1021 } else if (mtd->writesize == 4096) {
1022 config2 |= NFC_V3_CONFIG2_PS_4096;
1023 config2 |= NFC_V3_CONFIG2_NUM_ADDR_PHASE1(addr_phases);
1024 } else {
1025 config2 |= NFC_V3_CONFIG2_PS_512;
1026 config2 |= NFC_V3_CONFIG2_NUM_ADDR_PHASE1(addr_phases - 1);
1027 }
1028
1029 if (mtd->writesize) {
1f42adc8
UKK
1030 if (chip->ecc.mode == NAND_ECC_HW)
1031 config2 |= NFC_V3_CONFIG2_ECC_EN;
1032
71718a8e
SH
1033 config2 |= NFC_V3_CONFIG2_PPB(
1034 ffs(mtd->erasesize / mtd->writesize) - 6,
1035 host->devtype_data->ppb_shift);
71ec5155
SH
1036 host->eccsize = get_eccsize(mtd);
1037 if (host->eccsize == 8)
1038 config2 |= NFC_V3_CONFIG2_ECC_MODE_8;
1039 }
1040
1041 writel(config2, NFC_V3_CONFIG2);
1042
1043 config3 = NFC_V3_CONFIG3_NUM_OF_DEVICES(0) |
1044 NFC_V3_CONFIG3_NO_SDMA |
1045 NFC_V3_CONFIG3_RBB_MODE |
1046 NFC_V3_CONFIG3_SBB(6) | /* Reset default */
1047 NFC_V3_CONFIG3_ADD_OP(0);
1048
1049 if (!(chip->options & NAND_BUSWIDTH_16))
1050 config3 |= NFC_V3_CONFIG3_FW8;
1051
1052 writel(config3, NFC_V3_CONFIG3);
1053
1054 writel(0, NFC_V3_DELAY_LINE);
d4840180
IC
1055}
1056
34f6e157
SH
1057/* Used by the upper layer to write command to NAND Flash for
1058 * different operations to be carried out on NAND Flash */
1059static void mxc_nand_command(struct mtd_info *mtd, unsigned command,
1060 int column, int page_addr)
1061{
1062 struct nand_chip *nand_chip = mtd->priv;
1063 struct mxc_nand_host *host = nand_chip->priv;
34f6e157 1064
289c0522 1065 pr_debug("mxc_nand_command (cmd = 0x%x, col = 0x%x, page = 0x%x)\n",
34f6e157
SH
1066 command, column, page_addr);
1067
1068 /* Reset command state information */
1069 host->status_request = false;
34f6e157 1070
34f6e157 1071 /* Command pre-processing step */
34f6e157 1072 switch (command) {
d4840180 1073 case NAND_CMD_RESET:
e4303b25
UKK
1074 host->devtype_data->preset(mtd);
1075 host->devtype_data->send_cmd(host, command, false);
d4840180 1076 break;
34f6e157 1077
34f6e157 1078 case NAND_CMD_STATUS:
f8f9608d 1079 host->buf_start = 0;
34f6e157 1080 host->status_request = true;
34f6e157 1081
e4303b25 1082 host->devtype_data->send_cmd(host, command, true);
c4ca3997
UKK
1083 WARN_ONCE(column != -1 || page_addr != -1,
1084 "Unexpected column/row value (cmd=%u, col=%d, row=%d)\n",
1085 command, column, page_addr);
89121a6b 1086 mxc_do_addr_cycle(mtd, column, page_addr);
34f6e157
SH
1087 break;
1088
34f6e157 1089 case NAND_CMD_READ0:
34f6e157 1090 case NAND_CMD_READOOB:
89121a6b
SH
1091 if (command == NAND_CMD_READ0)
1092 host->buf_start = column;
1093 else
1094 host->buf_start = column + mtd->writesize;
f8f9608d 1095
5ea32021 1096 command = NAND_CMD_READ0; /* only READ0 is valid */
89121a6b 1097
e4303b25 1098 host->devtype_data->send_cmd(host, command, false);
c4ca3997
UKK
1099 WARN_ONCE(column < 0,
1100 "Unexpected column/row value (cmd=%u, col=%d, row=%d)\n",
1101 command, column, page_addr);
1102 mxc_do_addr_cycle(mtd, 0, page_addr);
89121a6b 1103
2d69c7fa 1104 if (mtd->writesize > 512)
e4303b25
UKK
1105 host->devtype_data->send_cmd(host,
1106 NAND_CMD_READSTART, true);
c5d23f1b 1107
e4303b25 1108 host->devtype_data->send_page(mtd, NFC_OUTPUT);
89121a6b 1109
096bcc23
SH
1110 memcpy32_fromio(host->data_buf, host->main_area0,
1111 mtd->writesize);
89121a6b 1112 copy_spare(mtd, true);
34f6e157
SH
1113 break;
1114
34f6e157 1115 case NAND_CMD_SEQIN:
5ea32021
SH
1116 if (column >= mtd->writesize)
1117 /* call ourself to read a page */
1118 mxc_nand_command(mtd, NAND_CMD_READ0, 0, page_addr);
34f6e157 1119
5ea32021 1120 host->buf_start = column;
89121a6b 1121
e4303b25 1122 host->devtype_data->send_cmd(host, command, false);
c4ca3997
UKK
1123 WARN_ONCE(column < -1,
1124 "Unexpected column/row value (cmd=%u, col=%d, row=%d)\n",
1125 command, column, page_addr);
1126 mxc_do_addr_cycle(mtd, 0, page_addr);
34f6e157
SH
1127 break;
1128
1129 case NAND_CMD_PAGEPROG:
096bcc23 1130 memcpy32_toio(host->main_area0, host->data_buf, mtd->writesize);
f8f9608d 1131 copy_spare(mtd, false);
e4303b25
UKK
1132 host->devtype_data->send_page(mtd, NFC_INPUT);
1133 host->devtype_data->send_cmd(host, command, true);
c4ca3997
UKK
1134 WARN_ONCE(column != -1 || page_addr != -1,
1135 "Unexpected column/row value (cmd=%u, col=%d, row=%d)\n",
1136 command, column, page_addr);
89121a6b 1137 mxc_do_addr_cycle(mtd, column, page_addr);
34f6e157
SH
1138 break;
1139
34f6e157 1140 case NAND_CMD_READID:
e4303b25 1141 host->devtype_data->send_cmd(host, command, true);
89121a6b 1142 mxc_do_addr_cycle(mtd, column, page_addr);
e4303b25 1143 host->devtype_data->send_read_id(host);
c4ca3997 1144 host->buf_start = 0;
34f6e157
SH
1145 break;
1146
89121a6b 1147 case NAND_CMD_ERASE1:
34f6e157 1148 case NAND_CMD_ERASE2:
e4303b25 1149 host->devtype_data->send_cmd(host, command, false);
c4ca3997
UKK
1150 WARN_ONCE(column != -1,
1151 "Unexpected column value (cmd=%u, col=%d)\n",
1152 command, column);
89121a6b
SH
1153 mxc_do_addr_cycle(mtd, column, page_addr);
1154
3d6e81c0
UKK
1155 break;
1156 case NAND_CMD_PARAM:
1157 host->devtype_data->send_cmd(host, command, false);
1158 mxc_do_addr_cycle(mtd, column, page_addr);
1159 host->devtype_data->send_page(mtd, NFC_OUTPUT);
1160 memcpy32_fromio(host->data_buf, host->main_area0, 512);
1161 host->buf_start = 0;
34f6e157
SH
1162 break;
1163 }
1164}
1165
f1372055
SH
1166/*
1167 * The generic flash bbt decriptors overlap with our ecc
1168 * hardware, so define some i.MX specific ones.
1169 */
1170static uint8_t bbt_pattern[] = { 'B', 'b', 't', '0' };
1171static uint8_t mirror_pattern[] = { '1', 't', 'b', 'B' };
1172
1173static struct nand_bbt_descr bbt_main_descr = {
1174 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1175 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1176 .offs = 0,
1177 .len = 4,
1178 .veroffs = 4,
1179 .maxblocks = 4,
1180 .pattern = bbt_pattern,
1181};
1182
1183static struct nand_bbt_descr bbt_mirror_descr = {
1184 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1185 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1186 .offs = 0,
1187 .len = 4,
1188 .veroffs = 4,
1189 .maxblocks = 4,
1190 .pattern = mirror_pattern,
1191};
1192
f48d0f9a 1193/* v1 + irqpending_quirk: i.MX21 */
e4303b25 1194static const struct mxc_nand_devtype_data imx21_nand_devtype_data = {
6d38af25 1195 .preset = preset_v1,
e4303b25
UKK
1196 .send_cmd = send_cmd_v1_v2,
1197 .send_addr = send_addr_v1_v2,
6d38af25 1198 .send_page = send_page_v1,
e4303b25
UKK
1199 .send_read_id = send_read_id_v1_v2,
1200 .get_dev_status = get_dev_status_v1_v2,
1201 .check_int = check_int_v1_v2,
1202 .irq_control = irq_control_v1_v2,
6d38af25 1203 .get_ecc_status = get_ecc_status_v1,
6dcdf99d
UKK
1204 .ecclayout_512 = &nandv1_hw_eccoob_smallpage,
1205 .ecclayout_2k = &nandv1_hw_eccoob_largepage,
1206 .ecclayout_4k = &nandv1_hw_eccoob_smallpage, /* XXX: needs fix */
5e05a2d6 1207 .select_chip = mxc_nand_select_chip_v1_v3,
69d023be 1208 .correct_data = mxc_nand_correct_data_v1,
f48d0f9a
UKK
1209 .irqpending_quirk = 1,
1210 .needs_ip = 0,
1211 .regs_offset = 0xe00,
1212 .spare0_offset = 0x800,
1213 .spare_len = 16,
1214 .eccbytes = 3,
1215 .eccsize = 1,
1216};
1217
1218/* v1 + !irqpending_quirk: i.MX27, i.MX31 */
1219static const struct mxc_nand_devtype_data imx27_nand_devtype_data = {
1220 .preset = preset_v1,
1221 .send_cmd = send_cmd_v1_v2,
1222 .send_addr = send_addr_v1_v2,
1223 .send_page = send_page_v1,
1224 .send_read_id = send_read_id_v1_v2,
1225 .get_dev_status = get_dev_status_v1_v2,
1226 .check_int = check_int_v1_v2,
1227 .irq_control = irq_control_v1_v2,
1228 .get_ecc_status = get_ecc_status_v1,
1229 .ecclayout_512 = &nandv1_hw_eccoob_smallpage,
1230 .ecclayout_2k = &nandv1_hw_eccoob_largepage,
1231 .ecclayout_4k = &nandv1_hw_eccoob_smallpage, /* XXX: needs fix */
1232 .select_chip = mxc_nand_select_chip_v1_v3,
1233 .correct_data = mxc_nand_correct_data_v1,
1234 .irqpending_quirk = 0,
1235 .needs_ip = 0,
1236 .regs_offset = 0xe00,
1237 .spare0_offset = 0x800,
1238 .axi_offset = 0,
1239 .spare_len = 16,
1240 .eccbytes = 3,
1241 .eccsize = 1,
e4303b25
UKK
1242};
1243
1244/* v21: i.MX25, i.MX35 */
1245static const struct mxc_nand_devtype_data imx25_nand_devtype_data = {
6d38af25 1246 .preset = preset_v2,
e4303b25
UKK
1247 .send_cmd = send_cmd_v1_v2,
1248 .send_addr = send_addr_v1_v2,
6d38af25 1249 .send_page = send_page_v2,
e4303b25
UKK
1250 .send_read_id = send_read_id_v1_v2,
1251 .get_dev_status = get_dev_status_v1_v2,
1252 .check_int = check_int_v1_v2,
1253 .irq_control = irq_control_v1_v2,
6d38af25 1254 .get_ecc_status = get_ecc_status_v2,
6dcdf99d
UKK
1255 .ecclayout_512 = &nandv2_hw_eccoob_smallpage,
1256 .ecclayout_2k = &nandv2_hw_eccoob_largepage,
1257 .ecclayout_4k = &nandv2_hw_eccoob_4k,
5e05a2d6 1258 .select_chip = mxc_nand_select_chip_v2,
69d023be 1259 .correct_data = mxc_nand_correct_data_v2_v3,
f48d0f9a
UKK
1260 .irqpending_quirk = 0,
1261 .needs_ip = 0,
1262 .regs_offset = 0x1e00,
1263 .spare0_offset = 0x1000,
1264 .axi_offset = 0,
1265 .spare_len = 64,
1266 .eccbytes = 9,
1267 .eccsize = 0,
e4303b25
UKK
1268};
1269
71718a8e 1270/* v3.2a: i.MX51 */
e4303b25
UKK
1271static const struct mxc_nand_devtype_data imx51_nand_devtype_data = {
1272 .preset = preset_v3,
1273 .send_cmd = send_cmd_v3,
1274 .send_addr = send_addr_v3,
1275 .send_page = send_page_v3,
1276 .send_read_id = send_read_id_v3,
1277 .get_dev_status = get_dev_status_v3,
1278 .check_int = check_int_v3,
1279 .irq_control = irq_control_v3,
6d38af25 1280 .get_ecc_status = get_ecc_status_v3,
6dcdf99d
UKK
1281 .ecclayout_512 = &nandv2_hw_eccoob_smallpage,
1282 .ecclayout_2k = &nandv2_hw_eccoob_largepage,
1283 .ecclayout_4k = &nandv2_hw_eccoob_smallpage, /* XXX: needs fix */
5e05a2d6 1284 .select_chip = mxc_nand_select_chip_v1_v3,
69d023be 1285 .correct_data = mxc_nand_correct_data_v2_v3,
f48d0f9a
UKK
1286 .irqpending_quirk = 0,
1287 .needs_ip = 1,
1288 .regs_offset = 0,
1289 .spare0_offset = 0x1000,
1290 .axi_offset = 0x1e00,
1291 .spare_len = 64,
1292 .eccbytes = 0,
1293 .eccsize = 0,
71718a8e
SH
1294 .ppb_shift = 7,
1295};
1296
1297/* v3.2b: i.MX53 */
1298static const struct mxc_nand_devtype_data imx53_nand_devtype_data = {
1299 .preset = preset_v3,
1300 .send_cmd = send_cmd_v3,
1301 .send_addr = send_addr_v3,
1302 .send_page = send_page_v3,
1303 .send_read_id = send_read_id_v3,
1304 .get_dev_status = get_dev_status_v3,
1305 .check_int = check_int_v3,
1306 .irq_control = irq_control_v3,
1307 .get_ecc_status = get_ecc_status_v3,
1308 .ecclayout_512 = &nandv2_hw_eccoob_smallpage,
1309 .ecclayout_2k = &nandv2_hw_eccoob_largepage,
1310 .ecclayout_4k = &nandv2_hw_eccoob_smallpage, /* XXX: needs fix */
1311 .select_chip = mxc_nand_select_chip_v1_v3,
1312 .correct_data = mxc_nand_correct_data_v2_v3,
1313 .irqpending_quirk = 0,
1314 .needs_ip = 1,
1315 .regs_offset = 0,
1316 .spare0_offset = 0x1000,
1317 .axi_offset = 0x1e00,
1318 .spare_len = 64,
1319 .eccbytes = 0,
1320 .eccsize = 0,
1321 .ppb_shift = 8,
e4303b25
UKK
1322};
1323
4d62435f
SG
1324static inline int is_imx21_nfc(struct mxc_nand_host *host)
1325{
1326 return host->devtype_data == &imx21_nand_devtype_data;
1327}
1328
1329static inline int is_imx27_nfc(struct mxc_nand_host *host)
1330{
1331 return host->devtype_data == &imx27_nand_devtype_data;
1332}
1333
1334static inline int is_imx25_nfc(struct mxc_nand_host *host)
1335{
1336 return host->devtype_data == &imx25_nand_devtype_data;
1337}
1338
1339static inline int is_imx51_nfc(struct mxc_nand_host *host)
1340{
1341 return host->devtype_data == &imx51_nand_devtype_data;
1342}
1343
1344static inline int is_imx53_nfc(struct mxc_nand_host *host)
1345{
1346 return host->devtype_data == &imx53_nand_devtype_data;
1347}
1348
1349static struct platform_device_id mxcnd_devtype[] = {
1350 {
1351 .name = "imx21-nand",
1352 .driver_data = (kernel_ulong_t) &imx21_nand_devtype_data,
1353 }, {
1354 .name = "imx27-nand",
1355 .driver_data = (kernel_ulong_t) &imx27_nand_devtype_data,
1356 }, {
1357 .name = "imx25-nand",
1358 .driver_data = (kernel_ulong_t) &imx25_nand_devtype_data,
1359 }, {
1360 .name = "imx51-nand",
1361 .driver_data = (kernel_ulong_t) &imx51_nand_devtype_data,
1362 }, {
1363 .name = "imx53-nand",
1364 .driver_data = (kernel_ulong_t) &imx53_nand_devtype_data,
1365 }, {
1366 /* sentinel */
1367 }
1368};
1369MODULE_DEVICE_TABLE(platform, mxcnd_devtype);
1370
6436356b
UKK
1371#ifdef CONFIG_OF_MTD
1372static const struct of_device_id mxcnd_dt_ids[] = {
1373 {
1374 .compatible = "fsl,imx21-nand",
1375 .data = &imx21_nand_devtype_data,
1376 }, {
1377 .compatible = "fsl,imx27-nand",
1378 .data = &imx27_nand_devtype_data,
1379 }, {
1380 .compatible = "fsl,imx25-nand",
1381 .data = &imx25_nand_devtype_data,
1382 }, {
1383 .compatible = "fsl,imx51-nand",
1384 .data = &imx51_nand_devtype_data,
71718a8e
SH
1385 }, {
1386 .compatible = "fsl,imx53-nand",
1387 .data = &imx53_nand_devtype_data,
6436356b
UKK
1388 },
1389 { /* sentinel */ }
1390};
1391
1392static int __init mxcnd_probe_dt(struct mxc_nand_host *host)
1393{
1394 struct device_node *np = host->dev->of_node;
1395 struct mxc_nand_platform_data *pdata = &host->pdata;
1396 const struct of_device_id *of_id =
1397 of_match_device(mxcnd_dt_ids, host->dev);
1398 int buswidth;
1399
1400 if (!np)
1401 return 1;
1402
1403 if (of_get_nand_ecc_mode(np) >= 0)
1404 pdata->hw_ecc = 1;
1405
1406 pdata->flash_bbt = of_get_nand_on_flash_bbt(np);
1407
1408 buswidth = of_get_nand_bus_width(np);
1409 if (buswidth < 0)
1410 return buswidth;
1411
1412 pdata->width = buswidth / 8;
1413
1414 host->devtype_data = of_id->data;
1415
1416 return 0;
1417}
1418#else
1419static int __init mxcnd_probe_dt(struct mxc_nand_host *host)
1420{
1421 return 1;
1422}
1423#endif
1424
06f25510 1425static int mxcnd_probe(struct platform_device *pdev)
34f6e157
SH
1426{
1427 struct nand_chip *this;
1428 struct mtd_info *mtd;
34f6e157
SH
1429 struct mxc_nand_host *host;
1430 struct resource *res;
d4ed8f12 1431 int err = 0;
34f6e157
SH
1432
1433 /* Allocate memory for MTD device structure and private data */
a5900554
HS
1434 host = devm_kzalloc(&pdev->dev, sizeof(struct mxc_nand_host),
1435 GFP_KERNEL);
34f6e157
SH
1436 if (!host)
1437 return -ENOMEM;
1438
a5900554
HS
1439 /* allocate a temporary buffer for the nand_scan_ident() */
1440 host->data_buf = devm_kzalloc(&pdev->dev, PAGE_SIZE, GFP_KERNEL);
1441 if (!host->data_buf)
1442 return -ENOMEM;
f8f9608d 1443
34f6e157
SH
1444 host->dev = &pdev->dev;
1445 /* structures must be linked */
1446 this = &host->nand;
1447 mtd = &host->mtd;
1448 mtd->priv = this;
1449 mtd->owner = THIS_MODULE;
87f39f04 1450 mtd->dev.parent = &pdev->dev;
1fbff0a6 1451 mtd->name = DRIVER_NAME;
34f6e157
SH
1452
1453 /* 50 us command delay time */
1454 this->chip_delay = 5;
1455
1456 this->priv = host;
1457 this->dev_ready = mxc_nand_dev_ready;
1458 this->cmdfunc = mxc_nand_command;
34f6e157
SH
1459 this->read_byte = mxc_nand_read_byte;
1460 this->read_word = mxc_nand_read_word;
1461 this->write_buf = mxc_nand_write_buf;
1462 this->read_buf = mxc_nand_read_buf;
34f6e157 1463
24b82d3c 1464 host->clk = devm_clk_get(&pdev->dev, NULL);
e4a09cbf
SH
1465 if (IS_ERR(host->clk))
1466 return PTR_ERR(host->clk);
34f6e157 1467
71885b65 1468 err = mxcnd_probe_dt(host);
4d62435f 1469 if (err > 0) {
453810b7
JH
1470 struct mxc_nand_platform_data *pdata =
1471 dev_get_platdata(&pdev->dev);
4d62435f
SG
1472 if (pdata) {
1473 host->pdata = *pdata;
1474 host->devtype_data = (struct mxc_nand_devtype_data *)
1475 pdev->id_entry->driver_data;
1476 } else {
1477 err = -ENODEV;
1478 }
1479 }
71885b65
SH
1480 if (err < 0)
1481 return err;
1482
1483 if (host->devtype_data->needs_ip) {
1484 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
b0de774c
TR
1485 host->regs_ip = devm_ioremap_resource(&pdev->dev, res);
1486 if (IS_ERR(host->regs_ip))
1487 return PTR_ERR(host->regs_ip);
71885b65
SH
1488
1489 res = platform_get_resource(pdev, IORESOURCE_MEM, 1);
1490 } else {
1491 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
1492 }
1493
b0de774c
TR
1494 host->base = devm_ioremap_resource(&pdev->dev, res);
1495 if (IS_ERR(host->base))
1496 return PTR_ERR(host->base);
34f6e157 1497
c6de7e1b 1498 host->main_area0 = host->base;
9467114e 1499
f48d0f9a
UKK
1500 if (host->devtype_data->regs_offset)
1501 host->regs = host->base + host->devtype_data->regs_offset;
1502 host->spare0 = host->base + host->devtype_data->spare0_offset;
1503 if (host->devtype_data->axi_offset)
1504 host->regs_axi = host->base + host->devtype_data->axi_offset;
1505
1506 this->ecc.bytes = host->devtype_data->eccbytes;
1507 host->eccsize = host->devtype_data->eccsize;
1508
1509 this->select_chip = host->devtype_data->select_chip;
1510 this->ecc.size = 512;
1511 this->ecc.layout = host->devtype_data->ecclayout_512;
1512
6436356b 1513 if (host->pdata.hw_ecc) {
34f6e157
SH
1514 this->ecc.calculate = mxc_nand_calculate_ecc;
1515 this->ecc.hwctl = mxc_nand_enable_hwecc;
69d023be 1516 this->ecc.correct = host->devtype_data->correct_data;
34f6e157 1517 this->ecc.mode = NAND_ECC_HW;
34f6e157 1518 } else {
34f6e157 1519 this->ecc.mode = NAND_ECC_SOFT;
34f6e157
SH
1520 }
1521
6436356b
UKK
1522 /* NAND bus width determines access functions used by upper layer */
1523 if (host->pdata.width == 2)
34f6e157 1524 this->options |= NAND_BUSWIDTH_16;
34f6e157 1525
6436356b 1526 if (host->pdata.flash_bbt) {
f1372055
SH
1527 this->bbt_td = &bbt_main_descr;
1528 this->bbt_md = &bbt_mirror_descr;
1529 /* update flash based bbt */
bb9ebd4e 1530 this->bbt_options |= NAND_BBT_USE_FLASH;
34f6e157
SH
1531 }
1532
63f1474c 1533 init_completion(&host->op_completion);
d4840180
IC
1534
1535 host->irq = platform_get_irq(pdev, 0);
26fbf48b
FE
1536 if (host->irq < 0)
1537 return host->irq;
d4840180 1538
63f1474c 1539 /*
e4303b25
UKK
1540 * Use host->devtype_data->irq_control() here instead of irq_control()
1541 * because we must not disable_irq_nosync without having requested the
1542 * irq.
63f1474c 1543 */
e4303b25 1544 host->devtype_data->irq_control(host, 0);
63f1474c 1545
e4a09cbf 1546 err = devm_request_irq(&pdev->dev, host->irq, mxc_nfc_irq,
b1eb234f 1547 0, DRIVER_NAME, host);
d4840180 1548 if (err)
e4a09cbf
SH
1549 return err;
1550
dcedf628
FE
1551 err = clk_prepare_enable(host->clk);
1552 if (err)
1553 return err;
e4a09cbf 1554 host->clk_act = 1;
d4840180 1555
63f1474c 1556 /*
8556958a
UKK
1557 * Now that we "own" the interrupt make sure the interrupt mask bit is
1558 * cleared on i.MX21. Otherwise we can't read the interrupt status bit
1559 * on this machine.
63f1474c 1560 */
f48d0f9a 1561 if (host->devtype_data->irqpending_quirk) {
8556958a 1562 disable_irq_nosync(host->irq);
e4303b25 1563 host->devtype_data->irq_control(host, 1);
8556958a 1564 }
63f1474c 1565
bd3fd62e 1566 /* first scan to find the device and get the page size */
4d62435f 1567 if (nand_scan_ident(mtd, is_imx25_nfc(host) ? 4 : 1, NULL)) {
bd3fd62e
VB
1568 err = -ENXIO;
1569 goto escan;
1570 }
34f6e157 1571
a5900554
HS
1572 /* allocate the right size buffer now */
1573 devm_kfree(&pdev->dev, (void *)host->data_buf);
1574 host->data_buf = devm_kzalloc(&pdev->dev, mtd->writesize + mtd->oobsize,
1575 GFP_KERNEL);
1576 if (!host->data_buf) {
1577 err = -ENOMEM;
1578 goto escan;
1579 }
1580
6e85dfdc 1581 /* Call preset again, with correct writesize this time */
e4303b25 1582 host->devtype_data->preset(mtd);
6e85dfdc 1583
2d69c7fa 1584 if (mtd->writesize == 2048)
6dcdf99d
UKK
1585 this->ecc.layout = host->devtype_data->ecclayout_2k;
1586 else if (mtd->writesize == 4096)
1587 this->ecc.layout = host->devtype_data->ecclayout_4k;
34f6e157 1588
6a918bad 1589 if (this->ecc.mode == NAND_ECC_HW) {
4d62435f 1590 if (is_imx21_nfc(host) || is_imx27_nfc(host))
6a918bad
MD
1591 this->ecc.strength = 1;
1592 else
1593 this->ecc.strength = (host->eccsize == 4) ? 4 : 8;
1594 }
1595
4a43faf5
SH
1596 /* second phase scan */
1597 if (nand_scan_tail(mtd)) {
1598 err = -ENXIO;
1599 goto escan;
1600 }
1601
34f6e157 1602 /* Register the partitions */
6436356b
UKK
1603 mtd_device_parse_register(mtd, part_probes,
1604 &(struct mtd_part_parser_data){
1605 .of_node = pdev->dev.of_node,
1606 },
1607 host->pdata.parts,
1608 host->pdata.nr_parts);
34f6e157
SH
1609
1610 platform_set_drvdata(pdev, host);
1611
1612 return 0;
1613
1614escan:
c10d8ee3
LW
1615 if (host->clk_act)
1616 clk_disable_unprepare(host->clk);
34f6e157
SH
1617
1618 return err;
1619}
1620
810b7e06 1621static int mxcnd_remove(struct platform_device *pdev)
34f6e157
SH
1622{
1623 struct mxc_nand_host *host = platform_get_drvdata(pdev);
1624
34f6e157 1625 nand_release(&host->mtd);
8bfd4f7f
WY
1626 if (host->clk_act)
1627 clk_disable_unprepare(host->clk);
34f6e157
SH
1628
1629 return 0;
1630}
1631
34f6e157
SH
1632static struct platform_driver mxcnd_driver = {
1633 .driver = {
1634 .name = DRIVER_NAME,
6436356b 1635 .of_match_table = of_match_ptr(mxcnd_dt_ids),
04dd0d3a 1636 },
4d62435f 1637 .id_table = mxcnd_devtype,
ddf16d62 1638 .probe = mxcnd_probe,
5153b88c 1639 .remove = mxcnd_remove,
34f6e157 1640};
ddf16d62 1641module_platform_driver(mxcnd_driver);
34f6e157
SH
1642
1643MODULE_AUTHOR("Freescale Semiconductor, Inc.");
1644MODULE_DESCRIPTION("MXC NAND MTD driver");
1645MODULE_LICENSE("GPL");
This page took 0.400449 seconds and 5 git commands to generate.