mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-11-30 03:26:13 +01:00
87 lines
3.3 KiB
C
87 lines
3.3 KiB
C
/* This is an automation example file.
|
|
* The presence of a file calle "myAutomation.h" brings EX-RAIL code into
|
|
* the command station.
|
|
* The auotomation may have multiple concurrent tasks.
|
|
* A task may
|
|
* - Act as a ROUTE setup macro for a user to drive over
|
|
* - drive a loco through an AUTOMATION
|
|
* - automate some cosmetic part of the layout without any loco.
|
|
*
|
|
* At startup, a single task is created to execute the first
|
|
* instruction after E$XRAIL.
|
|
* This task may simply follow a route, or may START
|
|
* further tasks (thats is.. send a loco out along a route).
|
|
*
|
|
* Where the loco id is not known at compile time, a new task
|
|
* can be creatd with the command:
|
|
* </ START [cab] route>
|
|
*
|
|
* A ROUTE, AUTOMATION or SEQUENCE are internally identical in ExRail terms
|
|
* but are just represented differently to a Withrottle user:
|
|
* ROUTE(n,"name") - as Route_n .. to setup a route through a layout
|
|
* AUTOMATION(n,"name") as Auto_n .. to send the current loco off along an automated journey
|
|
* SEQUENCE(n) is not visible to Withrottle.
|
|
*
|
|
*/
|
|
|
|
EXRAIL // myAutomation must start with the EXRAIL instruction
|
|
// This is the default starting route, AKA SEQUENCE(0)
|
|
SETLOCO(3) // set current loco id...
|
|
START(1) // send current loco off along route 1
|
|
SETLOCO(10) // set current loco id...
|
|
START(2) // send current loco off along route 2
|
|
DONE // This just ends the startup thread, leaving 2 others running.
|
|
|
|
/* SEQUENCE(1) is a simple shuttle between 2 sensors
|
|
* S10 and S11 are sensors pre-defined with the <S> command
|
|
* S10 S11
|
|
* === START->================
|
|
*/
|
|
SEQUENCE(1)
|
|
DELAY(10000) // wait 10 seconds
|
|
FON(3) // Set Loco Function 3, Horn on
|
|
DELAY(1000) // wait 1 second
|
|
FOFF(3) // Horn off
|
|
FWD(80) // Move forward at speed 80
|
|
AT(11) // until we hit sensor id 11
|
|
STOP // then stop
|
|
DELAY(5000) // Wait 5 seconds
|
|
FON(2) // ring bell
|
|
REV(60) // reverse at speed 60
|
|
AT(10) // until we get to S10
|
|
STOP // then stop
|
|
FOFF(2) // Bell off
|
|
FOLLOW(1) // and follow sequence 1 again
|
|
|
|
/* SEQUENCE(2) is an automation example for a single loco Y shaped journey
|
|
* S1,S2,S3 are sensors, T4 is a turnout
|
|
*
|
|
* S3 T4 S1
|
|
* ===-START->=============================================
|
|
* //
|
|
* S2 //
|
|
* ======================//
|
|
*
|
|
* Train runs from START to S1, back to S2, again to S1, Back to start.
|
|
*/
|
|
SEQUENCE(2)
|
|
FWD(60) // go forward at DCC speed 60
|
|
AT(1) STOP // when we get to sensor 1
|
|
DELAY(10000) // wait 10 seconds
|
|
THROW(4) // throw turnout for route to S2
|
|
REV(45) // go backwards at speed 45
|
|
AT(2) STOP // until we arrive at sensor 2
|
|
DELAY(5000) // wait 5 seconds
|
|
FWD(50) // go forwards at speed 50
|
|
AT(1) STOP // and stop at sensor 1
|
|
DELAY(5000) // wait 5 seconds
|
|
CLOSE(4) // set turnout closed
|
|
REV(50) // reverse back to S3
|
|
AT(3) STOP
|
|
DELAY(20000) // wait 20 seconds
|
|
FOLLOW(2) // follow sequence 2... ie repeat the process
|
|
|
|
ENDEXRAIL // marks the end of the EXRAIL program.
|
|
|
|
|