3.18.3.5 Module Documentation

#include "mcc_generated_files/system/system.h"

#define FLASH_ADDRESS (PROGMEM_SIZE - 5) //Flash address at which data is to be written

void FLASH_Example_PageErase_RowWrite_Read(void)
{
    flash_address_t flashStartPageAddress;
    uint16_t index;
    flash_data_t flashWriteData[PROGMEM_PAGE_SIZE];
    nvm_status_t errorStatus = NVM_OK;
    bool readError = false;

    //Get the starting address of the page containing the given address
    flashStartPageAddress = FLASH_PageAddressGet(FLASH_ADDRESS);
  
    //Erase entire page 
    NVM_UnlockKeySet(UNLOCK_KEY);     
    errorStatus = FLASH_PageErase(flashStartPageAddress);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_PageErase passed \r\n");
    }
    else
    {
        printf("FLASH_PageErase failed \r\n");
        NVM_StatusClear();
    }

    //Prepare row data
    for (index = 0; index < PROGMEM_PAGE_SIZE; index++)
    {
        flashWriteData[index] = (flash_data_t) index;
    }

    //Write data to Flash row  
    NVM_UnlockKeySet(UNLOCK_KEY);
    errorStatus = FLASH_RowWrite(flashStartPageAddress, flashWriteData);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_RowWrite passed \r\n");
    }
    else
    {
        printf("FLASH_RowWrite failed \r\n");
        NVM_StatusClear();
    }

    //Read and verify row data
    for (index = 0; index < PROGMEM_PAGE_SIZE; index++)
    {
        if (FLASH_Read(flashStartPageAddress + index) != flashWriteData[index])
        {
            readError = true;
            break;
        }
    }

    if (readError == false)
    {
        printf("FLASH_Read passed \r\n");
    }
    else
    {
        printf("FLASH_Read failed \r\n");
    }
}

#include "mcc_generated_files/system/system.h"

#define FLASH_ADDRESS (PROGMEM_SIZE - 5) //Flash address at which data is to be written

void FLASH_Example_PageErase_Write_Read(void)
{
    flash_address_t flashStartPageAddress;
    nvm_status_t errorStatus = NVM_OK;

    //Get the starting address of the page containing the given address
    flashStartPageAddress = FLASH_PageAddressGet(FLASH_ADDRESS);

    //Erase entire page     
    NVM_UnlockKeySet(UNLOCK_KEY);   
    errorStatus = FLASH_PageErase(flashStartPageAddress);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_PageErase passed \r\n");
    }
    else
    {
        printf("FLASH_PageErase failed \r\n");
        NVM_StatusClear();
    }

    //Write one word (0xAAAA) at the beginning of the page   
    NVM_UnlockKeySet(UNLOCK_KEY);
    errorStatus = FLASH_Write(flashStartPageAddress, 0xAAAA);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_Write passed \r\n");
    }
    else
    {
        printf("FLASH_Write failed \r\n");
        NVM_StatusClear();
    }

    //Verify FLASH_WordWrite by reading
    if (0xAAAA == (uint16_t) (FLASH_Read(flashStartPageAddress + 1) << 8 | FLASH_Read(flashStartPageAddress)))
    {
        printf("FLASH_Read passed \r\n");
    }
    else
    {
        printf("FLASH_Read failed \r\n");
    }
}

#include "mcc_generated_files/system/system.h"

#define FLASH_ADDRESS (PROGMEM_SIZE - 5) //Flash address at which data is to be written

flash_data_t flashWriteData[PROGMEM_PAGE_SIZE] __at(BUFFER_RAM_START_ADDRESS);

void FLASH_Example_UpdateSelectiveLocations(void)
{
    flash_address_t flashStartPageAddress;
    uint16_t flashAddressOffset;
    nvm_status_t errorStatus = NVM_OK;
    bool readError = false;    

    //Get the starting address of the page containing the given address
    flashStartPageAddress = FLASH_PageAddressGet(FLASH_ADDRESS);

    //Read entire row in buffer RAM
    NVM_UnlockKeySet(UNLOCK_KEY);  
    errorStatus = FLASH_RowRead(flashStartPageAddress, flashWriteData);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_RowRead passed \r\n");
    }
    else
    {
        printf("FLASH_RowRead failed \r\n");
        NVM_StatusClear();
    }
    
    //Get offset from the starting address of the page
    flashAddressOffset = FLASH_PageOffsetGet(FLASH_ADDRESS);

    //Update 4 bytes 
    flashWriteData[flashAddressOffset] = 0x0A;
    flashWriteData[flashAddressOffset + 1] = 0x1A;
    flashWriteData[flashAddressOffset + 2] = 0x2A;
    flashWriteData[flashAddressOffset + 3] = 0x3A;

    //Erase entire Flash page    
    NVM_UnlockKeySet(UNLOCK_KEY);   
    errorStatus = FLASH_PageErase(flashStartPageAddress);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_PageErase passed \r\n");
    }
    else
    {
        printf("FLASH_PageErase failed \r\n");
        NVM_StatusClear();
    }

    //Write data to Flash row  
    NVM_UnlockKeySet(UNLOCK_KEY);
    errorStatus = FLASH_RowWrite(flashStartPageAddress, flashWriteData);
    NVM_UnlockKeyClear();
    if (errorStatus == NVM_OK)
    {
        printf("FLASH_RowWrite passed \r\n");
    }
    else
    {
        printf("FLASH_RowWrite failed \r\n");
        NVM_StatusClear();
    }

    //Read and verify row data
    for (flashAddressOffset = 0; flashAddressOffset < PROGMEM_PAGE_SIZE; flashAddressOffset++)
    {
        if (FLASH_Read(flashStartPageAddress + flashAddressOffset) != flashWriteData[flashAddressOffset])
        {
            readError = true;
            break;
        }
    }

    if (readError == false)
    {
        printf("FLASH_Read passed \r\n");
    }
    else
    {
        printf("FLASH_Read failed \r\n");
    }
}

#include "mcc_generated_files/system/system.h"

#define EEPROM_ADDRESS (EEPROM_START_ADDRESS) //EEPROM address at which data is to be written

void EEPROM_Write_Read(void)
{
    eeprom_data_t eepromWriteData[8];
    uint8_t count;
    bool readError = false;

    //Prepare data
    for (count = 0; count < 8; count++)
    {
        eepromWriteData[count] = 0xA1 + count;
    }

    for (count = 0; count < 8; count++)
    {
        //Write EEPROM byte    
        NVM_UnlockKeySet(UNLOCK_KEY);
        EEPROM_Write(EEPROM_ADDRESS + count, eepromWriteData[count]);
        NVM_UnlockKeyClear();
        while (NVM_IsBusy());
        if (NVM_StatusGet() == NVM_OK)
        {
            printf("EEPROM_Write passed \r\n");
        }
        else
        {
            printf("EEPROM_Write failed \r\n");
            NVM_StatusClear();
        }
    }

    //Read and verify
    for (count = 0; count < 8; count++)
    {
        if (EEPROM_Read(EEPROM_ADDRESS + count) != eepromWriteData[count])
        {
            readError = true;
            break;
        }
    }

    if (readError == false)
    {
        printf("EEPROM_Read passed \r\n");
    }
    else
    {
        printf("EEPROM_Read failed \r\n");
    }
}

#include "mcc_generated_files/system/system.h"

#define DEVICE_ID_ADDRESS (0x3FFFFEU) //Compare with the device data sheet to see if the address is correct

void NVM_Example_DeviceID_Read(void)
{
    printf("Device ID : 0x%X \r\n", DeviceID_Read(DEVICE_ID_ADDRESS));
}

#include "mcc_generated_files/system/system.h"

#define CONFIG_TO_BE_UPDATED_ADDRESS (0x300000U) //CONFIG1 address (Compare with the device data sheet to see if the address is correct)
#define _CONFIG1_FEXTOSC_MASK (0b111)

void NVM_Example_Configuration_UpdateSpecificSetting(void)
{
    configuration_address_t configurationToBeUpdatedAddress = CONFIG_TO_BE_UPDATED_ADDRESS;   
    configuration_data_t configurationValueToBeUpdated;
   
    //Read
    configurationValueToBeUpdated = CONFIGURATION_Read(configurationToBeUpdatedAddress);
    
    //Modify
    configurationValueToBeUpdated &= (~((configuration_data_t)_CONFIG1_FEXTOSC_MASK)); //Clear External Oscillator Mode Selection bits
    
    //Write
    NVM_UnlockKeySet(UNLOCK_KEY);
    CONFIGURATION_Write(configurationToBeUpdatedAddress, configurationValueToBeUpdated);
    NVM_UnlockKeyClear();
    while (NVM_IsBusy());
    if (NVM_StatusGet() == NVM_OK)
    {
        printf("CONFIGURATION_Write passed \r\n");
    }
    else
    {
        printf("CONFIGURATION_Write failed \r\n");
        NVM_StatusClear();
    }
    
    //Read again to verify
    if(configurationValueToBeUpdated == CONFIGURATION_Read(configurationToBeUpdatedAddress))
    {
        printf("CONFIGURATION_Read passed \r\n");
    }
    else
    {
        printf("CONFIGURATION_Read failed \r\n");
    }
}