VirtualBox Virtual Machine for TI OMAP-L138/AM1808 Linux PSP Release Notes ------------------------------------------------------------------------------- Logic PD PSP Version: PSP-SDK-03.21.00.04 Date: 04/25/2013 ------------------------------------------------------------------------------- --------------------------- Table of Contents --------------------------- 0 Scope of Document 1 Overview 2 Requirements 3 Installation 4 Building 5 General Info --------------------------- 0) Scope of Document -------------------- The information contained within these release notes may pertain only to this version of the Linux PSP and virtual machine (VM). Please refer to Logic PD's website for more information. For installation instructions, please refer to the "AM1808 and OMAP-L138 Linux User Guide," available at: http://support.logicpd.com/downloads/1539/ 1) Overview ----------- The .ova file is a VM complete with Ubuntu operating system (OS) build tools and embedded Linux source code for this kit. 2) Requirements --------------- --) VirtualBox --) VirtualBox Extension Pack --) AM1808_OMAP-L138_Linux_PSP_SDK_03-21-00-04_VM.ova Optional: --) The VM does not include the latest Ubuntu updates. After your first build, you may want to run the Ubuntu update manager. --) The VM does not include VirtualBox Guest Additions. After your first build, you may want to add VirtualBox Guest Additions to simplify resizing screens and cutting and pasting between host and VM. See VirtualBox Help for VirtualBox and VirtualBox Guest Additions install instructions. VirtualBox version 4.1.18 was used to create this VM. 3) Installation --------------- a) Install VirtualBox; see the VirtualBox website at: https://www.virtualbox.org b) Install the VirtualBox Extension Pack for your OS. See the VirtualBox website at: https://www.virtualbox.org c) Start the VM and select File > Import virtual appliance.... d) Select the .ova file included with these release notes. e) Follow the prompts for installation. 4) Building the Linux SDK ------------------------- a) Open VirtualBox b) Right-click the AM1808_OMAP-L138_Linux_PSP_SDK_03-21-00-04_VM module that appears in the virtualBox VM Manager window and click "Settings" in the column on the left. Click "Serial Ports" and select the checkbox labeled "Enable Serial Port". c) Double-click the AM1808_OMAP-L138_Linux_PSP_SDK_03-21-00-04_VM module that appears in the virtualBox VM Manager window in the column on the left. d) When the VM is up and running, log in to Ubuntu with the following credentials: Ubuntu Username: logic Ubuntu Password: logic e) Set your environment. i) Open the terminal and use the following command to switch to the AM1808_OMAP-L138 directory: $ cd AM1808_OMAP-L138 ii) Run the following environment script: $ source setenv.sh You should see a message that reads "Setting up environment variables as shortcuts." f) Build the bootloader. i) Switch to the U-Boot directory: $ cd $UBOOT ii) Clean the build: $ make distclean CROSS_COMPILE=arm-none-linux-gnueabi- iii) Configure the source code: $ make da850evm_config CROSS_COMPILE=arm-none-linux-gnueabi- iv) Build the bootloader: $ make all CROSS_COMPILE=arm-none-linux-gnueabi- You will find the output here: $UBOOT/u-boot.bin g) Build the kernel. i) Switch to the kernel directory: $ cd $KERNEL ii) Clean the build: $ make distclean ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- iii) Prepare the kernel config file: $ make da850_omapl138_defconfig ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- iv) Build the kernel: $ make uImage ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- You will find the output here: $KERNEL/arch/arm/boot/uImage h) Create a bootable SD card: i) Create a dual-partition SD card: http://code.google.com/p/beagleboard/wiki/LinuxBootDiskFormat NOTE: The first partition should NOT be set as bootable. NOTE: You must format BOTH partitions. NOTE: You will need to remount the SD card after formatting. ii) Switch to the Images directory: $ cd $IMAGES iii) Copy the Kernel image to the first partition of the SD card: $ sudo cp uImage /media/LABEL1 iv) Copy the root filesystem to the second partition of the SD card: $ sudo tar -xvf /tftpboot/arago-base-image-glibc-ipk-2009.11-arago.rootfs.tar.gz -C /media/LABEL2 i) Flash the recovery image into SPI flash. i) Set DIP switches 7 and 8 on the S7 DIP switch board to the ON position. ii) Power on the system and enter the following commands: $ cd $RECOVER $ mono ./sfh_OMAP-L138.exe -erase -flashType SPI_MEM $ mono ./sfh_OMAP-L138.exe -flash -targetType OMAPL138 -flashType SPI_MEM -v./SPI_Flash/ubl_OMAPL138_SPI_MEM.bin ./SPI_Flash/u-boot.bin iii) Power off the system. iv) Set all DIP switches on the S7 DIP switch board to the OFF position. v) Insert the SD card into the development kit and power on the system. j) Restore the Ethernet MAC address on the SOM using the procedures in "Section 6" of Logic PD's "AN 566 AM1808/OMAP-L138 SOM-M1 SPI Flash Recovery," available at: http://support.logicpd.com/downloads/1572/ 5) General Info --------------- --) If you have difficulty installing or running VirtualBox, please see the VirtualBox website at: https://www.virtualbox.org --) Make sure VT-x and VT-d/AMD-Vi flags are enabled in the host BIOS. --) VirtualBox versions 3.1.x and older may not work with this VM. --) Make sure the VirtualBox Extension Pack is installed. --) If using "Ubuntu Software Center" to install VirtualBox, consider instead going to https://www.virtualbox.org to get the latest version of VirtualBox. ----------------------------------------------------------------------------- Copyright (c) 2013 Logic PD, Inc. www.logicpd.com