# $Author$ : $RCSfile$
# $Revision$, $Date$



       scade2brick -- Prepare C code generated by SCADE for brickOS.
       -------------------------------------------------------------
                            Copyright (C) 2006, Jan Tobias Muehlberg
                                        <muehlber@fh-brandenburg.de>


## Installation

   Requirements

     * gcc and binutils for Hitachi H8/300
     * brickOS 0.2.6 or later (http://brickos.sourceforge.net/)
     * know where your brickOS is installed
     * GnuPG (optional)

   Installing scade2brick

   The following is a step-by-step guide for installing scade2brick
   on a POSIX compliant operating system such as Linux or Windows
   with Cygwin (http://www.cygwin.com/). VER denotes the version number
   of scade2brick you are about to install. Thus, if you are installing
   scade2brick 0.9.1, you will have to download scade2brick-0.9.1.tar.gz.
   Step 2 is optional.

     1) download scade2brick-VER.tar.gz and scade2brick-VER.tar.gz.asc
        (optional) to your current directory

     2) verify the signature (optional)

        $ gpg --recv-key 5BC905EC
        $ gpg scade2brick-VER.tar.gz.asc scade2brick-VER.tar.gz

     3) unpack scade2brick-VER.tar.gz

        $ gunzip -c scade2brick-VER.tar.gz | tar -xv

     4) Change current directory to the scade2brick-VER;
        configure and build scade2brick

        $ cd scade2brick-VER

	The configuration script ./configure requires three parameters:
	 --prefix=...  denotes the path where you want to install
	               scade2brick. You need write permissions to
		       <prefix>/bin and <prefix>/lib
         --include=... specifies the path where the brickOS include
                       files are installed. Usually this is
                       <brickOS-prefix>/include/brickos.
         --lib=...     specifies the path where the brickOS libraries
                       are installed. Usually this is
                       <brickOS-prefix>/lib/brickos.
        Let us assume that you have installed brickOS to /usr, for
        example by using the packages provided by the Debian GNU/Linux
        project.

        $ ./configure --prefix=/usr/local \
                      --include=/usr/include/brickos \
                      --lib=/usr/lib/brickos
        $ make

     5) Install scade2brick (you may have to become a privileged use first)

        $ make install

     6) Done.


## Usage

   Please refer to the project web page at

     http://zeus.fh-brandenburg.de/~muehlber/content/software/scade2brick/


## License

   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License
   as published by the Free Software Foundation; either version 2
   of the License, or any later version.
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
   02110-1301, USA.