4 * This file is part of BeRTOS.
6 * Bertos is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20 * As a special exception, you may use this file as part of a free software
21 * library without restriction. Specifically, if other files instantiate
22 * templates or use macros or inline functions from this file, or you compile
23 * this file and link it with other files to produce an executable, this
24 * file does not by itself cause the resulting executable to be covered by
25 * the GNU General Public License. This exception does not however
26 * invalidate any other reasons why the executable file might be covered by
27 * the GNU General Public License.
29 * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
33 * \brief LM3S1968 internal flash memory driver.
35 * \author Andrea Righi <arighi@develer.com>
38 #include "flash_lm3s.h"
39 #include "cfg/cfg_emb_flash.h"
41 // Define log settings for cfg/log.h
42 #define LOG_LEVEL CONFIG_FLASH_EMB_LOG_LEVEL
43 #define LOG_FORMAT CONFIG_FLASH_EMB_LOG_FORMAT
45 #include <cfg/macros.h>
47 #include <io/kblock.h>
49 #include <drv/timer.h>
50 #include <drv/flash.h>
52 #include <cpu/power.h> /* cpu_relax() */
53 #include <cpu/types.h>
55 #include <string.h> /* memcpy() */
62 static bool flash_wait(struct KBlock *blk, uint32_t event)
64 Flash *fls = FLASH_CAST(blk);
65 ticks_t start = timer_clock();
68 if (!(FLASH_FMC_R & event))
71 if (FLASH_FCRIS_R & FLASH_FCRIS_ARIS)
73 fls->hw->status |= FLASH_WR_PROTECT;
74 LOG_ERR("wr protect..\n");
78 if (timer_clock() - start > ms_to_ticks(CONFIG_FLASH_WR_TIMEOUT))
80 fls->hw->status |= FLASH_WR_TIMEOUT;
81 LOG_ERR("Timeout..\n");
91 static int lm3s_erasePage(struct KBlock *blk, uint32_t addr)
93 FLASH_FCMISC_R = FLASH_FCMISC_AMISC;
95 FLASH_FMA_R = (volatile uint32_t)addr;
96 FLASH_FMC_R = FLASH_FMC_WRKEY | FLASH_FMC_ERASE;
98 return flash_wait(blk, FLASH_FMC_ERASE);
101 static int lm3s_writeWord(struct KBlock *blk, uint32_t addr, uint32_t data)
103 FLASH_FCMISC_R = FLASH_FCMISC_AMISC;
105 FLASH_FMA_R = (volatile uint32_t)addr;
106 FLASH_FMD_R = (volatile uint32_t)data;
107 FLASH_FMC_R = FLASH_FMC_WRKEY | FLASH_FMC_WRITE;
109 return flash_wait(blk, FLASH_FMC_WRITE);
112 static size_t lm3s_flash_readDirect(struct KBlock *blk, block_idx_t idx, void *buf, size_t offset, size_t size)
114 memcpy(buf, (void *)(idx * blk->blk_size + offset), size);
118 static size_t lm3s_flash_writeDirect(struct KBlock *blk, block_idx_t idx, const void *_buf, size_t offset, size_t size)
122 ASSERT(size == blk->blk_size);
124 if (!lm3s_erasePage(blk, (idx * blk->blk_size)))
127 uint32_t addr = idx * blk->blk_size;
128 const uint8_t *buf = (const uint8_t *)_buf;
132 uint32_t data = (*(buf + 3) << 24) |
137 if (!lm3s_writeWord(blk, addr, data))
145 return blk->blk_size;
148 static int lm3s_flash_error(struct KBlock *blk)
150 Flash *fls = FLASH_CAST(blk);
151 return fls->hw->status;
154 static void lm3s_flash_clearerror(struct KBlock *blk)
156 Flash *fls = FLASH_CAST(blk);
160 static const KBlockVTable flash_lm3s_buffered_vt =
162 .readDirect = lm3s_flash_readDirect,
163 .writeDirect = lm3s_flash_writeDirect,
165 .readBuf = kblock_swReadBuf,
166 .writeBuf = kblock_swWriteBuf,
167 .load = kblock_swLoad,
168 .store = kblock_swStore,
170 .close = kblock_swClose,
172 .error = lm3s_flash_error,
173 .clearerr = lm3s_flash_clearerror,
176 static const KBlockVTable flash_lm3s_unbuffered_vt =
178 .readDirect = lm3s_flash_readDirect,
179 .writeDirect = lm3s_flash_writeDirect,
181 .close = kblock_swClose,
183 .error = lm3s_flash_error,
184 .clearerr = lm3s_flash_clearerror,
187 static struct FlashHardware flash_lm3s_hw;
188 static uint8_t flash_buf[FLASH_PAGE_SIZE];
190 static void common_init(Flash *fls)
192 memset(fls, 0, sizeof(*fls));
193 DB(fls->blk.priv.type = KBT_FLASH);
195 FLASH_USECRL_R = CPU_FREQ / 1000000 - 1;
197 fls->hw = &flash_lm3s_hw;
199 fls->blk.blk_size = FLASH_PAGE_SIZE;
200 fls->blk.blk_cnt = FLASH_SIZE / FLASH_PAGE_SIZE;
204 void flash_hw_init(Flash *fls, int flags)
207 fls->blk.priv.vt = &flash_lm3s_buffered_vt;
208 fls->blk.priv.flags |= KB_BUFFERED | KB_PARTIAL_WRITE | flags;
209 fls->blk.priv.buf = flash_buf;
211 /* Load the first block in the cache */
212 void *flash_start = 0x0;
213 memcpy(fls->blk.priv.buf, flash_start, fls->blk.blk_size);
216 void flash_hw_initUnbuffered(Flash *fls, int flags)
219 fls->blk.priv.vt = &flash_lm3s_unbuffered_vt;
220 fls->blk.priv.flags |= flags;