c68adb787b
This is consistent with hardware behavior as shown by this test https://gist.github.com/ds84182/40e46129bd38b46a5100f15f96ba5eaf
77 lines
2.4 KiB
C++
77 lines
2.4 KiB
C++
// Copyright 2014 Citra Emulator Project
|
|
// Licensed under GPLv2 or any later version
|
|
// Refer to the license.txt file included.
|
|
|
|
#pragma once
|
|
|
|
#include <vector>
|
|
#include "common/common_types.h"
|
|
#include "core/hle/kernel/kernel.h"
|
|
#include "core/hle/result.h"
|
|
|
|
// Address arbiters are an underlying kernel synchronization object that can be created/used via
|
|
// supervisor calls (SVCs). They function as sort of a global lock. Typically, games/other CTR
|
|
// applications use them as an underlying mechanism to implement thread-safe barriers, events, and
|
|
// semaphores.
|
|
|
|
////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
// Kernel namespace
|
|
|
|
namespace Kernel {
|
|
|
|
class Thread;
|
|
|
|
enum class ArbitrationType : u32 {
|
|
Signal,
|
|
WaitIfLessThan,
|
|
DecrementAndWaitIfLessThan,
|
|
WaitIfLessThanWithTimeout,
|
|
DecrementAndWaitIfLessThanWithTimeout,
|
|
};
|
|
|
|
class AddressArbiter final : public Object {
|
|
public:
|
|
/**
|
|
* Creates an address arbiter.
|
|
*
|
|
* @param name Optional name used for debugging.
|
|
* @returns The created AddressArbiter.
|
|
*/
|
|
static SharedPtr<AddressArbiter> Create(std::string name = "Unknown");
|
|
|
|
std::string GetTypeName() const override {
|
|
return "Arbiter";
|
|
}
|
|
std::string GetName() const override {
|
|
return name;
|
|
}
|
|
|
|
static const HandleType HANDLE_TYPE = HandleType::AddressArbiter;
|
|
HandleType GetHandleType() const override {
|
|
return HANDLE_TYPE;
|
|
}
|
|
|
|
std::string name; ///< Name of address arbiter object (optional)
|
|
|
|
ResultCode ArbitrateAddress(SharedPtr<Thread> thread, ArbitrationType type, VAddr address,
|
|
s32 value, u64 nanoseconds);
|
|
|
|
private:
|
|
AddressArbiter();
|
|
~AddressArbiter() override;
|
|
|
|
/// Puts the thread to wait on the specified arbitration address under this address arbiter.
|
|
void WaitThread(SharedPtr<Thread> thread, VAddr wait_address);
|
|
|
|
/// Resume all threads found to be waiting on the address under this address arbiter
|
|
void ResumeAllThreads(VAddr address);
|
|
|
|
/// Resume one thread found to be waiting on the address under this address arbiter and return
|
|
/// the resumed thread.
|
|
SharedPtr<Thread> ResumeHighestPriorityThread(VAddr address);
|
|
|
|
/// Threads waiting for the address arbiter to be signaled.
|
|
std::vector<SharedPtr<Thread>> waiting_threads;
|
|
};
|
|
|
|
} // namespace Kernel
|