###########################################################################
#
# Dell PowerEdge Fan Controller
# README
#
# Version : 1.0
# Release : July 2026
#
# License : MIT
#
# Author  : Jack Bamford
#
###########################################################################

Overview
--------

Dell PowerEdge Fan Controller v1 is the original release of the fan control
script designed for Dell PowerEdge servers running TrueNAS.

The script replaces Dell's default high-speed fan response with a simple
dynamic fan controller based on system temperatures.

Unlike Version 2, this release consists of a single shell script and does
not include a dedicated launcher or background service management.

Test Platform
-------------

Server
  Dell PowerEdge R730xd

Management
  iDRAC8 Enterprise

Storage Controller
  Dell HBA330

Operating System
  TrueNAS CORE

Features
--------

• Dynamic CPU temperature monitoring
• Inlet temperature monitoring
• Exhaust temperature monitoring
• Manual fan speed control
• Automatic return to Dell Automatic fan control
• Lightweight shell implementation
• Uses local IPMI (ipmitool)

Files Included
--------------

r730xd-fancontrol.sh
    Main fan control script.

Installation
------------

1. Copy the script to:

       /root/scripts/

2. Make it executable:

       chmod +x r730xd-fancontrol.sh

3. Configure a TrueNAS Post Init Script or execute manually.

Requirements
------------

• Dell PowerEdge Server
• iDRAC7 / iDRAC8
• Local IPMI support
• ipmitool
• TrueNAS CORE

Known Limitations
-----------------

Version 1 does not include:

• Dedicated startup launcher
• PID file management
• Automatic daemon execution
• Sensor retry protection
• Enhanced logging
• HDD SMART temperature monitoring

Users are encouraged to upgrade to Version 2 for additional features and
improved reliability.

Compatibility
-------------

✔ TrueNAS CORE
✔ Dell PowerEdge R730xd
✔ Dell HBA330
✔ iDRAC8

Change Log
----------

v1.0 (July 2026)
----------------
• Initial release
• Dynamic CPU temperature-based fan control
• Inlet and exhaust temperature monitoring
• Manual IPMI fan control
• Automatic fallback to Dell Automatic fan control

Upgrade
-------

Version 2 is recommended for new installations and includes:

• Dedicated startup launcher
• Background daemon operation
• PID management
• Sensor retry protection
• Improved logging
• Better fault tolerance
• Improved documentation

Disclaimer
----------

This software is provided "AS IS", without warranty of any kind, express or
implied, including but not limited to the warranties of merchantability,
fitness for a particular purpose and non-infringement.

The author accepts no responsibility for hardware damage, data loss,
business interruption or any other issues arising from the use of this
software.

Users are responsible for thoroughly testing this software in their own
environment before deploying it on production systems.

Copyright (c) 2026 Jack Bamford