access_extended_sram.h

本程序是用于访问空间大于 64 KB （即：地址指针数大于两个字节）外部扩展随机存取存储器的源程序文件。

/*--------------------------------------------------------------------------------------
函数［EXTSRAM_Data_Access_Times］的入口参数和出口参数的静态变量定义：
--------------------------------------------------------------------------------------*/
#if defined(_IAR_EW_AVR_)                     // "IAR Embedded Workbench AVR " 条件编译开始
#pragma diag_suppress=Pe550                   //  禁止编译时产生 Pe550 消息
#endif                                        // "defined(_IAR_EW_AVR_)" 条件编译结束
static unsigned int IN_all_data_start_size;   // 访问地址低位的起始地址指针数值
static unsigned int IN_all_data_end_size;     // 访问地址低位的终止地址指针数值
static unsigned char IN_all_data_h_start_size;// 访问地址高位的起始地址指针数值
static unsigned char IN_all_data_h_end_size;  // 访问地址高位的终止地址指针数值
static unsigned char OUT_data_size_remainder; // 最后一次访问操作的地址个数（余数）
#if defined(_IAR_EW_AVR_)                     // "IAR Embedded Workbench AVR " 条件编译开始
#pragma diag_default=Pe550                    // Pe550 消息复原为默认设置
#endif                                        // "defined(_IAR_EW_AVR_)" 条件编译结束

/*==========================================================================================
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" 条件编译结束



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