80bf061b37
* [thermal control] Fix pmon docker stop issue on 3800 * [thermal fix] Fix QA test issue * [thermal fix] change psu._get_power_available_status to psu.get_power_available_status * [thermal fix] adjust log for PSU absence and power absence * [thermal fix] add unit test for loading thermal policy file with duplicate conditions in different policies * [thermal] fix fan.get_presence for non-removable SKU * [thermal fix] fix issue: fan direction is based on drawer * Fix issue: when fan is not present, should not read fan direction from sysfs but directly return N/A * [thermal fix] add unit test for get_direction for absent FAN * Unplugable PSU has no FAN, no need add a FAN object for this PSU * Update submodules Co-authored-by: Stephen Sun <5379172+stephenxs@users.noreply.github.com>
355 lines
12 KiB
Python
355 lines
12 KiB
Python
#!/usr/bin/env python
|
|
|
|
#############################################################################
|
|
# Mellanox
|
|
#
|
|
# Module contains an implementation of SONiC Platform Base API and
|
|
# provides the FANs status which are available in the platform
|
|
#
|
|
#############################################################################
|
|
|
|
import os.path
|
|
|
|
try:
|
|
from sonic_platform_base.fan_base import FanBase
|
|
except ImportError as e:
|
|
raise ImportError (str(e) + "- required module not found")
|
|
|
|
LED_ON = '1'
|
|
LED_OFF = '0'
|
|
|
|
PWM_MAX = 255
|
|
|
|
FAN_PATH = "/var/run/hw-management/thermal/"
|
|
LED_PATH = "/var/run/hw-management/led/"
|
|
# fan_dir isn't supported on Spectrum 1. It is supported on Spectrum 2 and later switches
|
|
FAN_DIR = "/var/run/hw-management/system/fan_dir"
|
|
|
|
# SKUs with unplugable FANs:
|
|
# 1. don't have fanX_status and should be treated as always present
|
|
hwsku_dict_with_unplugable_fan = ['ACS-MSN2010', 'ACS-MSN2100']
|
|
|
|
class Fan(FanBase):
|
|
"""Platform-specific Fan class"""
|
|
|
|
STATUS_LED_COLOR_ORANGE = "orange"
|
|
|
|
def __init__(self, has_fan_dir, fan_index, drawer_index = 1, psu_fan = False, sku = None):
|
|
# API index is starting from 0, Mellanox platform index is starting from 1
|
|
self.index = fan_index + 1
|
|
self.drawer_index = drawer_index + 1
|
|
|
|
self.is_psu_fan = psu_fan
|
|
self.always_presence = False if sku not in hwsku_dict_with_unplugable_fan else True
|
|
|
|
self.fan_min_speed_path = "fan{}_min".format(self.index)
|
|
if not self.is_psu_fan:
|
|
self.fan_speed_get_path = "fan{}_speed_get".format(self.index)
|
|
self.fan_speed_set_path = "fan{}_speed_set".format(self.index)
|
|
self.fan_presence_path = "fan{}_status".format(self.drawer_index)
|
|
self.fan_max_speed_path = "fan{}_max".format(self.index)
|
|
self._name = "fan{}".format(fan_index + 1)
|
|
else:
|
|
self.fan_speed_get_path = "psu{}_fan1_speed_get".format(self.index)
|
|
self.fan_presence_path = "psu{}_fan1_speed_get".format(self.index)
|
|
self._name = 'psu_{}_fan_{}'.format(self.index, 1)
|
|
self.fan_max_speed_path = None
|
|
self.fan_status_path = "fan{}_fault".format(self.index)
|
|
self.fan_green_led_path = "led_fan{}_green".format(self.drawer_index)
|
|
self.fan_red_led_path = "led_fan{}_red".format(self.drawer_index)
|
|
self.fan_orange_led_path = "led_fan{}_orange".format(self.drawer_index)
|
|
self.fan_pwm_path = "pwm1"
|
|
self.fan_led_cap_path = "led_fan{}_capability".format(self.drawer_index)
|
|
if has_fan_dir:
|
|
self.fan_dir = FAN_DIR
|
|
else:
|
|
self.fan_dir = None
|
|
|
|
|
|
def get_direction(self):
|
|
"""
|
|
Retrieves the fan's direction
|
|
|
|
Returns:
|
|
A string, either FAN_DIRECTION_INTAKE or FAN_DIRECTION_EXHAUST
|
|
depending on fan direction
|
|
|
|
Notes:
|
|
What Mellanox calls forward:
|
|
Air flows from fans side to QSFP side, for example: MSN2700-CS2F
|
|
which means intake in community
|
|
What Mellanox calls reverse:
|
|
Air flow from QSFP side to fans side, for example: MSN2700-CS2R
|
|
which means exhaust in community
|
|
According to hw-mgmt:
|
|
1 stands for forward, in other words intake
|
|
0 stands for reverse, in other words exhaust
|
|
"""
|
|
if not self.fan_dir or self.is_psu_fan or not self.get_presence():
|
|
return self.FAN_DIRECTION_NOT_APPLICABLE
|
|
|
|
try:
|
|
with open(os.path.join(self.fan_dir), 'r') as fan_dir:
|
|
fan_dir_bits = int(fan_dir.read())
|
|
fan_mask = 1 << self.drawer_index - 1
|
|
if fan_dir_bits & fan_mask:
|
|
return self.FAN_DIRECTION_INTAKE
|
|
else:
|
|
return self.FAN_DIRECTION_EXHAUST
|
|
except (ValueError, IOError) as e:
|
|
raise RuntimeError("Failed to read fan direction status to {}".format(repr(e)))
|
|
|
|
|
|
def get_name(self):
|
|
return self._name
|
|
|
|
def get_status(self):
|
|
"""
|
|
Retrieves the operational status of fan
|
|
|
|
Returns:
|
|
bool: True if fan is operating properly, False if not
|
|
"""
|
|
status = 0
|
|
if self.is_psu_fan:
|
|
status = 0
|
|
else:
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_status_path), 'r') as fault_status:
|
|
status = int(fault_status.read())
|
|
except (ValueError, IOError):
|
|
status = 1
|
|
|
|
return status == 0
|
|
|
|
|
|
def get_presence(self):
|
|
"""
|
|
Retrieves the presence status of fan
|
|
|
|
Returns:
|
|
bool: True if fan is present, False if not
|
|
"""
|
|
status = 0
|
|
if self.is_psu_fan:
|
|
if os.path.exists(os.path.join(FAN_PATH, self.fan_presence_path)):
|
|
status = 1
|
|
else:
|
|
status = 0
|
|
else:
|
|
if self.always_presence:
|
|
status = 1
|
|
else:
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_presence_path), 'r') as presence_status:
|
|
status = int(presence_status.read())
|
|
except (ValueError, IOError):
|
|
status = 0
|
|
|
|
return status == 1
|
|
|
|
|
|
def _get_min_speed_in_rpm(self):
|
|
speed = 0
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_min_speed_path), 'r') as min_fan_speed:
|
|
speed = int(min_fan_speed.read())
|
|
except (ValueError, IOError):
|
|
speed = 0
|
|
|
|
return speed
|
|
|
|
|
|
def _get_max_speed_in_rpm(self):
|
|
speed = 0
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_max_speed_path), 'r') as max_fan_speed:
|
|
speed = int(max_fan_speed.read())
|
|
except (ValueError, IOError):
|
|
speed = 0
|
|
|
|
return speed
|
|
|
|
|
|
def get_speed(self):
|
|
"""
|
|
Retrieves the speed of fan
|
|
|
|
Returns:
|
|
int: percentage of the max fan speed
|
|
"""
|
|
speed = 0
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_speed_get_path), 'r') as fan_curr_speed:
|
|
speed_in_rpm = int(fan_curr_speed.read())
|
|
except (ValueError, IOError):
|
|
speed_in_rpm = 0
|
|
|
|
if self.fan_max_speed_path is None:
|
|
# in case of max speed unsupported, we just return speed in unit of RPM.
|
|
return speed_in_rpm
|
|
|
|
max_speed_in_rpm = self._get_max_speed_in_rpm()
|
|
speed = 100*speed_in_rpm/max_speed_in_rpm
|
|
if speed > 100:
|
|
speed = 100
|
|
|
|
return speed
|
|
|
|
|
|
def get_target_speed(self):
|
|
"""
|
|
Retrieves the expected speed of fan
|
|
|
|
Returns:
|
|
int: percentage of the max fan speed
|
|
"""
|
|
if self.is_psu_fan:
|
|
# Not like system fan, psu fan speed can not be modified, so target speed is N/A
|
|
return self.get_speed()
|
|
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_speed_set_path), 'r') as fan_pwm:
|
|
pwm = int(fan_pwm.read())
|
|
except (ValueError, IOError):
|
|
pwm = 0
|
|
|
|
speed = int(round(pwm*100.0/PWM_MAX))
|
|
|
|
return speed
|
|
|
|
|
|
def set_speed(self, speed):
|
|
"""
|
|
Set fan speed to expected value
|
|
|
|
Args:
|
|
speed: An integer, the percentage of full fan speed to set fan to,
|
|
in the range 0 (off) to 100 (full speed)
|
|
|
|
Returns:
|
|
bool: True if set success, False if fail.
|
|
"""
|
|
status = True
|
|
pwm = int(round(PWM_MAX*speed/100.0))
|
|
|
|
if self.is_psu_fan:
|
|
#PSU fan speed is not setable.
|
|
return False
|
|
|
|
try:
|
|
with open(os.path.join(FAN_PATH, self.fan_speed_set_path), 'w') as fan_pwm:
|
|
fan_pwm.write(str(pwm))
|
|
except (ValueError, IOError):
|
|
status = False
|
|
|
|
return status
|
|
|
|
|
|
def _get_led_capability(self):
|
|
cap_list = None
|
|
try:
|
|
with open(os.path.join(LED_PATH, self.fan_led_cap_path), 'r') as fan_led_cap:
|
|
caps = fan_led_cap.read()
|
|
cap_list = caps.split()
|
|
except (ValueError, IOError):
|
|
status = 0
|
|
|
|
return cap_list
|
|
|
|
|
|
def set_status_led(self, color):
|
|
"""
|
|
Set led to expected color
|
|
|
|
Args:
|
|
color: A string representing the color with which to set the
|
|
fan module status LED
|
|
|
|
Returns:
|
|
bool: True if set success, False if fail.
|
|
"""
|
|
led_cap_list = self._get_led_capability()
|
|
if led_cap_list is None:
|
|
return False
|
|
|
|
if self.is_psu_fan:
|
|
# PSU fan led status is not able to set
|
|
return False
|
|
status = False
|
|
try:
|
|
if color == self.STATUS_LED_COLOR_GREEN:
|
|
with open(os.path.join(LED_PATH, self.fan_green_led_path), 'w') as fan_led:
|
|
fan_led.write(LED_ON)
|
|
status = True
|
|
elif color == self.STATUS_LED_COLOR_RED:
|
|
# Some fan don't support red led but support orange led, in this case we set led to orange
|
|
if self.STATUS_LED_COLOR_RED in led_cap_list:
|
|
led_path = os.path.join(LED_PATH, self.fan_red_led_path)
|
|
elif self.STATUS_LED_COLOR_ORANGE in led_cap_list:
|
|
led_path = os.path.join(LED_PATH, self.fan_orange_led_path)
|
|
else:
|
|
return False
|
|
with open(led_path, 'w') as fan_led:
|
|
fan_led.write(LED_ON)
|
|
status = True
|
|
elif color == self.STATUS_LED_COLOR_OFF:
|
|
if self.STATUS_LED_COLOR_GREEN in led_cap_list:
|
|
with open(os.path.join(LED_PATH, self.fan_green_led_path), 'w') as fan_led:
|
|
fan_led.write(str(LED_OFF))
|
|
if self.STATUS_LED_COLOR_RED in led_cap_list:
|
|
with open(os.path.join(LED_PATH, self.fan_red_led_path), 'w') as fan_led:
|
|
fan_led.write(str(LED_OFF))
|
|
if self.STATUS_LED_COLOR_ORANGE in led_cap_list:
|
|
with open(os.path.join(LED_PATH, self.fan_orange_led_path), 'w') as fan_led:
|
|
fan_led.write(str(LED_OFF))
|
|
|
|
status = True
|
|
else:
|
|
status = False
|
|
except (ValueError, IOError):
|
|
status = False
|
|
|
|
return status
|
|
|
|
|
|
def get_status_led(self):
|
|
"""
|
|
Gets the state of the fan status LED
|
|
|
|
Returns:
|
|
A string, one of the predefined STATUS_LED_COLOR_* strings above
|
|
"""
|
|
led_cap_list = self._get_led_capability()
|
|
if led_cap_list is None:
|
|
return self.STATUS_LED_COLOR_OFF
|
|
|
|
try:
|
|
with open(os.path.join(LED_PATH, self.fan_green_led_path), 'r') as fan_led:
|
|
if LED_OFF != fan_led.read().rstrip('\n'):
|
|
return self.STATUS_LED_COLOR_GREEN
|
|
if self.STATUS_LED_COLOR_RED in led_cap_list:
|
|
with open(os.path.join(LED_PATH, self.fan_red_led_path), 'r') as fan_led:
|
|
if LED_OFF != fan_led.read().rstrip('\n'):
|
|
return self.STATUS_LED_COLOR_RED
|
|
if self.STATUS_LED_COLOR_ORANGE in led_cap_list:
|
|
with open(os.path.join(LED_PATH, self.fan_orange_led_path), 'r') as fan_led:
|
|
if LED_OFF != fan_led.read().rstrip('\n'):
|
|
return self.STATUS_LED_COLOR_RED
|
|
except (ValueError, IOError) as e:
|
|
raise RuntimeError("Failed to read led status for fan {} due to {}".format(self.index, repr(e)))
|
|
|
|
return self.STATUS_LED_COLOR_OFF
|
|
|
|
|
|
def get_speed_tolerance(self):
|
|
"""
|
|
Retrieves the speed tolerance of the fan
|
|
|
|
Returns:
|
|
An integer, the percentage of variance from target speed which is
|
|
considered tolerable
|
|
"""
|
|
# The tolerance value is fixed as 20% for all the Mellanox platform
|
|
return 20
|