power_manager/powerd/policy/charge_controller.h

// Copyright 2019 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef POWER_MANAGER_POWERD_POLICY_CHARGE_CONTROLLER_H_
#define POWER_MANAGER_POWERD_POLICY_CHARGE_CONTROLLER_H_

#include <string>

#include <base/macros.h>
#include <base/optional.h>

#include "power_manager/proto_bindings/policy.pb.h"

namespace power_manager {

class BatteryPercentageConverter;

namespace system {
class ChargeControllerHelperInterface;
}  // namespace system

namespace policy {

// ChargeController is responsible for handling power policies:
// peak shift, advanced battery charge.
class ChargeController {
 public:
  ChargeController();
  ~ChargeController();

  // |helper| and |battery_percentage_converter| must be non-null.
  void Init(system::ChargeControllerHelperInterface* helper,
            BatteryPercentageConverter* battery_percentage_converter);

  // Does nothing if |policy| and |cached_policy_| peak shift related fields are
  // equal. Otherwise updates the charging configuration per |policy| and
  // copies |policy| to |cached_policy_|.
  void HandlePolicyChange(const PowerManagementPolicy& policy);

 private:
  bool ApplyPolicyChange(const PowerManagementPolicy& policy);
  bool ApplyPeakShiftChange(const PowerManagementPolicy& policy);
  bool ApplyBootOnAcChange(const PowerManagementPolicy& policy);
  bool ApplyUsbPowerShareChange(const PowerManagementPolicy& policy);
  bool ApplyAdvancedBatteryChargeModeChange(
      const PowerManagementPolicy& policy);
  bool ApplyBatteryChargeModeChange(const PowerManagementPolicy& policy);

  // Calls delegate's |SetPeakShiftDayConfig| function and returns the result
  // if |day_config| contains all needed fields, otherwise returns false.
  bool SetPeakShiftDayConfig(
      const PowerManagementPolicy::PeakShiftDayConfig& day_config);

  // Calls delegate's |SetAdvancedBatteryChargeModeDayConfig| function and
  // returns the result if |day_config| contains all needed fields, otherwise
  // returns false.
  bool SetAdvancedBatteryChargeModeDayConfig(
      const PowerManagementPolicy::AdvancedBatteryChargeModeDayConfig&
          day_config);

  // Checks that charging-related fields are equal between |policy| and
  // |cached_policy_|.
  bool IsPolicyEqualToCache(const PowerManagementPolicy& policy) const;

  // Not owned.
  system::ChargeControllerHelperInterface* helper_ = nullptr;

  // Not owned.
  BatteryPercentageConverter* battery_percentage_converter_ = nullptr;

  // Contains last successfully applied power policies settings.
  base::Optional<PowerManagementPolicy> cached_policy_;

  DISALLOW_COPY_AND_ASSIGN(ChargeController);
};

}  // namespace policy
}  // namespace power_manager

#endif  // POWER_MANAGER_POWERD_POLICY_CHARGE_CONTROLLER_H_