Procedura installazione ambiente di sviluppo RTEMS 4.5.0 per Windows
====================================================================

Il nostro CD etichettato RTEMS450-01 é cosí composto:

 root +
      |
      + cygwin		= environment GNU per Windows.
      + rtems-4.5.0  	= sorgenti RTOS RTEMS 4.5.0.


Installazione environment GNU per Windows Cygwin
================================================

Per semplificare le operazioni di installazione ho preferito eseguire
parte delle operazioni di installazione utilizzando una sessione DOS.

001) avviare una sessione DOS.

002) porsi sulla directory di installazione del Cygwin.
     
     	<cd_name>: <cr>
	cd \cygwin <cr>

003) avviare il programma di installazione.

	setup.exe <cr>	

004) alla comparsa della dialog di impostazione :

	premere bottone "next"
	segliere "install from local Directory"
        premere bottone "next"
	premere bottone "next"
	impostare la root directory a "c:/bin/cygwin"
	impostare "unix"
	impostare "all"
	premere bottone "next"
	premere bottone "next"
  	
     A questo punto l'installazione dei file comincia.
     A termine della copia file :

	deselezionare "add to start menu"
        premere bottone "next"
	premere bottone "ok"
 
Il programma di installazione ha cosí terminato e crea un'icona
sul desktop che avvia l'environment Cygwin con un nome utente
determinato dalle impostazione nome utente di Windows.

Nel mio caso ha creato un utente chiamato SILVERIO_DIQUIGIOVANNI
e la conseguente directory /home/SILVERIO_DIQUIGIOVANNI/

D'ora in poi sostuiró tale nome utente con <user_home> al fine
di rendere la descrizione piú portabile possibile.

In questa fase sono peró stati installati solo i pacchetti correnti
e non quelli sperimentali. Perció bisognerá ripetere l'operazione
di installazione specificando il desiderio di installare i pacchetti
sperimentali.

005) riavviare il programma di installazione.

	setup.exe <cr>	

006) alla comparsa della dialog di impostazione :

	premere bottone "next"
	segliere "install from local Directory"
        premere bottone "next"
	premere bottone "next"
	impostare la root directory a "c:/bin/cygwin"
	impostare "unix"
	impostare "all"
	premere bottone "next"
	segliere "Exp"
	premere bottone "next"
  	
     A questo punto l'installazione dei file comincia.
     A termine della copia file :

	deselezionare "add to start menu"
        premere bottone "next"
	premere bottone "ok"

005) Chiudere la sessione DOS:

     exit <cr>


Verifica dei pacchetti Cygwin primari installati
================================================

Ora provvederemo a testare la funzionalitá dei alcuni pacchetti
necessari per la realizzazione dell'ambiente di sviluppo RTEMS.

001) Avviare l'environment Cygwin tramite l'apposita icona sul
     desktop.

002) Verificare i singoli pacchetti:

     automake --version <cr>
     autoconf --version <cr>
     perl --version <cr>
     make --version <cr>

     Come risultato otterremo i seguenti valori:

     automake	= 1.4
     autoconf	= 2.13
     perl	= 5.6.1
     make	= 3.79.1


Installazione gestore pachetti RPM per Cygwin
=============================================

Per semplificare le operazioni di realizzazione dell'environment
RTEMS ho preferito utilizzare la tool-chain giá precompilata in
formato RPM. A tale proposito bisogna innanzitutto installare il
gestore dei pacchetti RPM, attualmente non incluso tra i programmi
disponibili con Cygwin.

001) Avviare la sessione Cygwin.

002) Porsi sulla root directory:

     cd /

003) Scompattare il pacchetto di RPM:

     cd / <cr>
     cp <cd_name>:/cygwin/rpm-3.0.4-cygwin.tgz / <cr>
     tar -xf rpm-3.0.4-cygwin.tgz <cr>
     rm rpm-3.0.4-cygwin.tgz <cr>

004) Inizializzazione gestore pacchetti RPM:

     rpm --initdb <cr>


Installazione pachetti RPM per RTEMS 4.5.0 su micro Hitachi SH
==============================================================

001) Intallazione pacchetti RTEMS:

     cd / <cr>
     cp <cd_name>:/rtems-4.5.0/cygwin-rpms/* / <cr>
     rpm -i --nodeps --ignoreos rtems-base-binutils-2.9.5.0.24-1.i386.rpm <cr>
     rpm -i --nodeps --ignoreos rtems-base-gcc-gcc2.95.2newlib1.8.2-7.i386.rpm <cr>
     rpm -i --nodeps --ignoreos rtems-base-gdb-4.18-4.i386.rpm <cr>
     rpm -i --nodeps --ignoreos sh-rtems-binutils-2.9.5.0.24-1.i386.rpm <cr>
     rpm -i --nodeps --ignoreos sh-rtems-gcc-gcc2.95.2newlib1.8.2-7.i386.rpm <cr>
     rpm -i --nodeps --ignoreos sh-rtems-gdb-4.18-4.i386.rpm <cr>
     rm *rpm <cr>


     P.S: durante l'installazione dei pacchetti compaiono molteplici
          volte le scritte:
 	  
              user administrator does not exist - using root
              group None does not exist - using root
 
          le quale sono da ignorare !!!!

002) Chiudere la sessione Cygwin:

     exit <cr>

003) Configurare l'environment Cygwin per tool-chain RTEMS tramite
     la creazione di un file testo in formato Unix contenente le
     seguenti linee di codice e memorizzato in <user_home> sotto il
     nome di .bashrc:

#
# RTEMS environment
#

# Visibility to egcs binary for sh processors

export PATH=$PATH:/opt/rtems/bin

004) Avviare l'environment Cygwin tramite l'apposita icona sul
     desktop.

005) Verificare i singoli pacchetti:

     sh-rtems-gcc --version <cr>
     sh-rtems-as --version <cr>
     sh-rtems-ld --version <cr>
     sh-rtems-gdb --version <cr>

     Come risultato otterremo i seguenti valori:

     sh-rtems-gcc = 2.9.5
     sh-rtems-as  = 2.9.5
     sh-rtems-ld  = 2.9.5
     sh-rtems-gdb = 4.18


Realizzazione sistema operativo RTEMS per SH
============================================

ln -s /bin/gcc.exe /bin/cc.exe <cr>
cd /<user_home> <cr>
mkdir rtems-4.5.0 <cr>
mkdir rtems-4.5.0/build <cr> 
mkdir rtems-4.5.0/build/sh-rtems-01 <cr>
mkdir rtems-4.5.0/source <cr>
cd rtems-4.5.0/source <cr>
cp c:/usr/archive/rtems-4.5.0/rtems-4.5.0.tgz rtems-4.5.0.tgz <cr>
tar -xzf rtems-4.5.0.tgz <cr>

remove io_types.h from H_FILES & EXTRA_DIST in 
  /<user_home>/rtems-4.5.0/source/rtems-4.5.0/c/src/lib/libcpu/sh/sh7045/Makefile.am

rm rtems-4.5.0.tgz <cr>
cd .. <cr>
cd build/sh-rtems-01 <cr>

../../source/rtems-4.5.0/configure --target=sh-rtems
                                   --prefix=/home/SILVERIO_DIQUIGIOVANNI/rtems-4.5.0/sh-rtems-01/
                                   --disable-multiprocessing
                                   --disable-posix
                                   --disable-itron
                                   --disable-networking
                                   --disable-rdbg
                                   --disable-cxx
                                   --disable-tests <cr>

make all install <cr>