Spectrum Digital AM1808/AM1810/OMAPL138 EVM Linux SDK
This page details the process of creating a SD card which is needed to boot and run a Linux system on Spectrum Digital's AM1810,AM1808 and OMAPL138 Evaluation Modules(EVM).This page will also be a primary location for all the binaries,scripts and documents required to achieve this task.
- PC Running Linux Operating System. Prefereably Ubuntu 10.04(tested version).
- SD CARD - 4GB and above.
- USB SDHC Card Reader.
- Create a directory on your linux host machine to download all the required files.
- First, download all the binaries into the directory depending on the version you are interested in. Read the release notes for detailed information on the version you are about to download.
- Next, download the install scripts as a .zip file. Extract all the scripts into the directory. Run the command chmod +x *.sh on the directory from the terminal window.
- Lastly,follow the SD card creation steps very carefully and create the SD card.
AM18x DVSDK binaries
|Linux DVSDK - AM18x
Linux DVSDK for AM1808,AM1810 and OMAPL138 EVMs.
|August 22nd 2011
AM18x DVSDK SD Card install scripts
|Make 3 partition SD Card.
||August 22nd 2011
AM18x SD Card Creation Steps
- This step assumes that all the files listed below for creating a SD card are in the same directory structure on your linux host machine.The first three files are downloaded from section AM18x DVSDK binaries, the last three files are downloaded from section AM18x DVSDK SD Card install scripts.
- Plug in the SD card reader with SD card plugged in into the USB port of your linux host machine.
- Examine the linux host system using the command df -hT.A sample output of the command is shown below.
The example above shows that the SD card reader is attached to /dev/sdc on the linux system.This is a typical 8G card purchased through a retail channel which has a standard windows FAT formatted single partition.
!!!The Linux host partition (mounted on /) is on /dev/sda1. This indicates that the host machine has a SATA drive on /dev/sda!!!
- Note down the partition that the SD card is attached to. In our example above, the SD card is attaches to /dev/sdc
- Run makeSD.sh script with device name that the SD card is attached to as the parameter. This command requires administrator priviliges (sudo access)on your host.The sample command for our example is sudo ./makeSD.sh /dev/sdc. The output of the command is shown in the figure below.This command takes about 5-10 minutes to complete.
!!!Passing the device associated with the hard drive of the host machine to this script will destroy the host machine's hard drive!!!
- After all the operations from the previous step are completed, unplug the card reader and replug into the USB port. The SD card now has 3 partitions. They are boot,rootfs and START_HERE partitions. The boot partition has the kernel image, rootfs partition has the filesystem and the START_HERE partition has all the other miscellaneous files required for your development.
Running the demo
- Download the code sourcery lite toolchain from this link. Make sure to download IA32 GNU/Linux Installer. Open a terminal window on your linux host and navigate to the installer directory. Run chmod +x arm-2009q1-203-arm-none-linux-gnueabi.bin on the installer.
host# chmod +x arm-2009q1-203-arm-none-linux-gnueabi.bin
- Execute the installer using the command ./arm-2009q1-203-arm-none-linux-gnueabi.bin and follow the installer instructions on the screen to do a typical installation.
- From the terminal window, naviagate to START_HERE partition of your SD card. This typically is /media/START_HERE directory.Execute install-sd-dvsdk-18.104.22.168.sh script. Follow the script instructions.
host# cd /media/START_HERE
- Code Composer Studio v5 (CCSv5) is provided as a part of the Linux SDK. CCSv5 is an Integrated Development Environment (IDE) based on Eclipse and provides a graphical environment you can use to experiment with the example applications provided or develop your own. The following files will be found in the START_HERE partition of the SD Card:
--CCS (folder containing CCS installer with plug-ins in extras folder)
Enter the /media/START_HERE directory and enter the following commands at the Ubuntu Linux Host to install CCSv5.
host# cd /media/START_HERE
host# ./ccs_install.sh $PWD
CCSv5 Users Guide will provide you with additional details of using CCSv5 with your AM1808/AM1810/OMAPL138 EVM.
- The source and prebuilt-binaries of ubl can be found under the archive SDK_INSTALL_DIR/host-tools/flash_utils/OMAP-L138_FlashAndBootUtils_2_31_a.tar.gz. Untar the Flash and Boot utilities.The prebuilt ubl binary can be found under OMAP-L138_FlashAndBootUtils_2_31/OMAP-L138/GNU/ubl directory. The ubl binary used on all the three Spectrumdigital's AM1808/AM1810/OMAPL138 EVM's is ubl_AM1810_SPI_MEM.bin
Note: Please note that ubl_AM1808_SPI_MEM.bin and ubl_OMAPL138_SPI_MEM.bin are for Logic PD's AM1808 and OMAPL138 EVM's. They are not supported on SpectrumDigital AM1808 and OMAPL138 EVM'S due to differences in DDR and UART peripherals.
- The next step is to program the EVM with ubl and uboot. One way of programming ubl and u-boot is via JTAG by connecting the EVM to either Spectrum Digital's XDS510USB PLUS emulator or XDS560V2u STM class emulators. A detailed procedure of executing the tests on a linux host can be found in readme.txt located in CCS_INSTALL_DIR/ccsv5/ccs_base_5.0.1.00026/emulation/boards/evmam18xx_v1 directory.
Note:A copy of prebuilt ubl and u-boot binaries already exist under CCS_INSTALL_DIR/ccsv5/ccs_base_5.0.1.00026/emulation/boards/evmam18xx_v1/dss_scripts directory.
- The next step is to set the uboot environment variables to boot the kernel and filesystem from SD card. This can be done by running the setup.sh script from SDK install directory.This file is located in the top level of the SDK install directory and can be run with the following command. Please note that this command requires you to have administrator priviliges (sudo access) on your host.
host# cd SDK_INSTALL_DIR
host# sudo ./setup.sh
Choosing all the default settings while running the script will setup the board memory to 64MB and to boot the kernel and filesystem from SD card. This requires you to connect the RS-232 cable between your host and EVM as well as your ethernet cable.
- Plug in the SD card and follow the instructions in the quick start guide to run the demo. Even though the quick start guide is specific to AM1810 EVM, the same procedure also applies to spectrum digital's AM1808 and OMAP L138 EVM's.