fprotect.h

/*
 * Copyright (c) 2018 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */

#ifndef FPROTECT_H_
#define FPROTECT_H_

#include <stdint.h>
#include <string.h>
#include <zephyr/types.h>

/**
 * @file
 * @defgroup fprotect Hardware flash write protection.
 * @{
 *
 * @brief API for write protection of flash areas using Hardware peripheral
 */

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @brief Protect flash area against writes.
 *
 * @param[in]  start   Start of range to protect.
 * @param[in]  length  Length in bytes of range to protect.
 *
 * @retval 0        On success.
 * @retval -EINVAL  If any of the argument are incorrect.
 * @retval -ENOSPC  If function is called too many times. Applies to
 *                  devices where there is a limited number of configuration
 *                  registers which are used for all address ranges.
 */
int fprotect_area(uint32_t start, size_t length);

#if defined(CONFIG_FPROTECT_ENABLE_NO_ACCESS)
/**
 * @brief Protect flash area against reads/writes.
 *
 * @param[in]  start   Start of range to protect.
 * @param[in]  length  Length in bytes of range to protect.
 *
 * @retval 0        On success.
 * @retval -EINVAL  If any of the argument are incorrect.
 * @retval -ENOSPC  If function is called too many times. Applies to
 *                  devices where there is a limited number of configuration
 *                  registers which are used for all address ranges.
 */
int fprotect_area_no_access(uint32_t start, size_t length);
#endif

#ifdef __cplusplus
}
#endif

/**
 * @}
 */

#endif /* FPROTECT_H_ */