README.txt
author Mike Kinghan <mikek@symbian.org>
Wed, 04 Aug 2010 10:56:22 +0100
branchGCC_SURGE
changeset 93 07b904f40417
parent 35 bfd7df5b9067
permissions -rw-r--r--
Provisional fix for bug 3508 - Persistent storage support breaks Linux compatibility. Enables libnvmemmory.so to be built and dynamically linked on Linux and rom boot reports persistent storage image created OK, but ROM then crashes.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     1
This is repo contains the following; 
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     2
35
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
     3
applications/
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
     4
	Sample application 
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
     5
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     6
baseport/
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     7
	The baseport (BSP) needed to run Symbian OS in QEMU
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     8
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
     9
docs/
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    10
	Various documentation about the baseport, peripherals and how to use QEMU.
9
ed6428499142 Documentation updates
martin.trojer@nokia.com
parents: 8
diff changeset
    11
	The wiki folders contains a dump from Wiki documentation, thus the unfortunate .doc format.
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    12
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    13
symbian-qemu-0.9.1-12/
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    14
	A version of QEMU with some extra features not yet available in the QEMU mainline.
9
ed6428499142 Documentation updates
martin.trojer@nokia.com
parents: 8
diff changeset
    15
	A corresponding set of Windows/Linux binaries is available from the Symbian Foundation wiki
ed6428499142 Documentation updates
martin.trojer@nokia.com
parents: 8
diff changeset
    16
        http://developer.symbian.org/wiki/index.php/SYBORG/QEMU
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    17
35
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    18
tools/e32test-driver/
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    19
	A simple python script to run the E32test-suite and collect/summarize the results.
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    20
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    21
tools/elf4rom/
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    22
	The ELF4ROM command line tool and libraries. This tool is used to convert Symbian ROM images
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    23
	into debuggable elf files. See docs/wiki/ELF4ROM.doc for more information.
bfd7df5b9067 Updated the README.txt file
Martin Trojer <martin.trojer@nokia.com>
parents: 10
diff changeset
    24
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    25
Some notes;
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    26
8
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    27
* The source layout for baseport now matches the Symbian Foundation layout, and 
10
1cf69c2c2bbd Adjust to /sf/adaptation/qemu, add package_definition.xml and syborg.mrp
William Roberts <williamr@symbian.org>
parents: 9
diff changeset
    28
  will compile correctly if this repository is unpacked to /sf/adaptation/qemu. Eventually
8
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    29
  the baseport could move into the kernelhwsrv or boardsupport packages, but that
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    30
  would imply changing AsspNKernIncludePath in baseport/syborg/variant.mmh
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    31
  
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    32
* Even though a version of QEMU is supplied, the TOT version of QEMU should be usable 
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    33
  (but you will have to build it yourself). The QEMU version is supplied here to 
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    34
  share some the extra features not yet available in mainline QEMU. Most noticeable 
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    35
  the support for Python peripherals (and binary separation of QEMU and its peripheral) 
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    36
  and the skinning support to supply a landing zone for phone specific buttons etc.
0
ffa851df0825 Initial syborg (baseport) and documentation import
martin.trojer@nokia.com
parents:
diff changeset
    37
8
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    38
* Throughout the documentation the SVP is referenced. SVP stands for the 
3c796bbf0db3 Updated the README.txt - includes instructions on downloading ready-to-use QEMU binaries
William Roberts <williamr@symbian.org>
parents: 0
diff changeset
    39
  "Symbian Virtual Platform" and this was the proposed product name of the 
9
ed6428499142 Documentation updates
martin.trojer@nokia.com
parents: 8
diff changeset
    40
  QEMU based simulator. For the purpose of these sources and documents treat the SVP 
ed6428499142 Documentation updates
martin.trojer@nokia.com
parents: 8
diff changeset
    41
  as QEMU with the syborg board models.