Kernel: Add an SD card driver for the aarch64 port

Co-authored-by: Ollrogge <nils-ollrogge@outlook.de>

Kernel/Storage/SD/SDHostController.h

@@ -0,0 +1,89 @@
+/*
+ * Copyright (c) 2023, the SerenityOS developers.
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <AK/Badge.h>
+#include <AK/Function.h>
+#include <AK/Result.h>
+#include <AK/Types.h>
+#include <Kernel/Locking/Mutex.h>
+#include <Kernel/Storage/SD/Commands.h>
+#include <Kernel/Storage/SD/Registers.h>
+#include <Kernel/Storage/SD/SDMemoryCard.h>
+
+namespace Kernel {
+
+class SDHostController : public StorageController {
+public:
+    SDHostController();
+    ErrorOr<void> initialize();
+
+    virtual ~SDHostController() = default;
+
+    virtual LockRefPtr<StorageDevice> device(u32 index) const override { return index == 0 ? m_card : nullptr; }
+    virtual ErrorOr<void> reset() override;
+    virtual ErrorOr<void> shutdown() override;
+    virtual size_t devices_count() const override { return m_card ? 1 : 0; }
+    virtual void complete_current_request(AsyncDeviceRequest::RequestResult) override;
+
+    ErrorOr<void> read_block(Badge<SDMemoryCard>, u32 block_address, u32 block_count, UserOrKernelBuffer out);
+    ErrorOr<void> write_block(Badge<SDMemoryCard>, u32 block_address, u32 block_count, UserOrKernelBuffer in);
+
+protected:
+    virtual SD::HostControlRegisterMap volatile* get_register_map_base_address() = 0;
+
+private:
+    ErrorOr<NonnullLockRefPtr<SDMemoryCard>> try_initialize_inserted_card();
+
+    bool is_card_inserted() const
+    {
+        constexpr u32 card_inserted = 1 << 16;
+        return m_registers->present_state & card_inserted;
+    }
+
+    SD::HostVersion host_version() { return m_registers->slot_interrupt_status_and_version.specification_version_number; }
+
+    ErrorOr<void> reset_host_controller();
+
+    SD::Command last_sent_command()
+    {
+        SD::Command command {};
+        command.raw = m_registers->transfer_mode_and_command;
+        return command;
+    }
+    bool currently_active_command_uses_transfer_complete_interrupt();
+
+    ErrorOr<void> sd_clock_supply(u32 frequency);
+    void sd_clock_stop();
+    ErrorOr<void> sd_clock_frequency_change(u32 frequency);
+    ErrorOr<u32> retrieve_sd_clock_frequency();
+
+    struct Response {
+        u32 response[4];
+    };
+    ErrorOr<void> issue_command(SD::Command const&, u32 argument);
+    ErrorOr<Response> wait_for_response();
+
+    bool card_status_contains_errors(SD::Command const&, u32);
+
+    bool retry_with_timeout(Function<bool()>, i64 delay_between_tries = 100);
+
+    enum class DataTransferType {
+        Read,
+        Write
+    };
+    ErrorOr<void> transaction_control_with_data_transfer_using_the_dat_line_without_dma(SD::Command const&, u32 argument, u32 block_count, u32 block_size, UserOrKernelBuffer, DataTransferType data_transfer_type);
+    ErrorOr<SD::SDConfigurationRegister> retrieve_sd_configuration_register(u32 relative_card_address);
+
+    volatile SD::HostControlRegisterMap* m_registers;
+    LockRefPtr<SDMemoryCard> m_card { nullptr };
+
+    u32 m_hardware_relative_controller_id { 0 };
+    Mutex m_lock { "SDHostController"sv };
+};
+
+}