Skip to Content

Changes for page Interfaces and Rulesets

Last modified by cbu on 2025/01/30 12:05
From version 4.1
edited by nbw
on 2014/06/22 18:25
Change comment: There is no comment for this version
To version 1.1
edited by nbw
on 2014/06/20 09:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -135,23 +135,7 @@
135 135  
136 136  === Logging ===
137 137  
138 -* All log messages must be prefixed. For Station-2-Station controllers the prefix** [trainnum][ST-ST]** must be used.
139 139  * The variable **debug** indicates verbose logging.
140 -* Station-2-Station controllers should produce a log message when entering a new train segment even without verbose logging.
141 -* With verbose logging every state can produce a log message as an entry action.
142 -* Function //println(String str)// must be used to produce textual output.
143 -* //printf()// or other IO functions must not be used, because output may not be flushed correctly.
139 +* All log messages must be prefixed:** [trainnum][ST-ST]**
144 144  
145 -=== Codestyle ===
146 -
147 -* Use entry-/exit-actions instead of actions on transitions, if possible.
148 -* If using hostcode, only use functions delivered by our own C-Interface and not the Höhrmann-API.
149 -
150 -=== Deadlock Prevention ===
151 -
152 -* When attempting to reserve more than one segment (Entering a station, passing a junction) a separate protocol for deadlock prevention must be adhered to.
153 -* In each tick the controller must check if only partial permissions were granted.
154 -* If partial permission was granted the train waits for one tick and releases all locks.
155 -* In the following tick the locks are requested again.
156 -* As a special case the controllers passing through KIO_LN_0 or KIO_LN_1 must wait an additional tick after releasing the requests.
157 -* A sample controller can be found in the repository at [[/doc/deadlocks/resolve_deadlock.sct>>url:https://git.rtsys.informatik.uni-kiel.de/projects/PRAK/repos/14ss-railway/browse/doc/deadlocks/resolve_deadlock.sct||shape="rect"]]
141 +Use **println** function to produce textual output. Do not use printf or other io functions, because output may not be flushed correctly.
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -9471285
1 +9471019
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471285/Interfaces and Rulesets
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471019/Interfaces and Rulesets