initial commit
This commit is contained in:
+243
@@ -0,0 +1,243 @@
|
||||
//*****************************************************************************
|
||||
//
|
||||
//! @file flash_write.c
|
||||
//!
|
||||
//! @brief Flash write example.
|
||||
//!
|
||||
//! This example shows how to modify the internal Flash using HAL flash helper
|
||||
//! functions.
|
||||
//!
|
||||
//! This example works on instance 1 of the Flash, i.e. the portion of the
|
||||
//! Flash above 256KB/512KB.
|
||||
//!
|
||||
//
|
||||
//*****************************************************************************
|
||||
|
||||
//*****************************************************************************
|
||||
//
|
||||
// Copyright (c) 2020, Ambiq Micro
|
||||
// All rights reserved.
|
||||
//
|
||||
// Redistribution and use in source and binary forms, with or without
|
||||
// modification, are permitted provided that the following conditions are met:
|
||||
//
|
||||
// 1. Redistributions of source code must retain the above copyright notice,
|
||||
// this list of conditions and the following disclaimer.
|
||||
//
|
||||
// 2. Redistributions in binary form must reproduce the above copyright
|
||||
// notice, this list of conditions and the following disclaimer in the
|
||||
// documentation and/or other materials provided with the distribution.
|
||||
//
|
||||
// 3. Neither the name of the copyright holder nor the names of its
|
||||
// contributors may be used to endorse or promote products derived from this
|
||||
// software without specific prior written permission.
|
||||
//
|
||||
// Third party software included in this distribution is subject to the
|
||||
// additional license terms as defined in the /docs/licenses directory.
|
||||
//
|
||||
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
||||
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
// POSSIBILITY OF SUCH DAMAGE.
|
||||
//
|
||||
// This is part of revision 2.4.2 of the AmbiqSuite Development Package.
|
||||
//
|
||||
//*****************************************************************************
|
||||
|
||||
#include "am_mcu_apollo.h"
|
||||
#include "am_bsp.h"
|
||||
#include "am_util.h"
|
||||
|
||||
//! Arbitrary page address in flash instance 1.
|
||||
#define ARB_PAGE_ADDRESS (AM_HAL_FLASH_INSTANCE_SIZE + (2 * AM_HAL_FLASH_PAGE_SIZE))
|
||||
|
||||
|
||||
static uint32_t ui32Source[512];
|
||||
|
||||
//*****************************************************************************
|
||||
//
|
||||
// Main function.
|
||||
//
|
||||
//*****************************************************************************
|
||||
int
|
||||
main(void)
|
||||
{
|
||||
int32_t i32ReturnCode;
|
||||
int32_t i32ErrorFlag = 0;
|
||||
uint32_t *pui32Src;
|
||||
uint32_t *pui32Dst;
|
||||
int32_t ix;
|
||||
uint32_t ui32PrgmAddr;
|
||||
|
||||
//
|
||||
// Set the clock frequency.
|
||||
//
|
||||
am_hal_clkgen_sysclk_select(AM_HAL_CLKGEN_SYSCLK_MAX);
|
||||
|
||||
//
|
||||
// Initialize the peripherals for this board.
|
||||
//
|
||||
am_bsp_low_power_init();
|
||||
|
||||
//
|
||||
// Initialize the printf interface for ITM/SWO output.
|
||||
//
|
||||
am_util_stdio_printf_init((am_util_stdio_print_char_t) am_bsp_itm_string_print);
|
||||
|
||||
//
|
||||
// Initialize the SWO GPIO pin
|
||||
//
|
||||
am_bsp_pin_enable(ITM_SWO);
|
||||
|
||||
//
|
||||
// Enable the ITM.
|
||||
//
|
||||
am_hal_itm_enable();
|
||||
|
||||
//
|
||||
// Enable debug printf messages using ITM on SWO pin
|
||||
//
|
||||
am_bsp_debug_printf_enable();
|
||||
|
||||
//
|
||||
// Clear the terminal and print the banner.
|
||||
//
|
||||
am_util_stdio_terminal_clear();
|
||||
am_util_stdio_printf("Flash Write Example\n");
|
||||
|
||||
//
|
||||
// Select an arbitrary page address in flash instance 1.
|
||||
// 260KB = 0x41000.
|
||||
//
|
||||
ui32PrgmAddr = ARB_PAGE_ADDRESS;
|
||||
|
||||
//
|
||||
// Erase the whole block of FLASH instance 1.
|
||||
//
|
||||
am_util_stdio_printf(" ... erasing all of flash instance %d.\n", AM_HAL_FLASH_ADDR2INST(ui32PrgmAddr) );
|
||||
i32ReturnCode = am_hal_flash_mass_erase(AM_HAL_FLASH_PROGRAM_KEY, 1);
|
||||
|
||||
//
|
||||
// Check for an error from the HAL.
|
||||
//
|
||||
if (i32ReturnCode)
|
||||
{
|
||||
am_util_stdio_printf("FLASH_MASS_ERASE i32ReturnCode = 0x%x.\n",
|
||||
i32ReturnCode);
|
||||
i32ErrorFlag++;
|
||||
}
|
||||
|
||||
//
|
||||
// Setup a pattern to write to the FLASH.
|
||||
//
|
||||
am_util_stdio_printf(" ... programming flash instance %d, page %d.\n",
|
||||
AM_HAL_FLASH_ADDR2INST(ui32PrgmAddr),
|
||||
AM_HAL_FLASH_ADDR2PAGE(ui32PrgmAddr) );
|
||||
|
||||
pui32Src = ui32Source;
|
||||
for (ix = 0x100; ix < (0x100 + (512 * 4)); ix += 4)
|
||||
{
|
||||
*pui32Src++ = ix;
|
||||
}
|
||||
|
||||
//
|
||||
// Program a few words in a page in the main block of instance 1.
|
||||
//
|
||||
pui32Dst = (uint32_t *) ui32PrgmAddr;
|
||||
i32ReturnCode = am_hal_flash_program_main(AM_HAL_FLASH_PROGRAM_KEY,
|
||||
ui32Source,
|
||||
pui32Dst,
|
||||
512);
|
||||
|
||||
//
|
||||
// Check for an error from the HAL.
|
||||
//
|
||||
if (i32ReturnCode)
|
||||
{
|
||||
am_util_stdio_printf("FLASH program page at 0x%08x "
|
||||
"i32ReturnCode = 0x%x.\n",
|
||||
ui32PrgmAddr,
|
||||
i32ReturnCode);
|
||||
i32ErrorFlag++;
|
||||
}
|
||||
|
||||
//
|
||||
// Check the page just programmed.
|
||||
//
|
||||
am_util_stdio_printf(" ... verifying the page just programmed.\n");
|
||||
for ( ix = 0; ix < 512; ix++ )
|
||||
{
|
||||
if ( *(uint32_t*)(ui32PrgmAddr + (ix*4)) != ui32Source[ix] )
|
||||
{
|
||||
am_util_stdio_printf("ERROR: flash address 0x%08x did not program properly:\n"
|
||||
" Expected value = 0x%08x, programmed value = 0x%08x.\n",
|
||||
ui32PrgmAddr + (ix * 4),
|
||||
ui32Source[ix],
|
||||
*(uint32_t*)(ui32PrgmAddr + (ix * 4)) );
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Erase the page just programmed.
|
||||
//
|
||||
am_util_stdio_printf(" ... erasing the page just programmed.\n");
|
||||
i32ReturnCode = am_hal_flash_page_erase(AM_HAL_FLASH_PROGRAM_KEY,
|
||||
AM_HAL_FLASH_ADDR2INST(ui32PrgmAddr),
|
||||
AM_HAL_FLASH_ADDR2PAGE(ui32PrgmAddr) );
|
||||
|
||||
//
|
||||
// Check for an error from the HAL.
|
||||
//
|
||||
if (i32ReturnCode)
|
||||
{
|
||||
am_util_stdio_printf(" FLASH erase page at 0x%08x "
|
||||
"i32ReturnCode = 0x%x.\n",
|
||||
ARB_PAGE_ADDRESS, i32ReturnCode);
|
||||
i32ErrorFlag++;
|
||||
}
|
||||
|
||||
//
|
||||
// Check that the entire page is erased.
|
||||
//
|
||||
am_util_stdio_printf(" ... verifying the page just erased.\n");
|
||||
for ( ix = 0; ix < 512; ix++ )
|
||||
{
|
||||
if ( *(uint32_t*)(ui32PrgmAddr + (ix*4)) != 0xFFFFFFFF )
|
||||
{
|
||||
am_util_stdio_printf("ERROR: flash address 0x%08x did not ERASE properly:\n"
|
||||
" Expected value = 0xFFFFFFFF, programmed value = 0x%08x.\n",
|
||||
ui32PrgmAddr + (ix*4),
|
||||
*(uint32_t*)(ui32PrgmAddr + (ix * 4)) );
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Report success or any failures and exit.
|
||||
//
|
||||
if (i32ErrorFlag)
|
||||
{
|
||||
am_util_stdio_printf("ERROR: FLASH Write example failure %d\n",
|
||||
i32ErrorFlag);
|
||||
}
|
||||
else
|
||||
{
|
||||
am_util_stdio_printf("FLASH Write example successful \n");
|
||||
}
|
||||
|
||||
//
|
||||
// Verify that ITM is done printing
|
||||
//
|
||||
am_hal_itm_not_busy();
|
||||
|
||||
//
|
||||
// Provide return code back to the system.
|
||||
//
|
||||
return i32ErrorFlag;
|
||||
}
|
||||
Reference in New Issue
Block a user