CCP Utility Driver

Contains assembly API prototypes for the CCP (Configuration Change Protection) utility driver. More...

Functions
void	ASM_WriteCcp8 (register8_t *regAddr, uint8_t value)
	Writes value to a Configuration Change Protected (CCP) 8-bit register.
void	ASM_WriteCcp16 (register16_t *regAddr, uint16_t value)
	Writes value to a Configuration Change Protected (CCP) 16-bit register.
void	ASM_WriteCcp24 (register32_t *regAddr, uint32_t value)
	Writes value to a Configuration Change Protected (CCP) 24-bit register.

Detailed Description

Contains assembly API prototypes for the CCP (Configuration Change Protection) utility driver.

Version

1.0.0-alpha.1

Copyright

© 2025 Microchip Technology Inc. and its subsidiaries.

Subject to your compliance with these terms, you may use Microchip software and any derivatives exclusively with Microchip products. It is your responsibility to comply with third party license terms applicable to your use of third party software (including open source software) that may accompany Microchip software.

THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.

UML Class Diagrams

UML Activity Diagrams

Function Documentation

ASM_WriteCcp16()

void ASM_WriteCcp16	(	register16_t *	regAddr,
		uint16_t	value )

Writes value to a Configuration Change Protected (CCP) 16-bit register.

This function writes the required CCP signature to unlock CCP-protected Special Function Registers (SFRs) before writing the specified value to it. Once unlocked, the protected register must be written to within the next four CPU instructions. To ensure the CCP sequence is correctly executed, the function is implemented in assembly.

Note

This function writes to 16-bit CCP protected SFRs. For 8-bit and 24-bit registers see ASM_WriteCcp8 and ASM_WriteCcp24.

An attempted write to CCP-protected SFRs outside the CCP sequence is discarded and issues a bus error.

Warning

It is the responsibility of the calling function to provide a valid SFR address and value. No input validation is performed.

Parameters

regAddr	Address of the CCP-protected register.
value	Specifies the value to write to the CCP-protected register.

ASM_WriteCcp24()

void ASM_WriteCcp24	(	register32_t *	regAddr,
		uint32_t	value )

Writes value to a Configuration Change Protected (CCP) 24-bit register.

This function writes the required CCP signature to unlock CCP-protected Special Function Registers (SFRs) before writing the specified value to it. Once unlocked, the protected register must be written to within the next four CPU instructions. To ensure the CCP sequence is correctly executed, the function is implemented in assembly.

Note

This function writes to 24-bit CCP protected SFRs. For 8-bit and 16-bit registers see ASM_WriteCcp8 and ASM_WriteCcp16.

Warning

This function only writes the three least significant bytes and discards the most significant byte of the value input parameter.

Note

An attempted write to CCP-protected SFRs outside the CCP sequence is discarded and issues a bus error.

Warning

It is the responsibility of the calling function to provide a valid SFR address and value. No input validation is performed.

Parameters

regAddr	Address of the CCP-protected register.
value	Specifies the value to write to the CCP-protected register.

ASM_WriteCcp8()

void ASM_WriteCcp8	(	register8_t *	regAddr,
		uint8_t	value )

Writes value to a Configuration Change Protected (CCP) 8-bit register.

This function writes the required CCP signature to unlock CCP-protected Special Function Registers (SFRs) before writing the specified value to it. Once unlocked, the protected register must be written to within the next four CPU instructions. To ensure the CCP sequence is correctly executed, the function is implemented in assembly.

Note

This function writes to 8-bit CCP protected SFRs. For 16-bit and 24-bit registers see ASM_WriteCcp16 and ASM_WriteCcp24.

An attempted write to CCP-protected SFRs outside the CCP sequence is discarded and issues a bus error.

Warning

It is the responsibility of the calling function to provide a valid SFR address and value. No input validation is performed.

Parameters

regAddr	Address of the CCP-protected register.
value	Specifies the value to write to the CCP-protected register.