softminus/min_duty_cycle_settei.sh

## 106 changes: 106 additions & 0 deletions min_duty_cycle_settei.sh
@@ -0,0 +1,106 @@

    #!/bin/bash
#!/bin/bash


    # Copyright (C) 2020 Kia
# Copyright (C) 2020 Kia

    # Licensed under Zero Clause BSD License
# Licensed under Zero Clause BSD License


    if [[ $# -ne 3 ]]; then
if [[ $# -ne 3 ]]; then

        echo "usage: $0 (BMC I2C BUS NUMBER) (FAN PAGE) (DUTY CYCLE FLOOR)"
    echo "usage: $0 (BMC I2C BUS NUMBER) (FAN PAGE) (DUTY CYCLE FLOOR)"

        echo ""
    echo ""

        echo "BMC I2C BUS NUMBER can be found as follows"
    echo "BMC I2C BUS NUMBER can be found as follows"

        echo "$ ls /sys/bus/i2c/devices/*/hwmon/hwmon*/fan1_input"
    echo "$ ls /sys/bus/i2c/devices/*/hwmon/hwmon*/fan1_input"

        echo ""
    echo ""

        echo "if the output of that command is:"
    echo "if the output of that command is:"

        echo "/sys/bus/i2c/devices/7-0073/hwmon/hwmon4/fan1_input"
    echo "/sys/bus/i2c/devices/7-0073/hwmon/hwmon4/fan1_input"

        echo "that means that the I2C bus number is 7"
    echo "that means that the I2C bus number is 7"

        echo "Check /sys/module/ftsteutates/drivers/i2c\:ftsteutates/ to be sure"
    echo "Check /sys/module/ftsteutates/drivers/i2c\:ftsteutates/ to be sure"

        echo ""
    echo ""

        echo "FAN PAGE = 0x48 + index of fan"
    echo "FAN PAGE = 0x48 + index of fan"

        echo "On my system, FAN PAGE can be (0x48, 0x49, 0x4a, 0x4b)"
    echo "On my system, FAN PAGE can be (0x48, 0x49, 0x4a, 0x4b)"

        echo ""
    echo ""

        echo "DUTY CYCLE FLOOR can be any number from 0 to 255, but please"
    echo "DUTY CYCLE FLOOR can be any number from 0 to 255, but please"

        echo "don't set it lower than it already is."
    echo "don't set it lower than it already is."

        echo ""
    echo ""

        echo "This tool asks the Teutates BMC (in a way that does not survive"
    echo "This tool asks the Teutates BMC (in a way that does not survive"

        echo "reboots/power-cycles/shutdowns) to keep the PWM waveform that is"
    echo "reboots/power-cycles/shutdowns) to keep the PWM waveform that is"

        echo "fed to the fan corresponding to FAN PAGE to have a duty cycle that"
    echo "fed to the fan corresponding to FAN PAGE to have a duty cycle that"

        echo "is greater or equal to (DUTY CYCLE FLOOR) / 255"
    echo "is greater or equal to (DUTY CYCLE FLOOR) / 255"

        echo ""
    echo ""

        echo "A fan that runs at MAX_RPM without a PWM signal (or with a DC PWM"
    echo "A fan that runs at MAX_RPM without a PWM signal (or with a DC PWM"

        echo "signal) will never run slower than MAX_RPM * (DUTY CYCLE FLOOR) / 255"
    echo "signal) will never run slower than MAX_RPM * (DUTY CYCLE FLOOR) / 255"

        echo ""
    echo ""

        echo "#########################################################################"
    echo "#########################################################################"

        echo "                               ☢CAUTION!!☢"
    echo "                               ☢CAUTION!!☢"

        echo "The supplied I2C bus number MUST correspond to the bus where the"
    echo "The supplied I2C bus number MUST correspond to the bus where the"

        echo "Teutates BMC lives on."
    echo "Teutates BMC lives on."

        echo ""
    echo ""

        echo "The supplied fan page must be between 0x48-0x4f inclusive and"
    echo "The supplied fan page must be between 0x48-0x4f inclusive and"

        echo "must correspond to a fan in your system connected to the Teutates BMC."
    echo "must correspond to a fan in your system connected to the Teutates BMC."

        echo ""
    echo ""

        echo "Incorrectly specifying the I2C bus number or fan page may BRICK"
    echo "Incorrectly specifying the I2C bus number or fan page may BRICK"

        echo "or IRREVERSIBLY DESTROY your system!"
    echo "or IRREVERSIBLY DESTROY your system!"

        echo "                               ☢CAUTION!!☢"
    echo "                               ☢CAUTION!!☢"

        echo "#########################################################################"
    echo "#########################################################################"

        echo ""
    echo ""

        echo "It is likely that this tool will not produce expected results if"
    echo "It is likely that this tool will not produce expected results if"

        echo "SilentFanConfig-Manager has been run -- which writes fan config stuff"
    echo "SilentFanConfig-Manager has been run -- which writes fan config stuff"

        echo "into nonvolatile storage. The aforementioned fan config stuff might"
    echo "into nonvolatile storage. The aforementioned fan config stuff might"

        echo "set a different set of control modes, causing the write to 0x86 to"
    echo "set a different set of control modes, causing the write to 0x86 to"

        echo "not have the desired effect. I don't have the full Teutates"
    echo "not have the desired effect. I don't have the full Teutates"

        echo "documentation, so i do not know any of the control laws are."
    echo "documentation, so i do not know any of the control laws are."

        echo ""
    echo ""

        echo "However, if you have access to SilentFanConfig-Manager, why do you even"
    echo "However, if you have access to SilentFanConfig-Manager, why do you even"

        echo "need this?"
    echo "need this?"

        echo ""
    echo ""

        echo "This tool has only been tested on a single motherboard:"
    echo "This tool has only been tested on a single motherboard:"

        echo "FUJITSU /D3641-S1, BIOS V5.0.0.13 R1.7.0 for D3641-S1x"
    echo "FUJITSU /D3641-S1, BIOS V5.0.0.13 R1.7.0 for D3641-S1x"

        echo "with FTS Teutates chip revision: 3.11"
    echo "with FTS Teutates chip revision: 3.11"

        echo ""
    echo ""

        echo "FOR USE ONLY ON FUJITSU/KONTRON MOTHERBOARDS WITH TEUTATES BMC"
    echo "FOR USE ONLY ON FUJITSU/KONTRON MOTHERBOARDS WITH TEUTATES BMC"

        echo ""
    echo ""

        exit 1
    exit 1

    fi
fi


    case $2 in
case $2 in

        0x48|0x49|0x4a|0x4b|0x4c|0x4d|0x4e|0x4f)
    0x48|0x49|0x4a|0x4b|0x4c|0x4d|0x4e|0x4f)

            echo "supplied fan page is "$2
        echo "supplied fan page is "$2

            ;;
        ;;

        *)
    *)

            echo "INVALID FAN PAGE!!"
        echo "INVALID FAN PAGE!!"

            exit 2
        exit 2

            ;;
        ;;

    esac
esac


    set -e
set -e


    echo -n "Testing for Teutates BMC presence... "
echo -n "Testing for Teutates BMC presence... "

    # test that we have a teutates bmc, ideally this modprobe fails otherwise
# test that we have a teutates bmc, ideally this modprobe fails otherwise

    sudo modprobe ftsteutates
sudo modprobe ftsteutates

    # but we need it not be loaded, so we can have the i2c bus to ourselves
# but we need it not be loaded, so we can have the i2c bus to ourselves

    sudo rmmod ftsteutates
sudo rmmod ftsteutates


    echo "present"
echo "present"

    # this lets us do i2cset
# this lets us do i2cset

    sudo modprobe i2c-dev
sudo modprobe i2c-dev


    # switch the page for the fan in question. the user is responsible
# switch the page for the fan in question. the user is responsible

    # for making sure this is between 0x48 and 0x4f
# for making sure this is between 0x48 and 0x4f

    echo "writing to the i2c bus; hope you gave us the correct one!"
echo "writing to the i2c bus; hope you gave us the correct one!"

    sudo i2cset -y $1 0x73 0x7f $2
sudo i2cset -y $1 0x73 0x7f $2


    # set PWM duty cycle
# set PWM duty cycle

    sudo i2cset -y $1 0x73 0x86 $3
sudo i2cset -y $1 0x73 0x86 $3


    # set the page back to 0x00 just to be kind to whoever (the kernel module) talks with the BMC after us
# set the page back to 0x00 just to be kind to whoever (the kernel module) talks with the BMC after us

    sudo i2cset -y $1 0x73 0x7f 0x00
sudo i2cset -y $1 0x73 0x7f 0x00


    echo "writes done"
echo "writes done"

    # let us look at our handiwork via sensors(1).
# let us look at our handiwork via sensors(1).

    # be patient, i think the BMC only updates RPM every second or so
# be patient, i think the BMC only updates RPM every second or so

    sudo modprobe ftsteutates
sudo modprobe ftsteutates