> ## 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.

# 风扇

Dragonwing IQ‑8275 EVK 的设计功耗最高可达 70 W,因此需要强有力的散热解决方案。默认的散热方案基于风扇,使用安装在设备底部的 CPU 散热器。

本板卡使用的风扇控制器是 Texas Instruments AMC6821SQDBQRQ1 PWM 风扇控制器 IC。风扇通过主板上的 JFAN 连接器(S6B‑XH‑SM4‑TB(LF)(SN))连接。

<img src="https://mintcdn.com/qualcomm-prod/Bh7DlgudKfjY_3Wf/Linux/images/peripheral-interfaces/IQ9075_Thermal_Headsink_Fan.png?fit=max&auto=format&n=Bh7DlgudKfjY_3Wf&q=85&s=d41e8eb5bfec15230eda4e2eb7ac88c3" width="1470" height="350" data-path="Linux/images/peripheral-interfaces/IQ9075_Thermal_Headsink_Fan.png" />

**IQ-8275 EVK 主板上的风扇连接器详情:**

<img src="https://mintcdn.com/qualcomm-prod/Bh7DlgudKfjY_3Wf/Linux/images/peripheral-interfaces/IQ9075_JFAN_connector.png?fit=max&auto=format&n=Bh7DlgudKfjY_3Wf&q=85&s=2ecdd2d7e83c96175ab8e59adc98490f" width="884" height="530" data-path="Linux/images/peripheral-interfaces/IQ9075_JFAN_connector.png" />

## 概述

风扇控制器根据温度输入调节风扇转速,以确保最佳的散热性能和能效。它支持多种工作模式,并可通过系统节点动态配置。

## 特性

* 支持两种工作模式:手动模式和自动模式(模式 2)
* 基于温度输入的动态风扇转速控制

## 工作模式

| 模式             | 说明                              |
| -------------- | ------------------------------- |
| **手动模式(模式 1)** | 风扇转速由用户手动设置。不进行基于温度的自动控制。       |
| **自动模式(模式 2)** | 风扇转速根据远程温度传感器的读数自动控制。这是当前启用的模式。 |

## 工作原理

<Steps>
  <Step title="初始化">
    系统启动并加载风扇控制器配置。
  </Step>

  <Step title="模式选择">
    将 `pwm1_enable` 节点设置为 `2` 以启用自动模式。
  </Step>

  <Step title="温度监测">
    远程温度传感器持续监测系统温度。
  </Step>

  <Step title="PWM 调节">
    控制器根据温度调节 PWM 信号(0–255)以控制风扇转速。
  </Step>

  <Step title="风扇转速控制">
    风扇转速(`fan1_input`)相应地增加或减少。
  </Step>

  <Step title="阈值处理">
    如果温度降至 `temp2_auto_point1_temp` 以下,风扇将关闭。
  </Step>
</Steps>

## 模式详情与验证

<Tabs>
  <Tab title="自动模式(模式 2)">
    ### 说明

    在自动模式下,风扇转速根据远程温度传感器(`temp2_input`)自动控制。系统根据预定义的温度阈值调整风扇功率和转速,以确保高效散热。

    ### 节点路径

    所有相关节点位于:

    ```bash theme={null}
    /sys/class/hwmon/hwmonX/
    ```

    <img src="https://mintcdn.com/qualcomm-prod/Bh7DlgudKfjY_3Wf/Linux/images/peripheral-interfaces/IQ9075_Fan_hwmon_nodes.png?fit=max&auto=format&n=Bh7DlgudKfjY_3Wf&q=85&s=d0bd78ddfd7e397c59807a018e404ef0" width="974" height="351" data-path="Linux/images/peripheral-interfaces/IQ9075_Fan_hwmon_nodes.png" />

    ### 温度阈值

    | 温度范围(°C)    | 节点值(毫摄氏度)                                                   | 风扇行为      | 功率(PWM1) |
    | ----------- | ----------------------------------------------------------- | --------- | -------- |
    | 低于 0°C      | `temp2_auto_point1_temp` = 0                                | 风扇停止      | 0        |
    | 0°C – 48°C  | `temp2_auto_point1_temp` 至 `temp2_auto_point2_temp` = 48000 | 风扇以最低转速运行 | \~85     |
    | 48°C – 58°C | `temp2_auto_point2_temp` 至 `temp2_auto_point3_temp` = 58000 | 风扇高速运行    | 255      |

    ### 关键节点

    | 节点                       | 用途                |
    | ------------------------ | ----------------- |
    | `pwm1_enable`            | 设置为 `2` 以启用自动模式   |
    | `temp2_input`            | 当前远程温度            |
    | `fan1_input`             | 当前风扇转速(RPM)       |
    | `pwm1`                   | 当前输入到风扇的功率(0–255) |
    | `temp2_auto_point1_temp` | 下限阈值(风扇关闭)        |
    | `temp2_auto_point2_temp` | 中间阈值(低速)          |
    | `temp2_auto_point3_temp` | 上限阈值(高速)          |

    ### 验证

    <Note>
      对于 IQ-8275,`amc6821` 位于 `hwmon0`,因此 `X` = `0`。
    </Note>

    <Steps>
      <Step title="确认模式">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/pwm1_enable
        ```

        确保输出为 `2`。
      </Step>

      <Step title="监测温度">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/temp2_input
        ```
      </Step>

      <Step title="检查风扇转速">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/fan1_input
        ```
      </Step>

      <Step title="检查功率输入">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/pwm1
        ```
      </Step>

      <Step title="观察行为">
        * 低于 `temp2_auto_point1_temp`:风扇应停止(`fan1_input` = 0,`pwm1` = 0)
        * 在 point1 与 point2 之间:风扇低速运行(`pwm1` ≈ 85)
        * 在 point2 与 point3 之间:风扇全速运行(`pwm1` = 255)
      </Step>
    </Steps>
  </Tab>

  <Tab title="手动模式(模式 1)">
    ### 说明

    在手动模式下,风扇转速由用户设置,与温度无关。通过 `pwm1` 节点调整输入到风扇控制器的功率。

    ### 节点路径

    所有相关节点位于:

    ```bash theme={null}
    /sys/class/hwmon/hwmonX/
    ```

    ### 关键节点

    | 节点            | 用途                   |
    | ------------- | -------------------- |
    | `pwm1_enable` | 设置为 `1` 以启用手动模式      |
    | `pwm1`        | 设置功率输入以控制风扇转速(0–255) |

    ### 验证

    <Steps>
      <Step title="确认模式">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/pwm1_enable
        ```

        确保输出为 `1`。
      </Step>

      <Step title="调整功率输入">
        ```bash theme={null}
        echo <value> > /sys/class/hwmon/hwmonX/pwm1
        ```

        设置所需的功率输入值(0–255)。
      </Step>

      <Step title="检查风扇转速">
        ```bash theme={null}
        cat /sys/class/hwmon/hwmonX/fan1_input
        ```

        确保风扇转速随设置的功率输入而变化。
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  AMC6821 风扇控制器的实际 hwmon 编号可能会有所不同。要确定正确的编号:

  ```bash theme={null}
  grep "amc6821" hwmon*/name
  ```

  预期输出:

  ```bash theme={null}
  ubuntu@ubuntu:/sys/class/hwmon$ grep "amc6821" hwmon*/name
  hwmon0/name:amc6821
  ```
</Note>