2012-08-17 00:35:39 +00:00
|
|
|
/***************************************************************************
|
Flash, FRAM and EEPROM driver for STM32 QUAD-/OCTOSPI interface
- write speed up to 150 kByte/s on STM32F469I-disco (due to
SWD clock and USB connection), up to 1 MByte/s on Nucleo-F767ZI
with external STLink-V3 or Nucleo-G474RE with two W25Q256FV in
dual 4-line mode or STM32H73BI-Disco in octal mode
- tested with STM32L476G-disco (64MBit flash, 3-byte addr),
STM32F412G-Disco, STM32F469I-Disco, STM32F746G-Disco, and
STM32L476G-Disco (all 128Mbit flash, 3-byte addr),
STM32F723E-Disco, STM32F769I-Disco (512Mbit flash, 4-byte addr)
STM32L4R9I-Disco, STM32L4P5G-Disco (512MBit octo-flash, DTR, 4-byte addr)
STM32H745I-Disco, STM32H747I-Disco (two 512MBit flash, 4-byte addr)
STM32H73BI-Disco, STM32H735G-Disco (512MBit octo-flash, DTR, 4-byte addr)
- suitable cfg for Discovery boards included
- limited parsing of SFDP data if flash device not hardcoded
(tested only in single/quad mode as most devices either don't
support SFDP at all or have empty(!) SFDP memory)
- 'set' command for auto detection override (e. g. for EEPROMs)
- 'cmd' command for arbitrary SPI commands (reconfiguration, testing etc.)
- makefile for creation of binary loader files
- tcl/board/stm32f469discovery.cfg superseded by stm32f469i-disco.cfg
- tcl/board/stm32f7discovery.cfg removed as name is ambiguous
(superseded by stm32f746g-disco.cfg vs. stm32f769i-disco.cfg)
- dual 4-line mode tested on Nucleo-F767ZI, Nucleo-H743ZI and Nucleo-H7A3ZI-Q
with two W25Q256FV, and on Nucleo-L496ZP-P and Nucleo-L4R5ZI
with two W25Q128FV, sample cfg files included and on STM32H745I-Disco,
STM32H747I-Disco, STM32H750B-Disco
- read/verify/erase_check uses indirect read mode to work around silicon bug in
H7, L4+ and MP1 memory mapped mode (last bytes not readable, accessing last
bytes causes debug interface to hang)
- octospi supported only in single/dual 1-line, 2-line, 4-line
and single 8-line modes, (not in hyper flash mode)
Requirements:
GPIOs must be initialized appropriately, and SPI flash chip be configured
appropriately (1-line ..., QPI, 4-byte addresses ...). This is board/chip
specific, cf. included cfg files. The driver infers most parameters from
current setting in CR, CCR, ... registers.
Change-Id: I54858fbbe8758c3a5fe58812e93f5f39514704f8
Signed-off-by: Andreas Bolsch <hyphen0break@gmail.com>
Reviewed-on: http://openocd.zylin.com/4321
Tested-by: jenkins
Reviewed-by: Tarek BOCHKATI <tarek.bouchkati@gmail.com>
Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
Reviewed-by: Christopher Head <chead@zaber.com>
2016-12-21 09:35:58 +00:00
|
|
|
* Copyright (C) 2018-2019 by Andreas Bolsch *
|
2018-11-18 16:08:20 +00:00
|
|
|
* andreas.bolsch@mni.thm.de *
|
|
|
|
|
* *
|
2012-08-17 00:35:39 +00:00
|
|
|
* Copyright (C) 2012 by George Harris *
|
|
|
|
|
* george@luminairecoffee.com *
|
|
|
|
|
* *
|
|
|
|
|
* Copyright (C) 2010 by Antonio Borneo *
|
|
|
|
|
* borneo.antonio@gmail.com *
|
|
|
|
|
* *
|
|
|
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
|
|
|
* it under the terms of the GNU General Public License as published by *
|
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
|
|
|
* (at your option) any later version. *
|
|
|
|
|
* *
|
|
|
|
|
* This program is distributed in the hope that it will be useful, *
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
|
|
|
* GNU General Public License for more details. *
|
|
|
|
|
* *
|
|
|
|
|
* You should have received a copy of the GNU General Public License *
|
2016-05-16 20:41:00 +00:00
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>. *
|
2012-08-17 00:35:39 +00:00
|
|
|
***************************************************************************/
|
|
|
|
|
|
2015-09-21 19:07:46 +00:00
|
|
|
#ifndef OPENOCD_FLASH_NOR_SPI_H
|
|
|
|
|
#define OPENOCD_FLASH_NOR_SPI_H
|
|
|
|
|
|
2018-11-18 16:08:20 +00:00
|
|
|
#ifndef __ASSEMBLER__
|
|
|
|
|
|
2012-08-17 00:35:39 +00:00
|
|
|
/* data structure to maintain flash ids from different vendors */
|
|
|
|
|
struct flash_device {
|
Flash, FRAM and EEPROM driver for STM32 QUAD-/OCTOSPI interface
- write speed up to 150 kByte/s on STM32F469I-disco (due to
SWD clock and USB connection), up to 1 MByte/s on Nucleo-F767ZI
with external STLink-V3 or Nucleo-G474RE with two W25Q256FV in
dual 4-line mode or STM32H73BI-Disco in octal mode
- tested with STM32L476G-disco (64MBit flash, 3-byte addr),
STM32F412G-Disco, STM32F469I-Disco, STM32F746G-Disco, and
STM32L476G-Disco (all 128Mbit flash, 3-byte addr),
STM32F723E-Disco, STM32F769I-Disco (512Mbit flash, 4-byte addr)
STM32L4R9I-Disco, STM32L4P5G-Disco (512MBit octo-flash, DTR, 4-byte addr)
STM32H745I-Disco, STM32H747I-Disco (two 512MBit flash, 4-byte addr)
STM32H73BI-Disco, STM32H735G-Disco (512MBit octo-flash, DTR, 4-byte addr)
- suitable cfg for Discovery boards included
- limited parsing of SFDP data if flash device not hardcoded
(tested only in single/quad mode as most devices either don't
support SFDP at all or have empty(!) SFDP memory)
- 'set' command for auto detection override (e. g. for EEPROMs)
- 'cmd' command for arbitrary SPI commands (reconfiguration, testing etc.)
- makefile for creation of binary loader files
- tcl/board/stm32f469discovery.cfg superseded by stm32f469i-disco.cfg
- tcl/board/stm32f7discovery.cfg removed as name is ambiguous
(superseded by stm32f746g-disco.cfg vs. stm32f769i-disco.cfg)
- dual 4-line mode tested on Nucleo-F767ZI, Nucleo-H743ZI and Nucleo-H7A3ZI-Q
with two W25Q256FV, and on Nucleo-L496ZP-P and Nucleo-L4R5ZI
with two W25Q128FV, sample cfg files included and on STM32H745I-Disco,
STM32H747I-Disco, STM32H750B-Disco
- read/verify/erase_check uses indirect read mode to work around silicon bug in
H7, L4+ and MP1 memory mapped mode (last bytes not readable, accessing last
bytes causes debug interface to hang)
- octospi supported only in single/dual 1-line, 2-line, 4-line
and single 8-line modes, (not in hyper flash mode)
Requirements:
GPIOs must be initialized appropriately, and SPI flash chip be configured
appropriately (1-line ..., QPI, 4-byte addresses ...). This is board/chip
specific, cf. included cfg files. The driver infers most parameters from
current setting in CR, CCR, ... registers.
Change-Id: I54858fbbe8758c3a5fe58812e93f5f39514704f8
Signed-off-by: Andreas Bolsch <hyphen0break@gmail.com>
Reviewed-on: http://openocd.zylin.com/4321
Tested-by: jenkins
Reviewed-by: Tarek BOCHKATI <tarek.bouchkati@gmail.com>
Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
Reviewed-by: Christopher Head <chead@zaber.com>
2016-12-21 09:35:58 +00:00
|
|
|
const char *name;
|
2018-11-18 16:08:20 +00:00
|
|
|
uint8_t read_cmd;
|
|
|
|
|
uint8_t qread_cmd;
|
|
|
|
|
uint8_t pprog_cmd;
|
2012-08-17 00:35:39 +00:00
|
|
|
uint8_t erase_cmd;
|
|
|
|
|
uint8_t chip_erase_cmd;
|
|
|
|
|
uint32_t device_id;
|
|
|
|
|
uint32_t pagesize;
|
2018-11-18 16:08:20 +00:00
|
|
|
uint32_t sectorsize;
|
|
|
|
|
uint32_t size_in_bytes;
|
2012-08-17 00:35:39 +00:00
|
|
|
};
|
|
|
|
|
|
2018-11-18 16:08:20 +00:00
|
|
|
#define FLASH_ID(n, re, qr, pp, es, ces, id, psize, ssize, size) \
|
|
|
|
|
{ \
|
|
|
|
|
.name = n, \
|
|
|
|
|
.read_cmd = re, \
|
|
|
|
|
.qread_cmd = qr, \
|
|
|
|
|
.pprog_cmd = pp, \
|
|
|
|
|
.erase_cmd = es, \
|
|
|
|
|
.chip_erase_cmd = ces, \
|
|
|
|
|
.device_id = id, \
|
|
|
|
|
.pagesize = psize, \
|
|
|
|
|
.sectorsize = ssize, \
|
|
|
|
|
.size_in_bytes = size, \
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#define FRAM_ID(n, re, qr, pp, id, size) \
|
|
|
|
|
{ \
|
|
|
|
|
.name = n, \
|
|
|
|
|
.read_cmd = re, \
|
|
|
|
|
.qread_cmd = qr, \
|
|
|
|
|
.pprog_cmd = pp, \
|
|
|
|
|
.erase_cmd = 0x00, \
|
|
|
|
|
.chip_erase_cmd = 0x00, \
|
|
|
|
|
.device_id = id, \
|
|
|
|
|
.pagesize = 0, \
|
|
|
|
|
.sectorsize = 0, \
|
|
|
|
|
.size_in_bytes = size, \
|
2012-08-17 00:35:39 +00:00
|
|
|
}
|
|
|
|
|
|
2014-01-20 15:03:24 +00:00
|
|
|
extern const struct flash_device flash_devices[];
|
2012-08-17 00:35:39 +00:00
|
|
|
|
2018-11-18 16:08:20 +00:00
|
|
|
#endif
|
|
|
|
|
|
2012-08-17 00:35:39 +00:00
|
|
|
/* fields in SPI flash status register */
|
2018-11-18 16:08:20 +00:00
|
|
|
#define SPIFLASH_BSY 0
|
|
|
|
|
#define SPIFLASH_BSY_BIT (1 << SPIFLASH_BSY) /* WIP Bit of SPI SR */
|
|
|
|
|
#define SPIFLASH_WE 1
|
|
|
|
|
#define SPIFLASH_WE_BIT (1 << SPIFLASH_WE) /* WEL Bit of SPI SR */
|
2012-08-17 00:35:39 +00:00
|
|
|
|
|
|
|
|
/* SPI Flash Commands */
|
|
|
|
|
#define SPIFLASH_READ_ID 0x9F /* Read Flash Identification */
|
2018-11-18 16:08:20 +00:00
|
|
|
#define SPIFLASH_READ_MID 0xAF /* Read Flash Identification, multi-io */
|
2012-08-17 00:35:39 +00:00
|
|
|
#define SPIFLASH_READ_STATUS 0x05 /* Read Status Register */
|
|
|
|
|
#define SPIFLASH_WRITE_ENABLE 0x06 /* Write Enable */
|
|
|
|
|
#define SPIFLASH_PAGE_PROGRAM 0x02 /* Page Program */
|
|
|
|
|
#define SPIFLASH_FAST_READ 0x0B /* Fast Read */
|
|
|
|
|
#define SPIFLASH_READ 0x03 /* Normal Read */
|
Flash, FRAM and EEPROM driver for STM32 QUAD-/OCTOSPI interface
- write speed up to 150 kByte/s on STM32F469I-disco (due to
SWD clock and USB connection), up to 1 MByte/s on Nucleo-F767ZI
with external STLink-V3 or Nucleo-G474RE with two W25Q256FV in
dual 4-line mode or STM32H73BI-Disco in octal mode
- tested with STM32L476G-disco (64MBit flash, 3-byte addr),
STM32F412G-Disco, STM32F469I-Disco, STM32F746G-Disco, and
STM32L476G-Disco (all 128Mbit flash, 3-byte addr),
STM32F723E-Disco, STM32F769I-Disco (512Mbit flash, 4-byte addr)
STM32L4R9I-Disco, STM32L4P5G-Disco (512MBit octo-flash, DTR, 4-byte addr)
STM32H745I-Disco, STM32H747I-Disco (two 512MBit flash, 4-byte addr)
STM32H73BI-Disco, STM32H735G-Disco (512MBit octo-flash, DTR, 4-byte addr)
- suitable cfg for Discovery boards included
- limited parsing of SFDP data if flash device not hardcoded
(tested only in single/quad mode as most devices either don't
support SFDP at all or have empty(!) SFDP memory)
- 'set' command for auto detection override (e. g. for EEPROMs)
- 'cmd' command for arbitrary SPI commands (reconfiguration, testing etc.)
- makefile for creation of binary loader files
- tcl/board/stm32f469discovery.cfg superseded by stm32f469i-disco.cfg
- tcl/board/stm32f7discovery.cfg removed as name is ambiguous
(superseded by stm32f746g-disco.cfg vs. stm32f769i-disco.cfg)
- dual 4-line mode tested on Nucleo-F767ZI, Nucleo-H743ZI and Nucleo-H7A3ZI-Q
with two W25Q256FV, and on Nucleo-L496ZP-P and Nucleo-L4R5ZI
with two W25Q128FV, sample cfg files included and on STM32H745I-Disco,
STM32H747I-Disco, STM32H750B-Disco
- read/verify/erase_check uses indirect read mode to work around silicon bug in
H7, L4+ and MP1 memory mapped mode (last bytes not readable, accessing last
bytes causes debug interface to hang)
- octospi supported only in single/dual 1-line, 2-line, 4-line
and single 8-line modes, (not in hyper flash mode)
Requirements:
GPIOs must be initialized appropriately, and SPI flash chip be configured
appropriately (1-line ..., QPI, 4-byte addresses ...). This is board/chip
specific, cf. included cfg files. The driver infers most parameters from
current setting in CR, CCR, ... registers.
Change-Id: I54858fbbe8758c3a5fe58812e93f5f39514704f8
Signed-off-by: Andreas Bolsch <hyphen0break@gmail.com>
Reviewed-on: http://openocd.zylin.com/4321
Tested-by: jenkins
Reviewed-by: Tarek BOCHKATI <tarek.bouchkati@gmail.com>
Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
Reviewed-by: Christopher Head <chead@zaber.com>
2016-12-21 09:35:58 +00:00
|
|
|
#define SPIFLASH_MASS_ERASE 0xC7 /* Mass Erase */
|
|
|
|
|
#define SPIFLASH_READ_SFDP 0x5A /* Read Serial Flash Discoverable Parameters */
|
2015-09-21 19:07:46 +00:00
|
|
|
|
2018-11-18 16:08:20 +00:00
|
|
|
#define SPIFLASH_DEF_PAGESIZE 256 /* default for non-page-oriented devices (FRAMs) */
|
|
|
|
|
|
2015-09-21 19:07:46 +00:00
|
|
|
#endif /* OPENOCD_FLASH_NOR_SPI_H */
|
