mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
e181a40c9f
This is a breaking change: applications which used diskio.h to call ff_diskio_register, will now need to include diskio_impl.h. Including diskio.h will include the original diskio.h header from FatFS library.
67 lines
2.2 KiB
C
67 lines
2.2 KiB
C
// Copyright 2017-2019 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "diskio.h"
|
|
#include "esp_err.h"
|
|
|
|
/**
|
|
* Structure of pointers to disk IO driver functions.
|
|
*
|
|
* See FatFs documentation for details about these functions
|
|
*/
|
|
typedef struct {
|
|
DSTATUS (*init) (BYTE pdrv); /*!< disk initialization function */
|
|
DSTATUS (*status) (BYTE pdrv); /*!< disk status check function */
|
|
DRESULT (*read) (BYTE pdrv, BYTE* buff, DWORD sector, UINT count); /*!< sector read function */
|
|
DRESULT (*write) (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count); /*!< sector write function */
|
|
DRESULT (*ioctl) (BYTE pdrv, BYTE cmd, void* buff); /*!< function to get info about disk and do some misc operations */
|
|
} ff_diskio_impl_t;
|
|
|
|
/**
|
|
* Register or unregister diskio driver for given drive number.
|
|
*
|
|
* When FATFS library calls one of disk_xxx functions for driver number pdrv,
|
|
* corresponding function in discio_impl for given pdrv will be called.
|
|
*
|
|
* @param pdrv drive number
|
|
* @param discio_impl pointer to ff_diskio_impl_t structure with diskio functions
|
|
* or NULL to unregister and free previously registered drive
|
|
*/
|
|
void ff_diskio_register(BYTE pdrv, const ff_diskio_impl_t* discio_impl);
|
|
|
|
#define ff_diskio_unregister(pdrv_) ff_diskio_register(pdrv_, NULL)
|
|
|
|
|
|
/**
|
|
* Get next available drive number
|
|
*
|
|
* @param out_pdrv pointer to the byte to set if successful
|
|
*
|
|
* @return ESP_OK on success
|
|
* ESP_ERR_NOT_FOUND if all drives are attached
|
|
*/
|
|
esp_err_t ff_diskio_get_drive(BYTE* out_pdrv);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|