XFlash_Unlock - 2021.1 English

Xilinx Standalone Library Documentation OS and Libraries Document Collection (UG643)

Document ID
Release Date
2021.1 English

This function Unlocks the blocks in the specified range of the flash device(s).

The device is polled until an error or the operation completes successfully.

Note: None.


int XFlash_Unlock(XFlash *InstancePtr, u32 Offset, u32 Bytes);


The following table lists the XFlash_Unlock function arguments.

Table 1. XFlash_Unlock Arguments
Type Name Description
XFlash * InstancePtr Pointer to the XFlash instance.
u32 Offset Offset into the device(s) address space from which to begin block UnLocking. The first three bytes of every block is reserved for special purpose. The offset should be at least three bytes from start of the block.
u32 Bytes Number of bytes to UnLock in the Block starting from Offset.


  • XST_SUCCESS if successful.
  • XFLASH_ADDRESS_ERROR if the destination address range is not completely within the addressable areas of the device(s).