Release Notes - SAM9X25 Software Package ------------------------------------------ Release version: 1.0 Release date: 2011-04-28 1 Overview ---------- The SAM9X25 Software Package consists of SAM9X25 microcontroller drivers, software services & libraries, and demonstration applications. Each software module is provided with full source code, example of usage, rich html documentation and ready-to-use projects for the GNU GCC, IAR EWARM and Keil ¦̀Vision compilers. 2 Downloading and Installing ---------------------------- 2.1 GNU softpack On both Windows and Linux platforms, simply unzip the SAM9X25 Softpack for GNU. Make sure arm-none-eabi-gcc compiler is available in the default environment. "Sourcery G++ Lite 2010-q1-188" version of Codesourcery compiler has been used for SAM9X25 Softpack for GNU development. Each example is delivered with a single Makefile. Compilation is launched using the following command: make Some extra parameters can be specified. CROSS_COMPILE parameter can be used to specify another toolchain: make CROSS_COMPILE=arm-none-eabi- All default parameters defined in Makefile can be overriden through the command line: make TRACE_LEVEL=3 The default target will compile the example for all available memory configurations (ddram, ...). According to the memory configuration, the corresponding .lds file (located in libraries/board/) is used during the link. The compilation can be limited to a single memory configuration specifying the memory as a target: make MEMORIES=ddram GDB can be launched using command line. Several gdb commands shall be used to connect to the gdbserver, to initialize memories then load the application. These commands can be stored in a .gdb file. Some default .gdb files located in resources/gcc directory provide useful standard settings for AT91SAM Evaluation Kits. In order to simplify command line debugging using gdb, a makefile target sequencially starts the compilation then launch the debug session and load the application: make debug_sram Several aditionnal requirements are mandatory before building this target: SAM-ICE gdbserver shall be started before. The perl script from previous version isn't anymore used. gdb tries to connect to gdbserver through the localhost:2331 port. This is the default with SAM-ICE gdbserver. At least programming NVM memories can be done using SAM-BA graphical application. SAM_BA can also be run in command line mode, execute customized complex initialization scripts and load in several memories. 2.2 IAR softpack SAM9X25 SoftPack for EWARM requires an installation of IAR Systems Embedded Workbench for ARM version 5.50.x. The SAM9X25 SoftPack for EWARM will change the following components of your existing IAR EWARM 5.50.x installation: - Example projects for SAM9X25-EK board - C-SPY device description files - Device selection files Note that this package will add all sam9x5 series (5 devices) related configuration files in your EWARM installation, other files are left unmodified. After installation, the examples will be accessible under the "Example Projects" item in the IAR Information Center for ARM (show at EWARM startup or with "Help -> Information Center"). Choose "Atmel" from the manufacturer list, then choose SAM9X25-ek board. The list of supported examples will be displayed so you can easily clone the ones you are interested in. In addition, the examples come with HTML documentation explaining what they do and how to use them. It will be located in the "arm/examples/Atmel/SAM9X25-ek/documentation" subdirectory of your EWARM installation folder. The EWARM C-SPY debugger offers a particularly useful feature: in the Registers Window, the user can see the contents of peripheral registers in the chip. This functionality requires Device Description Files which provide the register mapping information for each board. Installing the SAM9X25 SoftPack for EWARM will add the .ddf files for SAM9X25 Atmel microcontrollers. The device description file is included in the SAM9X25 SoftPack for EWARM. 2.3 Keil ¦̀Vision softpack SAM9X25 SoftPack for ¦̀Vision requires an installation of ¦̀Vision for ARM version 4.20. The SAM9X25 SoftPack for Keil ¦̀Vision will change the following components of your existing Keil ¦̀Vision installation: - Example projects for SAM9X25-EK board Examples can be compiled and debugged using ¦̀Vision IDE. 2.4 SAM-BA support for sam9X25-ek To program SAM9X25 external memories, SAM9X25 sam-ba patch should be added to an already existing SAM-BA 2.10 installation.(You can install SAM-BA 2.10 available on Atmel web site: http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3883 if never install sam-ba v2.10 before). Then you can choose "SAM9X25-ek" board in connection window of SAM-BA.Then you can choose "SAM9X25-ek" board in connection window of SAM-BA. 2.4 Segger SAM-ICE driver Install JLinkARM driver version 4.20 or later to get support for SAM9X25 chip with SAM-ICE probe. 3 Contents ----------- This release of SAM9X25 SoftPack contains the following examples for CodeSourcery/GCC, IAR EWARM and Keil ¦̀Vision toolchains: - adc_adc10 - dma - getting-started - pmc_clock_switching - qtouch - ssc_dma_audio - twi_eeprom - twi_slave - sysc - spi_slave - can - tc_capture_waveform - usart_hw_handshaking - usart_spi - usart_synchronous - usart_serial - pwm - periph_protect - smc_psram - emac - hsmci_multimedia_card - hsmci_sdcard - hsmci_sdio - smc_nandflash - spi_serialflash - usb_core - usb_massstorage - usb_hid_mouse - usb_hid_keyboard - usb_hid_transfer - usb_cdc_serial - usb_audio_looprec - usb_iad_cdc_cdc - usb_iad_cdc_hid - usb_iad_cdc_msd - usb_hid_msd The software package includes the following libraries: - Libraires - libchip_sam9X25 - libboard_sam9X25-ek - libnandflash - libpmecc - libsdmmc - libspiflash - libstoragemedia - usb 4 Known issues --------------------- 5 Contact Information --------------------- For support on the AT91 Software Package please send request to at91@atmel.com 6 Copyright (c) 2011, Atmel Corporation All rights reserved. ------------------------------------------------------------ * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the disclaimer below. * * Atmel's name may not be used to endorse or promote products derived from * this software without specific prior written permission. * * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.