2 * Copyright (c) 2006 M. Warner Losh. All rights reserved.
3 * Copyright (c) 2009 Oleksandr Tymoshenko. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 #include <sys/cdefs.h>
27 __FBSDID("$FreeBSD$");
29 #include <sys/param.h>
30 #include <sys/systm.h>
34 #include <sys/kernel.h>
35 #include <sys/kthread.h>
38 #include <sys/malloc.h>
39 #include <sys/module.h>
40 #include <sys/mutex.h>
41 #include <geom/geom_disk.h>
43 #include <dev/spibus/spi.h>
44 #include "spibus_if.h"
46 #include <dev/flash/mx25lreg.h>
49 #define FL_ERASE_4K 0x01
50 #define FL_ERASE_32K 0x02
53 * Define the sectorsize to be a smaller size rather than the flash
54 * sector size. Trying to run FFS off of a 64k flash sector size
55 * results in a completely un-usable system.
57 #define MX25L_SECTORSIZE 512
59 struct mx25l_flash_ident
62 uint8_t manufacturer_id;
64 unsigned int sectorsize;
65 unsigned int sectorcount;
72 uint8_t sc_manufacturer_id;
73 uint16_t sc_device_id;
74 unsigned int sc_sectorsize;
78 struct bio_queue_head sc_bio_queue;
79 unsigned int sc_flags;
82 #define M25PXX_LOCK(_sc) mtx_lock(&(_sc)->sc_mtx)
83 #define M25PXX_UNLOCK(_sc) mtx_unlock(&(_sc)->sc_mtx)
84 #define M25PXX_LOCK_INIT(_sc) \
85 mtx_init(&_sc->sc_mtx, device_get_nameunit(_sc->sc_dev), \
87 #define M25PXX_LOCK_DESTROY(_sc) mtx_destroy(&_sc->sc_mtx);
88 #define M25PXX_ASSERT_LOCKED(_sc) mtx_assert(&_sc->sc_mtx, MA_OWNED);
89 #define M25PXX_ASSERT_UNLOCKED(_sc) mtx_assert(&_sc->sc_mtx, MA_NOTOWNED);
92 static int mx25l_open(struct disk *dp);
93 static int mx25l_close(struct disk *dp);
94 static int mx25l_ioctl(struct disk *, u_long, void *, int, struct thread *);
95 static void mx25l_strategy(struct bio *bp);
96 static void mx25l_task(void *arg);
98 struct mx25l_flash_ident flash_devices[] = {
99 { "mx25ll32", 0xc2, 0x2016, 64 * 1024, 64, FL_NONE },
100 { "m25p64", 0x20, 0x2017, 64 * 1024, 128, FL_NONE },
101 { "mx25ll64", 0xc2, 0x2017, 64 * 1024, 128, FL_NONE },
102 { "mx25ll128", 0xc2, 0x2018, 64 * 1024, 256, FL_ERASE_4K | FL_ERASE_32K },
103 { "s25fl128", 0x01, 0x2018, 64 * 1024, 256, FL_NONE },
104 { "s25sl064a", 0x01, 0x0216, 64 * 1024, 128, FL_NONE },
108 mx25l_get_status(device_t dev)
110 uint8_t txBuf[2], rxBuf[2];
111 struct spi_command cmd;
114 memset(&cmd, 0, sizeof(cmd));
115 memset(txBuf, 0, sizeof(txBuf));
116 memset(rxBuf, 0, sizeof(rxBuf));
118 txBuf[0] = CMD_READ_STATUS;
123 err = SPIBUS_TRANSFER(device_get_parent(dev), dev, &cmd);
128 mx25l_wait_for_device_ready(device_t dev)
130 while ((mx25l_get_status(dev) & STATUS_WIP))
134 static struct mx25l_flash_ident*
135 mx25l_get_device_ident(struct mx25l_softc *sc)
137 device_t dev = sc->sc_dev;
138 uint8_t txBuf[8], rxBuf[8];
139 struct spi_command cmd;
140 uint8_t manufacturer_id;
144 memset(&cmd, 0, sizeof(cmd));
145 memset(txBuf, 0, sizeof(txBuf));
146 memset(rxBuf, 0, sizeof(rxBuf));
148 txBuf[0] = CMD_READ_IDENT;
152 * Some compatible devices has extended two-bytes ID
153 * We'll use only manufacturer/deviceid atm
157 err = SPIBUS_TRANSFER(device_get_parent(dev), dev, &cmd);
161 manufacturer_id = rxBuf[1];
162 dev_id = (rxBuf[2] << 8) | (rxBuf[3]);
165 i < sizeof(flash_devices)/sizeof(struct mx25l_flash_ident); i++) {
166 if ((flash_devices[i].manufacturer_id == manufacturer_id) &&
167 (flash_devices[i].device_id == dev_id))
168 return &flash_devices[i];
171 printf("Unknown SPI flash device. Vendor: %02x, device id: %04x\n",
172 manufacturer_id, dev_id);
177 mx25l_set_writable(device_t dev, int writable)
179 uint8_t txBuf[1], rxBuf[1];
180 struct spi_command cmd;
183 memset(&cmd, 0, sizeof(cmd));
184 memset(txBuf, 0, sizeof(txBuf));
185 memset(rxBuf, 0, sizeof(rxBuf));
187 txBuf[0] = writable ? CMD_WRITE_ENABLE : CMD_WRITE_DISABLE;
192 err = SPIBUS_TRANSFER(device_get_parent(dev), dev, &cmd);
196 mx25l_erase_cmd(device_t dev, off_t sector, uint8_t ecmd)
198 uint8_t txBuf[4], rxBuf[4];
199 struct spi_command cmd;
202 mx25l_wait_for_device_ready(dev);
203 mx25l_set_writable(dev, 1);
205 memset(&cmd, 0, sizeof(cmd));
206 memset(txBuf, 0, sizeof(txBuf));
207 memset(rxBuf, 0, sizeof(rxBuf));
214 txBuf[1] = ((sector >> 16) & 0xff);
215 txBuf[2] = ((sector >> 8) & 0xff);
216 txBuf[3] = (sector & 0xff);
217 err = SPIBUS_TRANSFER(device_get_parent(dev), dev, &cmd);
221 mx25l_write(device_t dev, off_t offset, caddr_t data, off_t count)
223 struct mx25l_softc *sc;
224 uint8_t txBuf[8], rxBuf[8];
225 struct spi_command cmd;
227 long bytes_to_write, bytes_writen;
231 pdev = device_get_parent(dev);
232 sc = device_get_softc(dev);
238 write_offset = offset;
241 * Use the erase sectorsize here since blocks are fully erased
242 * first before they're written to.
244 if (count % sc->sc_sectorsize != 0 || offset % sc->sc_sectorsize != 0)
248 * Assume here that we write per-sector only
249 * and sector size should be 256 bytes aligned
251 KASSERT(write_offset % FLASH_PAGE_SIZE == 0,
252 ("offset for BIO_WRITE is not page size (%d bytes) aligned",
256 * Maximum write size for CMD_PAGE_PROGRAM is
257 * FLASH_PAGE_SIZE, so split data to chunks
258 * FLASH_PAGE_SIZE bytes eash and write them
261 while (bytes_writen < count) {
263 * If we crossed sector boundary - erase next sector
265 if (((offset + bytes_writen) % sc->sc_sectorsize) == 0)
266 mx25l_erase_cmd(dev, offset + bytes_writen, CMD_SECTOR_ERASE);
268 txBuf[0] = CMD_PAGE_PROGRAM;
269 txBuf[1] = ((write_offset >> 16) & 0xff);
270 txBuf[2] = ((write_offset >> 8) & 0xff);
271 txBuf[3] = (write_offset & 0xff);
273 bytes_to_write = MIN(FLASH_PAGE_SIZE,
274 count - bytes_writen);
277 cmd.tx_data = data + bytes_writen;
278 cmd.tx_data_sz = bytes_to_write;
279 cmd.rx_data = data + bytes_writen;
280 cmd.rx_data_sz = bytes_to_write;
283 * Eash completed write operation resets WEL
284 * (write enable latch) to disabled state,
285 * so we re-enable it here
287 mx25l_wait_for_device_ready(dev);
288 mx25l_set_writable(dev, 1);
290 err = SPIBUS_TRANSFER(pdev, dev, &cmd);
294 bytes_writen += bytes_to_write;
295 write_offset += bytes_to_write;
302 mx25l_read(device_t dev, off_t offset, caddr_t data, off_t count)
304 struct mx25l_softc *sc;
305 uint8_t txBuf[8], rxBuf[8];
306 struct spi_command cmd;
310 pdev = device_get_parent(dev);
311 sc = device_get_softc(dev);
314 * Enforce the disk read sectorsize not the erase sectorsize.
315 * In this way, smaller read IO is possible,dramatically
316 * speeding up filesystem/geom_compress access.
318 if (count % sc->sc_disk->d_sectorsize != 0
319 || offset % sc->sc_disk->d_sectorsize != 0)
322 txBuf[0] = CMD_FAST_READ;
326 txBuf[1] = ((offset >> 16) & 0xff);
327 txBuf[2] = ((offset >> 8) & 0xff);
328 txBuf[3] = (offset & 0xff);
335 cmd.tx_data_sz = count;
337 cmd.rx_data_sz = count;
339 err = SPIBUS_TRANSFER(pdev, dev, &cmd);
345 mx25l_probe(device_t dev)
347 device_set_desc(dev, "M25Pxx Flash Family");
352 mx25l_attach(device_t dev)
354 struct mx25l_softc *sc;
355 struct mx25l_flash_ident *ident;
357 sc = device_get_softc(dev);
359 M25PXX_LOCK_INIT(sc);
361 ident = mx25l_get_device_ident(sc);
365 mx25l_wait_for_device_ready(sc->sc_dev);
367 sc->sc_disk = disk_alloc();
368 sc->sc_disk->d_open = mx25l_open;
369 sc->sc_disk->d_close = mx25l_close;
370 sc->sc_disk->d_strategy = mx25l_strategy;
371 sc->sc_disk->d_ioctl = mx25l_ioctl;
372 sc->sc_disk->d_name = "flash/spi";
373 sc->sc_disk->d_drv1 = sc;
374 sc->sc_disk->d_maxsize = DFLTPHYS;
375 sc->sc_disk->d_sectorsize = MX25L_SECTORSIZE;
376 sc->sc_disk->d_mediasize = ident->sectorsize * ident->sectorcount;
377 sc->sc_disk->d_unit = device_get_unit(sc->sc_dev);
378 sc->sc_disk->d_dump = NULL; /* NB: no dumps */
379 /* Sectorsize for erase operations */
380 sc->sc_sectorsize = ident->sectorsize;
381 sc->sc_flags = ident->flags;
383 /* NB: use stripesize to hold the erase/region size for RedBoot */
384 sc->sc_disk->d_stripesize = ident->sectorsize;
386 disk_create(sc->sc_disk, DISK_VERSION);
387 bioq_init(&sc->sc_bio_queue);
389 kproc_create(&mx25l_task, sc, &sc->sc_p, 0, 0, "task: mx25l flash");
390 device_printf(sc->sc_dev, "%s, sector %d bytes, %d sectors\n",
391 ident->name, ident->sectorsize, ident->sectorcount);
397 mx25l_detach(device_t dev)
404 mx25l_open(struct disk *dp)
410 mx25l_close(struct disk *dp)
417 mx25l_ioctl(struct disk *dp, u_long cmd, void *data, int fflag,
425 mx25l_strategy(struct bio *bp)
427 struct mx25l_softc *sc;
429 sc = (struct mx25l_softc *)bp->bio_disk->d_drv1;
431 bioq_disksort(&sc->sc_bio_queue, bp);
437 mx25l_task(void *arg)
439 struct mx25l_softc *sc = (struct mx25l_softc*)arg;
447 bp = bioq_first(&sc->sc_bio_queue);
449 msleep(sc, &sc->sc_mtx, PRIBIO, "jobqueue", 0);
450 } while (bp == NULL);
451 bioq_remove(&sc->sc_bio_queue, bp);
454 switch (bp->bio_cmd) {
456 bp->bio_error = mx25l_read(dev, bp->bio_offset,
457 bp->bio_data, bp->bio_bcount);
460 bp->bio_error = mx25l_write(dev, bp->bio_offset,
461 bp->bio_data, bp->bio_bcount);
464 bp->bio_error = EINVAL;
472 static devclass_t mx25l_devclass;
474 static device_method_t mx25l_methods[] = {
475 /* Device interface */
476 DEVMETHOD(device_probe, mx25l_probe),
477 DEVMETHOD(device_attach, mx25l_attach),
478 DEVMETHOD(device_detach, mx25l_detach),
483 static driver_t mx25l_driver = {
486 sizeof(struct mx25l_softc),
489 DRIVER_MODULE(mx25l, spibus, mx25l_driver, mx25l_devclass, 0, 0);