From c4a160c49b3b631cfa43a271b28d3348aa832c53 Mon Sep 17 00:00:00 2001
From: kpetersn <kmpeters@anl.gov>
Date: Fri, 24 Feb 2023 22:24:51 +0000
Subject: [PATCH] Added a step for launching a motor screen

---
 3-Add-simulated-motors.md | 41 +++++++++++++++++++++++++++++++++------
 1 file changed, 35 insertions(+), 6 deletions(-)

diff --git a/3-Add-simulated-motors.md b/3-Add-simulated-motors.md
index 7cd4bb9..3bed9f8 100644
--- a/3-Add-simulated-motors.md
+++ b/3-Add-simulated-motors.md
@@ -136,6 +136,7 @@ index 588dda7..8fddfc1 100644
 
 ### 3.3 Run the IOC
 
+Start the IOC in a screen session:
 ```
 $ ./softioc/xxx.sh start
 ```
@@ -147,6 +148,7 @@ Starting xxx
 ```
 </details>
 
+Confirm that the IOC is running:
 ```
 $ ./softioc/xxx.sh status
 ```
@@ -159,18 +161,45 @@ xxx is running (pid=1914250) in a screen session (pid=1914249)
 ```
 </details>
 
-Things to do:
+Things to do while connected to the IOC's console:
 * see messages when driver was initialized
 * dbl "motor"
-* move motors
+
+Things to do while NOT connected to the IOC's console:
 * grep motor req files in built_*.req
 * grep DVAL in built_positions.sav
 
-### 3.4 Remove simulated motors
+### 3.4 Launch motor screen
+
+Do the following:
+
+1. Launch caQtDM if it isn't already running
+
+```
+$ ./softioc/xxx.sh caqtdm
+```
+
+This launches **my-xxx.ui**:
+
+![screenshot of my-xxx.ui showing the default Motors section](images/my-xxx-motors.png)
+
+2. Click the **Motors 1-8** button on **my-xxx.ui**
+
+This launches **topMotors8.ui**:
+
+![screenshot of topMotors8.ui](images/topMotors8.png)
+
+3. From the **m1** menu of **topMotors8.ui**, choose **m1 (Debug)**
+
+This launches **motorx_all.ui**:
+
+![screenshot of motorx_all.ui](images/motorx_all.png)
+
+### 3.5 Remove simulated motors
 
 Simulated motors behave like real motors, but they don't **misbehave** like real motors, so we'll remove them for now.
 
-#### 3.4.1 Stop the IOC
+#### 3.5.1 Stop the IOC
 
 ```
 $ ./softioc/xxx.sh stop
@@ -183,7 +212,7 @@ Stopping xxx (pid=1914250)
 ```
 </details>
 
-#### 3.4.2 Edit iocsh/motor.iocsh
+#### 3.5.2 Edit iocsh/motor.iocsh
 
 ```
 $ gedit iocsh/motor.iocsh &
@@ -217,7 +246,7 @@ index 273bea4..ce924c3 100644
 ```
 </details>
 
-#### 3.4.3 Run the IOC
+#### 3.5.3 Run the IOC
 
 We run the IOC at this point to confirm the simulated motors have been removed.
 
-- 
GitLab