Documentation
This project provides different configurations of virtual images
with a complete environment for maemo applications programming and building. There are
two different virtual images:
- Virtual image with Ubuntu Server Gutsy installed - used as sandbox for
building C/C++ applications and also other utilities for non-Linux host operation systems.
It is used for ESbox
Eclipse-based product to provide non-Linux host system programming for maemo platform.
- Virtual image with Ubuntu Server Hardy installed - the same as previous
one, but for non-Windows system usage (see Known Issues section).
In order to access any Maemo SDK virtual image, you need to use default credentials:
- login: maemo
- password: maemo
Root user (
root) is disabled. Then, if you want to become root you need to user
sudo command.
Installation
Both images are compressed as zip files. In addition, other files are also attached: release notes,
vmx (VMPlayer description file), README and copyright notices.
The virtual images execute properly on Debian-based distributions, MS Windows XP/Vista and also on
Mac OS X.
You can use both QEMU or VMPlayer to run the machines. To run the machine with QEMU,
execute the following command:
(On Linux)
$ qemu -hda maemosdk_*_*.vmdk -L /usr/bin/qemu
(On Windows)
$ qemu.exe -hda maemosdk_*_*.vmdk -L C:\QEMU\pc-bios
It is important to install
KQEMU Accelerator to speed
up virtual image execution.
However, if you want to use VMWare, you will need a *.vmx file (this file is already attached
on virtual images zip files). To "play" the machine with VMWare, you can use VMPlayer graphical interface.
Development Targets
On both virtual images, the targets for the Maemo 4.1 platform are DIABLO_X86 (i386)
and DIABLO_ARMEL (arm). You can use the i386 target during most of
the development phase, and then change to ARMEL when you decide to
deploy or test your software in the device
The default target is DIABLO_X86,
but you can change environments calling the sb-menu utility,
going in the Select option, and choosing the environment.
If you switch between X86 and ARM targets, remember to stop and restart the environment
with af-sb-init.sh stop and af-sb-init.sh start,
respectively.
WARNING: For some reason af-sb-init.sh stop
doesn't work on the ARMEL target, and before changing targets you need
to call sb-menu select the killall
option, and send a 9 signal to the processes running.
How to use the maemo SDK virtual image with ESbox
If you want to use the maemo SDK virtual image with ESbox and use the IDE on a non-Linux
operating system (Windows or OS X), check this
document to configure your environment properly.
Remeber that
sudo must be used to obtain superuser privilegies (see
user account)
Known issues
- This image does not contain OpenVMTools preinstalled or any other enhancing-performance
tool. These tools are mostly used for enhancing graphics and network performance. As this
image does not provide GUI interface, neither good networking performance,
enhancing-performance tools are not installed by default.
- This image has performance drawback when used with QEMU. Usage of VMWare Player to run
this Maemo Virtual SDK Image is recommended for those developers who experience performance
problems with QEMU.
Specific to Hardy image:
- This image has problems with Samba sharing when used with Windows host PC.
There is another Maemo Virtual SDK Image based on Ubuntu Gutsy that is
recommended for Windows users who experience Samba problems.
