MM32F3273G8P火龙果开发板MindSDK开发教程18 -sfud库的移植

MM32F3273G8P火龙果开发板MindSDK开发教程18 -sfud库的移植

1、sfud简介

SFUD (Serial Flash Universal Driver) 串行 Flash 通用驱动库
推荐查看官方文档：一款使用 JEDEC SFDP 标准的串行 (SPI) Flash 通用驱动库

2、实验设备

主控：MM32F3273G8P火龙果开发板
spi flash ： W25Q32
使用SPI2。（PB12 PB13 PB14 PB15）

3、SPI初始化

在移植sfud之前，我们先初始化spi2，用读取函数，读取一下w25q32的manufacturer_id值，如果能正常读取，说明我们的设备没有问题，spi初始化也正常，然后再来移植sfud库。
初始化gpio的函数如下：
CS采用软件控制的方式，读写之前拉低，读写结束拉高。

static bool SPI_GpioConfig(void)
{
    /* gpio. */
    GPIO_Init_Type gpio_init;
    /* PB12 - SPI_CS. */
    gpio_init.Pins  = GPIO_PIN_12;
    gpio_init.PinMode  = GPIO_PinMode_Out_PushPull;
    gpio_init.Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &gpio_init);
    GPIO_PinAFConf(GPIOB, gpio_init.Pins, GPIO_AF_15);
    GPIO_SetBits(GPIOB, gpio_init.Pins);

    /* PB13 - SPI_SCK. */
    gpio_init.Pins  = GPIO_PIN_13;
    gpio_init.PinMode  = GPIO_PinMode_AF_PushPull;
    gpio_init.Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &gpio_init);
    GPIO_PinAFConf(GPIOB, gpio_init.Pins, GPIO_AF_5);

    /* PB14 - SPI_MISO. */
    gpio_init.Pins  = GPIO_PIN_14;
    gpio_init.PinMode  = GPIO_PinMode_In_PullUp;
    gpio_init.Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &gpio_init);
    GPIO_PinAFConf(GPIOB, gpio_init.Pins, GPIO_AF_5);

    /* PB15 - SPI_MOSI. */
    gpio_init.Pins  = GPIO_PIN_15;
    gpio_init.PinMode  = GPIO_PinMode_AF_PushPull;
    gpio_init.Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &gpio_init);
    GPIO_PinAFConf(GPIOB, gpio_init.Pins, GPIO_AF_5);
    return true;
}

SPI初始化函数：

bool SPI_Config(void)
{
    SPI_GpioConfig();
    /* Setup SPI module. */
    SPI_Master_Init_Type spi_init;
    spi_init.ClockFreqHz = CLOCK_APB1_FREQ;
    spi_init.BaudRate = 400000u;
    spi_init.XferMode = SPI_XferMode_TxRx;
    spi_init.PolPha = SPI_PolPha_Alt1;
    spi_init.DataWidth = SPI_DataWidth_8b;
    spi_init.LSB = false;
    spi_init.AutoCS = true;
    SPI_InitMaster(SPI2, &spi_init);

    /* Enable SPI. */
    SPI_Enable(SPI2, true);
    return true;
}

注意SPI_PolPha_Alt1其实就是spi mode0，这里的定义怪怪的。

spi时钟初始化：

/* GPIOB. */
RCC_EnableAHB1Periphs(RCC_AHB1_PERIPH_GPIOB, true);
RCC_ResetAHB1Periphs(RCC_AHB1_PERIPH_GPIOB);

/* SPI2. */
RCC_EnableAPB1Periphs(RCC_APB1_PERIPH_SPI2, true);
RCC_ResetAPB1Periphs(RCC_APB1_PERIPH_SPI2);

读取函数：（写入一个读取一个）

static void SPI_WriteReadOnebyte(uint8_t w_data,uint8_t *r_data)
{
    while ( SPI_STATUS_TX_FULL & SPI_GetStatus(SPI2) )
    {}
    SPI_PutData(SPI2, w_data);
    while (0u == (SPI_STATUS_RX_DONE & SPI_GetStatus(SPI2)) )
    {}
    *r_data =  SPI_GetData(SPI2);
}

void SPI_WriteReadData(uint8_t *w_data,uint8_t *r_data,int len)
{
    GPIO_WriteBit(GPIOB,GPIO_PIN_12,0);
    while (len)
    {
        SPI_WriteReadOnebyte(*w_data++,r_data++);
        len--;
    }
    GPIO_WriteBit(GPIOB,GPIO_PIN_12,1);
}

读取 manufacturer_id函数

#define CMD_JEDEC_ID          0x9f
#define CMD_MANUFACURER_ID    0x90

static void w25q32_read_manufacturer_id(uint16_t *id)
{
    uint8_t tx_data[6] = {CMD_MANUFACURER_ID ,0,0,0,0,0};
    uint8_t rx_data[6] = {0};
    SPI_WriteReadData(tx_data,rx_data,6);
	*id = (rx_data[4]<<8)|rx_data[5];
}


static void w25q32_read_jedec_id(uint16_t *id)
{
    uint8_t tx_data[4] = {CMD_JEDEC_ID ,0,0,0};
    uint8_t rx_data[4] = {0};
    SPI_WriteReadData(tx_data,rx_data,4);
	*id = (rx_data[2]<<8)|rx_data[3];
}

void SPI_Test(void)
{
    uint16_t id = 0;
    SPI_Config();
    w25q32_read_manufacturer_id(&id);
    printf("get manufacturer id == 0x%04x\r\n",id);
    w25q32_read_jedec_id(&id);
    printf("get jedec id == 0x%04x\r\n",id);
}

调用SPI_Test函数后，打印如下：

说明spi2已经正常工作，w25q32也正常，接下来我们来移植sfud库。

4、sfud移植

下载加压后，将sfud中的文件copy到工程中。
因为w25q32是在支持列表中的，我们要修改的其实就两个文件，一个是sfud_cfg.h，另一个为sfud_port.c
文件目录结构如图：

sfud_cfg.h的修改如下：

#ifndef _SFUD_CFG_H_
#define _SFUD_CFG_H_

//#define SFUD_DEBUG_MODE

#define SFUD_USING_SFDP

#define SFUD_USING_FLASH_INFO_TABLE

enum {
    SFUD_SPI_DEVICE_INDEX = 0,
};

#define SFUD_FLASH_DEVICE_TABLE \
{ \
    [SFUD_SPI_DEVICE_INDEX] = {.name = "W25Q32", .spi.name = "SPI2"}, \
}

#endif /* _SFUD_CFG_H_ */

sfud_port.c的修改

static uint8_t spi_xfer(const uint8_t value)函数修改成自己平台的读写函数。

mm32平台修改如下：

static uint8_t spi_xfer(const uint8_t value)
{
    while(0 == (SPI_GetStatus(SPI2) & SPI_STATUS_TX_EMPTY) )
    {}
    SPI_PutData(SPI2, value);

    while(0 == (SPI_GetStatus(SPI2) & SPI_STATUS_RX_DONE) )
    {}
    return SPI_GetData(SPI2);
}

static void spi_cs_control(bool enable)函数，修改成自己平台控制gpio的函数。mm平台修改如下：

/* control the cs pin output. */
static void spi_cs_control(bool enable)
{
    if (true == enable)
    {
        GPIO_ClearBits(GPIOB, GPIO_PIN_12);
    }
    else
    {
        GPIO_SetBits(GPIOB, GPIO_PIN_12);
    }
}

sfud_err sfud_spi_port_init(sfud_flash *flash)函数添加spi2的初始化函数。这里添加之前我们定义的 SPI_Config()函数即可。

sfud_err sfud_spi_port_init(sfud_flash *flash)
{
    sfud_err result = SFUD_SUCCESS;
    SPI_Config();

    /* init sfud spi obj. */
    flash->spi.wr           = spi_write_read;
    flash->spi.lock         = spi_lock;
    flash->spi.unlock       = spi_unlock;
    flash->spi.user_data    = NULL;
    flash->retry.delay      = retry_delay_100us;
    flash->retry.times      = 60u * 10000u;

    return result;
}

5、sfud的使用

调用官方的demo

static void sfud_demo(uint32_t addr, size_t size, uint8_t *data)
{
    sfud_err result = SFUD_SUCCESS;
    const sfud_flash *flash = sfud_get_device_table() + 0;
    size_t i;
    /* prepare write data */
    for (i = 0; i < size; i++)
    {
        data[i] = i;
    }
    /* erase test */
    result = sfud_erase(flash, addr, size);
    if (result == SFUD_SUCCESS)
    {
        printf("Erase the %s flash data finish. Start from 0x%08X, size is %ld.\r\n", flash->name, addr,
                       size);
    }
    else
    {
        printf("Erase the %s flash data failed.\r\n", flash->name);
        return;
    }
    /* write test */
    result = sfud_write(flash, addr, size, data);
    if (result == SFUD_SUCCESS)
    {
        printf("Write the %s flash data finish. Start from 0x%08X, size is %ld.\r\n", flash->name, addr,
                       size);
    }
    else
    {
        printf("Write the %s flash data failed.\r\n", flash->name);
        return;
    }
    /* read test */
    result = sfud_read(flash, addr, size, data);
    if (result == SFUD_SUCCESS)
    {
        printf("Read the %s flash data success. Start from 0x%08X, size is %ld. The data is:\r\n", flash->name, addr,
                       size);
        printf("Offset (h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F\r\n");
        for (i = 0; i < size; i++)
        {
			if (i % 16 == 0)
			{
                printf("[%08X] ", addr + i);
            }
            printf("%02X ", data[i]);
            if (((i + 1) % 16 == 0) || i == size - 1)
            {
                printf("\r\n");
            }
        }
        printf("\r\n");
    }
    else
    {
        printf("Read the %s flash data failed.\r\n", flash->name);
    }
    /* data check */
    for (i = 0; i < size; i++)
    {
        if (data[i] != i % 256)
        {
            printf("Read and check write data has an error. Write the %s flash data failed.\r\n", flash->name);
                    break;
        }
    }
    if (i == size)
    {
        printf("The %s flash test is success.\r\n", flash->name);
    }
}

main函数调用：

static uint8_t data [256] = {0};

int main(void)
{
	BOARD_InitBootClocks();  // ³õʼ»¯Ê±ÖÓ
	BOARD_InitDebugConsole();
	BOARD_UserKeyInit();
	LED_Init();
	BOARD_TIM6_Init();

	// for mutilbutton init
	button_init(&btn1, read_button_GPIO, 0, btn1_id);
	button_attach(&btn1, PRESS_DOWN,       BTN1_PRESS_DOWN_Handler);
	button_attach(&btn1, PRESS_UP,         BTN1_PRESS_UP_Handler);
	button_start(&btn1);

	BOARD_TIM7_Init();

	BOARD_Delay1Ms(1000);
	
	printf("Board Init Success\r\n");

	sfud_init();
	sfud_demo(0,256,data);
	while(1)
	{
	}	
}

6、现象

烧录后打印如下：

7、代码

代码下载