mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-11-22 23:56: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 ROUTES.
|
||
|
|
* This task may simply follow a route, or may SCHEDULE
|
||
|
|
* 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:
|
||
|
|
* </ SCHEDULE [cab] route>
|
||
|
|
*
|
||
|
|
* A ROUTE, AUTOMATION or SEQUENCE are internally identical in ExRail terms
|
||
|
|
* but are just represented differently to a Withrottle user:
|
||
|
|
* ROUTE(n) - as Route_n .. to setup a route through a layout
|
||
|
|
* AUTOMATION(n) as Auto_n .. to send the current loco off along an automated journey
|
||
|
|
* SEQUENCE(n) is not visible to Withrottle.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
ROUTES // myAutomation must start with the ROUTES instruction
|
||
|
|
// This is the default starting route, AKA ROUTE(0)
|
||
|
|
SETLOCO(3) // set current loco id...
|
||
|
|
SCHEDULE(1) // send current loco off along route 1
|
||
|
|
SETLOCO(10) // set current loco id...
|
||
|
|
SCHEDULE(2) // send current loco off along route 2
|
||
|
|
ENDROUTE // This just ends the startup thread, leaving 2 others running.
|
||
|
|
|
||
|
|
/* ROUTE(1) is a simple shuttle between 2 sensors
|
||
|
|
* S10 and S11 are sensors pre-defined with the <S> command
|
||
|
|
* S10 S11
|
||
|
|
* === START->================
|
||
|
|
*/
|
||
|
|
AUTOMATION(1)
|
||
|
|
DELAY(100) // wait 10 seconds
|
||
|
|
FON(3) // Set Loco Function 3, Horn on
|
||
|
|
DELAY(10) // 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(50) // 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 route 1 again
|
||
|
|
|
||
|
|
/* AUTOMATION(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.
|
||
|
|
*/
|
||
|
|
AUTOMATION(2)
|
||
|
|
FWD(60) // go forward at DCC speed 60
|
||
|
|
AT(1) STOP // when we get to sensor 1
|
||
|
|
DELAY(100) // 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(50) // wait 5 seconds
|
||
|
|
FWD(50) // go forwards at speed 50
|
||
|
|
AT(1) STOP // and stop at sensor 1
|
||
|
|
DELAY(50) // wait 5 seconds
|
||
|
|
CLOSE(4) // set turnout closed
|
||
|
|
REV(50) // reverse back to S3
|
||
|
|
AT(3) STOP
|
||
|
|
DELAY(200) // wait 20 seconds
|
||
|
|
FOLLOW(2) // follow route 2... ie repeat the process
|
||
|
|
|
||
|
|
ENDROUTES // marks the end of the ROUTES program.
|
||
|
|
|
||
|
|
|