735 lines
24 KiB
C
735 lines
24 KiB
C
/*
|
|
* Copyright (c) 2013-2019 Huawei Technologies Co., Ltd. All rights reserved.
|
|
* Copyright (c) 2020-2021 Huawei Device Co., Ltd. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice, this list of
|
|
* conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice, this list
|
|
* of conditions and the following disclaimer in the documentation and/or other materials
|
|
* provided with the distribution.
|
|
*
|
|
* 3. Neither the name of the copyright holder nor the names of its contributors may be used
|
|
* to endorse or promote products derived from this software without specific prior written
|
|
* permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
|
|
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup disk Disk
|
|
* @ingroup filesystem
|
|
*/
|
|
|
|
#ifndef _DISK_H
|
|
#define _DISK_H
|
|
|
|
#include "fs/fs.h"
|
|
#include "los_base.h"
|
|
#include "pthread.h"
|
|
|
|
#ifdef LOSCFG_FS_FAT_CACHE
|
|
#include "bcache.h"
|
|
#endif
|
|
|
|
#include "pthread.h"
|
|
|
|
#ifdef __cplusplus
|
|
#if __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#endif /* __cplusplus */
|
|
|
|
#define SYS_MAX_DISK 5
|
|
#define MAX_DIVIDE_PART_PER_DISK 16
|
|
#define MAX_PRIMARY_PART_PER_DISK 4
|
|
#define SYS_MAX_PART (SYS_MAX_DISK * MAX_DIVIDE_PART_PER_DISK)
|
|
#define DISK_NAME 255
|
|
#define DISK_MAX_SECTOR_SIZE 512
|
|
|
|
#define PAR_OFFSET 446 /* MBR: Partition table offset (2) */
|
|
#define BS_SIG55AA 510 /* Signature word (2) */
|
|
#define BS_FILSYSTEMTYPE32 82 /* File system type (1) */
|
|
#define BS_JMPBOOT 0 /* x86 jump instruction (3-byte) */
|
|
#define BS_FILSYSTYPE 0x36 /* File system type (2) */
|
|
#define BS_SIG55AA_VALUE 0xAA55
|
|
|
|
#define PAR_TYPE_OFFSET 4
|
|
#define PAR_START_OFFSET 8
|
|
#define PAR_COUNT_OFFSET 12
|
|
#define PAR_TABLE_SIZE 16
|
|
#define EXTENDED_PAR 0x0F
|
|
#define EXTENDED_8G 0x05
|
|
#define EMMC 0xEC
|
|
#define OTHERS 0x01 /* sdcard or umass */
|
|
|
|
#define BS_FS_TYPE_MASK 0xFFFFFF
|
|
#define BS_FS_TYPE_VALUE 0x544146
|
|
#define BS_FS_TYPE_FAT 0x0B
|
|
#define BS_FS_TYPE_NTFS 0x07
|
|
|
|
#define FIRST_BYTE 1
|
|
#define SECOND_BYTE 2
|
|
#define THIRD_BYTE 3
|
|
#define FOURTH_BYTE 4
|
|
|
|
#define BIT_FOR_BYTE 8
|
|
|
|
#define LD_WORD_DISK(ptr) (UINT16)(((UINT16)*((UINT8 *)(ptr) + FIRST_BYTE) << (BIT_FOR_BYTE * FIRST_BYTE)) | \
|
|
(UINT16)*(UINT8 *)(ptr))
|
|
#define LD_DWORD_DISK(ptr) (UINT32)(((UINT32)*((UINT8 *)(ptr) + THIRD_BYTE) << (BIT_FOR_BYTE * THIRD_BYTE)) | \
|
|
((UINT32)*((UINT8 *)(ptr) + SECOND_BYTE) << (BIT_FOR_BYTE * SECOND_BYTE)) | \
|
|
((UINT16)*((UINT8 *)(ptr) + FIRST_BYTE) << (BIT_FOR_BYTE * FIRST_BYTE)) | \
|
|
(*(UINT8 *)(ptr)))
|
|
|
|
#define LD_QWORD_DISK(ptr) ((UINT64)(((UINT64)LD_DWORD_DISK(&(ptr)[FOURTH_BYTE]) << (BIT_FOR_BYTE * FOURTH_BYTE)) | \
|
|
LD_DWORD_DISK(ptr)))
|
|
|
|
/* Check VBR string, including FAT, NTFS */
|
|
#define VERIFY_FS(ptr) (((LD_DWORD_DISK(&(ptr)[BS_FILSYSTEMTYPE32]) & BS_FS_TYPE_MASK) == BS_FS_TYPE_VALUE) || \
|
|
!strncmp(&(ptr)[BS_FILSYSTYPE], "FAT", strlen("FAT")) || \
|
|
!strncmp(&(ptr)[BS_JMPBOOT], "\xEB\x52\x90" "NTFS ", \
|
|
strlen("\xEB\x52\x90" "NTFS ")))
|
|
|
|
#define PARTION_MODE_BTYE (PAR_OFFSET + PAR_TYPE_OFFSET) /* 0xEE: GPT(GUID), else: MBR */
|
|
#define PARTION_MODE_GPT 0xEE /* 0xEE: GPT(GUID), else: MBR */
|
|
#define SIGNATURE_OFFSET 0 /* The offset of GPT partition header signature */
|
|
#define SIGNATURE_LEN 8 /* The length of GPT signature */
|
|
#define HEADER_SIZE_OFFSET 12 /* The offset of GPT header size */
|
|
#define TABLE_SIZE_OFFSET 84 /* The offset of GPT table size */
|
|
#define TABLE_NUM_OFFSET 80 /* The number of GPT table */
|
|
#define TABLE_START_SECTOR 2
|
|
#define TABLE_MAX_NUM 128
|
|
#define TABLE_SIZE 128
|
|
#define GPT_PAR_START_OFFSET 32
|
|
#define GPT_PAR_END_OFFSET 40
|
|
#define PAR_ENTRY_NUM_PER_SECTOR 4
|
|
#define HEADER_SIZE_MASK 0xFFFFFFFF
|
|
#define HEADER_SIZE 0x5C
|
|
#define HARD_DISK_GUID_OFFSET 56
|
|
#define HARD_DISK_GUID_FOR_ESP 0x0020004900460045
|
|
#define HARD_DISK_GUID_FOR_MSP 0x007200630069004D
|
|
#define PAR_VALID_OFFSET0 0
|
|
#define PAR_VALID_OFFSET1 4
|
|
#define PAR_VALID_OFFSET2 8
|
|
#define PAR_VALID_OFFSET3 12
|
|
|
|
#define VERIFY_GPT(ptr) ((!strncmp(&(ptr)[SIGNATURE_OFFSET], "EFI PART", SIGNATURE_LEN)) && \
|
|
((LD_DWORD_DISK(&(ptr)[HEADER_SIZE_OFFSET]) & HEADER_SIZE_MASK) == HEADER_SIZE))
|
|
|
|
#define VERITY_PAR_VALID(ptr) ((LD_DWORD_DISK(&(ptr)[PAR_VALID_OFFSET0]) + \
|
|
LD_DWORD_DISK(&(ptr)[PAR_VALID_OFFSET1]) + \
|
|
LD_DWORD_DISK(&(ptr)[PAR_VALID_OFFSET2]) + \
|
|
LD_DWORD_DISK(&(ptr)[PAR_VALID_OFFSET3])) != 0)
|
|
|
|
/* ESP MSP */
|
|
#define VERITY_AVAILABLE_PAR(ptr) ((LD_QWORD_DISK(&(ptr)[HARD_DISK_GUID_OFFSET]) != HARD_DISK_GUID_FOR_ESP) && \
|
|
(LD_QWORD_DISK(&(ptr)[HARD_DISK_GUID_OFFSET]) != HARD_DISK_GUID_FOR_MSP))
|
|
|
|
/* Command code for disk_ioctrl function */
|
|
/* Generic command (Used by FatFs) */
|
|
#define DISK_CTRL_SYNC 0 /* Complete pending write process */
|
|
#define DISK_GET_SECTOR_COUNT 1 /* Get media size */
|
|
#define DISK_GET_SECTOR_SIZE 2 /* Get sector size */
|
|
#define DISK_GET_BLOCK_SIZE 3 /* Get erase block size */
|
|
#define DISK_CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used */
|
|
|
|
/* Generic command (Not used by FatFs) */
|
|
#define DISK_CTRL_POWER 5 /* Get/Set power status */
|
|
#define DISK_CTRL_LOCK 6 /* Lock/Unlock media removal */
|
|
#define DISK_CTRL_EJECT 7 /* Eject media */
|
|
#define DISK_CTRL_FORMAT 8 /* Create physical format on the media */
|
|
|
|
/* MMC/SDC specific ioctl command */
|
|
#define DISK_MMC_GET_TYPE 10 /* Get card type */
|
|
#define DISK_MMC_GET_CSD 11 /* Get CSD */
|
|
#define DISK_MMC_GET_CID 12 /* Get CID */
|
|
#define DISK_MMC_GET_OCR 13 /* Get OCR */
|
|
#define DISK_MMC_GET_SDSTAT 14 /* Get SD status */
|
|
|
|
/* ATA/CF specific ioctl command */
|
|
#define DISK_ATA_GET_REV 20 /* Get F/W revision */
|
|
#define DISK_ATA_GET_MODEL 21 /* Get model name */
|
|
#define DISK_ATA_GET_SN 22 /* Get serial number */
|
|
|
|
typedef enum _disk_status_ {
|
|
STAT_UNUSED,
|
|
STAT_INUSED,
|
|
STAT_UNREADY
|
|
} disk_status_e;
|
|
|
|
typedef struct _los_disk_ {
|
|
UINT32 disk_id : 8; /* physics disk number */
|
|
UINT32 disk_status : 2; /* status of disk */
|
|
UINT32 part_count : 8; /* current partition count */
|
|
UINT32 reserved : 14;
|
|
struct Vnode *dev; /* device */
|
|
#ifdef LOSCFG_FS_FAT_CACHE
|
|
OsBcache *bcache; /* cache of the disk, shared in all partitions */
|
|
#endif
|
|
UINT32 sector_size; /* disk sector size */
|
|
UINT64 sector_start; /* disk start sector */
|
|
UINT64 sector_count; /* disk sector number */
|
|
UINT8 type;
|
|
CHAR *disk_name;
|
|
LOS_DL_LIST head; /* link head of all the partitions */
|
|
struct pthread_mutex disk_mutex;
|
|
} los_disk;
|
|
|
|
typedef struct _los_part_ {
|
|
UINT32 disk_id : 8; /* physics disk number */
|
|
UINT32 part_id : 8; /* partition number in the system */
|
|
UINT32 part_no_disk : 8; /* partition number in the disk */
|
|
UINT32 part_no_mbr : 5; /* partition number in the mbr */
|
|
UINT32 reserved : 3;
|
|
UINT8 filesystem_type; /* filesystem used in the partition */
|
|
UINT8 type;
|
|
struct Vnode *dev; /* dev devices used in the partition */
|
|
CHAR *part_name;
|
|
UINT64 sector_start; /*
|
|
* offset of a partition to the primary devices
|
|
* (multi-mbr partitions are seen as same parition)
|
|
*/
|
|
UINT64 sector_count; /*
|
|
* sector numbers of a partition. If there is no addpartition operation,
|
|
* then all the mbr devices equal to the primary device count.
|
|
*/
|
|
LOS_DL_LIST list; /* linklist of partition */
|
|
} los_part;
|
|
|
|
struct partition_info {
|
|
UINT8 type;
|
|
UINT64 sector_start;
|
|
UINT64 sector_count;
|
|
};
|
|
|
|
struct disk_divide_info {
|
|
UINT64 sector_count;
|
|
UINT32 sector_size;
|
|
UINT32 part_count;
|
|
/*
|
|
* The primary partition place should be reversed and set to 0 in case all the partitions are
|
|
* logical partition (maximum 16 currently). So the maximum part number should be 4 + 16.
|
|
*/
|
|
struct partition_info part[MAX_DIVIDE_PART_PER_DISK + MAX_PRIMARY_PART_PER_DISK];
|
|
};
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Disk driver initialization.
|
|
*
|
|
* @par Description:
|
|
* Initializate a disk dirver, and set the block cache.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The parameter diskName must point a valid string, which end with the terminating null byte.</li>
|
|
* <li>The total length of parameter diskName must be less than the value defined by PATH_MAX.</li>
|
|
* <li>The parameter bops must pointed the right functions, otherwise the system
|
|
* will crash when the disk is being operated.</li>
|
|
* <li>The parameter info can be null or point to struct disk_divide_info. when info is null,
|
|
* the disk will be divided base the information of MBR, otherwise,
|
|
* the disk will be divided base the information of parameter info.</li>
|
|
* </ul>
|
|
*
|
|
* @param diskName [IN] Type #const CHAR * disk driver name.
|
|
* @param bops [IN] Type #const struct block_operations * block driver control sturcture.
|
|
* @param priv [IN] Type #VOID * private data of vnode.
|
|
* @param diskID [IN] Type #INT32 disk id number, less than SYS_MAX_DISK.
|
|
* @param info [IN] Type #VOID * disk driver partition information.
|
|
*
|
|
* @retval #0 Initialization success.
|
|
* @retval #-1 Initialization failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_disk_deinit
|
|
*
|
|
*/
|
|
INT32 los_disk_init(const CHAR *diskName, const struct block_operations *bops,
|
|
VOID *priv, INT32 diskID, VOID *info);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Destroy a disk driver.
|
|
*
|
|
* @par Description:
|
|
* Destroy a disk driver, free the dependent resource.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param diskID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
*
|
|
* @retval #0 Destroy success.
|
|
* @retval #-1 Destroy failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_disk_init
|
|
*
|
|
*/
|
|
INT32 los_disk_deinit(INT32 diskID);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Read data from disk driver.
|
|
*
|
|
* @par Description:
|
|
* Read data from disk driver.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The sector size of the disk to be read should be acquired by los_part_ioctl before calling this function.</li>
|
|
* <li>The parameter buf must point to a valid memory and the buf size is count * sector_size.</li>
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
* @param buf [OUT] Type #VOID * memory which used to store read data.
|
|
* @param sector [IN] Type #UINT64 expected start sector number to read.
|
|
* @param count [IN] Type #UINT32 expected sector count to read.
|
|
* @param useRead [IN] Type #BOOL set FALSE to use the write block for optimization
|
|
*
|
|
* @retval #0 Read success.
|
|
* @retval #-1 Read failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_disk_write
|
|
*
|
|
*/
|
|
INT32 los_disk_read(INT32 drvID, VOID *buf, UINT64 sector, UINT32 count, BOOL useRead);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Write data to a disk driver.
|
|
*
|
|
* @par Description:
|
|
* Write data to a disk driver.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The sector size of the disk to be read should be acquired by los_part_ioctl before calling this function.</li>
|
|
* <li>The parameter buf must point to a valid memory and the buf size is count * sector_size.</li>
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
* @param buf [IN] Type #const VOID * memory which used to storage write data.
|
|
* @param sector [IN] Type #UINT64 expected start sector number to read.
|
|
* @param count [IN] Type #UINT32 experted sector count of write.
|
|
*
|
|
* @retval #0 Write success.
|
|
* @retval #-1 Write failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_disk_read
|
|
*
|
|
*/
|
|
INT32 los_disk_write(INT32 drvID, const VOID *buf, UINT64 sector, UINT32 count);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Get information of disk driver.
|
|
*
|
|
* @par Description:
|
|
* Get information of disk driver.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
* @param cmd [IN] Type #INT32 command to issu, currently support GET_SECTOR_COUNT, GET_SECTOR_SIZE,
|
|
* GET_BLOCK_SIZE, CTRL_SYNC.
|
|
* @param buf [OUT] Type #VOID * memory to storage the information, the size must enough for data type(UINT64)
|
|
* when cmd type is DISK_GET_SECTOR_COUNT, others is size_t.
|
|
*
|
|
* @retval #0 Get information success.
|
|
* @retval #-1 Get information failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 los_disk_ioctl(INT32 drvID, INT32 cmd, VOID *buf);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Sync blib cache.
|
|
*
|
|
* @par Description:
|
|
* Sync blib cache, write the valid data to disk driver.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
*
|
|
* @retval #0 Sync success.
|
|
* @retval #INT32 Sync failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 los_disk_sync(INT32 drvID);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Set blib cache for the disk driver.
|
|
*
|
|
* @par Description:
|
|
* Set blib cache for the disk driver, users can set the number of sectors of per block,
|
|
* and the number of blocks.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk driver id number, less than the value defined by SYS_MAX_DISK.
|
|
* @param sectorPerBlock [IN] Type #UINT32 sector number of per block, only can be 32 * (1, 2, ..., 8).
|
|
* @param blockNum [IN] Type #UINT32 block number of cache.
|
|
*
|
|
* @retval #0 Set success.
|
|
* @retval #INT32 Set failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 los_disk_set_bcache(INT32 drvID, UINT32 sectorPerBlock, UINT32 blockNum);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Read data from chosen partition.
|
|
*
|
|
* @par Description:
|
|
* Read data from chosen partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The sector size of the disk to be read should be acquired by los_part_ioctl before calling this function.</li>
|
|
* <li>The parameter buf must point to valid memory and the buf size is count * sector_size.</li>
|
|
* </ul>
|
|
*
|
|
* @param pt [IN] Type #INT32 partition number, less than the value defined by SYS_MAX_PART.
|
|
* @param buf [OUT] Type #VOID * memory which used to store the data to be read.
|
|
* @param sector [IN] Type #UINT64 start sector number of chosen partition.
|
|
* @param count [IN] Type #UINT32 the expected sector count for reading.
|
|
* @param useRead [IN] Type #BOOL FALSE when reading large contiguous data, TRUE for other situations
|
|
*
|
|
* @retval #0 Read success.
|
|
* @retval #-1 Read failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_part_read
|
|
*
|
|
*/
|
|
INT32 los_part_read(INT32 pt, VOID *buf, UINT64 sector, UINT32 count, BOOL useRead);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Write data to chosen partition.
|
|
*
|
|
* @par Description:
|
|
* Write data to chosen partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The sector size of the disk to be write should be acquired by los_part_ioctl before calling this function.</li>
|
|
* <li>The parameter buf must point to valid memory and the buf size is count * sector_size.</li>
|
|
* </ul>
|
|
*
|
|
* @param pt [IN] Type #INT32 partition number,less than the value defined by SYS_MAX_PART.
|
|
* @param buf [IN] Type #VOID * memory which used to storage the written data.
|
|
* @param sector [IN] Type #UINT64 start sector number of chosen partition.
|
|
* @param count [IN] Type #UINT32 the expected sector count for write.
|
|
*
|
|
* @retval #0 Write success.
|
|
* @retval #-1 Write failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_part_read
|
|
*
|
|
*/
|
|
INT32 los_part_write(INT32 pt, const VOID *buf, UINT64 sector, UINT32 count);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Clear the bcache data
|
|
*
|
|
* @par Description:
|
|
* Flush the data and mark the block as unused.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param drvID [IN] Type #INT32 disk id
|
|
*
|
|
* @retval #0 Write success.
|
|
* @retval #-1 Write failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_part_read
|
|
*
|
|
*/
|
|
INT32 los_disk_cache_clear(INT32 drvID);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Get information of chosen partition.
|
|
*
|
|
* @par Description:
|
|
* By passed command to get information of chosen partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param pt [IN] Type #INT32 partition number,less than the value defined by SYS_MAX_PART.
|
|
* @param cmd [IN] Type #INT32 command to issu, currently support GET_SECTOR_COUNT, GET_SECTOR_SIZE,
|
|
* GET_BLOCK_SIZE, CTRL_SYNC.
|
|
* @param buf [OUT] Type #VOID * memory to store the information, the size must enough for data type (UINT64)
|
|
* when cmd type is DISK_GET_SECTOR_COUNT, others is size_t.
|
|
*
|
|
* @retval #0 Get information success.
|
|
* @retval #-1 Get information failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 los_part_ioctl(INT32 pt, INT32 cmd, VOID *buf);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Decide the chosen partition is exist or not.
|
|
*
|
|
* @par Description:
|
|
* Decide the chosen partition is exist or not.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The parameter dev is a full path, which begin with '/' and end with '/0'.</li>
|
|
* </ul>
|
|
*
|
|
* @param dev [IN] Type #const CHAR * partition driver name.
|
|
* @param mode [IN] Type #mode_t access modd.
|
|
*
|
|
* @retval #0 The chosen partition is exist.
|
|
* @retval #-1 The chosen partition is not exist.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 los_part_access(const CHAR *dev, mode_t mode);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Find disk partition.
|
|
*
|
|
* @par Description:
|
|
* By driver partition vnode to find disk partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param blkDriver [IN] Type #struct Vnode * partition driver vnode.
|
|
*
|
|
* @retval #NULL Can't find chosen disk partition.
|
|
* @retval #los_part * This is partition structure pointer of chosen disk partition.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
los_part *los_part_find(struct Vnode *blkDriver);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Find disk driver.
|
|
*
|
|
* @par Description:
|
|
* By disk driver id number to find disk dirver.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param id [IN] Type #INT32 disk id number,less than the value defined by SYS_MAX_DISK.
|
|
*
|
|
* @retval #NULL Can't find chosen disk driver.
|
|
* @retval #los_disk * This is disk structure pointer of chosen disk driver.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
los_disk *get_disk(INT32 id);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Find disk partition.
|
|
*
|
|
* @par Description:
|
|
* By driver partition id number to find disk partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param id [IN] Type #INT32 partition id number,less than the value defined by SYS_MAX_PART.
|
|
*
|
|
* @retval #NULL Can't find chosen disk partition.
|
|
* @retval #los_part * This is partition structure pointer of chosen disk partition.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
los_part *get_part(INT32 id);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Print partition information.
|
|
*
|
|
* @par Description:
|
|
* Print partition information.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param part [IN] Type #los_part * partition control structure pointer
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
VOID show_part(los_part *part);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief Add a new mmc partition.
|
|
*
|
|
* @par Description:
|
|
* Add a new mmc partition, users can set the start sector and size of the new partition.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* None
|
|
* </ul>
|
|
*
|
|
* @param info [IN] Type #struct disk_divide_info * Disk driver information structure pointer.
|
|
* @param sectorStart [IN] Type #size_t Start sector number of the new partition.
|
|
* @param sectorCount [IN] Type #size_t Sector count of the new partition.
|
|
*
|
|
* @retval #0 Add partition success.
|
|
* @retval #-1 Add partition failed.
|
|
*
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see None
|
|
*
|
|
*/
|
|
INT32 add_mmc_partition(struct disk_divide_info *info, size_t sectorStart, size_t sectorCount);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief alloc a new UNUSED disk id.
|
|
*
|
|
* @par Description:
|
|
* Get a free disk id for new device.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The parameter diskName must point a valid string, which end with the null byte ('\0') </li>
|
|
* <li>The total length of parameter diskName must be less than the value defined by DISK_NAME </li>
|
|
* </ul>
|
|
*
|
|
* @param diskName [IN] Type #const CHAR * device name.
|
|
*
|
|
* @retval #INT32 available disk id
|
|
* @retval #-1 alloc disk id failed
|
|
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_get_diskid_byname
|
|
*
|
|
*/
|
|
INT32 los_alloc_diskid_byname(const CHAR *diskName);
|
|
|
|
/**
|
|
* @ingroup disk
|
|
* @brief get the INUSED disk id.
|
|
*
|
|
* @par Description:
|
|
* Get the correponding INUSED disk id by diskName.
|
|
*
|
|
* @attention
|
|
* <ul>
|
|
* <li>The parameter diskName must point a valid string, which end with the null byte ('\0') </li>
|
|
* <li>The total length of parameter diskName must be less than the value defined by DISK_NAME </li>
|
|
* </ul>
|
|
*
|
|
* @param diskName [IN] Type #const CHAR * device name.
|
|
*
|
|
* @retval #INT32 available disk id
|
|
* @retval #-1 get disk id failed
|
|
|
|
* @par Dependency:
|
|
* <ul><li>disk.h</li></ul>
|
|
* @see los_alloc_diskid_byname
|
|
*
|
|
*/
|
|
INT32 los_get_diskid_byname(const CHAR *diskName);
|
|
|
|
#ifdef __cplusplus
|
|
#if __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* __cplusplus */
|
|
|
|
#endif
|