HOWTO Setup GumStix Buildroot on a Windows System using VMWare

=The Easy Route=

Download the VMWare Server and/or Player software
The good people at VMWare have made their virtualization software available as a free download. There are two versions of the free software: server and player. The VMWare player seems to have much better support for USB devices, while the Server is useful for developing your own custom VMWare images. Either can be used to download and compile the source code for GumStix Linux, but you'll need the VMWare Player communicate with the GumStix system via a USB port. Ergo, we recommend installing the Player and If you know you're going to build your own development image, install the Server as well.

You can find the download images at the VMWare Download site.

Download the Homebrew Mobile Phone Club Developers' Image
Use BitTorrent to download the XU710_HBMOBILE003.tar.gz.torrent file. More info can be found at LinuxTracker.

Tell the VMWare Server (or Player) about the Image
Once you've downloaded the gzipped tar file containing the VMWare image, use a tool such as Power Archiver 6.1 (.exe), 7-ZIP, or WinZip to unarchive the XU710_HBMOBILE003.tar.gz file. When unpacked, it will (or at least it should) extract the contents into a director called XU710_HBMOBILE003.

Now use the "File >> Import" feature of VMWare Workstation to import the virtual machine definition in the XU710_HBMOBILE003 directory.

After that, it should be as simple as clicking the green "start" button.

Tinker
Once you've booted the image, it should automatically log in as user "mobo". You should also find an informational mobo.html file on the desktop. Some good hints include:


 * To get a terminal, click on the "Applications" button in the upper left corner of the screen, drag down to the "System" sub-menu, then drag over and then down to the "Terminal" menu item.
 * To perform a command as root, put the word  before the command. The system will ask you for your password which is "hbmobile" (without the quotes.)
 * To open a web browser, click on the Firefox logo (the orange and blue thing) just to the right of the "Applications" button in the top left corner of the screen.
 * The system is setup with several virtual desktops. In theory, the Ctrl-Alt-Left Arrow and Ctrl-Alt-Right Arrow move between screens, but the default configuration for VMWare is to steal the Ctrl-Alt keystroke for it's own purposes. In the bottom-right corner of the desktop, you should see the "pager" that lets you switch between virtual desktops.

Build
To build the boot loader (u-boot.bin), root filesystem (rootfs.arm_nofpu.jffs2), and kernel (uImage), simply execute the following command from the command line:""

This will download the latest build_myphone.sh file from the web and execute it.

When it's finished (it takes about 2 hours on my reasonably slow laptop and 6 hours on my very slow laptop) you'll see the three files mentioned above in the ~/Projects directory. Once you've built these files, install them using the procedure documented at the HOWTO Reflash the GumStix Verdex page.

=The Less Easy Route (Building Your Own VMWare Image)=

Install the VMWare Server software
If you haven't done so already, visit the the VMWare Download site and retrieve the installer for the VMWare Server. Please note that you're expected to agree to a EULA and request a license string before the software will run (though there's no fee associated with this license.)

Download the Xubuntu 7.10 Gutsy Gibbon Linux Install Disk
You're free to choose a completely different distribution if you want, but I've turned into quite the Debian/Ubuntu fan lately, so the instructions here will apply to those who like (X)Ubuntu. I'm using Xubuntu because it seems slightly "zippier" than the full Ubuntu distro on virtualized hardware. You can download an ISO image from the Xubuntu download page.

Start the VMWare Server and Create a New Image

 * 1) After launching the VMWare Server, you'll be asked what VMWare host you want to be connected to. select LocalHost.
 * 2) Start the VM creation process by selecting the File >> New >> Virtual Machine... menu item.
 * 3) When queried whether to use a "Typical" or "Custom" VM configuration, select Custom.
 * 4) When queried which class of Guest Operating System you'll be installing, select Linux from the radio button selection and Other Linux 2.6.x kernel from the drop down selection list.
 * 5) Choose a meaningful name. I name my images like: XUnnn_HBMOBILEyyy where nnn is the version of Xubuntu and yyy is the version of the image I'm working with.
 * 6) The new VM wizard will ask if you wish to "Make this virtual machine private." I usually select the default, which is to make it private.
 * 7) It will also ask which user to run the VM as. I choose the default, User that powers on the Virtual Machine.
 * 8) I don't have two processors in my laptop, but I imagine it would be nice to utilize them both if the VM migrated to a machine that did, so when the wizard asks the number of virtual processors, I select Two.
 * 9) You are free to give the VM as much memory as you think it needs. I generally select 256Mb when creating the images.
 * 10) I have encountered minor problems when using bridged networking, so I usually select network address translation (NAT).
 * 11) For an I/O Adapter Type, I select a LSI Logic SCSI type.
 * 12) Next, I tell the wizard I want to Create a new virtual disk.
 * 13) The disk should be a SCSI (Recommended) type.
 * 14) I usually select the default size, which is 8.0 Gb on my machine. But most importantly, uncheck the Allocate all disk space now check-box. Otherwise, the virtual disk it creates will be difficult to compress.
 * 15) I like to name the Disk file the same name as the virtual machine and place it in the same folder with the VM.

Mount and Install Linux from the Xubuntu Disk Image

 * 1) Open the Virtual Machine Settings dialog box with the VM >> Settings... menu item.
 * 2) Highlight the CD-ROM (IDE 1:0) device in the device list on the Hardware tab.
 * 3) Select the "Use ISO Image" radio button in the Connection section of the dialog.
 * 4) Enter the path to Xubuntu ISO image you downloaded earlier or click the browse button and select it with the file chooser.
 * 5) Click OK
 * 6) In the main VMWare Server Console, click the green "Start" button. It may take several minutes, but the Xubuntu LiveCD / Install desktop should come up.
 * 7) On the left side of the screen is a column of icons. Double-click the "Install" icon at the bottom.
 * 8) Xubuntu can be configured with several languages and keyboard settings. The options I chose were:"English Language InstallIn a time zone near Los AngelesUS English / US English keyboard layoutDo a Guided partitioning on SCSI (0,0,0)Do not import existing user accounts"
 * 9) When the wizard asks for information about me, I enter:"What is your name? Homebrew Mobile Phone DeveloperWhat name do you want to use to log in? mobo</li>Choose a password... hbmobile</li>name of this computer? sheriff-mobo</li></ul>"
 * 10) Hit the "Install" button on the "Ready to Install" dialog. At this point, the disk will spin and the lights will blink and in about 20 minutes (depending on how beefy your host system is) the install will be complete.
 * 11) When the install completes, you'll see a dialog box asking you to "Continue Using the Live CD" or "Restart Now". Unmount the Xubuntu Install Disk before restarting the virtual machine. You do this by going back to the settings dialog box at the "VM >> Settings..." menu item, clicking on the CD-ROM device and selecting the "Use physical drive" radio button to the right of the device list. (If you find that your mouse is trapped inside the virtual machine, hit the Control and Alt keys simultaneously, this will allow the mouse pointer to escape the virtual Xubuntu desktop.

Login and Configure the mobo Account

 * 1) After rebooting, you should see a standard Xubuntu login panel.  Login with the username "mobo" and the password "hbmobile".
 * 2) Open a terminal window by selecting the clicking on the "Applications" button in the upper left corner of the virtual screen, dragging down to "Accessories", and then over and down to the "Terminal" menu item.
 * 3) From the command line, issue these commands:""
 * 4) Edit the Login Windows Preferences by clicking on the "Applications" button in the upper left hand corner of the screen, dragging down to "Settings" and then over and down to the "Login Window" menu item. When the Login Windows Preferences dialog box appears, click on the "Security" tab. Check the "Enable Automatic Login" checkbox and select the user "mobo" from the drop down list below the check box; then click on the Close button.
 * 5) Start the Firefox browser by clicking on the Firefox logo in the upper left of the screen. Set the default page by clicking on the "Edit >> Preferences" menu item. In the Home Page text box, enter:"file:///home/mobo/Desktop/mobo.html"Then click the "Close" button.

Halt the System and Package the Virtual Machine
Now that everything is configured, you can shut down the Linux virtual machine by selecting clicking on the "Applications" button in the upper left corner of the screen and dragging down to the "Quit" menu item; then hit the "Shutdown" button. You're now ready to distribute your VMWare Image!

The VMWare web site indicates that only the .vmx and .vmdk files are required for distribution with a new virtual machine, so quit the VMWare Server Console and archive these two files.