README.txt
author Mike Kinghan <mikek@symbian.org>
Wed, 04 Aug 2010 15:41:26 +0100
branchGCC_SURGE
changeset 95 285922d13199
parent 35 bfd7df5b9067
permissions -rw-r--r--
Correction for the fix for Bug 3508 - Persistent storage support breaks Linux compatibility. A 2nd `make install' will fail attempting to create symlink libnvmemmory.so already created by 1st install. Install should pre-emptively delete it.

This is repo contains the following; 

applications/
	Sample application 

baseport/
	The baseport (BSP) needed to run Symbian OS in QEMU

docs/
	Various documentation about the baseport, peripherals and how to use QEMU.
	The wiki folders contains a dump from Wiki documentation, thus the unfortunate .doc format.

symbian-qemu-0.9.1-12/
	A version of QEMU with some extra features not yet available in the QEMU mainline.
	A corresponding set of Windows/Linux binaries is available from the Symbian Foundation wiki
        http://developer.symbian.org/wiki/index.php/SYBORG/QEMU

tools/e32test-driver/
	A simple python script to run the E32test-suite and collect/summarize the results.

tools/elf4rom/
	The ELF4ROM command line tool and libraries. This tool is used to convert Symbian ROM images
	into debuggable elf files. See docs/wiki/ELF4ROM.doc for more information.

Some notes;

* The source layout for baseport now matches the Symbian Foundation layout, and 
  will compile correctly if this repository is unpacked to /sf/adaptation/qemu. Eventually
  the baseport could move into the kernelhwsrv or boardsupport packages, but that
  would imply changing AsspNKernIncludePath in baseport/syborg/variant.mmh
  
* Even though a version of QEMU is supplied, the TOT version of QEMU should be usable 
  (but you will have to build it yourself). The QEMU version is supplied here to 
  share some the extra features not yet available in mainline QEMU. Most noticeable 
  the support for Python peripherals (and binary separation of QEMU and its peripheral) 
  and the skinning support to supply a landing zone for phone specific buttons etc.

* Throughout the documentation the SVP is referenced. SVP stands for the 
  "Symbian Virtual Platform" and this was the proposed product name of the 
  QEMU based simulator. For the purpose of these sources and documents treat the SVP 
  as QEMU with the syborg board models.