EMTime/libopencm3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Documentation added to flash modules for all STM32 families.

Browse Source
This commit is contained in:
Ken Sarkies
2014-01-16 05:49:57 +10:30
committed by Frantisek Burian
parent e4f4845e0c
commit a54a12e1c9
16 changed files with 847 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
lib/stm32/l1/flash.c
View File

@@ -1,3 +1,29 @@
/** @defgroup flash_file FLASH
*
* @ingroup STM32L1xx
*
* @brief <b>libopencm3 STM32L1xx FLASH</b>
*
* @version 1.0.0
*
* @author @htmlonly &copy; @endhtmlonly 2010
* Thomas Otto <tommi@viadmin.org>
* @author @htmlonly &copy; @endhtmlonly 2010
* Mark Butler <mbutler@physics.otago.ac.nz>
* @author @htmlonly &copy; @endhtmlonly 2012
* Karl Palsson <karlp@tweak.net.au>
*
* @date 14 January 2014
*
* For the STM32L1xx, accessing FLASH memory is described briefly in
* section 2.3.3 of the STM32L1xx Reference Manual.
* For detailed programming information see:
* PM0062 programming manual: STM32L1xxxx Flash and EEPROM programming
* March 2012, Doc ID 16024 Rev 5
*
* LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@@ -19,28 +45,72 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include <libopencm3/stm32/l1/flash.h>
/**@{*/
#include <libopencm3/stm32/flash.h>
/*---------------------------------------------------------------------------*/
/** @brief Enable 64 Bit Programming Mode
*/
void flash_64bit_enable(void)
{
FLASH_ACR |= FLASH_ACR_ACC64;
}
/*---------------------------------------------------------------------------*/
/** @brief Enable 32 Bit Programming Mode
This mode is a low power mode. It must be used at low frequencies and does not
allow prefetch or wait states to be used.
*/
void flash_64bit_disable(void)
{
FLASH_ACR &= ~FLASH_ACR_ACC64;
}
/*---------------------------------------------------------------------------*/
/** @brief Enable the FLASH Prefetch Buffer
This buffer is used for instruction fetches and is enabled by default after
reset.
Note carefully the restrictions under which the prefetch buffer may be
enabled or disabled. Prefetch is only available when 64-bit
access is enabled.
*/
void flash_prefetch_enable(void)
{
FLASH_ACR |= FLASH_ACR_PRFTEN;
}
/*---------------------------------------------------------------------------*/
/** @brief Disable the FLASH Prefetch Buffer
Note carefully the restrictions under which the prefetch buffer may be
set to disabled. See the reference and programming manuals for details.
*/
void flash_prefetch_disable(void)
{
FLASH_ACR &= ~FLASH_ACR_PRFTEN;
}
/*---------------------------------------------------------------------------*/
/** @brief Set the Number of Wait States
Used to match the system clock to the FLASH memory access time. See the
programming manual for more information on clock speed and voltage ranges. The
latency must be changed to the appropriate value <b>before</b> any increase in
clock speed, or <b>after</b> any decrease in clock speed. A latency setting of
zero only applies if 64-bit mode is not used.
@param[in] uint32_t ws: values 0 or 1 only.
*/
void flash_set_ws(uint32_t ws)
{
uint32_t reg32;
@@ -50,3 +120,5 @@ void flash_set_ws(uint32_t ws)
reg32 |= ws;
FLASH_ACR = reg32;
}
/**@}*/