Ruby at 08:26, 15 June 2026

2026-06-15T08:26:17Z

← Older revision		Revision as of 16:26, 15 June 2026
Line 5:		Line 5:
	Due to various limitations, we were unable to run tests on Home Assistant OS, so guidance for this setup was previously missing from our tutorial - [https://wiki.geekworm.com/XScript ''XScript'']. Recently, a community member generously shared their configuration workflow - see the original [https://wiki.geekworm.com/NASPi#cs-comment-11256 comment - ''Fan control on Home Assistant / HAOS'']. This contribution greatly completes and improves our tutorial. We extend our sincere gratitude to this friend, and his guide is now included on this page for anyone in need of reference.		Due to various limitations, we were unable to run tests on Home Assistant OS, so guidance for this setup was previously missing from our tutorial - [https://wiki.geekworm.com/XScript ''XScript'']. Recently, a community member generously shared their configuration workflow - see the original [https://wiki.geekworm.com/NASPi#cs-comment-11256 comment - ''Fan control on Home Assistant / HAOS'']. This contribution greatly completes and improves our tutorial. We extend our sincere gratitude to this friend, and his guide is now included on this page for anyone in need of reference.

	Fan control on Home Assistant / HAOS		==Fan control on Home Assistant / HAOS==

	{\| class="wikitable"		{\| class="wikitable"
Line 16:		Line 16:


	<b>Step 1: Read CPU Temperature in HAOS</b>		===<b>Step 1: Read CPU Temperature in HAOS</b>===

	To control the fan, we first need to monitor the temperature.		To control the fan, we first need to monitor the temperature.
Line 24:		Line 24:


	<b>Step 2: Install the "pigpio" Add-on</b>		===<b>Step 2: Install the "pigpio" Add-on</b>===

	To allow HAOS to communicate with the GPIO pins on a hardware level, we need a small background daemon.		To allow HAOS to communicate with the GPIO pins on a hardware level, we need a small background daemon.
Line 34:		Line 34:


	<b>Step 3: Install the PWM Integration via HACS</b>		===<b>Step 3: Install the PWM Integration via HACS</b>===
	:*Open HACS (Home Assistant Community Store) from your sidebar.		:*Open HACS (Home Assistant Community Store) from your sidebar.
	:*Click the three dots in the top right corner and select Custom repositories.		:*Click the three dots in the top right corner and select Custom repositories.
Line 42:		Line 42:


	<b>Step 4: Configure the Fan</b>		===<b>Step 4: Configure the Fan</b>===

	Next, we tell Home Assistant that there is a PWM device connected to GPIO pin 18.		Next, we tell Home Assistant that there is a PWM device connected to GPIO pin 18.
Line 61:		Line 61:


	<b>Step 5: The Automation</b>		===<b>Step 5: The Automation</b>===

	Finally, we link the CPU temperature to the "brightness" of our pseudo-light, using hysteresis to prevent the fan from constantly turning on and off.		Finally, we link the CPU temperature to the "brightness" of our pseudo-light, using hysteresis to prevent the fan from constantly turning on and off.
Line 131:		Line 131:

	==FAQ==		==FAQ==
	~~<!-- 这里提供了一个Q&A的模板，增加Q&A时按照下面的格式写就可以了 -->~~
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	<div style="font-weight:bold;line-height:1.0;">		<div style="font-weight:bold;line-height:1.0;">
Line 140:		Line 139:
	</div>		</div>
	</div>		</div>

	-->		-->

Ruby: Created page with "{{GD Template Impl}} ==Overview== This page provides {{red|a fan control tutorial}} for NASPi, NASPi Gemini 2.5, NASPi CM4-M2 and NASPi CM4-2.5 on '''Home Assistant OS'''. Due to various limitations, we were unable to run tests on Home Assistant OS, so guidance for this setup was previously missing from our tutorial - [https://wiki.geekworm.com/XScript ''XScript'']. Recently, a community member generously shared their configuration workflow - see the original [https://w..."

2026-06-15T08:22:08Z

Created page with "{{GD Template Impl}} ==Overview== This page provides {{red|a fan control tutorial}} for NASPi, NASPi Gemini 2.5, NASPi CM4-M2 and NASPi CM4-2.5 on '''Home Assistant OS'''. Due to various limitations, we were unable to run tests on Home Assistant OS, so guidance for this setup was previously missing from our tutorial - [https://wiki.geekworm.com/XScript ''XScript'']. Recently, a community member generously shared their configuration workflow - see the original [https://w..."

New page

{{GD Template Impl}}
==Overview==
This page provides {{red|a fan control tutorial}} for NASPi, NASPi Gemini 2.5, NASPi CM4-M2 and NASPi CM4-2.5 on '''Home Assistant OS'''.

Due to various limitations, we were unable to run tests on Home Assistant OS, so guidance for this setup was previously missing from our tutorial - [https://wiki.geekworm.com/XScript ''XScript'']. Recently, a community member generously shared their configuration workflow - see the original [https://wiki.geekworm.com/NASPi#cs-comment-11256 comment - ''Fan control on Home Assistant / HAOS'']. This contribution greatly completes and improves our tutorial. We extend our sincere gratitude to this friend, and his guide is now included on this page for anyone in need of reference.

Fan control on Home Assistant / HAOS

{| class="wikitable"
|<b>Goal</b>||Set up PWM fan speed control on Home Assistant OS. The fan automatically adjusts its rotating speed based on CPU temperature. A hysteresis mechanism is adopted to prevent frequent start-stop cycles, implementing intelligent temperature-controlled variable-speed heat dissipation.
|-
|<b>Devices</b>||Raspberry Pi 4B, Geekworm NASPi Kit
|-
|<b>OS</b>||Home Assistant
|}

<b>Step 1: Read CPU Temperature in HAOS</b>

To control the fan, we first need to monitor the temperature.
:*Go to Settings > Devices & Services in Home Assistant.
:*Click on Add Integration in the bottom right corner and search for System Monitor.
:*Add the integration and ensure the processor temperature sensor (usually <code>sensor.processor_temperature</code>) is enabled.

<b>Step 2: Install the "pigpio" Add-on</b>

To allow HAOS to communicate with the GPIO pins on a hardware level, we need a small background daemon.
:*Go to Settings > Add-ons > Add-on Store.
:*Click the three dots in the top right corner and select Repositories.
:*Add this updated community repository: [https://github.com/Poeschl-HomeAssistant-Addons/repository](https://github.com/Poeschl-HomeAssistant-Addons/repository)
:*Reload the page, search the list for the pigpio add-on, and install it.
:*<b>Important:</b> Enable the toggles for Start on boot and Watchdog, then start the add-on.

<b>Step 3: Install the PWM Integration via HACS</b>
:*Open HACS (Home Assistant Community Store) from your sidebar.
:*Click the three dots in the top right corner and select Custom repositories.
:*Paste the URL [https://github.com/RedMeKool/HA-Raspberry-pi-GPIO-PWM](https://github.com/RedMeKool/HA-Raspberry-pi-GPIO-PWM) into the input field.
:*Select Integration as the category and click Add.
:*Now, search for Raspberry Pi GPIO PWM in HACS, download the integration, and completely restart Home Assistant.

<b>Step 4: Configure the Fan</b>

Next, we tell Home Assistant that there is a PWM device connected to GPIO pin 18.
:*Open your <code>configuration.yaml</code> (e.g., via the "File editor" or "Studio Code Server" add-on).
:*Add the following code:
<div style="margin-left: 2em;">
<pre>
light:
- platform: rpi_gpio_pwm
leds:
- name: NASPi Cooler
pin: 18
</pre>
</div>
:*Save the file and restart Home Assistant once more.
:*<b>Hardware Note:</b> You now have an entity called <code>light.naspi_cooler</code>. You can toggle it on your dashboard and increase the "brightness" to test it.
::<b>Caution:</b> Due to the hardware design, the included Geekworm fan often requires at least 60–65% power (brightness) just to start spinning!

<b>Step 5: The Automation</b>

Finally, we link the CPU temperature to the "brightness" of our pseudo-light, using hysteresis to prevent the fan from constantly turning on and off.
:*Go to Settings > Automations and create a new automation.
:*Click the three dots in the top right corner and switch to Edit in YAML mode.
:*Overwrite everything with this:
<div style="margin-left: 2em;">
<pre>
alias: "System: NASPi Fan Control"
mode: restart
trigger:
- platform: state
entity_id: sensor.processor_temperature
action:
- choose:
# LEVEL 2 (100%): When temp rises ABOVE 60°C
- conditions:
- condition: numeric_state
entity_id: sensor.processor_temperature
above: 60
sequence:
- service: light.turn_on
target:
entity_id: light.naspi_cooler
data:
brightness_pct: 100
# LEVEL 1 (70%): When temp is between 53°C and 60°C
# 53°C acts as the turn-on hysteresis!
- conditions:
- condition: numeric_state
entity_id: sensor.processor_temperature
above: 53
- condition: numeric_state
entity_id: sensor.processor_temperature
below: 60
sequence:
- service: light.turn_on
target:
entity_id: light.naspi_cooler
data:
brightness_pct: 70
# TURN OFF: Only when temp drops BELOW 48°C (turn-off hysteresis)
# AND the temperature has been that low for at least 1 minute (time filter)
- conditions:
- condition: numeric_state
entity_id: sensor.processor_temperature
below: 48
- condition: template
value_template: "{{ (now() - states.sensor.processor_temperature.last_changed).total_seconds() > 60 }}"
sequence:
- service: light.turn_off
target:
entity_id: light.naspi_cooler
# Default behavior: Do nothing, keep current state
default: []
</pre>
</div>

</div>


<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.0;">
Q1: Question 1
</div>
<div class="mw-collapsible-content">
A: Place the answer here.
</div>
</div>
-->


‎<comment-streams id="main"/>


[[Category:Product Manual]]
[[Category:Raspberry pi]]
[[Category:Knowledge]]
[[Category:Orange Pi]]
[[Category:Arduino]]
[[Category:Consumer Electronics]]
[[Category:DIY Electronics]]
[[Category:ESP32]]
[[Category:Jetson Nano]]
[[Category:LattePanda]]
[[Category:Smart Home]]

XScript HAOS - Revision history

Ruby at 08:26, 15 June 2026