A31 STM32_HAL库函数 之 NAND通用驱动 -- B -- 所有函数的介绍及使用
1 该驱动函数预览
序号 | 函数名 | 描述 |
---|
1 | HAL_NAND_Init() | 初始化NAND闪存设备。 |
2 | HAL_NAND_DeInit() | 反初始化NAND闪存设备。 |
3 | HAL_NAND_MspInit() | 初始化MCU外设相关的NAND引脚或资源。 |
4 | HAL_NAND_MspDeInit() | 反初始化MCU外设相关的NAND引脚或资源。 |
5 | HAL_NAND_IRQHandler() | NAND闪存中断处理程序。 |
6 | HAL_NAND_ITCallback() | NAND闪存中断回调函数。 |
7 | HAL_NAND_ConfigDevice() | 配置NAND闪存设备。 |
8 | HAL_NAND_Read_ID() | 读取NAND闪存设备的ID。 |
9 | HAL_NAND_Reset() | 复位NAND闪存设备。 |
10 | HAL_NAND_Read_Page_8b() | 从NAND闪存设备中读取8位数据页。 |
11 | HAL_NAND_Read_Page_16b() | 从NAND闪存设备中读取16位数据页。 |
12 | HAL_NAND_Write_Page_8b() | 向NAND闪存设备中写入8位数据页。 |
13 | HAL_NAND_Write_Page_16b() | 向NAND闪存设备中写入16位数据页。 |
14 | HAL_NAND_Read_SpareArea_8b() | 从NAND闪存设备中读取8位备用区。 |
15 | HAL_NAND_Read_SpareArea_16b() | 从NAND闪存设备中读取16位备用区。 |
16 | HAL_NAND_Write_SpareArea_8b() | 向NAND闪存设备中写入8位备用区。 |
17 | HAL_NAND_Write_SpareArea_16b() | 向NAND闪存设备中写入16位备用区。 |
18 | HAL_NAND_Erase_Block() | 擦除NAND闪存设备的块。 |
19 | HAL_NAND_Read_Status() | 读取NAND闪存设备的状态。 |
20 | HAL_NAND_Address_Inc() | NAND闪存地址自增函数。 |
21 | HAL_NAND_ECC_Enable() | 启用NAND闪存设备的ECC(错误校验和纠正)。 |
22 | HAL_NAND_ECC_Disable() | 禁用NAND闪存设备的ECC。 |
23 | HAL_NAND_GetECC() | 获取NAND闪存设备的ECC信息。 |
24 | HAL_NAND_GetState() | 获取NAND闪存设备的状态。 |
25 | HAL_NAND_Read_Status() | 读取 NAND Flash 的状态寄存器 |
以下是使用模板:
#include "stm32f4xx_hal.h"
int main(void) {
HAL_Init();
HAL_NAND_MspInit();
HAL_NAND_Init();
HAL_NAND_ConfigDevice();
HAL_NAND_Read_ID();
HAL_NAND_Read_Status();
HAL_NAND_DeInit();
HAL_NAND_MspDeInit();
return 0;
}
1.13 HAL_NAND_Write_Page_16b
函数名 | HAL_NAND_Write_Page_16b |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Write_Page_16b(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress, uint16_t *pData, uint32_t Size) |
功能描述 | 以 16 位模式写入数据到 NAND Flash 的一页 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输入参数 3 | pData:要写入的数据缓冲区 |
输入参数 4 | Size:要写入的数据字节数 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.14 HAL_NAND_Read_SpareArea_8b
函数名 | HAL_NAND_Read_SpareArea_8b |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Read_SpareArea_8b(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress, uint8_t *pData, uint32_t Size) |
功能描述 | 以 8 位模式读取 NAND Flash 中的页的备用区数据 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输入参数 3 | pData:存储读取数据的缓冲区 |
输入参数 4 | Size:要读取的数据字节数 |
输出参数 | pData:存储读取数据的缓冲区 |
返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.15 HAL_NAND_Read_SpareArea_16b
函数名 | HAL_NAND_Read_SpareArea_16b |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Read_SpareArea_16b(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress, uint16_t *pData, uint32_t Size) |
功能描述 | 以 16 位模式读取 NAND Flash 中的页的备用区数据 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输入参数 3 | pData: |
存储读取数据的缓冲区 |
| 输入参数 4 | Size:要读取的数据字节数 |
| 输出参数 | pData:存储读取数据的缓冲区 |
| 返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |
1.16 HAL_NAND_Write_SpareArea_8b
函数名 | HAL_NAND_Write_SpareArea_8b |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Write_SpareArea_8b(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress, uint8_t *pData, uint32_t Size) |
功能描述 | 以 8 位模式写入数据到 NAND Flash 的页的备用区 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输入参数 3 | pData:要写入的数据缓冲区 |
输入参数 4 | Size:要写入的数据字节数 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.17 HAL_NAND_Write_SpareArea_16b
函数名 | HAL_NAND_Write_SpareArea_16b |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Write_SpareArea_16b(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress, uint16_t *pData, uint32_t Size) |
功能描述 | 以 16 位模式写入数据到 NAND Flash 的页的备用区 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输入参数 3 | pData:要写入的数据缓冲区 |
输入参数 4 | Size:要写入的数据字节数 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.18 HAL_NAND_Erase_Block
函数名 | HAL_NAND_Erase_Block |
---|
函数原形 | HAL_StatusTypeDef HAL_NAND_Erase_Block(NAND_HandleTypeDef *hnand, NAND_AddressTypeDef *pAddress) |
功能描述 | 擦除 NAND Flash 中的一个块 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.19 HAL_NAND_Read_Status
函数名 | HAL_NAND_Read_Status |
---|
函数原形 | uint32_t HAL_NAND_Read_Status(NAND_HandleTypeDef *hnand, uint32_t Timeout) |
功能描述 | 读取 NAND Flash 的状态寄存器 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | uint32_t:NAND Flash 的状态寄存器的值 |
先决条件 | 无 |
被调用函数 | 无 |
1.20 HAL_NAND_Address_Inc
函数名 | HAL_NAND_Address_Inc |
---|
函数原形 | void HAL_NAND_Address_Inc(NAND_AddressTypeDef *pAddress) |
功能描述 | 自动增加 NAND Flash 地址指针 |
输入参数 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
输出参数 | pAddress:NAND Flash 内的地址,指向一个 NAND_AddressTypeDef 结构体 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.21 HAL_NAND_ECC_Enable
函数名 | HAL_NAND_ECC_Enable |
---|
函数原形 | void HAL_NAND_ECC_Enable(NAND_HandleTypeDef *hnand) |
功能描述 | 启用 NAND Flash 的硬件 ECC |
输入参数 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.22 HAL_NAND_ECC_Disable
函数名 | HAL_NAND_ECC_Disable |
---|
函数原形 | void HAL_NAND_ECC_Disable(NAND_HandleTypeDef *hnand) |
功能描述 | 禁用 NAND Flash 的硬件 ECC |
输入参数 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.23 HAL_NAND_GetECC
函数名 | HAL_NAND_GetECC |
---|
函数原形 | uint32_t HAL_NAND_GetECC(NAND_HandleTypeDef *hnand, uint32_t Timeout) |
功能描述 | 读取 NAND Flash 的 ECC |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | uint32_t:ECC 值 |
先决条件 | 无 |
被调用函数 | 无 |
1.24 HAL_NAND_GetState
函数名 | HAL_NAND_GetState |
---|
函数原形 | HAL_NAND_StateTypeDef HAL_NAND_GetState(NAND_HandleTypeDef *hnand) |
功能描述 | 获取 NAND Flash 的状态 |
输入参数 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_NAND_StateTypeDef:NAND Flash 的状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.25 HAL_NAND_Read_Status
函数名 | HAL_NAND_Read_Status |
---|
函数原形 | uint32_t HAL_NAND_Read_Status(NAND_HandleTypeDef *hnand, uint32_t Timeout) |
功能描述 | 读取 NAND Flash 的状态寄存器 |
输入参数 1 | hnand:NAND 句柄,指向一个 NAND_HandleTypeDef 结构体 |
输入参数 2 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | uint32_t:NAND Flash 的状态寄存器的值 |
先决条件 | 无 |
被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|
2024年4月30日 | 第一次发布,介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。