Home
3 API
3.3 Safe PLIB
Safe PLIBs are used for setting up and controlling the operation of the peripherals.
3.3.8 SAFE_PLIB_NVMCTRL
Set of safe functions for setting up and controlling the NVMCTRL peripheral.
3.3.8.6 NVMCTRL_RowErase
Erases a Row in the NVM

1 Preface
2 Diagnostic Library for SAM C21
3 API
- 3.1 API Overview
- 3.2 Diagnostic Mechanisms
- 3.3 Safe PLIB
  Safe PLIBs are used for setting up and controlling the operation of the peripherals.
  - 3.3.1 SAFE_PLIB_ADC
    Set of safe functions for setting up and controlling the ADC peripheral.
  - 3.3.2 SAFE_PLIB_CAN
    Set of safe functions for setting up and controlling the CAN peripheral.
  - 3.3.3 SAFE_PLIB_DAC
    Set of safe functions for setting up and controlling the DAC peripheral.
  - 3.3.4 SAFE_PLIB_DIVAS
    Set of safe functions for setting up and controlling the DIVAS peripheral.
  - 3.3.5 SAFE_PLIB_DMAC
    Set of safe functions for setting up and controlling the DMAC peripheral.
  - 3.3.6 SAFE_PLIB_EIC
    Set of safe functions for setting up and controlling the EIC peripheral.
  - 3.3.7 SAFE_PLIB_FREQM
    Set of safe functions for setting up and controlling the FREQM peripheral.
  - 3.3.8 SAFE_PLIB_NVMCTRL
    Set of safe functions for setting up and controlling the NVMCTRL peripheral.
    - 3.3.8.1 NVMCTRL_CallbackRegister
      Sets the pointer to the function (and it's context) to be called when the operation is complete.
    - 3.3.8.2 NVMCTRL_Initialize
      Initialze peripheral instance as per application need.
    - 3.3.8.3 NVMCTRL_IsBusy
      Returns the current status of NVM controller.
    - 3.3.8.4 NVMCTRL_PageWrite
      Writes one page of data to given NVM address.
    - 3.3.8.5 NVMCTRL_RegionUnlock
      Unlocks a NVM region.
    - 3.3.8.6 NVMCTRL_RowErase
      Erases a Row in the NVM
  - 3.3.9 SAFE_PLIB_PAC
    Set of safe functions for setting up and controlling the PAC peripheral.
  - 3.3.10 SAFE_PLIB_RSTC
    Set of safe functions for setting up and controlling the RSTC peripheral.
  - 3.3.11 SAFE_PLIB_RTC
    Set of safe functions for setting up and controlling the RTC peripheral.
  - 3.3.12 SAFE_PLIB_SDADC
    Set of safe functions for setting up and controlling the SDADC peripheral.
  - 3.3.13 SAFE_PLIB_SERCOM_USART
    Set of safe functions for setting up and controlling the USART peripheral.
  - 3.3.14 SAFE_PLIB_TC
    Set of safe functions for setting up and controlling the TC peripheral.
  - 3.3.15 SAFE_PLIB_TCC
    Set of safe functions for setting up and controlling the TCC peripheral.
  - 3.3.16 SAFE_PLIB_WDT
    Set of safe functions for setting up and controlling the WDT peripheral.
4 Appendix - FMEDA to Diagnostic API Mapping
5 Known Issues
6 Revision History
Microchip Information

3.3.8.6 NVMCTRL_RowErase

Erases a Row in the NVM

This function will erase one row in NVM. The address of the row to be erased is specified by the address parameter. This address can be any address in the row. Calling this function will cause the CPU execution to stall, hence blocking execution of any other thread. Execution resumes when the Erase operation has completed.

bool NVMCTRL_RowErase
(
    uint32_t address
);

Precondition

The NVMCTRL_Initialize() function should have been called once. Also validate if NVM controller is ready to accept new request by calling NVMCTRL_IsBusy().

Parameters

address - Any address in the row to be erased.

Returns

bool - returns true if write was successful, otherwise false.