Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

15.1.57. alt_write_flash()

Prototype

int alt_write_flash(alt_flash_fd* fd,

int offset,

const void* src_addr,


 int length)

Commonly Called By

C/C++ programs

Device drivers

Thread-safe

No.

Available from ISR

No.

Include

<sys/alt_flash.h>

Description

The alt_write_flash() function writes data to flash. The data to be written is at address src_addr. length bytes are written to the flash fd, offset bytes from the beginning of the flash device address space.

Call this function only when operating in single-threaded mode. This function does not preserve any unwritten areas of any flash sectors affected by this write.

For more information, refer to “Using Flash Devices” in the "Developing Programs Using the Hardware Abstraction Layer" chapter.

The only valid values for the fd parameter are those returned from the alt_flash_open_dev function. If any other value is passed, the behavior of this function is undefined.

Return

The return value is zero on success and nonzero otherwise.