summaryrefslogtreecommitdiffstats
path: root/c/src/lib/libbsp/arm/atsam/README
diff options
context:
space:
mode:
Diffstat (limited to 'c/src/lib/libbsp/arm/atsam/README')
-rw-r--r--c/src/lib/libbsp/arm/atsam/README92
1 files changed, 0 insertions, 92 deletions
diff --git a/c/src/lib/libbsp/arm/atsam/README b/c/src/lib/libbsp/arm/atsam/README
deleted file mode 100644
index 2ebaa726c8..0000000000
--- a/c/src/lib/libbsp/arm/atsam/README
+++ /dev/null
@@ -1,92 +0,0 @@
-Board support package for the Atmel SAM V71/V70/E70/S70 chip platform.
-
-The BSP is customized to a particular board/chip variant by means of configure
-command line options.
-
-Use --enable-chip=XYZ to select the chip variant where XYZ is one of same70j19,
-same70j20, same70j21, same70n19, same70n20, same70n21, same70q19, same70q20,
-same70q21, sams70j19, sams70j20, sams70j21, sams70n19, sams70n20, sams70n21,
-sams70q19, sams70q20, sams70q21, samv71j19, samv71j20, samv71j21, samv71n19,
-samv71n20, samv71n21, samv71q19, samv71q20 and samv71q21. By default the BSP
-uses the ATSAMV71Q21 chip. Not all variants are tested.
-
-Use --enable-sdram=XYZ to select the SDRAM variant where XYZ is one of
-is42s16100e-7bli and is42s16320f-7bl. Not all variants are tested with all
-controller and speed combinations.
-
-Use BOARD_MAINOSC=XYZ to set the main oscillator frequency in Hz (default
-12MHz).
-
-Use ATSAM_MCK=XYZ to set the MCK frequency that should be used. The default case
-(123000000) enables operation of an external SDRAM on the SAMv71 Explained
-evaluation kit. Some other configurations (e.g. 150MHz) would be too fast on
-that board.
-
-Your application can also overwrite the clock settings. If you have a
-bootloader with one setting in your internal flash and an application with
-another setting in your external SDRAM, you should also use the
-ATSAM_CHANGE_CLOCK_FROM_SRAM=1 option. To overwrite the clock settings, define
-the following structures in your application:
-
---------
-const struct atsam_clock_config atsam_clock_config = {
- .pllar_init = my_custom_pllar_value,
- .mckr_init = my_custom_mckr_value,
- .mck_freq = my_resulting_mck_frequency
-};
-
-const struct BOARD_Sdram_Config BOARD_Sdram_Config = {
- .sdramc_tr = my_custom_sdramc_tr_value,
- .sdramc_cr = my_custom_sdramc_cr_value,
- .sdramc_mdr = my_custom_sdramc_mdr_value,
- .sdramc_cfr1 = my_custom_sdramc_cfr1_value
-};
---------
-
-Use ATSAM_SLOWCLOCK_USE_XTAL=0 to disable the usage of the external 32kHz
-oscillator for the slow clock. This is useful for example for the SAM E70
-Xplained kit.
-
-Use ATSAM_CONSOLE_BAUD=XYZ to set the initial baud for console devices (default
-115200).
-
-Use ATSAM_CONSOLE_DEVICE_TYPE=XYZ to set the device type for /dev/console, use
-0 for USART and 1 for UART (default USART).
-
-Use ATSAM_CONSOLE_DEVICE_INDEX=XYZ to set the device index for /dev/console
-(default 1, e.g. USART1).
-
-Use ATSAM_CONSOLE_USE_INTERRUPTS=XYZ to set the use interrupt driven mode for
-console devices (used by default).
-
-Use ATSAM_MEMORY_TCM_SIZE=XYZ to set the size of tightly coupled memories (TCM)
-in bytes (default 0x00000000).
-
-Use ATSAM_MEMORY_INTFLASH_SIZE=XYZ to set the size of internal flash in bytes
-(default is derived from chip variant).
-
-Use ATSAM_MEMORY_INTSRAM_SIZE=XYZ to set the size of internal SRAM in bytes
-(default is derived from chip variant).
-
-Use ATSAM_MEMORY_SDRAM_SIZE=XYZ to set the size of external SDRAM in bytes
-(default 0x00200000).
-
-Use ATSAM_MEMORY_QSPIFLASH_SIZE=XYZ to set the size of QSPI flash in bytes
-(default 0x00200000).
-
-The pins may be configured by the application at link-time. See
-<bsp/pin-config.h>.
-
-The clock driver uses the ARMv7-M Systick.
-
-The console driver supports the USART and UART devices.
-
-The default linker command file places the code into the internal flash. Use
-"LDFLAGS += -qnolinkcmds -T linkcmds.sdram" to place the code into the external
-SDRAM. Use "LDFLAGS += -qnolinkcmds -T linkcmds.intsram" to place the code
-into the internal SRAM.
-
-The fast text section uses the ITCM. The fast data section uses the DTCM.
-
-Data and instruction cache are enabled during system start. The RTEMS cache
-manager is supported with exception of the freeze functions.