david 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
..
pages 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
pics 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
schematics 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
Makefile 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
arm_info_also_in_pages_arm.txt 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
manual.pdf 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
manual.tex 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten
readme_arm7.txt 3e4abc9b01 o add fat filesystem test for arm lpc2148 15 vuotta sitten

readme_arm7.txt

*
* efsl SD-Card SPI-Interface for
* - Philips LPC2000 ARM7TDMI-S
* - Atmel AT91SAM7S ARM7TDMI
*
* The LPC2000 and AT91SAM7 interfaces are
* Copyright (c) 2005, 2006
* by Martin Thomas, Kaiserslautern, Germany
*
* http://www.siwawi.arubi.uni-kl.de/avr_projects
*

All interfaces inherit the license from the
main efsl-source.

-------------------------------------------------

Changelog:

20060910 mthomas
* bug-fix in AT91SAM7-interface (for CS with GPIO during init)
* variable Chip-Select in AT91SAM7-interface
* applied more patches, sync with efsl 0.2.8
(just one instruction)
* modified AT91SAM7 example

20060531 mthomas
* applied patches found in the efsl sf.net project-pages.
The patches are marked with #warning in the source since
they are not part of the "official" efsl source-code

-------------------------------------------------

Common "ARM7" Interface Information:

- A GNU arm-elf toolchain/cross-compiler
must be available to build the examples
and the library.
Ready-made toolchains: i.e. WinARM or
GNUARM
Other ARM-compilers may work too but
have not been tested.

- #define BYTE_ALIGNMENT is disabled
for the ARM-interfaces in config*.h
It didn't work with alignment enabled.

- The hardware connection is similar
to the connection described
in the efsl-manual for Atmel AVRs.
Pullup-Resistors should be optional.
Tests did work without pullups.

-------------------------------------------------

For each interface an example application
is provided in the examples-directory. The
examples can be build with the library
libefsl.a or with the efsl source-code.

(1) To use the efsl-source "directly"

- Verfiy that conf/config.h is present
and the settings match the used
interfaces (see templates).
- Modify the line in the example's
Makefile to: EFSL_AS_LIB = 0
- "make all" in the example's directory.

(2) To use the efsl-library (libefsl.a)

- Verfiy that conf/config.h is present
and the settings match the used
interfaces (see templates).
- Build the library libefsl.a with
the Makefile from the efsl root-
directory for the used interface.
(i.e. "make --makefile=Makefile-AT91 lib"
or "make --makefile=Makefile-LPC2000 lib" )
- Modify the line in the example's
Makefile to: EFSL_AS_LIB = 1
- "make all" in the example's directory


The example-applications demonstrate:

- Init of the efsl ARM debug-system
- Init of the efsl
- List contents of the SD-Card's
root directory
- Open a file and type the content
- Append a line of text to a file
- "cat/type" the file's content again

The applications print status- and
debug-messages to the UART1 on
LPC2000 or DBGU on AT91SAM7
(115200,8,N,1,no FC).

-------------------------------------------------

Additional Information for the LPC2000 Interface

- The efsl-interface supports SD-Cards
connected to the LPC2000 SPI ("SPI0")
and SSP ("SPI1") interface. The used
SPI-interface is hardcoded by the value
defined in config.h and can not be
changed during runtime.

- Only some parts of the LPC2000-family
have the fast SSP-Interface (i.e. LPC213x,
LPC214x) others only provide the slower
SPI interface.

- To build the library create the file
conf/config.h based on the template
config-sample-lpc2000.h and use the
makefile Makefile-LPC2000 in the
efsl-root-directory for LPC2000s
(ARM7TDMI-S).

- I have tested the interface with a
LPC2138-controller and the SPI(0)
and SSP/SPI1-Interface. Other
LPC2000-ARM7 controllers should be
supported too. (I have got positive
feedback from LPC2148-users).
Verify that the register-adresses in
inc/interfaces/LPC2000_regs.h
match the used controller and the
maximum speed defined in lpc2000_spi.c
is available for the part. Verify the
pin-connections in lpc2000_spi.c.
Adjust the memory-setting in the linker-script.

- LPC2000 TODO: 16bit, FIFO (patches available at sf.net)

-------------------------------------------------

Additional Information for the AT91 Interface

- The interface supports SD-Cards connected
to the AT91SAM7 SPI interface.

- To build the library create a file
conf/config.h based on the template
config-sample-at91.h and use the
makefile Makefile-AT91 in the
efsl-root-directory for AT91 (ARM7TDMI).

- The AT91SAM7 offers 4 chip-select
signals which can be mapped to
different pins. Chip-select is done
by the hardware. See at91_spi.c
for configuration options.
Chip-Select can be fixed or variable
(Fixed or variable peripheral select - see
option in AT91_spi.c, further information
in the datasheet).

- I have tested the interface with AT91SAM7S256
and SAM7S64 controllers. Other AT91-ARM7 controllers
should be supported too.
To adapt the code for another AT91 with SPI:
- check if the register-defintions in AT91SAM7S_regs.h
are valid for the target. The file can be replaced
by header file provided by Atmel for the used part
(see at91.com)
- verify the maximum speed in at91_spi.c
- verfiy the pin-connections in at91_spi.c
- Check the memory-settings in the linker-script of
the example.

- AT91 TODO: PDC/"DMA", 16bit-transfer, SSC-support,

-------------------------------------------------

Test Hard- and Software:

- Keil (keil.com) MCB2130 board with LPC2138
with additional SD/MMC-connector (from Buerklin.de)
- Atmel AT91SAM7S-EK board with AT91SAM7S64
with additional SD/MMC-connector
- SAM7-P board with AT91SAM7S256
with on-board SD/MMC-connector

- SanDisk "standard" SD-Card 256MB
(not the "highspeed"-version)

- WinARM (arm-elf GNU toolchain)
- Bray++ Terminal

WinARM is available at:
http://www.siwawi.arubi.uni-kl.de/avr_projects/arm_projects

-------------------------------------------------

Credits:

- The code in efsl_debug_printf_arm.c is based
on code from Holger Klabunde and has been
modified to support a "fdevopen"-function
(efsl_debug_devopen_arm).
The original code has no copyright-notice and
is derived from an free code by Volker Oth.

- Register-definitions for LPC213x are
based on a header-file from Keil GmbH
(supplied with the DKARM trial-version).

- Register-definitions for AT91SAM7 are from
at91.com (provided by Atmel).

- The basic method to handle the SPI interface
on AT91 has been found in a free example from
Olimex.com.

-------------------------------------------------


I hope the ARM-interfaces are useful for you.
Martin Thomas 9/2006