mikroSDK Reference Manual
diskio.h
1/*-----------------------------------------------------------------------/
2/ Low level disk interface modlue include file (C)ChaN, 2019 /
3/-----------------------------------------------------------------------*/
4
5#ifndef _DISKIO_DEFINED
6#define _DISKIO_DEFINED
7
8#ifdef __cplusplus
9extern "C" {
10#endif
11
12#include "generic_pointer.h"
13
14/* Status of Disk Functions */
15typedef BYTE DSTATUS;
16
17/* Results of Disk Functions */
18typedef enum {
19 RES_OK = 0, /* 0: Successful */
20 RES_ERROR, /* 1: R/W Error */
21 RES_WRPRT, /* 2: Write Protected */
22 RES_NOTRDY, /* 3: Not Ready */
23 RES_PARERR /* 4: Invalid Parameter */
24} DRESULT;
25
26
27/*---------------------------------------*/
28/* Prototypes for disk control functions */
29
30
31DSTATUS disk_initialize (BYTE pdrv);
32DSTATUS disk_status (BYTE pdrv);
33DRESULT disk_read (BYTE pdrv, BYTE* buff, LBA_t sector, UINT count);
34DRESULT disk_write (BYTE pdrv, const BYTE* __generic_ptr buff, LBA_t sector, UINT count);
35DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
36
37
38/* Disk Status Bits (DSTATUS) */
39
40#define STA_NOINIT 0x01 /* Drive not initialized */
41#define STA_NODISK 0x02 /* No medium in the drive */
42#define STA_PROTECT 0x04 /* Write protected */
43
44
45/* Command code for disk_ioctrl fucntion */
46
47/* Generic command (Used by FatFs) */
48#define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */
49#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */
50#define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
51#define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */
52#define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */
53
54/* Generic command (Not used by FatFs) */
55#define CTRL_POWER 5 /* Get/Set power status */
56#define CTRL_LOCK 6 /* Lock/Unlock media removal */
57#define CTRL_EJECT 7 /* Eject media */
58#define CTRL_FORMAT 8 /* Create physical format on the media */
59
60/* MMC/SDC specific ioctl command */
61#define MMC_GET_TYPE 10 /* Get card type */
62#define MMC_GET_CSD 11 /* Get CSD */
63#define MMC_GET_CID 12 /* Get CID */
64#define MMC_GET_OCR 13 /* Get OCR */
65#define MMC_GET_SDSTAT 14 /* Get SD status */
66#define ISDIO_READ 55 /* Read data form SD iSDIO register */
67#define ISDIO_WRITE 56 /* Write data to SD iSDIO register */
68#define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */
69
70/* ATA/CF specific ioctl command */
71#define ATA_GET_REV 20 /* Get F/W revision */
72#define ATA_GET_MODEL 21 /* Get model name */
73#define ATA_GET_SN 22 /* Get serial number */
74
75#ifdef __cplusplus
76}
77#endif
78
79#endif