view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    other versions should work without tracing or with minor editing.

INSTALLATION

    *   Download the latest package from http://www.veripool.org/systemperl
        or CPAN and decompress.

          gunzip SystemPerl_version.tar.gz ; tar xvf SystemPerl_version.tar}

    *   cd to the directory containing this README notice. Some files will
        permanently live in this directory, so make sure it's in a site wide
        area.

          cd SystemPerl*

    *   Make sure the "SYSTEMC" environment variable points to your SystemC
        installed directory; or that "SYSTEMC_INCLUDE" points to the include
        directory with systemc.h in it, and that "SYSTEMC_LIBDIR" points to
        the directory with libsystemc.a in it. If using bash, this would
        consist of the line

            export SYSTEMC=/path/to/systemc
            export SYSTEMC_INCLUDE=/path/to/systemc/include   # with systemc.h
            export SYSTEMC_LIBDIR=/path/to/systemc/lib    # with libsystemc.a

        in your "~/.bashrc" file.

        If different than the above, make sure the "SYSTEMC_KIT" environment
        variable points to your original SystemC source code kit.

        Type "perl Makefile.PL" to configure SystemPerl for your system.

        You may get a warning message about needing Verilog::Netlist, if so
        you need to install or upgrade the "verilog-perl" package from CPAN.

    *   Type "make" to compile SystemPerl.

        If you get a error message ``y.tab.c: error: parse error before
        goto,'' there is a problem between Bison and GCC. The simplest fix
        is to edit y.tab.c to comment out ``__attribute__ ((unused))''.

    *   Type "make test" to check the compilation.

    *   You can see examples under the test_dir directory. The *.sp files
        are "inline" converted, while the *.h and *.cpp files are expanded
        from the .sp files.

    *   Type "make install" to install the programs and any data files and
        documentation.

    *   Add a "SYSTEMPERL" environment variable that points to the directory
        of this kit (the directory you typed ``make install'' inside, not
        your site-perl directory.) If using bash, this would consist of the
        line

          export SYSTEMPERL=/path/to/systemperl

        in your "~/.bashrc" file.

    *   Optionally add a "SYSTEMPERL_INCLUDE" environment variable if for
        some reason you wish to relocate the include files (the files under
        the kit's src directory). For example distributions often want to
        relocate the SystemPerl includes into the standard system include
        directory. Note that these files are not installed with "make
        install" (as Perl doesn't provide a standard way to install
        includes), which is why SYSTEMPERL or SYSTEMPERL_INCLUDE must point
        to them.

DISTRIBUTION

    SystemPerl is part of the <http://www.veripool.org/> free SystemC
    software tool suite. The latest version is available from CPAN and from
    <http://www.veripool.org/systemperl>.

    Copyright 2001-2014 by Wilson Snyder. This package is free software; you
    can redistribute it and/or modify it under the terms of either the GNU
    Lesser General Public License Version 3 or the Perl Artistic License
    Version 2.0.

    This code is provided with no warranty of any kind, and is used entirely
    at your own risk.

AUTHORS

    Wilson Snyder <wsnyder@wsnyder.org>.

SEE ALSO

  Primary Documentation:

    SystemC::Manual (This document)

  Language Documentation:

    SystemC::SystemPerl

  Programs:

    sp_includer, sp_makecheck, sp_preproc

  Major modules:

    SystemC::Netlist, SystemC::Parser

  Submodules:

    SystemC::Coverage SystemC::Coverage::Item SystemC::Coverage::ItemKey

    SystemC::Netlist SystemC::Netlist::AutoCover SystemC::Netlist::AutoTrace
    SystemC::Netlist::Cell SystemC::Netlist::Class
    SystemC::Netlist::CoverGroup SystemC::Netlist::CoverPoint
    SystemC::Netlist::File SystemC::Netlist::Method SystemC::Netlist::Module
    SystemC::Netlist::Net SystemC::Netlist::Pin SystemC::Netlist::Port

    Verilog::Netlist