This function Locks the blocks in the specified range of the flash device(s).
The device is polled until an error or the operation completes successfully.
- XFLASH_ADDRESS_ERROR if the destination address range is not completely within the addressable areas of the device(s).
Note: Due to flash memory design, the range actually locked is larger than what
was specified by the Offset and Bytes parameters. This occurs if the parameters do not
align to block boundaries.
Prototype
int XFlash_Lock(XFlash *InstancePtr, u32 Offset, u32 Bytes);Parameters
The following table lists the XFlash_Lock function arguments.
| Type | Member | Description |
|---|---|---|
| XFlash * | InstancePtr | Pointer to the XFlash instance |
| u32 | Offset | Offset into the device(s) address space from which to begin block locking. The first three bytes of every block is reserved for special purpose. The offset must be at least three bytes from start of the block |
| u32 | Bytes | Number of bytes to Lock in the Block starting from Offset |
Returns
- XST_SUCCESS if successful.