c112e5d478
Consistently place C++ use of extern "C" after all include directives, within the negative branch of _ASMLANGUAGE if used. Background from issue #17997: Declarations that use C linkage should be placed within extern "C" so the language linkage is correct when the header is included by a C++ compiler. Similarly #include directives should be outside the extern "C" to ensure the language-specific default linkage is applied to any declarations provided by the included header. See: https://en.cppreference.com/w/cpp/language/language_linkage Signed-off-by: Peter Bigot <peter.bigot@nordicsemi.no>
69 lines
1.7 KiB
C
69 lines
1.7 KiB
C
/*
|
|
* Copyright (c) 2017 Nordic Semiconductor ASA
|
|
* Copyright (c) 2017 Linaro Limited
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#ifndef ZEPHYR_INCLUDE_DFU_FLASH_IMG_H_
|
|
#define ZEPHYR_INCLUDE_DFU_FLASH_IMG_H_
|
|
|
|
#include <storage/flash_map.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct flash_img_context {
|
|
u8_t buf[CONFIG_IMG_BLOCK_BUF_SIZE];
|
|
const struct flash_area *flash_area;
|
|
size_t bytes_written;
|
|
u16_t buf_bytes;
|
|
#ifdef CONFIG_IMG_ERASE_PROGRESSIVELY
|
|
off_t off_last;
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* @brief Initialize context needed for writing the image to the flash.
|
|
*
|
|
* @param ctx context to be initialized
|
|
*
|
|
* @return 0 on success, negative errno code on fail
|
|
*/
|
|
int flash_img_init(struct flash_img_context *ctx);
|
|
|
|
/**
|
|
* @brief Read number of bytes of the image written to the flash.
|
|
*
|
|
* @param ctx context
|
|
*
|
|
* @return Number of bytes written to the image flash.
|
|
*/
|
|
size_t flash_img_bytes_written(struct flash_img_context *ctx);
|
|
|
|
/**
|
|
* @brief Process input buffers to be written to the image slot 1. flash
|
|
* memory in single blocks. Will store remainder between calls.
|
|
*
|
|
* A final call to this function with flush set to true
|
|
* will write out the remaining block buffer to flash. Since flash is written to
|
|
* in blocks, the contents of flash from the last byte written up to the next
|
|
* multiple of CONFIG_IMG_BLOCK_BUF_SIZE is padded with 0xff.
|
|
*
|
|
* @param ctx context
|
|
* @param data data to write
|
|
* @param len Number of bytes to write
|
|
* @param flush when true this forces any buffered
|
|
* data to be written to flash
|
|
*
|
|
* @return 0 on success, negative errno code on fail
|
|
*/
|
|
int flash_img_buffered_write(struct flash_img_context *ctx, u8_t *data,
|
|
size_t len, bool flush);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* ZEPHYR_INCLUDE_DFU_FLASH_IMG_H_ */
|