FRS Part 1 Build IO and CCM

P6 - Part 1 Build IO and CCM
Author

CTRL Designer LLC

Published

2024.02.01

1 FRS Work Process Tasks

The following file is used in this documentation:

  • folder: Projects>>CDL-VRT-2023>>P6-FRS-Functional-Requirement-Specification
  • file: P6-CDL-FRS-01-UmV340-YN-v01a.xlsm

FRS work process is divided into six parts:

Index Description
Part 1 Assign IO to CCM and CM
Part 2 Mode of Operation, Steps and Transitions
Part 3 Build CCM Enablement to Steps
Part 4 Review CCM Enablement Matrix Dynamically
Part 5 Review the pCode and Dictionary
Part 6 Build and Modify DSS and SOP

In this section the Part 1 - Assign IO to CCM and CM is documented.

1.1 Tasks Summary

The following worksheets in the FRS workbook are reviewed and explained:

  • {B1-IO}
  • {Work}
  • {B2-RootTags}
  • {B3-Calculation}
  • {B4-Alarms}
  • {B5-Code}

In this section, the following tasks are executed

N Task Description
1 Build {B1-IO} Add All IO required by this UM
2 Review CM Library Check the available CMs
3 Review CCM Library Check available CCM
4 Build {Work} Define Strategies
5 Build {b3-Calculation} or {B5-Code} add additional Calculated Tags
6 Assign CCM for AO Root-Tags Assign AO Root Tags to CCM
7 Assign CCM for DO Root-Tags Assign DO Root Tags to CCM
8 Assign Child-Tag per CCM Assign Additional Tags to CM
9 Review and Plan

1.1.1 Build {B1-IO}

Purpose: The purpose of this step is to copy the IO database .

To Do: The {B1-IO} worksheet is divided into two parts:

  • IO Definition
  • IO to CCM and CM Assignment
Issues N Tag Type Description Base Min Max
NA 1 EV-34001 DO V340 Feed A BV Run Off Run
NA 2 ZSO-34001 DI V340 Feed A BV Open Open Close TRUE
NA 3 EV-34010 DO P340A Product BV Pump Suction Run Off Run
NA 4 ZSO-34010 DI P340A Product BV Pump Suction Open Open Close TRUE
NA 5 EV-34016 DO P340A Product BV Pump Discharge Run Off Run
NA 6 ZSO-34016 DI P340A Product BV Pump Discharge Open Open Close TRUE
NA 7 EV-34026 DO V340 Product Rcycl BV Run Off Run
NA 8 ZSO-34026 DI V340 Product Rcycl BV Open Open Close TRUE
NA 9 EV-34028 DO V340 Product BV Run Off Run
NA 10 ZSO-34028 DI V340 Product BV Open Open Close TRUE
NA 11 FV-34003 AO V340 Feed A Valve 75 0 100
NA 12 FT-34004 AI V340 Feed A 400 0 500
NA 13 LV-34030 AO V340 Product Valve 75 0 100
NA 14 LT-34031 AI V340 Level 70 0 100
NA 15 EY-34012 DO P340A Product Pump Run Off Run
NA 16 JT-34015 AI P340A Product Pump Power 15 0 50
NA 17 ZYR-34013 DI P340A Product Pump Running Run Off Run
NA 18 ZYS-34014 DI P340A Product Pump Stopped Run Off Run
NA 19 PT-34040 AI V340 Pressure NA 0 100

The following the definition of columns in FRS file sheet B1-IO

Column Field Name Note
1 Issues A place holder to document issues, Use your initial + “:” + issue. In the final FRS all issues should be resolved.
2 N A sequential number 1,2,.. For sorting purpose.
3 Tag Name Use the CDL book of convention. It should be similar to the P&ID Tag Name
4 Type

AI: Analog Instrument

AO: Analog Valve (Root Tag)

DO: Digital block valve (Root Tag)

DI: Digital Input

AiCalc: Calculated AI

DiCalc: Calculated DI
5 Tag Description Unit or Equipment Name + Description
6 Base Case Typical value when in RUN Step
7

A-Minimum

D-False

Analog: minimum of the range

Digital: value when it is FALSE
8

A-Maximum

D-True

Analog: maximum of the range

Digital: value when it is TRUE
9 Eng Units Engineering Unit - Use the CDL book of convention

IO Definition

The following table represent the data from {B1-IO} worksheet.

Tag.Name Um.Name X.1..CCM.CM.Class…LibName..V. X.2..CCM.Element
EV-34001 UmV340 DO-01-BlockValve | CCmBlockDo DO
ZSO-34001 UmV340 DO-01-BlockValve | CCmBlockDo DiFBOpen
EV-34010 UmV340 DO-01-BlockValve | CCmBlockDo DO
ZSO-34010 UmV340 DO-01-BlockValve | CCmBlockDo DiFBOpen
EV-34016 UmV340 DO-01-BlockValve | CCmBlockDo DO
ZSO-34016 UmV340 DO-01-BlockValve | CCmBlockDo DiFBOpen
EV-34026 UmV340 DO-01-BlockValve | CCmBlockDo DO
ZSO-34026 UmV340 DO-01-BlockValve | CCmBlockDo DiFBOpen
EV-34028 UmV340 DO-01-BlockValve | CCmBlockDo DO
ZSO-34028 UmV340 DO-01-BlockValve | CCmBlockDo DiFBOpen
FV-34003 UmV340 AO-01a-Pid | CCmL1Cntl AO
FT-34004 UmV340 AO-01a-Pid | CCmL1Cntl AiPvL1
LV-34030 UmV340 AO-01a-Pid | CCmL1Cntl AO
LT-34031 UmV340 AO-01a-Pid | CCmL1Cntl AiPvL1
EY-34012 UmV340 DO-02-Pump | CCmPump DO
JT-34015 UmV340 DO-02-Pump | CCmPump AiPower
ZYR-34013 UmV340 DO-02-Pump | CCmPump DiFBRun
ZYS-34014 UmV340 DO-02-Pump | CCmPump DiFBStop
PT-34040 UmV340 AI-In | CmAnalogIn AI
X.3..CCM.Gen.Name X.4..CCM.Gen.Description X.8..CM.Type
EBVFeedA Feed A Block Valve EBV-34001
EBVFeedA Feed A Block Valve EBV-34001
EBVPmpSuc Pump Suc Block Valve EBV-34010
EBVPmpSuc Pump Suc Block Valve EBV-34010
EBVPmpDis Pump Dis Block Valve EBV-34016
EBVPmpDis Pump Dis Block Valve EBV-34016
EBVRcycl Recycle Block Valve EBV-34026
EBVRcycl Recycle Block Valve EBV-34026
EBVProd Product Block Valve EBV-34028
EBVProd Product Block Valve EBV-34028
FdCntl Feed Controller FC-34003Cntl
FdCntl Feed Controller FC-34003Cntl
LvlCntl Level Controller LC-34030Cntl
LvlCntl Level Controller LC-34030Cntl
Pmp Pump Pmp-34012
Pmp Pump Pmp-34012
Pmp Pump Pmp-34012
Pmp Pump Pmp-34012
Pressure V340 Pressure PT-34040
Column Field Name Note
24 Um-Name Assign the Um + Unit Name Like UmV340
25 [1] CCM-CM-Class Use Pulldown and assign the correct CCM or CM
26 [2] CCM-Element ROOT TAG or the Input Element
27 [3] CCM-Gen-Name See tables below
28 [4] CCM-Gen-Description The short Description
29 [5] Inst-Name Installation Name |
30 [6] Inst-Description The short Description

Generic Name needed for development of the Code.

Tag Name Gen-Name Wrapper-Name
EV34001 EBVFeedA EBV34001
CV34003 FdCntl FC34004Cntl
EY34012 PmpProd PMP34012

or

Tag Name Gen-Name Wrapper-Name
EV-34001 EBV-FeedA EBV-34001
FV-34003 Fd-Cntl FC-34004Cntl
EY-34012 PmpProd PMP-34012

Rules:

1- Block Valves Gen-Name Should start with EBV

2- Controller Gen-Name should end with Cntl

3- Pumps Gen-Name should start with Pmp

1.1.2 Review CCM Library

Purpose: The purpose of this step is to review the CM and CCM libraries.

To Do Please do the following :

  1. Review CM Library
  2. Review CCM Library

The CM and CCM Libraries are documented in the P5

1.1.3 Build {Work}

Purpose: The purpose of this step is to develop the {work} worksheet.

To Do Please do the following :

  1. in {B1-IO} worksheet, filter on the Type column and Select AO and DO
Tag Name Type Tag Description
EV-34001 DO V340 Feed A BV
EV-34010 DO P340A Product BV Pump Suction
EV-34016 DO P340A Product BV Pump Discharge
EV-34026 DO V340 Product Rcycl BV
EV-34028 DO V340 Product BV
FV-34003 AO V340 Feed A Valve
LV-34030 AO V340 Product Valve
EY-34012 DO P340A Product Pump

Therefore there are 6 DO (Block Valve) and 2 AO (Controllers)

  1. Select {work} worksheet
    • Select Row 1 to 27 and paste it 8 times (AO + DO)

  1. Fill the following
N- Strategy CCM-CM-Class | LibName CCM-Element CCM-Gen-Name CCM-Gen-Desc CCM-Wrapper Name
1- Feed Strategy AO-01a-Pid | CCmL1Cntl AO LvlCntl Level Controller LC-34030Cntl

  1. Review the CCM Library and add the following in the CCM-CM-Lib

    Copy and paste

  • CCM Name: CCmL1Cntl
  • Class: AO-01a-Pid
  • Element: AiPvL1Cntl
  • Strategy: AiPvL1 | CmAnalogIn AiPvL1Cntl | CmPid AO | CmAnalogOut
  1. Add FT and FV tag names
  2. Select {B1-IO} sheet and press CTRL + T , then select option W

  1. Return to {Work} worksheet

    This will add the Description of the IO tags.

  1. Add The Tag Name
  2. Review all entries in the {work} worksheets.

1.1.4 Build {b3-Calculation} or {B5-Code}

In this example there is no calculation. Review UmR350 or UmT360

1.1.5 Assign CCM for AO Root-Tags

Purpose: The purpose of this step is to assign IO to CCM or CM objects.

To Do Please do the following:

1- Review the menu Note: In worksheets starting with B, press CTRL + T to get the following menu

Key Description
B1 List All Root-Tags {B1-IO} >> {B2-RootTags}
B2 Add All CCM Child-Tags {B2-RootTags}
B3 Add Additional Tags {B1-IO} >> {B2-RootTags}
B4 Add CCm From Lib and add Data {D-CCM}
B5 Reconcile ALL Ccm New Columns {D-CCM}
B6 Remove all Ccm New Columns {D-CCM}
B7 Delete all D_Ccm Sheets {D-CCM}
B8 Convert Code to PY {B5-Code}
S Save IO and Steps Sheets to BCK file
R Restore IO and Steps Sheets from BCK file}
B9 Generate URL Objects {URL_Objects}
BR Generate FRS Word Report
W Add IO lookup to {Work}
A Display User Forms - Add Root-Tags
B Display User Forms - Add Child-Tags
C Display User Forms - Add Additional-Tags

  1. Select {B1-IO} worksheet

  2. Run B1 | List All Root-Tags {B1-IO} >> {B2-RootTags}

  3. Review {B2-RootTags} worksheet

  4. Run Add All CCM Child-Tags {B2-RootTags}

  5. Review {B2-RootTags} worksheet

  6. Run B3 | Add Additional Tags {B1-IO} >> {B2-RootTags}

  7. Review {B2-RootTags} worksheet

1.1.6 Review and Plan

  1. Save the Workbook