/* IBM_PROLOG_BEGIN_TAG */ /* This is an automatically generated prolog. */ /* */ /* $Source: src/import/chips/p9a/procedures/hwp/memory/p9a_mss_utils_to_throttle.C $ */ /* */ /* OpenPOWER HostBoot Project */ /* */ /* Contributors Listed Below - COPYRIGHT 2019,2020 */ /* [+] International Business Machines Corp. */ /* */ /* */ /* Licensed under the Apache License, Version 2.0 (the "License"); */ /* you may not use this file except in compliance with the License. */ /* You may obtain a copy of the License at */ /* */ /* http://www.apache.org/licenses/LICENSE-2.0 */ /* */ /* Unless required by applicable law or agreed to in writing, software */ /* distributed under the License is distributed on an "AS IS" BASIS, */ /* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or */ /* implied. See the License for the specific language governing */ /* permissions and limitations under the License. */ /* */ /* IBM_PROLOG_END_TAG */ /// /// @file p9a_mss_utils_to_throttle.C /// @brief Sets throttles and power attributes for a given utilization value /// @note TMGT will call this procedure to set the N address operations (commands) /// allowed within a window of M DRAM clocks given the minimum dram data bus utilization. //// If input utilization is zero, then safemode values from MRW will be used /// // *HWP HWP Owner: Andre A. Marin // *HWP HWP Backup: Louis Stermole // *HWP Team: Memory // *HWP Level: 1 // *HWP Consumed by: FSP:HB #include #include #include #include #include // fapi2 #include extern "C" { /// /// @brief Determines throttle and power values for a given port databus utilization. /// @param[in] i_targets vector of OCMB_CHIPs to set throttle and power attributes on /// @return FAPI2_RC_SUCCESS iff ok /// @note ATTR_MSS_MEM_THROTTLED_N_COMMANDS_PER_SLOT will be set to worst case of all slots passed in /// @note input ATTR_MSS_DATABUS_UTIL and ATTR_MSS_MEM_WATT_TARGET /// @note output ATTR_MSS_MEM_THROTTLED_N_COMMANDS_PER_SLOT, ATTR_MSS_MEM_THROTTLED_N_COMMANDS_PER_PORT, and ATTR_MSS_PORT_MAXPOWER /// @note Does not set runtime throttles or set registers to throttle values /// fapi2::ReturnCode p9a_mss_utils_to_throttle(const std::vector>& i_targets) { constexpr uint64_t l_min_util = mss::power_thermal::throttle_traits::MIN_UTIL; FAPI_INF("Entering p9a_mss_utils_to_throttle"); std::vector> l_exceeded_power; bool l_util_error = false; for (const auto& l_ocmb : i_targets) { if (mss::count_dimm(l_ocmb) == 0) { FAPI_INF("Skipping %s because it has no DIMM targets", mss::c_str(l_ocmb)); continue; } uint32_t l_max_databus_util = 0; uint32_t l_dram_clocks = 0; uint32_t l_safemode_util = 0; uint32_t l_safemode_throttle_per_port = 0; uint32_t l_calc_util = 0; FAPI_TRY(mss::attr::get_mrw_mem_m_dram_clocks(l_dram_clocks)); FAPI_TRY(mss::attr::get_mrw_max_dram_databus_util(l_max_databus_util)); FAPI_TRY(mss::attr::get_mrw_safemode_dram_databus_util(l_safemode_util)); l_safemode_throttle_per_port = mss::power_thermal::calc_n_from_dram_util( (l_safemode_util / mss::power_thermal::throttle_const::PERCENT_CONVERSION), l_dram_clocks); for(const auto& l_port : mss::find_targets(l_ocmb)) { fapi2::ReturnCode l_rc; uint32_t l_input_databus_util = 0; bool l_safemode = false; // Util attribute set by OCC FAPI_TRY( mss::attr::get_databus_util(l_port, l_input_databus_util) ); FAPI_INF("Input databus utilization for %s is %d", mss::c_str(l_port), l_input_databus_util); // If input utilization is zero, use mrw safemode throttle values for utilization // else make sure we're within our maximum utilization limit FAPI_TRY(mss::power_thermal::calc_utilization(l_port, l_input_databus_util, l_dram_clocks, l_safemode_throttle_per_port, l_max_databus_util, l_calc_util, l_util_error, l_safemode)); // Error if utilization is less than MIN_UTIL // Don't exit, let HWP finish and return error at end FAPI_ASSERT_NOEXIT( !l_util_error, fapi2::MSS_MIN_UTILIZATION_ERROR() .set_INPUT_UTIL_VALUE(l_input_databus_util) .set_MIN_UTIL_VALUE(l_min_util), "%s Input utilization (%d) less than minimum utilization allowed (%d)", mss::c_str(l_port), l_input_databus_util, l_min_util); // Make a throttle object in order to calculate the port power mss::power_thermal::throttle l_throttle(l_port, l_rc); FAPI_TRY(l_rc, "%s Error calculating mss::power_thermal::throttle constructor in p9a_mss_utils_to_throttles", mss::c_str(l_port)); FAPI_TRY(l_throttle.calc_slots_and_power(l_calc_util)); FAPI_INF( "%s Calculated N commands per port %d, per slot %d, commands per dram clock window %d, maxpower is %d", mss::c_str(l_port), l_throttle.iv_n_port, l_throttle.iv_n_slot, l_dram_clocks, l_throttle.iv_calc_port_maxpower); FAPI_TRY(mss::attr::set_port_maxpower(l_port, l_throttle.iv_calc_port_maxpower)); FAPI_TRY(mss::attr::set_mem_throttled_n_commands_per_slot(l_port, (l_safemode) ? l_safemode_throttle_per_port : l_throttle.iv_n_slot)); FAPI_TRY(mss::attr::set_mem_throttled_n_commands_per_port(l_port, (l_safemode) ? l_safemode_throttle_per_port : l_throttle.iv_n_port)); } // ports } // ocmbs // Equalize throttles to prevent variable performance // Note that we don't do anything with any port that exceed the power limit here, as we don't have an input power limit to go from FAPI_TRY(mss::power_thermal::equalize_throttles(i_targets, mss::throttle_type::POWER, l_exceeded_power)); // Return a failing RC code if we had any input utilization values less than MIN_UTIL if (l_util_error) { fapi2::current_err = fapi2::RC_MSS_MIN_UTILIZATION_ERROR; } fapi_try_exit: return fapi2::current_err; } }// extern C