﻿/*!
 * @file        readme.txt
 *
 * @brief       This file is routine instruction
 *
 * @version     V1.0.0
 *
 * @date        2023-03-25
 *
 * @attention
 *
 *  Copyright (C) 2023 Geehy Semiconductor
 *
 *  You may not use this file except in compliance with the
 *  GEEHY COPYRIGHT NOTICE (GEEHY SOFTWARE PACKAGE LICENSE).
 *
 *  The program is only for reference, which is distributed in the hope
 *  that it will be useful and instructional for customers to develop
 *  their software. Unless required by applicable law or agreed to in
 *  writing, the program is distributed on an "AS IS" BASIS, WITHOUT
 *  ANY WARRANTY OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the GEEHY SOFTWARE PACKAGE LICENSE for the governing permissions
 *  and limitations under the License.
 */


&par Example Description

This example provides a basic example of how to use the EMMC firmware library and
an associate driver to perform erase/read/write operations on the M29W128FL,
M29W128GL or S29GL128P NOR memories.

Connect:
  - NAND CLK(PD3)      ----->     NAND_CLK
  - NAND NL(PB7)      ----->     NAND_NL
  - NAND DATA0(PD14)   ----->     NAND_DATA0
  - NAND DATA1(PD15)   ----->     NAND_DATA1
  - NAND DATA2(PD0)    ----->     NAND_DATA2
  - NAND DATA3(PD1)    ----->     NAND_DATD3
  - NAND DATA4(PE7)    ----->     NAND_DATA4
  - NAND DATA5(PE8)    ----->     NAND_DATA5
  - NAND DATA6(PE9)    ----->     NAND_DATA6
  - NAND DATA7(PE10)   ----->     NAND_DATA7
  - NAND DATA8(PE11)   ----->     NAND_DATA8
  - NAND DATA9(PE12)   ----->     NAND_DATA9
  - NAND DATA10(PE13)  ----->     NAND_DATA10
  - NAND DATA11(PE14)  ----->     NAND_DATA11
  - NAND DATA12(PE15)  ----->     NAND_DATA12
  - NAND DATA13(PD8)   ----->     NAND_DATA13
  - NAND DATA14(PD9)   ----->     NAND_DATA14
  - NAND DATA15(PD10)  ----->     NAND_DATA15
  - NAND ADDR16(PD11)  ----->     NAND_ADDR16
  - NAND ADDR17(PD12)  ----->     NAND_ADDR17
  - NAND ADDR18(PD13)  ----->     NAND_ADDR18
  - NAND ADDR19(PE3)   ----->     NAND_ADDR19
  - NAND ADDR20(PE4)   ----->     NAND_ADDR20
  - NAND ADDR21(PE5)   ----->     NAND_ADDR21
  - NAND ADDR22(PE6)   ----->     NAND_ADDR22
  - NAND ADDR23(PE2)   ----->     NAND_ADDR23
  - NAND NWAIT(PD6)    ----->     NAND_NWAIT
  - NAND NOE(PD4)      ----->     NAND_NOE
  - NAND NWE(PD5)      ----->     NAND_NWE
  - NAND NE1(PD7)      ----->     NAND_NE1
  - NAND_NBL0(PE0)     ----->     NAND_NBL0
  - NAND_NBL1(PE1)     ----->     NAND_NBL1

&par Directory contents

  - FMC/DMC_NOR/src/apm32a10x_int.c     Interrupt handlers
  - FMC/DMC_NOR/src/main.c                     Main program

&par IDE environment

  - MDK-ARM V5.36
  - EWARM V8.50.5.26295
  - ECLIPSE V4.27

&par Hardware and Software environment

  - This example runs on APM32A103_MINI Devices.