sdmmc: implement driver suitable for fs + bootloader

* sdmmc: begin skeletoning sdmmc driver

* sdmmc: add most of SdHostStandardController

* sdmmc: implement most of SdmmcController

* sdmmc: Sdmmc2Controller

* sdmmc: skeleton implementation of Sdmmc1Controller

* sdmmc: complete abstract logic for Sdmmc1 power controller

* sdmmc: implement gpio handling for sdmmc1-register-control

* sdmmc: implement pinmux handling for sdmmc1-register-control

* sdmmc: fix building for arm32 and in stratosphere context

* sdmmc: implement voltage enable/set for sdmmc1-register-control

* util: move T(V)SNPrintf from kernel to util

* sdmmc: implement BaseDeviceAccessor

* sdmmc: implement MmcDeviceAccessor

* sdmmc: implement clock reset controller for register api

* sdmmc: fix bug in WaitWhileCommandInhibit, add mmc accessors

* exo: add sdmmc test program

* sdmmc: fix speed mode extension, add CheckMmcConnection for debug

* sdmmc: add DeviceDetector, gpio: implement client api

* gpio: modernize client api instead of doing it the lazy way

* sdmmc: SdCardDeviceAccessor impl

* sdmmc: update test program to read first two sectors of sd card

* sdmmc: fix vref sel

* sdmmc: finish outward-facing api (untested)

* ams: changes for libvapours including tegra register defs

* sdmmc: remove hwinit

libraries/libvapours/include/vapours/sdmmc/sdmmc_build_config.hpp

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2018-2020 Atmosphère-NX
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+#include <vapours/common.hpp>
+#include <vapours/assert.hpp>
+#include <vapours/results.hpp>
+#include <vapours/util.hpp>
+#include <vapours/svc.hpp>
+#include <vapours/dd.hpp>
+
+#if defined(ATMOSPHERE_IS_EXOSPHERE)
+
+    //#define AMS_SDMMC_THREAD_SAFE
+    //#define AMS_SDMMC_USE_DEVICE_VIRTUAL_ADDRESS
+    //#define AMS_SDMMC_USE_PCV_CLOCK_RESET_CONTROL
+    //#define AMS_SDMMC_USE_DEVICE_DETECTOR
+    //#define AMS_SDMMC_USE_LOGGER
+    //#define AMS_SDMMC_USE_OS_EVENTS
+    //#define AMS_SDMMC_USE_OS_TIMER
+    #define AMS_SDMMC_USE_UTIL_TIMER
+    //#define AMS_SDMMC_ENABLE_MMC_HS400
+    //#define AMS_SDMMC_ENABLE_SD_UHS_I
+    //#define AMS_SDMMC_SET_PLLC4_BASE
+    //#define AMS_SDMMC_USE_SD_CARD_DETECTOR
+
+#elif defined(ATMOSPHERE_IS_MESOSPHERE)
+
+    //#define AMS_SDMMC_THREAD_SAFE
+    //#define AMS_SDMMC_USE_DEVICE_VIRTUAL_ADDRESS
+    //#define AMS_SDMMC_USE_PCV_CLOCK_RESET_CONTROL
+    //#define AMS_SDMMC_USE_DEVICE_DETECTOR
+    //#define AMS_SDMMC_USE_LOGGER
+    //#define AMS_SDMMC_USE_OS_EVENTS
+    //#define AMS_SDMMC_USE_OS_TIMER
+    #define AMS_SDMMC_USE_UTIL_TIMER
+    //#define AMS_SDMMC_ENABLE_MMC_HS400
+    //#define AMS_SDMMC_ENABLE_SD_UHS_I
+    //#define AMS_SDMMC_SET_PLLC4_BASE
+    //#define AMS_SDMMC_USE_SD_CARD_DETECTOR
+
+#elif defined(ATMOSPHERE_IS_STRATOSPHERE)
+
+    #define AMS_SDMMC_THREAD_SAFE
+    #define AMS_SDMMC_USE_DEVICE_VIRTUAL_ADDRESS
+    #define AMS_SDMMC_USE_PCV_CLOCK_RESET_CONTROL
+    #define AMS_SDMMC_USE_DEVICE_DETECTOR
+    #define AMS_SDMMC_USE_LOGGER
+    #define AMS_SDMMC_USE_OS_EVENTS
+    #define AMS_SDMMC_USE_OS_TIMER
+    //#define AMS_SDMMC_USE_UTIL_TIMER
+    #define AMS_SDMMC_ENABLE_MMC_HS400
+    #define AMS_SDMMC_ENABLE_SD_UHS_I
+    #define AMS_SDMMC_SET_PLLC4_BASE
+    #define AMS_SDMMC_USE_SD_CARD_DETECTOR
+
+#else
+    #error "Unknown execution context for ams::sdmmc!"
+#endif

libraries/libvapours/include/vapours/sdmmc/sdmmc_common.hpp

@@ -0,0 +1,114 @@
+/*
+ * Copyright (c) 2018-2020 Atmosphère-NX
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+#include <vapours/sdmmc/sdmmc_build_config.hpp>
+
+namespace ams::sdmmc {
+
+    enum BusPower {
+        BusPower_Off  = 0,
+        BusPower_1_8V = 1,
+        BusPower_3_3V = 2,
+    };
+
+    enum BusWidth {
+        BusWidth_1Bit = 0,
+        BusWidth_4Bit = 1,
+        BusWidth_8Bit = 2,
+    };
+
+    enum SpeedMode {
+        SpeedMode_MmcIdentification     =  0,
+        SpeedMode_MmcLegacySpeed        =  1,
+        SpeedMode_MmcHighSpeed          =  2,
+        SpeedMode_MmcHs200              =  3,
+        SpeedMode_MmcHs400              =  4,
+        SpeedMode_SdCardIdentification  =  5,
+        SpeedMode_SdCardDefaultSpeed    =  6,
+        SpeedMode_SdCardHighSpeed       =  7,
+        SpeedMode_SdCardSdr12           =  8,
+        SpeedMode_SdCardSdr25           =  9,
+        SpeedMode_SdCardSdr50           = 10,
+        SpeedMode_SdCardSdr104          = 11,
+        SpeedMode_SdCardDdr50           = 12,
+        SpeedMode_GcAsicFpgaSpeed       = 13,
+        SpeedMode_GcAsicSpeed           = 14,
+    };
+
+    enum Port {
+        Port_Mmc0 = 0,
+        Port_SdCard0 = 1,
+        Port_GcAsic0 = 2,
+    };
+
+    struct ErrorInfo {
+        u32 num_activation_failures;
+        u32 num_activation_error_corrections;
+        u32 num_read_write_failures;
+        u32 num_read_write_error_corrections;
+    };
+
+    struct DataTransfer {
+        void *buffer;
+        size_t buffer_size;
+        size_t block_size;
+        u32 num_blocks;
+        bool is_read;
+    };
+
+    using DeviceDetectionEventCallback = void (*)(void *);
+
+    constexpr inline size_t SectorSize    = 0x200;
+
+    constexpr inline size_t DeviceCidSize = 0x10;
+    constexpr inline size_t DeviceCsdSize = 0x10;
+
+    constexpr inline size_t BufferDeviceVirtualAddressAlignment = alignof(ams::dd::DeviceVirtualAddress);
+    static_assert(BufferDeviceVirtualAddressAlignment >= 8);
+
+    void Initialize(Port port);
+    void Finalize(Port port);
+
+#if defined(AMS_SDMMC_USE_PCV_CLOCK_RESET_CONTROL)
+    void SwitchToPcvClockResetControl();
+#endif
+
+#if defined(AMS_SDMMC_USE_DEVICE_VIRTUAL_ADDRESS)
+    void RegisterDeviceVirtualAddress(Port port, uintptr_t buffer, size_t buffer_size, ams::dd::DeviceVirtualAddress buffer_device_virtual_address);
+    void UnregisterDeviceVirtualAddress(Port port, uintptr_t buffer, size_t buffer_size, ams::dd::DeviceVirtualAddress buffer_device_virtual_address);
+#endif
+
+    void ChangeCheckTransferInterval(Port port, u32 ms);
+    void SetDefaultCheckTransferInterval(Port port);
+
+    Result Activate(Port port);
+    void Deactivate(Port port);
+
+    Result Read(void *dst, size_t dst_size, Port port, u32 sector_index, u32 num_sectors);
+    Result Write(Port port, u32 sector_index, u32 num_sectors, const void *src, size_t src_size);
+
+    Result CheckConnection(SpeedMode *out_speed_mode, BusWidth *out_bus_width, Port port);
+
+    Result GetDeviceSpeedMode(SpeedMode *out, Port port);
+    Result GetDeviceMemoryCapacity(u32 *out_num_sectors, Port port);
+    Result GetDeviceStatus(u32 *out_device_status, Port port);
+    Result GetDeviceCid(void *out, size_t out_size, Port port);
+    Result GetDeviceCsd(void *out, size_t out_size, Port port);
+
+    void GetAndClearErrorInfo(ErrorInfo *out_error_info, size_t *out_log_size, char *out_log_buffer, size_t log_buffer_size, Port port);
+
+}

libraries/libvapours/include/vapours/sdmmc/sdmmc_gc_asic.hpp

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2018-2020 Atmosphère-NX
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#pragma once
+#include <vapours/sdmmc/sdmmc_build_config.hpp>
+
+namespace ams::sdmmc {
+
+    constexpr inline size_t GcAsicOperationSize = 0x40;
+
+    void PutGcAsicToSleep(Port port);
+    Result AwakenGcAsic(Port port);
+    Result WriteGcAsicOperation(Port port, const void *op_buf, size_t op_buf_size);
+    Result FinishGcAsicOperation(Port port);
+    Result AbortGcAsicOperation(Port port);
+    Result SleepGcAsic(Port port);
+    Result UpdateGcAsicKey(Port port);
+
+    void SignalGcRemovedEvent(Port port);
+    void ClearGcRemovedEvent(Port port);
+
+}

libraries/libvapours/include/vapours/sdmmc/sdmmc_mmc.hpp

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2018-2020 Atmosphère-NX
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+#include <vapours/sdmmc/sdmmc_build_config.hpp>
+
+
+namespace ams::sdmmc {
+
+    enum MmcPartition {
+        MmcPartition_UserData       = 0,
+        MmcPartition_BootPartition1 = 1,
+        MmcPartition_BootPartition2 = 2,
+        MmcPartition_Unknown        = 3,
+    };
+
+    constexpr inline size_t MmcExtendedCsdSize = 0x200;
+    constexpr inline size_t MmcWorkBufferSize  = MmcExtendedCsdSize;
+
+    void SetMmcWorkBuffer(Port port, void *buffer, size_t buffer_size);
+    void PutMmcToSleep(Port port);
+    void AwakenMmc(Port port);
+    Result SelectMmcPartition(Port port, MmcPartition mmc_partition);
+    Result EraseMmc(Port port);
+    Result GetMmcBootPartitionCapacity(u32 *out_num_sectors, Port port);
+    Result GetMmcExtendedCsd(void *out_buffer, size_t buffer_size, Port port);
+
+    Result CheckMmcConnection(SpeedMode *out_speed_mode, BusWidth *out_bus_width, Port port);
+
+}

libraries/libvapours/include/vapours/sdmmc/sdmmc_sd_card.hpp

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2018-2020 Atmosphère-NX
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#pragma once
+#include <vapours/sdmmc/sdmmc_build_config.hpp>
+
+namespace ams::sdmmc {
+
+    enum SdCardSwitchFunction {
+        SdCardSwitchFunction_CheckSupportedFunction = 0,
+        SdCardSwitchFunction_CheckDefault           = 1,
+        SdCardSwitchFunction_CheckHighSpeed         = 2,
+        SdCardSwitchFunction_CheckSdr50             = 3,
+        SdCardSwitchFunction_CheckSdr104            = 4,
+        SdCardSwitchFunction_CheckDdr50             = 5,
+    };
+
+    constexpr inline size_t SdCardScrSize                  = 0x08;
+    constexpr inline size_t SdCardSwitchFunctionStatusSize = 0x40;
+    constexpr inline size_t SdCardSdStatusSize             = 0x40;
+
+    constexpr inline size_t SdCardWorkBufferSize           = SdCardSdStatusSize;
+
+    void SetSdCardWorkBuffer(Port port, void *buffer, size_t buffer_size);
+    void PutSdCardToSleep(Port port);
+    void AwakenSdCard(Port port);
+    Result GetSdCardProtectedAreaCapacity(u32 *out_num_sectors, Port port);
+    Result GetSdCardScr(void *dst, size_t dst_size, Port port);
+    Result GetSdCardSwitchFunctionStatus(void *dst, size_t dst_size, Port port, SdCardSwitchFunction switch_function);
+    Result GetSdCardCurrentConsumption(u16 *out_current_consumption, Port port, SpeedMode speed_mode);
+    Result GetSdCardSdStatus(void *dst, size_t dst_size, Port port);
+
+    Result CheckSdCardConnection(SpeedMode *out_speed_mode, BusWidth *out_bus_width, Port port);
+
+    bool IsSdCardInserted(Port port);
+    bool IsSdCardRemoved(Port port);
+
+    void RegisterSdCardDetectionEventCallback(Port port, DeviceDetectionEventCallback callback, void *arg);
+    void UnregisterSdCardDetectionEventCallback(Port port);
+
+}