Harry at 11:11, 12 June 2026

2026-06-12T11:11:07Z

← Older revision		Revision as of 19:11, 12 June 2026
Line 96:		Line 96:
	#		#
	</div>{{DISPLAYTITLE:		</div>{{DISPLAYTITLE:
	Fan control on ~~Homeassistant~~ / HAOS		Fan control on Home Assistant / HAOS
	}}		}}

212.34.73.12 at 12:18, 11 June 2026

2026-06-11T12:18:28Z

New page

I hope this helps someone—it took me a while to figure this out. [created and translated with Gemini, successfully tested in june 2026]<div>
=== Step 1: Read CPU Temperature in HAOS ===
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.

=== Step 2: Install the "pigpio" Add-on ===
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: <code><nowiki>[https://github.com/Poeschl-HomeAssistant-Addons/repository]</nowiki>(<nowiki>https://github.com/Poeschl-HomeAssistant-Addons/repository</nowiki>)</code>
# Reload the page, search the list for the '''pigpio''' add-on, and install it.
# '''Important:''' Enable the toggles for '''Start on boot''' and '''Watchdog''', then start the add-on.

=== Step 3: Install the PWM Integration via HACS ===

# 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 <code><nowiki>[https://github.com/RedMeKool/HA-Raspberry-pi-GPIO-PWM]</nowiki>(<nowiki>https://github.com/RedMeKool/HA-Raspberry-pi-GPIO-PWM</nowiki>)</code> 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'''.

=== Step 4: Configure the Fan ===
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:

light:
- platform: rpi_gpio_pwm
leds:
- name: NASPi Cooler
pin: 18

# Save the file and restart Home Assistant once more.
# ''Hardware Note:'' 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. '''Caution:''' Due to the hardware design, the included Geekworm fan often requires '''at least 60–65% power (brightness)''' just to start spinning!

=== Step 5: The Automation ===
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:

alias: "System: NASPi Fan Control"
mode: restart
trigger:
<nowiki> </nowiki> - platform: state
<nowiki> </nowiki> entity_id: sensor.processor_temperature
action:
<nowiki> </nowiki>- choose:
<nowiki> </nowiki> # LEVEL 2 (100%): When temp rises ABOVE 60°C
<nowiki> </nowiki> - conditions:
<nowiki> </nowiki> - condition: numeric_state
<nowiki> </nowiki> entity_id: sensor.processor_temperature
<nowiki> </nowiki> above: 60
<nowiki> </nowiki> sequence:
<nowiki> </nowiki> - service: light.turn_on
<nowiki> </nowiki> target:
<nowiki> </nowiki> entity_id: light.naspi_cooler
<nowiki> </nowiki> data:
<nowiki> </nowiki> brightness_pct: 100
<nowiki> </nowiki> # LEVEL 1 (70%): When temp is between 53°C and 60°C
<nowiki> </nowiki> # 53°C acts as the turn-on hysteresis!
<nowiki> </nowiki> - conditions:
<nowiki> </nowiki> - condition: numeric_state
<nowiki> </nowiki> entity_id: sensor.processor_temperature
<nowiki> </nowiki> above: 53
<nowiki> </nowiki> - condition: numeric_state
<nowiki> </nowiki> entity_id: sensor.processor_temperature
<nowiki> </nowiki> below: 60
<nowiki> </nowiki> sequence:
<nowiki> </nowiki> - service: light.turn_on
<nowiki> </nowiki> target:
<nowiki> </nowiki> entity_id: light.naspi_cooler
<nowiki> </nowiki> data:
<nowiki> </nowiki> brightness_pct: 70
<nowiki> </nowiki> # TURN OFF: Only when temp drops BELOW 48°C (turn-off hysteresis)
<nowiki> </nowiki> # AND the temperature has been that low for at least 1 minute (time filter)
<nowiki> </nowiki> - conditions:
<nowiki> </nowiki> - condition: numeric_state
<nowiki> </nowiki> entity_id: sensor.processor_temperature
<nowiki> </nowiki> below: 48
<nowiki> </nowiki> - condition: template
<nowiki> </nowiki> value_template: "<nowiki>{{ (now() - states.sensor.processor_temperature.last_changed).total_seconds() > 60 }}</nowiki>"
<nowiki> </nowiki> sequence:
<nowiki> </nowiki> - service: light.turn_off
<nowiki> </nowiki> target:
<nowiki> </nowiki> entity_id: light.naspi_cooler
<nowiki> </nowiki> # Default behavior: Do nothing, keep current state
<nowiki> </nowiki> default: []

#
</div>{{DISPLAYTITLE:
Fan control on Homeassistant / HAOS
}}

CommentStreams:18f4560ed5f6ac02e77c41d0c43469a3 - Revision history

Harry at 11:11, 12 June 2026

212.34.73.12 at 12:18, 11 June 2026