From dca476dbd726fdb9a108df2b2b64cfa1a0fc0ed7 Mon Sep 17 00:00:00 2001
From: kpetersn <kmpeters@anl.gov>
Date: Fri, 24 Feb 2023 22:48:10 +0000
Subject: [PATCH] Added a step to launch a screen and try to move a motor while
 the controller isn't running

---
 5-Add-virtual-motors.md | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/5-Add-virtual-motors.md b/5-Add-virtual-motors.md
index 5b2b589..018a4b5 100644
--- a/5-Add-virtual-motors.md
+++ b/5-Add-virtual-motors.md
@@ -323,7 +323,11 @@ index 588dda7..b8f6949 100644
 ```
 </details>
 
-#### 5.8 Run the IOC
+### 5.8 Launch a motor screen
+
+Follow the instructions in [step 3.4](3-Add-simulated-motors.md#34-launch-motor-screen) if a motor screen isn't already open.
+
+### 5.9 Run the IOC
 
 ```
 $ ./softioc/xxx.sh run
@@ -336,11 +340,18 @@ drvAsynIPPortConfigure("VMC_ETH","127.0.0.1:33333", 0, 0, 0)
 2023/01/12 14:38:30.980 VMC_ETH -1 autoConnect could not connect: Can't connect to 127.0.0.1:33333: Connection refused
 ```
 
+<details>
+<summary>Try to move a motor</summary>
+
+The move fails and the motor screen displays a controller error:
+![screenshot of motorx_all.ui showing a controller error](images/motorx_all-controllerError.png)
+</details>
+
 Ctrl+c to kill the IOC.
 
-### 5.9 Start the Virtual Motor Controller
+### 5.10 Start the Virtual Motor Controller
 
-#### 5.9.1 server.py syntax
+#### 5.10.1 server.py syntax
 
 ```
 $ ${SUPPORT_DIR}/motorVMC/python/server.py -h
@@ -358,7 +369,7 @@ Options:
 ```
 </details>
 
-#### 5.9.2 Start servery.py in a different terminal window
+#### 5.10.2 Start servery.py in a different terminal window
 
 ```
 $ xterm -e "${SUPPORT_DIR}/motorVMC/python/server.py -p 33333" &
@@ -371,7 +382,7 @@ Listening on port 33333
 ```
 </details>
 
-### 5.10 Start the IOC
+### 5.11 Start the IOC
 
 Start the IOC in a screen session so the terminal remains usable.
 
-- 
GitLab