A32 STM32_HAL库函数 之 NOR 通用驱动 -- A -- 所有函数的介绍及使用

1 该驱动函数预览

序号	函数名	描述
1	HAL_NOR_Init()	初始化NOR闪存设备。
2	HAL_NOR_DeInit()	反初始化NOR闪存设备。
3	HAL_NOR_MspInit()	初始化MCU外设相关的NOR引脚或资源。
4	HAL_NOR_MspDeInit()	反初始化MCU外设相关的NOR引脚或资源。
5	HAL_NOR_MspWait()	为NOR闪存设备的操作进行等待。
6	HAL_NOR_Read_ID()	读取NOR闪存设备的ID。
7	HAL_NOR_ReturnToReadMode()	将NOR闪存设备返回到读取模式。
8	HAL_NOR_Read()	从NOR闪存设备中读取数据。
9	HAL_NOR_Program()	向NOR闪存设备中编程数据。
10	HAL_NOR_ReadBuffer()	从NOR闪存设备中读取数据缓冲区。
11	HAL_NOR_ProgramBuffer()	向NOR闪存设备中编程数据缓冲区。
12	HAL_NOR_Erase_Block()	擦除NOR闪存设备的块。
13	HAL_NOR_Erase_Chip()	擦除NOR闪存设备的整个芯片。
14	HAL_NOR_Read_CFI()	从NOR闪存设备中读取CFI（通用闪存接口）信息。
15	HAL_NOR_WriteOperation_Enable()	启用NOR闪存设备的写操作。
16	HAL_NOR_WriteOperation_Disable()	禁用NOR闪存设备的写操作。
17	HAL_NOR_GetState()	获取NOR闪存设备的状态。
18	HAL_NOR_GetStatus()	获取NOR闪存设备的状态寄存器的值。

以下是使用模板：

#include "stm32f4xx_hal.h"

int main(void) {
    // HAL初始化
    HAL_Init();
    
    // 初始化MCU外设相关的NOR引脚或资源
    HAL_NOR_MspInit();
    
    // 初始化NOR闪存设备
    HAL_NOR_Init();
    
    // 进行其他操作...
    
    // 读取NOR闪存设备的ID
    HAL_NOR_Read_ID();
    
    // 读取NOR闪存设备的状态
    HAL_NOR_GetStatus();
    
    // 反初始化NOR闪存设备
    HAL_NOR_DeInit();
    
    // 反初始化MCU外设相关的NOR引脚或资源
    HAL_NOR_MspDeInit();
    
    return 0;
}

1.1 HAL_NOR_Init

函数名	HAL_NOR_Init
函数原形	HAL_StatusTypeDef HAL_NOR_Init(NOR_HandleTypeDef *hnor)
功能描述	初始化 NOR Flash
输入参数	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.2 HAL_NOR_DeInit

函数名	HAL_NOR_DeInit
函数原形	HAL_StatusTypeDef HAL_NOR_DeInit(NOR_HandleTypeDef *hnor)
功能描述	反初始化 NOR Flash
输入参数	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.3 HAL_NOR_MspInit

函数名	HAL_NOR_MspInit
函数原形	void HAL_NOR_MspInit(NOR_HandleTypeDef *hnor)
功能描述	初始化 NOR Flash 外设时的低层硬件资源
输入参数	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.4 HAL_NOR_MspDeInit

函数名	HAL_NOR_MspDeInit
函数原形	void HAL_NOR_MspDeInit(NOR_HandleTypeDef *hnor)
功能描述	反初始化 NOR Flash 外设时的低层硬件资源
输入参数	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.5 HAL_NOR_MspWait

函数名	HAL_NOR_MspWait
函数原形	void HAL_NOR_MspWait(NOR_HandleTypeDef *hnor, uint32_t Timeout)
功能描述	等待 NOR Flash 状态为就绪
输入参数 1	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输入参数 2	Timeout：超时时间（单位：毫秒）
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.6 HAL_NOR_Read_ID

函数名	HAL_NOR_Read_ID
函数原形	HAL_StatusTypeDef HAL_NOR_Read_ID(NOR_HandleTypeDef *hnor, uint16_t *pNOR_ID)
功能描述	读取 NOR Flash 的 ID
输入参数 1	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输入参数 2	pNOR_ID：存储读取到的 NOR Flash ID 的缓冲区
输出参数	pNOR_ID：存储读取到的 NOR Flash ID 的缓冲区
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.7 HAL_NOR_ReturnToReadMode

函数名	HAL_NOR_ReturnToReadMode
函数原形	HAL_StatusTypeDef HAL_NOR_ReturnToReadMode(NOR_HandleTypeDef *hnor)
功能描述	将 NOR Flash 返回到读取模式
输入参数	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.8 HAL_NOR_Read

函数名	HAL_NOR_Read
函数原形	HAL_StatusTypeDef HAL_NOR_Read(NOR_HandleTypeDef *hnor, uint32_t Address, uint16_t *pData, uint32_t BufferSize)
功能描述	从 NOR Flash 中读取数据
输入参数 1	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输入参数 2	Address：读取数据的起始地址
输入参数 3	pData：存储读取数据的缓冲区
输入参数 4	BufferSize：要读取的数据字节数
输出参数	pData：存储读取数据的缓冲区
返回值	HAL

_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |

---

1.9 HAL_NOR_Program

函数名	HAL_NOR_Program
函数原形	HAL_StatusTypeDef HAL_NOR_Program(NOR_HandleTypeDef *hnor, uint32_t Address, uint16_t Data)
功能描述	向 NOR Flash 编程一个半字（16 位）数据
输入参数 1	hnor：NOR 句柄，指向一个 NOR_HandleTypeDef 结构体
输入参数 2	Address：编程数据的目标地址
输入参数 3	Data：要编程的数据
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

该文档修改记录：

修改时间	修改说明
2024年4月30日	第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。