more docs merged into the big doc

9 files changed, 203 insertions, 203 deletions

diff --git a/zpu/roadshow/roadshow/pics/GCC_logo.png b/zpu/docs/images/GCC_logo.png
index 7b3435f..7b3435f 100644
--- a/zpu/roadshow/roadshow/pics/GCC_logo.png
+++ b/zpu/docs/images/GCC_logo.png
diff --git a/zpu/roadshow/roadshow/pics/codesize1.PNG b/zpu/docs/images/codesize1.PNG
index 874ee9d..874ee9d 100644
--- a/zpu/roadshow/roadshow/pics/codesize1.PNG
+++ b/zpu/docs/images/codesize1.PNG
diff --git a/zpu/roadshow/roadshow/pics/codesize2.PNG b/zpu/docs/images/codesize2.PNG
index caa8c14..caa8c14 100644
--- a/zpu/roadshow/roadshow/pics/codesize2.PNG
+++ b/zpu/docs/images/codesize2.PNG
diff --git a/zpu/roadshow/roadshow/pics/ecos.gif b/zpu/docs/images/ecos.gif
index 3dad40c..3dad40c 100644
--- a/zpu/roadshow/roadshow/pics/ecos.gif
+++ b/zpu/docs/images/ecos.gif
diff --git a/zpu/roadshow/roadshow/pics/elizadebug1.PNG b/zpu/docs/images/elizadebug1.PNG
index f3c3f5f..f3c3f5f 100644
--- a/zpu/roadshow/roadshow/pics/elizadebug1.PNG
+++ b/zpu/docs/images/elizadebug1.PNG
diff --git a/zpu/roadshow/roadshow/pics/elizadebug2.PNG b/zpu/docs/images/elizadebug2.PNG
index 13f046e..13f046e 100644
--- a/zpu/roadshow/roadshow/pics/elizadebug2.PNG
+++ b/zpu/docs/images/elizadebug2.PNG
diff --git a/zpu/docs/zpu_arch.html b/zpu/docs/zpu_arch.html
index c7e20bc..280cda3 100644
--- a/zpu/docs/zpu_arch.html
+++ b/zpu/docs/zpu_arch.html
@@ -15,7 +15,12 @@
 <li> <a href="#wishbone">Wishbone</a>
 <li> <a href="#zpu_core_small.vhd">About zpu_core_small.vhd</a>
 <li> <a href="#zpu_core.vhd">About zpu_core.vhd</a>
+<li> <a href="#codesize">Optimizing for code size</a>
+<li> <a href="#ecos">Installing eCos build tools</a>
+
+
 <li> <a href="#nextgen">Next generation ZPU</a>
+
 </ul>
 
 <a name="fpgastarted"/>
@@ -1457,6 +1462,204 @@ accessed through this memory interface.
 <p>
 It performs better(despite having less memory bandwidth than zpu_core_small.vhd)
 since it implements many more instructions.
+<h1>Compiling hello world program with the ZPU GCC toolchain</h1>
+The ZPU comes with a standard GCC toolchain and an instruction set simulator. This allows compiling, running & debugging simple test programs. The Simulator has 
+some very basic peripherals defined: counter, timer interrupt and a debug output port. 
+<h1>Installation</h1>
+<ol>
+<li>Install Cygwin. http://www.cygwin.com 
+<li>Start Cygwin bash
+<li>unzip zputoolchain.zip
+<li>Add install/bin from zputoolchain.zip to PATH.<br>
+export PATH=$PATH:<unzipdir>/install/bin
+</ol>
+<h1>Hello world example</h1>
+The ZPU toolchain comes with newlib & libstdc++ support which means that many C/C++ programs can be compiled without modification.
+<p> 
+<code>
+zpu-elf-gcc -Os -zeta hello.c -o hello.elf -Wl,--relax -Wl,--gc-sections<br>
+zpu-elf-size hello.elf<br>
+</code>
+
+<a name="codesize"/>
+<h1>Optimizing for code size</h1>
+The ZPU toolchain produces highly compact code.  
+<ol>
+<li>Since the ZPU GCC toolchain supports standard ANSI C, it is easy to stumble across
+functionality that takes up a lot of space. E.g. the standard printf() function is a beast. Some compilers drop e.g. floating point support
+from the printf() function and thus boast a "smaller" printf() when in fact they have a non-standard printf(). newlib has a standard printf() function
+and an alternative iprintf() function that works only on integers.
+<li>The ZPU ships with default startup code that works across various configurations of the ZPU, so be warned that there is some overhead that will
+not occurr in the final application(anywhere between 1-4kBytes).
+<li>Compilation and linker options matter. The ZPU benefits greatly from the "-Wl,--relax -Wl,--gc-sections" options which is not used by
+all architectures(e.g. GCC ARM does not implement/need -Wl,--relax).  
+</ol> 
+<h2>Small code example</h2>
+<code>
+zpu-elf-gcc -Os -abel smallstd.c -o smallstd.elf -Wl,--relax -Wl,--gc-sections<br>
+zpu-elf-size small.elf<br>
+<br>
+$ zpu-elf-size small.elf<br>
+   text    data     bss     dec     hex filename<br>
+   2845     952      36    3833     ef9 small.elf<br>
+<br>
+</code>
+
+<h2>Even smaller code example</h2>
+If the ZPU implements the optional instructions, the RAM overhead can be reduced significantly.
+<p>
+<code>
+zpu-elf-gcc -Os -abel crt0_phi.S small.c -o small.elf -Wl,--relax -Wl,--gc-sections -nostdlib <br>
+zpu-elf-size small.elf<br>
+<br>
+$ zpu-elf-size small.elf<br>
+   text    data     bss     dec     hex filename<br>
+     56       8       0      64      40 small.elf<br>
+     <br>
+</code>
+
+
+
+<a name="ecos"/>
+<h1>Installing eCos build tools</h1>
+<code>
+tar -xjvf ecossnapshot.tar.bz2<br>
+tar -xjvf repository.tar.bz2<br>
+tar -xjvf ecostools.tar.bz2<br>
+# run this every time you open the shell<br>
+export PATH=$PATH:`pwd`/ecos-install<br>
+export ECOS_REPOSITORY=`pwd`/ecos/packages:`pwd`/repository<br>
+</code>
+<h1>Compiling eCos tests</h1>
+<code>
+ecosconfig new zeta default<br>
+ecosconfig tree<br>
+make<br>
+cd kernel/current<br>
+make tests<br>
+</code>
+
+<h1>Code size ZPU</h1>
+<code>
+$ zpu-elf-size *<br>
+   text    data     bss     dec     hex filename<br>
+  15761    1504   12060   29325    728d bin_sem0<br>
+  16907    1512   14436   32855    8057 bin_sem1<br>
+  17105    1524   30032   48661    be15 bin_sem2<br>
+  17186    1512   14436   33134    816e bin_sem3<br>
+  18986    1500   12036   32522    7f0a clock0<br>
+  15812    1504   13236   30552    7758 clock1<br>
+  25095    1972   13224   40291    9d63 clockcnv<br>
+  16437    1500   13224   31161    79b9 clocktruth<br>
+  15762    1504   12060   29326    728e cnt_sem0<br>
+  17124    1512   14436   33072    8130 cnt_sem1<br>
+  35947    1564   22512   60023    ea77 dhrystone<br>
+  16428    1500   13228   31156    79b4 except1<br>
+  15751    1504   12052   29307    727b flag0<br>
+  19145    1512   15624   36281    8db9 flag1<br>
+  20053    1516  102908  124477   1e63d fptest<br>
+  15998    1496   12092   29586    7392 intr0<br>
+  16080    1496   12200   29776    7450 kalarm0<br>
+  15327    1496   12036   28859    70bb kcache1<br>
+  15549    1496   13224   30269    763d kcache2<br>
+  18291    1500   12260   32051    7d33 kclock0<br>
+  16231    1500   13232   30963    78f3 kclock1<br>
+  16572    1496   13228   31296    7a40 kexcept1<br>
+  15618    1496   12060   29174    71f6 kflag0<br>
+  19287    1500   15624   36411    8e3b kflag1<br>
+  16887    1516   15628   34031    84ef kill<br>
+  16186    1496   12128   29810    7472 kintr0<br>
+  19724    1504   14516   35744    8ba0 klock<br>
+  18283    1500   14592   34375    8647 kmbox1<br>
+  15539    1496   12064   29099    71ab kmutex0<br>
+  16524    1504   15664   33692    839c kmutex1<br>
+  18272    1712   20348   40332    9d8c kmutex3<br>
+  18682    1608   20352   40642    9ec2 kmutex4<br>
+  15619    1496   14412   31527    7b27 ksched1<br>
+  15567    1496   12060   29123    71c3 ksem0<br>
+  17063    1500   14436   32999    80e7 ksem1<br>
+  15504    1496   13228   30228    7614 kthread0<br>
+  16167    1496   14412   32075    7d4b kthread1<br>
+  18281    1512   14580   34373    8645 mbox1<br>
+  20611    1508   14940   37059    90c3 mqueue1<br>
+  15672    1504   12064   29240    7238 mutex0<br>
+  16678    1516   15664   33858    8442 mutex1<br>
+  17694    1508   16868   36070    8ce6 mutex2<br>
+  18203    1720   20344   40267    9d4b mutex3<br>
+  16352    1508   14428   32288    7e20 release<br>
+  15890    1500   14412   31802    7c3a sched1<br>
+  44196    1612  286332  332140   5116c stress_threads<br>
+  17891    1524   16864   36279    8db7 sync2<br>
+  16943    1512   15644   34099    8533 sync3<br>
+  15467    1496   13064   30027    754b thread0<br>
+  16134    1496   14420   32050    7d32 thread1<br>
+  17560    1512   15636   34708    8794 thread2<br>
+  16279    1500   24028   41807    a34f thread_gdb<br>
+  17051    1504   20376   38931    9813 timeslice<br>
+  17146    1504   21564   40214    9d16 timeslice2<br>
+  37313    1512  422380  461205   70995 tm_basic<br>
+</code>
+<h2>Code size ARM (non-thumb)</h2>
+Thumb does not compile out of the box w/AT91 EB40a for which this test was made.<p>
+<code>
+$ arm-elf-size *<br>
+   text    data     bss     dec     hex filename<br>
+  25204     692   16976   42872    a778 bin_sem0<br>
+  26644     700   22096   49440    c120 bin_sem1<br>
+  26996     712   55584   83292   1455c bin_sem2<br>
+  27008     700   22100   49808    c290 bin_sem3<br>
+  28992     688   16944   46624    b620 clock0<br>
+  25456     692   19532   45680    b270 clock1<br>
+  34572    1160   19520   55252    d7d4 clockcnv<br>
+  26224     688   19508   46420    b554 clocktruth<br>
+  25204     692   16976   42872    a778 cnt_sem0<br>
+  26888     700   22108   49696    c220 cnt_sem1<br>
+  44180     752   27416   72348   11a9c dhrystone<br>
+  26088     688   19520   46296    b4d8 except1<br>
+  25236     692   16968   42896    a790 flag0<br>
+  29532     700   24668   54900    d674 flag1<br>
+  29508     704  109652  139864   22258 fptest<br>
+  25932     684   17016   43632    aa70 intr0<br>
+  25824     684   17112   43620    aa64 kalarm0<br>
+  24728     684   16956   42368    a580 kcache1<br>
+  25168     684   19512   45364    b134 kcache2<br>
+  28112     688   17168   45968    b390 kclock0<br>
+  25976     688   19524   46188    b46c kclock1<br>
+  26372     684   19512   46568    b5e8 kexcept1<br>
+  25140     684   16968   42792    a728 kflag0<br>
+  29824     688   24660   55172    d784 kflag1<br>
+  26896     704   24656   52256    cc20 kill<br>
+  26088     684   17028   43800    ab18 kintr0<br>
+  30812     692   22176   53680    d1b0 klock<br>
+  28504     688   22260   51452    c8fc kmbox1<br>
+  24984     684   16984   42652    a69c kmutex0<br>
+  26504     692   24704   51900    cabc kmutex1<br>
+  28792     900   34892   64584    fc48 kmutex3<br>
+  29264     796   34896   64956    fdbc kmutex4<br>
+  25240     684   22084   48008    bb88 ksched1<br>
+  25044     684   16968   42696    a6c8 ksem0<br>
+  26988     688   22100   49776    c270 ksem1<br>
+  25028     684   19512   45224    b0a8 kthread0<br>
+  25996     684   22080   48760    be78 kthread1<br>
+  28552     700   22252   51504    c930 mbox1<br>
+  31324     696   22612   54632    d568 mqueue1<br>
+  25108     692   16980   42780    a71c mutex0<br>
+  26464     704   24700   51868    ca9c mutex1<br>
+  27624     696   27280   55600    d930 mutex2<br>
+  28596     908   34884   64388    fb84 mutex3<br>
+  26156     696   22100   48952    bf38 release<br>
+  25460     688   22084   48232    bc68 sched1<br>
+  56356     828   45892  103076   192a4 stress_threads<br>
+  27900     712   27288   55900    da5c sync2<br>
+  26760     700   24692   52152    cbb8 sync3<br>
+  24924     684   19356   44964    afa4 thread0<br>
+  25868     684   22084   48636    bdfc thread1<br>
+  27452     700   24680   52832    ce60 thread2<br>
+  26136     688   42704   69528   10f98 thread_gdb<br>
+  27212     692   34916   62820    f564 timeslice<br>
+  52728     700  123332  176760   2b278 tm_basic<br>
+</code>
+
 
 
 <a name="nextgen"/>
diff --git a/zpu/roadshow/roadshow/codesize/index.html b/zpu/roadshow/roadshow/codesize/index.html
deleted file mode 100644
index 3f61b4e..0000000
--- a/zpu/roadshow/roadshow/codesize/index.html
+++ /dev/null
@@ -1,58 +0,0 @@
-<html>
-<body>
-<h1>Compiling hello world program with the ZPU GCC toolchain</h1>
-The ZPU comes with a standard GCC toolchain and an instruction set simulator. This allows compiling, running & debugging simple test programs. The Simulator has 
-some very basic peripherals defined: counter, timer interrupt and a debug output port. 
-<h1>Installation</h1>
-<ol>
-<li>Install Cygwin. http://www.cygwin.com 
-<li>Start Cygwin bash
-<li>unzip zputoolchain.zip
-<li>Add install/bin from zputoolchain.zip to PATH.<br>
-export PATH=$PATH:<unzipdir>/install/bin
-</ol>
-<h1>Hello world example</h1>
-The ZPU toolchain comes with newlib & libstdc++ support which means that many C/C++ programs can be compiled without modification.
-<p> 
-<code>
-zpu-elf-gcc -Os -zeta hello.c -o hello.elf -Wl,--relax -Wl,--gc-sections<br>
-zpu-elf-size hello.elf<br>
-</code>
-<h1>Optimizing for size</h1>
-The ZPU toolchain produces highly compact code.  
-<ol>
-<li>Since the ZPU GCC toolchain supports standard ANSI C, it is easy to stumble across
-functionality that takes up a lot of space. E.g. the standard printf() function is a beast. Some compilers drop e.g. floating point support
-from the printf() function and thus boast a "smaller" printf() when in fact they have a non-standard printf(). newlib has a standard printf() function
-and an alternative iprintf() function that works only on integers.
-<li>The ZPU ships with default startup code that works across various configurations of the ZPU, so be warned that there is some overhead that will
-not occurr in the final application(anywhere between 1-4kBytes).
-<li>Compilation and linker options matter. The ZPU benefits greatly from the "-Wl,--relax -Wl,--gc-sections" options which is not used by
-all architectures(e.g. GCC ARM does not implement/need -Wl,--relax).  
-</ol> 
-<h2>Small code example</h2>
-<code>
-zpu-elf-gcc -Os -abel smallstd.c -o smallstd.elf -Wl,--relax -Wl,--gc-sections<br>
-zpu-elf-size small.elf<br>
-<br>
-$ zpu-elf-size small.elf<br>
-   text    data     bss     dec     hex filename<br>
-   2845     952      36    3833     ef9 small.elf<br>
-<br>
-</code>
-
-<h2>Even smaller code example</h2>
-If the ZPU implements the optional instructions, the RAM overhead can be reduced significantly.
-<p>
-<code>
-zpu-elf-gcc -Os -abel crt0_phi.S small.c -o small.elf -Wl,--relax -Wl,--gc-sections -nostdlib <br>
-zpu-elf-size small.elf<br>
-<br>
-$ zpu-elf-size small.elf<br>
-   text    data     bss     dec     hex filename<br>
-     56       8       0      64      40 small.elf<br>
-     <br>
-</code>
-
-</body>
-</html>
diff --git a/zpu/roadshow/roadshow/ecos/index.html b/zpu/roadshow/roadshow/ecos/index.html
deleted file mode 100644
index 5245459..0000000
--- a/zpu/roadshow/roadshow/ecos/index.html
+++ /dev/null
@@ -1,145 +0,0 @@
-<html>
-<body>
-<h1>Installing eCos build tools</h1>
-<code>
-tar -xjvf ecossnapshot.tar.bz2<br>
-tar -xjvf repository.tar.bz2<br>
-tar -xjvf ecostools.tar.bz2<br>
-# run this every time you open the shell<br>
-export PATH=$PATH:`pwd`/ecos-install<br>
-export ECOS_REPOSITORY=`pwd`/ecos/packages:`pwd`/repository<br>
-</code>
-<h1>Compiling eCos tests</h1>
-<code>
-ecosconfig new zeta default<br>
-ecosconfig tree<br>
-make<br>
-cd kernel/current<br>
-make tests<br>
-</code>
-
-<h1>Code size ZPU</h1>
-<code>
-$ zpu-elf-size *<br>
-   text    data     bss     dec     hex filename<br>
-  15761    1504   12060   29325    728d bin_sem0<br>
-  16907    1512   14436   32855    8057 bin_sem1<br>
-  17105    1524   30032   48661    be15 bin_sem2<br>
-  17186    1512   14436   33134    816e bin_sem3<br>
-  18986    1500   12036   32522    7f0a clock0<br>
-  15812    1504   13236   30552    7758 clock1<br>
-  25095    1972   13224   40291    9d63 clockcnv<br>
-  16437    1500   13224   31161    79b9 clocktruth<br>
-  15762    1504   12060   29326    728e cnt_sem0<br>
-  17124    1512   14436   33072    8130 cnt_sem1<br>
-  35947    1564   22512   60023    ea77 dhrystone<br>
-  16428    1500   13228   31156    79b4 except1<br>
-  15751    1504   12052   29307    727b flag0<br>
-  19145    1512   15624   36281    8db9 flag1<br>
-  20053    1516  102908  124477   1e63d fptest<br>
-  15998    1496   12092   29586    7392 intr0<br>
-  16080    1496   12200   29776    7450 kalarm0<br>
-  15327    1496   12036   28859    70bb kcache1<br>
-  15549    1496   13224   30269    763d kcache2<br>
-  18291    1500   12260   32051    7d33 kclock0<br>
-  16231    1500   13232   30963    78f3 kclock1<br>
-  16572    1496   13228   31296    7a40 kexcept1<br>
-  15618    1496   12060   29174    71f6 kflag0<br>
-  19287    1500   15624   36411    8e3b kflag1<br>
-  16887    1516   15628   34031    84ef kill<br>
-  16186    1496   12128   29810    7472 kintr0<br>
-  19724    1504   14516   35744    8ba0 klock<br>
-  18283    1500   14592   34375    8647 kmbox1<br>
-  15539    1496   12064   29099    71ab kmutex0<br>
-  16524    1504   15664   33692    839c kmutex1<br>
-  18272    1712   20348   40332    9d8c kmutex3<br>
-  18682    1608   20352   40642    9ec2 kmutex4<br>
-  15619    1496   14412   31527    7b27 ksched1<br>
-  15567    1496   12060   29123    71c3 ksem0<br>
-  17063    1500   14436   32999    80e7 ksem1<br>
-  15504    1496   13228   30228    7614 kthread0<br>
-  16167    1496   14412   32075    7d4b kthread1<br>
-  18281    1512   14580   34373    8645 mbox1<br>
-  20611    1508   14940   37059    90c3 mqueue1<br>
-  15672    1504   12064   29240    7238 mutex0<br>
-  16678    1516   15664   33858    8442 mutex1<br>
-  17694    1508   16868   36070    8ce6 mutex2<br>
-  18203    1720   20344   40267    9d4b mutex3<br>
-  16352    1508   14428   32288    7e20 release<br>
-  15890    1500   14412   31802    7c3a sched1<br>
-  44196    1612  286332  332140   5116c stress_threads<br>
-  17891    1524   16864   36279    8db7 sync2<br>
-  16943    1512   15644   34099    8533 sync3<br>
-  15467    1496   13064   30027    754b thread0<br>
-  16134    1496   14420   32050    7d32 thread1<br>
-  17560    1512   15636   34708    8794 thread2<br>
-  16279    1500   24028   41807    a34f thread_gdb<br>
-  17051    1504   20376   38931    9813 timeslice<br>
-  17146    1504   21564   40214    9d16 timeslice2<br>
-  37313    1512  422380  461205   70995 tm_basic<br>
-</code>
-<h2>Code size ARM (non-thumb)</h2>
-Thumb does not compile out of the box w/AT91 EB40a for which this test was made.<p>
-<code>
-$ arm-elf-size *<br>
-   text    data     bss     dec     hex filename<br>
-  25204     692   16976   42872    a778 bin_sem0<br>
-  26644     700   22096   49440    c120 bin_sem1<br>
-  26996     712   55584   83292   1455c bin_sem2<br>
-  27008     700   22100   49808    c290 bin_sem3<br>
-  28992     688   16944   46624    b620 clock0<br>
-  25456     692   19532   45680    b270 clock1<br>
-  34572    1160   19520   55252    d7d4 clockcnv<br>
-  26224     688   19508   46420    b554 clocktruth<br>
-  25204     692   16976   42872    a778 cnt_sem0<br>
-  26888     700   22108   49696    c220 cnt_sem1<br>
-  44180     752   27416   72348   11a9c dhrystone<br>
-  26088     688   19520   46296    b4d8 except1<br>
-  25236     692   16968   42896    a790 flag0<br>
-  29532     700   24668   54900    d674 flag1<br>
-  29508     704  109652  139864   22258 fptest<br>
-  25932     684   17016   43632    aa70 intr0<br>
-  25824     684   17112   43620    aa64 kalarm0<br>
-  24728     684   16956   42368    a580 kcache1<br>
-  25168     684   19512   45364    b134 kcache2<br>
-  28112     688   17168   45968    b390 kclock0<br>
-  25976     688   19524   46188    b46c kclock1<br>
-  26372     684   19512   46568    b5e8 kexcept1<br>
-  25140     684   16968   42792    a728 kflag0<br>
-  29824     688   24660   55172    d784 kflag1<br>
-  26896     704   24656   52256    cc20 kill<br>
-  26088     684   17028   43800    ab18 kintr0<br>
-  30812     692   22176   53680    d1b0 klock<br>
-  28504     688   22260   51452    c8fc kmbox1<br>
-  24984     684   16984   42652    a69c kmutex0<br>
-  26504     692   24704   51900    cabc kmutex1<br>
-  28792     900   34892   64584    fc48 kmutex3<br>
-  29264     796   34896   64956    fdbc kmutex4<br>
-  25240     684   22084   48008    bb88 ksched1<br>
-  25044     684   16968   42696    a6c8 ksem0<br>
-  26988     688   22100   49776    c270 ksem1<br>
-  25028     684   19512   45224    b0a8 kthread0<br>
-  25996     684   22080   48760    be78 kthread1<br>
-  28552     700   22252   51504    c930 mbox1<br>
-  31324     696   22612   54632    d568 mqueue1<br>
-  25108     692   16980   42780    a71c mutex0<br>
-  26464     704   24700   51868    ca9c mutex1<br>
-  27624     696   27280   55600    d930 mutex2<br>
-  28596     908   34884   64388    fb84 mutex3<br>
-  26156     696   22100   48952    bf38 release<br>
-  25460     688   22084   48232    bc68 sched1<br>
-  56356     828   45892  103076   192a4 stress_threads<br>
-  27900     712   27288   55900    da5c sync2<br>
-  26760     700   24692   52152    cbb8 sync3<br>
-  24924     684   19356   44964    afa4 thread0<br>
-  25868     684   22084   48636    bdfc thread1<br>
-  27452     700   24680   52832    ce60 thread2<br>
-  26136     688   42704   69528   10f98 thread_gdb<br>
-  27212     692   34916   62820    f564 timeslice<br>
-  52728     700  123332  176760   2b278 tm_basic<br>
-</code>
-
-</body>
-</html>
-
-