LDR6500D显示器固件开发避坑指南：Alt Mode协商×多口功率分配×OSD联动状态反馈的协议层实现路径

// Alt Mode 协商状态机（适用于 LDR6500D 显示器场景）
enum PD_State { DETECT, CAPS_SENT, REQUEST_RCVD, ACCEPTED, ALT_MODE_ENTRY, ALT_MODE_ACTIVE };

void PD_State_Machine(uint8_t port_id, PD_Message_t *msg) {
    static PD_State state[PORT_MAX];
    PD_State next_state = state[port_id];

    switch (msg->type) {
        case PD_MSG_ATTENTION:
            // 对端请求重新评估功率，预留重构 PDO 的入口
            next_state = CAPS_SENT;
            Send_Source_Caps(port_id);
            break;

        case PD_MSG_GET_SOURCE_CAP:
            // 对端请求能力广播
            Send_Source_Caps(port_id);
            break;

        case PD_MSG_REQUEST:
            // 核心握手节点：评估请求 PDO 是否在预算内
            if (Evaluate_PDO_Request(msg->pdo, port_id) == PASS) {
                Accept_Request(port_id);
                next_state = ACCEPTED;
                Start_Power_Sequence(port_id);
            } else {
                Reject_Request(port_id);
                Log_Reject_Reason(msg->pdo, port_id);
            }
            break;

        case PD_MSG_PS_RDY:
            // 对端电源就绪，确认链路建立
            if (next_state == ACCEPTED) {
                next_state = ALT_MODE_ENTRY;
                Initiate_AltMode_Entry(port_id, VDO_SVID_DISPLAYPORT);
            }
            break;

        case PD_MSG_VDM_DISCOVER:
            // Alt Mode VDM 交换入口
            Respond_Discover_VDO(port_id);
            break;

        case PD_MSG_VDM_ENTER:
            // 进入 Alt Mode 确认（LDR6500D 内置 DP AM 逻辑）
            if (Validate_VDO_Enter(msg->vdo) == PASS) {
                Send_Enter_Ack(port_id);
                Switch_To_DP_Mode(port_id);  // CC 通道切换为 DP 协议
                next_state = ALT_MODE_ACTIVE;
                Notify_OSD(MODE_VIDEO_ACTIVE);  // 触发 OSD 联动
            } else {
                Send_Enter_Nack(port_id);
            }
            break;

        default:
            // 未预期消息，打印日志用于 debug
            Log_Unexpected_Message(msg->type, port_id);
            break;
    }

    state[port_id] = next_state;
}

// 多口功率动态分配算法（以两 USB-C 口为例）
#define TOTAL_BUDGET_WATT   65   // 整机功率预算（视设计而定）
#define PORT_COUNT          2

typedef struct {
    uint8_t port_id;
    uint8_t current_pdo_index;     // 当前协商的 PDO 档位
    uint16_t power_allocated_W;   // 已分配功率
    bool connected;
    bool power_ready;
} Port_Context;

Port_Context port_ctx[PORT_COUNT];

void Recalculate_Power_Allocation(void) {
    uint16_t total_connected_power = 0;
    uint8_t i;

    // Step 1: 汇总已连接的端口当前功率需求
    for (i = 0; i < PORT_COUNT; i++) {
        if (port_ctx[i].connected) {
            total_connected_power += Get_PDO_Power(port_ctx[i].current_pdo_index);
        }
    }

    // Step 2: 检测是否超出总预算
    if (total_connected_power <= TOTAL_BUDGET_WATT) {
        // 未超预算，全部端口维持当前协商结果
        return;
    }

    // Step 3: 超预算场景下的优先级策略（可定制）
    // 策略A：视频优先（连接有 DP Alt Mode 的端口优先）
    // 策略B：先到先得（已协商端口锁定功率，新端口降级）
    // 策略C：平均分配

    // 以下采用策略A简化示例
    uint8_t video_port = Find_Video_Capable_Port();

    for (i = 0; i < PORT_COUNT; i++) {
        if (i == video_port) continue;  // 视频口保留全额
        if (port_ctx[i].connected) {
            // 非视频口降级到次档 PDO
            uint8_t fallback_pdo = Find_Fallback_PDO(port_ctx[i].current_pdo_index);
            if (fallback_pdo != port_ctx[i].current_pdo_index) {
                Send_Request(port_ctx[i].port_id, fallback_pdo);
            }
        }
    }
}

void On_Port_Connect(uint8_t port_id) {
    port_ctx[port_id].connected = true;
    port_ctx[port_id].current_pdo_index = 0;
    Recalculate_Power_Allocation();
}

void On_Port_Disconnect(uint8_t port_id) {
    port_ctx[port_id].connected = false;
    port_ctx[port_id].power_ready = false;
    Recalculate_Power_Allocation();  // 重新释放功率给其他口
}

// PD 状态到 OSD 变量的映射函数
typedef struct {
    char voltage_str[8];      // 如 "20V"
    char current_str[8];      // 如 "3.25A"
    char power_role_str[16]; // 如 "PD Sink"
    char alt_mode_str[16];   // 如 "DP Active"
    uint8_t error_code;
} OSD_PD_Status;

void Update_OSD_PD_Status(uint8_t port_id) {
    OSD_PD_Status osd_data;
    PD_Negotiation_Result_t result = Get_PD_Result(port_id);

    // 功率档位转字符串
    uint16_t voltage = Get_Negotiated_Voltage(port_id);
    uint16_t current = Get_Negotiated_Current(port_id);
    snprintf(osd_data.voltage_str, sizeof(osd_data.voltage_str), "%dV", voltage / 1000);
    snprintf(osd_data.current_str, sizeof(osd_data.current_str), "%d.%02dA",
             current / 1000, (current % 1000) / 10);

    // 数据角色识别
    if (result.power_role == POWER_ROLE_SINK) {
        strcpy(osd_data.power_role_str, "PD Sink (充电中)");
    } else if (result.power_role == POWER_ROLE_SOURCE) {
        strcpy(osd_data.power_role_str, "PD Source (供电中)");
    } else {
        strcpy(osd_data.power_role_str, "未协商");
    }

    // Alt Mode 状态
    if (result.alt_mode_active) {
        if (result.alt_mode_svid == 0xFF01) {
            strcpy(osd_data.alt_mode_str, "DP Alt Mode");
        } else {
            strcpy(osd_data.alt_mode_str, "Alt Mode已激活");
        }
    } else {
        strcpy(osd_data.alt_mode_str, "USB Only");
    }

    // 错误码处理
    osd_data.error_code = result.last_error;

    // 推送到 OSD UI 渲染层（具体 API 取决于显示器主控平台）
    Push_To_OSD_Queue(OSD_ITEM_PD_STATUS, &osd_data, sizeof(osd_data));
}

// 在 Alt Mode 协商完成后调用
void PD_AltMode_Negotiation_Callback(uint8_t port_id, bool success) {
    if (success) {
        Update_OSD_PD_Status(port_id);
        // 可选：触发 OSD 自动弹出「连接成功」提示
        Trigger_OSD_Toast("USB-C %s", success ? "已连接" : "协商失败");
    }
}