Changes for page Basic design

Last modified by nfl on 2025/01/30 12:05

From version 19.1
edited by sna
on 2014/08/20 23:21
Change comment: There is no comment for this version
To version 14.1
edited by krat
on 2014/08/11 11:18
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.sna
1 +XWiki.krat
Content
... ... @@ -43,694 +43,894 @@
43 43  
44 44  The train controller is composed of several //Station-2-Station// controllers. These are combined to form a complete schedule. Additionally, the cleanup signal has to be watched to abort the schedule and return back to the initial position.
45 45  
46 -=== Structure ===
46 +== Station-2-Station controller ==
47 47  
48 -{{code linenumbers="true" language="sct"}}
49 -//
50 -// Structure of a train controller based on test case 2
51 -//
52 -scchart Test2 "Test of IC_JCT" {
53 -  // Set of request variables for all tracks for 11 trains
54 - bool IC_JCT_0_req[11], IC_LN_0_req[11], IC_LN_1_req[11], IC_LN_2_req[11];
55 - bool IC_LN_3_req[11], IC_LN_4_req[11], IC_LN_5_req[11], IC_ST_0_req[11];
56 - bool IC_ST_1_req[11], IC_ST_2_req[11], IC_ST_3_req[11], IC_ST_4_req[11];
57 - bool IO_LN_0_req[11], IO_LN_1_req[11], IO_LN_2_req[11], KH_LN_0_req[11];
58 - bool KH_LN_1_req[11], KH_LN_2_req[11], KH_LN_3_req[11], KH_LN_4_req[11];
59 - bool KH_LN_5_req[11], KH_LN_6_req[11], KH_LN_7_req[11], KH_LN_8_req[11];
60 - bool KH_ST_0_req[11], KH_ST_1_req[11], KH_ST_2_req[11], KH_ST_3_req[11];
61 - bool KH_ST_4_req[11], KH_ST_5_req[11], KH_ST_6_req[11], KIO_LN_0_req[11];
62 - bool KIO_LN_1_req[11], OC_JCT_0_req[11], OC_LN_0_req[11], OC_LN_1_req[11];
63 - bool OC_LN_2_req[11], OC_LN_3_req[11], OC_LN_4_req[11], OC_LN_5_req[11];
64 - bool OC_ST_0_req[11], OC_ST_1_req[11], OC_ST_2_req[11], OC_ST_3_req[11];
65 - bool OC_ST_4_req[11], OI_LN_0_req[11], OI_LN_1_req[11], OI_LN_2_req[11];
66 - bool req_in_R, req_out_R, req_in_L, req_out_L;
48 +Each Station-2-Station controller realizes the movement from one of the stations (IC,OC,KH) to another station. All controllers using IC or OC parts have to respect the traveling directions. For the Kicking Horse Pass two separate controllers, forwards and backwards, are used.
67 67  
68 -  // Set of permission variables for all tracks
69 - int IC_JCT_0_perm, IC_LN_0_perm, IC_LN_1_perm, IC_LN_2_perm;
70 - int IC_LN_3_perm, IC_LN_4_perm, IC_LN_5_perm, IC_ST_0_perm;
71 - int IC_ST_1_perm, IC_ST_2_perm, IC_ST_3_perm, IC_ST_4_perm;
72 - int IO_LN_0_perm, IO_LN_1_perm, IO_LN_2_perm, KH_LN_0_perm;
73 - int KH_LN_1_perm, KH_LN_2_perm, KH_LN_3_perm, KH_LN_4_perm;
74 - int KH_LN_5_perm, KH_LN_6_perm, KH_LN_7_perm, KH_LN_8_perm;
75 - int KH_ST_0_perm, KH_ST_1_perm, KH_ST_2_perm, KH_ST_3_perm;
76 - int KH_ST_4_perm, KH_ST_5_perm, KH_ST_6_perm, KIO_LN_0_perm;
77 - int KIO_LN_1_perm, OC_JCT_0_perm, OC_LN_0_perm, OC_LN_1_perm;
78 - int OC_LN_2_perm, OC_LN_3_perm, OC_LN_4_perm, OC_LN_5_perm;
79 - int OC_ST_0_perm, OC_ST_1_perm, OC_ST_2_perm, OC_ST_3_perm;
80 - int OC_ST_4_perm, OI_LN_0_perm, OI_LN_1_perm, OI_LN_2_perm;
81 -  bool perm_in_R, perm_out_R, perm_in_L, perm_out_L;
82 -
83 - // Debug flag for additional output
84 - bool debug = false;
85 - // Cleanup flag for halting the trains at home station tracks
86 -  bool cleanup = false;
87 -  // Variable, that gives the number of trains to C-Controller for stability check
88 - int trainCount;
89 -
90 - // Set of constants for binding to referenced SCCharts
91 - const int c_EINS = 1;
92 - const int c_ZWEI = 2;
93 - const int c_DREI = 3;
94 - const int c_VIER = 4;
95 - const int c_FUENF = 5;
96 -
97 - // State initializing the trains on corresponding tracks
98 - initial state init references initRailway11Trains
99 - --> run;
100 -
101 - // State handling the train schedules
102 - state run {
103 - // Regions handling the mutual exclusion on the track segments
104 - region Mutexes:
105 -  // State referenced to the MutexController for 11 Trains
106 - initial state Mutexes references mutexRailway11Trains;
107 -
108 - region KH_Mutexes:
109 -  // State referenced to additional MutexController for KH
110 - initial state KH_Mutexes references kh_mutex;
111 -
112 - // Regions that contain the schedules for individual trains
113 - //--------------------------------------------------------------------------------------
50 +The controllers starting from Kicking Horse Pass Station make an assumption of the direction of the train. These are dependent on the directions of the inner or outer circle, e.g. the KHIC controller starts backwards because this is the only valid direction to travel this path. To drive a train from the Kicking Horse Station (facing forward) to the Inner Circle we have to combine the KHOC and OCIC controllers.
114 114  
115 - // Region with schedule for train 4
116 - region Train4 :
117 -  // State with the schedule for train 4
118 - initial state train4 {
119 -
120 - // Annotation for replacing following constant in the hostcode of referenced SCChart
121 - @alterHostcode
122 - // Number of the train for identifying on track segments
123 - const int trainNum = 4;
124 -  // Variable specifying the track, where the train arrives at,
125 - // and for transmitting the track number to next Station-2-Station controller
126 - int arrivalTrack = 3;
127 -
128 - // Schedule of train 4: train drives only in the IC, should use station track 3
129 - // State Round referenced to ICIC Station-2-Station controller
130 - initial state Round references ICIC
131 - bind depTrack to arrivalTrack,
132 - destTrack to c_DREI,
133 - arrTrack to arrivalTrack
134 -  // Transition to checking state
135 - >-> Choice;
136 -
137 - // State for checking, when the train should halt and if the train is on corresponding track
138 - state Choice
139 - // Transition for driving additional circle, if cleanup = false or wrong track used
140 - --> Round with !cleanup | !(arrivalTrack == 3)
141 - // Transition to final state
142 - --> Done;
143 -
144 - final state Done;
145 - };
52 +[[image:attach:ICIC.png]]
146 146  
54 +When arriving on a station the train controller **must** first call the function //void railArrival(int train, int station)//. This starts the waiting timer for the train.
55 +Next the train **must** wait for// int railDeparture(int train)// to return 1.
56 +After the waiting has finished the controller can reach a final state and pass the control back to the train controller.
147 147  
148 - // Region with schedule for train 5, identical to region above
149 -  region Train5 :
150 - initial state train5 {
151 -
152 - @alterHostcode
153 - const int trainNum = 5;
154 - int arrivalTrack = 2;
155 -
156 - initial state Round references ICIC
157 - bind depTrack to arrivalTrack,
158 - destTrack to c_ZWEI,
159 - arrTrack to arrivalTrack
160 - >-> Choice;
161 -
162 - state Choice
163 - --> Round with !cleanup | !(arrivalTrack == 2)
164 - --> Done;
165 -
166 - final state Done;
167 -
168 - };
169 -
58 +=== Structure   ===
170 170  
171 - // Region with schedule for train 9, identical to region above
172 - region Train9 :
173 - initial state train9 {
174 -
175 - @alterHostcode
176 - const int trainNum = 9;
177 - int arrivalTrack = 1;
178 -
179 - initial state Round references ICIC
180 - bind depTrack to arrivalTrack,
181 - destTrack to c_EINS,
182 - arrTrack to arrivalTrack
183 - >-> Choice;
184 -
185 - state Choice
186 - --> Round with !cleanup | !(arrivalTrack == 1)
187 - --> Done;
188 -
189 - final state Done;
190 - };
60 +|=(((
61 +{{{input int *_perm;}}}
191 191  
63 +{{{output bool *_req[11];}}}
192 192  
193 - // Region with schedule for train 7
194 - region Train7 :
195 - initial state train7 {
196 -
197 - @alterHostcode
198 - const int trainNum = 7;
199 - int arrivalTrack = 1;
200 -
201 - // Schedule of train 7: train drives from OC-Station track 1 to IC-Station track 2 and back
202 - // arrivalTrack used for transmitting the number of station track where train arrived on
203 - // to next controller where the train starts on
204 - initial state OCtoIC references OCIC
205 - bind depTrack to arrivalTrack,
206 - destTrack to c_ZWEI,
207 - arrTrack to arrivalTrack
208 -  // Transition to next Station-2-Station controller
209 - >-> ICtoOC;
210 -
211 - state ICtoOC references ICOC
212 - bind depTrack to arrivalTrack,
213 - destTrack to c_EINS,
214 - arrTrack to arrivalTrack
215 -  // Transition to checking state because train at home station
216 - >-> Choice;
217 -
218 - // State for checking, when the train should halt and if the train is on corresponding track
219 - state Choice
220 - // Transition for driving additional circle, if cleanup = false or wrong track used
221 -  --> OCtoIC with !cleanup | !(arrivalTrack == 1)
222 - // Transition to final state
223 - --> Done;
224 -
225 - final state Done;
226 - };
227 - };
228 -}
229 -{{/code}}
65 +{{{input int trainNum;}}}
230 230  
67 +{{{input int depTrack;}}}
68 +
69 +{{{input int destTrack;}}}
70 +
71 +{{{input bool cleanup;}}}
72 +
73 +{{{input bool debug;}}}
74 +
75 +{{{output int arrTrack;}}}
76 +
77 +{{{int i_arrOnTrack;}}}
78 +
79 +{{{ }}}
80 +
81 +{{{initial state *_ST {}}}
82 +
83 +{{{    entry debug / 'println([trainNum][ST-ST] ... )';}}}
84 +
85 +{{{ }}}
86 +
87 +{{{    initial state waitForPerm {}}}
88 +
89 +{{{        entry / *_ST_4_req[trainNum] = true;}}}
90 +
91 +{{{        entry / *_LN_0_req[trainNum] = true;}}}
92 +
93 +{{{    }}}}
94 +
95 +{{{    --> gotPerm with (*_ST_4_perm == trainNum) & (*_LN_0_perm == trainNum)}}}
96 +
97 +{{{    --> backOff with (*_ST_4_perm == trainNum) | (*_LN_0_perm == trainNum);}}}
98 +
99 +{{{ }}}
100 +
101 +{{{    state backOff}}}
102 +
103 +{{{    --> backOff1;}}}
104 +
105 +{{{ }}}
106 +
107 +{{{    state backOff1 {}}}
108 +
109 +{{{ entry / *_ST_4_req[trainNum] = false;}}}
110 +
111 +{{{ entry / *_LN_0_req[trainNum] = false;}}}
112 +
113 +{{{    }}}}
114 +
115 +{{{    --> waitForPerm;}}}
116 +
117 +{{{ }}}
118 +
119 +{{{ final state gotPerm;}}}
120 +
121 +{{{}}}}
122 +
123 +{{{>-> Dep_*_ST;}}}
124 +
125 +{{{ }}}
126 +
127 +{{{state Dep_*_ST {}}}
128 +
129 +{{{    entry / 'railPoint(*,STRAIGHT)';}}}
130 +
131 +{{{    entry / 'railSignal(*_LN_0, FWD, RED)';}}}
132 +
133 +{{{    entry / 'railTrack(*_LN_0,FWD,trainNum,NORMAL)';}}}
134 +
135 +{{{    entry / 'railTrack(*_ST_4,FWD,trainNum,NORMAL)';}}}
136 +
137 +{{{    entry depTrack == 1 / 'railSignal(*_ST_1, FWD, GREEN)';}}}
138 +
139 +{{{    entry depTrack == 2 / 'railSignal(*_ST_2, FWD, GREEN)';}}}
140 +
141 +{{{    entry depTrack == 3 / 'railSignal(*_ST_3, FWD, GREEN)';}}}
142 +
143 +{{{    ..........}}}
144 +
145 +{{{  } --> *_LN_0 with 'railContact(*_LN_0,0)';}}}
146 +
147 +{{{ }}}
148 +
149 +{{{  state *_LN_0 {}}}
150 +
151 +{{{    entry / 'println("[trainNum][ST-ST] Entering *_LN_0")';}}}
152 +
153 +{{{    entry debug / 'println("[trainNum][ST-ST] Requesting permission for *_LN_1")';}}}
154 +
155 +{{{    entry depTrack == 1 / 'railSignal(*_ST_1, FWD, RED)';}}}
156 +
157 +{{{    entry depTrack == 2 / 'railSignal(*_ST_2, FWD, RED)';}}}
158 +
159 +{{{    entry depTrack == 3 / 'railSignal(*_ST_3, FWD, RED)';}}}
160 +
161 +{{{    entry / *_LN_1_req[trainNum] = true;}}}
162 +
163 +{{{ }}}
164 +
165 +{{{    region Travel:}}}
166 +
167 +{{{      initial state Entry}}}
168 +
169 +{{{      --> Continue with 'railContact(*_LN_0,0)' & (*_LN_1_perm == trainNum)}}}
170 +
171 +{{{      --> Slowdown with 'railContact(*_LN_0,0)';}}}
172 +
173 +{{{ }}}
174 +
175 +{{{      state Slowdown {}}}
176 +
177 +{{{        entry debug / 'println("[trainNum][ST-ST] Slowing down on *_LN_0")';}}}
178 +
179 +{{{        entry / 'railTrack(*_LN_0,FWD,trainNum,CAUTION)';}}}
180 +
181 +{{{      }}}}
182 +
183 +{{{      --> Waiting with 'railContact(*_LN_0,1)'}}}
184 +
185 +{{{      --> Continue with *_LN_1_perm == trainNum;}}}
186 +
187 +{{{ }}}
188 +
189 +{{{      state Waiting {}}}
190 +
191 +{{{        entry debug / 'println("[trainNum][ST-ST] Stopping on *_LN_0")';}}}
192 +
193 +{{{        entry / 'railTrackBrake(*_LN_0)';}}}
194 +
195 +{{{      }}}}
196 +
197 +{{{      --> Continue with *_LN_1_perm == trainNum;}}}
198 +
199 +{{{ }}}
200 +
201 +{{{      final state Continue {}}}
202 +
203 +{{{        entry debug / 'println("[trainNum][ST-ST] Continuing on *_LN_0")';}}}
204 +
205 +{{{        entry / 'railSignal(*_LN_0,FWD,GREEN)';}}}
206 +
207 +{{{        entry / 'railTrack(*_LN_0,FWD,trainNum,NORMAL)';}}}
208 +
209 +{{{        entry / 'railTrack(*_LN_1,FWD,trainNum,NORMAL)';}}}
210 +
211 +{{{        entry / 'railSignal(*_LN_1, FWD, RED)';}}}
212 +
213 +{{{      };}}}
214 +
215 +{{{ }}}
216 +
217 +{{{    region Cleanup:}}}
218 +
219 +{{{      initial state Entry}}}
220 +
221 +{{{      --> cleanup with 'railContact(*_LN_0,0)';}}}
222 +
223 +{{{ }}}
224 +
225 +{{{      final state cleanup {}}}
226 +
227 +{{{      entry debug / 'println("[trainNum][ST-ST] Entered *_LN_0 completely")';}}}
228 +
229 +{{{      entry / 'railTrackOff(*_ST_4)';}}}
230 +
231 +{{{      entry / *_ST_4_req[trainNum] = false;}}}
232 +
233 +{{{      };}}}
234 +
235 +{{{  }>-> *_LN_0_*_LN_1;}}}
236 +
237 +{{{ }}}
238 +
239 +{{{  state *_LN_0_*_LN_1}}}
240 +
241 +{{{  --> *_LN_1 with 'railContact(*_LN_1,0)';}}}
242 +
243 +{{{ }}}
244 +
245 +{{{// ...................}}}
246 +
247 +{{{// Set of track segment controlling states such as before}}}
248 +
249 +{{{// ...................}}}
250 +
251 +{{{ }}}
252 +
253 +{{{state *_LN_5 {}}}
254 +
255 +{{{    int perm_all_next_segments = false;}}}
256 +
257 +{{{    entry / 'println("[trainNum][ST-ST] Entering *_LN_5")';}}}
258 +
259 +{{{    entry / 'railSignal(*_LN_4, FWD, RED)';}}}
260 +
261 +{{{ }}}
262 +
263 +{{{    region Travel:}}}
264 +
265 +{{{      initial state Entry}}}
266 +
267 +{{{      --> Continue with 'railContact(*_LN_5,0)' & perm_all_next_segments}}}
268 +
269 +{{{      --> Slowdown with 'railContact(*_LN_5,0)';}}}
270 +
271 +{{{ }}}
272 +
273 +{{{      state Slowdown {}}}
274 +
275 +{{{        entry debug / 'println("[trainNum][ST-ST] Slowing down on *_LN_5")';}}}
276 +
277 +{{{        entry / 'railTrack(*_LN_5,FWD,trainNum,CAUTION)';}}}
278 +
279 +{{{      }}}}
280 +
281 +{{{      --> Waiting with 'railContact(*_LN_5,1)'}}}
282 +
283 +{{{      --> Continue with perm_all_next_segments;}}}
284 +
285 +{{{ }}}
286 +
287 +{{{      state Waiting {}}}
288 +
289 +{{{        entry debug / 'println("[trainNum][ST-ST] Stopping on *_LN_5")';}}}
290 +
291 +{{{        entry / 'railTrackBrake(*_LN_5)';}}}
292 +
293 +{{{      }}}}
294 +
295 +{{{      --> Continue with perm_all_next_segments;}}}
296 +
297 +{{{ }}}
298 +
299 +{{{      final state Continue {}}}
300 +
301 +{{{        entry debug / 'println("[trainNum][ST-ST] Continuing on *_LN_5")';        }}}
302 +
303 +{{{        entry i_arrOnTrack == 1 / 'railTrack(*_ST_1,FWD,trainNum,NORMAL)';}}}
304 +
305 +{{{        entry i_arrOnTrack == 2 / 'railTrack(*_ST_2,FWD,trainNum,NORMAL)';}}}
306 +
307 +{{{        entry i_arrOnTrack == 3 / 'railTrack(*_ST_3,FWD,trainNum,NORMAL)';}}}
308 +
309 +{{{        ----------}}}
310 +
311 +{{{        entry / arrTrack = i_arrOnTrack;}}}
312 +
313 +{{{      };}}}
314 +
315 +{{{ }}}
316 +
317 +{{{    region Cleanup:}}}
318 +
319 +{{{      initial state Entry}}}
320 +
321 +{{{      --> cleanup with 'railContact(*_LN_5,0)';}}}
322 +
323 +{{{ }}}
324 +
325 +{{{      final state cleanup {}}}
326 +
327 +{{{        entry debug / 'println("[trainNum][ST-ST] Entered *_LN_5 completely")';}}}
328 +
329 +{{{        entry / 'railTrackOff(*_LN_4)';}}}
330 +
331 +{{{        entry / *_LN_4_req[trainNum] = false;}}}
332 +
333 +{{{      };}}}
334 +
335 +{{{ }}}
336 +
337 +{{{    region Permissions:}}}
338 +
339 +{{{      initial state checking {}}}
340 +
341 +{{{        entry / *_ST_0_req[trainNum] = true;}}}
342 +
343 +{{{        entry destTrack == 1 | !cleanup / *_ST_1_req[trainNum] = true;}}}
344 +
345 +{{{        entry destTrack == 2 | !cleanup / *_ST_2_req[trainNum] = true;}}}
346 +
347 +{{{        entry destTrack == 3 | !cleanup / *_ST_3_req[trainNum] = true;}}}
348 +
349 +{{{      }}}}
350 +
351 +\\
352 +
353 +{{{      --> success with destTrack == 1 & *_ST_0_perm == trainNum & *_ST_1_perm == trainNum / i_arrOnTrack = 1}}}
354 +
355 +\\
356 +
357 +{{{      --> success with destTrack == 2 & *_ST_0_perm == trainNum & *_ST_2_perm == trainNum / i_arrOnTrack = 2}}}
358 +
359 +\\
360 +
361 +{{{      --> success with destTrack == 3 & *_ST_0_perm == trainNum & *_ST_3_perm == trainNum / i_arrOnTrack = 3}}}
362 +
363 +{{{      --> success with *_ST_0_perm == trainNum & *_ST_1_perm == trainNum / i_arrOnTrack = 1}}}
364 +
365 +{{{      --> success with *_ST_0_perm == trainNum & *_ST_2_perm == trainNum / i_arrOnTrack = 2}}}
366 +
367 +{{{      --> success with *_ST_0_perm == trainNum & *_ST_3_perm == trainNum / i_arrOnTrack = 3}}}
368 +
369 +
370 +\\
371 +
372 +{{{      --> resolving with *_ST_0_perm == trainNum | *_ST_3_perm == trainNum | *_ST_2_perm == trainNum | *_ST_1_perm == trainNum;}}}
373 +
374 +{{{ }}}
375 +
376 +{{{      state resolving}}}
377 +
378 +{{{      --> resolving1;}}}
379 +
380 +{{{ }}}
381 +
382 +{{{      state resolving1 {}}}
383 +
384 +{{{        entry / *_ST_0_req[trainNum] = false;}}}
385 +
386 +{{{        entry / *_ST_1_req[trainNum] = false;}}}
387 +
388 +{{{        entry / *_ST_2_req[trainNum] = false;}}}
389 +
390 +{{{        entry / *_ST_3_req[trainNum] = false;}}}
391 +
392 +{{{      }}}}
393 +
394 +{{{      --> checking;}}}
395 +
396 +{{{ }}}
397 +
398 +{{{      state success}}}
399 +
400 +{{{      --> success1;}}}
401 +
402 +{{{ }}}
403 +
404 +{{{      final state success1 {}}}
405 +
406 +{{{        entry !(i_arrOnTrack == 1) / *_ST_1_req[trainNum] = false;      }}}
407 +
408 +{{{        entry !(i_arrOnTrack == 2) / *_ST_2_req[trainNum] = false;}}}
409 +
410 +{{{        entry !(i_arrOnTrack == 3) / *_ST_3_req[trainNum] = false;}}}
411 +
412 +{{{        entry / perm_all_next_segments = true;}}}
413 +
414 +{{{      };}}}
415 +
416 +{{{  }>-> *_LN_5_*_ST;}}}
417 +
418 +{{{ }}}
419 +
420 +{{{  state *_LN_5_*_ST}}}
421 +
422 +{{{  --> Arr_*_ST with i_arrOnTrack == 1 & 'railContact(*_ST_1,0)'}}}
423 +
424 +{{{  --> Arr_*_ST with i_arrOnTrack == 2 & 'railContact(*_ST_2,0)'}}}
425 +
426 +{{{  --> Arr_*_ST with i_arrOnTrack == 3 & 'railContact(*_ST_3,0)';}}}
427 +
428 +{{{ }}}
429 +
430 +{{{  state Arr_*_ST {}}}
431 +
432 +{{{    entry / 'railSignal(*_LN_5, FWD, RED)';}}}
433 +
434 +{{{    entry / 'railTrackOff(*_LN_5)';}}}
435 +
436 +{{{    entry / 'railTrack(*_ST_0,FWD,trainNum,SLOW)';}}}
437 +
438 +{{{    entry i_arrOnTrack == 1 / 'railTrack(*_ST_1,FWD,trainNum,SLOW)';}}}
439 +
440 +{{{    entry i_arrOnTrack == 2 / 'railTrack(*_ST_2,FWD,trainNum,SLOW)';}}}
441 +
442 +{{{    entry i_arrOnTrack == 3 / 'railTrack(*_ST_3,FWD,trainNum,SLOW)';}}}
443 +
444 +{{{    entry / *_LN_5_req[trainNum] = false;}}}
445 +
446 +{{{ }}}
447 +
448 +{{{    initial state SlowEntry}}}
449 +
450 +{{{    --> Slow with i_arrOnTrack == 1 & 'railContact(*_ST_1,0)'}}}
451 +
452 +{{{    --> Slow with i_arrOnTrack == 2 & 'railContact(*_ST_2,0)'}}}
453 +
454 +{{{    --> Slow with i_arrOnTrack == 3 & 'railContact(*_ST_3,0)';}}}
455 +
456 +{{{ }}}
457 +
458 +{{{    state Slow {}}}
459 +
460 +{{{      entry / 'railTrackOff(*_ST_0)';}}}
461 +
462 +{{{      entry / *_ST_0_req[trainNum] = false;}}}
463 +
464 +{{{    }}}}
465 +
466 +{{{    --> Halt with i_arrOnTrack == 1 & 'railContact(*_ST_1,1)'}}}
467 +
468 +{{{    --> Halt with i_arrOnTrack == 2 & 'railContact(*_ST_2,1)'}}}
469 +
470 +{{{    --> Halt with i_arrOnTrack == 3 & 'railContact(*_ST_3,1)';}}}
471 +
472 +{{{ }}}
473 +
474 +{{{    final state Halt {}}}
475 +
476 +{{{      entry i_arrOnTrack == 1 / 'railTrackBrake(*_ST_1)';}}}
477 +
478 +{{{      entry i_arrOnTrack == 2 / 'railTrackBrake(*_ST_2)';}}}
479 +
480 +{{{      entry i_arrOnTrack == 3 / 'railTrackBrake(*_ST_3)';}}}
481 +
482 +{{{      entry i_arrOnTrack == 1 / 'railArrival(trainNum, *_ST_1)';}}}
483 +
484 +{{{      entry i_arrOnTrack == 2 / 'railArrival(trainNum, *_ST_2)';}}}
485 +
486 +{{{      entry i_arrOnTrack == 3 / 'railArrival(trainNum, *_ST_3)';}}}
487 +
488 +{{{    };}}}
489 +
490 +{{{  }}}}
491 +
492 +{{{  >-> done;}}}
493 +
494 +{{{ }}}
495 +
496 +{{{  state done}}}
497 +
498 +{{{  --> reallyDone with 'railDeparture(trainNum)';}}}
499 +
500 +{{{ }}}
501 +
502 +{{{  final state reallyDone;}}}
503 +)))|=(((
504 +~/~/ All permissions variables
505 +
506 +~/~/ All request variables
507 +
508 +~/~/ Train number
509 +
510 +~/~/ Departure track number
511 +
512 +~/~/ Destination track number
513 +
514 +~/~/ Cleanup flag for selecting the destination track
515 +
516 +~/~/ Debug flag for additional output
517 +
518 +~/~/ Arrival track
519 +
520 +~/~/ Variable (arrival track) for selecting correct station elements
521 +
231 231  
232 232  
233 -== Station-2-Station controller ==
524 +~/~/ Handles departing from a station
234 234  
235 -Each Station-2-Station controller realizes the movement from one of the stations (IC,OC,KH) to another station. All controllers using IC or OC parts have to respect the traveling directions. For the Kicking Horse Pass two separate controllers, forwards and backwards, are used.
526 +~/~/ Additional output for debugging
236 236  
237 -The controllers starting from Kicking Horse Pass Station make an assumption of the direction of the train. These are dependent on the directions of the inner or outer circle, e.g. the KHIC controller starts backwards because this is the only valid direction to travel this path. To drive a train from the Kicking Horse Station (facing forward) to the Inner Circle we have to combine the KHOC and OCIC controllers.
528 +
238 238  
239 -[[image:attach:ICIC.png]]
530 +~/~/ State, which sets requests for needed tracks
240 240  
241 -When arriving on a station the train controller **must** first call the function //void railArrival(int train, int station)//. This starts the waiting timer for the train.
242 -Next the train **must** wait for// int railDeparture(int train)// to return 1.
243 -After the waiting has finished the controller can reach a final state and pass the control back to the train controller.
532 +
244 244  
245 -=== Structure  ===
534 +
246 246  
247 -{{code linenumbers="true" language="sct"}}
248 -//
249 -// Structure of a Station-2-Station controller from Station * to Station *
250 -//
251 -scchart STST " * to * Controller " {
536 +
252 252  
253 - // Set of permission variables for required tracks
254 - input int *_perm;
538 +~/~/ Transition is taken, if all permissions are received
255 255  
256 - // Set of request variables for required tracks for 11 trains
257 - output bool *_req[11];
540 +~/~/ Transition is taken, if some (not all) permissions are received
258 258  
259 - // Train number
260 - input int trainNum;
542 +
261 261  
262 - // Number of the departure track in a station
263 - input int depTrack;
544 +~/~/ State for waiting an additional Tick
264 264  
265 - // Number of the destination track in a station
266 - input int destTrack;
546 +
267 267  
268 - // Cleanup flag for selecting the destination track
269 - input bool cleanup;
548 +
270 270  
271 - // Debug flag for additional output
272 - input bool debug;
550 +~/~/ State, which releases the requests for needed tracks
273 273  
274 - // Arrival track
275 - output int arrTrack;
552 +
276 276  
277 - // Variable with value for arrTrack for selecting correct station elements
278 - int i_arrOnTrack;
279 279  
280 - // Handles departing from a station *
281 - initial state *_ST {
282 - // hostcode call for additional output when debug
283 - entry debug / 'println([trainNum][ST-ST] ... )';
555 +
284 284  
285 - // State, which sets requests for needed tracks
286 - initial state waitForPerm {
287 - entry / *_ST_4_req[trainNum] = true;
288 - entry / *_LN_0_req[trainNum] = true;
289 - }
290 - // Transition is taken, if all permissions are received
291 - --> gotPerm with (*_ST_4_perm == trainNum) & (*_LN_0_perm == trainNum)
292 - // Transition is taken, if some (not all) permissions are received
293 - --> backOff with (*_ST_4_perm == trainNum) | (*_LN_0_perm == trainNum);
557 +
558 +~/~/ Transition to repeat requesting permissions procedure
559 +
294 294  
295 - // State for waiting an additional tick when not all permissions are received
296 - state backOff
297 - --> backOff1;
561 +
298 298  
299 - // State, which releases the requests for needed tracks
300 - state backOff1 {
301 - entry / *_ST_4_req[trainNum] = false;
302 - entry / *_LN_0_req[trainNum] = false;
303 - }
304 - // Transition to repeat requesting permissions procedure
305 - --> waitForPerm;
563 +
306 306  
307 - final state gotPerm;
308 - }
309 - // Transition to the departure state
310 - >-> Dep_*_ST;
565 +
566 +~/~/ Transition to the departure state
567 +
311 311  
312 - // State, which handles the departure of a train
313 - state Dep_*_ST {
314 - // Set of entry-Actions with hostcode calls to set tracks, points and signals according to depTrack
315 - entry / 'railPoint(*,STRAIGHT)';
316 - entry / 'railSignal(*_LN_0, FWD, RED)';
317 - entry / 'railTrack(*_LN_0,FWD,trainNum,NORMAL)';
318 - entry / 'railTrack(*_ST_4,FWD,trainNum,NORMAL)';
319 - entry depTrack == 1 / 'railSignal(*_ST_1, FWD, GREEN)';
320 - entry depTrack == 2 / 'railSignal(*_ST_2, FWD, GREEN)';
321 - entry depTrack == 3 / 'railSignal(*_ST_3, FWD, GREEN)';
322 - //...
323 - // Transition to next track segment, if contact is triggered
324 - } --> *_LN_0 with 'railContact(*_LN_0,0)';
569 +
570 +~/~/ State, which handles the train departure
571 +
572 +~/~/ Set of entry-Actions to set tracks, points and signals according to depTrack
573 +
325 325  
326 326  
327 327  
328 - // ----------------------------------------------------------------------------------------------------------------
329 - // Set of track segment controlling states such as follows
330 - // ----------------------------------------------------------------------------------------------------------------
331 331  
332 - // Transition to next track segment, if contact is triggered
333 - state *_LN_0 {
334 - // Hostcode calls for outputs
335 - entry / 'println("[trainNum][ST-ST] Entering *_LN_0")';
336 - entry debug / 'println("[trainNum][ST-ST] Requesting permission for *_LN_1")';
337 - // Entry-Actions with hostcode calls to set previous signal according to depTrack to RED
338 - entry depTrack == 1 / 'railSignal(*_ST_1, FWD, RED)';
339 - entry depTrack == 2 / 'railSignal(*_ST_2, FWD, RED)';
340 - entry depTrack == 3 / 'railSignal(*_ST_3, FWD, RED)';
341 - // Requesting the next track segment
342 - entry / *_LN_1_req[trainNum] = true;
578 +
343 343  
344 - // Region for handling train driving
345 - region Travel:
346 - initial state Entry
347 - // Transition to continuing state, if permitted
348 - --> Continue with 'railContact(*_LN_0,0)' & (*_LN_1_perm == trainNum)
349 - // Transition to slowing down else
350 - --> Slowdown with 'railContact(*_LN_0,0)';
580 +
351 351  
352 - // State for slowing down the train
353 - state Slowdown {
354 - entry debug / 'println("[trainNum][ST-ST] Slowing down on *_LN_0")';
355 - // Entry-Action with hostcode calls for slowing down the train
356 - entry / 'railTrack(*_LN_0,FWD,trainNum,CAUTION)';
357 - }
358 - // Transition to waiting state
359 - --> Waiting with 'railContact(*_LN_0,1)'
360 - // Transition to continuing state, if permitted
361 - --> Continue with *_LN_1_perm == trainNum;
582 +
362 362  
363 - // State for train waiting on permission
364 - state Waiting {
365 - entry debug / 'println("[trainNum][ST-ST] Stopping on *_LN_0")';
366 - // Entry-Action with hostcode call for stopping the train
367 - entry / 'railTrackBrake(*_LN_0)';
368 - }
369 - --> Continue with *_LN_1_perm == trainNum;
584 +
370 370  
371 - // State to continuing driving on the track
372 - final state Continue {
373 - entry debug / 'println("[trainNum][ST-ST] Continuing on *_LN_0")';
374 - // Entry-Actions with hostcode calls to set tracks and signals for driving
375 - entry / 'railSignal(*_LN_0,FWD,GREEN)';
376 - entry / 'railTrack(*_LN_0,FWD,trainNum,NORMAL)';
377 - entry / 'railTrack(*_LN_1,FWD,trainNum,NORMAL)';
378 - entry / 'railSignal(*_LN_1, FWD, RED)';
379 - };
586 +
587 +~/~/ Transition to next track segment, if contact is triggered
588 +
380 380  
381 - // Region for handling cleanup functionalities
382 - region Cleanup:
383 - initial state Entry
384 - // Transition to cleanup state
385 - --> cleanup with 'railContact(*_LN_0,0)';
590 +
591 +~/~/ State for handling the train on track *_LN_0
592 +
593 +~/~/ Outputs for debugging
594 +
386 386  
387 - // State for cleaning up the previous track segments
388 - final state cleanup {
389 - entry debug / 'println("[trainNum][ST-ST] Entered *_LN_0 completely")';
390 - // Entry-Action with hostcode call to switching off the previous track
391 - entry / 'railTrackOff(*_ST_4)';
392 - // Entry-Action to release the previous track
393 - entry / *_ST_4_req[trainNum] = false;
394 - };
395 - // Transition to transitional state
396 - }>-> *_LN_0_*_LN_1;
596 +
597 +~/~/ Entry-Actions to set the previous signals to RED
598 +
397 397  
398 - state *_LN_0_*_LN_1
399 - // Transition to next track segment, if contact is triggered
400 - --> *_LN_1 with 'railContact(*_LN_1,0)';
600 +
401 401  
402 - // ----------------------------------------------------------------------------------------------------------------
403 403  
603 +~/~/ Requesting the next segment
404 404  
605 +
405 405  
406 - // State for entering a station
407 - state *_LN_5 {
408 - // Variable for checking all needed permissions
409 - int perm_all_next_segments = false;
410 - entry / 'println("[trainNum][ST-ST] Entering *_LN_5")';
411 - entry / 'railSignal(*_LN_4, FWD, RED)';
607 +~/~/ Region for handling train driving
608 +
412 412  
413 - // Region for handling train driving such as above,
414 - // only with perm_all_next_segments for permitting more than one track
415 - region Travel:
416 - initial state Entry
417 - --> Continue with 'railContact(*_LN_5,0)' & perm_all_next_segments
418 - --> Slowdown with 'railContact(*_LN_5,0)';
610 +
611 +~/~/ Transition to continuing state, if permitted
612 +
613 +~/~/ Transition to slowing down else
614 +
419 419  
420 - state Slowdown {
421 - entry debug / 'println("[trainNum][ST-ST] Slowing down on *_LN_5")';
422 - entry / 'railTrack(*_LN_5,FWD,trainNum,CAUTION)';
423 - }
424 - --> Waiting with 'railContact(*_LN_5,1)'
425 - --> Continue with perm_all_next_segments;
616 +
617 +~/~/ State for slowing down
618 +
619 +~/~/ Addtitional output for debugging
620 +
621 +~/~/ Entry-Action for slowing down the train
622 +
426 426  
427 - state Waiting {
428 - entry debug / 'println("[trainNum][ST-ST] Stopping on *_LN_5")';
429 - entry / 'railTrackBrake(*_LN_5)';
430 - }
431 - --> Continue with perm_all_next_segments;
624 +
625 +~/~/ Transition to waiting state
626 +
627 +~/~/ Transition to continuing state, if permitted
628 +
432 432  
433 - final state Continue {
434 - entry debug / 'println("[trainNum][ST-ST] Continuing on *_LN_5")';
435 - entry i_arrOnTrack == 1 / 'railTrack(*_ST_1,FWD,trainNum,NORMAL)';
436 - entry i_arrOnTrack == 2 / 'railTrack(*_ST_2,FWD,trainNum,NORMAL)';
437 - entry i_arrOnTrack == 3 / 'railTrack(*_ST_3,FWD,trainNum,NORMAL)';
438 - //...
439 - entry / arrTrack = i_arrOnTrack;
440 - };
630 +
631 +~/~/ Waiting state
632 +
633 +~/~/ Addtitional output for debugging
634 +
635 +~/~/ Entry-Action for stopping the train
636 +
441 441  
442 - // Region for handling cleanup-functionalities such as above
443 - region Cleanup:
444 - initial state Entry
445 - --> cleanup with 'railContact(*_LN_5,0)';
638 +
639 +~/~/ Tranisition to continuing state
640 +
446 446  
447 - final state cleanup {
448 - entry debug / 'println("[trainNum][ST-ST] Entered *_LN_5 completely")';
449 - entry / 'railTrackOff(*_LN_4)';
450 - entry / *_LN_4_req[trainNum] = false;
451 - };
642 +
643 +~/~/ State to continuing driving on the track
644 +
645 +~/~/ Addtitional output for debugging
646 +
647 +~/~/ Entry-Actions to set tracks and signals for driving
648 +
452 452  
453 - // Region for handling permissions of all needed tracks
454 - region Permissions:
455 - // State for requesting all needed tracks according to destination track and cleanup-Flag
456 - initial state checking {
457 - entry / *_ST_0_req[trainNum] = true;
458 - entry destTrack == 1 | !cleanup / *_ST_1_req[trainNum] = true;
459 - entry destTrack == 2 | !cleanup / *_ST_2_req[trainNum] = true;
460 - entry destTrack == 3 | !cleanup / *_ST_3_req[trainNum] = true;
461 - }
462 - // Transitions for permitted tracks match wished tracks
463 - --> success with destTrack == 1 & *_ST_0_perm == trainNum & *_ST_1_perm == trainNum / i_arrOnTrack = 1
464 - --> success with destTrack == 2 & *_ST_0_perm == trainNum & *_ST_2_perm == trainNum / i_arrOnTrack = 2
465 - --> success with destTrack == 3 & *_ST_0_perm == trainNum & *_ST_3_perm == trainNum / i_arrOnTrack = 3
466 - // Transitions for permitted tracks don't match wished tracks
467 - --> success with *_ST_0_perm == trainNum & *_ST_1_perm == trainNum / i_arrOnTrack = 1
468 - --> success with *_ST_0_perm == trainNum & *_ST_2_perm == trainNum / i_arrOnTrack = 2
469 - --> success with *_ST_0_perm == trainNum & *_ST_3_perm == trainNum / i_arrOnTrack = 3
470 - // Transition for not all tracks permitted
471 - --> resolving with *_ST_0_perm == trainNum | *_ST_3_perm == trainNum | *_ST_2_perm == trainNum | *_ST_1_perm == trainNum;
650 +
472 472  
473 - // State for waiting an additional tick
474 - state resolving
475 - --> resolving1;
476 -
477 - // State for releasing track requests
478 - state resolving1 {
479 - entry / *_ST_0_req[trainNum] = false;
480 - entry / *_ST_1_req[trainNum] = false;
481 - entry / *_ST_2_req[trainNum] = false;
482 - entry / *_ST_3_req[trainNum] = false;
483 - }
484 - // Transition for trying the requesting again
485 - --> checking;
652 +
486 486  
487 - // State for waiting an additional tick
488 - state success
489 - --> success1;
490 490  
491 - // State for releasing not used track requests
492 - final state success1 {
493 - entry !(i_arrOnTrack == 1) / *_ST_1_req[trainNum] = false;
494 - entry !(i_arrOnTrack == 2) / *_ST_2_req[trainNum] = false;
495 - entry !(i_arrOnTrack == 3) / *_ST_3_req[trainNum] = false;
496 - // Settting perm_all_next_segments to true
497 - entry / perm_all_next_segments = true;
498 - };
499 - // Transition to station entry states
500 - }>-> *_LN_5_*_ST;
501 501  
502 - // State waiting for station entry
503 - state *_LN_5_*_ST
504 - --> Arr_*_ST with i_arrOnTrack == 1 & 'railContact(*_ST_1,0)'
505 -  --> Arr_*_ST with i_arrOnTrack == 2 & 'railContact(*_ST_2,0)'
506 - --> Arr_*_ST with i_arrOnTrack == 3 & 'railContact(*_ST_3,0)';
656 +
507 507  
508 - // State for setting tracks, points and signals according to i_arrOnTrack
509 - // and releasing previous track request
510 - state Arr_*_ST {
511 - entry / 'railSignal(*_LN_5, FWD, RED)';
512 - entry / 'railTrackOff(*_LN_5)';
513 - entry / 'railTrack(*_ST_0,FWD,trainNum,SLOW)';
514 - entry i_arrOnTrack == 1 / 'railTrack(*_ST_1,FWD,trainNum,SLOW)';
515 - entry i_arrOnTrack == 2 / 'railTrack(*_ST_2,FWD,trainNum,SLOW)';
516 - entry i_arrOnTrack == 3 / 'railTrack(*_ST_3,FWD,trainNum,SLOW)';
517 - entry / *_LN_5_req[trainNum] = false;
658 +
659 +~/~/ Region for handling cleanup-functionalities
660 +
518 518  
519 - initial state SlowEntry
520 - --> Slow with i_arrOnTrack == 1 & 'railContact(*_ST_1,0)'
521 - --> Slow with i_arrOnTrack == 2 & 'railContact(*_ST_2,0)'
522 - --> Slow with i_arrOnTrack == 3 & 'railContact(*_ST_3,0)';
662 +
663 +~/~/ Transition to cleanup state
664 +
523 523  
524 - // State for switching off previous track and releasing the request
525 - state Slow {
526 - entry / 'railTrackOff(*_ST_0)';
527 - entry / *_ST_0_req[trainNum] = false;
528 - }
529 - // Transitions to halt state, when train is at second contact of a track segment
530 - --> Halt with i_arrOnTrack == 1 & 'railContact(*_ST_1,1)'
531 - --> Halt with i_arrOnTrack == 2 & 'railContact(*_ST_2,1)'
532 - --> Halt with i_arrOnTrack == 3 & 'railContact(*_ST_3,1)';
666 +
667 +~/~/ Cleanup state
668 +
669 +~/~/ Addtitional output for debugging
670 +
671 +~/~/ Entry-Action to switching off the previous track
672 +
673 +~/~/ Entry-Action to release the previous track
674 +
533 533  
534 -
535 - final state Halt {
536 - // Entry-Actions for braking the train on correct track
537 - entry i_arrOnTrack == 1 / 'railTrackBrake(*_ST_1)';
538 - entry i_arrOnTrack == 2 / 'railTrackBrake(*_ST_2)';
539 - entry i_arrOnTrack == 3 / 'railTrackBrake(*_ST_3)';
540 - // Entry-Actions for waiting for timer on correct track
541 - entry i_arrOnTrack == 1 / 'railArrival(trainNum, *_ST_1)';
542 - entry i_arrOnTrack == 2 / 'railArrival(trainNum, *_ST_2)';
543 - entry i_arrOnTrack == 3 / 'railArrival(trainNum, *_ST_3)';
544 - };
545 - }
546 - >-> done;
676 +
677 +~/~/ Transition to transitional state
678 +
547 547  
548 - state done
549 - // Transition to final state, if timer is ready
550 - --> reallyDone with 'railDeparture(trainNum)';
680 +
681 +~/~/ Transitional state
682 +
683 +~/~/ Transition to next track segment, if contact is triggered
684 +
551 551  
552 - final state reallyDone;
553 -}
554 -{{/code}}
555 555  
556 -== Dynamic Controller ==
687 +
557 557  
558 -The dynamic controller handles all 11 Trains. For each train the controller has a region with a referenced dynamic scheduling. Thereby each train can follow an arbitrary schedule. Additionally the controller has a region for stable cleanup function.
689 +
559 559  
560 -{{code linenumbers="true" language="sct"}}
561 -//
562 -// Dynamic controller for 11 trains
563 -//
564 -scchart DynamicController11 {
565 - // Set of request variables for all tracks for 11 trains
566 - bool IC_JCT_0_req[11], IC_LN_0_req[11], IC_LN_1_req[11], IC_LN_2_req[11];
567 - bool IC_LN_3_req[11], IC_LN_4_req[11], IC_LN_5_req[11], IC_ST_0_req[11];
568 - bool IC_ST_1_req[11], IC_ST_2_req[11], IC_ST_3_req[11], IC_ST_4_req[11];
569 - bool IO_LN_0_req[11], IO_LN_1_req[11], IO_LN_2_req[11], KH_LN_0_req[11];
570 - bool KH_LN_1_req[11], KH_LN_2_req[11], KH_LN_3_req[11], KH_LN_4_req[11];
571 - bool KH_LN_5_req[11], KH_LN_6_req[11], KH_LN_7_req[11], KH_LN_8_req[11];
572 - bool KH_ST_0_req[11], KH_ST_1_req[11], KH_ST_2_req[11], KH_ST_3_req[11];
573 - bool KH_ST_4_req[11], KH_ST_5_req[11], KH_ST_6_req[11], KIO_LN_0_req[11];
574 - bool KIO_LN_1_req[11], OC_JCT_0_req[11], OC_LN_0_req[11], OC_LN_1_req[11];
575 - bool OC_LN_2_req[11], OC_LN_3_req[11], OC_LN_4_req[11], OC_LN_5_req[11];
576 - bool OC_ST_0_req[11], OC_ST_1_req[11], OC_ST_2_req[11], OC_ST_3_req[11];
577 - bool OC_ST_4_req[11], OI_LN_0_req[11], OI_LN_1_req[11], OI_LN_2_req[11];
578 - bool req_in_R , req_out_R , req_in_L , req_out_L;
579 -  
580 - // Set of permission variables for all tracks
581 - int IC_JCT_0_perm, IC_LN_0_perm, IC_LN_1_perm, IC_LN_2_perm;
582 - int IC_LN_3_perm, IC_LN_4_perm, IC_LN_5_perm, IC_ST_0_perm;
583 - int IC_ST_1_perm, IC_ST_2_perm, IC_ST_3_perm, IC_ST_4_perm;
584 - int IO_LN_0_perm, IO_LN_1_perm, IO_LN_2_perm, KH_LN_0_perm;
585 - int KH_LN_1_perm, KH_LN_2_perm, KH_LN_3_perm, KH_LN_4_perm;
586 - int KH_LN_5_perm, KH_LN_6_perm, KH_LN_7_perm, KH_LN_8_perm;
587 - int KH_ST_0_perm, KH_ST_1_perm, KH_ST_2_perm, KH_ST_3_perm;
588 - int KH_ST_4_perm, KH_ST_5_perm, KH_ST_6_perm, KIO_LN_0_perm;
589 - int KIO_LN_1_perm, OC_JCT_0_perm, OC_LN_0_perm, OC_LN_1_perm;
590 - int OC_LN_2_perm, OC_LN_3_perm, OC_LN_4_perm, OC_LN_5_perm;
591 - int OC_ST_0_perm, OC_ST_1_perm, OC_ST_2_perm, OC_ST_3_perm;
592 - int OC_ST_4_perm, OI_LN_0_perm, OI_LN_1_perm, OI_LN_2_perm;
593 - bool perm_in_R , perm_out_R , perm_in_L , perm_out_L;
691 +
594 594  
595 - // Flags needed for stable cleanup function
596 - //----------------------------------------------------------------------------------------
597 - // Flags for trains are ready and back at home
598 - bool trainDone[11];
599 - // Flags for trains are on their home circle
600 - bool circle[11];
601 - // Flag for trains 0 to 7 are back at home and trains 8 to 10 are on their home circle
602 -  bool mainDone;
603 - // Flag for all trains are back at home
604 -  bool allDone;
605 - //----------------------------------------------------------------------------------------
693 +
606 606  
607 - // Debug flag for additional output
608 -  bool debug;
609 - // Cleanup flag for halting the trains at home station tracks
610 -  bool cleanup;
611 - // Variable, that gives the number of trains to C-Controller for stability check
612 -  int trainCount;
613 - // Constant needed for binding to referenced SCCharts
614 - const bool c_TRUE = true;
695 +~/~/ State for entering a station
615 615  
697 +~/~/ Variable for checking all needed permissions
698 +
699 +~/~/ Output
700 +
701 +~/~/ Setting signal to RED
702 +
616 616  
617 - // State initializing the trains on corresponding tracks
618 - initial state init references initRailway11Trains
619 - >-> run;
620 620  
621 -
622 - // State handling the train schedules
623 -  state run {
705 +~/~/ Region for handling train driving
624 624  
625 -  // Region handling the cleanup function
626 - region Abort:
627 - initial state notDone
628 -  // Transition when trains 0 to 7 are back at home and trains 8 to 10 are on their home circle
629 - --> mainDone with trainDone[0] & trainDone[1] & trainDone[2]
630 - & trainDone[3] & trainDone[4] & trainDone[5]
631 - & trainDone[6] & trainDone[7]
632 - & circle[8] & circle[9] & circle[10];
633 -
634 - // State for allowing trains 8 to 10 to halt on the home track
635 - state mainDone
636 - --> quitCircle with / mainDone = true;
637 -
638 - // State waiting for trains 8 to 10 halt and setting flag for terminate the controller
639 - state quitCircle
640 - --> done with trainDone[8] & trainDone[9] & trainDone[10] / allDone = true;
641 -
642 - final state done;
643 -
644 - // Regions handling the mutual exclusion on the track segments
645 - region Mutexes:
646 - initial state Mutexes references mutexRailway11Trains
647 - // terminates with a strong abort when all trains are at home
648 - o-> done with allDone;
649 -
650 - final state done;
651 -
652 - region KH_Mutexes:
653 - initial state KH_Mutexes references kh_mutex
654 -  // terminates with a strong abort when all trains are at home
655 - o-> done with allDone;
656 -
657 - final state done;
707 +
658 658  
659 - // Regions that contain the dynamic schedules for trains 0 to 7
660 - //--------------------------------------------------------------------------------------
709 +~/~/ Transition to continuing state, if permitted
710 +
711 +~/~/ Transition to slowing down else
712 +
661 661  
662 - // Region with the dynamic schedule for train 0
663 - region Train0:
664 - initial state Train0 {
665 - @alterHostcode
666 - const int trainNum = 0
667 -  // Variable for saving the home track
668 - int homeTrack = 1;
669 - // Variable for saving the home station
670 - int homeStation = 1;
671 -
672 - // State referenced to dynamic scheduling
673 - initial state drive
674 - references DynamicSheduling
675 -  // Binding circleDone to true for halting at home if cleanup is set
676 - bind circleDone to c_TRUE
677 -  // Set a flag and a light for train at home
678 - >-> done with / 'railLight(10,1)'; trainDone[0] = true;
679 -
680 - final state done;
681 - }
682 - >-> done;
683 -
684 - final state done;
685 685  
686 - // ... (other regions for trains 1 to 7 such as before)
715 +~/~/ State for slowing down
687 687  
688 -  //--------------------------------------------------------------------------------------
717 +~/~/ Addtitional output for debugging
718 +
719 +~/~/ Entry-Action for slowing down the train
720 +
689 689  
690 690  
723 +~/~/ Transition to waiting state
691 691  
725 +~/~/ Transition to continuing state, if permitted
692 692  
693 - // Regions that contain the dynamic schedules for trains 8 to 10
694 - // Differences to regions above is that the trains 8 to 10 circle at home station circle
695 - // until trains 0 to 7 are back at home station and track
696 - // For this circleDone binds mainDone flag
697 - //--------------------------------------------------------------------------------------
698 698  
699 - // Region with the dynamic schedule for train 8
700 - region Train8:
701 - initial state Train8 {
702 - @alterHostcode
703 - const int trainNum = 8
704 - // Variable for saving the home track
705 -  int homeTrack = 5;
706 - // Variable for saving the home station
707 - int homeStation = 1;
708 -
709 - // State referenced to dynamic scheduling
710 - initial state drive
711 - references DynamicSheduling
712 -  // Binding circleDone to mainDone for halting at home only if cleanup is set
713 - // and trains 0 to 7 are at home and 8 to 10 on home circle
714 - bind circleDone to mainDone
715 - // Set a flag and a light for train at home 
716 - >-> done with / 'railLight(6,1)'; trainDone[8] = true;
717 -
718 - final state done;
719 - }
720 - >-> done;
721 -
722 - final state done;
723 723  
724 - // ... (other regions for trains 9 and 10 such as before)
725 - //--------------------------------------------------------------------------------------
729 +~/~/ Waiting state
726 726  
727 - }
728 - >-> flash;
729 -
730 - // State for flashing the lights at the end of the controller
731 - state flash
732 - --> done with / 'railFlashLight()';
733 -
734 - final state done;
735 -}
736 -{{/code}}
731 +~/~/ Addtitional output for debugging
732 +
733 +~/~/ Entry-Action for stopping the train
734 +
735 +
736 +
737 +~/~/ Tranisition to continuing state
738 +
739 +
740 +
741 +~/~/ State to continuing driving on the track
742 +
743 +~/~/ Addtitional output for debugging
744 +
745 +~/~/ Set of entry-Actions for setting tracks, points and signals according to i_arrOnTrack
746 +
747 +
748 +
749 +
750 +
751 +~/~/ Setting the arrival track (output)
752 +
753 +
754 +
755 +
756 +
757 +~/~/ Region for handling cleanup-functionalities
758 +
759 +
760 +
761 +~/~/ Transition to cleanup state
762 +
763 +
764 +
765 +~/~/ Cleanup state
766 +
767 +~/~/ Addtitional output for debugging
768 +
769 +~/~/ Entry-Action to switching off the previous tracks
770 +
771 +~/~/ Entry-Action to release the previous tracks
772 +
773 +
774 +
775 +
776 +
777 +~/~/ Region for handling permissions of all needed tracks
778 +
779 +~/~/ State for requesting all needed tracks according to destination track and cleanup-Flag
780 +
781 +
782 +
783 +
784 +
785 +
786 +
787 +
788 +
789 +
790 +
791 +~/~/ Transitions for permitted tracks match wished tracks
792 +
793 +
794 +
795 +
796 +
797 +
798 +
799 +
800 +
801 +~/~/ Transitions for permitted tracks don't match wished tracks
802 +
803 +
804 +
805 +
806 +
807 +~/~/ Transition for not all tracks permitted
808 +
809 +
810 +
811 +
812 +
813 +~/~/ State for waiting an additional tick
814 +
815 +
816 +
817 +
818 +
819 +~/~/ State for releasing track requests
820 +
821 +
822 +
823 +
824 +
825 +
826 +
827 +
828 +
829 +
830 +
831 +~/~/ Transition for trying the requesting again
832 +
833 +
834 +
835 +~/~/ State for waiting an additional tick
836 +
837 +
838 +
839 +
840 +
841 +~/~/ State for releasing not used track requests
842 +
843 +
844 +
845 +
846 +
847 +
848 +
849 +~/~/ Settting perm_all_next_segments to true
850 +
851 +
852 +
853 +~/~/ Transition to station entry states
854 +
855 +
856 +
857 +~/~/ State waiting for station entry
858 +
859 +
860 +
861 +
862 +
863 +
864 +
865 +
866 +
867 +~/~/ State for setting tracks, points and signals according to i_arrOnTrack
868 +
869 +~/~/ and releasing previous track request
870 +
871 +
872 +
873 +
874 +
875 +
876 +
877 +
878 +
879 +
880 +
881 +
882 +
883 +
884 +
885 +~/~/ State for slowing down, if train completely on track
886 +
887 +
888 +
889 +
890 +
891 +
892 +
893 +
894 +
895 +~/~/ State for switching off previous track and releasing the request
896 +
897 +
898 +
899 +
900 +
901 +
902 +
903 +~/~/ Transitions to halt states, if train at second contact of a track
904 +
905 +
906 +
907 +
908 +
909 +
910 +
911 +
912 +
913 +~/~/ Entry-Actions for braking the train on correct track
914 +
915 +
916 +
917 +
918 +
919 +~/~/ Entry-Actions for waiting for timer on correct track
920 +
921 +
922 +
923 +
924 +
925 +
926 +
927 +
928 +
929 +
930 +
931 +
932 +
933 +
934 +
935 +~/~/ Transition to final state, if timer is ready
936 +)))
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -9471750
1 +9471660
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471750/Basic design
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471660/Basic design