Scenario: Host Command Execution¶
1. Overview¶
This scenario describes the complete flow of host remote command execution, from command send to completion notification.
2. Preconditions¶
| Condition | Required State |
|---|---|
| Communication | COMMUNICATING |
| Control State | ONLINE REMOTE |
| Process State | Varies by command |
3. Command Flow Overview¶
sequenceDiagram
participant Host
participant Equipment
rect rgb(240, 248, 255)
Note over Host,Equipment: Command Request
Host->>Equipment: S2F41 W (RCMD, Parameters)
Equipment-->>Host: S2F42 (HCACK, CPACK)
end
rect rgb(240, 255, 240)
Note over Host,Equipment: Command Execution
Note over Equipment: Execute command...
end
rect rgb(255, 248, 240)
Note over Host,Equipment: Completion Notification
Equipment->>Host: S6F11 W (CommandComplete event)
Host-->>Equipment: S6F12 (ACKC6=0)
end
4. START Command Example¶
4.1 Sequence Diagram¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: IDLE
Host->>Equipment: S2F41 W
Note right of Host: RCMD="START"<br/>RecipeID="RECIPE001"<br/>LotID="LOT001"
Note over Equipment: Validate command
Note over Equipment: Check recipe exists
Note over Equipment: Verify parameters
Equipment-->>Host: S2F42
Note left of Equipment: HCACK=0 (Accepted)
Note over Equipment: State: SETTING UP
Equipment->>Host: S6F11 W (ProcessStateChange)
Host-->>Equipment: S6F12
Note over Equipment: Load recipe
Note over Equipment: Initialize process
Note over Equipment: State: READY
Equipment->>Host: S6F11 W (ProcessStateChange)
Host-->>Equipment: S6F12
Note over Equipment: State: EXECUTING
Equipment->>Host: S6F11 W (ProcessStarted)
Note right of Equipment: Report: RecipeID, LotID, StartTime
Host-->>Equipment: S6F12
4.2 S2F41 Message Structure¶
S2F41 W
<L[2]
<RCMD "START">
<L[2]
<L[2]
<CPNAME "RecipeID">
<CPVAL "RECIPE001">
>
<L[2]
<CPNAME "LotID">
<CPVAL "LOT001">
>
>
>
4.3 S2F42 Success Response¶
5. Command Rejection Scenarios¶
5.1 Wrong Control State¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: ONLINE LOCAL (not REMOTE)
Host->>Equipment: S2F41 W (RCMD="START")
Equipment-->>Host: S2F42 (HCACK=2)
Note left of Equipment: Cannot perform now<br/>(wrong control state)
Response:
5.2 Wrong Process State¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: EXECUTING (cannot START)
Host->>Equipment: S2F41 W (RCMD="START")
Equipment-->>Host: S2F42 (HCACK=2)
Note left of Equipment: Cannot perform now<br/>(wrong process state)
5.3 Invalid Command¶
sequenceDiagram
participant Host
participant Equipment
Host->>Equipment: S2F41 W (RCMD="INVALID_CMD")
Equipment-->>Host: S2F42 (HCACK=1)
Note left of Equipment: Invalid command
5.4 Parameter Error¶
sequenceDiagram
participant Host
participant Equipment
Host->>Equipment: S2F41 W
Note right of Host: RCMD="START"<br/>RecipeID="NONEXISTENT"
Equipment-->>Host: S2F42
Note left of Equipment: HCACK=3 (Parameter error)<br/>CPACK=2 (Illegal value)
Response:
S2F42
<L[2]
<HCACK 3> // Parameter error
<L[1]
<L[2]
<CPNAME "RecipeID">
<CPACK 2> // Illegal value
>
>
>
6. PAUSE and RESUME Commands¶
6.1 Pause Sequence¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: EXECUTING
Host->>Equipment: S2F41 W (RCMD="PAUSE")
Equipment-->>Host: S2F42 (HCACK=0)
Note over Equipment: Complete current step
Note over Equipment: State: PAUSING
Note over Equipment: State: PAUSED
Equipment->>Host: S6F11 W (ProcessPaused)
Note right of Equipment: Report: PauseReason, CurrentStep
Host-->>Equipment: S6F12
6.2 Resume Sequence¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: PAUSED
Host->>Equipment: S2F41 W (RCMD="RESUME")
Equipment-->>Host: S2F42 (HCACK=0)
Note over Equipment: State: EXECUTING
Equipment->>Host: S6F11 W (ProcessResumed)
Host-->>Equipment: S6F12
7. ABORT Command¶
7.1 Abort Sequence¶
sequenceDiagram
participant Host
participant Equipment
Note over Equipment: State: EXECUTING
Host->>Equipment: S2F41 W (RCMD="ABORT")
Equipment-->>Host: S2F42 (HCACK=0)
Note over Equipment: State: ABORTING
Note over Equipment: Safe shutdown sequence
Note over Equipment: State: IDLE
Equipment->>Host: S6F11 W (ProcessAborted)
Note right of Equipment: Report: AbortReason, AbortTime
Host-->>Equipment: S6F12
8. Command Timeout Handling¶
8.1 No Response (T3 Timeout)¶
sequenceDiagram
participant Host
participant Equipment
Host->>Equipment: S2F41 W (RCMD="START")
Note over Equipment: Equipment busy/crashed
Note over Host: T3 timeout (45 sec)
Note over Host: Raise timeout error
8.2 Command Execution Timeout¶
Host should monitor for completion event within expected time:
| Command | Expected Completion | Timeout Action |
|---|---|---|
| START | ProcessStarted event | Query process state |
| PAUSE | ProcessPaused event | Retry or escalate |
| ABORT | ProcessAborted event | Check equipment status |
9. HCACK Response Codes Summary¶
| HCACK | Meaning | Typical Cause |
|---|---|---|
| 0 | Accepted | Command will execute |
| 1 | Invalid command | RCMD not recognized |
| 2 | Cannot perform now | Wrong state |
| 3 | Parameter error | Invalid CPNAME or CPVAL |
| 4 | Async completion | Command queued |
| 5 | Rejected, already in state | e.g., PAUSE when paused |
| 6 | No such object | Object reference invalid |
10. Related Events¶
| Event | CEID | Trigger |
|---|---|---|
| RemoteCommandReceived | 6001 | Any S2F41 received |
| RemoteCommandCompleted | 6002 | Command execution success |
| RemoteCommandFailed | 6003 | Command execution failed |
| ProcessStarted | 101 | START command success |
| ProcessPaused | 104 | PAUSE command success |
| ProcessResumed | 105 | RESUME command success |
| ProcessAborted | 103 | ABORT command success |