为什么FR8008GPU用不了QSPI的四线psram,只能用单线读取



  • #include <stdint.h>
    #include <stdbool.h>

    #include "plf.h"
    #include "driver_system.h"
    #include "driver_psram.h"

    #include "co_log.h"
    #include "co_printf.h"
    #include "driver_gpio.h"
    #include "sys_utils.h"
    #include "bsp_psram.h"

    #undef LOG_LOCAL_LEVEL
    #define LOG_LOCAL_LEVEL (LOG_LEVEL_INFO)
    static const char *psram_tag = "psram";

    #define PSRAM_BASE QSPI1_DAC_ADDRESS

    extern void psram_reset(void);
    extern void psram_set_delay(uint8_t d);
    extern void psram_set_ahb_trigger(uint32_t addr);
    extern void psram_set_frame(uint8_t r_op, uint8_t r_it, uint8_t r_at, uint8_t r_dt, uint8_t r_dummy,
    uint8_t w_op, uint8_t w_at, uint8_t w_dt, uint8_t w_dummy);

    static void psram_pins_qspi0(void)
    {
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_0, PORTC0_FUNC_QSPI0_IO3);
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_1, PORTC1_FUNC_QSPI0_SCLK0);
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_2, PORTC2_FUNC_QSPI0_CSN0);
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_3, PORTC3_FUNC_QSPI0_IO1);
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_4, PORTC4_FUNC_QSPI0_IO2);
    system_set_port_mux(GPIO_PORT_C, GPIO_BIT_5, PORTC5_FUNC_QSPI0_IO0);
    }

    static void psram_lines_gpio_check(void)
    {
    GPIO_InitTypeDef io;
    __SYSTEM_GPIO_CLK_ENABLE();

    LOG_INFO(psram_tag, "line check: PORTC mux=%08x", system_regs->port_mux[2]);
    
    for (uint8_t pin = 0; pin < 6; pin++)
    {
        system_set_port_mux(GPIO_PORT_C, pin, PORT_FUNC_GPIO);
        io.Mode = GPIO_MODE_INPUT;
        io.Pull = GPIO_PULLUP;
        io.Pin  = (GPIO_PIN_0 << pin);
        gpio_init(GPIO_C, &io);
        co_delay_100us(1); 
        uint8_t up = gpio_read_pin(GPIO_C, (GPIO_PIN_0 << pin)) ? 1 : 0;
    
        io.Pull = GPIO_PULLDOWN;
        gpio_init(GPIO_C, &io);
        co_delay_100us(1);
        uint8_t dn = gpio_read_pin(GPIO_C, (GPIO_PIN_0 << pin)) ? 1 : 0;
    
        co_printf("psram line PC%d: pullup=%d pulldown=%d %s\r\n", pin, up, dn,
                  (up == 1 && dn == 0) ? "ok" : "!!");
    }
    
    io.Mode = GPIO_MODE_INPUT;
    io.Pin  = GPIO_PIN_2;
    io.Pull = GPIO_PULLUP;
    gpio_init(GPIO_D, &io);
    uint8_t cup = gpio_read_pin(GPIO_D, GPIO_PIN_2) ? 1 : 0;
    io.Pull = GPIO_PULLDOWN;
    gpio_init(GPIO_D, &io);
    uint8_t cdn = gpio_read_pin(GPIO_D, GPIO_PIN_2) ? 1 : 0;
    co_printf("psram ctrl PD2: pullup=%d pulldown=%d\r\n", cup, cdn);
    

    }

    bool bsp_psram_init(void)
    {
    co_delay_100us(500);

    psram_lines_gpio_check(); 
    
    __SYSTEM_GPIO_CLK_ENABLE();
    /* 参考例程(lvgl_knob_open_demo)同款参考时钟配置 */
    system_regs->mdm_qspi_cfg.qspi_ref_128m_en = 1;
    system_regs->mdm_qspi_cfg.qspi_ref_clk_sel = 1;
    system_set_internal_flash_clock_div(1); 
    
    psram_pins_qspi0();
    
    (void)psram_init(PSRAM_CLK_SEL_COREH_96M);
    system_regs->mdm_qspi_cfg.qspi0_ref_clk_en = 1;
    system_regs->mdm_qspi_cfg.qspi0_hclk_en = 1;
    psram_set_ahb_trigger(PSRAM_BASE);
    
    volatile uint8_t *img = (volatile uint8_t *)PSRAM_BASE;
    
    for (int attempt = 0; attempt < 3; attempt++)
    {
        psram_reset();
        co_delay_100us(10);
        psram_set_frame(0x03, 0, 0, 0, 0, 0x02, 0, 0, 0);
        img[0] = 0x5Au;
        img[1] = 0xA5u;
        co_delay_100us(1);
    
        for (int d = 0; d < 16; d++)
        {
            psram_set_delay((uint8_t)d);
            co_delay_100us(1);
            if (img[0] == 0x5Au && img[1] == 0xA5u)
            {
                psram_set_delay((uint8_t)d);
                LOG_INFO(psram_tag, "psram ready (spi, delay tap %d)", d);
                return true;
            }
        }
        LOG_INFO(psram_tag, "spi scan fail attempt %d, retry", attempt);
    }
    
    LOG_INFO(psram_tag, "psram init FAIL (spi x3)");
    return false;
    

    }

    #include <stdint.h>
    #include <string.h>

    #include "plf.h"
    #include "driver_qspi.h"
    #include "driver_psram.h"
    #include "driver_system.h"
    #include "driver_pmu.h"
    #include "driver_cache.h"

    #include "co_printf.h"
    #include "sys_utils.h"

    #ifdef INLINE
    #undef INLINE
    #endif
    #define INLINE

    #define PSRAM_ENABLE_Q_MODE 1 /* TEST: all-quad framing at slow clock */
    #define PSRAM_CLK_DIV_SEL QSPI_BAUDRATE_DIV_2
    #define PSRAM_BASE QSPI1_DAC_ADDRESS

    #define PSRAM_READ_IDENTIFICATION 0x9F

    #define PSRAM_READ_OPCODE 0x03
    #define PSRAM_FAST_READ_OPCODE 0x0B
    #define PSRAM_FAST_QUAL_READ_OPCODE 0xEB

    #define PSRAM_PAGE_PROGRAM_OPCODE 0x02
    #define PSRAM_PAGE_QUAL_PROGRAM_OPCODE 0x38

    #define PSRAM_ENTER_QUAD_MODE_OPCODE 0x35
    #define PSRAM_EXIT_QUAD_MODE_OPCODE 0xF5

    #define PSRAM_RESET_ENABLE_OPCODE 0x66
    #define PSRAM_RESET_OPCODE 0x99

    #define QSPI0_STIG_MAX_SINGLE_LEN 8
    #define QSPI0_STIG_BANK_DEPTH 128

    #define QSPI0_HIGH_SPEED 1
    uint8_t psram_delay = 0xFF;
    static const struct qspi_stig_reg_t psram_read_id_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 0,
    .enable_write = 0,
    .addr_bytes = 0,
    .enable_mode = 0,
    .enable_cmd_addr = 0,
    .read_bytes = 3,
    .enable_read = 1,
    .opcode = PSRAM_READ_IDENTIFICATION,
    };

    static const struct qspi_stig_reg_t enter_quad_mode_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 0,
    .enable_write = 0,
    .addr_bytes = 0,
    .enable_mode = 0,
    .enable_cmd_addr = 0,
    .read_bytes = 0,
    .enable_read = 0,
    .opcode = PSRAM_ENTER_QUAD_MODE_OPCODE,
    };

    static const struct qspi_stig_reg_t reset_enable_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 0,
    .enable_write = 0,
    .addr_bytes = 0,
    .enable_mode = 0,
    .enable_cmd_addr = 0,
    .read_bytes = 0,
    .enable_read = 0,
    .opcode = PSRAM_RESET_ENABLE_OPCODE,
    };

    static const struct qspi_stig_reg_t reset_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 0,
    .enable_write = 0,
    .addr_bytes = 0,
    .enable_mode = 0,
    .enable_cmd_addr = 0,
    .read_bytes = 0,
    .enable_read = 0,
    .opcode = PSRAM_RESET_OPCODE,
    };

    //static const struct qspi_stig_reg_t exit_quad_mode_cmd = {
    // .enable_bank = 0,
    // .dummy_cycles = 0,
    // .write_bytes = 0,
    // .enable_write = 0,
    // .addr_bytes = 0,
    // .enable_mode = 0,
    // .enable_cmd_addr = 0,
    // .read_bytes = 0,
    // .enable_read = 0,
    // .opcode = PSRAM_EXIT_QUAD_MODE_OPCODE,
    //};

    volatile struct qspi_regs_t *qspi0_ctrl = (volatile struct qspi_regs_t *)QSPI0_APB_BASE;

    INLINE void qspi0_cfg_set_enable(uint8_t en)
    {
    qspi0_ctrl->config.enable = en;
    }

    INLINE void qspi0_cfg_set_cpol(uint8_t high)
    {
    qspi0_ctrl->config.cpol = high;
    }

    INLINE void qspi0_cfg_set_cpha(uint8_t rising)
    {
    qspi0_ctrl->config.cpha = rising;
    }

    INLINE void qspi0_cfg_set_hold(uint8_t hold)
    {
    qspi0_ctrl->config.hold_pin = hold;
    }

    INLINE void qspi0_cfg_set_reset(uint8_t reset)
    {
    qspi0_ctrl->config.reset_pin = reset;
    }

    INLINE void qspi0_cfg_set_reset_sel(uint8_t dedicated)
    {
    qspi0_ctrl->config.reset_pin_conf = dedicated;
    }

    INLINE void qspi0_cfg_set_enable_dac(uint8_t en)
    {
    qspi0_ctrl->config.enable_DAC = en;
    }

    INLINE void qspi0_cfg_set_enable_legacy(uint8_t en)
    {
    qspi0_ctrl->config.enable_legacy = en;
    }

    INLINE void qspi0_cfg_set_write_protect(uint8_t wp)
    {
    qspi0_ctrl->config.write_en_pin = wp;
    }

    INLINE void qspi0_cfg_set_enable_remap(uint8_t en)
    {
    qspi0_ctrl->config.enable_AHB_remap = en;
    }

    static void qspi0_cfg_set_baudrate(uint8_t baudrate);

    INLINE void qspi0_cfg_set_enable_AHB_decoder(uint8_t en)
    {
    qspi0_ctrl->config.enable_AHB_decoder = en;
    }

    INLINE int qspi0_is_busy(void)
    {
    return (qspi0_ctrl->config.status == 0);
    }

    INLINE void qspi0_read_set_opcode(uint8_t opcode)
    {
    qspi0_ctrl->read_conf.opcode_no_XIP = opcode;
    }

    INLINE void qspi0_read_set_instruction_type(uint8_t type)
    {
    qspi0_ctrl->read_conf.instruction_type = type;
    }

    INLINE void qspi0_read_set_address_type(uint8_t type)
    {
    qspi0_ctrl->read_conf.addr_type = type;
    }

    INLINE void qspi0_read_set_data_type(uint8_t type)
    {
    qspi0_ctrl->read_conf.data_type = type;
    }

    INLINE void qspi0_read_set_mode_en(uint8_t en)
    {
    qspi0_ctrl->read_conf.enable_mode = en;
    }

    INLINE void qspi0_read_set_dummy_cycles(uint8_t cycles)
    {
    qspi0_ctrl->read_conf.dummy_cycles = cycles;
    }

    INLINE void qspi0_write_set_opcode(uint8_t opcode)
    {
    qspi0_ctrl->write_conf.opcode = opcode;
    }

    INLINE void qspi0_write_set_wel_dis(uint8_t disable)
    {
    qspi0_ctrl->write_conf.disable_WEL = disable;
    }

    INLINE void qspi0_write_set_address_type(uint8_t type)
    {
    qspi0_ctrl->write_conf.addr_type = type;
    }

    INLINE void qspi0_write_set_data_type(uint8_t type)
    {
    qspi0_ctrl->write_conf.data_type = type;
    }

    INLINE void qspi0_write_set_dummy_cycles(uint8_t cycles)
    {
    qspi0_ctrl->write_conf.dummy_cycles = cycles;
    }

    INLINE void qspi0_set_remap_address(uint32_t address)
    {
    qspi0_ctrl->remap_address = address;
    }

    INLINE void qspi0_set_mode_bit(uint8_t mode)
    {
    qspi0_ctrl->mode_bits = (uint32_t)mode;
    }

    INLINE void qspi0_poll_set_opcode(uint8_t opcode)
    {
    qspi0_ctrl->poll_cfg.opcode_poll = opcode;
    }

    INLINE void qspi0_poll_set_bit_index(uint8_t index)
    {
    qspi0_ctrl->poll_cfg.poll_bit_index = index;
    }

    INLINE void qspi0_poll_set_polarity(uint8_t pol)
    {
    qspi0_ctrl->poll_cfg.poll_polarity = pol;
    }

    INLINE void qspi0_poll_set_disable(uint8_t dis)
    {
    qspi0_ctrl->poll_cfg.disable_poll = dis;
    }

    INLINE void qspi0_poll_set_expire(uint8_t en, uint32_t duration)
    {
    qspi0_ctrl->poll_cfg.enable_expiration = en;
    if(en) {
    qspi0_ctrl->poll_expiration = duration;
    }
    }

    INLINE void qspi0_poll_set_poll_count(uint8_t count)
    {
    qspi0_ctrl->poll_cfg.poll_count = count;
    }

    INLINE void qspi0_poll_set_poll_delay(uint8_t delay)
    {
    qspi0_ctrl->poll_cfg.poll_repetition_delay = delay;
    }

    INLINE void qspi0_set_cmd_addr(uint32_t addr)
    {
    qspi0_ctrl->cmd_address = addr;
    }

    INLINE void qspi0_stig_set_opcode(uint8_t opcode)
    {
    qspi0_ctrl->cmd_ctrl.opcode = opcode;
    }

    INLINE void qspi0_stig_set_read_en(uint8_t en)
    {
    qspi0_ctrl->cmd_ctrl.enable_read = en;
    }

    INLINE void qspi0_stig_set_read_bytes(uint8_t bytes)
    {
    qspi0_ctrl->cmd_ctrl.read_bytes = bytes;
    }

    INLINE void qspi0_stig_set_addr(uint8_t en, uint8_t bytes, uint32_t addr)
    {
    qspi0_ctrl->cmd_ctrl.enable_cmd_addr = en;
    qspi0_ctrl->cmd_ctrl.addr_bytes = bytes;
    if(en) {
    qspi0_ctrl->cmd_address = addr;
    }
    }

    INLINE void qspi0_stig_set_mode_en(uint8_t en)
    {
    qspi0_ctrl->cmd_ctrl.enable_mode = en;
    }

    INLINE void qspi0_stig_set_write_en(uint8_t en)
    {
    qspi0_ctrl->cmd_ctrl.enable_write = en;
    }

    INLINE void qspi0_stig_set_write_bytes(uint8_t bytes)
    {
    qspi0_ctrl->cmd_ctrl.write_bytes = bytes;
    }

    INLINE void qspi0_stig_set_dummy_cycles(uint8_t cycles)
    {
    qspi0_ctrl->cmd_ctrl.dummy_cycles = cycles;
    }

    INLINE void qspi0_stig_set_mem_bank(uint8_t en, uint8_t bytes)
    {
    qspi0_ctrl->cmd_ctrl.enable_bank = en;
    if(en) {
    qspi0_ctrl->cmd_ctrl_mem.mem_bank_req_bytes = bytes;
    }
    }

    static void qspi0_cfg_set_baudrate(uint8_t baudrate)
    {
    qspi0_ctrl->config.baud_rate = baudrate;
    }

    static const struct qspi_stig_reg_t psram_stig_read_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 0,
    .enable_write = 0,
    .addr_bytes = 2, /* QSPI_STIG_ADDR_BYTES_3 /
    .enable_mode = 0,
    .enable_cmd_addr = 1,
    .read_bytes = 3,
    .enable_read = 1,
    .opcode = PSRAM_READ_OPCODE, /
    0x03 */
    };

    static const struct qspi_stig_reg_t psram_stig_write_cmd = {
    .enable_bank = 0,
    .dummy_cycles = 0,
    .write_bytes = 3,
    .enable_write = 1,
    .addr_bytes = 2, /* QSPI_STIG_ADDR_BYTES_3 /
    .enable_mode = 0,
    .enable_cmd_addr = 1,
    .read_bytes = 0,
    .enable_read = 0,
    .opcode = PSRAM_PAGE_PROGRAM_OPCODE, /
    0x02 */
    };

    static int qspi0_stig_cmd(struct qspi_stig_reg_t cmd, enum qspi_stig_cmd_type_t type, int len, uint8_t *buffer)
    {
    uint32_t tmp_u32[2];
    uint8_t *tmp_u8 = (uint8_t *)tmp_u32;

    if(type == QSPI_STIG_CMD_BANK_READ) {
        if(QSPI0_STIG_BANK_DEPTH < len) {
            return -1;
        }
    }
    else {
        if(QSPI0_STIG_MAX_SINGLE_LEN < len) {
            return -1;
        }
    }
    
    while(qspi0_is_busy());
    
    if(type == QSPI_STIG_CMD_EXE) {
        qspi0_ctrl->cmd_ctrl = cmd;
        qspi0_ctrl->cmd_ctrl.execute = 1;
        while(qspi0_ctrl->cmd_ctrl.progress_status);
    }
    else {
        if(type == QSPI_STIG_CMD_WRITE) {
            memcpy(tmp_u8, buffer, len);
            qspi0_ctrl->write_data_L = tmp_u32[0];
            qspi0_ctrl->write_data_H = tmp_u32[1];
            cmd.write_bytes = len - 1;
            qspi0_ctrl->cmd_ctrl = cmd;
            qspi0_ctrl->cmd_ctrl.execute = 1;
            while(qspi0_ctrl->cmd_ctrl.progress_status);
        }
        else {
            cmd.read_bytes = len - 1;
            qspi0_ctrl->cmd_ctrl = cmd;
            qspi0_ctrl->cmd_ctrl.execute = 1;
            while(qspi0_ctrl->cmd_ctrl.progress_status);
            if(type == QSPI_STIG_CMD_READ) {
                tmp_u32[0] = qspi0_ctrl->read_data_L;
                tmp_u32[1] = qspi0_ctrl->read_data_H;
                //co_printf("READ_L: 0x%08x, READ_H: 0x%08x.\r\n", tmp_u32[0], tmp_u32[1]);
                memcpy(buffer, tmp_u8, len);
            }
            else {
                //TBD, BANK READ
            }
        }
    }
    
    return 0;
    

    }

    void psram_enter_quad(void)
    {
    qspi0_stig_cmd(enter_quad_mode_cmd, QSPI_STIG_CMD_EXE, 0, NULL);
    }

    uint32_t psram_read_id(void)
    {
    uint32_t flash_id;
    qspi0_stig_cmd(psram_read_id_cmd, QSPI_STIG_CMD_READ, 3, (uint8_t *)&flash_id);
    return (flash_id&0xffffff);
    }

    static void psram_controller_init(uint16_t page_boundary)
    {
    while(qspi0_is_busy());

    #if PSRAM_ENABLE_Q_MODE == 1
    qspi0_read_set_opcode(PSRAM_FAST_READ_OPCODE);
    qspi0_read_set_instruction_type(QSPI_WIRE_TYPE_QIO);
    qspi0_read_set_address_type(QSPI_WIRE_TYPE_QIO);
    qspi0_read_set_data_type(QSPI_WIRE_TYPE_QIO);
    qspi0_read_set_dummy_cycles(4);
    qspi0_read_set_mode_en(0);
    qspi0_set_mode_bit(0);//8 bits data after addr

    qspi0_write_set_opcode(PSRAM_PAGE_QUAL_PROGRAM_OPCODE);
    qspi0_write_set_address_type(QSPI_WIRE_TYPE_QIO);
    qspi0_write_set_data_type(QSPI_WIRE_TYPE_QIO);
    qspi0_write_set_dummy_cycles(0);
    

    #else
    qspi0_read_set_opcode(PSRAM_FAST_QUAL_READ_OPCODE);
    qspi0_read_set_instruction_type(QSPI_WIRE_TYPE_STAND);
    qspi0_read_set_address_type(QSPI_WIRE_TYPE_QIO);
    qspi0_read_set_data_type(QSPI_WIRE_TYPE_QIO);
    qspi0_read_set_dummy_cycles(6);
    qspi0_read_set_mode_en(0);
    qspi0_set_mode_bit(0);//8 bits data after addr

    qspi0_write_set_opcode(PSRAM_PAGE_QUAL_PROGRAM_OPCODE);
    qspi0_write_set_address_type(QSPI_WIRE_TYPE_QIO);
    qspi0_write_set_data_type(QSPI_WIRE_TYPE_QIO);
    qspi0_write_set_dummy_cycles(0);
    

    #endif

    //init configuration register
    qspi0_cfg_set_cpol(0);
    qspi0_cfg_set_cpha(0);
    qspi0_cfg_set_enable_dac(1);
    qspi0_cfg_set_enable_legacy(0);
    qspi0_cfg_set_enable_remap(1);
    

    #if QSPI0_HIGH_SPEED
    qspi0_cfg_set_baudrate(PSRAM_CLK_DIV_SEL);
    #else
    qspi0_cfg_set_baudrate(QSPI_BAUDRATE_DIV_32);
    #endif
    qspi0_cfg_set_enable_AHB_decoder(1);
    qspi0_write_set_wel_dis(1);
    qspi0_poll_set_disable(1);

    #if QSPI0_HIGH_SPEED
    qspi0_ctrl->read_cap.delay_capture = 3;
    #else
    qspi0_ctrl->read_cap.delay_capture = 0;
    #endif
    qspi0_ctrl->read_cap.enable_loopback_clk = 1;
    qspi0_ctrl->delay.sel_start_offset = 2;
    qspi0_ctrl->delay.sel_end_offset = 2;
    qspi0_ctrl->delay.sel_dessert = 2;
    qspi0_ctrl->cs_ctrl.rd_brk_en = 1;
    qspi0_ctrl->cs_ctrl.disable_cs_after_first_byte = 0; /* forum-verified working value for quad PSRAM (was 1 in SDK) /
    qspi0_ctrl->cs_ctrl.page_boundary_protect_en = 1;
    qspi0_ctrl->cs_ctrl.page_boundary = page_boundary;
    qspi0_set_remap_address(QSPI1_DAC_ADDRESS);
    qspi0_ctrl->AHB_trigger_address = PSRAM_BASE; /
    DAC window trigger (old project set it; default points elsewhere) */
    qspi0_cfg_set_enable(1);
    }

    void psram_cache_enable(void)
    {
    __CACHE_FLUSH(CACHE);
    __CACHE_WR_MODE_SET(CACHE, CACHE_WR_WRITE_THROUGH);
    __CACHE_ADDR_RANGEx_BANK_SET(CACHE, 0, 0x0000);
    __CACHE_ADDR_RANGEx_MASK_SET(CACHE, 0, 0x0000);
    __CACHE_ADDR_RANGEx_POL_SET(CACHE, 0, CACHE_POL_CACHABLE);
    __CACHE_ADDR_RANGEx_ENABLE(CACHE, 0);
    __CACHE_ENABLE(CACHE);
    }

    bool psram_init(enum psram_clk_sel_t clk_sel)
    {
    uint32_t ref_clk;

    if (clk_sel >= PSRAM_CLK_SEL_MAX) {
        return false;
    }
    
    switch (clk_sel) {
        case PSRAM_CLK_SEL_COREH_48M:
            system_regs->mdm_qspi_cfg.qspi0_ref_clk_sel = 0;
            ref_clk = 48000000;
            break;
        case PSRAM_CLK_SEL_COREH_96M:
            system_regs->mdm_qspi_cfg.qspi0_ref_clk_sel = 1;
            ref_clk = 96000000;
            break;      
        case PSRAM_CLK_SEL_COREH_192M:
            system_regs->mdm_qspi_cfg.qspi0_ref_clk_sel = 2;
            ref_clk = 192000000;
            break;
        default:
            return false;
    }
    system_regs->mdm_qspi_cfg.qspi0_ref_clk_en=1;
    system_regs->mdm_qspi_cfg.qspi0_hclk_en=1;
    system_regs->mdm_qspi_cfg.qspi0_io_ctl_oen=0;
    
    if(psram_delay == 0xFF)
    {
        qspi0_stig_cmd(reset_enable_cmd, QSPI_STIG_CMD_EXE, 0, NULL);
        qspi0_stig_cmd(reset_cmd, QSPI_STIG_CMD_EXE, 0, NULL);
        co_delay_10us(20);  /* 200us reset recovery before quad entry */
        /* serial write magic @0 while die in SPI mode (baseline) */
        {
            uint32_t magic = 0xc3c3c3c3;
            uint32_t chk = 0;
            qspi0_ctrl->cmd_address = 0;
            qspi0_stig_cmd(psram_stig_write_cmd, QSPI_STIG_CMD_WRITE, 4, (uint8_t *)&magic);
            qspi0_ctrl->cmd_address = 0;
            qspi0_stig_cmd(psram_stig_read_cmd, QSPI_STIG_CMD_READ, 4, (uint8_t *)&chk);
            co_printf("psram serial w/r chk=%x\r\n", chk);
        }
    

    #if PSRAM_ENABLE_Q_MODE == 1
    psram_enter_quad();
    #endif // PSRAM_ENABLE_Q_MODE == 1
    }

    /* about 100 bytes can be transmitted during 8us when QSPI clock is 24MHz */
    ref_clk /= ((PSRAM_CLK_DIV_SEL+1) * 2);
    uint32_t bytes = ref_clk / 240000;
    uint32_t boundary_cfg = 1 << (31 - __CLZ(bytes));
    if (boundary_cfg >= 0x100) {
        boundary_cfg = 0x100;
    }
    psram_controller_init(boundary_cfg);
    
    if(psram_delay != 0xFF)
    {
        qspi0_ctrl->read_cap.delay_capture = psram_delay;
    }
    else
    {
        /* detect read capture delay configuration */
        uint8_t delay_lower, delay_upper, index;
        /* QUAD READ test v2: sweep dummy cycles x capture taps.
           Serial-written c3c3c3c3 @0 must appear via quad DAC read. Log non-zero only. */
        {
            static const uint8_t dummies[] = {4, 2, 6, 8, 0, 3, 5, 1, 7};
            uint8_t found = 0;
            for (uint8_t di = 0; di < sizeof(dummies) && !found; di++) {
                qspi0_read_set_dummy_cycles(dummies[di]);
                for (index = 0; index < 16; index++) {
                    while(qspi0_is_busy());
                    qspi0_ctrl->read_cap.delay_capture = index;
                    uint32_t dbg = *(volatile uint32_t *)(PSRAM_BASE);
                    if (dbg != 0) {
                        co_printf("psram qt(d=%d,t=%d)=%x\r\n", dummies[di], index, dbg);
                    }
                    if (dbg == 0xc3c3c3c3) {
                        co_printf("psram QUAD READ OK (dummy=%d tap=%d)\r\n", dummies[di], index);
                        found = 1;
                        break;
                    }
                }
            }
            if (!found) {
                co_printf("psram QUAD READ DEAD (9 dummies x 16 taps)\r\n");
            }
        }
        /* QUAD WRITE test: write via quad DAC @4, verify via SERIAL read @4 */
        {
            *(volatile uint32_t *)(PSRAM_BASE + 4) = 0x5a5a5a5a;
            while(qspi0_is_busy());
            uint32_t chk4 = 0;
            qspi0_ctrl->cmd_address = 4;
            qspi0_stig_cmd(psram_stig_read_cmd, QSPI_STIG_CMD_READ, 4, (uint8_t *)&chk4);
            co_printf("psram quad w @4, serial sees=%x %s\r\n", chk4,
                      (chk4 == 0x5a5a5a5a) ? "QUAD WRITE OK" : "QUAD WRITE DEAD");
        }
        *(volatile uint32_t *)(PSRAM_BASE) = 0x5a5a5a5a;
        while(qspi0_is_busy());
    
        for (index = 0; index < 16; index++) {
            while(qspi0_is_busy());
            qspi0_ctrl->read_cap.delay_capture = index;
            if (*(volatile uint32_t *)(PSRAM_BASE) == 0x5a5a5a5a) {
                break;
            }
        }
        if (index == 16) {
            system_regs->mdm_qspi_cfg.qspi0_ref_clk_en=0;
            return false;
        }
        else {
            delay_lower = index;
        }
        for (; index < 16; index++) {
            while(qspi0_is_busy());        
            qspi0_ctrl->read_cap.delay_capture = index;
            delay_upper = index;
            if (*(volatile uint32_t *)(PSRAM_BASE) != 0x5a5a5a5a) {
                break;
            }
        }
        
        psram_delay = ((delay_lower + delay_upper)>>1);
        while(qspi0_is_busy());
        qspi0_ctrl->read_cap.delay_capture = psram_delay;      
    }
    return true;
    

    }

    /* ---- old-project helpers restored: the only PSRAM path proven on this

    •  board+die (single-lane DAC, verified working on FR8008GPU 2026-10-27).
      
    •  SDK quad framings (all-quad and 1-4-4) both fail on this die. ---- */
      

    void psram_reset(void)
    {
    qspi0_stig_cmd(reset_enable_cmd, QSPI_STIG_CMD_EXE, 0, NULL);
    qspi0_stig_cmd(reset_cmd, QSPI_STIG_CMD_EXE, 0, NULL);
    }

    void psram_set_delay(uint8_t d)
    {
    qspi0_ctrl->read_cap.delay_capture = d;
    }

    void psram_set_ahb_trigger(uint32_t addr)
    {
    qspi0_ctrl->AHB_trigger_address = addr;
    }

    void psram_set_frame(uint8_t r_op, uint8_t r_it, uint8_t r_at, uint8_t r_dt, uint8_t r_dummy,
    uint8_t w_op, uint8_t w_at, uint8_t w_dt, uint8_t w_dummy)
    {
    qspi0_read_set_opcode(r_op);
    qspi0_read_set_instruction_type(r_it);
    qspi0_read_set_address_type(r_at);
    qspi0_read_set_data_type(r_dt);
    qspi0_read_set_dummy_cycles(r_dummy);
    qspi0_read_set_mode_en(0);
    qspi0_set_mode_bit(0);
    qspi0_write_set_opcode(w_op);
    qspi0_write_set_address_type(w_at);
    qspi0_write_set_data_type(w_dt);
    qspi0_write_set_dummy_cycles(w_dummy);
    }