ftl.h

浏览该文件的文档.

#ifndef __FEMU_FTL_H
#define __FEMU_FTL_H
 
#include "../nvme.h"
 
#define INVALID_PPA     (~(0ULL))
#define INVALID_LPN     (~(0ULL))
#define UNMAPPED_PPA    (~(0ULL))
 
enum {
    NAND_READ =  0,
    NAND_WRITE = 1,
    NAND_ERASE = 2,
 
    NAND_READ_LATENCY = 40000,
    NAND_PROG_LATENCY = 200000,
    NAND_ERASE_LATENCY = 2000000,
};
 
enum {
    USER_IO = 0,
    GC_IO = 1,
};
 
enum {
    SEC_FREE = 0,
    SEC_INVALID = 1,
    SEC_VALID = 2,
 
    PG_FREE = 0,
    PG_INVALID = 1,
    PG_VALID = 2
};
 
enum {
    FEMU_ENABLE_GC_DELAY = 1,
    FEMU_DISABLE_GC_DELAY = 2,
 
    FEMU_ENABLE_DELAY_EMU = 3,
    FEMU_DISABLE_DELAY_EMU = 4,
 
    FEMU_RESET_ACCT = 5,
    FEMU_ENABLE_LOG = 6,
    FEMU_DISABLE_LOG = 7,
};
 
 
#define BLK_BITS    (16)
#define PG_BITS     (16)
#define SEC_BITS    (8)
#define PL_BITS     (8)
#define LUN_BITS    (8)
#define CH_BITS     (7)
 
struct ppa {
    union {
        struct {
            uint64_t blk : BLK_BITS;
            uint64_t pg  : PG_BITS;
            uint64_t sec : SEC_BITS;
            uint64_t pl  : PL_BITS;
            uint64_t lun : LUN_BITS;
            uint64_t ch  : CH_BITS;
            uint64_t rsv : 1;
        } g;
 
        uint64_t ppa;
    };
};
 
typedef int nand_sec_status_t;
 
struct nand_page {
    nand_sec_status_t *sec;
    int nsecs;
    int status;
};
 
struct nand_block {
    struct nand_page *pg;
    int npgs;
    int ipc; 
    int vpc; 
    int erase_cnt;
    int wp; 
};
 
struct nand_plane {
    struct nand_block *blk;
    int nblks;
};
 
struct nand_lun {
    struct nand_plane *pl;
    int npls;
    uint64_t next_lun_avail_time;
    bool busy;
    uint64_t gc_endtime;
};
 
struct ssd_channel {
    struct nand_lun *lun;
    int nluns;
    uint64_t next_ch_avail_time;
    bool busy;
    uint64_t gc_endtime;
};
 
struct ssdparams {
    int secsz;        
    int secs_per_pg;  
    int pgs_per_blk;  
    int blks_per_pl;  
    int pls_per_lun;  
    int luns_per_ch;  
    int nchs;         
    int pg_rd_lat;    
    int pg_wr_lat;    
    int blk_er_lat;   
    int ch_xfer_lat;  
    double gc_thres_pcent;
    int gc_thres_lines;
    double gc_thres_pcent_high;
    int gc_thres_lines_high;
    bool enable_gc_delay;
 
    /* below are all calculated values */
    int secs_per_blk; 
    int secs_per_pl;  
    int secs_per_lun; 
    int secs_per_ch;  
    int tt_secs;      
    int pgs_per_pl;   
    int pgs_per_lun;  
    int pgs_per_ch;   
    int tt_pgs;       
    int blks_per_lun; 
    int blks_per_ch;  
    int tt_blks;      
    int secs_per_line;
    int pgs_per_line;
    int blks_per_line;
    int tt_lines;
 
    int pls_per_ch;   
    int tt_pls;       
    int tt_luns;      
};
 
typedef struct line {
    int id;  
    int ipc; 
    int vpc; 
    QTAILQ_ENTRY(line) entry; 
    size_t                  pos;
} line;
 
struct write_pointer {
    struct line *curline;
    int ch;
    int lun;
    int pg;
    int blk;
    int pl;
};
 
struct line_mgmt {
    struct line *lines;
    /* free line list, we only need to maintain a list of blk numbers */
    QTAILQ_HEAD(free_line_list, line) free_line_list;
    pqueue_t *victim_line_pq;
    //QTAILQ_HEAD(victim_line_list, line) victim_line_list;
    QTAILQ_HEAD(full_line_list, line) full_line_list;
    int tt_lines;
    int free_line_cnt;
    int victim_line_cnt;
    int full_line_cnt;
};
 
struct nand_cmd {
    int type;
    int cmd;
    int64_t stime; 
};
 
struct ssd {
    char *ssdname;
    struct ssdparams sp;
    struct ssd_channel *ch;
    struct ppa *maptbl;             
    uint64_t *rmap;                 
    struct write_pointer wp;
    struct line_mgmt lm;
 
    /* lockless ring for communication with NVMe IO thread */
    struct rte_ring **to_ftl;       
    struct rte_ring **to_poller;    
    bool *dataplane_started_ptr;
    QemuThread ftl_thread;
};
 
void ssd_init(FemuCtrl *n);
 
#ifdef FEMU_DEBUG_FTL
#define ftl_debug(fmt, ...) \
    do { printf("[FEMU] FTL-Dbg: " fmt, ## __VA_ARGS__); } while (0)
#else
#define ftl_debug(fmt, ...) \
    do { } while (0)
#endif
 
#define ftl_err(fmt, ...) \
    do { fprintf(stderr, "[FEMU] FTL-Err: " fmt, ## __VA_ARGS__); } while (0)
 
#define ftl_log(fmt, ...) \
    do { printf("[FEMU] FTL-Log: " fmt, ## __VA_ARGS__); } while (0)
 
 
/* FEMU assert() */
#ifdef FEMU_DEBUG_FTL
#define ftl_assert(expression) assert(expression)
#else
#define ftl_assert(expression)
#endif
 
#endif