'
+}
+
/**
* Determines whether a document element should be included in the documentation.
* The element must be included if:
@@ -276,14 +302,12 @@ function processHref ($, documentation) {
for (const docElement of documentation) {
// Modify the href attribute pointing to another section of the documentation
if (docElement.fullClassName === href) {
- const anchorId = createAnchorId(
- docElement.headingNum,
- docElement.headingText
- )
+ const anchorId = createAnchorId(docElement.headingText, docElement.headingNum)
+ $(this).before('Section ')
$(this)
.attr('href', `#${anchorId}`)
.attr('style', 'white-space: nowrap;')
- .text(`Section ${docElement.headingNum}`)
+ .text(`${docElement.headingNum}`)
return
}
}
@@ -396,10 +420,11 @@ function createSectionNum (documentation) {
* the previous heading number.
*
* @param {number} headingIdx - The current heading index.
- * @param {string} prevHeadingNum - The previous heading number in dot-separated format.
+ * @param {string} [prevHeadingNum='0'] - The previous heading number in dot-separated format.
+ *
* @returns {string} The new heading number in dot-separated format.
*/
-function createHeadingNum (headingIdx, prevHeadingNum) {
+function createHeadingNum (headingIdx, prevHeadingNum = '0') {
const prevHeadingSplit = prevHeadingNum.split('.')
if (headingIdx <= prevHeadingSplit.length) {
return [
@@ -409,33 +434,19 @@ function createHeadingNum (headingIdx, prevHeadingNum) {
} else return [...prevHeadingSplit, 1].join('.')
}
-/**
- * Creates a nomenclature for the sorted documentation array by adding heading
- * indices and numbers.
- *
- * @param {Array
1.2. Minimum outdoor airflow setting
@@ -41,7 +41,7 @@
Section 4
+Section 4
for more detailed description.
1.4. Supply air temperature setpoint
@@ -52,7 +52,7 @@
TOut and operation mode uOpeMod are used
along with the maximum supply air temperature, for computing the supply air temperature
setpoint. See
-Section 7
+Section 7
for more detailed description.
1.5. Coil valve control
@@ -61,7 +61,7 @@
Section 6
+Section 6
for more detailed description.
1.6. Freeze protection
@@ -70,7 +70,7 @@
Section 2
+Section 2
for more detailed description.
1.7. Building pressure control
@@ -88,7 +88,7 @@
Relief fan control
-Section 10 is not
+Section 10 is not
included in the AHU controller. This sequence controls all the relief fans that are
serving one common space, which may include multiple air handling units.
@@ -107,10 +107,12 @@
Section 3
+Section 3
for more detailed description.
-
This sequence outputs the system reset requests for multiple zone air handling unit. The
implementation is according to the Section 5.16.16 of ASHRAE Guideline 36, May 2020.
@@ -238,7 +242,9 @@
Block that outputs the supply air temperature setpoint and the coil valve control
inputs for VAV system with multiple zones, implemented according to Section 5.16.2 of
@@ -430,7 +442,7 @@
-
+
Variable
Value
Definition
Device
AHU Supply Fan
Associated device
SP0
iniSet (18 °C, adjustable)
Initial setpoint
@@ -446,8 +458,8 @@
-
-
+
+
7.3. During Cool-down modes (uOpeMod=3)
@@ -460,7 +472,9 @@
Supply air temperature setpoint TSupSet shall be TSupWarUpSetBac (35 °C, adjustable).
-
8. Minimum outdoor airflow setpoint, when complying with ASHRAE 62.1 requirements
9. Minimum outdoor airflow setpoint, when complying with Title 24 requirements
This sequence outputs AHU level effective outdoor air absolute minimum and design
minimum setpoints VEffAbsOutAir_flow, VEffDesOutAir_flow and
@@ -570,7 +586,9 @@
Sequence for controling relief fan that is part of AHU. It is developed based on
Section 5.16.9 of ASHRAE Guideline 36, May 2020, with the modification to accommodate
@@ -593,7 +611,7 @@
Fan speed shall be equal to the PID signal but no less than the minimum speed.
-
+
When relief system is enabled, and the control loop
output is above 5%, open the motorized dampers to the relief fans;
@@ -610,20 +628,22 @@
-
10.1. Damper position limits for units with separated minimum outdoor air damper and airflow measurement
10.2. Damper position limits for units with separated minimum outdoor air damper and airflow measurement
Block that outputs the position limits of the return and outdoor air damper for units
with a separated minimum outdoor air damper and airflow measurement.
It is implemented according to Section 5.16.5 of the ASHRAE Guideline 36, May 2020.
This is a multi zone VAV AHU economizer enable/disable sequence
based on the Section 5.16.7 of the ASHRAE Guideline 36, May 2020. Additional
@@ -687,8 +709,8 @@
The following state machine chart illustrates the transitions between enabling and disabling:
-
-
+
+
After the disable signal is activated, the following procedure is applied, in order to
@@ -706,7 +728,9 @@
disDel (15 s, adjustable) time delay.
-
10.3. Modulate economizer dampers position for buildings with return fan controlling pressure
10.4. Modulate economizer dampers position for buildings with return fan controlling pressure
Block modulates the damper of economizers of buildings with pressure controlled by
return fan and airflow tracking. It is implemented according to Section 5.16.2.3.d,
@@ -718,7 +742,7 @@
10.5. Modulate economizer dampers position for buildings with relief damper or fan controlling pressure
This is a multi zone VAV AHU economizer modulation block. It calculates
the outdoor and return air damper positions based on the supply air temperature
@@ -761,27 +787,29 @@
-
-
+
+
Multi zone AHU economizer modulation control chart:
This block outputs the air economizer high limits according to the energy standard,
device type and climate zone. The implementation is according to the Section 5.1.17 of ASHRAE
Guideline 36, May 2020.
When ASHRAE 90.1-2016 is used.
-
+
Device type
Allowed only in these ASHRAE Climate Zones
Required High Limit (Economizer OFF when)
-
Fixed dry bulb
1b, 2b, 3b, 3c, 4b, 4c, 5b, 5c, 6b, 7, 8
+
Fixed dry bulb
1b, 2b, 3b, 3c, 4b, 4c, 5b, 5c, 6b, 7, 8
outdoor air temperature is higher than 24 °C (TCut=24°C)
@@ -803,7 +831,7 @@
Fixed dry bulb with differential dry bulb
+
Fixed dry bulb with differential dry bulb
1b, 2b, 3b, 3c, 4b, 4c, 5b, 5c, 6b, 7, 8
outdoor air temperature is higher than 24 °C or the return air temperature (TCut=min(24°C, TRet))
@@ -813,10 +841,10 @@
+
Device type
California Climate Zones
Required High Limit (Economizer OFF when)
-
Fixed dry bulb
1, 3, 5, 11 to 16
outdoor air temperature is higher than 24 °C (TCut=24°C)
+
Fixed dry bulb
1, 3, 5, 11 to 16
outdoor air temperature is higher than 24 °C (TCut=24°C)
2, 4, 10
outdoor air temperature is higher than 23 °C (TCut=23°C)
@@ -828,7 +856,7 @@
Differential dry bulb
1, 3, 5, 11 to 16
outdoor air temperature is higher than the return air temperature (TCut=TRet)
+
Differential dry bulb
1, 3, 5, 11 to 16
outdoor air temperature is higher than the return air temperature (TCut=TRet)
2, 4, 10
outdoor air temperature is higher than the return air temperature minus 1 °C (TCut=TRet-1°C)
@@ -844,7 +872,7 @@
Fixed dry bulb with differential dry bulb
1, 3, 5, 11 to 16
+
Fixed dry bulb with differential dry bulb
1, 3, 5, 11 to 16
outdoor air temperature is higher than 24 °C or the return air temperature (TCut=24°C or TCut=TRet)
@@ -865,7 +893,9 @@
10.6. Static pressure setpoint reset using trim and respond logic
True: relief fan is part of AHU; False: the relief fans group that may associate multiple AHUs
-
ControlEconomizer
ecoHigLimCon
Economizer high limit control device
-
CoolingCoil
cooCoi
Cooling coil type
-
HeatingCoil
heaCoi
Heating coil type
-
Boolean
have_perZonRehBox
Check if there is any VAV-reheat boxes on perimeter zones
-
Real
VUncDesOutAir_flow
Uncorrected design outdoor airflow rate, including diversity where applicable. It can be determined using the 62MZCalc spreadsheet from ASHRAE 62.1 User's Manual
m3/s
Real
VDesTotOutAir_flow
Design total outdoor airflow rate. It can be determined using the 62MZCalc spreadsheet from ASHRAE 62.1 User's Manual
m3/s
Real
VAbsOutAir_flow
Design outdoor airflow rate when all zones with CO2 sensors or occupancy sensors are unpopulated. Needed when complying with Title 24 requirements
m3/s
Real
VDesOutAir_flow
Design minimum outdoor airflow rate with the areas served by the system are occupied at their design population, including diversity where applicable. Needed when complying with Title 24 requirements
m3/s
Real
pIniSet
Initial pressure setpoint for fan speed control
Pa
Real
pMinSet
Minimum pressure setpoint for fan speed control
Pa
Real
pMaxSet
Duct design maximum static pressure. It is the Max_DSP shown in Section 3.2.1.1 of Guideline 36
Pa
Real
pDelTim
Delay time after which trim and respond is activated
s
Real
pSamplePeriod
Sample period
s
Integer
pNumIgnReq
Number of ignored requests
-
Real
pTriAmo
Trim amount
Pa
Real
pResAmo
Respond amount (must be opposite in to trim amount)
Pa
Real
pMaxRes
Maximum response per time interval (same sign as respond amount)
Pa
SimpleController
fanSpeCon
Supply fan speed PID controller
-
Real
kFanSpe
Gain of supply fan speed PID controller
-
Real
TiFanSpe
Time constant of integrator block for supply fan speed PID controller
s
Real
TdFanSpe
Time constant of derivative block for supply fan speed PID controller
s
Real
supFanSpe_max
Maximum allowed supply fan speed
-
Real
supFanSpe_min
Lowest allowed supply fan speed if fan is on
-
Real
iniFanSpe
Initial speed when fan is enabled. It has to be greater than the lowest allowed speed
-
Real
TSupCoo_min
Lowest cooling supply air temperature setpoint when the outdoor air temperature is at the higher value of the reset range and above
K
Real
TSupCoo_max
Highest cooling supply air temperature setpoint. It is typically 18 degC (65 degF)
+ in mild and dry climates, 16 degC (60 degF) or lower in humid climates
K
Real
TOut_min
Lower value of the outdoor air temperature reset range. Typically value is 16 degC (60 degF)
K
Real
TOut_max
Higher value of the outdoor air temperature reset range. Typically value is 21 degC (70 degF)
K
Real
TSupWarUpSetBac
Supply temperature in warm up and set back mode
K
Real
delTimSupTem
Delay timer
s
Real
samPerSupTem
Sample period of component
s
Integer
ignReqSupTem
Number of ignorable requests for TrimResponse logic
-
Real
triAmoSupTem
Trim amount
K
Real
resAmoSupTem
Response amount
K
Real
maxResSupTem
Maximum response per time interval
K
SimpleController
valCon
Type of controller for coil valves control
-
Real
kVal
Gain of controller for valve control
-
Real
TiVal
Time constant of integrator block for valve control
s
Real
TdVal
Time constant of derivative block for valve control
s
Real
uHeaCoi_max
Upper limit of controller signal when heating coil is off. Require -1 < uHea_max < uCoo_min < 1.
-
Real
uCooCoi_min
Lower limit of controller signal when cooling coil is off. Require -1 < uHea_max < uCoo_min < 1.
-
SimpleController
minOAConTyp
Type of minimum outdoor air controller
-
Real
kMinOA
Gain of controller
-
Real
TiMinOA
Time constant of integrator block
s
Real
TdMinOA
Time constant of derivative block
s
Boolean
have_CO2Sen
True: some zones have CO2 sensor
-
Real
dpAbsMinOutDam
Absolute minimum pressure difference across the minimum outdoor air damper. It provides the absolute minimum outdoor airflow
-
Real
dpDesMinOutDam
Design minimum pressure difference across the minimum outdoor air damper. It provides the design minimum outdoor airflow
Pa
SimpleController
dpConTyp
Type of differential pressure setpoint controller
-
Real
kDp
Gain of controller
-
Real
TiDp
Time constant of integrator block
s
Real
TdDp
Time constant of derivative block
s
Real
uRetDam_min
Loop signal value to start decreasing the maximum return air damper position
-
Real
delTOutHis
Delta between the temperature hysteresis high and low limit
K
Real
delEntHis
Delta between the enthalpy hysteresis high and low limits
J/kg
Real
retDamFulOpeTim
Time period to keep return air damper fully open before releasing it for minimum outdoor airflow control
+ at disable to avoid pressure fluctuations
s
Real
disDel
Short time delay before closing the outdoor air damper at disable to avoid pressure fluctuations
s
Real
retDamPhy_max
Physically fixed maximum position of the return air damper
-
Real
retDamPhy_min
Physically fixed minimum position of the return air damper
-
Real
outDamPhy_max
Physically fixed maximum position of the outdoor air damper
-
Real
outDamPhy_min
Physically fixed minimum position of the outdoor air damper
-
Real
minOutDamPhy_max
Physically fixed maximum position of the minimum outdoor air damper
-
Real
minOutDamPhy_min
Physically fixed minimum position of the minimum outdoor air damper
-
Real
uHeaMax
Lower limit of controller input when outdoor damper opens (see diagram)
-
Real
uCooMin
Upper limit of controller input when return damper is closed (see diagram)
-
Integer
minHotWatReq
Minimum heating hot-water plant request to active the heating plant
-
SimpleController
freProHeaCoiCon
Freeze protection heating coil controller
-
Real
kFrePro
Gain of coil controller
-
Real
TiFrePro
Time constant of integrator block
s
Real
TdFrePro
Time constant of derivative block
s
Real
yMaxFrePro
Upper limit of output
-
Real
yMinFrePro
Lower limit of output
-
Real
dpBuiSet
Building static pressure difference relative to ambient (positive to pressurize the building)
Pa
Real
kRelDam
Gain, applied to building pressure control error normalized with dpBuiSet
-
Real
difFloSet
Airflow differential between supply air and return air fans required to maintain building pressure at desired pressure
m3/s
SimpleController
retFanCon
Type of controller for return fan
-
Real
kRetFan
Gain, normalized using dpBuiSet
-
Real
TiRetFan
Time constant of integrator block
s
Real
TdRetFan
Time constant of derivative block
s
Real
retFanSpe_max
Maximum return fan speed
-
Real
retFanSpe_min
Minimum return fan speed
-
Real
p_rel_RetFan_min
Minimum return fan discharge static pressure difference setpoint
Pa
Real
p_rel_RetFan_max
Maximum return fan discharge static pressure difference setpoint
Pa
Real
relFanSpe_min
Relief fan minimum speed
-
Real
kRelFan
Gain of relief fan controller, normalized using dpBuiSet
-
Real
Thys
Hysteresis for checking temperature difference
-
Real
posHys
Hysteresis for checking valve position difference
-
Real
hys
Hysteresis for checking the relief fan controller output value
-
Inputs
Type
Name
Description
Unit
Integer
uAhuOpeMod
Operation mode for AHU operation
-
Integer
uZonPreResReq
Zone static pressure reset requests
-
Real
dpDuc
Measured duct static pressure
Pa
Real
TOut
Outdoor air temperature
K
Integer
uZonTemResReq
Zone cooling supply air temperature reset request
-
Boolean
u1SupFan
Supply fan status
-
Real
TAirSup
Measured supply air temperature
K
Real
VSumAdjPopBreZon_flow
Sum of the adjusted population component breathing zone flow rate
m3/s
Real
VSumAdjAreBreZon_flow
Sum of the adjusted area component breathing zone flow rate
m3/s
Real
VSumZonPri_flow
Sum of the zone primary airflow rates for all zones in all zone groups that are in occupied mode
m3/s
Real
uOutAirFra_max
Maximum zone outdoor air fraction, equals to the maximum of primary outdoor air fraction of all zones
-
Real
VSumZonAbsMin_flow
Sum of the zone absolute minimum outdoor airflow setpoint
m3/s
Real
VSumZonDesMin_flow
Sum of the zone design minimum outdoor airflow setpoint
m3/s
Real
VAirOut_flow
Measured outdoor air volumetric flow rate
m3/s
Real
uCO2Loo_max
Maximum zone CO2 control loop output
-
Real
dpMinOutDam
Measured pressure difference across the minimum outdoor air damper
Pa
Real
TAirRet
Used only for fixed plus differential dry bulb temperature high limit cutoff
K
Real
hAirOut
Outdoor air enthalpy
J/kg
Real
hAirRet
OA enthalpy high limit cutoff. For differential enthalpy use return air enthalpy measurement
J/kg
Boolean
u1FreSta
Freeze protection stat signal. The stat is normally close (the input is normally true), when enabling freeze protection, the input becomes false
-
Boolean
u1SofSwiRes
Freeze protection reset signal from software switch
-
Boolean
u1RelFan
Relief fan status
-
Real
TAirMix
Measured mixed air temperature
K
Real
dpBui
Measured building static pressure difference, relative to ambient (positive if pressurized)
Pa
Real
VAirSup_flow
Measured AHU supply airflow rate
m3/s
Real
VAirRet_flow
Measured AHU return airflow rate
m3/s
Outputs
Type
Name
Description
Unit
Real
TAirSupSet
AHU supply air temperature setpoint
K
Real
VEffAirOut_flow_min
Effective minimum outdoor airflow setpoint
m3/s
Real
yMinOutDam
Minimum outdoor air damper commanded position
-
Boolean
y1MinOutDam
Minimum outdoor air damper command on
-
Real
yRetDam
Return air damper commanded position
-
Real
yRelDam
Relief air damper commanded position
-
Real
yOutDam
Economizer outdoor air damper commanded position
-
Boolean
y1EneCHWPum
Commanded on to energize chilled water pump
-
Boolean
y1SupFan
Supply fan command on
-
Real
ySupFan
Air handler supply fan commanded speed
-
Boolean
y1RetFan
Return fan commanded on
-
Real
yRetFan
Return fan commanded speed
-
Boolean
y1RelFan
Relief fan commanded on
-
Real
yRelFan
Relief fan commanded speed
-
Boolean
y1RelDam
True: 2-position relief damper is commanded open
-
Real
yCooCoi
Cooling coil valve commanded position
-
Real
yHeaCoi
Heating coil valve commanded position
-
Integer
yAla
Alarm level
-
Real
yDpBui
Building static pressure difference, relative to ambient (positive if pressurized)
Lower limit of controller input when outdoor damper opens (see diagram)
-
Real
uMax
Upper limit of controller input when return damper is closed (see diagram)
-
Real
uOutDamMax
Maximum loop signal for the OA damper to be fully open
-
Real
uRetDamMin
Minimum loop signal for the RA damper to be fully open
-
Inputs
Type
Name
Description
Unit
Real
uTSup
Signal for supply air temperature control (T Sup Control Loop Signal in diagram)
-
Real
uOutDam_min
Minimum economizer damper position limit as returned by the damper position limits sequence
-
Real
uOutDam_max
Maximum economizer damper position limit as returned by the economizer enable-disable sequence.
+ If the economizer is disabled, this value equals uOutDam_min
-
Real
uRetDam_min
Minimum return air damper position limit as returned by the economizer enable-disable sequence
-
Real
uRetDam_max
Maximum return air damper position limit as returned by the economizer enable-disable sequence
Uncorrected design outdoor airflow rate, including diversity where applicable. It can be determined using the 62MZCalc spreadsheet from ASHRAE 62.1 User's Manual
m3/s
Real
VDesTotOutAir_flow
Design total outdoor airflow rate. It can be determined using the 62MZCalc spreadsheet from ASHRAE 62.1 User's Manual
m3/s
Inputs
Type
Name
Description
Unit
Real
VSumAdjPopBreZon_flow
Sum of the adjusted population component breathing zone flow rate
m3/s
Real
VSumAdjAreBreZon_flow
Sum of the adjusted area component breathing zone flow rate
m3/s
Real
VSumZonPri_flow
Sum of the zone primary airflow rates for all zones in all zone groups that are in occupied mode
m3/s
Real
uOutAirFra_max
Maximum zone outdoor air fraction
-
Real
VAirOut_flow
Measured outdoor air volumetric flow rate
m3/s
Outputs
Type
Name
Description
Unit
Real
VUncOutAir_flow
Uncorrected minimum outdoor airflow rate
m3/s
Real
VEffAirOut_flow_min
Effective minimum outdoor airflow setpoint
m3/s
Real
effOutAir_normalized
Effective minimum outdoor airflow setpoint, normalized by the design total outdoor airflow rate
Lowest cooling supply air temperature setpoint when the outdoor air temperature is at the
+ higher value of the reset range and above
K
Real
TSupCoo_max
Highest cooling supply air temperature setpoint. It is typically 18 degC (65 degF)
+ in mild and dry climates, 16 degC (60 degF) or lower in humid climates
K
Real
TOut_min
Lower value of the outdoor air temperature reset range. Typically value is 16 degC (60 degF)
K
Real
TOut_max
Higher value of the outdoor air temperature reset range. Typically value is 21 degC (70 degF)
K
Real
TSupWarUpSetBac
Supply temperature in warm up and set back mode
K
Real
delTim
Delay timer
s
Real
samplePeriod
Sample period of component
s
Integer
numIgnReq
Number of ignorable requests for TrimResponse logic
-
Real
triAmo
Trim amount
K
Real
resAmo
Response amount
K
Real
maxRes
Maximum response per time interval
K
Real
TDeaBan
Default supply temperature setpoint when the AHU is disabled