drivers/gpu/msd-arm-mali/src/power_manager.h

// Copyright 2017 The Fuchsia 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_H_
#define POWER_MANAGER_H_

#include <chrono>
#include <deque>
#include <mutex>

#include "platform_semaphore.h"
#include <magma_util/macros.h>
#include <magma_util/register_io.h>

// This class generally lives on the device thread.
class PowerManager {
public:
    PowerManager(magma::RegisterIo* io);

    // Called on the device thread or the initial driver thread.
    void EnableCores(magma::RegisterIo* io, uint64_t shader_bitmask);

    // Called on the GPU interrupt thread.
    void ReceivedPowerInterrupt(magma::RegisterIo* io);

    uint64_t l2_ready_status() const
    {
        std::lock_guard<std::mutex> lock(ready_status_mutex_);
        return l2_ready_status_;
    }

    // This is called whenever the GPU starts or stops processing work.
    void UpdateGpuActive(bool active);

    // Retrieves information on what fraction of time in the recent past (last
    // 100 ms or so) the GPU was actively processing commands.
    void GetGpuActiveInfo(std::chrono::steady_clock::duration* total_time_out,
                          std::chrono::steady_clock::duration* active_time_out);

    void DisableL2(magma::RegisterIo* io);
    bool WaitForL2Disable(magma::RegisterIo* io);
    bool WaitForShaderReady(magma::RegisterIo* io);

private:
    friend class TestMsdArmDevice;
    friend class TestPowerManager;

    struct TimePeriod {
        std::chrono::steady_clock::time_point end_time;
        std::chrono::steady_clock::duration total_time;
        std::chrono::steady_clock::duration active_time;
    };

    std::deque<TimePeriod>& time_periods() { return time_periods_; }

    mutable std::mutex ready_status_mutex_;
    MAGMA_GUARDED(ready_status_mutex_) uint64_t tiler_ready_status_ = 0;
    MAGMA_GUARDED(ready_status_mutex_) uint64_t l2_ready_status_ = 0;

    std::unique_ptr<magma::PlatformSemaphore> power_state_semaphore_;

    std::deque<TimePeriod> time_periods_;
    bool gpu_active_ = false;
    std::chrono::steady_clock::time_point last_check_time_;
};

#endif // POWER_MANAGER_H_