Skip to Content
Last modified by Alexander Schulz-Rosengarten on 2023/09/11 16:17
From version 36.1
edited by cmot
on 2014/06/28 13:47
Change comment: There is no comment for this version
To version 15.1
edited by cmot
on 2014/02/10 21:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,7 +1,9 @@
1 -= Modeling SCCharts with KIELER – PLDI'14 Artifact =
1 +[[image:attach:title7.png]]
2 2  
3 -This tutorial should guide you if you like to model SCCharts with KIELER and use the circuit based software synthesis path as explained in our [1] [[PLDI'14 submission>>url:http://rtsys.informatik.uni-kiel.de/%7Ebiblio/downloads/papers/pldi14-submitted.pdf||shape="rect"]]. We will show you how to
3 += Modeling SCCharts with KIELER =
4 4  
5 +This tutorial should guide you if you like to model SCCharts with KIELER and use the circuit based software synthesis path as explained in our [1] [[PLDI'14 submission>>url:http://rtsys.informatik.uni-kiel.de/~~biblio/downloads/papers/pldi14.pdf||shape="rect"]]. We will show you how to
6 +
5 5  ~1. Download & Start KIELER,
6 6  
7 7  2. Model an SCChart, and
... ... @@ -8,29 +8,19 @@
8 8  
9 9  3. Generate C Code.
10 10  
11 -We will use a simple example here in order to illustrate the process. Please refer to the SCCharts superpage for the [[project status>>doc:SCCharts]] and [[known limitations>>doc:SCCharts]]. If you are interested in the source code you can find instruction how to download and compile it here: [[Getting Started>>url:http://rtsys.informatik.uni-kiel.de/confluence/display/KIELER/Getting+Started||shape="rect"]].
13 +We will use a simple example here in order to illustrate the process. It should be straightforward to use these instructions in order to compile a more advanced SCChart. Note that there are known minor bugs in the current nightly build that will be fixed in the next release of KIELER 0.10.0. These bugs might in some cases prevent you from compiling more elaborate examples.
12 12  
13 -See a list of the evaluated examples at the end.
14 -
15 15  
16 16  
17 -[1] PLDI submission: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~biblio/downloads/papers/pldi14-submitted.pdf>>url:http://rtsys.informatik.uni-kiel.de/%7Ebiblio/downloads/papers/pldi14-submitted.pdf||shape="rect"]]
17 +[1] PLDI submission: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~biblio/downloads/papers/pldi14.pdf>>url:http://rtsys.informatik.uni-kiel.de/%7Ebiblio/downloads/papers/pldi14.pdf||shape="rect" class="moz-txt-link-freetext"]]
18 18  
19 -
19 += Download & Start KIELER =
20 20  
21 -In addition to the step-by-step tutorial below we also captured a [[video >>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/sccharts.swf||shape="rect"]]that shows each of the explained steps:
22 -
23 -[[~[~[image:attach:RTEmagicC_demo.png.png~]~]>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/sccharts.swf||shape="rect"]]
24 -
25 -Download location: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/files/pldi14/sccharts.swf>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/sccharts.swf||shape="rect"]]
26 -
27 -= 1. Download & Start KIELER =
28 -
29 29  [[Download>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]] a suitable KIELER version for your operation system. The zip bundles are fully compiled and ready-to-run, they do not need any further installation process. Just save and extract them to/at the location of your choice and start the KIELER executable.
30 30  
31 31  [[~[~[image:attach:RTEmagicC_download.png.png~]~]>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
32 32  
33 -Download location: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/files/pldi14/>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
25 +Download Location: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/files/pldi14/>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
34 34  
35 35  When you start the KIELER executable, you probably need to set a (new) workspace location of your choice. (Click on the images to enlarge them).
36 36  
... ... @@ -58,14 +58,70 @@
58 58  
59 59  Now you can proceed in modeling an SCChart as explained below.
60 60  
61 -= 2. + 3. Model and Compile an SCChart =
53 += Model an SCChart =
62 62  
63 -We have moved the guide that shows how to model and compile an SCChart within KIELER to a new [[doc:Quick Start Guide]]. Be advised that in order to follow all explanations there may require the latest version of KIELER not the (possibly outdated) PLDI-Artifact.
55 +Right-click on a project and create a (text) File:
64 64  
65 -
57 +[[image:attach:kieler08.png]]
66 66  
67 -= 4. Evaluated Examples =
59 +Name it abo.sct:
68 68  
69 -In the following, you find the examples used for evaluation. Be advised that there currently is no tool integrated evaluation possible. Please refer to the SCCharts superpage for the [[project status>>doc:SCCharts]] and [[known limitations>>doc:SCCharts]].
61 +[[image:attach:kieler09.png]]
70 70  
71 -Find the list of Examples used for evaluation [[here>>doc:Examples]].
63 +The textual SCCharts Xtext based editor (for *.sct files) will automatically be opened:
64 +
65 +[[image:attach:kieler10.png]]
66 +
67 +Now start modeling an SCChart. For example copy & paste the following sct code of abo, the hello world of SCCharts:
68 +
69 +{{code title="abo.sct"}}
70 +@VHLayout
71 +scchart ABO {
72 + input output bool A;
73 + input output bool B;
74 + output bool O1;
75 + output bool O2;
76 + region:
77 +
78 + initial state Init
79 + --> WaitAB immediate with / O1 = false; O2 = false;
80 + state WaitAB {
81 + region HandleA:
82 + initial state WaitA
83 + --> DoneA immediate with A / B = true; O1 = true;
84 + final state DoneA;
85 + region HandleB:
86 + initial state WaitB
87 + --> DoneB with B / O1 = true;
88 + final state DoneB;
89 + }
90 + >-> GotAB with / O1 = false; O2 = true;
91 + state GotAB;
92 +}
93 +{{/code}}
94 +
95 +As you save (Ctrl+S), KIELER will automatically draw the graphical SCChart diagram in a new KLigD view:
96 +
97 +[[image:attach:kieler11.png]]
98 +
99 +You may want to re-arrange views. Just drag the KLighD view to the right side:
100 +
101 +[[image:attach:kieler12.png]]
102 +
103 +You will now see how to generate a C tick function.
104 +
105 += Generate C Code =
106 +
107 +You can do several transformations on SCCharts (*.sct files). Just right click the file you want to transform in the project explorer and select the Transform SCChart sub menu. As abo is already a Core SCCart you do not need the core transformations. Click the All Normalize Transformations, this will do the Split Trigger and Effects and the Surface and Depth transformations together (in this order).
108 +
109 +[[image:attach:kieler13.png]]
110 +
111 +After performing a transformation the transformed SCChart will open (together with it's KLighD diagram visualization):
112 +
113 +[[image:attach:kieler14.png]]
114 +
115 +Now generate the Sequentially Constructive Graph (SCG) from the normalized form. You do this also in the context menu of the Project Explorer
116 +
117 +
118 +
119 +
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -9471488
1 +8651727
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471488/PLDI'14 Artifact on SCCharts
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/8651727/PLDI'14 Artifact on SCCharts