> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LED

Dragonwing IQ-8275 EVK 配备了用于监测系统功能（如上电和板级故障）的状态 LED，对调试和板卡启动（bring-up）非常有用。

## LED 指示灯

主板包含多个 LED，为系统状态、电源稳压和调试提供可视化反馈。

| 参考标识符 | 位置 | 颜色 | 功能                   |
| ----- | -- | -- | -------------------- |
| DS1   | 主板 | 绿色 | 保留用于调试               |
| DS8   | 主板 | 绿色 | Ethernet 状态 LED      |
| DS9   | 主板 | 绿色 | Ethernet 状态 LED      |
| DS10  | 主板 | 绿色 | VREG\_3P3\_SIP 指示灯   |
| DS11  | 主板 | 橙色 | VREG\_3P3\_SIP 指示灯   |
| LED1  | 主板 | 绿色 | 通过 GPIO 由软件控制的 RGB 灯 |

**DS1** — 正常运行时不亮。用于内部开发和故障排查。

**DS8** — 指示 Ethernet 接口的链路和活动状态。点亮时表示 Ethernet 端口处于活动状态；闪烁表示正在传输数据。

**DS9** — 功能与 DS8 类似，通常对应第二个 Ethernet 接口或双端口配置。

<Note>
  Ethernet LED（DS8 和 DS9）遵循标准 Ethernet 信号约定：常亮绿色表示链路已建立，闪烁表示有活动。
</Note>

**DS10** — 表示 3.3V 系统级封装（SiP）稳压器已启用且供电正常（PS\_HOLD 信号）。

**DS11** — 为与 DS10 相同的电压轨提供另一种可视化提示，通常用于指示故障或次要状态（例如待机或错误）。

<Note>
  稳压器 LED（DS10 和 DS11）：绿色表示正常运行；橙色可能表示警告或备用状态，具体取决于固件配置。
</Note>

**LED1** — 连接到 GPIO 引脚，允许软件控制 LED 的颜色和行为，用于状态指示或用户自定义模式。可通过 GPIO 17（红）、56（绿）和 57（蓝）进行编程。

## 启动序列

| 启动阶段           | LED 行为                                                        |
| -------------- | ------------------------------------------------------------- |
| **上电自检（POST）** | DS10（绿色）点亮 — 3.3V 供电稳定。DS11（橙色）点亮 — 未检测到故障。DS1 可能短暂闪烁以进行调试检查。 |
| **引导加载程序**     | 若在引导加载程序中配置，LED1 可能显示静态颜色（默认绿色）。Ethernet LED 保持熄灭。            |
| **内核初始化**      | LED1 变为可由软件控制。网络驱动加载后，Ethernet LED（DS8、DS9）开始闪烁。              |
| **操作系统就绪**     | LED1 可显示自定义模式。DS8/DS9 指示链路/活动状态。                              |

## 故障排查

<AccordionGroup>
  <Accordion title="DS1（调试）— LED 持续常亮">
    **可能原因：** 调试模式卡死或固件问题。

    **处理方法：** 对板卡进行断电重启。若问题仍存在，重新烧写引导加载程序或检查调试日志。
  </Accordion>

  <Accordion title="DS8 / DS9（Ethernet）— 操作系统启动后 LED 熄灭">
    **可能原因：** Ethernet 链路未建立或驱动故障。

    **处理方法：** 检查 Ethernet 线缆和端口。验证网络配置并重新加载网络驱动。
  </Accordion>

  <Accordion title="DS10（绿色 – VREG_3P3_SIP）— 上电期间 LED 熄灭">
    **可能原因：** 3.3V 稳压器未启用。

    **处理方法：** 检查电源轨。检查 PMIC 配置并在启动日志中查找稳压器错误。
  </Accordion>

  <Accordion title="DS11（橙色 – VREG_3P3_SIP）— 正常启动期间 LED 点亮">
    **可能原因：** 稳压器故障或过流。

    **处理方法：** 断开外设、测量电压、检查 PMIC 故障寄存器。若问题仍存在，更换板卡。
  </Accordion>

  <Accordion title="LED1（通过 GPIO 的 RGB）— 操作系统启动后颜色不变化">
    **可能原因：** GPIO 控制未初始化。

    **处理方法：** 确认 GPIO 驱动已加载。检查软件配置并通过手动切换 GPIO 进行测试。
  </Accordion>
</AccordionGroup>
