haiku/headers/private/drivers/mmc.h

/*
 * Copyright 2019, Haiku, Inc. All Rights Reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
 *		Adrien Destugues, pulkomandy@pulkomandy.tk
 */
#ifndef _MMC_H
#define _MMC_H


#include <device_manager.h>


#define MMC_BUS_MODULE_NAME "bus_managers/mmc_bus/driver_v1"


enum {
	CARD_TYPE_MMC,
	CARD_TYPE_SD,
	CARD_TYPE_SDHC,
	CARD_TYPE_UHS1,
	CARD_TYPE_UHS2,
	CARD_TYPE_SDIO
};


// Interface between mmc_bus and underlying implementation
typedef struct mmc_bus_interface {
	driver_module_info info;

	status_t (*set_clock)(void* controller, uint32_t kilohertz);
	status_t (*execute_command)(void* controller, uint8_t command,
		uint32_t argument, uint32_t* result);
} mmc_bus_interface;


// Interface between mmc device driver (mmc_disk, sdio drivers, ...) and mmc_bus
typedef struct mmc_device_interface {
	driver_module_info info;

	status_t (*execute_command)(device_node* node, uint8_t command,
		uint32_t argument, uint32_t* result);
} mmc_device_interface;


#endif /* _MMC_H */
sdhci and mmc implementation sdhci: - Add semaphore for interrupt management - Add basic operations (setting clock, executing a command) - Add early initialization (clocks and power up) - Wrap the bus in a C++ class to ease usage - Expose API to MMC bus manager - TODO: manage card insertion and removal interrupts - TODO: use MSI when available mmc_bus: - Implements SD card management independant of the way we access the bus (later on different drivers can provide the same API as SDHCI) - Worker thread to do the initialization - Implement card initialization process up until getting an RCA from the card. This is the generic part to assign an ID to the card, after this point commands can be targetted at the specific card so it can be handed over to the mmc_disk driver. - TODO: initialization for non-SDHC cards which do not reply to CMD8. Change-Id: I71950ca3ce206378a68fa7f97c19f638183d6cdd Reviewed-on: https://review.haiku-os.org/c/1032 Reviewed-by: waddlesplash <waddlesplash@gmail.com> 2019-02-11 00:39:02 +03:00			`/*`
			`* Copyright 2019, Haiku, Inc. All Rights Reserved.`
			`* Distributed under the terms of the MIT License.`
			`*`
			`* Authors:`
			`* Adrien Destugues, pulkomandy@pulkomandy.tk`
			`*/`
			`#ifndef _MMC_H`
			`#define _MMC_H`


			`#include <device_manager.h>`


			`#define MMC_BUS_MODULE_NAME "bus_managers/mmc_bus/driver_v1"`


mmc: register devices for detected cards Change-Id: I90891ead9a425e0e8bd25c2190fe3d430d49411b Reviewed-on: https://review.haiku-os.org/c/haiku/+/1067 Reviewed-by: waddlesplash <waddlesplash@gmail.com> 2019-02-17 13:54:12 +03:00			`enum {`
			`CARD_TYPE_MMC,`
			`CARD_TYPE_SD,`
			`CARD_TYPE_SDHC,`
			`CARD_TYPE_UHS1,`
			`CARD_TYPE_UHS2,`
			`CARD_TYPE_SDIO`
			`};`


sdhci and mmc implementation sdhci: - Add semaphore for interrupt management - Add basic operations (setting clock, executing a command) - Add early initialization (clocks and power up) - Wrap the bus in a C++ class to ease usage - Expose API to MMC bus manager - TODO: manage card insertion and removal interrupts - TODO: use MSI when available mmc_bus: - Implements SD card management independant of the way we access the bus (later on different drivers can provide the same API as SDHCI) - Worker thread to do the initialization - Implement card initialization process up until getting an RCA from the card. This is the generic part to assign an ID to the card, after this point commands can be targetted at the specific card so it can be handed over to the mmc_disk driver. - TODO: initialization for non-SDHC cards which do not reply to CMD8. Change-Id: I71950ca3ce206378a68fa7f97c19f638183d6cdd Reviewed-on: https://review.haiku-os.org/c/1032 Reviewed-by: waddlesplash <waddlesplash@gmail.com> 2019-02-11 00:39:02 +03:00			`// Interface between mmc_bus and underlying implementation`
			`typedef struct mmc_bus_interface {`
			`driver_module_info info;`

			`status_t (set_clock)(void controller, uint32_t kilohertz);`
			`status_t (execute_command)(void controller, uint8_t command,`
			`uint32_t argument, uint32_t* result);`
			`} mmc_bus_interface;`


mmc_bus: add execute_command function For now it just forwards the command to the SDHCI controller. The bus will gain more features and functions as work advances (tracking which card is active, arbitration of DMA transfers, etc). Change-Id: I094eb84f27e7789387a3f8fb65fba1e5fcfa3e8a Reviewed-on: https://review.haiku-os.org/c/haiku/+/3094 Reviewed-by: waddlesplash <waddlesplash@gmail.com> 2020-07-26 14:49:20 +03:00			`// Interface between mmc device driver (mmc_disk, sdio drivers, ...) and mmc_bus`
			`typedef struct mmc_device_interface {`
			`driver_module_info info;`

			`status_t (execute_command)(device_node node, uint8_t command,`
			`uint32_t argument, uint32_t* result);`
			`} mmc_device_interface;`


sdhci and mmc implementation sdhci: - Add semaphore for interrupt management - Add basic operations (setting clock, executing a command) - Add early initialization (clocks and power up) - Wrap the bus in a C++ class to ease usage - Expose API to MMC bus manager - TODO: manage card insertion and removal interrupts - TODO: use MSI when available mmc_bus: - Implements SD card management independant of the way we access the bus (later on different drivers can provide the same API as SDHCI) - Worker thread to do the initialization - Implement card initialization process up until getting an RCA from the card. This is the generic part to assign an ID to the card, after this point commands can be targetted at the specific card so it can be handed over to the mmc_disk driver. - TODO: initialization for non-SDHC cards which do not reply to CMD8. Change-Id: I71950ca3ce206378a68fa7f97c19f638183d6cdd Reviewed-on: https://review.haiku-os.org/c/1032 Reviewed-by: waddlesplash <waddlesplash@gmail.com> 2019-02-11 00:39:02 +03:00			`#endif /* _MMC_H */`