Document AStop

pyproject.toml

@@ -27,6 +27,7 @@ modern-sphinx-version-warning = "==1.1.6"
 sphinxcontrib-htmlhelp = "==2.1.0"
 sphinxcontrib-serializinghtml = "==2.0.0"
 sphinxcontrib-svg2pdfconverter = "==1.2.2"
+sphinxcontrib-video = "==0.2.1"
 sphinxext-delta = "==0.2.0"
 sphinxext-mimic = "==0.1.1"
 sphinxext-opengraph = "==0.9.0"

source/_static/css/frc-rtd.css

@@ -38,6 +38,15 @@
 	width: 320px;
 }
 
+/*
+* Prevent video containers from spilling over the edges of the main panel.
+* This matches the built-in style for `.rst-content img`
+*/
+.rst-content video {
+	max-width: 100%;
+	height: auto;
+}
+
 .document img {
 	margin-bottom: 10px;
 }

source/conf.py

@@ -41,6 +41,7 @@
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.intersphinx",
     "sphinxcontrib.rsvgconverter",
+    "sphinxcontrib.video",
     "sphinxext.delta",
     "sphinxext.opengraph",
     "sphinxext.photofinish",

source/docs/beta/tasks/task-4-new-features.rst

@@ -10,6 +10,8 @@ The purpose of this task is to test any newly developed or heavily modified feat
 
 **All languages**
 
+- Use the new A-Stop functionality built into the :doc:`Driver Station's Practice mode </docs/software/driverstation/driver-station>`.
+
 **LabVIEW**
 
 **Java**

source/docs/software/driverstation/driver-station.rst

@@ -21,6 +21,23 @@ The FRC Driver Station can be launched by double-clicking the icon on the Deskto
   * :kbd:`[` + :kbd:`]` + :kbd:`\\` - Enable the robot (the 3 keys above Enter on most keyboards)
   * :kbd:`Enter` - Disable the Robot
   * :kbd:`Space` - Emergency Stop the robot. After an emergency stop is triggered the roboRIO will need to be rebooted before the robot can be enabled again.
+  * :kbd:`Backspace` - "A-Stop" the robot when in Practice Mode - Autonomous Enabled. The robot will be disabled until the Practice Mode reaches Teleop then will be automatically re-enabled. While disabled, the application background will flash orange indicating the robot will re-enable automatically.
+
+.. only:: html
+
+   .. video:: images/driver-station/ds-astop.mp4
+      :loop:
+      :width: 900
+      :autoplay:
+      :muted:
+      :alt: Driver Station flashing orange in A-Stop mode
+
+.. only:: not html
+
+    .. figure:: images/driver-station/ds-astop.png
+       :alt: Driver Station flashing orange in A-Stop mode
+
+       View this page in the web documentation for an animation of the A-Stop behavior
 
 .. note:: Space bar will E-Stop the robot regardless of if the Driver Station window has focus or not
 
@@ -58,7 +75,7 @@ The Operations Tab is used to control the mode of the robot and provide addition
 
   - Teleoperated Mode causes the robot to run the code in the Teleoperated portion of the match.
   - Autonomous Mode causes the robot to run the code in the Autonomous portion of the match.
-  - Practice Mode causes the robot to cycle through the same transitions as an FRC match after the Enable button is pressed (timing for practice mode can be found on the setup tab).
+  - Practice Mode causes the robot to cycle through the same transitions as an FRC match after the Enable button is pressed (timing for practice mode can be found on the setup tab). When Practice Mode is in use, the DS will flash the background orange to indicate a pending enable (either the start of Autonomous or the start of Teleop after an A-Stop).
   - :doc:`Test Mode </docs/software/basic-programming/using-test-mode>` is an additional mode where test code that doesn't run in a regular match can be tested.
 
 2. Enable/Disable - These controls enable and disable the robot. See also `Driver Station Key Shortcuts`_.

source/requirements.txt

@@ -86,6 +86,7 @@ sphinxcontrib-jsmath==1.0.1 ; python_version >= "3.9" and python_version < "3.13
 sphinxcontrib-qthelp==2.0.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxcontrib-serializinghtml==2.0.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxcontrib-svg2pdfconverter==1.2.2 ; python_version >= "3.9" and python_version < "3.13"
+sphinxcontrib-video==0.2.1 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-delta==0.2.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-mimic==0.1.1 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-opengraph==0.9.0 ; python_version >= "3.9" and python_version < "3.13"