park_locomotive
End a locomotive's session by ramping down speed, setting direction forward, turning off lights, and releasing the throttle in one call.
Instructions
Put ONE locomotive to rest for the session: smooth stop, forward, lights off, throttle released.
Args: address: The locomotive's DCC address.
Use for "éteins la loco"/"coupe les moteurs"/"put the 3 to bed"/
"park the autorail"/"shut down the autorail" — end-of-session
shutdown for one locomotive, not a mid-run pause (use stop).
NOT stop/emergency_stop (speed only, throttle stays acquired,
lights untouched) and NOT set_power (DCC station's own power,
JMRI-wide). This tool only touches this one locomotive's session
state (speed + lights + release), never system power.
Four steps, one call: (1) ramp down to 0, duration scaled to current speed (up to ~3s at full speed, shorter/none if already slow); (2) flip to forward if in reverse (safe, since speed is 0 by now); (3) turn off every light-related function, same as set_loco_lights(address, False); (4) release the throttle.
If never acquired, steps 1-2 are skipped, but step 3 still auto-acquires (like set_loco_lights always does) so step 4 always has something to release.
Never call set_speed/stop, set_direction, set_loco_lights, and release_throttle yourself in sequence for a shutdown request — use this tool.
Returns {"address", "stopped": bool, "direction": "forward", "lights": , "released": bool}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |