大家好，我是痞子衡，是正經(jīng)搞技術(shù)的痞子。今天痞子衡給大家介紹的是i.MXRT啟動(dòng)頭FDCB里的lookupTable。

一個(gè)MCU內(nèi)部通常有很多外設(shè)模塊，這些外設(shè)模塊是各MCU廠商做差異化產(chǎn)品的本質(zhì)，也是各廠商核心競(jìng)爭(zhēng)力所在（這里特指那些生產(chǎn)ARM Cortex-M內(nèi)核MCU的廠商）。在做MCU開(kāi)發(fā)時(shí)有時(shí)候并不需要了解全部的外設(shè)，因?yàn)橛行┩庠O(shè)在項(xiàng)目里不一定會(huì)用到，但是要想把恩智浦i.MXRT系列MCU玩起來(lái)，有一個(gè)外設(shè)是必須要有所了解的，它就是FlexSPI，這個(gè)外設(shè)負(fù)責(zé)與外部串行NOR Flash連接，實(shí)現(xiàn)外部NOR Flash里的應(yīng)用程序指令與數(shù)據(jù)的讀取，而串行NOR Flash正是i.MXRT首選的啟動(dòng)設(shè)備。

那么在FlexSPI外設(shè)模塊里究竟是什么機(jī)制實(shí)現(xiàn)了Flash中應(yīng)用程序指令與數(shù)據(jù)的讀取功能呢？痞子衡從i.MXRT啟動(dòng)頭FDCB里的lookupTable設(shè)定開(kāi)始說(shuō)起：

一、為何i.MXRT能從外部Flash XIP啟動(dòng)？

關(guān)于在串行NOR Flash XIP執(zhí)行原理，痞子衡其實(shí)在之前一篇文章 《在串行NOR Flash XIP調(diào)試原理》 的第二小節(jié) i.MXRT FlexSPI外設(shè)特性 介紹過(guò)，是FlexSPI這個(gè)外設(shè)實(shí)現(xiàn)了從串行Flash任意地址取指令的功能，這是先決條件。

有了從Flash任意地址取指的先決條件基礎(chǔ)，在i.MXRT芯片上電后，BootROM便只需要將FlexSPI外設(shè)配置到指定工作狀態(tài)（這里詳見(jiàn) 《深入i.MXRT1050系列ROM中串行NOR Flash啟動(dòng)初始化流程》 一文，尤其是文中最后一節(jié)提到的第二次FlexSPI初始化，本文討論的內(nèi)容其實(shí)屬于第二次初始化后的狀態(tài)），F(xiàn)lexSPI外設(shè)配置信息完全來(lái)自于啟動(dòng)頭FDCB（一共512bytes），F(xiàn)lexSPI配置完成后，BootROM再把CPU控制權(quán)交給應(yīng)用程序，這就完成了啟動(dòng)任務(wù)。

下面的 qspiflash_config 便是i.MXRT SDK包里使用的一個(gè)典型的適用符合JEDEC SFDP標(biāo)準(zhǔn)且容量為8MB的QSPI NOR Flash的FDCB頭。這個(gè)啟動(dòng)頭將FlexSPI配置成了四線模式，100MHz時(shí)鐘頻率，Quad I/O Fast Read時(shí)序模式（注意這個(gè)頭里lookupTable設(shè)定寫(xiě)法其實(shí)并不標(biāo)準(zhǔn)，沒(méi)有顯式地寫(xiě)出模式序列和停止序列，后面痞子衡會(huì)細(xì)說(shuō)）：

當(dāng)PC開(kāi)始指向FlexSPI映射空間（0x60000000 - 0x607FFFFF）去執(zhí)行用戶程序時(shí)，F(xiàn)lexSPI便在背后一直默默為CPU送上指定的指令數(shù)據(jù)，如下圖綠色箭頭流向所示。指令數(shù)據(jù)從外部Flash中通過(guò)IO_CTL且按照SEQ_CTL指定的時(shí)序送入RX_FIFO，再到AHB_RX_BUF，最后經(jīng)過(guò)AHB_CTL送到系統(tǒng)AHB總線上，以被CPU無(wú)障礙獲取。整個(gè)過(guò)程中最重要的自動(dòng)化環(huán)節(jié)其實(shí)是黃色框內(nèi)的SEQ_CTL，是這個(gè)SEQ_CTL在時(shí)刻驅(qū)動(dòng)著FlexSPI發(fā)送符合Flash要求的讀訪問(wèn)時(shí)序。

二、FlexSPI外設(shè)的SEQ_CTL是如何工作的？

經(jīng)過(guò)上一節(jié)的分析，我們知道了是FlexSPI中的SEQ_CTL組件實(shí)現(xiàn)了核心的Flash訪問(wèn)時(shí)序控制，那么SEQ_CTL我們?cè)撛趺纯刂扑?？別急，這時(shí)候該LUT登場(chǎng)，LUT是Look Up Table的簡(jiǎn)稱，它其實(shí)是FlexSPI內(nèi)部的一塊存儲(chǔ)區(qū)（即FlexSPI->LUTx寄存器），它的組織結(jié)構(gòu)如下，LUT由多個(gè)Sequence組成（比如i.MXRT1050上是16個(gè)），每個(gè)Sequence由最多8個(gè)instruction組成，每個(gè)instruction大小為16bits，分為opcode（序列編號(hào)） + num_pads（管腳模式） + operand（序列參數(shù)值）三部分。

每個(gè)instruction，你可以理解為一個(gè)Flash訪問(wèn)傳輸子序列（比如命令序列、地址序列、模式序列，dummy序列，讀/寫(xiě)數(shù)據(jù)序列，停止序列等），在FlexSPI外設(shè)模塊里面預(yù)先實(shí)現(xiàn)了很多個(gè)基礎(chǔ)instruction，instruction中的opcode即是那些預(yù)實(shí)現(xiàn)的序列編號(hào)。opcode全部編號(hào)如下：

命令序列:
    CMD_SDR   - 0x01， CMD_DDR   - 0x21
地址序列：
    RADDR_SDR - 0x02， RADDR_DDR - 0x22， CADDR_SDR - 0x03， CADDR_DDR - 0x23
模式序列：
    MODE1_SDR - 0x04， MODE1_DDR - 0x24， MODE2_SDR - 0x05， MODE2_DDR - 0x25
    MODE4_SDR - 0x06， MODE4_DDR - 0x26， MODE8_SDR - 0x07， MODE8_DDR - 0x27
寫(xiě)數(shù)據(jù)序列:
    WRITE_SDR - 0x08， WRITE_DDR - 0x28
讀數(shù)據(jù)序列:
    READ_SDR  - 0x09， READ_DDR  - 0x29
LEARN序列:
    LEARN_SDR - 0x0A， LEARN_DDR - 0x2A
數(shù)據(jù)長(zhǎng)度設(shè)置序列（適用FPGA）:
    DATSZ_SDR - 0x0B， DATSZ_DDR - 0x2B
空指令序列::
    DUMMY_SDR - 0x0C， DUMMY_DDR - 0x2C， DUMMY_RWDS_SDR - 0x0D， DUMMY_RWDS_DDR - 0x2D
JMP序列:
    JMP_ON_CS - 0x1F
停止序列:
    STOP      - 0x00

有了這些基礎(chǔ)instruction，我們便可以自由組合它們（最多8個(gè)），得到我們想要的完整傳輸Sequence。比如最常見(jiàn)的Quad I/O Read SDR傳輸時(shí)序便由CMD_SDR + RADDR_SDR + MODE8_SDR + DUMMY_SDR + READ_SDR + STOP六個(gè)子序列組成，如下表所示：

Note: 關(guān)于READ_SDR的參數(shù)值設(shè)置（即讀取數(shù)據(jù)長(zhǎng)度）需要特別說(shuō)明一下，這個(gè)參數(shù)僅對(duì)IP CMD方式的訪問(wèn)時(shí)序有效；而對(duì)于AHB CMD方式的訪問(wèn)時(shí)序，這個(gè)參數(shù)值設(shè)定是無(wú)效的，實(shí)際讀取數(shù)據(jù)長(zhǎng)度是由AHB RX Buffer策略靈活決定的。

從引腳信號(hào)上來(lái)看，完整Quad I/O Read SDR傳輸時(shí)序如下圖所示。注意有一處要特別說(shuō)明，從FlexSPI外設(shè)本身而言，MODE8_SDR序列和DUMMY_SDR序列是互相獨(dú)立的，但在不少Flash芯片上，MODE8_SDR所占的2個(gè)時(shí)鐘周期也被算在了總Dummy時(shí)鐘周期數(shù)里。

LUT中最多可以存儲(chǔ)16個(gè)Sequence，對(duì)于XIP執(zhí)行而言，只需要一個(gè)讀訪問(wèn)時(shí)序（比如最常用的Quad I/O Read SDR傳輸時(shí)序）即可。如果是IAP，那么還需要添加擦除時(shí)序，寫(xiě)訪問(wèn)時(shí)序，寫(xiě)使能時(shí)序，讀狀態(tài)寄存器時(shí)序等。這些預(yù)先存放在LUT中的Sequence被用戶按需觸發(fā)以實(shí)現(xiàn)各種不同類型的Flash訪問(wèn)，這就是SEQ_CTL工作機(jī)制。

三、FDCB中的lookupTable是如何配置進(jìn)FlexSPI->LUT的？

從FlexSPI外設(shè)模塊設(shè)計(jì)上而言，LUT里16個(gè)Sequence地位是相同的，對(duì)于XIP執(zhí)行，必要的讀訪問(wèn)時(shí)序可以放在LUT中的任何一個(gè)Sequence位置，只需要在FlexSPI->FLSHxCR2寄存器（x可取A1/A2/B1/B2，具體根據(jù)Flash引腳連接來(lái)定）中的ARDSEQID位指明讀訪問(wèn)時(shí)序在LUT中的位置(index)即可。

但是畢竟應(yīng)用程序是由BootROM引導(dǎo)的，BootROM有自己的一套配置FlexSPI規(guī)則，它定死了CMD_LUT_SEQ_IDX_READ位置，即讀訪問(wèn)時(shí)序必須是FlexSPI->LUT[]中第一個(gè)Sequence，因?yàn)镕lexSPI->FLSHxCR2[ARDSEQID]被BootROM配置成了0。所以我們?cè)跍?zhǔn)備FDCB時(shí)，lookupTable中第一個(gè)Sequence必須放置讀訪問(wèn)時(shí)序。

再來(lái)看BootROM中的FlexSPI初始化函數(shù)，在外設(shè)模塊基本初始化 flexspi_init() 完成后，然后 flexspi_update_lut() 被調(diào)用去更新了一次LUT就直接結(jié)束了。這次的LUT更新其實(shí)僅僅是將FDCB里的lookupTable[0] - lookupTable[3]（第一條Sequence） 填到 FlexSPI->LUT[0] - FlexSPI->LUT[3]里。至于為何有時(shí)候你會(huì)看到FDCB里lookupTable中不止一條Sequence，這個(gè)痞子衡后面另有文章再聊。

status_t flexspi_nor_flash_init(uint32_t instance, flexspi_nor_config_t *config)
{
    status_t status = kStatus_InvalidArgument;

    status = flexspi_init(instance, (flexspi_mem_config_t *)config);
    if (status != kStatus_Success)
    {
        break;
    }

    // Configure Lookup table for Read
    // 將config->memConfig.lookupTable里的第一個(gè)sequence放到FlexSPI->LUT[0] - FlexSPI->LUT[3]里
    flexspi_update_lut(instance, 0, config->memConfig.lookupTable, 1);

    return status;
}

四、設(shè)定FDCB中l(wèi)ookupTable的一個(gè)實(shí)例

我們以i.MXRT官方EVK上配套的典型Flash型號(hào)IS25WP064AJBLE來(lái)實(shí)戰(zhàn)，下圖是該Flash的Fast Read Quad I/O Sequence，這個(gè)時(shí)序圖中命令序列、地址序列、Dummy序列的參數(shù)值是明確的，但模式序列、讀數(shù)據(jù)序列參數(shù)值并不明確，我們給它明確一下，模式序列中mode bits我們?cè)O(shè)為0x00（其實(shí)只要不是0xAx均可），即 non-continuous read mode；讀數(shù)據(jù)序列中data out byte其實(shí)不可設(shè)（上面講過(guò)AHB訪問(wèn)下是由RX Buffer策略自動(dòng)控制的），隨便寫(xiě)個(gè)非0值即可。

基于上面的真實(shí)Flash讀數(shù)據(jù)傳輸時(shí)序圖，我們?cè)贔DCB中l(wèi)ookupTable里的對(duì)應(yīng)設(shè)定應(yīng)如下：

#define CMD_LUT_SEQ_IDX_READ        0

#define FLEXSPI_LUT_SEQ(cmd0, pad0, op0, cmd1, pad1, op1)                                  \
    (FLEXSPI_LUT_OPERAND0(op0) | FLEXSPI_LUT_NUM_PADS0(pad0) | FLEXSPI_LUT_OPCODE0(cmd0) | \
     FLEXSPI_LUT_OPERAND1(op1) | FLEXSPI_LUT_NUM_PADS1(pad1) | FLEXSPI_LUT_OPCODE1(cmd1))

#define FLEXSPI_1PAD 0
#define FLEXSPI_2PAD 1
#define FLEXSPI_4PAD 2
#define FLEXSPI_8PAD 3

const flexspi_nor_config_t qspiflash_config = {
    .memConfig =
        {
            .lookupTable =
                {
                    // Quad I/O Fast Read LUTs
                    // 第1個(gè)instruction是CMD_SDR，參數(shù)值為0xEB，即Quad I/O Fast Read命令
                    // 第2個(gè)instruction是RADDR_SDR，參數(shù)值為0x18，即24bits地址（三字節(jié)）
                    [4*CMD_LUT_SEQ_IDX_READ + 0] = FLEXSPI_LUT_SEQ(CMD_SDR,   FLEXSPI_1PAD, 0xEB, RADDR_SDR, FLEXSPI_4PAD, 0x18),

                    // 第3個(gè)instruction是MODE8_SDR，參數(shù)值為0x00。注意對(duì)于IS25WP064AJBLE它同時(shí)也算2個(gè)Dummy時(shí)鐘周期?。?！
                    // 第4個(gè)instruction是DUMMY_SDR，參數(shù)值為0x04，加上上面一共6個(gè)時(shí)鐘周期
                    [4*CMD_LUT_SEQ_IDX_READ + 1] = FLEXSPI_LUT_SEQ(MODE8_SDR, FLEXSPI_4PAD, 0x00, DUMMY_SDR, FLEXSPI_4PAD, 0x04),

                    // 第5個(gè)instruction是READ_SDR，參數(shù)值為0x04，設(shè)定并不生效，隨便寫(xiě)個(gè)非0值都行
                    // 第6個(gè)instruction是STOP
                    [4*CMD_LUT_SEQ_IDX_READ + 2] = FLEXSPI_LUT_SEQ(READ_SDR,  FLEXSPI_4PAD, 0x04, STOP,      FLEXSPI_1PAD, 0x00),
                    [4*CMD_LUT_SEQ_IDX_READ + 3] = 0,
                },
        },
};

五、對(duì)FlexSPI映射區(qū)域進(jìn)行AHB讀訪問(wèn)一定會(huì)啟動(dòng)SEQ_CTL工作嗎？

當(dāng)我們放好了正確的FDCB，BootROM正常配置完FlexSPI，并啟動(dòng)了應(yīng)用程序后，CPU便開(kāi)始按部就班從FlexSPI映射區(qū)域直接AHB訪問(wèn)去獲取應(yīng)用程序指令，是不是每一次的CPU訪問(wèn)都會(huì)讓SEQ_CTL組件按LUT里的設(shè)定發(fā)送一次讀訪問(wèn)時(shí)序呢？其實(shí)并不是！

我們知道i.MXRT系列會(huì)有L1 Cache，如果Flash某地址里的指令內(nèi)容緩存在L1 Cache里，那么當(dāng)前CPU訪問(wèn)該Flash地址處的指令并不需要從Flash里重新再獲取一次，CPU直接從cache里便可以得到指令，此時(shí)SEQ_CTL不會(huì)工作。

即便L1 Cache里沒(méi)有緩存到CPU所要指令，如果FlexSPI本身的Cacheable和Prefetch功能打開(kāi)的話，AHB RX/TX Buffer里可能也會(huì)緩存CPU所要指令。如果所需指令確實(shí)緩存在AHB Buffer里，SEQ_CTL仍然不會(huì)工作。

僅當(dāng)CPU所要指令是全新的，完全沒(méi)有緩存，SEQ_CTL才會(huì)真正開(kāi)始工作，按LUT設(shè)定去發(fā)送讀數(shù)據(jù)訪問(wèn)時(shí)序給Flash。

六、AHB讀訪問(wèn)下SEQ_CTL工作一次到底獲取多長(zhǎng)的數(shù)據(jù)？

前面講了，我們?cè)趌ookupTable里無(wú)法有效設(shè)置讀數(shù)據(jù)序列中data out byte，因?yàn)锳HB訪問(wèn)下的一次讀取的長(zhǎng)度是由RX Buffer策略控制的。在i.MXRT1050中AHB RX Buffer總大小為1KB，分為四個(gè)：AHB RX Buffer0 - AHB RX Buffer3，每個(gè)Buffer的大小都是可配的。具體配置在如下FlexSPI->AHBRXBUFxCR0寄存器里：

BootROM使用了如下 flexspi_config_ahb_buffers() 函數(shù)配置了AHB Buffer，即開(kāi)啟了FlexSPI的Prefetch功能，并且將四個(gè)FlexSPI->AHBRXBUFxCR0[BUFSZ]全部設(shè)為了0，根據(jù)手冊(cè)，這種配置意味著僅啟用Buffer3作為唯一的RX Buffer，并且Buffer3大小為1KB。那么我們現(xiàn)在知道了，在Prefetch開(kāi)啟的情況下，SEQ_CTL工作一次就會(huì)讀取1KB數(shù)據(jù)。當(dāng)然Prefetch功能是可以在應(yīng)用程序里被關(guān)掉的，如果Prefetch不使能，SEQ_CTL工作一次僅獲取最小數(shù)據(jù)單元（8bytes）。

status_t flexspi_config_ahb_buffers(FLEXSPI_Type *base, flexspi_mem_config_t *config)
{
    uint32_t temp;
    uint32_t index;
    status_t status = kStatus_InvalidArgument;

    do
    {
        if ((base == NULL) || (config == NULL))
        {
            break;
        }

        if (config->deviceType == kFlexSpiDeviceType_SerialNOR)
        {
            // Configure AHBCR
            temp = base->AHBCR & (~FLEXSPI_AHBCR_APAREN_MASK);
            // Remove alignment limitation when Flash device works under DDR mode.
            temp |= FLEXSPI_AHBCR_READADDROPT_MASK;
#if FLEXSPI_FEATURE_HAS_PARALLEL_MODE
            if (flexspi_is_parallel_mode(config))
            {
                temp |= FLEXSPI_AHBCR_APAREN_MASK;
            }
#endif // FLEXSPI_FEATURE_HAS_PARALLEL_MODE
            base->AHBCR = temp;
        }

        // Enable prefetch feature
        base->AHBCR |= FLEXSPI_AHBCR_PREFETCHEN_MASK;

        // Skip AHB buffer configuration if corresponding bit is set
        if ((config->controllerMiscOption & (1<<kFlexSpiMiscOffset_SkipAhbBufConfig)))
        {
            status = kStatus_Success;
            break;
        }

        // Configure AHB RX buffer
        for (index = 0; index < FLEXSPI_AHBRXBUFCR0_COUNT - 1; index++)
        {
            base->AHBRXBUFCR0[index] &=
                ~(FLEXSPI_AHBRXBUFCR0_BUFSZ_MASK | FLEXSPI_AHBRXBUFCR0_MSTRID_MASK | FLEXSPI_AHBRXBUFCR0_PRIORITY_MASK);
        }
        status = kStatus_Success;

    } while (0);

    return status;
}

至此，i.MXRT啟動(dòng)頭FDCB里的lookupTable痞子衡便介紹完畢了，掌聲在哪里~~~