簡(jiǎn)介本資源是一套面向嵌入式開發(fā)工程師與單片機(jī)初學(xué)者的SPI Flash驅(qū)動(dòng)代碼實(shí)現(xiàn)聚焦MX25L128128MB與MX25L256256MB兩款Microchip高容量串行閃存芯片的底層通信支持解決微控制器外擴(kuò)非易失存儲(chǔ)時(shí)的初始化、讀寫、扇區(qū)擦除及狀態(tài)校驗(yàn)等核心問題適用于STM32、AVR、ESP32等主流平臺(tái)的裸機(jī)或RTOS環(huán)境開發(fā)。壓縮包共4個(gè)文件2個(gè)C源文件 2個(gè)頭文件總大小僅8KB結(jié)構(gòu)精簡(jiǎn)C文件封裝了SPI初始化、命令發(fā)送、多字節(jié)地址讀寫、扇區(qū)擦除及寫使能/禁止等完整操作函數(shù)H文件提供寄存器定義、宏指令封裝與API接口聲明便于快速移植與調(diào)用。目前已有1198人學(xué)習(xí)下載代碼注釋清晰、邏輯分層明確涵蓋RDSR狀態(tài)輪詢、CS信號(hào)管理、時(shí)序延時(shí)處理及基礎(chǔ)錯(cuò)誤檢查機(jī)制可直接集成進(jìn)項(xiàng)目工程顯著降低SPI Flash適配門檻并提升開發(fā)效率。 如果你在搜“MX25L128 SPI驅(qū)動(dòng)代碼”多半是項(xiàng)目里要掛一顆SPI NOR Flash做代碼存儲(chǔ)或者日志記錄。這個(gè)標(biāo)題里的驅(qū)動(dòng)包核心就是MX25L128和MX25L256兩代128Mbit/256Mbit SPI Flash的驅(qū)動(dòng)實(shí)現(xiàn)涵蓋命令封裝、時(shí)序控制、擦寫流程這些跑業(yè)務(wù)前必須搞定的基礎(chǔ)動(dòng)作。我的建議很直接不要拿到代碼就復(fù)制粘貼先把Flash的命令集和SPI時(shí)序吃透再動(dòng)手改引腳和時(shí)鐘這樣移植到STM32、GD32甚至國(guó)產(chǎn)MCU上才順手。這個(gè)包對(duì)我最大的價(jià)值就是省去了翻數(shù)據(jù)手冊(cè)寫第一版驅(qū)動(dòng)的時(shí)間但真正跑穩(wěn)定靠的還是把底層機(jī)制理解到位。無(wú)論你是剛接觸SPI Flash的初學(xué)者還是已經(jīng)在其他平臺(tái)寫過類似驅(qū)動(dòng)的工程師這篇文章都會(huì)把MX25L128/MX25L256的SPI驅(qū)動(dòng)代碼拆開揉碎從協(xié)議基礎(chǔ)、芯片特性、驅(qū)動(dòng)架構(gòu)到實(shí)際移植和常見坑點(diǎn)一次性說清楚。不想聽理論只想抄代碼的可以直接跳到第4節(jié)但強(qiáng)烈建議抽時(shí)間把第2節(jié)看了很多疑難雜癥的根源都藏在SPI模式和命令細(xì)節(jié)里。1. 內(nèi)容整體設(shè)計(jì)與思路拆解1.1 標(biāo)題背后是什么先把這個(gè)文件名拆開看MX25L128_MX25L256_SPI驅(qū)動(dòng)代碼.rar。里面通常包含的是兩個(gè)型號(hào)的驅(qū)動(dòng)工程或者源碼文件MX25L128和MX25L256分別是128Mbit16MB和256Mbit32MB的NOR Flash。這里的“SPI驅(qū)動(dòng)”不是指MCU的SPI外設(shè)初始化那么淺而是指圍繞這顆Flash芯片封裝出來的一套讀寫擦除接口。這類驅(qū)動(dòng)代碼包在項(xiàng)目里的角色說直白點(diǎn)就是“存儲(chǔ)底座”。你要存固件升級(jí)包要存配置文件要存設(shè)備運(yùn)行日志甚至要掛一個(gè)文件系統(tǒng)底層都離不開這套Flash驅(qū)動(dòng)。很多工程師第一次接觸SPI Flash時(shí)容易陷入一個(gè)誤區(qū)以為驅(qū)動(dòng)就是幾個(gè)HAL_SPI_Transmit調(diào)用接在一起。實(shí)際上命令時(shí)序、狀態(tài)輪詢、頁(yè)邊界處理、4字節(jié)地址模式切換這些才是驅(qū)動(dòng)是否可靠的分水嶺。我見過不少人把網(wǎng)上代碼粘過來讀ID能過但寫入之后斷電重啟數(shù)據(jù)就丟了。原因是寫操作沒有正確判斷WIP忙狀態(tài)位CS片選時(shí)序也沒摳好。所以這套代碼的真正含金量在于對(duì)這些狀態(tài)的正確管理和邊界情況的處理。1.2 前置知識(shí)準(zhǔn)備在用這套驅(qū)動(dòng)之前你不需要精通Flash內(nèi)部原理但至少得清楚三件事SPI是主從通信MCU做主機(jī)Flash做從機(jī)四根線SCLK、MOSI、MISO、CS各司其職CS低電平選中芯片。Flash寫入前必須先擦除擦除以扇區(qū)Sector通常4KB或塊Block通常64KB為最小單位這一點(diǎn)和EEPROM完全不同。讀命令、寫命令、擦除命令都有固定格式發(fā)錯(cuò)一個(gè)字節(jié)芯片就不理你。這三條理解透了后面看代碼就不會(huì)懵。如果哪一條不太熟第2節(jié)會(huì)把SPI協(xié)議和MX25L系列芯片特性重新捋一遍。2. SPI通信與MX25L系列芯片特性2.1 SPI協(xié)議基礎(chǔ)四根線各司其職SPI通信本質(zhì)上就是一組移位寄存器在主從機(jī)之間循環(huán)移位。你可以把它想象成四個(gè)人配合干活SCLK是節(jié)拍器每跳一下主從雙方各移出一位數(shù)據(jù)、各采入一位數(shù)據(jù)MOSI是主機(jī)向從機(jī)送數(shù)據(jù)的通道MISO是從機(jī)向主機(jī)回?cái)?shù)據(jù)的通道CS是隊(duì)長(zhǎng)的點(diǎn)名信號(hào)低電平表示“這次通信我選中你了其他芯片靠邊站”。SPI有四種模式由CPOL時(shí)鐘極性和CPHA時(shí)鐘相位組合決定。CPOL決定空閑時(shí)SCLK是高還是低CPHA決定數(shù)據(jù)在時(shí)鐘上升沿還是下降沿被采樣。MX25L系列Flash支持Mode 0CPOL0, CPHA0和Mode 3CPOL1, CPHA1大多數(shù)驅(qū)動(dòng)代碼默認(rèn)用Mode 0也就是空閑時(shí)鐘為低、數(shù)據(jù)在上升沿采樣。如果你的板子死活讀不到正確數(shù)據(jù)第一件事就是查SPI的CPOL和CPHA配置尤其是從別人的工程移植過來的場(chǎng)景這一條我踩過不只一次。還有一個(gè)容易忽略的點(diǎn)MOSI在發(fā)送完命令和地址之后繼續(xù)發(fā)送的每一個(gè)字節(jié)都是時(shí)鐘信號(hào)。讀操作的時(shí)候主機(jī)要持續(xù)發(fā)送0xFF或者0x00來產(chǎn)生時(shí)鐘從機(jī)才會(huì)把數(shù)據(jù)放到MISO上。代碼里讀數(shù)據(jù)的那些HAL_SPI_Receive調(diào)用本質(zhì)上是主機(jī)在一邊發(fā)空數(shù)據(jù)一邊收數(shù)據(jù)不理解這一點(diǎn)看DMA模式下的讀代碼就會(huì)一頭霧水。2.2 MX25L128與MX25L256關(guān)鍵參數(shù)對(duì)比MX25L128和MX25L256都是Macronix旺宏的SPI NOR Flash產(chǎn)品線命令集高度兼容所以一套驅(qū)動(dòng)代碼往往能同時(shí)覆蓋這兩個(gè)型號(hào)。這也是標(biāo)題里把兩個(gè)型號(hào)放在一起的原因。下面是它們的一些關(guān)鍵參數(shù)對(duì)比參數(shù)MX25L12835FMX25L25645G容量128Mbit / 16MB256Mbit / 32MB頁(yè)大小256字節(jié)256字節(jié)扇區(qū)大小4KB4KB塊大小64KB部分型號(hào)含32KB塊64KB地址寬度3字節(jié)24bit支持3字節(jié)/4字節(jié)切換最高SPI時(shí)鐘133MHz133MHz標(biāo)準(zhǔn)讀命令 0x03支持支持快速讀命令 0x0B支持支持頁(yè)編程 0x02支持支持扇區(qū)擦除 0x20支持支持兩者最大的差異在最后一行旁邊的“地址寬度”。MX25L256容量超過16MB3字節(jié)地址最多只能覆蓋到16MB所以芯片內(nèi)部設(shè)計(jì)了4字節(jié)地址模式。驅(qū)動(dòng)里必須對(duì)這顆256Mbit的芯片做特殊處理要么初始化時(shí)發(fā)0xB7命令切到4字節(jié)地址模式要么后續(xù)所有讀改寫命令都改用4字節(jié)地址版本的命令碼比如0x13代替0x03、0x12代替0x02。如果拿著MX25L128的驅(qū)動(dòng)不修改直接上256的芯片能讀前16MB超過16MB的地址全部亂套。另一個(gè)容易被忽視的參數(shù)是“塊大小”和“扇區(qū)大小”。擦除命令按粒度區(qū)分0x20擦除4KB扇區(qū)0x52擦除32KB塊0xD8擦除64KB塊0xC7或0x60整片擦除。設(shè)計(jì)驅(qū)動(dòng)接口時(shí)我會(huì)把“擦除扇區(qū)”和“擦除塊”分開封裝業(yè)務(wù)層按需調(diào)用避免誤操作把大面積數(shù)據(jù)清掉。2.3 Flash命令集常用的幾條命令MX25L系列命令集基本延續(xù)了行業(yè)標(biāo)準(zhǔn)下面這張表是驅(qū)動(dòng)里最常用到的幾條命令命令碼功能說明Write Enable0x06寫使能執(zhí)行寫/擦除前必須先發(fā)Write Disable0x04寫禁用Read Status Register0x05讀狀態(tài)寄存器判斷WIP忙狀態(tài)Read Data0x03普通讀最大50MHzFast Read0x0B快速讀附加1個(gè)Dummy字節(jié)最大133MHzPage Program0x02頁(yè)編程一次最多256字節(jié)Sector Erase0x204KB扇區(qū)擦除Block Erase0xD864KB塊擦除Chip Erase0xC7整片擦除Read ID0x9F讀芯片IDEnter 4-Byte Mode0xB7進(jìn)入4字節(jié)地址模式狀態(tài)寄存器是驅(qū)動(dòng)核心依賴的寄存器0x05讀出來的字節(jié)里bit0是WIPWrite In Progressbit1是WELWrite Enable Latch。寫完或擦除后芯片內(nèi)部自動(dòng)把WIP置1完成后清零。驅(qū)動(dòng)里必須輪詢這個(gè)位直到它變成0才算當(dāng)前操作真正完成。很多數(shù)據(jù)丟失問題就是沒等這個(gè)標(biāo)志位導(dǎo)致的。還有一點(diǎn)要注意0x9F讀ID命令MX25L系列通常返回3個(gè)字節(jié)廠商ID0xC2旺宏、類型0x20、容量0x18對(duì)應(yīng)128Mbit0x19對(duì)應(yīng)256Mbit。驅(qū)動(dòng)里通過這三個(gè)字節(jié)就能區(qū)分當(dāng)前掛了哪顆芯片從而決定是否需要走4字節(jié)地址邏輯。3. 驅(qū)動(dòng)代碼架構(gòu)與設(shè)計(jì)思路3.1 驅(qū)動(dòng)分層底層抽象與上層命令分離好的SPI Flash驅(qū)動(dòng)一定不是把所有代碼堆在一個(gè)文件里。我習(xí)慣把驅(qū)動(dòng)拆成三層SPI硬件抽象層、Flash命令層、應(yīng)用接口層。SPI硬件抽象層只負(fù)責(zé)最底層的字節(jié)收發(fā)比如基于STM32 HAL庫(kù)封裝幾個(gè)函數(shù)SPI_Transmit、SPI_Receive、SPI_TransmitReceive。這一層是唯一需要?jiǎng)覯CU相關(guān)代碼的地方換平臺(tái)就重寫這一層上面兩層基本不動(dòng)。Flash命令層根據(jù)芯片數(shù)據(jù)手冊(cè)把命令碼和收發(fā)邏輯封裝成具體操作比如MX25L_SendCommand、MX25L_ReadStatusReg、MX25L_WaitBusy。這層不關(guān)心業(yè)務(wù)只負(fù)責(zé)“把這條命令按協(xié)議發(fā)出去并處理結(jié)果”。應(yīng)用接口層面向業(yè)務(wù)提供MX25L_Read、MX25L_Write、MX25L_EraseSector、MX25L_EraseChip這類接口。寫接口內(nèi)部自動(dòng)處理頁(yè)邊界拆分、擦寫前等待、寫使能等邏輯業(yè)務(wù)方不需要了解Flash細(xì)節(jié)直接按“偏移地址緩沖區(qū)”來調(diào)用。這樣分層的意義等你換MCU或者換Flash型號(hào)時(shí)就體會(huì)到了。我最早一個(gè)項(xiàng)目直接在主邏輯文件里寫HAL_SPI_Transmit后面換Flash芯片改得頭皮發(fā)麻。后來重構(gòu)成分層結(jié)構(gòu)換芯片只需要改命令層換MCU只需要改最底層。3.2 核心數(shù)據(jù)結(jié)構(gòu)與狀態(tài)管理驅(qū)動(dòng)里最好維護(hù)一個(gè)Flash對(duì)象結(jié)構(gòu)體把當(dāng)前芯片的狀態(tài)記下來typedef struct { SPI_HandleTypeDef *spiHandle; // SPI外設(shè)句柄 GPIO_TypeDef *csPort; // CS引腳端口 uint16_t csPin; // CS引腳號(hào) uint32_t capacity; // 容量單位字節(jié) uint16_t pageSize; // 頁(yè)大小通常256 uint8_t addrMode; // 3字節(jié)或4字節(jié)地址模式 } MX25L_Flash_t;有了這個(gè)結(jié)構(gòu)體驅(qū)動(dòng)函數(shù)就能傳一個(gè)指針進(jìn)去代碼復(fù)用性高很多。狀態(tài)管理方面驅(qū)動(dòng)內(nèi)部至少要實(shí)現(xiàn)WaitBusy超時(shí)機(jī)制。我一般用簡(jiǎn)單的循環(huán)遞減做超時(shí)因?yàn)镕lash擦除時(shí)間可能長(zhǎng)達(dá)幾秒整片擦除甚至上百秒如果驅(qū)動(dòng)被用在帶操作系統(tǒng)的環(huán)境循環(huán)等待期間還要考慮是否讓出CPU或者把等待邏輯改成異步查詢。3.3 硬件片選與軟件片選我推薦軟件控制這里展開說一下熱詞里提到的“SPI硬件片選與軟件片選”。很多MCU的SPI外設(shè)帶硬件NSS功能發(fā)送數(shù)據(jù)時(shí)自動(dòng)把NSS拉低傳輸結(jié)束自動(dòng)拉高。聽起來很省事但在Flash驅(qū)動(dòng)里硬件NSS往往會(huì)帶來麻煩。原因在于某些Flash命令需要CS連續(xù)保持低電平。比如普通讀0x03命令發(fā)送完命令和地址后主機(jī)要持續(xù)產(chǎn)生時(shí)鐘讀數(shù)據(jù)只要你還在讀CS就必須保持低。如果用硬件NSS它會(huì)在你第一次調(diào)用SPI_Transmit結(jié)束后就把CS拉高后面的數(shù)據(jù)就全廢了。所以我的方案始終是軟件控制CS把CS配置為普通GPIO輸出在每條命令開始前手動(dòng)拉低整條命令的數(shù)據(jù)交互全部結(jié)束后再拉高。代碼里就兩行宏定義#define FLASH_CS_LOW() HAL_GPIO_WritePin(FLASH_CS_GPIO_Port, FLASH_CS_Pin, GPIO_PIN_RESET) #define FLASH_CS_HIGH() HAL_GPIO_WritePin(FLASH_CS_GPIO_Port, FLASH_CS_Pin, GPIO_PIN_SET)另外MX25L系列Flash還有WP#和HOLD#引腳。WP#是寫保護(hù)引腳低電平時(shí)禁止寫入狀態(tài)寄存器和擦寫操作HOLD#是暫停引腳低電平時(shí)芯片暫停通信。這兩根引腳如果不用必須通過電阻上拉到高電平否則就算代碼寫得再對(duì)寫操作也會(huì)莫名其妙失敗。這個(gè)細(xì)節(jié)PCB設(shè)計(jì)時(shí)就要注意軟件排查時(shí)如果發(fā)現(xiàn)寫不進(jìn)去也要先量一下這兩個(gè)引腳的電位。4. 實(shí)操環(huán)節(jié)基于STM32 HAL庫(kù)的驅(qū)動(dòng)移植4.1 初始化流程設(shè)計(jì)我一般把初始化分成兩步MCU的SPI外設(shè)初始化和Flash芯片的初始化確認(rèn)。MCU這邊用STM32CubeMX配置最快SPI選用Mode 0速度先保守一點(diǎn)分頻到10MHz左右等調(diào)通了再往上提。CS引腳配置為GPIO輸出初始輸出高電平避免上電瞬間誤選中Flash。Flash芯片初始化要做的事情有兩件讀ID確認(rèn)芯片連接正確如果是MX25L256開啟4字節(jié)地址模式。初始化函數(shù)大致長(zhǎng)這樣uint8_t MX25L_Init(MX25L_Flash_t *flash) { uint32_t id MX25L_ReadID(flash); if ((id 0xFF0000) ! 0xC20000) { return 1; // ID異常 } uint8_t density id 0xFF; if (density 0x19) { // MX25L256 flash-capacity 32 * 1024 * 1024; MX25L_Enter4ByteMode(flash); } else { flash-capacity 16 * 1024 * 1024; } return 0; }4.2 關(guān)鍵驅(qū)動(dòng)代碼實(shí)現(xiàn)先說讀ID這是驅(qū)動(dòng)移植后的第一個(gè)驗(yàn)證點(diǎn)。能讀到正確的廠商和容量ID說明SPI通信通路沒問題讀不到或者讀錯(cuò)優(yōu)先檢查SPI模式、CS引腳、時(shí)鐘使能。讀ID的代碼可以這樣寫uint32_t MX25L_ReadID(MX25L_Flash_t *flash) { uint8_t cmd 0x9F; uint8_t rx[3] {0}; FLASH_CS_LOW(); HAL_SPI_Transmit(flash-spiHandle, cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(flash-spiHandle, rx, 3, HAL_MAX_DELAY); FLASH_CS_HIGH(); return (rx[0] 16) | (rx[1] 8) | rx[2]; }接下來是寫使能和等待忙這兩個(gè)函數(shù)幾乎貫穿所有寫操作void MX25L_WriteEnable(MX25L_Flash_t *flash) { uint8_t cmd 0x06; FLASH_CS_LOW(); HAL_SPI_Transmit(flash-spiHandle, cmd, 1, HAL_MAX_DELAY); FLASH_CS_HIGH(); } uint8_t MX25L_WaitBusy(MX25L_Flash_t *flash, uint32_t timeout) { uint8_t cmd 0x05; uint8_t status 0; while (timeout--) { FLASH_CS_LOW(); HAL_SPI_Transmit(flash-spiHandle, cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(flash-spiHandle, status, 1, HAL_MAX_DELAY); FLASH_CS_HIGH(); if ((status 0x01) 0) { return 0; } } return 1; // 超時(shí) }頁(yè)編程是寫操作的核心。一次最多寫256字節(jié)而且不能跨頁(yè)。也就是說如果當(dāng)前地址在頁(yè)內(nèi)的剩余空間不足你要寫的長(zhǎng)度就得拆成兩次或者多次寫操作。代碼里我通常在做Write封裝時(shí)先把“本頁(yè)最大可寫長(zhǎng)度”算出來uint8_t MX25L_WritePage(MX25L_Flash_t *flash, uint32_t addr, const uint8_t *buf, uint16_t len) { uint16_t maxLen flash-pageSize - (addr % flash-pageSize); if (len maxLen) { return 1; // 超出頁(yè)邊界 } MX25L_WriteEnable(flash); FLASH_CS_LOW(); uint8_t cmd[4] {0x02, (addr 16) 0xFF, (addr 8) 0xFF, addr 0xFF}; HAL_SPI_Transmit(flash-spiHandle, cmd, 4, HAL_MAX_DELAY); HAL_SPI_Transmit(flash-spiHandle, (uint8_t *)buf, len, HAL_MAX_DELAY); FLASH_CS_HIGH(); MX25L_WaitBusy(flash, 10000); return 0; }注意:上面代碼默認(rèn)3字節(jié)地址模式。如果在MX25L256上開啟了4字節(jié)地址模式命令地址部分就要改成發(fā)4個(gè)字節(jié)也就是把0x02改成0x12或者保留0x02但后面跟4字節(jié)地址具體取決于你用的地址模式和命令組合。實(shí)際工程中我會(huì)把這種差異封裝進(jìn)一個(gè)發(fā)送地址的函數(shù)里避免在業(yè)務(wù)代碼里到處判斷。擦除操作更直接發(fā)完命令就是等忙uint8_t MX25L_EraseSector(MX25L_Flash_t *flash, uint32_t addr) { MX25L_WriteEnable(flash); FLASH_CS_LOW(); uint8_t cmd[4] {0x20, (addr 16) 0xFF, (addr 8) 0xFF, addr 0xFF}; HAL_SPI_Transmit(flash-spiHandle, cmd, 4, HAL_MAX_DELAY); FLASH_CS_HIGH(); return MX25L_WaitBusy(flash, 100000); }扇區(qū)擦除4KB通常要幾十到上百毫秒64KB塊擦除則要幾百毫秒到一秒多所以WaitBusy的超時(shí)要給足。如果你在RTOS環(huán)境里直接循環(huán)等待記得考慮線程調(diào)度問題或者干脆把這個(gè)驅(qū)動(dòng)放到專門的任務(wù)里跑。4.3 MX25L256的4字節(jié)地址模式處理MX25L256是256Mbit的容量3字節(jié)地址最多尋址16MB。如果你只用前16MB那確實(shí)可以不做任何特殊處理。但既然上了這顆料多數(shù)情況是為了用滿32MB。這時(shí)候就必須把芯片切到4字節(jié)地址模式。進(jìn)入4字節(jié)模式最簡(jiǎn)單的方法是開機(jī)初始化時(shí)發(fā)一條0xB7命令void MX25L_Enter4ByteMode(MX25L_Flash_t *flash) { uint8_t cmd 0xB7; FLASH_CS_LOW(); HAL_SPI_Transmit(flash-spiHandle, cmd, 1, HAL_MAX_DELAY); FLASH_CS_HIGH(); }0xB7命令是“非易失性”切換芯片掉電后依然保持4字節(jié)模式所以只需要在首次配置時(shí)做一次。命令執(zhí)行期間會(huì)有WIP忙狀態(tài)執(zhí)行完后也建議調(diào)用WaitBusy確認(rèn)一下。4字節(jié)模式下前面那些命令的地址字段都要從3字節(jié)改成4字節(jié)發(fā)送順序是高字節(jié)在前。這種改動(dòng)很容易出bug我的經(jīng)驗(yàn)是用一個(gè)工具函數(shù)專門拼地址void MX25L_BuildCommand(uint8_t *buf, uint8_t cmd, uint32_t addr, uint8_t addrBytes) { buf[0] cmd; for (int i 0; i addrBytes; i) { buf[1 i] (addr (8 * (addrBytes - 1 - i))) 0xFF; } }這樣讀、寫、擦除命令都走這一條拼包邏輯3字節(jié)還是4字節(jié)只取決于addrBytes傳入的是3還是4代碼干凈也容易查錯(cuò)。5. 常見問題與排查技巧實(shí)錄5.1 讀ID失敗或者讀出全0xFF這是最最常見的現(xiàn)象基本屬于“SPI通路沒建立起來”。排查順序我建議這樣走用示波器量CS引腳在發(fā)送命令期間是否被拉低如果CS始終高電平檢查GPIO初始化和宏定義。檢查SPI模式是否為Mode 0或者M(jìn)ode 3這兩種模式MX25L都支持但MCU必須和Flash約定一致。檢查SCLK時(shí)鐘有沒有輸出如果SCLK完全沒波形多半是SPI外設(shè)時(shí)鐘沒在CubeMX里使能或者引腳復(fù)用配置錯(cuò)誤。檢查MISO和MOSI是否接反。這種低級(jí)錯(cuò)誤我在樣板調(diào)試時(shí)也犯過用萬(wàn)用表量一下連線最直接。如果讀出來的ID是亂碼而不是全FF則更多是時(shí)序問題比如SPI速率太快、信號(hào)質(zhì)量差、線太長(zhǎng)或者串了比較大的電阻。這時(shí)候把SPI分頻調(diào)大一些降速再試。5.2 寫入后讀取全是FF遇到這種問題先別懷疑代碼邏輯排查思路按這個(gè)順序來第一寫操作是否完整執(zhí)行了寫使能。任何寫操作前必須發(fā)0x06并在發(fā)完0x06后檢查狀態(tài)寄存器的WEL位是否為1。如果WEL一直是0芯片根本不接受寫命令。第二寫之后有沒有等WIP清零。頁(yè)編程雖然看起來一瞬就完成了但芯片內(nèi)部擦寫需要時(shí)間。WIP沒清零之前讀出來的數(shù)據(jù)可能是舊數(shù)據(jù)或者全FF。必須等到WIP0再讀。第三WP#引腳是不是被拉低了。如果WP#被拉低芯片的寫保護(hù)生效所有寫命令都會(huì)被拒絕。這是硬件上最容易被忽略的點(diǎn)。第四地址是否對(duì)齊。頁(yè)編程要求地址和頁(yè)邊界對(duì)齊如果跨頁(yè)了后段數(shù)據(jù)會(huì)寫失敗。這個(gè)問題我放在下一小節(jié)專門說。5.3 寫入超過256字節(jié)失敗MX25L系列一次頁(yè)編程最多256字節(jié)。更準(zhǔn)確地說這256字節(jié)必須落在同一頁(yè)內(nèi)。當(dāng)寫入地址靠近頁(yè)末尾時(shí)比如頁(yè)偏移240字節(jié)你要寫32字節(jié)實(shí)際只有16字節(jié)能寫入當(dāng)前頁(yè)剩下的16字節(jié)會(huì)回卷到本頁(yè)開頭把前面的數(shù)據(jù)覆蓋掉或者被芯片直接拒絕。解決這個(gè)問題標(biāo)準(zhǔn)做法是在Write入口函數(shù)里做拆分。我參考過很多開源方案最簡(jiǎn)單的是在外面包一層循環(huán)uint16_t MX25L_Write(MX25L_Flash_t *flash, uint32_t addr, const uint8_t *buf, uint16_t len) { uint16_t written 0; while (len 0) { uint16_t pageLeft flash-pageSize - (addr % flash-pageSize); uint16_t chunk (len pageLeft) ? pageLeft : len; if (MX25L_WritePage(flash, addr, buf, chunk) ! 0) { break; } addr chunk; buf chunk; len - chunk; written chunk; } return written; }每個(gè)chunk寫到頁(yè)邊界就停下來下一輪循環(huán)從新頁(yè)開頭繼續(xù)這樣頁(yè)編程嚴(yán)格落在單頁(yè)范圍內(nèi)。5.4 擦除時(shí)間過長(zhǎng)導(dǎo)致看門狗復(fù)位Flash擦除是一種慢操作4KB扇區(qū)擦除典型值在幾十到一百毫秒64KB塊擦除可能到一秒鐘以上。如果你的系統(tǒng)開了看門狗又在擦除時(shí)循環(huán)等WIP很可能觸發(fā)看門狗復(fù)位。處理方案有幾個(gè)一是在擦除期間定期喂狗雖然不優(yōu)雅但最簡(jiǎn)單二是把擦除和等待分離成異步流程發(fā)完擦除命令后就退出定時(shí)查詢WIP三是調(diào)整看門狗超時(shí)時(shí)間讓超時(shí)覆蓋最慢的擦除場(chǎng)景。具體用哪種取決于你的業(yè)務(wù)對(duì)實(shí)時(shí)性的要求。我個(gè)人在批量擦除大量扇區(qū)的場(chǎng)景里更喜歡用異步查詢方式避免長(zhǎng)時(shí)間阻塞主任務(wù)。5.5 DMA傳輸和Cache一致性熱詞里出現(xiàn)了“SPI DMA”這確實(shí)是高性能場(chǎng)景繞不開的。用HAL庫(kù)的SPI DMA收發(fā)一個(gè)典型坑是接收緩沖區(qū)和發(fā)送緩沖區(qū)必須在Cache可管理的地址范圍內(nèi)。Cortex-M7或者M(jìn)33內(nèi)核的MCU如果開啟了CacheDMA訪問的內(nèi)存和CPU讀寫之間存在一致性風(fēng)險(xiǎn)最直觀的現(xiàn)象就是DMA收到的數(shù)據(jù)全是舊的或者發(fā)送出去的數(shù)據(jù)被篡改。解決辦法兩個(gè)方向buf定義為全局變量并做對(duì)齊通常對(duì)齊到32字節(jié)或者關(guān)閉相關(guān)內(nèi)存區(qū)域的Cache。在Cortex-M7上我通常用MPU單獨(dú)把DMA緩沖區(qū)所在區(qū)域配置為非Cache或者用SCB_CleanDCache/InvalidateDCache在DMA前后手動(dòng)維護(hù)一致性。這個(gè)坑不是每次都會(huì)出現(xiàn)但一旦出現(xiàn)就非常難查建議一開始就按規(guī)范做。6. 性能優(yōu)化與后續(xù)擴(kuò)展6.1 開啟Quad SPI模式如果你對(duì)讀取吞吐有要求比如OTA升級(jí)包有幾MB要快速搬到內(nèi)存標(biāo)準(zhǔn)SPI模式即使跑到133MHz單向也就16MB/s左右。MX25L系列支持Quad模式用四條數(shù)據(jù)線同時(shí)傳數(shù)據(jù)理論上能提升好幾倍吞吐。要開啟Quad Output Fast Read除了發(fā)送0x6B或0xEB命令還得把芯片狀態(tài)寄存器里的QE位Quad Enable置1。寫狀態(tài)寄存器的步驟是先寫使能0x06然后發(fā)送寫狀態(tài)命令再寫入目標(biāo)寄存器的值。不同型號(hào)QE位的位置不一樣MX25L12835F和MX25L25645G的QE位都在狀態(tài)寄存器2的高位區(qū)域具體需要查對(duì)應(yīng)數(shù)據(jù)手冊(cè)確認(rèn)。一旦QE位置1WP#引腳和HOLD#引腳的功能會(huì)被重新分配為IO2和IO3所以硬件上要保證這兩個(gè)引腳不是單純的上下拉而是能參與數(shù)據(jù)傳輸。Quad模式帶來的速度提升明顯但前提是MCU這邊的SPI外設(shè)也支持QuadIO模式STM32有一些系列支持很多國(guó)產(chǎn)MCU則不一定。如果MCU硬件不支持Quad只靠GPIO模擬四線通信收益有限不建議折騰。6.2 配合文件系統(tǒng)使用SPI Flash最常見的拓展還是掛一個(gè)FATFS。切到FATFS之前建議先把讀寫的4KB對(duì)齊問題想清楚。FATFS默認(rèn)按扇區(qū)512字節(jié)讀而Flash的擦除粒度是4KB。如果每個(gè)FAT扇區(qū)都單獨(dú)擦寫不僅效率低還會(huì)加速Flash磨損。解決方案通常是把文件系統(tǒng)扇區(qū)大小設(shè)成4096字節(jié)或者用專用的Flash文件系統(tǒng)。后者我這里先不展開但如果你要在設(shè)備里長(zhǎng)期存數(shù)據(jù)、頻繁改小文件建議認(rèn)真評(píng)估一下磨損均衡和掉電保護(hù)策略不然Flash寫壞是遲早的事。6.3 OTP區(qū)域和唯一IDMX25L系列部分型號(hào)還提供OTP一次性可編程區(qū)域和一些安全特性。OTP區(qū)域可以用來存設(shè)備序列號(hào)、密鑰這類不需要頻繁改寫但需要防止篡改的數(shù)據(jù)。如果你已經(jīng)在用MX25L256且還有空余引腳和資源這塊區(qū)域值得研究直接讀廠商手冊(cè)里的OTP章節(jié)就好。最后再分享一個(gè)我踩過多次坑后總結(jié)的習(xí)慣每次新板子回來調(diào)Flash驅(qū)動(dòng)先跑一個(gè)“寫-讀-比對(duì)”的壓力測(cè)試覆蓋頁(yè)邊界、扇區(qū)邊界、最大地址邊界跑幾輪再進(jìn)業(yè)務(wù)開發(fā)。SPI Flash驅(qū)動(dòng)跑起來容易跑穩(wěn)不容易邊界情況都在測(cè)試?yán)?。這套MX25L128/MX25L256驅(qū)動(dòng)代碼本質(zhì)上只是一個(gè)起點(diǎn)。真正體現(xiàn)功力的是你對(duì)SPI協(xié)議細(xì)節(jié)的把握對(duì)Flash特性差異的敏感以及對(duì)異常場(chǎng)景的處理能力。希望這篇文章能讓你的嵌入式存儲(chǔ)方案少走幾段彎路。本文還有配套的精品資源點(diǎn)擊獲取