xref: /nrf52832-nimble/rt-thread/components/drivers/mtd/mtd.c (revision 104654410c56c573564690304ae786df310c91fc)
1*10465441SEvalZero /*
2*10465441SEvalZero  * Copyright (c) 2006-2018, RT-Thread Development Team
3*10465441SEvalZero  *
4*10465441SEvalZero  * SPDX-License-Identifier: Apache-2.0
5*10465441SEvalZero  *
6*10465441SEvalZero  * Change Logs:
7*10465441SEvalZero  * Date           Author        Notes
8*10465441SEvalZero    2018-09-10     heyuanjie87   first version
9*10465441SEvalZero 
10*10465441SEvalZero  */
11*10465441SEvalZero 
12*10465441SEvalZero #include <drivers/mtd.h>
13*10465441SEvalZero 
mtd_part_alloc(rt_mtd_t * master,const struct mtd_part * part)14*10465441SEvalZero static rt_mtd_t* mtd_part_alloc(rt_mtd_t *master, const struct mtd_part *part)
15*10465441SEvalZero {
16*10465441SEvalZero     rt_mtd_t *slave;
17*10465441SEvalZero 
18*10465441SEvalZero     slave = rt_malloc(sizeof(rt_mtd_t));
19*10465441SEvalZero     if (slave == RT_NULL)
20*10465441SEvalZero         goto out;
21*10465441SEvalZero 
22*10465441SEvalZero     slave->master = master;
23*10465441SEvalZero 
24*10465441SEvalZero     *slave = *master;
25*10465441SEvalZero     slave->size = part->size;
26*10465441SEvalZero     slave->offset = part->offset;
27*10465441SEvalZero 
28*10465441SEvalZero out:
29*10465441SEvalZero 
30*10465441SEvalZero     return slave;
31*10465441SEvalZero }
32*10465441SEvalZero 
rt_mtd_get(const char * name)33*10465441SEvalZero rt_mtd_t* rt_mtd_get(const char *name)
34*10465441SEvalZero {
35*10465441SEvalZero     rt_mtd_t *mtd;
36*10465441SEvalZero 
37*10465441SEvalZero     mtd = (rt_mtd_t *)rt_device_find(name);
38*10465441SEvalZero     if (mtd == RT_NULL)
39*10465441SEvalZero         return RT_NULL;
40*10465441SEvalZero 
41*10465441SEvalZero     if (mtd->parent.type != RT_Device_Class_MTD)
42*10465441SEvalZero         return RT_NULL;
43*10465441SEvalZero 
44*10465441SEvalZero     return mtd;
45*10465441SEvalZero }
46*10465441SEvalZero 
47*10465441SEvalZero /*
48*10465441SEvalZero  * Register MTD driver
49*10465441SEvalZero  *
50*10465441SEvalZero  * @parts partion description
51*10465441SEvalZero  * @np number of partitions
52*10465441SEvalZero  * @return number of unregistered partitions
53*10465441SEvalZero  *
54*10465441SEvalZero */
rt_mtd_register(rt_mtd_t * master,const struct mtd_part * parts,int np)55*10465441SEvalZero int rt_mtd_register(rt_mtd_t *master, const struct mtd_part *parts, int np)
56*10465441SEvalZero {
57*10465441SEvalZero     int ret;
58*10465441SEvalZero     rt_mtd_t *slave;
59*10465441SEvalZero 
60*10465441SEvalZero     master->master = master;
61*10465441SEvalZero     master->parent.type = RT_Device_Class_MTD;
62*10465441SEvalZero 
63*10465441SEvalZero     if (np > 0)
64*10465441SEvalZero     {
65*10465441SEvalZero         master->offset = parts->offset;
66*10465441SEvalZero         master->size = parts->size;
67*10465441SEvalZero 
68*10465441SEvalZero         ret = rt_device_register((rt_device_t)master, parts->name, 0);
69*10465441SEvalZero         if (ret != 0)
70*10465441SEvalZero             goto _out;
71*10465441SEvalZero 
72*10465441SEvalZero         np --;
73*10465441SEvalZero         parts ++;
74*10465441SEvalZero     }
75*10465441SEvalZero 
76*10465441SEvalZero     while (np > 0)
77*10465441SEvalZero     {
78*10465441SEvalZero         slave = mtd_part_alloc(master, parts);
79*10465441SEvalZero         if (!slave)
80*10465441SEvalZero             break;
81*10465441SEvalZero         ret = rt_device_register((rt_device_t)slave, parts->name, 0);
82*10465441SEvalZero         if (ret)
83*10465441SEvalZero             break;
84*10465441SEvalZero         parts ++;
85*10465441SEvalZero         np --;
86*10465441SEvalZero     }
87*10465441SEvalZero 
88*10465441SEvalZero _out:
89*10465441SEvalZero     return np;
90*10465441SEvalZero }
91*10465441SEvalZero 
rt_mtd_block_erase(rt_mtd_t * mtd,uint32_t block)92*10465441SEvalZero int rt_mtd_block_erase(rt_mtd_t *mtd, uint32_t block)
93*10465441SEvalZero {
94*10465441SEvalZero     uint32_t total_blks;
95*10465441SEvalZero     loff_t addr;
96*10465441SEvalZero 
97*10465441SEvalZero     total_blks = mtd->size/mtd->block_size;
98*10465441SEvalZero     if (block >= total_blks)
99*10465441SEvalZero         return -EINVAL;
100*10465441SEvalZero     addr = mtd->offset + mtd->block_size * block;
101*10465441SEvalZero 
102*10465441SEvalZero     return mtd->ops->erase(mtd->master, addr, mtd->block_size);
103*10465441SEvalZero }
104*10465441SEvalZero 
rt_mtd_block_isbad(rt_mtd_t * mtd,uint32_t block)105*10465441SEvalZero int rt_mtd_block_isbad(rt_mtd_t *mtd, uint32_t block)
106*10465441SEvalZero {
107*10465441SEvalZero     uint32_t total_blks, offset_blk;
108*10465441SEvalZero 
109*10465441SEvalZero     if (!mtd->ops->isbad)
110*10465441SEvalZero         return 0;
111*10465441SEvalZero 
112*10465441SEvalZero     total_blks = mtd->size / mtd->block_size;
113*10465441SEvalZero     if (block >= total_blks)
114*10465441SEvalZero         return -EINVAL;
115*10465441SEvalZero     offset_blk = mtd->offset / mtd->block_size;
116*10465441SEvalZero 
117*10465441SEvalZero     return mtd->ops->isbad(mtd->master, block + offset_blk);
118*10465441SEvalZero }
119*10465441SEvalZero 
rt_mtd_block_markbad(rt_mtd_t * mtd,uint32_t block)120*10465441SEvalZero int rt_mtd_block_markbad(rt_mtd_t *mtd, uint32_t block)
121*10465441SEvalZero {
122*10465441SEvalZero     uint32_t total_blks, offset_blk;
123*10465441SEvalZero 
124*10465441SEvalZero     if (!mtd->ops->markbad)
125*10465441SEvalZero         return -EOPNOTSUPP;
126*10465441SEvalZero 
127*10465441SEvalZero     total_blks = mtd->size / mtd->block_size;
128*10465441SEvalZero     if (block >= total_blks)
129*10465441SEvalZero         return -EINVAL;
130*10465441SEvalZero     offset_blk = mtd->offset / mtd->block_size;
131*10465441SEvalZero 
132*10465441SEvalZero     return mtd->ops->markbad(mtd->master, block + offset_blk);
133*10465441SEvalZero }
134*10465441SEvalZero 
rt_mtd_erase(rt_mtd_t * mtd,loff_t addr,size_t size)135*10465441SEvalZero int rt_mtd_erase(rt_mtd_t *mtd, loff_t addr, size_t size)
136*10465441SEvalZero {
137*10465441SEvalZero     if (addr > mtd->size || (addr + size) > mtd->size)
138*10465441SEvalZero         return -EINVAL;
139*10465441SEvalZero     addr += mtd->offset;
140*10465441SEvalZero 
141*10465441SEvalZero     return mtd->ops->erase(mtd->master, addr, size);
142*10465441SEvalZero }
143*10465441SEvalZero 
144*10465441SEvalZero /*
145*10465441SEvalZero * Read data only
146*10465441SEvalZero *
147*10465441SEvalZero * @from offset to read from
148*10465441SEvalZero * @return success size or error code
149*10465441SEvalZero */
rt_mtd_read(rt_mtd_t * mtd,loff_t from,uint8_t * buf,size_t len)150*10465441SEvalZero int rt_mtd_read(rt_mtd_t *mtd, loff_t from, uint8_t *buf, size_t len)
151*10465441SEvalZero {
152*10465441SEvalZero     int ret;
153*10465441SEvalZero     struct mtd_io_desc desc = {0};
154*10465441SEvalZero 
155*10465441SEvalZero     if (from < 0 || from >= (loff_t)mtd->size || len > mtd->size - from)
156*10465441SEvalZero         return -EINVAL;
157*10465441SEvalZero     if (!len)
158*10465441SEvalZero         return 0;
159*10465441SEvalZero 
160*10465441SEvalZero     desc.datbuf = buf;
161*10465441SEvalZero     desc.datlen = len;
162*10465441SEvalZero     ret = mtd->ops->read(mtd->master, from + mtd->offset, &desc);
163*10465441SEvalZero     if (ret)
164*10465441SEvalZero         return ret;
165*10465441SEvalZero 
166*10465441SEvalZero     return desc.datretlen;
167*10465441SEvalZero }
168*10465441SEvalZero 
169*10465441SEvalZero /**
170*10465441SEvalZero * Write data only
171*10465441SEvalZero *
172*10465441SEvalZero * @to offset to write from
173*10465441SEvalZero * @return success size or error code
174*10465441SEvalZero */
rt_mtd_write(rt_mtd_t * mtd,loff_t to,const uint8_t * buf,size_t len)175*10465441SEvalZero int rt_mtd_write(rt_mtd_t *mtd, loff_t to, const uint8_t *buf, size_t len)
176*10465441SEvalZero {
177*10465441SEvalZero     int ret;
178*10465441SEvalZero     struct mtd_io_desc desc = {0};
179*10465441SEvalZero 
180*10465441SEvalZero     if (to < 0 || to >= (loff_t)mtd->size || len > mtd->size - to)
181*10465441SEvalZero         return -EINVAL;
182*10465441SEvalZero     if (!mtd->ops->write)
183*10465441SEvalZero         return -EROFS;
184*10465441SEvalZero     if (!len)
185*10465441SEvalZero         return 0;
186*10465441SEvalZero 
187*10465441SEvalZero     desc.datbuf = (uint8_t*)buf;
188*10465441SEvalZero     desc.datlen = len;
189*10465441SEvalZero     ret = mtd->ops->write(mtd->master, to + mtd->offset, &desc);
190*10465441SEvalZero     if (ret)
191*10465441SEvalZero         return ret;
192*10465441SEvalZero 
193*10465441SEvalZero     return desc.datretlen;
194*10465441SEvalZero }
195*10465441SEvalZero 
196*10465441SEvalZero /**
197*10465441SEvalZero * Read data and/or out-of-band
198*10465441SEvalZero *
199*10465441SEvalZero * @from offset to read from
200*10465441SEvalZero * @desc sector operation description structure
201*10465441SEvalZero * @return error code, 0 success
202*10465441SEvalZero */
rt_mtd_read_oob(rt_mtd_t * mtd,loff_t from,struct mtd_io_desc * desc)203*10465441SEvalZero int rt_mtd_read_oob(rt_mtd_t *mtd, loff_t from, struct mtd_io_desc *desc)
204*10465441SEvalZero {
205*10465441SEvalZero     desc->datretlen = 0;
206*10465441SEvalZero     desc->oobretlen = 0;
207*10465441SEvalZero 
208*10465441SEvalZero     if (from < 0 || from >= (loff_t)mtd->size)
209*10465441SEvalZero         return -EINVAL;
210*10465441SEvalZero 
211*10465441SEvalZero     if (desc->datbuf && (desc->datlen > (mtd->size - from)))
212*10465441SEvalZero         return -EINVAL;
213*10465441SEvalZero 
214*10465441SEvalZero     return mtd->ops->read(mtd->master, from + mtd->offset, desc);
215*10465441SEvalZero }
216*10465441SEvalZero 
217*10465441SEvalZero /**
218*10465441SEvalZero * Write data and/or out-of-band
219*10465441SEvalZero *
220*10465441SEvalZero * @to offset to read from
221*10465441SEvalZero * @desc sector operation description structure
222*10465441SEvalZero * @return error code, 0 success
223*10465441SEvalZero */
rt_mtd_write_oob(rt_mtd_t * mtd,loff_t to,struct mtd_io_desc * desc)224*10465441SEvalZero int rt_mtd_write_oob(rt_mtd_t *mtd, loff_t to, struct mtd_io_desc *desc)
225*10465441SEvalZero {
226*10465441SEvalZero     desc->datretlen = 0;
227*10465441SEvalZero     desc->oobretlen = 0;
228*10465441SEvalZero 
229*10465441SEvalZero     if (to < 0 || to >= (loff_t)mtd->size)
230*10465441SEvalZero         return -EINVAL;
231*10465441SEvalZero 
232*10465441SEvalZero     if (desc->datbuf && (desc->datlen >(mtd->size - to)))
233*10465441SEvalZero         return -EINVAL;
234*10465441SEvalZero 
235*10465441SEvalZero     return mtd->ops->write(mtd->master, to + mtd->offset, desc);
236*10465441SEvalZero }
237