Skip to content

docs: add fan control guide - #60

Open
Naster17 wants to merge 1 commit into
elektricM:mainfrom
Naster17:main
Open

docs: add fan control guide#60
Naster17 wants to merge 1 commit into
elektricM:mainfrom
Naster17:main

Conversation

@Naster17

Copy link
Copy Markdown
Contributor

Summary

  • Add a dedicated Fan Control page under System Configuration covering software PWM fan control on the BC-250:
    • How the fan headers map to Linux (nct6687 driver, pwm2 = CPU_FAN1)
    • The J4003 multi-fan header next to CPU_FAN1: all five wired fan outputs (pwm1pwm5) are controllable under Linux, with the full channel map (including BIOS fan numbering); pwm6pwm8 are not wired
    • Manual per-channel PWM control with reference RPM values
    • The Naster17/bc250fc toolkit: temperature-based curve daemon (GPU edge temp, 1 s sampling), fan CLI, and a multi-distro installer (apk/apt/dnf/pacman) that builds and persists nct6687
    • The default fan curve, CoolerControl as a GUI alternative, and a BIOS vs software control comparison
    • A Troubleshooting section (Symptoms/Solution format) covering common PWM issues, driver conflicts, and the btop 0°C CPU-temperature quirk after loading nct6687
  • Cross-link the new page from Sensors & Monitoring and fix a broken in-page anchor there (#immutable-atomic-distros-...)

Notes

  • All commands and values were tested on a real board (PWM/RPM measurements, channel writability); the page keeps a neutral tone per the contributing guidelines
  • The bc250fc scripts referenced in the page are MIT-licensed in their own repository

Checklist

  • mkdocs build --strict passes
  • All in-page and cross-page anchors verified against the built site
  • Single commit, docs: prefix, title matches commit subject

Software PWM fan control for the CPU_FAN1 header and the J4003
multi-fan header: manual pwm control per channel, the Naster17/bc250fc
toolkit (temperature-based curve daemon, fan CLI, multi-distro
installer for nct6687), the default GPU-edge temperature curve, a BIOS
vs software comparison, and a troubleshooting section covering common
PWM issues and the btop 0°C sensor-selection quirk after loading
nct6687. Cross-linked from the sensors page, which also gets a
broken-anchor fix.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant