mirror of
https://github.com/betaflight/betaflight.git
synced 2025-07-15 20:35:33 +03:00
6189d6bdc5
Flash operations can specify how long to wait before the next operation is issued. Prior to this the amount of time waited, and when, was wrong. e.g. m25p16_eraseCompletely - possibly waits ages TO START, starts, exit. m25p16_pageProgramContinue - waits DEFAULT_TIMEOUT_MILLIS to START, starts, exits. m25p16_pageProgramContinue would fail to write to the flash as the device was still busy erasing and didn't wait long enough. what happens now is: m25p16_eraseCompletely - waits using the current timeout, starts, sets timeout to be `now + BULK_ERASE_TIMEOUT_MILLIS`, exits. m25p16_pageProgramContinue - waits using the current `BULK_ERASE_TIMEOUT_MILLIS`, starts, exists, sets timeout to be `now + DEFAULT_TIMEOUT_MILLIS`. Since the timeout is stored in the flashDevice_t the solution also works for multi-die devices which use an instance of flashDevice_t for each die.
97 lines
3.2 KiB
C
97 lines
3.2 KiB
C
/*
|
|
* This file is part of Cleanflight and Betaflight.
|
|
*
|
|
* Cleanflight and Betaflight are free software. You can redistribute
|
|
* this software and/or modify this software under the terms of the
|
|
* GNU General Public License as published by the Free Software
|
|
* Foundation, either version 3 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* Cleanflight and Betaflight are distributed in the hope that they
|
|
* 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.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this software.
|
|
*
|
|
* If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "pg/flash.h"
|
|
#include "drivers/io.h"
|
|
|
|
// Maximum page size of all supported SPI flash devices.
|
|
// Used to detect flashfs allocation size being too small.
|
|
#define FLASH_MAX_PAGE_SIZE 2048
|
|
|
|
#define SPIFLASH_INSTRUCTION_RDID 0x9F
|
|
|
|
typedef enum {
|
|
FLASH_TYPE_NOR = 0,
|
|
FLASH_TYPE_NAND
|
|
} flashType_e;
|
|
|
|
typedef uint16_t flashSector_t;
|
|
|
|
typedef struct flashGeometry_s {
|
|
flashSector_t sectors; // Count of the number of erasable blocks on the device
|
|
uint16_t pageSize; // In bytes
|
|
uint32_t sectorSize; // This is just pagesPerSector * pageSize
|
|
uint32_t totalSize; // This is just sectorSize * sectors
|
|
uint16_t pagesPerSector;
|
|
flashType_e flashType;
|
|
} flashGeometry_t;
|
|
|
|
void flashPreInit(const flashConfig_t *flashConfig);
|
|
bool flashInit(const flashConfig_t *flashConfig);
|
|
|
|
bool flashIsReady(void);
|
|
bool flashWaitForReady(void);
|
|
void flashEraseSector(uint32_t address);
|
|
void flashEraseCompletely(void);
|
|
void flashPageProgramBegin(uint32_t address);
|
|
void flashPageProgramContinue(const uint8_t *data, int length);
|
|
void flashPageProgramFinish(void);
|
|
void flashPageProgram(uint32_t address, const uint8_t *data, int length);
|
|
int flashReadBytes(uint32_t address, uint8_t *buffer, int length);
|
|
void flashFlush(void);
|
|
const flashGeometry_t *flashGetGeometry(void);
|
|
|
|
//
|
|
// flash partitioning api
|
|
//
|
|
|
|
typedef struct flashPartition_s {
|
|
uint8_t type;
|
|
flashSector_t startSector;
|
|
flashSector_t endSector;
|
|
} flashPartition_t;
|
|
|
|
#define FLASH_PARTITION_SECTOR_COUNT(partition) (partition->endSector + 1 - partition->startSector) // + 1 for inclusive, start and end sector can be the same sector.
|
|
|
|
// Must be in sync with flashPartitionTypeNames[]
|
|
// Should not be deleted or reordered once the code is writing a table to a flash.
|
|
typedef enum {
|
|
FLASH_PARTITION_TYPE_UNKNOWN = 0,
|
|
FLASH_PARTITION_TYPE_PARTITION_TABLE,
|
|
FLASH_PARTITION_TYPE_FLASHFS,
|
|
FLASH_PARTITION_TYPE_BADBLOCK_MANAGEMENT,
|
|
FLASH_PARTITION_TYPE_FIRMWARE,
|
|
FLASH_PARTITION_TYPE_CONFIG,
|
|
FLASH_MAX_PARTITIONS
|
|
} flashPartitionType_e;
|
|
|
|
typedef struct flashPartitionTable_s {
|
|
flashPartition_t partitions[FLASH_MAX_PARTITIONS];
|
|
} flashPartitionTable_t;
|
|
|
|
void flashPartitionSet(uint8_t index, uint32_t startSector, uint32_t endSector);
|
|
flashPartition_t *flashPartitionFindByType(flashPartitionType_e type);
|
|
const flashPartition_t *flashPartitionFindByIndex(uint8_t index);
|
|
const char *flashPartitionGetTypeName(flashPartitionType_e type);
|
|
int flashPartitionCount(void);
|