Device Specifications

Device Specifications

Overview

Device specifications define the power characteristics and management capabilities of different types of datacenter equipment. They serve as templates that describe how various device models behave, consume power, and can be managed by DPS. All data center entities refer to the device specifications by device type and model, so before defining any entities and topologies, device specifications must be available.

Device specifications are stored in YAML files and imported into DPS before creating entities and topologies.

DPS provides a basic set of standard devices that is always available. If desired, standard devices can be overridden using dpsctl upsert.

Device Types

Compute Devices

ComputerSystem - Servers or nodes:

- type: ComputerSystem
  description: NVIDIA GB200 Compute Tray (Bianca)
  model: DGX_GB200
  spec:
    devices:
      - type: CPU
        model: Grace
        count: 2
      - type: GPU
        model: GB200
        count: 4
    minLoadWatts: 900
    maxLoadWatts: 5640
    processorModulesCount: 2

GPU - Individual graphics processing units:

- type: GPU
  description: NVIDIA GB200 GPU
  model: GB200
  spec:
    minLoadWatts: 200
    maxLoadWatts: 1200
    wppsSupport: true

CPU - Central processing units:

- type: CPU
  description: NVIDIA Grace CPU
  model: Grace
  spec:
    minLoadWatts: 50
    maxLoadWatts: 420

Power Distribution Devices

PowerDomain - Top-level pseudo-device:

- type: PowerDomain
  description: Generic Power Domain 95 Pct Eff
  spec:
    efficiencyFactor: 0.95

PowerDistribution - PDUs and power distribution equipment:

- type: PowerDistribution
  description: Generic Rack PDU at 57500W 95 Pct Eff
  model: RackPDU95_57500W
  spec:
    maxLoadWatts: 57500
    efficiencyFactor: 0.95

PowerSupply - Individual power supply units:

- type: PowerSupply
  description: Generic Power Supply at 3300W 95 Pct Eff
  model: PowerSupply95_3300W
  spec:
    maxLoadWatts: 3300
    efficiencyFactor: 0.95

Core Properties

Power Characteristics

• minLoadWatts - Idle power consumption
• maxLoadWatts - Peak power consumption
• efficiencyFactor - Power conversion efficiency

Management Integration

• wppsSupport - Workload power profile support (GPUs)
• devices - Sub-components for composite devices

Usage

Device specifications are imported using dpsctl:

# Import device specifications
dpsctl device upsert devices.yaml

# List registered devices
dpsctl device list

Entities reference device specifications by type and model:

{
  "Type": "ComputerSystem",
  "Model": "DGX_GB200",
  "Name": "node001"
}

Further Reading

• Entities - Physical instances of devices
• Topologies - Device connectivity and relationships
• Power Policies - Power management configurations