am_is25xx_handle_t is25xx_handle = am_microport_flash_is25xx_inst_init(void);

SPI Flash比較特殊，在寫(xiě)入數(shù)據(jù)之前必須確保相應(yīng)的地址單元已經(jīng)被擦除，因此除了讀、寫(xiě)函數(shù)外，還有一個(gè)擦除函數(shù)。IS25功能接口函數(shù)如圖2所示。

圖2  IS25xx功能接口函數(shù)

1.擦除

擦除就是將數(shù)據(jù)全部重置為0xFF，即所有存儲(chǔ)單元的位設(shè)置為1。擦除操作不能直接擦除某個(gè)單一地址單元，擦除的最小單元是扇區(qū)，IS25一個(gè)扇區(qū)大小為4KB，即每次只能擦除單個(gè)或多個(gè)扇區(qū)。擦除函數(shù)原型為：

int am_is25xx_erase(am_is25xx_handle_t handle, uint32_t addr, uint32_t len);

其中，handle為IS25xx的實(shí)例句柄，addr為待擦除區(qū)域的首地址，由于擦除的最小單元為扇區(qū)，因此該地址必須為某個(gè)扇區(qū)的起始地址，len為擦除長(zhǎng)度，必須為扇區(qū)大小的整數(shù)倍。返回AM_OK，說(shuō)明擦除成功；

2.寫(xiě)入數(shù)據(jù)

在寫(xiě)入數(shù)據(jù)前，必須確保寫(xiě)入地址已被擦除。即需要變?yōu)?的位清0，寫(xiě)入操作無(wú)法將0變?yōu)?。從指定的起始地址開(kāi)始寫(xiě)入一段數(shù)據(jù)的函數(shù)原型為：

int am_is25xx_write(am_is25xx_handle_t handle, uint32_t addr, uint8_t *p_buf, uint32_t len);

其中，addr為待寫(xiě)入?yún)^(qū)域的首地址，只要確保addr之后的區(qū)域已經(jīng)經(jīng)過(guò)擦除，則可以從該芯片中任一存儲(chǔ)地址開(kāi)始寫(xiě)入，len為寫(xiě)入數(shù)據(jù)長(zhǎng)度。返回AM_OK，說(shuō)明寫(xiě)入數(shù)據(jù)成功；

3.讀取數(shù)據(jù)

從指定的起始地址開(kāi)始讀取一段數(shù)據(jù)的函數(shù)原型為：

int am_is25xx_read(am_is25xx_handle_t handle, uint32_t addr, uint8_t *p_buf, uint32_t len);

其中，addr為待讀取區(qū)域的首地址，可以指定該芯片中任一存儲(chǔ)地址開(kāi)始讀取，len為讀取數(shù)據(jù)長(zhǎng)度。返回AM_OK，說(shuō)明讀取數(shù)據(jù)成功。

由于讀、寫(xiě)數(shù)據(jù)需要的緩存空間較大，最好從全局?jǐn)?shù)據(jù)區(qū)域中分配緩存。如果直接從函數(shù)的運(yùn)行棧中分配較大字節(jié)空間，則完全有可能導(dǎo)致棧溢出，進(jìn)而系統(tǒng)崩潰。

AMetal平臺(tái)提供了較全面的功能接口函數(shù)，所有接口函數(shù)均脫離底層，不與具體硬件綁定，切換MCU可快速移植。AMetal助你快速實(shí)現(xiàn)SPI Flash功能，將專(zhuān)注力投入到核心應(yīng)用部分，讓具有競(jìng)爭(zhēng)力的產(chǎn)品更快走向市場(chǎng)！