Home | History | Annotate | Download | only in power
      1 // Copyright 2014 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #include <vector>
      6 
      7 #include "base/bind.h"
      8 #include "base/files/file_util.h"
      9 #include "base/logging.h"
     10 #include "base/strings/string_number_conversions.h"
     11 #include "base/strings/string_split.h"
     12 #include "base/strings/string_util.h"
     13 #include "base/strings/stringprintf.h"
     14 #include "chrome/browser/chromeos/power/cpu_data_collector.h"
     15 #include "chrome/browser/chromeos/power/power_data_collector.h"
     16 #include "content/public/browser/browser_thread.h"
     17 
     18 namespace chromeos {
     19 
     20 namespace {
     21 // The sampling of CPU idle or CPU freq data should not take more than this
     22 // limit.
     23 const int kSamplingDurationLimitMs = 500;
     24 
     25 // The CPU data is sampled every |kCpuDataSamplePeriodSec| seconds.
     26 const int kCpuDataSamplePeriodSec = 30;
     27 
     28 // The value in the file /sys/devices/system/cpu/cpu<n>/online which indicates
     29 // that CPU-n is online.
     30 const int kCpuOnlineStatus = 1;
     31 
     32 // The base of the path to the files and directories which contain CPU data in
     33 // the sysfs.
     34 const char kCpuDataPathBase[] = "/sys/devices/system/cpu";
     35 
     36 // Suffix of the path to the file listing the range of possible CPUs on the
     37 // system.
     38 const char kPossibleCpuPathSuffix[] = "/possible";
     39 
     40 // Format of the suffix of the path to the file which contains information
     41 // about a particular CPU being online or offline.
     42 const char kCpuOnlinePathSuffixFormat[] = "/cpu%d/online";
     43 
     44 // Format of the suffix of the path to the file which contains freq state
     45 // information of a CPU.
     46 const char kCpuFreqTimeInStatePathSuffixFormat[] =
     47     "/cpu%d/cpufreq/stats/time_in_state";
     48 
     49 // Format of the suffix of the path to the directory which contains information
     50 // about an idle state of a CPU on the system.
     51 const char kCpuIdleStateDirPathSuffixFormat[] = "/cpu%d/cpuidle/state%d";
     52 
     53 // Format of the suffix of the path to the file which contains the name of an
     54 // idle state of a CPU.
     55 const char kCpuIdleStateNamePathSuffixFormat[] = "/cpu%d/cpuidle/state%d/name";
     56 
     57 // Format of the suffix of the path which contains information about time spent
     58 // in an idle state on a CPU.
     59 const char kCpuIdleStateTimePathSuffixFormat[] = "/cpu%d/cpuidle/state%d/time";
     60 
     61 // Returns the index at which |str| is in |vector|. If |str| is not present in
     62 // |vector|, then it is added to it before its index is returned.
     63 size_t IndexInVector(const std::string& str,
     64                   std::vector<std::string>* vector) {
     65   for (size_t i = 0; i < vector->size(); ++i) {
     66     if (str == (*vector)[i])
     67       return i;
     68   }
     69 
     70   // If this is reached, then it means |str| is not present in vector.  Add it.
     71   vector->push_back(str);
     72   return vector->size() - 1;
     73 }
     74 
     75 // Returns true if the |i|-th CPU is online; false otherwise.
     76 bool CpuIsOnline(const int i) {
     77   const std::string online_file_format = base::StringPrintf(
     78       "%s%s", kCpuDataPathBase, kCpuOnlinePathSuffixFormat);
     79   const std::string cpu_online_file = base::StringPrintf(
     80       online_file_format.c_str(), i);
     81   if (!base::PathExists(base::FilePath(cpu_online_file))) {
     82     // If the 'online' status file is missing, then it means that the CPU is
     83     // not hot-pluggable and hence is always online.
     84     return true;
     85   }
     86 
     87   int online;
     88   std::string cpu_online_string;
     89   if (base::ReadFileToString(base::FilePath(cpu_online_file),
     90                              &cpu_online_string)) {
     91     base::TrimWhitespace(cpu_online_string, base::TRIM_ALL, &cpu_online_string);
     92     if (base::StringToInt(cpu_online_string, &online))
     93       return online == kCpuOnlineStatus;
     94   }
     95 
     96   LOG(ERROR) << "Bad format or error reading " << cpu_online_file << ". "
     97              << "Assuming offline.";
     98   return false;
     99 }
    100 
    101 // Samples the CPU idle state information from sysfs. |cpu_count| is the number
    102 // of possible CPUs on the system. Sample at index i in |idle_samples|
    103 // corresponds to the idle state information of the i-th CPU.
    104 void SampleCpuIdleData(
    105     int cpu_count,
    106     std::vector<std::string>* cpu_idle_state_names,
    107     std::vector<CpuDataCollector::StateOccupancySample>* idle_samples) {
    108   base::Time start_time = base::Time::Now();
    109   for (int cpu = 0; cpu < cpu_count; ++cpu) {
    110     CpuDataCollector::StateOccupancySample idle_sample;
    111     idle_sample.time = base::Time::Now();
    112     idle_sample.time_in_state.reserve(cpu_idle_state_names->size());
    113 
    114     if (!CpuIsOnline(cpu)) {
    115       idle_sample.cpu_online = false;
    116     } else {
    117       idle_sample.cpu_online = true;
    118 
    119       const std::string idle_state_dir_format = base::StringPrintf(
    120           "%s%s", kCpuDataPathBase, kCpuIdleStateDirPathSuffixFormat);
    121       for (int state_count = 0; ; ++state_count) {
    122         std::string idle_state_dir = base::StringPrintf(
    123             idle_state_dir_format.c_str(), cpu, state_count);
    124         // This insures us from the unlikely case wherein the 'cpuidle_stats'
    125         // kernel module is not loaded. This could happen on a VM.
    126         if (!base::DirectoryExists(base::FilePath(idle_state_dir)))
    127           break;
    128 
    129         const std::string name_file_format = base::StringPrintf(
    130             "%s%s", kCpuDataPathBase, kCpuIdleStateNamePathSuffixFormat);
    131         const std::string name_file_path = base::StringPrintf(
    132             name_file_format.c_str(), cpu, state_count);
    133         DCHECK(base::PathExists(base::FilePath(name_file_path)));
    134 
    135         const std::string time_file_format = base::StringPrintf(
    136             "%s%s", kCpuDataPathBase, kCpuIdleStateTimePathSuffixFormat);
    137         const std::string time_file_path = base::StringPrintf(
    138             time_file_format.c_str(), cpu, state_count);
    139         DCHECK(base::PathExists(base::FilePath(time_file_path)));
    140 
    141         std::string state_name, occupancy_time_string;
    142         int64 occupancy_time_usec;
    143         if (!base::ReadFileToString(base::FilePath(name_file_path),
    144                                     &state_name) ||
    145             !base::ReadFileToString(base::FilePath(time_file_path),
    146                                     &occupancy_time_string)) {
    147           // If an error occurs reading/parsing single state data, drop all the
    148           // samples as an incomplete sample can mislead consumers of this
    149           // sample.
    150           LOG(ERROR) << "Error reading idle state from "
    151                      << idle_state_dir << ". Dropping sample.";
    152           idle_samples->clear();
    153           return;
    154         }
    155 
    156         base::TrimWhitespace(state_name, base::TRIM_ALL, &state_name);
    157         base::TrimWhitespace(
    158             occupancy_time_string, base::TRIM_ALL, &occupancy_time_string);
    159         if (base::StringToInt64(occupancy_time_string, &occupancy_time_usec)) {
    160           // idle state occupancy time in sysfs is recorded in microseconds.
    161           int64 time_in_state_ms = occupancy_time_usec / 1000;
    162           size_t index = IndexInVector(state_name, cpu_idle_state_names);
    163           if (index >= idle_sample.time_in_state.size())
    164             idle_sample.time_in_state.resize(index + 1);
    165           idle_sample.time_in_state[index] = time_in_state_ms;
    166         } else {
    167           LOG(ERROR) << "Bad format in " << time_file_path << ". "
    168                      << "Dropping sample.";
    169           idle_samples->clear();
    170           return;
    171         }
    172       }
    173     }
    174 
    175     idle_samples->push_back(idle_sample);
    176   }
    177 
    178   // If there was an interruption in sampling (like system suspended),
    179   // discard the samples!
    180   int64 delay =
    181       base::TimeDelta(base::Time::Now() - start_time).InMilliseconds();
    182   if (delay > kSamplingDurationLimitMs) {
    183     idle_samples->clear();
    184     LOG(WARNING) << "Dropped an idle state sample due to excessive time delay: "
    185                  << delay << "milliseconds.";
    186   }
    187 }
    188 
    189 // Samples the CPU freq state information from sysfs. |cpu_count| is the number
    190 // of possible CPUs on the system. Sample at index i in |freq_samples|
    191 // corresponds to the freq state information of the i-th CPU.
    192 void SampleCpuFreqData(
    193     int cpu_count,
    194     std::vector<std::string>* cpu_freq_state_names,
    195     std::vector<CpuDataCollector::StateOccupancySample>* freq_samples) {
    196   base::Time start_time = base::Time::Now();
    197   for (int cpu = 0; cpu < cpu_count; ++cpu) {
    198     CpuDataCollector::StateOccupancySample freq_sample;
    199     freq_sample.time_in_state.reserve(cpu_freq_state_names->size());
    200 
    201     if (!CpuIsOnline(cpu)) {
    202       freq_sample.time = base::Time::Now();
    203       freq_sample.cpu_online = false;
    204     } else {
    205       freq_sample.cpu_online = true;
    206 
    207       const std::string time_in_state_path_format = base::StringPrintf(
    208           "%s%s", kCpuDataPathBase, kCpuFreqTimeInStatePathSuffixFormat);
    209       const std::string time_in_state_path = base::StringPrintf(
    210           time_in_state_path_format.c_str(), cpu);
    211       if (!base::PathExists(base::FilePath(time_in_state_path))) {
    212         // If the path to the 'time_in_state' for a single CPU is missing,
    213         // then 'time_in_state' for all CPUs is missing. This could happen
    214         // on a VM where the 'cpufreq_stats' kernel module is not loaded.
    215         LOG(ERROR) << "CPU freq stats not available in sysfs.";
    216         freq_samples->clear();
    217         return;
    218       }
    219 
    220       std::string time_in_state_string;
    221       // Note time as close to reading the file as possible. This is not
    222       // possible for idle state samples as the information for each state there
    223       // is recorded in different files.
    224       base::Time now = base::Time::Now();
    225       if (!base::ReadFileToString(base::FilePath(time_in_state_path),
    226                                   &time_in_state_string)) {
    227         LOG(ERROR) << "Error reading " << time_in_state_path << ". "
    228                    << "Dropping sample.";
    229         freq_samples->clear();
    230         return;
    231       }
    232 
    233       freq_sample.time = now;
    234 
    235       std::vector<std::string> lines;
    236       base::SplitString(time_in_state_string, '\n', &lines);
    237       // The last line could end with '\n'. Ignore the last empty string in
    238       // such cases.
    239       size_t state_count = lines.size();
    240       if (state_count > 0 && lines.back().empty())
    241         state_count -= 1;
    242       for (size_t state = 0; state < state_count; ++state) {
    243         std::vector<std::string> pair;
    244         int freq_in_khz;
    245         int64 occupancy_time_centisecond;
    246 
    247         // Occupancy of each state is in the format "<state> <time>"
    248         base::SplitString(lines[state], ' ', &pair);
    249         for (size_t s = 0; s < pair.size(); ++s)
    250           base::TrimWhitespace(pair[s], base::TRIM_ALL, &pair[s]);
    251         if (pair.size() == 2 &&
    252             base::StringToInt(pair[0], &freq_in_khz) &&
    253             base::StringToInt64(pair[1], &occupancy_time_centisecond)) {
    254           const std::string state_name = base::IntToString(freq_in_khz / 1000);
    255           size_t index = IndexInVector(state_name, cpu_freq_state_names);
    256           if (index >= freq_sample.time_in_state.size())
    257             freq_sample.time_in_state.resize(index + 1);
    258           // The occupancy time is in units of centiseconds.
    259           freq_sample.time_in_state[index] = occupancy_time_centisecond * 10;
    260         } else {
    261           LOG(ERROR) << "Bad format in " << time_in_state_path << ". "
    262                      << "Dropping sample.";
    263           freq_samples->clear();
    264           return;
    265         }
    266       }
    267     }
    268 
    269     freq_samples->push_back(freq_sample);
    270   }
    271 
    272   // If there was an interruption in sampling (like system suspended),
    273   // discard the samples!
    274   int64 delay =
    275       base::TimeDelta(base::Time::Now() - start_time).InMilliseconds();
    276   if (delay > kSamplingDurationLimitMs) {
    277     freq_samples->clear();
    278     LOG(WARNING) << "Dropped a freq state sample due to excessive time delay: "
    279                  << delay << "milliseconds.";
    280   }
    281 }
    282 
    283 // Samples CPU idle and CPU freq data from sysfs. This function should run on
    284 // the blocking pool as reading from sysfs is a blocking task. Elements at
    285 // index i in |idle_samples| and |freq_samples| correspond to the idle and
    286 // freq samples of CPU i. This also function reads the number of CPUs from
    287 // sysfs if *|cpu_count| < 0.
    288 void SampleCpuStateOnBlockingPool(
    289     int* cpu_count,
    290     std::vector<std::string>* cpu_idle_state_names,
    291     std::vector<CpuDataCollector::StateOccupancySample>* idle_samples,
    292     std::vector<std::string>* cpu_freq_state_names,
    293     std::vector<CpuDataCollector::StateOccupancySample>* freq_samples) {
    294   DCHECK(!content::BrowserThread::CurrentlyOn(content::BrowserThread::UI));
    295 
    296   if (*cpu_count < 0) {
    297     // Set |cpu_count_| to 1. If it is something else, it will get corrected
    298     // later. A system will at least have one CPU. Hence, a value of 1 here
    299     // will serve as a default value in case of errors.
    300     *cpu_count = 1;
    301     const std::string possible_cpu_path = base::StringPrintf(
    302         "%s%s", kCpuDataPathBase, kPossibleCpuPathSuffix);
    303     if (!base::PathExists(base::FilePath(possible_cpu_path))) {
    304       LOG(ERROR) << "File listing possible CPUs missing. "
    305                  << "Defaulting CPU count to 1.";
    306     } else {
    307       std::string possible_string;
    308       if (base::ReadFileToString(base::FilePath(possible_cpu_path),
    309                                  &possible_string)) {
    310         int max_cpu;
    311         // The possible CPUs are listed in the format "0-N". Hence, N is present
    312         // in the substring starting at offset 2.
    313         base::TrimWhitespace(possible_string, base::TRIM_ALL, &possible_string);
    314         if (possible_string.find("-") != std::string::npos &&
    315             possible_string.length() > 2 &&
    316             base::StringToInt(possible_string.substr(2), &max_cpu)) {
    317           *cpu_count = max_cpu + 1;
    318         } else {
    319           LOG(ERROR) << "Unknown format in the file listing possible CPUs. "
    320                      << "Defaulting CPU count to 1.";
    321         }
    322       } else {
    323         LOG(ERROR) << "Error reading the file listing possible CPUs. "
    324                    << "Defaulting CPU count to 1.";
    325       }
    326     }
    327   }
    328 
    329   // Initialize the deques in the data vectors.
    330   SampleCpuIdleData(*cpu_count, cpu_idle_state_names, idle_samples);
    331   SampleCpuFreqData(*cpu_count, cpu_freq_state_names, freq_samples);
    332 }
    333 
    334 }  // namespace
    335 
    336 // Set |cpu_count_| to -1 and let SampleCpuStateOnBlockingPool discover the
    337 // correct number of CPUs.
    338 CpuDataCollector::CpuDataCollector() : cpu_count_(-1), weak_ptr_factory_(this) {
    339 }
    340 
    341 CpuDataCollector::~CpuDataCollector() {
    342 }
    343 
    344 void CpuDataCollector::Start() {
    345   timer_.Start(FROM_HERE,
    346                base::TimeDelta::FromSeconds(kCpuDataSamplePeriodSec),
    347                this,
    348                &CpuDataCollector::PostSampleCpuState);
    349 }
    350 
    351 void CpuDataCollector::PostSampleCpuState() {
    352   int* cpu_count = new int(cpu_count_);
    353   std::vector<std::string>* cpu_idle_state_names =
    354       new std::vector<std::string>(cpu_idle_state_names_);
    355   std::vector<StateOccupancySample>* idle_samples =
    356       new std::vector<StateOccupancySample>;
    357   std::vector<std::string>* cpu_freq_state_names =
    358       new std::vector<std::string>(cpu_freq_state_names_);
    359   std::vector<StateOccupancySample>* freq_samples =
    360       new std::vector<StateOccupancySample>;
    361 
    362   content::BrowserThread::PostBlockingPoolTaskAndReply(
    363       FROM_HERE,
    364       base::Bind(&SampleCpuStateOnBlockingPool,
    365                  base::Unretained(cpu_count),
    366                  base::Unretained(cpu_idle_state_names),
    367                  base::Unretained(idle_samples),
    368                  base::Unretained(cpu_freq_state_names),
    369                  base::Unretained(freq_samples)),
    370       base::Bind(&CpuDataCollector::SaveCpuStateSamplesOnUIThread,
    371                  weak_ptr_factory_.GetWeakPtr(),
    372                  base::Owned(cpu_count),
    373                  base::Owned(cpu_idle_state_names),
    374                  base::Owned(idle_samples),
    375                  base::Owned(cpu_freq_state_names),
    376                  base::Owned(freq_samples)));
    377 }
    378 
    379 void CpuDataCollector::SaveCpuStateSamplesOnUIThread(
    380     const int* cpu_count,
    381     const std::vector<std::string>* cpu_idle_state_names,
    382     const std::vector<CpuDataCollector::StateOccupancySample>* idle_samples,
    383     const std::vector<std::string>* cpu_freq_state_names,
    384     const std::vector<CpuDataCollector::StateOccupancySample>* freq_samples) {
    385   DCHECK(content::BrowserThread::CurrentlyOn(content::BrowserThread::UI));
    386 
    387   cpu_count_ = *cpu_count;
    388 
    389   // |idle_samples| or |freq_samples| could be empty sometimes (for example, if
    390   // sampling was interrupted due to system suspension). Iff they are not empty,
    391   // they will have one sample each for each of the CPUs.
    392 
    393   if (!idle_samples->empty()) {
    394     // When committing the first sample, resize the data vector to the number of
    395     // CPUs on the system. This number should be the same as the number of
    396     // samples in |idle_samples|.
    397     if (cpu_idle_state_data_.empty()) {
    398       cpu_idle_state_data_.resize(idle_samples->size());
    399     } else {
    400       DCHECK_EQ(idle_samples->size(), cpu_idle_state_data_.size());
    401     }
    402     for (size_t i = 0; i < cpu_idle_state_data_.size(); ++i)
    403       AddSample(&cpu_idle_state_data_[i], (*idle_samples)[i]);
    404 
    405     cpu_idle_state_names_ = *cpu_idle_state_names;
    406   }
    407 
    408   if (!freq_samples->empty()) {
    409     // As with idle samples, resize the data vector before committing the first
    410     // sample.
    411     if (cpu_freq_state_data_.empty()) {
    412       cpu_freq_state_data_.resize(freq_samples->size());
    413     } else {
    414       DCHECK_EQ(freq_samples->size(), cpu_freq_state_data_.size());
    415     }
    416     for (size_t i = 0; i < cpu_freq_state_data_.size(); ++i)
    417       AddSample(&cpu_freq_state_data_[i], (*freq_samples)[i]);
    418 
    419     cpu_freq_state_names_ = *cpu_freq_state_names;
    420   }
    421 }
    422 
    423 CpuDataCollector::StateOccupancySample::StateOccupancySample()
    424     : cpu_online(false) {
    425 }
    426 
    427 CpuDataCollector::StateOccupancySample::~StateOccupancySample() {
    428 }
    429 
    430 }  // namespace chromeos
    431