Introduction APPLICATION NOTE The purpose of this document is to explain how to create a Virtual Machine on a Windows PC such that a Linux environment can be created in order to build a Linux kernel and applications. It also explains how to download and extract the RZ/A1 BSP. For this app note, VMWare Player and Ubuntu 14.04 will be installed. EU_00180 Rev.1.11 Target Device Contents 1. Install a Virtual Machine... 2 2. Download Ubuntu Ubuntu 14.04.1 LTS... 2 3. Create a New Virtual Machine... 2 4. Shutting down your Virtual Machine... 3 5. Install Some Additional Software Package Need for Kernel Building... 3 6. Download and Extract the RZ/A1 BSP... 3 7. Install the Cinnamon interface... 4 EU_00180 Rev.1.11 Page 1 of 4
1. Install a Virtual Machine Install a virtual machine of your choice: VMWare Player, VMWare Workstation, VirtualBox, etc For this appnote, VMWare Player 6 will be used. https://my.vmware.com/web/vmware/free#desktop_end_user_computing/vmware_player/6_0 2. Download Ubuntu Ubuntu 14.04.1 LTS Go to the following website and find the download for Ubuntu 14.04.01 LTS: http://www.ubuntu.com/desktop Make sure you download the 32-bit version because it will ensure it will work with all the Linux binary tools. You should be saving an ISO file (ubuntu-14.04.1-desktop-i386.iso) 3. Create a New Virtual Machine Launch your Virtual Machine app (VMWare Player in our case) and select to create a new virtual machine. The following is for VMWare Player 6. Click Create new Virtual Machine On the next screen, it will ask you if you have an ISO file to install with. Point it to the.iso file you downloaded. VMWare Player should recognize it. EU_00180 Rev.1.11 Page 2 of 4
On the next screen, it will ask you for: Full Name: Pick whatever you want like Renesas or your own name John Smith User Name: Pick whatever you want like renesas...or your own name (a short simple name and lower case is usually best like john or jsmith ) Password: Pick whatever you want like 1234.but keep it simple since this is just a virtual machine On the next screen, it will ask you for a Virtual Machine name. Pick whatever you want, like Ubuntu 14.04 LTS. Note that it will also ask you where on your PC you want to save your virtual machine files On the next screen, it will ask you for how big of a hard drive you need. The defaults are fine (20GB, split into multiple files) Click Finish to have the virtual machine created which will automatically boot it and start the install process of the Ubuntu OS. Simple use your username/password that you selected above to log in. 4. Shutting down your Virtual Machine When you are done using your virtual machine and want to shut down your virtual machine application (VMWare Player for example), you should properly shut down the virtual OS. For Ubuntu, that would be use the gear icon in the upper right corner and selecting shutdown. Alternatively, you can suspend the virtual machine by pressing the pause button. This allows you freeze your Linux OS so you can then shut down the virtual machine player (VMWare). Then later, you can come back and resume your PC image and pick up where you left off. 5. Install Some Additional Software Package Need for Kernel Building These software packages are not part of the default Ubuntu install, so you need to install them yourself. From a terminal (Ctrl + Alt + T), install the following packages by entering the follow. Note that the sudo command in front (sudo stands for super user do ) will require you to enter your password the same one you used to log in. $ sudo apt-get install u-boot-tools $ sudo apt-get install ncurses-dev 6. Download and Extract the RZ/A1 BSP Download the BSP and extract to /home/renesas/rskrza1-bsp-v1.2.0 Notice: The BSP is updated periodically. Please check the website to determine what the latest BSP is. https://github.com/renesas-rz/rskrza1_bsp_releases NOTE: This assumes your username for Linux was renesas. If you used your own name, then simply modify the path name as needed. From a terminal (Ctrl + Alt + T): $ cd /home/renesas $ wget https://github.com/renesas-rz/rskrza1_bsp_releases/raw/master/rskrza1-bsp-v1.2.0.tar.bz2 $ tar xf RSKRZA1-BSP-V1.2.0.tar.bz2 You should now be able to build the software in the RZ/A1 BSP: $ cd RSKRZA1-BSP-V1.2.0 $./build.sh EU_00180 Rev.1.11 Page 3 of 4
7. Install the Cinnamon interface The default desktop environment on Ubuntu is Unity which is quite a bit different from the standard Microsoft Windows environment. As an alternative, it is recommended that you install the Cinnamon interface which has a start button and a Task bar at the bottom. To install the Cinnamon package: Open a terminal window and enter the following commands: $ sudo add-apt-repository ppa:tsvetko.tsvetkov/cinnamon $ sudo apt-get update $ sudo apt-get install cinnamon Then, log out of the desktop environment using the icon on the very top right of your screen: At the login screen, click the round icon where you log in and select Cinnamon After logging back in, your desktop should look something like this: EU_00180 Rev.1.11 Page 4 of 4
Revision Record Rev. Date Description Page Summary 1.00 Nov 25, 2014 First edition issued 1.10 Jan 14, 2016 3,4 Added section 7, changed link to BSP v1.1.1 1.11 3 Fix tar command. Changed link to BSP v1.2.0 A-1