nominal-voltage-required#

Code

EL.001

Validator

latest+

Compatibility

other

Tags

🔑

Summary#

AC-powered equipment must declare its nominal input voltage. The attribute name varies by equipment class.

Description#

Nominal input voltage is the primary electrical specification used by data center power planning tools. The attribute name differs across equipment classes due to upstream CSV template inconsistencies. See the note below.

Why is it required?#

  • Required for power capacity planning and electrical compatibility checks in facility models

  • Used by electrical simulation runtimes to validate that the facility’s power supply matches the equipment’s rated voltage

  • Without this attribute, validators cannot determine whether AC-powered equipment is compatible with the facility’s electrical infrastructure

Attribute Mapping#

Equipment Class

Attribute

CDU

aif:spec:nominalVoltage

CRAH

aif:spec:electricalNominalVoltage

UPS

aif:spec:electricalInputVoltage

Applies to#

Equipment whose class declares electricalAC.applies in its config/aif-equipment-<class>.json definition: CDU, CRAH and UPS today. Compute rack equipment is excluded because it takes DC power profiles rather than AC parameters.

Note on naming#

Electrical attribute names differ by equipment class. The per-class mapping table above is normative: a validator reads the name given there for the asset’s class.

Examples#

# CDU
def Xform "Generic_CDU" {
    float aif:spec:nominalVoltage = 400.0
}

# CRAH
def Xform "CRAH500" {
    float aif:spec:electricalNominalVoltage = 480.0
}

# UPS
def Xform "UPS5000" {
    float aif:spec:electricalInputVoltage = 480.0
}

How to comply#

Set the appropriate attribute for your equipment class on the default prim of the *Properties.usda sublayer, using the value from the equipment datasheet in volts (V).

For More Information#