SystemC met Eclipse

Deze pagina is bestemd voor studenten van de Haagse Hogeschool - Academie voor Technology, Innovation & Society Delft groep E-EMSYS = minor Embedded Systems.

Downloaden

Eclipse IDE for C/C++ Developers: http://www.eclipse.org/downloads/.
GTKWave Viewer exe: http://www.dspia.com/gtkwave.exe.gz en GTKWave DLL's: http://www.dspia.com/libs.tar.gz.
SystemC 2.2.0: http://www.systemc.org/downloads/standards/.
Cygwin: http://www.cygwin.com/
Make: http://www.cmake.org/files/cygwin/make.exe

Installeren

Eclipse: uitpakken onder C:\
GTKWave.exe.gz en libs.tar.gz uitpakken in dezelfde map.
SystemC 2.2.0: uitpakken onder C:\
Cygwin: Installeer de packages Base, Devel en Libs.
Make: overschrijf C:\cygwin\bin\make.exe

Compileren van de library libsystemc.a met behulp van Cygwin

Edit de file C:\systemc-2.2.0\src\systemc.h regel 175 t/m 177:

    using std::wctomb;
    using std::mbstowcs;
    using std::wcstombs;

moeten gewijzigd worden in:

#if !defined(__CYGWIN__)
    using std::wctomb;
    using std::mbstowcs;
    using std::wcstombs;
#endif

Edit de file C:\systemc-2.2.0\src\sysc\utils\sc_utils_ids.cpp regel 61:
```
#include "sysc/utils/sc_report.h"
```
na deze regel moet toegevoegd worden:
```
#include <cstdlib>
#include <cstring>
```
Open de Cygwin Bash Shell en voer de volgende commando's uit
- cd /cygdrive/c/systemc-2.2.0
- mkdir objdir
- cd objdir
- ../configure
- make pthreads
- make pthreads install

Compileren en uitvoeren van een SystemC programma met Eclipse

Start Eclipse en kies menu File => New => C++ Project
Kies Empty Project en type een naam voor het project.
Klik Next.
Selecteer Debug.
Klik Finish.
Kies menu File => New => Source File.
Type een naam voor de cpp file. Vergeet niet om de extensie .cpp ook in te typen.
Kies menu Project => Properties.
Kies voor C/C++ Build => Settings => Tool Settings => Cygwin C++ Compiler => Directories en vul in: "C:\systemc-2.2.0\include"
Kies voor C/C++ Build => Settings => Tool Settings => Cygwin C++ Linker => Libraries en vul in: systemc en "C:\systemc-2.2.0\lib-cygwin"

Type nu het volgende SystemC programma in:

#include <systemc>

using namespace sc_core;
using namespace sc_dt;
using namespace std;

/* Simple DFF */

SC_MODULE(dff) {
   sc_in_clk clk;
   sc_in<sc_logic> din;
   sc_out<sc_logic> dout;
   SC_CTOR(dff) {
      SC_METHOD(on_clk_neg);
      sensitive << clk.neg();
   }
private:
   void on_clk_neg() {
      dout->write(din->read());
   }
};

SC_MODULE(tb_dff) {
   sc_clock clk;
   sc_signal<sc_logic> din;
   sc_signal<sc_logic> dout;
   SC_CTOR(tb_dff):
         clk("clk",10,SC_NS,0.5), DUT("dff") {
      DUT.din(din);
      DUT.dout(dout);
      DUT.clk(clk);
      SC_THREAD(main);
   }
private:
   dff DUT;
   void main() {
      din.write(SC_LOGIC_0);
      wait(31, SC_NS);
      din.write(SC_LOGIC_1);
      wait(42, SC_NS);
      din.write(SC_LOGIC_0);
   }
};

int sc_main(int argc, char* argv[]) {
   tb_dff TB("tb_dff");

   sc_trace_file *tf(sc_create_vcd_trace_file("trace"));
   tf->set_time_unit(1, SC_NS);
   sc_trace(tf, TB.clk, "clk");
   sc_trace(tf, TB.din, "din");
   sc_trace(tf, TB.dout, "dout");

   sc_start(100, SC_NS);

   sc_close_vcd_trace_file(tf);
   return 0;
}

Kies menu Project => Build Project.
Als het goed is dan verschijnt in het console window de volgende tekst.

**** Build of configuration Debug for project testDDF ****

make all 
Building file: ../main.cpp
Invoking: Cygwin C++ Compiler
g++ -I"C:\systemc-2.2.0\include" -O0 -g3 -Wall -c -fmessage-length=0 -MMD -MP -MF"main.d" -MT"main.d" -o"main.o" "../main.cpp"
Finished building: ../main.cpp
 
Building target: testDDF.exe
Invoking: Cygwin C++ Linker
g++ -L"C:\systemc-2.2.0\lib-cygwin" -o"testDDF.exe"  ./main.o   -lsystemc
Finished building target: testDDF.exe

Kies menu Run => Run Configurations...
Klik op het tabblad Environment.
Klik op de New... button.
Vul bij name in PATH en vul bij value in c:\cygwin\bin
Kies menu Run => Run Als het goed is verschijnt de volgende boodschap in het console window.
Het programma heeft het bestand trace.vcd aangemaakt in het directory van het project. Je kunt dit ook zien in de Project Explorer.
Open deze file met de GTKWave viewer door er dubbel op te klikken. (Dit werkt alleen als je in Windows Explorer de extensie .vcd gekoppeld hebt aan de GTKWave viewer.)
Door te dubbelklikken op het SystemC mapje kan je de beschikbare signalen zien. Klik op insert om een signaal te bekijken.

Problemen

Ik krijg de warnings (beide verschijnen 2x):
Error launching external scanner info generator (g++ -E -P -v -dD C:/workspace/.metadata/.plugins/org.eclipse.cdt.make.core/specs.cpp) Error launching external scanner info generator (gcc -E -P -v -dD C:/workspace/.metadata/.plugins/org.eclipse.cdt.make.core/specs.c)Dit heeft misschien iets te maken met de PATH environmentvariabele maar op dit moment kan deze warnings niet verklaren.

Warning in C:\systemc-2.2.0\include\sysc\datatypes\bit\sc_lv_base.h kun je voorkomen door regel 309 en 310:

    return sc_logic_value_t( m_data[wi] >> bi & SC_DIGIT_ONE |
                m_ctrl[wi] >> bi << 1 & SC_DIGIT_TWO );

Te vervangen door:

    return sc_logic_value_t( (m_data[wi] >> bi & SC_DIGIT_ONE) |
                (m_ctrl[wi] >> bi << 1 & SC_DIGIT_TWO) );