mtd.h

Go to the documentation of this file.

/*
 * Copyright (C) 2016  OTA keys S.A.
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef MTD_H
#define MTD_H
 
#include <stdint.h>
#if MODULE_VFS
#include "vfs.h"
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum mtd_power_state {
    MTD_POWER_UP,    
    MTD_POWER_DOWN,  
};
 
typedef struct mtd_desc mtd_desc_t;
 
typedef struct {
    const mtd_desc_t *driver;  
    uint32_t sector_count;     
    uint32_t pages_per_sector; 
    uint32_t page_size;        
} mtd_dev_t;
 
struct mtd_desc {
    int (*init)(mtd_dev_t *dev);
 
    int (*read)(mtd_dev_t *dev,
                void *buff,
                uint32_t addr,
                uint32_t size);
 
    int (*read_page)(mtd_dev_t *dev,
                     void *buff,
                     uint32_t page,
                     uint32_t offset,
                     uint32_t size);
 
    int (*write)(mtd_dev_t *dev,
                 const void *buff,
                 uint32_t addr,
                 uint32_t size);
 
    int (*write_page)(mtd_dev_t *dev,
                      const void *buff,
                      uint32_t page,
                      uint32_t offset,
                      uint32_t size);
 
    int (*erase)(mtd_dev_t *dev,
                 uint32_t addr,
                 uint32_t size);
 
    int (*erase_sector)(mtd_dev_t *dev,
                        uint32_t sector,
                        uint32_t count);
 
    int (*power)(mtd_dev_t *dev, enum mtd_power_state power);
};
 
int mtd_init(mtd_dev_t *mtd);
 
int mtd_read(mtd_dev_t *mtd, void *dest, uint32_t addr, uint32_t count);
 
int mtd_read_page(mtd_dev_t *mtd, void *dest, uint32_t page, uint32_t offset, uint32_t size);
 
int mtd_write(mtd_dev_t *mtd, const void *src, uint32_t addr, uint32_t count);
 
int mtd_write_page(mtd_dev_t *mtd, const void *src, uint32_t page, uint32_t offset, uint32_t size);
 
int mtd_erase(mtd_dev_t *mtd, uint32_t addr, uint32_t count);
 
int mtd_erase_sector(mtd_dev_t *mtd, uint32_t sector, uint32_t num);
 
int mtd_power(mtd_dev_t *mtd, enum mtd_power_state power);
 
#if defined(MODULE_VFS) || defined(DOXYGEN)
 
extern const vfs_file_ops_t mtd_vfs_ops;
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif /* MTD_H */