xref: /haiku/src/add-ons/kernel/bus_managers/mmc/mmc_bus.cpp (revision e46898932ce906c782f9f400b6d2d588ccb0af81)

/*
 * Copyright 2018-2020 Haiku, Inc. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
 *		B Krishnan Iyer, krishnaniyer97@gmail.com
 */
#include "mmc_bus.h"

#include <Errors.h>

#include <stdint.h>


MMCBus::MMCBus(device_node* node)
	:
	fNode(node),
	fController(NULL),
	fCookie(NULL),
	fStatus(B_OK),
	fWorkerThread(0)
{
	CALLED();

	// Get the parent info, it includes the API to send commands to the hardware
	device_node* parent = gDeviceManager->get_parent_node(node);
	fStatus = gDeviceManager->get_driver(parent,
		(driver_module_info**)&fController, &fCookie);
	gDeviceManager->put_node(parent);

	if (fStatus != B_OK) {
		ERROR("Not able to establish the bus %s\n",
			strerror(fStatus));
		return;
	}

	fSemaphore = create_sem(0, "MMC bus scan");
	fWorkerThread = spawn_kernel_thread(WorkerThread, "SD bus controller",
		B_NORMAL_PRIORITY, this);
	resume_thread(fWorkerThread);
}


MMCBus::~MMCBus()
{
	CALLED();

	// stop worker thread
	fStatus = B_SHUTTING_DOWN;

	status_t result;
	if (fWorkerThread != 0)
		wait_for_thread(fWorkerThread, &result);
	// TODO power off cards, stop clock, etc if needed.
}


status_t
MMCBus::InitCheck()
{
	return fStatus;
}


void
MMCBus::Rescan()
{
	// Just wake up the thread for a scan
	release_sem(fSemaphore);
}


status_t
MMCBus::ExecuteCommand(uint8_t command, uint32_t argument, uint32_t* response)
{
	return fController->execute_command(fCookie, command, argument, response);
}


status_t
MMCBus::WorkerThread(void* cookie)
{
	MMCBus* bus = (MMCBus*)cookie;
	uint32_t response;

	// We assume the bus defaults to 400kHz clock and has already powered on
	// cards.

	// Reset all cards on the bus
	bus->ExecuteCommand(0, 0, NULL);

	while (bus->fStatus != B_SHUTTING_DOWN) {
		// wait for bus to signal a card is inserted
		acquire_sem(bus->fSemaphore);
		TRACE("Scanning the bus\n");

		// Probe the voltage range
		// FIXME MMC cards will not reply to this! They expect CMD1 instead
		// SD v1 cards will also not reply, but we can proceed to ACMD41
		// If ACMD41 also does not work, it may be an SDIO card, too
		uint32_t probe = (1 << 8) | 0xAA;
		uint32_t hcs = 1 << 30;
		if (bus->ExecuteCommand(8, probe, &response) != B_OK) {
			TRACE("Card does not implement CMD8, may be a V1 SD card\n");
			// Do not check for SDHC support in this case
			hcs = 0;
		} else if (response != probe) {
			ERROR("Card does not support voltage range (expected %x, "
				"reply %x)\n", probe, response);
			// TODO what now?
		}

		// Probe OCR, waiting for card to become ready
		uint32_t ocr;
		do {
			uint32_t cardStatus;
			while (bus->ExecuteCommand(55, 0, &cardStatus)
					== B_BUSY) {
				ERROR("Card locked after CMD8...\n");
				snooze(1000000);
			}
			if ((cardStatus & 0xFFFF8000) != 0)
				ERROR("SD card reports error %x\n", cardStatus);
			if ((cardStatus & (1 << 5)) == 0)
				ERROR("Card did not enter ACMD mode\n");

			bus->ExecuteCommand(41, hcs | 0xFF8000, &ocr);

			if ((ocr & (1 << 31)) == 0) {
				TRACE("Card is busy\n");
				snooze(100000);
			}
		} while (((ocr & (1 << 31)) == 0));

		// FIXME this should be asked to each card, when there are multiple
		// ones. So ACMD41 should be moved inside the probing loop below?
		uint8_t cardType = CARD_TYPE_SD;

		if (ocr & hcs != 0)
			cardType = CARD_TYPE_SDHC;
		if (ocr & (1 << 29) != 0)
			cardType = CARD_TYPE_UHS2;
		if (ocr & (1 << 24) != 0)
			TRACE("Card supports 1.8v");
		TRACE("Voltage range: %x\n", ocr & 0xFFFFFF);

		// TODO send CMD11 to switch to low voltage mode if card supports it?

		// iterate CMD2/CMD3 to assign an RCA to all cards and publish devices
		// for each of them
		uint32_t cid[4];
		while (bus->ExecuteCommand(2, 0, cid) == B_OK) {
			bus->ExecuteCommand(3, 0, &response);

			TRACE("RCA: %x Status: %x\n", response >> 16, response & 0xFFFF);

			if ((response & 0xFF00) != 0x500) {
				TRACE("Card did not enter data state\n");
				// This probably means there are no more cards to scan on the
				// bus, so exit the loop.
				break;
			}

			// The card now has an RCA and it entered the data phase, which
			// means our initializing job is over, we can pass it on to the
			// mmc_disk driver.

			uint32_t vendor = cid[3] & 0xFFFFFF;
			char name[6] = {cid[2] >> 24, cid[2] >> 16, cid[2] >> 8, cid[2],
				cid[1] >> 24, 0};
			uint32_t serial = (cid[1] << 16) | (cid[0] >> 16);
			uint16_t revision = (cid[1] >> 20) & 0xF;
			revision *= 100;
			revision += (cid[1] >> 16) & 0xF;
			uint8_t month = cid[0] & 0xF;
			uint16_t year = 2000 + ((cid[0] >> 4) & 0xFF);
			uint16_t rca = response >> 16;

			device_attr attrs[] = {
				{ B_DEVICE_BUS, B_STRING_TYPE, {string: "mmc" }},
				{ B_DEVICE_PRETTY_NAME, B_STRING_TYPE, {string: "mmc device" }},
				{ B_DEVICE_VENDOR_ID, B_UINT32_TYPE, {ui32: vendor}},
				{ B_DEVICE_ID, B_STRING_TYPE, {string: name}},
				{ B_DEVICE_UNIQUE_ID, B_UINT32_TYPE, {ui32: serial}},
				{ "mmc/revision", B_UINT16_TYPE, {ui16: revision}},
				{ "mmc/month", B_UINT8_TYPE, {ui8: month}},
				{ "mmc/year", B_UINT16_TYPE, {ui16: year}},
				{ kMmcRcaAttribute, B_UINT16_TYPE, {ui16: rca}},
				{ kMmcTypeAttribute, B_UINT8_TYPE, {ui8: cardType}},
				{}
			};

			// publish child device for the card
			gDeviceManager->register_node(bus->fNode, MMC_BUS_MODULE_NAME,
				attrs, NULL, NULL);
		}

		// FIXME we also need to unpublish devices that are gone. Probably need
		// to "ping" all RCAs somehow? Or is there an interrupt we can look for
		// to detect added/removed cards?
	}

	TRACE("poller thread terminating");
	return B_OK;
}