VirtualBox image with Ubuntu for Korebot II development

K-TEAM SA

*******************************************************************************
Version
1.0 2010.04.28 J. Tharin

*******************************************************************************

Files needed:
 - VirtualBox installed (from http://www.virtualbox.org/)
 - Image file: {94dd2975-4410-4e00-9a4c-b6186322a9c3}.vmdk
 - Image file checksum: Ubuntu-KorebotII_VirtualBox.mf
 - Image file settings:  Ubuntu-KorebotII_VirtualBox.ovf

Hardware needed:
 - computer with at least 2GB of RAM and 4 GB of free diskspace

*******************************************************************************
 
Instructions:

- Install VirtualBox from http://www.virtualbox.org/

- Go to File/Import Appliance and import the Ubuntu-KorebotII_VirtualBox.ovf file settings.
  This will take some time.

- You may configure the serial port for using the KoreConnect to conenct to the Korebot II.  
  Select the "Ubuntu-KorebotII" machine and press "Settings" button.
  Go to "Serial Ports" settings;
    - On the tab "Port 1", enable the checkbox "Enable Serial Port"
      - and choose : Port Number: COM1 ( => this will be the Linux serial port /dev/ttyS0)
                     Port Mode: Host Device
                     Port/File Path: COM1 ,if you have a standard serial port and using COM1.
                                Or change to adapt to your computer serial port.
                            
  If you have the KheperaIII and the Korebot II, you can even use the Bluetooth com port instead of the KoreConnect.
  See the Khepera III user manual for the Bluetooth connection.

- You may want to share folders between your virtual machine and your computer.
  The network should be detected and installed autonomously.
  You can share folders like this:
    -  Select the "Ubuntu-KorebotII" machine and press "Settings" button.
    -  Go to "Shared Folders" settings
    - Push the Insert keyboard key or the icon "Add Shared Folder"
    - In the new dialog box, 
      for Folder path choose a existing (or create one) folder on your computer
      This folder will be available from the virtual machine (ex : "C:\virtual_machine_shared"). 
      The folder name should be autonomously created. You can change it. Try to not add any space in the name.
      (ex : "virtual_machine_shared").
  
   After starting the virtual machine and having installed the VirtualBox drivers as described in the next points,
   the shared folder will be mounted in /mnt/windows/ .
      
- Start the virtual machine "Ubuntu-KorebotII"
  its login is : 
        user: kteam
        password: kteamroot
 
- You may need to add the VirtualBox drivers, depending of the version of your computer and your VirtualBox.
  These drivers provide access to network, shared folder, mouse integration, ...
  In the "Device menu" (top bar of the window) of your virtual machine,
  Install guest additions.
 
- Korebot II development: 
  You will have the cross-compiler (full toolchain and sources) and development folder already installed (see the Korebot II user manual).
  You can start developing as described in chapter "4.4.2.1 Application development" of the above user manual. 
 
    
- Stopping the virtual machine.
  When going to the menu "Machine", you have 3 choices:
   - "Save the machine state": saves the current state, which will be reloaded next time
      you restart it.
   - "Send the shutdown signal", or press the shutdown button into the machine:
      power off the machine and save only the work done.
   - "Power off the machine": WARNING: it doesn't save anything; any work done will be discarded!