Reference Guide

CLI options
DellEmc Diag - Fan Controller Tool
version 1.5, x.xx.x.x-x
build, 2017/05/23
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.
NOTE:
Commonly, fan speeds are in two registers and must be written in a specific order. The write command cannot
change the fan speeds; use the set command.
26 Dell EMC DIAG OS tools