mirror of
https://github.com/RGBCube/serenity
synced 2025-05-31 13:48:12 +00:00
a6a439243f
This step would ideally not have been necessary (increases amount of refactoring and templates necessary, which in turn increases build times), but it gives us a couple of nice properties: - SpinlockProtected inside Singleton (a very common combination) can now obtain any lock rank just via the template parameter. It was not previously possible to do this with SingletonInstanceCreator magic. - SpinlockProtected's lock rank is now mandatory; this is the majority of cases and allows us to see where we're still missing proper ranks. - The type already informs us what lock rank a lock has, which aids code readability and (possibly, if gdb cooperates) lock mismatch debugging. - The rank of a lock can no longer be dynamic, which is not something we wanted in the first place (or made use of). Locks randomly changing their rank sounds like a disaster waiting to happen. - In some places, we might be able to statically check that locks are taken in the right order (with the right lock rank checking implementation) as rank information is fully statically known. This refactoring even more exposes the fact that Mutex has no lock rank capabilites, which is not fixed here.
65 lines
2.2 KiB
C++
65 lines
2.2 KiB
C++
/*
|
|
* Copyright (c) 2021-2022, Liav A. <liavalb@hotmail.co.il>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/OwnPtr.h>
|
|
#include <AK/Types.h>
|
|
#include <Kernel/Library/LockRefPtr.h>
|
|
#include <Kernel/Sections.h>
|
|
#include <Kernel/Storage/ATA/AHCI/Definitions.h>
|
|
#include <Kernel/Storage/ATA/ATAController.h>
|
|
#include <Kernel/Storage/StorageDevice.h>
|
|
|
|
namespace Kernel {
|
|
|
|
class AsyncBlockDeviceRequest;
|
|
class AHCIInterruptHandler;
|
|
class AHCIPort;
|
|
class AHCIController final : public ATAController
|
|
, public PCI::Device {
|
|
friend class AHCIInterruptHandler;
|
|
|
|
public:
|
|
static NonnullLockRefPtr<AHCIController> initialize(PCI::DeviceIdentifier const& pci_device_identifier);
|
|
virtual ~AHCIController() override;
|
|
|
|
virtual LockRefPtr<StorageDevice> device(u32 index) const override;
|
|
virtual bool reset() override;
|
|
virtual bool shutdown() override;
|
|
virtual size_t devices_count() const override;
|
|
virtual void start_request(ATADevice const&, AsyncBlockDeviceRequest&) override;
|
|
virtual void complete_current_request(AsyncDeviceRequest::RequestResult) override;
|
|
|
|
void handle_interrupt_for_port(Badge<AHCIInterruptHandler>, u32 port_index) const;
|
|
|
|
private:
|
|
void disable_global_interrupts() const;
|
|
void enable_global_interrupts() const;
|
|
|
|
explicit AHCIController(PCI::DeviceIdentifier const&);
|
|
void initialize_hba(PCI::DeviceIdentifier const&);
|
|
|
|
AHCI::HBADefinedCapabilities capabilities() const;
|
|
LockRefPtr<StorageDevice> device_by_port(u32 index) const;
|
|
|
|
volatile AHCI::PortRegisters& port(size_t port_number) const;
|
|
NonnullOwnPtr<Memory::Region> default_hba_region() const;
|
|
volatile AHCI::HBA& hba() const;
|
|
|
|
Array<LockRefPtr<AHCIPort>, 32> m_ports;
|
|
NonnullOwnPtr<Memory::Region> m_hba_region;
|
|
AHCI::HBADefinedCapabilities m_hba_capabilities;
|
|
|
|
// FIXME: There could be multiple IRQ (MSI) handlers for AHCI. Find a way to use all of them.
|
|
OwnPtr<AHCIInterruptHandler> m_irq_handler;
|
|
|
|
// Note: This lock is intended to be locked when doing changes to HBA registers
|
|
// that affect its core functionality in a manner that controls all attached storage devices
|
|
// to the HBA SATA ports.
|
|
mutable Spinlock<LockRank::None> m_hba_control_lock {};
|
|
};
|
|
}
|