STM32通用FLASH管理软件包——SFUD/FAL

/**

 * SPI write data then read data

 */

static sfud_err spi_write_read(const sfud_spi *spi, const uint8_t *write_buf, size_t write_size, uint8_t *read_buf,

        size_t read_size) {

    sfud_err result = SFUD_SUCCESS;

    spi_user_data_t spi_dev = (spi_user_data_t) spi->user_data;

    /**

     * add your spi write and read code

     */

    RT_ASSERT(spi);

    

    HAL_GPIO_WritePin(spi_dev->cs_gpiox, spi_dev->cs_gpio_pin, GPIO_PIN_RESET);

    if(write_size && read_size)

    {

        if(HAL_SPI_Transmit(spi_dev->spix, (uint8_t *)write_buf, write_size, 1000)!=HAL_OK) 

        {

            result = SFUD_ERR_WRITE;

        }   

       /* For simplicity reasons, this example is just waiting till the end of the

       transfer, but application may perform other tasks while transfer operation

       is ongoing. */

        while (HAL_SPI_GetState(spi_dev->spix) != HAL_SPI_STATE_READY);

        if(HAL_SPI_Receive(spi_dev->spix, (uint8_t *)read_buf, read_size, 1000)!=HAL_OK)

        {

            result = SFUD_ERR_READ;

        }

    }else if(write_size)

    {

        if(HAL_SPI_Transmit(spi_dev->spix, (uint8_t *)write_buf, write_size, 1000)!=HAL_OK) 

        {

            result = SFUD_ERR_WRITE;

        }

    }else

    {

        if(HAL_SPI_Receive(spi_dev->spix, (uint8_t *)read_buf, read_size, 1000)!=HAL_OK)

        {

            result = SFUD_ERR_READ;

        }

    }

       /* For simplicity reasons, this example is just waiting till the end of the

    transfer, but application may perform other tasks while transfer operation

    is ongoing. */

    while (HAL_SPI_GetState(spi_dev->spix) != HAL_SPI_STATE_READY);

    HAL_GPIO_WritePin(spi_dev->cs_gpiox, spi_dev->cs_gpio_pin, GPIO_PIN_SET);

    return result;

}

static spi_user_data user_spi = { .spix = &hspi2, .cs_gpiox = BSP_DATAFALSH_CS_GPIOX, .cs_gpio_pin = BSP_DATAFALSH_CS_GPIO_PIN };

sfud_err sfud_spi_port_init(sfud_flash *flash) {

    sfud_err result = SFUD_SUCCESS;

​

    /**

     * add your port spi bus and device object initialize code like this:

     * 1. rcc initialize

     * 2. gpio initialize

     * 3. spi device initialize

     * 4. flash->spi and flash->retry item initialize

     *    flash->spi.wr = spi_write_read; //Required

     *    flash->spi.qspi_read = qspi_read; //Required when QSPI mode enable

     *    flash->spi.lock = spi_lock;

     *    flash->spi.unlock = spi_unlock;

     *    flash->spi.user_data = &spix;

     *    flash->retry.delay = null;

     *    flash->retry.times = 10000; //Required

     */

    rt_mutex_init(&lock, "sfud_lock", RT_IPC_FLAG_FIFO);    

    MX_SPI_Init();

    #if defined(SOC_SERIES_STM32L4) || defined(SOC_SERIES_STM32F0) \

        || defined(SOC_SERIES_STM32F7) || defined(SOC_SERIES_STM32G0)

    

    SET_BIT(hspi2.Instance->CR2, SPI_RXFIFO_THRESHOLD_HF);

    #endif

    switch (flash->index) {

    case SFUD_W25QXX_DEVICE_INDEX: {

​

            /* 同步 Flash 移植所需的接口及数据 */

            flash->spi.wr = spi_write_read;

            flash->spi.lock = spi_lock;

            flash->spi.unlock = spi_unlock;

            flash->spi.user_data = &user_spi;

            /* about 100 microsecond delay */

            flash->retry.delay = retry_delay_100us;

            /* adout 60 seconds timeout */

            flash->retry.times = 60 * 10000;

​

            break;

        }

    }

    return result;

}<div align="left"><font color="rgb(51, 51, 51)"><font face="" "="">③ 其他接口移植：</font></font></div>static struct rt_mutex                 lock;

static char log_buf[256];

​

static void spi_lock(const sfud_spi *spi) {

    sfud_flash *sfud_dev = (sfud_flash *) (spi->user_data);

    struct spi_flash_device *rtt_dev = (struct spi_flash_device *) (sfud_dev->user_data);

​

    RT_ASSERT(spi);

    RT_ASSERT(sfud_dev);

    RT_ASSERT(rtt_dev);

​

    rt_mutex_take(&lock, RT_WAITING_FOREVER);

}

​

static void spi_unlock(const sfud_spi *spi) {

    sfud_flash *sfud_dev = (sfud_flash *) (spi->user_data);

    struct spi_flash_device *rtt_dev = (struct spi_flash_device *) (sfud_dev->user_data);

​

    RT_ASSERT(spi);

    RT_ASSERT(sfud_dev);

    RT_ASSERT(rtt_dev);

​

    rt_mutex_release(&lock);

}

static void retry_delay_100us(void) {

    /* 100 microsecond delay */

    rt_thread_delay((RT_TICK_PER_SECOND * 1 + 9999) / 10000);

}

void sfud_log_debug(const char *file, const long line, const char *format, ...) {

    va_list args;

​

    /* args point to the first variable parameter */

    va_start(args, format);

    rt_kprintf("[SFUD](%s:%ld) ", file, line);

    /* must use vprintf to print */

    rt_vsnprintf(log_buf, sizeof(log_buf), format, args);

    rt_kprintf("%s\n", log_buf);

    va_end(args);

}

​

/**

 * This function is print routine info.

 *

 * @param format output format

 * @param ... args

 */

void sfud_log_info(const char *format, ...) {

    va_list args;

​

    /* args point to the first variable parameter */

    va_start(args, format);

    rt_kprintf("[SFUD]");

    /* must use vprintf to print */

    rt_vsnprintf(log_buf, sizeof(log_buf), format, args);

    rt_kprintf("%s\n", log_buf);

    va_end(args);

}

typedef struct {

    char *name;                                  /**< serial flash name */

    size_t index;                                /**< index of flash device information table  <a href="home.php?mod=space&uid=8537" target="_blank">@see</a> flash_table */

    sfud_flash_chip chip;                        /**< flash chip information */

    sfud_spi spi;                                /**< SPI device */

    bool init_ok;                                /**< initialize OK flag */

    bool addr_in_4_byte;                         /**< flash is in 4-Byte addressing */

    struct {

        void (*delay)(void);                     /**< every retry's delay */

        size_t times;                            /**< default times for error retry */

    } retry;

    void *user_data;                             /**< some user data */

​

#ifdef SFUD_USING_QSPI

    sfud_qspi_read_cmd_format read_cmd_format;   /**< fast read cmd format */

#endif

​

#ifdef SFUD_USING_SFDP

    sfud_sfdp sfdp;                              /**< serial flash discoverable parameters by JEDEC standard */

#endif

​

} sfud_flash, *sfud_flash_t;

sfud_err sfud_device_init(sfud_flash *flash)[td]

sfud_flash *sfud_get_device(size_t index)[td]

sfud_err sfud_write(const sfud_flash *flash, uint32_t addr, size_t size, const uint8_t *data);sfud_err sfud_erase_write(const sfud_flash *flash, uint32_t addr, size_t size, const uint8_t *data)

#define STM32_FLASH_START_ADRESS     ((uint32_t)0x08000000)

#define STM32_FLASH_SIZE             (256 * 1024)

#define STM32_FLASH_END_ADDRESS      ((uint32_t)(STM32_FLASH_START_ADRESS + STM32_FLASH_SIZE))

​

#define STM32_SRAM1_START              (0x20000000)      

#define STM32_SRAM1_END                (STM32_SRAM1_START + 64 * 1024)   // 结束地址 = 0x20000000（基址） + 64K(RAM大小)