/* * Copyright (C) EdgeTX * * Authors: * Dr. Richard Li * * Based on code named * opentx - https://github.com/opentx/opentx * th9x - http://code.google.com/p/th9x * er9x - http://code.google.com/p/er9x * gruvin9x - http://code.google.com/p/gruvin9x * * License GPLv2: http://www.gnu.org/licenses/gpl-2.0.html * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License version 2 as * published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. */ /* * FrFTL - Flash Resident Flash Translation Layer * * This is a FTL designed for NOR flash, logical to physical mapping uses 2 layers * of translation tables all resident in flash. It comes with mechanisms to ensure * the integrity of the data in previous state when power out occurs in the middle * of flash programming. * * It can be used to back the FatFS library by ChaN and included the support of * CTRL_SYNC and CTRL_TRIM functions for best performance. * */ #pragma once #include #include #ifdef __cplusplus extern "C" { #endif typedef struct { bool (*flashRead)(uint32_t addr, uint8_t* buf, uint32_t len); bool (*flashProgram)(uint32_t addr, const uint8_t* buf, uint32_t len); bool (*flashErase)(uint32_t addr); bool (*flashBlockErase)(uint32_t addr); bool (*isFlashErased)(uint32_t addr); } FrFTLOps; typedef struct { const FrFTLOps* callbacks; uint32_t mttPhysicalPageNo; uint16_t physicalPageCount; uint8_t ttPageCount; uint32_t usableSectorCount; uint16_t writeFrontier; uint32_t* physicalPageState; bool physicalPageStateResolved; uint16_t pageBufferSize; void *pageBuffer; void* bufferHead; // LRU most used void* bufferTail; // LRU least used void* hashTable; // Fast cache lookup uint32_t memoryUsed; } FrFTL; bool ftlInit(FrFTL* ftl, const FrFTLOps* cb, uint16_t flashSizeInMB); void ftlDeInit(FrFTL* ftl); bool ftlWrite(FrFTL* ftl, uint32_t startSectorNo, uint32_t noOfSectors, const uint8_t* buf); bool ftlRead(FrFTL* ftl, uint32_t sectorNo, uint8_t* buffer); bool ftlTrim(FrFTL* ftl, uint32_t startSectorNo, uint32_t noOfSectors); bool ftlSync(FrFTL* ftl); #ifdef __cplusplus } #endif