1
0
mirror of https://github.com/DCC-EX/CommandStation-EX.git synced 2024-11-23 08:06:13 +01:00
CommandStation-EX/myAutomation.example.h

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.