Add qemu 2.4.0
[kvmfornfv.git] / qemu / roms / u-boot / doc / README.m68k
diff --git a/qemu/roms/u-boot/doc/README.m68k b/qemu/roms/u-boot/doc/README.m68k
new file mode 100644 (file)
index 0000000..c85febc
--- /dev/null
@@ -0,0 +1,166 @@
+
+U-Boot for Motorola M68K
+
+====================================================================
+History
+
+August 08,2005;                Jens Scharsig <esw@bus-elektronik.de>
+                       MCF5282 implementation without preloader
+January 12, 2004;      <josef.baumgartner@telex.de>
+====================================================================
+
+This file contains status information for the port of U-Boot to the
+Motorola M68K series of CPUs.
+
+1. OVERVIEW
+-----------
+Bernhard Kuhn ported U-Boot 0.4.0 to the Motorola Coldfire
+architecture. The patches of Bernhard support the MCF5272 and
+MCF5282. A great disadvantage of these patches was that they needed
+a pre-bootloader to start u-boot. Because of this, a new port was
+created which no longer needs a first stage booter.
+
+Although this port is intended to cover all M68k processors, only
+the parts for the Motorola Coldfire MCF5272 and MCF5282 are
+implemented at the moment. Additional CPUs and boards will be
+hopefully added soon!
+
+
+2. SUPPORTED CPUs
+-----------------
+
+2.1 Motorola Coldfire MCF5272
+-----------------------------
+CPU specific code is located in: arch/m68k/cpu/mcf52x2
+
+
+2.1 Motorola Coldfire MCF5282
+-----------------------------
+CPU specific code is located in: arch/m68k/cpu/mcf52x2
+
+The MCF5282 Port no longer needs a preloader and can place in external or
+internal FLASH.
+
+
+3. SUPPORTED BOARDs
+-------------------
+
+3.1 Motorola M5272C3 EVB
+------------------------
+Board specific code is located in: board/m5272c3
+
+To configure the board, type: make M5272C3_config
+
+U-Boot Memory Map:
+------------------
+0xffe00000 - 0xffe3ffff                u-boot
+0xffe04000 - 0xffe05fff                environment (embedded in u-boot!)
+0xffe40000 - 0xffffffff                free for linux/applications
+
+
+3.2 Motorola M5282 EVB
+------------------------
+Board specific code is located in: board/m5282evb
+
+To configure the board, type: make M5272C3_config
+
+At the moment the code isn't fully implemented and still needs a pre-loader!
+The preloader must initialize the processor and then start u-boot. The board
+must be configured for a pre-loader (see 4.1)
+
+For the preloader, please see
+http://mailman.uclinux.org/pipermail/uclinux-dev/2003-December/023384.html
+
+U-boot is configured to run at 0x20000 at default. This can be configured by
+change CONFIG_SYS_TEXT_BASE in board/m5282evb/config.mk and CONFIG_SYS_MONITOR_BASE in
+include/configs/M5282EVB.h.
+
+3.2 BuS EB+MCF-EV123
+---------------------
+
+Board specific code is located in: board/bus/EB+MCF-EV123
+
+To configure the board, type:
+
+make EB+MCF-EV123_config               for external FLASH
+make EB+MCF-EV123_internal_config      for internal FLASH
+
+
+4. CONFIGURATION OPTIONS/SETTINGS
+----------------------------------
+
+4.1 Configuration to use a pre-loader
+-------------------------------------
+If u-boot should be loaded to RAM and started by a pre-loader
+CONFIG_MONITOR_IS_IN_RAM must be defined. If it is defined the
+initial vector table and basic processor initialization will not
+be compiled in. The start address of u-boot must be adjusted in
+the boards config header file (CONFIG_SYS_MONITOR_BASE) and Makefile
+(CONFIG_SYS_TEXT_BASE) to the load address.
+
+4.1 MCF5272 specific Options/Settings
+-------------------------------------
+
+CONFIG_MCF52x2 -- defined for all MCF52x2 CPUs
+CONFIG_M5272   -- defined for all Motorola MCF5272 CPUs
+
+CONFIG_MONITOR_IS_IN_RAM
+               -- defined if u-boot is loaded by a pre-loader
+
+CONFIG_SYS_MBAR        -- defines the base address of the MCF5272 configuration registers
+CONFIG_SYS_INIT_RAM_ADDR
+               -- defines the base address of the MCF5272 internal SRAM
+CONFIG_SYS_ENET_BD_BASE
+               -- defines the base address of the FEC buffer descriptors
+
+CONFIG_SYS_SCR         -- defines the contents of the System Configuration Register
+CONFIG_SYS_SPR         -- defines the contents of the System Protection Register
+CONFIG_SYS_BRx_PRELIM  -- defines the contents of the Chip Select Base Registers
+CONFIG_SYS_ORx_PRELIM  -- defines the contents of the Chip Select Option Registers
+
+CONFIG_SYS_PxDDR       -- defines the contents of the Data Direction Registers
+CONFIG_SYS_PxDAT       -- defines the contents of the Data Registers
+CONFIG_SYS_PXCNT       -- defines the contents of the Port Configuration Registers
+
+
+4.2 MCF5282 specific Options/Settings
+-------------------------------------
+
+CONFIG_MCF52x2 -- defined for all MCF52x2 CPUs
+CONFIG_M5282   -- defined for all Motorola MCF5282 CPUs
+
+CONFIG_MONITOR_IS_IN_RAM
+               -- defined if u-boot is loaded by a pre-loader
+
+CONFIG_SYS_MBAR        -- defines the base address of the MCF5282 internal register space
+CONFIG_SYS_INIT_RAM_ADDR
+               -- defines the base address of the MCF5282 internal SRAM
+CONFIG_SYS_INT_FLASH_BASE
+               -- defines the base address of the MCF5282 internal Flash memory
+CONFIG_SYS_ENET_BD_BASE
+               -- defines the base address of the FEC buffer descriptors
+
+CONFIG_SYS_MFD
+               -- defines the PLL Multiplication Factor Devider
+                  (see table 9-4 of MCF user manual)
+CONFIG_SYS_RFD         -- defines the PLL Reduce Frecuency Devider
+                  (see table 9-4 of MCF user manual)
+
+CONFIG_SYS_CSx_BASE    -- defines the base address of chip select x
+CONFIG_SYS_CSx_SIZE    -- defines the memory size (address range) of chip select x
+CONFIG_SYS_CSx_WIDTH   -- defines the bus with of chip select x
+CONFIG_SYS_CSx_RO      -- if set to 0 chip select x is read/wirte
+                       else chipselct is read only
+CONFIG_SYS_CSx_WS      -- defines the number of wait states  of chip select x
+
+CONFIG_SYS_PxDDR       -- defines the contents of the Data Direction Registers
+CONFIG_SYS_PxDAT       -- defines the contents of the Data Registers
+CONFIG_SYS_PXCNT       -- defines the contents of the Port Configuration Registers
+
+CONFIG_SYS_PxPAR       -- defines the function of ports
+
+
+5. COMPILER
+-----------
+To create U-Boot the gcc-2.95.3 compiler set (m68k-elf-20030314) from uClinux.org was used.
+You can download it from: http://www.uclinux.org/pub/uClinux/m68k-elf-tools/