Open Networking Hardware Diagnostic Guide November 2022

Tests

The fantool tests the fans by setting them to different speeds and then verifying the configured fan speeds.

Registers and values pass as hexadecimal values with or without the preceding 0x. Fans display from 1 to Max System Fans.

CLI options

DellEmc Diag - Fan Controller Tool
version 1.5, x.xx.x.x-x
build, 2022/05/20,

Syntax: fantool <option>
 Show the help-text:=
     fantool --h                                               (or)
     fantool -h
 Initialize the fans to the default state:=
     fantool --init                                            (or)
     fantool -i
 Test using the Fan Controller config file:=
     fantool --test [--fan=<fan>] [--lpc]                      (or)
     fantool -t [-F <fan>] [-l]
 Get the speed of the specified fan or all fans in RPM:=
     fantool --get --fan=<fan | all> [--lpc]                   (or)
     fantool -g -F <fan | all> [-l]
 Set the fan(s) to the speed:=
     fantool --set --fan=<fan | all> --speed=<speed in RPM>    (or)
     fantool -s -F <fan | all> -S <speed in RPM>
 Execute repeatedly command by count:=
     fantool --iteration=max/<count> [option1] [option2]...    (or)
     fantool -I max/<count> [option1] [option2]...
 Read the Register from the fan controller:=
     fantool --read --fan=<fan | all> --reg=<register | all>   (or)
     fantool -r -F <fan | all> -R <register | all>
 Write the Register in the Fan Controller:=
     fantool --write --fan=<fan | all> --reg=<register> --val=<value> (or)
     fantool -w -F <fan | all> -R <register> -V <value>

Usage:=
     -h, --h            Show the help text
     -i, --init         Initilize to default
     -t, --test         Test using the pre-programmed configuration or use supplied config
     -g, --get          Get operation
     -s, --set          Set operation
     -r, --read         Read operation
     -w, --write        Write operation
     -I, --iteration=   Iteration command execution
     -F, --fan=         Fan Id
     -R, --register=    Register
     -V, --val=         Value to be set
     -S, --speed=       Speed of the fan
     -q, --lpc          Test by reading or modifying SmartFusion registers.
                        When this flag is used, it must be clubbed with one of above flags

  *Registers and Values are passed as Hexadecimal values with or without the preceding 0x.
  *Fans are from 1 to Max System Fans.

The fantool uses long options which requires two hyphens in front of the options. Options are required, optional, or none. If you require a parameter, specify it and include an equal sign. If a parameter is optional, enclose it with square brackets to show that it is optional, but do not type the brackets at the CLI. For example, --fan is optional and enter it as --fan=1 or --fan=all, and so forth. Parameters with angle brackets are required but have multiple options for the input. Do not type the angle brackets or the vertical line character in the CLI. Only use one option per command; for example, --fan=1 or --fan=all.

• test—Runs through the speeds for the fan, from highest to lowest, and checks that the fan can run at the speeds of the test. If a single fan is listed on the CLI, that fan is tested. If you use the all option, all fans are tested. The number in the parentheses during the test is the speed the system tries to reach during the test. If a fan cannot reach the desired speed within an acceptable range after 10 checks, the fan fails for that speed and the system moves on to the next fan.
• get—Gets the speed of the fan and returns it in the rate process module (RPM).
• set—Sets the speed of the fan in the RPM.

Output

root@dell-diag-os:~# fantool --test --lpc
Fan Controller Test LPC....................................
Max number of Fan Trays in the System : 5
Number of fans per tray : 2
Max Fan Speed set(PWM): 255
Getting Details for  Fan 1
 Fan 1 is Present
 Fan 1 Air flow type is Front To Rear
 Fan 1 status Normal
 Fan 1 speed is 8420 RPM
Getting Details for  Fan 2
 Fan 2 is Present
 Fan 2 Air flow type is Front To Rear
 Fan 2 status Normal
 Fan 2 speed is 8738 RPM
Getting Details for  Fan 3
 Fan 3 is Present
 Fan 3 Air flow type is Front To Rear
 Fan 3 status Normal
 Fan 3 speed is 8474 RPM
Getting Details for  Fan 4
 Fan 4 is Present
 Fan 4 Air flow type is Front To Rear
 Fan 4 status Normal
 Fan 4 speed is 8757 RPM
Getting Details for  Fan 5
 Fan 5 is Present
 Fan 5 Air flow type is Front To Rear
 Fan 5 status Normal
 Fan 5 speed is 8492 RPM
Getting Details for  Fan 6
 Fan 6 is Present
 Fan 6 Air flow type is Front To Rear
 Fan 6 status Normal
 Fan 6 speed is 8777 RPM
Getting Details for  Fan 7
 Fan 7 is Present
 Fan 7 Air flow type is Front To Rear
 Fan 7 status Normal
 Fan 7 speed is 8348 RPM
Getting Details for  Fan 8
 Fan 8 is Present
 Fan 8 Air flow type is Front To Rear
 Fan 8 status Normal
 Fan 8 speed is 8585 RPM
Getting Details for  Fan 9
 Fan 9 is Present
 Fan 9 Air flow type is Front To Rear
 Fan 9 status Normal
 Fan 9 speed is 8420 RPM
Getting Details for  Fan 10
 Fan 10 is Present
 Fan 10 Air flow type is Front To Rear
 Fan 10 status Normal
 Fan 10 speed is 8566 RPM
Fan Controller Test LPC......................... Passed
root@dell-diag-os:~#

root@dell-diag-os:~# fantool --get --lpc
Fan 1 speed is 8420 RPM
Fan 2 speed is 8757 RPM
Fan 3 speed is 8474 RPM
Fan 4 speed is 8738 RPM
Fan 5 speed is 8474 RPM
Fan 6 speed is 8757 RPM
Fan 7 speed is 8366 RPM
Fan 8 speed is 8604 RPM
Fan 9 speed is 8420 RPM
Fan 10 speed is 8566 RPM
[2]+  Done                    dhclient -q eth0
root@dell-diag-os:~#

root@dell-diag-os:~# fantool --get --fan=2 --lpc
Fan 2 speed is 8738 RPM
root@dell-diag-os:~#