aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authororwell96 <orwell@bleipb.de>2018-06-14 17:11:38 +0200
committerorwell96 <orwell@bleipb.de>2018-06-14 17:39:42 +0200
commit712db5bd7f0c5cab71ccdc93b5d5220b1c99173b (patch)
tree6be4de3b09be454a8275c7a7250fc942bf099f3e
parentb8f2ccc63882c77832e99bb692a7c25d2cd3a6ab (diff)
downloadadvtrains-712db5bd7f0c5cab71ccdc93b5d5220b1c99173b.tar.gz
advtrains-712db5bd7f0c5cab71ccdc93b5d5220b1c99173b.tar.bz2
advtrains-712db5bd7f0c5cab71ccdc93b5d5220b1c99173b.zip
Draft of interlocking system
-rw-r--r--advtrains_interlocking/database.lua46
-rw-r--r--advtrains_interlocking/init.lua0
2 files changed, 46 insertions, 0 deletions
diff --git a/advtrains_interlocking/database.lua b/advtrains_interlocking/database.lua
new file mode 100644
index 0000000..7a49383
--- /dev/null
+++ b/advtrains_interlocking/database.lua
@@ -0,0 +1,46 @@
+-- interlocking/database.lua
+-- saving the location of TCB's, their neighbors and their state
+--[[
+The interlocking system is based on track circuits.
+Track circuit breaks must be manually set by the user. Signals must be assigned to track circuit breaks and to a direction(connid).
+To simplify the whole system, there is no overlap.
+== Trains ==
+A train always reserves the space between two signals facing it. All track circuits in this space
+have a reservation entry TRAIN with the train's ID
+== Database storage ==
+The things that are actually saved are the Track Circuit Breaks. Each TCB holds a list of the TCBs that are adjacent in each direction.
+TC occupation/state is then saved inside each (TCB,Direction) and held in sync across all TCBs adjacent to this one. If something should not be in sync,
+all entries are merged to perform the most restrictive setup.
+== Traverser function ==
+To determine and update the list of neighboring TCBs, we need a traverser function.
+It will start at one TCB in a specified direction (connid) and use get_adjacent_rail to crawl along the track. When encountering a turnout or a crossing,
+it needs to branch(call itself recursively) to find all required TCBs. Those found TCBs are then saved in a list as tuples (TCB,Dir)
+In the last step, they exchange their neighbors.
+== TC states ==
+A track circuit does not have a state as such, but has more or less a list of "reservations"
+type can be one of these:
+TRAIN See Trains obove
+ROUTE Route set from a signal, but no train has yet passed that signal.
+Certain TCs can be marked as "allow call-on".
+== Route setting: ==
+Routes are set from a signal (the entry signal) to another signal facing the same direction (the exit signal)
+Remember that signals are assigned to a TCB and a connid.
+Whenever this is done, the following track circuits are set "reserved" by the train by saving the entry signal's ID:
+- all TCs on the direct way of the route - set as ROUTE
+Route setting fails whenever any TC that we want to set ROUTE to is already set ROUTE or TRAIN from another signal (except call-on, see below)
+Apart from this, we need to set turnouts
+- Turnouts on the track are set held as ROUTE
+- Turnouts that purpose as flank protection are set held as FLANK (NOTE: left as an idea for later, because it's not clear how to do this properly without an engineer)
+== Call-On/Multiple Trains ==
+It will be necessary to join and split trains using call-on routes. A call-on route may be set when:
+- there are no ROUTE reservations
+- there are TRAIN reservations only inside TCs that have "allow call-on" set
+
+
+== More notes ==
+- It may not be possible to switch turnouts when their TC has any state entry
+
+]]--
+
+
+
diff --git a/advtrains_interlocking/init.lua b/advtrains_interlocking/init.lua
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/advtrains_interlocking/init.lua