Head

GCC Code Coverage Report

Directory:	./		Exec	Total	Coverage
File:	lx_nand_flash_memory_initialize.c	Lines:	31	39	79.5 %
Date:	2024-12-12 16:33:39	Branches:	10	18	55.6 %


/***************************************************************************
 * Copyright (c) 2024 Microsoft Corporation
 *
 * This program and the accompanying materials are made available under the
 * terms of the MIT License which is available at
 * https://opensource.org/licenses/MIT.
 *
 * SPDX-License-Identifier: MIT
 **************************************************************************/


/**************************************************************************/
/**************************************************************************/
/**                                                                       */
/** LevelX Component                                                      */
/**                                                                       */
/**   NAND Flash                                                          */
/**                                                                       */
/**************************************************************************/
/**************************************************************************/

#define LX_SOURCE_CODE


/* Disable ThreadX error checking.  */

#ifndef LX_DISABLE_ERROR_CHECKING
#define LX_DISABLE_ERROR_CHECKING
#endif


/* Include necessary system files.  */

#include "lx_api.h"


/**************************************************************************/
/*                                                                        */
/*  FUNCTION                                               RELEASE        */
/*                                                                        */
/*    _lx_nand_flash_memory_initialize                    PORTABLE C      */
/*                                                           6.2.1       */
/*  AUTHOR                                                                */
/*                                                                        */
/*    Xiuwen Cai, Microsoft Corporation                                   */
/*                                                                        */
/*  DESCRIPTION                                                           */
/*                                                                        */
/*    This function imitialize memory buffer for NAND flash instance.     */
/*                                                                        */
/*  INPUT                                                                 */
/*                                                                        */
/*    nand_flash                            NAND flash instance           */
/*    memory_ptr                            Pointer to memory used by the */
/*                                            LevelX for this NAND.       */
/*    memory_size                           Size of memory                */
/*                                                                        */
/*  OUTPUT                                                                */
/*                                                                        */
/*    return status                                                       */
/*                                                                        */
/*  CALLS                                                                 */
/*                                                                        */
/*    LX_MEMSET                             Initialize memory             */
/*                                                                        */
/*  CALLED BY                                                             */
/*                                                                        */
/*    Internal LevelX                                                     */
/*                                                                        */
/*  RELEASE HISTORY                                                       */
/*                                                                        */
/*    DATE              NAME                      DESCRIPTION             */
/*                                                                        */
/*  03-08-2023     Xiuwen Cai               Initial Version 6.2.1        */
/*                                                                        */
/**************************************************************************/
UINT  _lx_nand_flash_memory_initialize(LX_NAND_FLASH  *nand_flash, ULONG* memory_ptr, UINT memory_size)
{

UINT    memory_offset;
UINT    buffer_size;


    /* Clear the memory buffer.  */
    LX_MEMSET(memory_ptr, 0, memory_size);

    /* Reset the memory offset.  */
    memory_offset = 0;

    /* Set memory size for block mapping table.  */
    buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_mapping_table);

    /* Make sure the size is at least one page size.  */
    if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
    {
        buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
    }

    /* Assign memory for block mapping table.  */
    nand_flash -> lx_nand_flash_block_mapping_table = (USHORT*)(((UCHAR*)memory_ptr) + memory_offset);

    /* Update block mapping table size.  */
    nand_flash -> lx_nand_flash_block_mapping_table_size = buffer_size;

    /* Update memory offset.  */
    memory_offset += buffer_size;

    /* Check if there is enough memory.  */
    if (memory_offset > memory_size)
    {

        /* No enough memory, return error.  */
        return(LX_NO_MEMORY);
    }

    /* Set memory size for erase count table.  */
    buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_erase_count_table);

    /* Make sure the size is at least one page size.  */
    if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
    {
        buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
    }

    /* Assign memory for erase count table.  */
    nand_flash -> lx_nand_flash_erase_count_table = (UCHAR*)(((UCHAR*)memory_ptr) + memory_offset);

    /* Update memory offset.  */
    memory_offset += buffer_size;

    /* Update erase count table size.  */
    nand_flash -> lx_nand_flash_erase_count_table_size = buffer_size;

    /* Check if there is enough memory.  */
    if (memory_offset > memory_size)
    {

        /* No enough memory, return error.  */
        return(LX_NO_MEMORY);
    }

    /* Assign memory for block list.  */
    nand_flash -> lx_nand_flash_block_list = (USHORT*)(((UCHAR*)memory_ptr) + memory_offset);

    /* Update memory offset.  */
    memory_offset += nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_list);

    /* Check if there is enough memory.  */
    if (memory_offset > memory_size)
    {

        /* No enough memory, return error.  */
        return(LX_NO_MEMORY);
    }

    /* Update block list size.  */
    nand_flash -> lx_nand_flash_block_list_size = nand_flash -> lx_nand_flash_total_blocks;

    /* Initialize block list. */
    nand_flash -> lx_nand_flash_free_block_list_tail = 0;
    nand_flash -> lx_nand_flash_mapped_block_list_head = nand_flash -> lx_nand_flash_block_list_size - 1;

    /* Set memory size for block status table.  */
    buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_status_table);

    /* Make sure the size is at least one page size.  */
    if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
    {
        buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
    }

    /* Assign memory for block status table.  */
    nand_flash -> lx_nand_flash_block_status_table = (USHORT*)(((UCHAR*)memory_ptr) + memory_offset);

    /* Update memory offset.  */
    memory_offset += buffer_size;

    /* Update block status table size.  */
    nand_flash -> lx_nand_flash_block_status_table_size = buffer_size;

    /* Check if there is enough memory.  */
    if (memory_offset > memory_size)
    {

        /* No enough memory, return error.  */
        return(LX_NO_MEMORY);
    }

    /* Assign memory for page buffer.  */
    nand_flash -> lx_nand_flash_page_buffer = ((UCHAR*)memory_ptr) + memory_offset;

    /* Update page buffer size.  */
    nand_flash -> lx_nand_flash_page_buffer_size = memory_size - memory_offset;

    /* Check if there is enough memory.  */
    if (nand_flash -> lx_nand_flash_page_buffer_size < (nand_flash -> lx_nand_flash_bytes_per_page + nand_flash -> lx_nand_flash_spare_total_length) * 2)
    {

        /* No enough memory, return error.  */
        return(LX_NO_MEMORY);
    }

    /* Return a successful completion.  */
    return(LX_SUCCESS);
}



Generated by: GCOVR (Version 4.1)

Line	Branch	Exec	Source
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_memory_initialize PORTABLE C */
42			/* 6.2.1 */
43			/* AUTHOR */
44			/* */
45			/* Xiuwen Cai, Microsoft Corporation */
46			/* */
47			/* DESCRIPTION */
48			/* */
49			/* This function imitialize memory buffer for NAND flash instance. */
50			/* */
51			/* INPUT */
52			/* */
53			/* nand_flash NAND flash instance */
54			/* memory_ptr Pointer to memory used by the */
55			/* LevelX for this NAND. */
56			/* memory_size Size of memory */
57			/* */
58			/* OUTPUT */
59			/* */
60			/* return status */
61			/* */
62			/* CALLS */
63			/* */
64			/* LX_MEMSET Initialize memory */
65			/* */
66			/* CALLED BY */
67			/* */
68			/* Internal LevelX */
69			/* */
70			/* RELEASE HISTORY */
71			/* */
72			/* DATE NAME DESCRIPTION */
73			/* */
74			/* 03-08-2023 Xiuwen Cai Initial Version 6.2.1 */
75			/* */
76			/**************************************************************************/
77		9	UINT _lx_nand_flash_memory_initialize(LX_NAND_FLASH nand_flash, ULONG memory_ptr, UINT memory_size)
78			{
79
80			UINT memory_offset;
81			UINT buffer_size;
82
83
84			/* Clear the memory buffer. */
85	✓✓	74025	LX_MEMSET(memory_ptr, 0, memory_size);
86
87			/* Reset the memory offset. */
88		9	memory_offset = 0;
89
90			/* Set memory size for block mapping table. */
91		9	buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_mapping_table);
92
93			/* Make sure the size is at least one page size. */
94	✗✓	9	if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
95			{
96			buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
97			}
98
99			/* Assign memory for block mapping table. */
100		9	nand_flash -> lx_nand_flash_block_mapping_table = (USHORT)(((UCHAR)memory_ptr) + memory_offset);
101
102			/* Update block mapping table size. */
103		9	nand_flash -> lx_nand_flash_block_mapping_table_size = buffer_size;
104
105			/* Update memory offset. */
106		9	memory_offset += buffer_size;
107
108			/* Check if there is enough memory. */
109	✗✓	9	if (memory_offset > memory_size)
110			{
111
112			/* No enough memory, return error. */
113			return(LX_NO_MEMORY);
114			}
115
116			/* Set memory size for erase count table. */
117		9	buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_erase_count_table);
118
119			/* Make sure the size is at least one page size. */
120	✗✓	9	if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
121			{
122			buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
123			}
124
125			/* Assign memory for erase count table. */
126		9	nand_flash -> lx_nand_flash_erase_count_table = (UCHAR)(((UCHAR)memory_ptr) + memory_offset);
127
128			/* Update memory offset. */
129		9	memory_offset += buffer_size;
130
131			/* Update erase count table size. */
132		9	nand_flash -> lx_nand_flash_erase_count_table_size = buffer_size;
133
134			/* Check if there is enough memory. */
135	✗✓	9	if (memory_offset > memory_size)
136			{
137
138			/* No enough memory, return error. */
139			return(LX_NO_MEMORY);
140			}
141
142			/* Assign memory for block list. */
143		9	nand_flash -> lx_nand_flash_block_list = (USHORT)(((UCHAR)memory_ptr) + memory_offset);
144
145			/* Update memory offset. */
146		9	memory_offset += nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_list);
147
148			/* Check if there is enough memory. */
149	✗✓	9	if (memory_offset > memory_size)
150			{
151
152			/* No enough memory, return error. */
153			return(LX_NO_MEMORY);
154			}
155
156			/* Update block list size. */
157		9	nand_flash -> lx_nand_flash_block_list_size = nand_flash -> lx_nand_flash_total_blocks;
158
159			/* Initialize block list. */
160		9	nand_flash -> lx_nand_flash_free_block_list_tail = 0;
161		9	nand_flash -> lx_nand_flash_mapped_block_list_head = nand_flash -> lx_nand_flash_block_list_size - 1;
162
163			/* Set memory size for block status table. */
164		9	buffer_size = nand_flash -> lx_nand_flash_total_blocks * sizeof(*nand_flash -> lx_nand_flash_block_status_table);
165
166			/* Make sure the size is at least one page size. */
167	✗✓	9	if (buffer_size < nand_flash -> lx_nand_flash_bytes_per_page)
168			{
169			buffer_size = nand_flash -> lx_nand_flash_bytes_per_page;
170			}
171
172			/* Assign memory for block status table. */
173		9	nand_flash -> lx_nand_flash_block_status_table = (USHORT)(((UCHAR)memory_ptr) + memory_offset);
174
175			/* Update memory offset. */
176		9	memory_offset += buffer_size;
177
178			/* Update block status table size. */
179		9	nand_flash -> lx_nand_flash_block_status_table_size = buffer_size;
180
181			/* Check if there is enough memory. */
182	✗✓	9	if (memory_offset > memory_size)
183			{
184
185			/* No enough memory, return error. */
186			return(LX_NO_MEMORY);
187			}
188
189			/* Assign memory for page buffer. */
190		9	nand_flash -> lx_nand_flash_page_buffer = ((UCHAR*)memory_ptr) + memory_offset;
191
192			/* Update page buffer size. */
193		9	nand_flash -> lx_nand_flash_page_buffer_size = memory_size - memory_offset;
194
195			/* Check if there is enough memory. */
196	✗✓	9	if (nand_flash -> lx_nand_flash_page_buffer_size < (nand_flash -> lx_nand_flash_bytes_per_page + nand_flash -> lx_nand_flash_spare_total_length) * 2)
197			{
198
199			/* No enough memory, return error. */
200			return(LX_NO_MEMORY);
201			}
202
203			/* Return a successful completion. */
204		9	return(LX_SUCCESS);
205			}
206