Summary

• Page properties (1 modified, 0 added, 0 removed)
• Objects (1 modified, 0 added, 0 removed)
  • Confluence.Code.ConfluencePageClass[0]

Details

Page properties

Content

...	...	@@ -135,7 +135,23 @@
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.
138	138	* The variable **debug** indicates verbose logging.
139		-* All log messages must be prefixed:** [trainnum][ST-ST]**
	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.
140	140
141		-Use **println** function to produce textual output. Do not use printf or other io functions, because output may not be flushed correctly.
	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"]]

Confluence.Code.ConfluencePageClass[0]

Id

...	...	@@ -1,1 +1,1 @@
1		-9471019
	1	+9471285

URL

...	...	@@ -1,1 +1,1 @@
1		-https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471019/Interfaces and Rulesets
	1	+https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS14Railway/pages/9471285/Interfaces and Rulesets