access_extended_sram.h

AVR单片机访问大于64K的外部RAM. .

/* 
**************************************************************************************** 
头部文件名：        Access_Extended_SRAM.h 
头部文件名称：      访问空间大于 64 KB 外部扩展随机存取存储器的头部文件 
文件版本：　　      1.0 
文件功能： 
　　　　本文件是对访问空间大于 64 KB 外部扩展随机存取存储器源程序文件的常量、 
　　　　数据结构类型进行定义和函数原型声明的头部文件。 
文件说明： 
　　　　本头部文件不允许用于无扩展并行总线结构的微处理器。 
编译工具软件：      IAR Embedded Workbench for Atmel AVR 版本：4.10 以上 
链接文件：          目标器件芯片的头部文件 

编作者：             
编作者 E-Mail：     [e-mail] 
编制日期：          2005年9月12日 
------------------------------------------------------------------------------ 
头部文件版本历史： 
2005年9月12日 -------- 版本 1.0 ：发行版本 
**************************************************************************************** 
*/ 


/*====================================================================================== 
下面两条指令是本头部文件条件编译的预处理指令，用于防止本头部文件被其他文件重复引用。 
======================================================================================*/ 
#ifndef ACCESS_EXTENDED_SRAM_H        // "ACCESS_EXTENDED_SRAM_H" 条件编译开始 
#define ACCESS_EXTENDED_SRAM_H 


/*====================================================================================== 
　　　　　　　　　　　　　　本头部文件包括的其他头部文件 
======================================================================================*/ 
#include "MCU_C_Macro_Data_Define.h"  // 包含数据类型和常用指令宏定义的头部文件 


/*====================================================================================== 
下面这三条指令是用于区分编译系统为 C++ 或 C 的预处理指令。 
"__cplusplus" 为 C++ 预处理器名字，这三条指令表明接在其下面的那些指令为 C 程序特征。 
======================================================================================*/ 
#ifdef __cplusplus 
extern "C" { 
#endif 


/*====================================================================================== 
使用 Access_Extended_SRAM.c 源程序文件中的函数声明（使用Ｃ或汇编语言编制的函数声明）： 
======================================================================================*/ 
#define USE_ASM_EXTSRAM_BLACK_ACCESS  // 使用汇编语言编制的函数声明 
                                        // 注：屏蔽此即使用Ｃ语言编制的函数 


/*====================================================================================== 
外部扩展随机存取存储器的地址引脚定义： 
注：下列这些定义与硬件设计相关，如需改变地址引脚仅在此重新定义即可。 
======================================================================================*/ 
#define EXTSRAM_ADDR_DDR  DDRD        // 扩展随机存储器的地址高位引脚的数据方向寄存器 
#define EXTSRAM_ADDR_PORT PORTD       // 扩展随机存储器的地址高位引脚的的数据寄存器 


/*====================================================================================== 
声明外部扩展随机存取存储器访问空间大小： 
======================================================================================*/ 
#define EXTSRAM_ADDR_START    0x1100  // 外部扩展随机存取存储器每页的起始地址 
#define EXTSRAM_ADDR_END      0xFFFF  // 外部扩展随机存取存储器每页的终止地址 
#define EXTSRAM_ADDR_H_START  0x80    // 外部扩展随机存取存储器寻址高位的起始地址 
#define EXTSRAM_ADDR_H_END    0xFF    // 外部扩展随机存取存储器寻址高位的终止地址 




/*====================================================================================== 
源程序文件中使用的全局静态变量定义： 
======================================================================================*/ 
/*---------------------------------------------------------------------------- 
定义用于储存外部扩展随机存取存储器访问地址的指针数值变量： 
----------------------------------------------------------------------------*/ 
#if defined(_IAR_EW_AVR_)             // "IAR Embedded Workbench AVR 编译器"条件编译开始 
  #pragma diag_suppress=Pe550           //  禁止编译时产生 Pe550 消息 
#endif                                // "defined(_IAR_EW_AVR_)" 条件编译结束 

static unsigned int es_addr_read_index = EXTSRAM_ADDR_START; 
                       // 读取数据操作访问地址的寻址低位指针数值变量 
static unsigned int es_addr_write_index = EXTSRAM_ADDR_START; 
                       // 写入数据操作访问地址的寻址低位指针数值变量 
static unsigned char es_addr_read_h_index = (EXTSRAM_ADDR_H_START+1); 
                       // 读取数据操作访问地址的寻址高位指针数值变量 
static unsigned char es_addr_write_h_index = (EXTSRAM_ADDR_H_START+1); 
                       // 写入数据操作访问地址的寻址高位指针数值变量 
static unsigned char es_addr_read_h_index_status = 0; 
                       // 读取数据操作访问地址的寻址高位指针状态变量 
static unsigned char es_addr_write_h_index_status = 0; 
                       // 写入数据操作访问地址的寻址高位指针状态变量 

#if defined(_IAR_EW_AVR_)             // "IAR Embedded Workbench AVR 编译器"条件编译开始 
  #pragma diag_default=Pe550            // Pe550 消息复原为默认设置 
#endif                                // "defined(_IAR_EW_AVR_)" 条件编译结束 


/*---------------------------------------------------------------------------- 
定义用于储存上面相应的指针数值变量的ＥＥＰＲＯＭ中的数组变量： 
定义这些数组变量的目的，在于防止掉电时丢失操作地址的指针数值。在上电后重新初始化时， 
将从这些数组变量中恢复操作地址的指针数值。 
----------------------------------------------------------------------------*/ 
eeprom unsigned int es_addr_read_index_eep[1]; 
eeprom unsigned int es_addr_write_index_eep[1]; 
eeprom unsigned char es_addr_read_h_index_eep[1]; 
eeprom unsigned char es_addr_write_h_index_eep[1]; 
eeprom unsigned char es_addr_read_h_index_status_eep[1]; 
eeprom unsigned char es_addr_write_h_index_status_eep[1]; 


/*====================================================================================== 
Access_Extended_SRAM.c 源程序文件中的函数原型声明： 
======================================================================================*/ 
/*---------------------------------------------------------------------------- 
函数功能：    本函数用于本函数用于以块方式访问空间大于 64 KB 外部随机存储器的 
              初始化操作。 
备注：        本函数仅在主函数中调用一次即可。 
----------------------------------------------------------------------------*/ 
void ExtSRAM_Black_initialization(void); 

/*---------------------------------------------------------------------------- 
函数功能：    本函数用于以块方式访问空间大于 64 KB 外部随机存储器的写入数据操作。 
函数入口参数：*first_data_address ------ 写入外部扩展随机存取存储器的首个数据地址指针。 
              data_length -------------- 写入的数据长度。 
全局静态变量：es_addr_write_h_index ---------- 写入数据操作访问地址的寻址低位指针数值变量 
              es_addr_write_index ------------ 写入数据操作访问地址的寻址高位指针数值变量 
              es_addr_write_h_index_status --- 写入数据操作访问地址的寻址高位指针状态变量 
备注：        ▲．本函数用于外部扩展随机存取存储器寻址指针不超过２个字节。 
              ▲．本函数写入的目标存储器空间将循环操作，即到达空间尾部时又返回到起始处， 
                  覆盖以前写入的数据继续执行写入操作。 
----------------------------------------------------------------------------*/ 
void ExtSRAM_Black_Write(unsigned char *first_data_address, 
                         // 写入外部扩展随机存取存储器的首个数据地址指针 
                         unsigned int data_length); 
                         // 写入的数据长度 

/*---------------------------------------------------------------------------- 
函数功能：    本函数用于以块方式访问空间大于 64 KB 外部随机存储器的读取数据操作。 
函数入口参数：*first_data_address ------ 将读取的数据存储到目标的首个地址指针。 
              data_length -------------- 读取的数据长度。 
全局静态变量：es_addr_read_h_index ---------- 读取数据操作访问地址的寻址低位指针数值变量 
              es_addr_read_index ------------ 读取数据操作访问地址的寻址高位指针数值变量 
              es_addr_read_h_index_status --- 读取数据操作访问地址的寻址高位指针状态变量 
备注：        ▲．本函数用于外部扩展随机存取存储器寻址指针不超过２个字节。 
              ▲．本函数读取的源存储器空间将循环操作，即到达空间尾部时又返回到起始处， 
                  继续执行读取数据操作。 
----------------------------------------------------------------------------*/ 
void ExtSRAM_Black_Read(unsigned char *first_data_address, 
                        // 将读取的数据存储到目标的首个地址指针 
                        unsigned int data_length); 
                        // 读取的数据长度 

/*---------------------------------------------------------------------------- 
函数功能：    本函数用于计算从大于 64 KB SRAM 中以固定数据长度访问数据，从 
              读取操作的访问地址到写入操作的访问地址之间所需要的次数值。 
函数入口参数：read_h -------- 读取操作的访问地址高位指针数值。 
              write_h ------- 写入操作的访问地址高位指针数值。 
              read ---------- 读取操作的访问地址低位指针数值。 
              write --------- 写入操作的访问地址低位指针数值。 
              data_size ----- 每次访问操作的地址个数（数据长度）。 
              入口参数还包括这些用于表示存储器特征的静态变量： 
              IN_all_data_start_size -------- 访问地址低位的起始地址指针数值 
              IN_all_data_end_size ---------- 访问地址低位的终止地址指针数值 
              IN_all_data_h_start_size ------ 访问地址高位的起始地址指针数值 
              IN_all_data_h_end_size -------- 访问地址高位的终止地址指针数值 
函数出口参数：所需要的整数次数值（包括余数的次数）。 
              出口参数还包括余数的静态变量： 
              OUT_data_size_remainder ------- 最后一次访问操作的地址个数（余数） 
备注：        ▲．函数出口参数为了其他函数的判断方便，预留次数值＝０，给其他 
                  函数使用。返回的函数出口参数＝实际次数值（包括余数的次数）＋１。 
                  在其他函数中，当次数值为１时，访问操作已全部完成；当次数值 
                  为２时，即执行访问余数操作。 
              ▲．本函数实际包括９个入口参数和２个出口参数。 
----------------------------------------------------------------------------*/ 
unsigned int EXTSRAM_Data_Access_Times(unsigned char read_h, 
                                       // 读取操作的访问地址高位指针数值 
                                       unsigned char write_h, 
                                       // 写入操作的访问地址高位指针数值 
                                       unsigned int read, 
                                       // 读取操作的访问地址低位指针数值 
                                       unsigned int write, 
                                       // 写入操作的访问地址低位指针数值 
                                       const unsigned char data_size); 
                                       // 每次访问操作的地址个数（数据长度） 


/*====================================================================================== 
下面这三条指令是用于与上面三条区分编译系统为 C++ 或 C 的预处理指令相对应。用于指定 
 extern "C" 链接指示符作用域，此处的"}"与上面的"{"相对应，为链接指示符作用结束符。 
======================================================================================*/ 
#ifdef __cplusplus 
} 
#endif 



#endif                                // "ACCESS_EXTENDED_SRAM_H" 条件编译结束 



/* 
**************************************************************************************** 
                             本头部文件到此结束 
**************************************************************************************** 
*/