Skip to Content
Last modified by Alexander Schulz-Rosengarten on 2023/09/11 16:17
From version 17.1
edited by cmot
on 2014/02/10 21:47
Change comment: There is no comment for this version
To version 27.1
edited by cmot
on 2014/02/11 11:38
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -10,19 +10,27 @@
10 10  
11 11  3. Generate C Code.
12 12  
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.
13 +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]].
14 14  
15 15  
16 16  
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"]]
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.pdf||shape="rect" class="moz-txt-link-freetext"]]
18 18  
19 -= Download & Start KIELER =
19 +
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 +
21 21  [[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.
22 22  
23 23  [[~[~[image:attach:RTEmagicC_download.png.png~]~]>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
24 24  
25 -Download Location: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/files/pldi14/>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
33 +Download location: [[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/files/pldi14/>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/pldi14/||shape="rect"]]
26 26  
27 27  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).
28 28  
... ... @@ -50,7 +50,7 @@
50 50  
51 51  Now you can proceed in modeling an SCChart as explained below.
52 52  
53 -= Model an SCChart =
61 += 2. Model an SCChart =
54 54  
55 55  Right-click on a project and create a (text) File:
56 56  
... ... @@ -60,6 +60,8 @@
60 60  
61 61  [[image:attach:kieler09.png]]
62 62  
71 +SCT is a textual description language for SCCharts. Due to space limitations SCT is not documented in the PLDI paper, but examples can be found [[here>>doc:SCT - Textual Description Language for SCCharts]]. Also the code completion functionality of the textual editor for SCT is very helpful. It can be invoked by pressing <Ctrl> + <Space>. It will list all syntactically possible input according to the SCT/SCCharts meta model.
72 +
63 63  The textual SCCharts Xtext based editor (for *.sct files) will automatically be opened:
64 64  
65 65  [[image:attach:kieler10.png]]
... ... @@ -102,7 +102,7 @@
102 102  
103 103  You will now see how to generate a C tick function.
104 104  
105 -= Generate C Code =
115 += 3. Generate C Code =
106 106  
107 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 108  
... ... @@ -112,54 +112,42 @@
112 112  
113 113  [[image:attach:kieler14.png]]
114 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 by selecting the *.normalized.sct and choosing Generate SCG:
125 +Now generate the Sequentially Constructive Graph (SCG) from the normalized form. You do this also in the context menu of the Project Explorer by selecting the *.normalized.sct and choosing Generate SCG. When selecting the abo.normalized.scg file the SCG diagram will be automatically synthesized (you may also want to re-arrange the KLigD view by dragging in to the right side again).
116 116  
117 -[[image:attach:kieler15.png]]
127 +[[image:attach:kieler15.png]][[image:attach:kieler16.png]]
118 118  
119 -When selecting the abo.normalized.scg file the SCG diagram will be automatically synthesized (you may also want to re-arrange the KLigD view by dragging in to the right side again):
129 +
120 120  
121 -[[image:attach:kieler16.png]]
131 +You can now populate the SCG automatically with dependency data. Choose Transform SCG -> SCG with Dependency Data from the context menu (left side). This will result in the following SCG (right side).
122 122  
123 -You can now populate the SCG automatically with dependency data. Choose Transform SCG -> SCG with Dependency Data from the context menu:
133 +[[image:attach:kieler17.png]][[image:attach:kieler18.png]]
124 124  
125 -[[image:attach:kieler17.png]]
135 +
126 126  
127 -This will result in the following SCG:
137 +Now populate the SCG with basic block information (left side). The SCG with calculated basic blocks will look like this (right side).
128 128  
129 -[[image:attach:kieler18.png]]
139 +[[image:attach:kieler19.png]][[image:attach:kieler20.png]]
130 130  
131 -Now populate the SCG with basic block information:
141 +
132 132  
133 -[[image:attach:kieler19.png]]
143 +The next step in compilation is the (more fine grained) calculate of scheduling blocks (left side). The populated SCG with scheduling information looks like this (right side).
134 134  
135 -The SCG with calculated basic blocks will look like this:
145 +[[image:attach:kieler21.png]][[image:attach:kieler22.png]]
136 136  
137 -[[image:attach:kieler20.png]]
147 +
138 138  
139 -The next step in compilation is the (more fine grained) calculate of scheduling blocks:
149 +The SCG is now ready to be sequentialized. A primitive scheduler currently is included in KIELER but more elaborate ones are already in the pipe line (left side). The sequentialized SCG looks like this (right side).
140 140  
141 -[[image:attach:kieler21.png]]
151 +[[image:attach:kieler23.png]][[image:attach:kieler24.png]]
142 142  
143 -The populated SCG with scheduling information looks like this:
153 +
144 144  
145 -[[image:attach:kieler22.png]]
155 +From here its only a short hop to C code. Transform the sequentialized SCG into an S Tick Function (left side). When opening the S file (abo.normalized.seq.s) this already is very c like code (right side).
146 146  
147 -The SCG is now ready to be sequentialized. A primitive scheduler currently is included in KIELER but more elaborate ones are already in the pipe line:
157 +[[image:attach:kieler25.png]][[image:attach:kieler26.png]]
148 148  
149 -[[image:attach:kieler23.png]]
159 +
150 150  
151 -The sequentialized SCG looks like this:
152 -
153 -[[image:attach:kieler24.png]]
154 -
155 -From here its only a short hop to C code. Transform the sequentialized SCG into an S Tick Function:
156 -
157 -[[image:attach:kieler25.png]]
158 -
159 -When opening the S file (abo.normalized.seq.s) this already is very c like code:
160 -
161 -[[image:attach:kieler26.png]]
162 -
163 163  Selecting Generate SC will produce a C file:
164 164  
165 165  [[image:attach:kieler27.png]][[image:attach:kieler28.png]]
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -8651731
1 +8651749
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/8651731/PLDI'14 Artifact on SCCharts
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/8651749/PLDI'14 Artifact on SCCharts