1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Probing flash chips with QINFO records.
4*4882a593Smuzhiyun * (C) 2008 Korolev Alexey <akorolev@infradead.org>
5*4882a593Smuzhiyun * (C) 2008 Vasiliy Leonenko <vasiliy.leonenko@gmail.com>
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun #include <linux/module.h>
8*4882a593Smuzhiyun #include <linux/types.h>
9*4882a593Smuzhiyun #include <linux/kernel.h>
10*4882a593Smuzhiyun #include <linux/init.h>
11*4882a593Smuzhiyun #include <linux/errno.h>
12*4882a593Smuzhiyun #include <linux/slab.h>
13*4882a593Smuzhiyun #include <linux/interrupt.h>
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun #include <linux/mtd/xip.h>
16*4882a593Smuzhiyun #include <linux/mtd/map.h>
17*4882a593Smuzhiyun #include <linux/mtd/pfow.h>
18*4882a593Smuzhiyun #include <linux/mtd/qinfo.h>
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun static int lpddr_chip_setup(struct map_info *map, struct lpddr_private *lpddr);
21*4882a593Smuzhiyun struct mtd_info *lpddr_probe(struct map_info *map);
22*4882a593Smuzhiyun static struct lpddr_private *lpddr_probe_chip(struct map_info *map);
23*4882a593Smuzhiyun static int lpddr_pfow_present(struct map_info *map,
24*4882a593Smuzhiyun struct lpddr_private *lpddr);
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun static struct qinfo_query_info qinfo_array[] = {
27*4882a593Smuzhiyun /* General device info */
28*4882a593Smuzhiyun {0, 0, "DevSizeShift", "Device size 2^n bytes"},
29*4882a593Smuzhiyun {0, 3, "BufSizeShift", "Program buffer size 2^n bytes"},
30*4882a593Smuzhiyun /* Erase block information */
31*4882a593Smuzhiyun {1, 1, "TotalBlocksNum", "Total number of blocks"},
32*4882a593Smuzhiyun {1, 2, "UniformBlockSizeShift", "Uniform block size 2^n bytes"},
33*4882a593Smuzhiyun /* Partition information */
34*4882a593Smuzhiyun {2, 1, "HWPartsNum", "Number of hardware partitions"},
35*4882a593Smuzhiyun /* Optional features */
36*4882a593Smuzhiyun {5, 1, "SuspEraseSupp", "Suspend erase supported"},
37*4882a593Smuzhiyun /* Operation typical time */
38*4882a593Smuzhiyun {10, 0, "SingleWordProgTime", "Single word program 2^n u-sec"},
39*4882a593Smuzhiyun {10, 1, "ProgBufferTime", "Program buffer write 2^n u-sec"},
40*4882a593Smuzhiyun {10, 2, "BlockEraseTime", "Block erase 2^n m-sec"},
41*4882a593Smuzhiyun {10, 3, "FullChipEraseTime", "Full chip erase 2^n m-sec"},
42*4882a593Smuzhiyun };
43*4882a593Smuzhiyun
lpddr_get_qinforec_pos(struct map_info * map,char * id_str)44*4882a593Smuzhiyun static long lpddr_get_qinforec_pos(struct map_info *map, char *id_str)
45*4882a593Smuzhiyun {
46*4882a593Smuzhiyun int qinfo_lines = ARRAY_SIZE(qinfo_array);
47*4882a593Smuzhiyun int i;
48*4882a593Smuzhiyun int bankwidth = map_bankwidth(map) * 8;
49*4882a593Smuzhiyun int major, minor;
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun for (i = 0; i < qinfo_lines; i++) {
52*4882a593Smuzhiyun if (strcmp(id_str, qinfo_array[i].id_str) == 0) {
53*4882a593Smuzhiyun major = qinfo_array[i].major & ((1 << bankwidth) - 1);
54*4882a593Smuzhiyun minor = qinfo_array[i].minor & ((1 << bankwidth) - 1);
55*4882a593Smuzhiyun return minor | (major << bankwidth);
56*4882a593Smuzhiyun }
57*4882a593Smuzhiyun }
58*4882a593Smuzhiyun printk(KERN_ERR"%s qinfo id string is wrong! \n", map->name);
59*4882a593Smuzhiyun BUG();
60*4882a593Smuzhiyun return -1;
61*4882a593Smuzhiyun }
62*4882a593Smuzhiyun
lpddr_info_query(struct map_info * map,char * id_str)63*4882a593Smuzhiyun static uint16_t lpddr_info_query(struct map_info *map, char *id_str)
64*4882a593Smuzhiyun {
65*4882a593Smuzhiyun unsigned int dsr, val;
66*4882a593Smuzhiyun int bits_per_chip = map_bankwidth(map) * 8;
67*4882a593Smuzhiyun unsigned long adr = lpddr_get_qinforec_pos(map, id_str);
68*4882a593Smuzhiyun int attempts = 20;
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun /* Write a request for the PFOW record */
71*4882a593Smuzhiyun map_write(map, CMD(LPDDR_INFO_QUERY),
72*4882a593Smuzhiyun map->pfow_base + PFOW_COMMAND_CODE);
73*4882a593Smuzhiyun map_write(map, CMD(adr & ((1 << bits_per_chip) - 1)),
74*4882a593Smuzhiyun map->pfow_base + PFOW_COMMAND_ADDRESS_L);
75*4882a593Smuzhiyun map_write(map, CMD(adr >> bits_per_chip),
76*4882a593Smuzhiyun map->pfow_base + PFOW_COMMAND_ADDRESS_H);
77*4882a593Smuzhiyun map_write(map, CMD(LPDDR_START_EXECUTION),
78*4882a593Smuzhiyun map->pfow_base + PFOW_COMMAND_EXECUTE);
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun while ((attempts--) > 0) {
81*4882a593Smuzhiyun dsr = CMDVAL(map_read(map, map->pfow_base + PFOW_DSR));
82*4882a593Smuzhiyun if (dsr & DSR_READY_STATUS)
83*4882a593Smuzhiyun break;
84*4882a593Smuzhiyun udelay(10);
85*4882a593Smuzhiyun }
86*4882a593Smuzhiyun
87*4882a593Smuzhiyun val = CMDVAL(map_read(map, map->pfow_base + PFOW_COMMAND_DATA));
88*4882a593Smuzhiyun return val;
89*4882a593Smuzhiyun }
90*4882a593Smuzhiyun
lpddr_pfow_present(struct map_info * map,struct lpddr_private * lpddr)91*4882a593Smuzhiyun static int lpddr_pfow_present(struct map_info *map, struct lpddr_private *lpddr)
92*4882a593Smuzhiyun {
93*4882a593Smuzhiyun map_word pfow_val[4];
94*4882a593Smuzhiyun
95*4882a593Smuzhiyun /* Check identification string */
96*4882a593Smuzhiyun pfow_val[0] = map_read(map, map->pfow_base + PFOW_QUERY_STRING_P);
97*4882a593Smuzhiyun pfow_val[1] = map_read(map, map->pfow_base + PFOW_QUERY_STRING_F);
98*4882a593Smuzhiyun pfow_val[2] = map_read(map, map->pfow_base + PFOW_QUERY_STRING_O);
99*4882a593Smuzhiyun pfow_val[3] = map_read(map, map->pfow_base + PFOW_QUERY_STRING_W);
100*4882a593Smuzhiyun
101*4882a593Smuzhiyun if (!map_word_equal(map, CMD('P'), pfow_val[0]))
102*4882a593Smuzhiyun goto out;
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun if (!map_word_equal(map, CMD('F'), pfow_val[1]))
105*4882a593Smuzhiyun goto out;
106*4882a593Smuzhiyun
107*4882a593Smuzhiyun if (!map_word_equal(map, CMD('O'), pfow_val[2]))
108*4882a593Smuzhiyun goto out;
109*4882a593Smuzhiyun
110*4882a593Smuzhiyun if (!map_word_equal(map, CMD('W'), pfow_val[3]))
111*4882a593Smuzhiyun goto out;
112*4882a593Smuzhiyun
113*4882a593Smuzhiyun return 1; /* "PFOW" is found */
114*4882a593Smuzhiyun out:
115*4882a593Smuzhiyun printk(KERN_WARNING"%s: PFOW string at 0x%lx is not found \n",
116*4882a593Smuzhiyun map->name, map->pfow_base);
117*4882a593Smuzhiyun return 0;
118*4882a593Smuzhiyun }
119*4882a593Smuzhiyun
lpddr_chip_setup(struct map_info * map,struct lpddr_private * lpddr)120*4882a593Smuzhiyun static int lpddr_chip_setup(struct map_info *map, struct lpddr_private *lpddr)
121*4882a593Smuzhiyun {
122*4882a593Smuzhiyun
123*4882a593Smuzhiyun lpddr->qinfo = kzalloc(sizeof(struct qinfo_chip), GFP_KERNEL);
124*4882a593Smuzhiyun if (!lpddr->qinfo)
125*4882a593Smuzhiyun return 0;
126*4882a593Smuzhiyun
127*4882a593Smuzhiyun /* Get the ManuID */
128*4882a593Smuzhiyun lpddr->ManufactId = CMDVAL(map_read(map, map->pfow_base + PFOW_MANUFACTURER_ID));
129*4882a593Smuzhiyun /* Get the DeviceID */
130*4882a593Smuzhiyun lpddr->DevId = CMDVAL(map_read(map, map->pfow_base + PFOW_DEVICE_ID));
131*4882a593Smuzhiyun /* read parameters from chip qinfo table */
132*4882a593Smuzhiyun lpddr->qinfo->DevSizeShift = lpddr_info_query(map, "DevSizeShift");
133*4882a593Smuzhiyun lpddr->qinfo->TotalBlocksNum = lpddr_info_query(map, "TotalBlocksNum");
134*4882a593Smuzhiyun lpddr->qinfo->BufSizeShift = lpddr_info_query(map, "BufSizeShift");
135*4882a593Smuzhiyun lpddr->qinfo->HWPartsNum = lpddr_info_query(map, "HWPartsNum");
136*4882a593Smuzhiyun lpddr->qinfo->UniformBlockSizeShift =
137*4882a593Smuzhiyun lpddr_info_query(map, "UniformBlockSizeShift");
138*4882a593Smuzhiyun lpddr->qinfo->SuspEraseSupp = lpddr_info_query(map, "SuspEraseSupp");
139*4882a593Smuzhiyun lpddr->qinfo->SingleWordProgTime =
140*4882a593Smuzhiyun lpddr_info_query(map, "SingleWordProgTime");
141*4882a593Smuzhiyun lpddr->qinfo->ProgBufferTime = lpddr_info_query(map, "ProgBufferTime");
142*4882a593Smuzhiyun lpddr->qinfo->BlockEraseTime = lpddr_info_query(map, "BlockEraseTime");
143*4882a593Smuzhiyun return 1;
144*4882a593Smuzhiyun }
lpddr_probe_chip(struct map_info * map)145*4882a593Smuzhiyun static struct lpddr_private *lpddr_probe_chip(struct map_info *map)
146*4882a593Smuzhiyun {
147*4882a593Smuzhiyun struct lpddr_private lpddr;
148*4882a593Smuzhiyun struct lpddr_private *retlpddr;
149*4882a593Smuzhiyun int numvirtchips;
150*4882a593Smuzhiyun
151*4882a593Smuzhiyun
152*4882a593Smuzhiyun if ((map->pfow_base + 0x1000) >= map->size) {
153*4882a593Smuzhiyun printk(KERN_NOTICE"%s Probe at base (0x%08lx) past the end of"
154*4882a593Smuzhiyun "the map(0x%08lx)\n", map->name,
155*4882a593Smuzhiyun (unsigned long)map->pfow_base, map->size - 1);
156*4882a593Smuzhiyun return NULL;
157*4882a593Smuzhiyun }
158*4882a593Smuzhiyun memset(&lpddr, 0, sizeof(struct lpddr_private));
159*4882a593Smuzhiyun if (!lpddr_pfow_present(map, &lpddr))
160*4882a593Smuzhiyun return NULL;
161*4882a593Smuzhiyun
162*4882a593Smuzhiyun if (!lpddr_chip_setup(map, &lpddr))
163*4882a593Smuzhiyun return NULL;
164*4882a593Smuzhiyun
165*4882a593Smuzhiyun /* Ok so we found a chip */
166*4882a593Smuzhiyun lpddr.chipshift = lpddr.qinfo->DevSizeShift;
167*4882a593Smuzhiyun lpddr.numchips = 1;
168*4882a593Smuzhiyun
169*4882a593Smuzhiyun numvirtchips = lpddr.numchips * lpddr.qinfo->HWPartsNum;
170*4882a593Smuzhiyun retlpddr = kzalloc(struct_size(retlpddr, chips, numvirtchips),
171*4882a593Smuzhiyun GFP_KERNEL);
172*4882a593Smuzhiyun if (!retlpddr)
173*4882a593Smuzhiyun return NULL;
174*4882a593Smuzhiyun
175*4882a593Smuzhiyun memcpy(retlpddr, &lpddr, sizeof(struct lpddr_private));
176*4882a593Smuzhiyun
177*4882a593Smuzhiyun retlpddr->numchips = numvirtchips;
178*4882a593Smuzhiyun retlpddr->chipshift = retlpddr->qinfo->DevSizeShift -
179*4882a593Smuzhiyun __ffs(retlpddr->qinfo->HWPartsNum);
180*4882a593Smuzhiyun
181*4882a593Smuzhiyun return retlpddr;
182*4882a593Smuzhiyun }
183*4882a593Smuzhiyun
lpddr_probe(struct map_info * map)184*4882a593Smuzhiyun struct mtd_info *lpddr_probe(struct map_info *map)
185*4882a593Smuzhiyun {
186*4882a593Smuzhiyun struct mtd_info *mtd = NULL;
187*4882a593Smuzhiyun struct lpddr_private *lpddr;
188*4882a593Smuzhiyun
189*4882a593Smuzhiyun /* First probe the map to see if we havecan open PFOW here */
190*4882a593Smuzhiyun lpddr = lpddr_probe_chip(map);
191*4882a593Smuzhiyun if (!lpddr)
192*4882a593Smuzhiyun return NULL;
193*4882a593Smuzhiyun
194*4882a593Smuzhiyun map->fldrv_priv = lpddr;
195*4882a593Smuzhiyun mtd = lpddr_cmdset(map);
196*4882a593Smuzhiyun if (mtd) {
197*4882a593Smuzhiyun if (mtd->size > map->size) {
198*4882a593Smuzhiyun printk(KERN_WARNING "Reducing visibility of %ldKiB chip"
199*4882a593Smuzhiyun "to %ldKiB\n", (unsigned long)mtd->size >> 10,
200*4882a593Smuzhiyun (unsigned long)map->size >> 10);
201*4882a593Smuzhiyun mtd->size = map->size;
202*4882a593Smuzhiyun }
203*4882a593Smuzhiyun return mtd;
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun kfree(lpddr->qinfo);
207*4882a593Smuzhiyun kfree(lpddr);
208*4882a593Smuzhiyun map->fldrv_priv = NULL;
209*4882a593Smuzhiyun return NULL;
210*4882a593Smuzhiyun }
211*4882a593Smuzhiyun
212*4882a593Smuzhiyun static struct mtd_chip_driver lpddr_chipdrv = {
213*4882a593Smuzhiyun .probe = lpddr_probe,
214*4882a593Smuzhiyun .name = "qinfo_probe",
215*4882a593Smuzhiyun .module = THIS_MODULE
216*4882a593Smuzhiyun };
217*4882a593Smuzhiyun
lpddr_probe_init(void)218*4882a593Smuzhiyun static int __init lpddr_probe_init(void)
219*4882a593Smuzhiyun {
220*4882a593Smuzhiyun register_mtd_chip_driver(&lpddr_chipdrv);
221*4882a593Smuzhiyun return 0;
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun
lpddr_probe_exit(void)224*4882a593Smuzhiyun static void __exit lpddr_probe_exit(void)
225*4882a593Smuzhiyun {
226*4882a593Smuzhiyun unregister_mtd_chip_driver(&lpddr_chipdrv);
227*4882a593Smuzhiyun }
228*4882a593Smuzhiyun
229*4882a593Smuzhiyun module_init(lpddr_probe_init);
230*4882a593Smuzhiyun module_exit(lpddr_probe_exit);
231*4882a593Smuzhiyun
232*4882a593Smuzhiyun MODULE_LICENSE("GPL");
233*4882a593Smuzhiyun MODULE_AUTHOR("Vasiliy Leonenko <vasiliy.leonenko@gmail.com>");
234*4882a593Smuzhiyun MODULE_DESCRIPTION("Driver to probe qinfo flash chips");
235*4882a593Smuzhiyun
236