source: rtems/c/src/lib/libbsp/arm/atsam/README @ f2e0f8e

5
Last change on this file since f2e0f8e was f2e0f8e, checked in by Sebastian Huber <sebastian.huber@…>, on 01/14/16 at 15:03:51

bsp/atsam: New

Close #2529.

  • Property mode set to 100644
File size: 2.4 KB
RevLine 
[f2e0f8e]1Board support package for the Atmel SAM V71/V70/E70/S70 chip platform.
2
3The BSP is customized to a particular board/chip variant by means of configure
4command line options.
5
6Use --enable-chip=XYZ to select the chip variant where XYZ is one of same70j19,
7same70j20, same70j21, same70n19, same70n20, same70n21, same70q19, same70q20,
8same70q21, sams70j19, sams70j20, sams70j21, sams70n19, sams70n20, sams70n21,
9sams70q19, sams70q20, sams70q21, samv71j19, samv71j20, samv71j21, samv71n19,
10samv71n20, samv71n21, samv71q19, samv71q20 and samv71q21.  By default the BSP
11uses the ATSAMV71Q21 chip.  Not all variants are tested.
12
13Use BOARD_MAINOSC=XYZ to set the main oscillator frequency in Hz (default
1412MHz).
15
16Use BOARD_MCK=XYZ to set the Master Clock (MCK) frequency in Hz (default
17123MHz).  The default value enables operation of an external SDRAM, e.g. 150MHz
18would be too fast.
19
20Use ATSAM_CONSOLE_BAUD=XYZ to set the initial baud for console devices (default
21115200).
22
23Use ATSAM_CONSOLE_DEVICE_TYPE=XYZ to set the device type for /dev/console, use
240 for USART and 1 for UART (default USART).
25
26Use ATSAM_CONSOLE_DEVICE_INDEX=XYZ to set the device index for /dev/console
27(default 1, e.g. USART1).
28
29Use ATSAM_CONSOLE_USE_INTERRUPTS=XYZ to set the use interrupt driven mode for
30console devices (used by default).
31
32Use ATSAM_MEMORY_TCM_SIZE=XYZ to set the size of tightly coupled memories (TCM)
33in bytes (default 0x00000000).
34
35Use ATSAM_MEMORY_INTFLASH_SIZE=XYZ to set the size of internal flash in bytes
36(default is derived from chip variant).
37
38Use ATSAM_MEMORY_INTSRAM_SIZE=XYZ to set the size of internal SRAM in bytes
39(default is derived from chip variant).
40
41Use ATSAM_MEMORY_SDRAM_SIZE=XYZ to set the size of external SDRAM in bytes
42(default 0x00200000).
43
44The pins may be configured by the application at link-time.  See
45<bsp/pin-config.h>.
46
47The clock driver uses the ARMv7-M Systick.
48
49The console driver supports the USART and UART devices.
50
51The default linker command file places the code into the internal flash.  Use
52"LDFLAGS += -qnolinkcmds -T linkcmds.sdram" to place the code into the external
53SDRAM.  Use "LDFLAGS += -qnolinkcmds -T linkcmds.intsram" to place the code
54into the internal SRAM.
55
56The fast text section uses the ITCM.  The fast data section uses the DTCM.
57
58Data and instruction cache are enabled during system start.  The RTEMS cache
59manager is supported with exception of the freeze functions.
Note: See TracBrowser for help on using the repository browser.