交换机 POE 端口功率分配策略：高密度部署以太网温湿度传感器时的过载保护机制

管理员手动配置每个端口的最大功率上限：
  interface GigabitEthernet 0/1
    power inline static max 4000   (4W)
  interface GigabitEthernet 0/2
    power inline static max 7000   (7W)

交换机通过 LLDP-MED 协议与 PD 设备协商实际所需功率：
  1. 设备插入 → 交换机先分配一个"探测功率"（通常 15.4W）
  2. PD 通过 LLDP-MED TLV 通告自己的实际功率需求（如 2.5W）
  3. 交换机调整分配，释放多余功率回池

先按静态配置分配，未配置的端口走动态协商。
优先级：静态 > 动态 > 未分类

优先级等级（从高到低）：
  1. Critical（关键）    → 永不掉电，除非交换机整体过载保护
  2. High（高）          → 功率不足时，最后被砍
  3. Low（低）           → 功率不足时，最先被砍
  4. 未配置              → 默认 Low

# Cisco
interface GigabitEthernet 0/1
  power inline priority critical

# H3C
poe priority critical interface GigabitEthernet 1/0/1

# 华为
interface GigabitEthernet 0/1
  poe priority critical

场景：48 口交换机，总预算 740W

设备分布：
  32 路温湿度传感器    × 2.5W = 80W
  8 路四合一一体机     × 6W   = 48W
  4 路摄像头           × 7W   = 28W
  4 路门禁             × 5W   = 20W
  ─────────────────────────────────
  总请求功率                    176W
  
  可用预算 740W × 0.9（安全余量）= 666W
  
  结论：充足，无需担心

场景：24 口 PoE 交换机，总预算 180W

设备分布：
  12 路温湿度传感器  × 2.5W = 30W
  12 路摄像头        × 12W  = 144W
  ─────────────────────────────────
  总请求功率                174W
  
  可用预算 180W × 0.8 = 144W
  
  结论：超了！功率不足，摄像头和传感器会争抢

功率不足时：
  1. 先砍 Priority = Low 的端口
  2. 再砍未配置优先级的端口
  3. 最后砍 Priority = High 的端口
  4. Critical 端口永不砍（除非交换机整体过载保护）

Cisco 日志示例：
%ILPOWER-5-ILPOWER_LOW_POWER: Interface Gi0/12: power denied, low power available
%ILPOWER-7-ILPOWER_PORT_SHUTDOWN: Interface Gi0/12: power shutdown due to power budget exceeded

H3C 日志示例：
POE/4/POWEROVER: Port GigabitEthernet1/0/12 power off due to insufficient power budget

# 动环专用交换机配置模板（Cisco 风格）

# 全局：启用 PoE，设置告警阈值
power inline budget 80%    # 告警阈值 80%
power inline never off all  # 禁止节能模式关闭端口

# 动环端口（1-32）：Critical 优先级
interface range GigabitEthernet 0/1 - 32
  power inline priority critical
  power inline static max 4000    # 限制每口最大 4W
  spanning-tree portfast
  spanning-tree bpduguard enable

# 预留端口（33-48）：Low 优先级，用于未来扩展
interface range GigabitEthernet 0/33 - 48
  power inline priority low
  power inline auto

OID 分支：
  CISCO-POWER-ETHERNET-EXT-MIB
  cpeExtPsePortPwrConsumption   → 每端口当前功耗
  cpeExtPsePortPwrAllocated     → 每端口分配功率
  cpeExtPsePortEnable           → 端口供电状态（1=on, 2=off）
  cpeExtMainPseUsageThreshold   → 全局功率使用率

  关键指标：
    cpeExtPsePowerMonitorTotalConsumption  → 总消耗功率
    cpeExtPsePowerMonitorTotalAllocated    → 总分配功率

from pysnmp.hlapi import *

def get_poe_status(host, community, port=161):
    """通过 SNMP 获取交换机 PoE 状态"""
    oids = {
        'total_consumption': '1.3.6.1.4.1.9.9.402.1.2.1.0',  # 总消耗
        'total_allocated': '1.3.6.1.4.1.9.9.402.1.2.2.0',    # 总分配
        'budget': '1.3.6.1.4.1.9.9.402.1.2.3.0',             # 总预算
    }

    results = {}
    for name, oid in oids.items():
        iterator = getCmd(
            SnmpEngine(),
            CommunityData(community),
            UdpTransportTarget((host, port)),
            ContextData(),
            ObjectType(ObjectIdentity(oid))
        )
        errorIndication, errorStatus, errorIndex, varBinds = next(iterator)
        if not errorIndication and not errorStatus:
            results[name] = int(varBinds[0][1])

    usage_pct = results.get('total_consumption', 0) / results.get('budget', 1) * 100
    results['usage_percent'] = round(usage_pct, 1)

    return results

# 示例
status = get_poe_status('192.168.10.254', 'public')
print(f"PoE 总预算: {status.get('budget', 'N/A')} mW")
print(f"已分配: {status.get('total_allocated', 'N/A')} mW")
print(f"实际消耗: {status.get('total_consumption', 'N/A')} mW")
print(f"使用率: {status.get('usage_percent', 'N/A')}%")

if status.get('usage_percent', 0) > 80:
    print("⚠️ PoE 功率使用率超过 80%，存在过载风险！")

PoE 使用率 > 70%  → 平台提示（黄色）
PoE 使用率 > 85%  → 平台告警（橙色），通知运维
PoE 使用率 > 95%  → 平台紧急告警（红色），触发降级预案
端口被断电       → 立即告警，标记对应传感器为 quality=bad