1 /*************************************************************************** 2 * Copyright (c) 2024 Microsoft Corporation 3 * 4 * This program and the accompanying materials are made available under the 5 * terms of the MIT License which is available at 6 * https://opensource.org/licenses/MIT. 7 * 8 * SPDX-License-Identifier: MIT 9 **************************************************************************/ 10 11 12 /**************************************************************************/ 13 /**************************************************************************/ 14 /** */ 15 /** LevelX Component */ 16 /** */ 17 /** NAND Flash */ 18 /** */ 19 /**************************************************************************/ 20 /**************************************************************************/ 21 22 #define LX_SOURCE_CODE 23 24 25 /* Disable ThreadX error checking. */ 26 27 #ifndef LX_DISABLE_ERROR_CHECKING 28 #define LX_DISABLE_ERROR_CHECKING 29 #endif 30 31 32 /* Include necessary system files. */ 33 34 #include "lx_api.h" 35 36 37 /**************************************************************************/ 38 /* */ 39 /* FUNCTION RELEASE */ 40 /* */ 41 /* _lx_nand_flash_block_allocate PORTABLE C */ 42 /* 6.2.1 */ 43 /* AUTHOR */ 44 /* */ 45 /* Xiuwen Cai, Microsoft Corporation */ 46 /* */ 47 /* DESCRIPTION */ 48 /* */ 49 /* This function attempts to get a block in the free block list. */ 50 /* */ 51 /* INPUT */ 52 /* */ 53 /* nand_flash NAND flash instance */ 54 /* block Return block number */ 55 /* */ 56 /* OUTPUT */ 57 /* */ 58 /* return status */ 59 /* */ 60 /* CALLS */ 61 /* */ 62 /* None */ 63 /* */ 64 /* CALLED BY */ 65 /* */ 66 /* Internal LevelX */ 67 /* */ 68 /* RELEASE HISTORY */ 69 /* */ 70 /* DATE NAME DESCRIPTION */ 71 /* */ 72 /* 03-08-2023 Xiuwen Cai Initial Version 6.2.1 */ 73 /* */ 74 /**************************************************************************/ _lx_nand_flash_block_allocate(LX_NAND_FLASH * nand_flash,ULONG * block)75UINT _lx_nand_flash_block_allocate(LX_NAND_FLASH* nand_flash, ULONG* block) 76 { 77 78 79 /* Check if the free block list is empty. */ 80 if (nand_flash -> lx_nand_flash_free_block_list_tail == 0) 81 { 82 83 /* Empty list, return error. */ 84 return(LX_NO_BLOCKS); 85 } 86 87 /* Remove one block from the list. */ 88 nand_flash -> lx_nand_flash_free_block_list_tail--; 89 90 /* Return the block number. */ 91 *block = nand_flash -> lx_nand_flash_block_list[nand_flash -> lx_nand_flash_free_block_list_tail]; 92 93 /* Return successful completion. */ 94 return(LX_SUCCESS); 95 } 96 97
