/* * Copyright (c) 2023, Leon Albrecht * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include #include namespace Kernel::USB { using namespace MassStorage; USB_DEVICE_DRIVER(MassStorageDriver); void MassStorageDriver::init() { auto driver = MUST(adopt_nonnull_lock_ref_or_enomem(new MassStorageDriver())); USBManagement::register_driver(driver); } ErrorOr MassStorageDriver::checkout_interface(USB::Device& device, USBInterface const& interface) { auto const& descriptor = interface.descriptor(); if (descriptor.interface_class_code != USB_CLASS_MASS_STORAGE) return ENOTSUP; dmesgln("USB MassStorage Interface for device {}:{} found:", device.device_descriptor().vendor_id, device.device_descriptor().product_id); dmesgln(" Subclass: {} [{:#02x}]", MassStorage::subclass_string((SubclassCode)descriptor.interface_sub_class_code), descriptor.interface_sub_class_code); dmesgln(" Protocol: {} [{:#02x}]", MassStorage::transport_protocol_string((TransportProtocol)descriptor.interface_protocol), descriptor.interface_protocol); // FIXME: Find a nice way of handling multiple device subclasses and protocols if (descriptor.interface_protocol == to_underlying(TransportProtocol::BBB)) return initialise_bulk_only_device(device, interface); return ENOTSUP; } ErrorOr MassStorageDriver::probe(USB::Device& device) { // USB massbulk Table 4.1: if (device.device_descriptor().device_class != USB_CLASS_DEVICE || device.device_descriptor().device_sub_class != 0x00 || device.device_descriptor().device_protocol != 0x00) return ENOTSUP; for (auto const& config : device.configurations()) { // FIXME: There might be multiple MassStorage configs present, // figure out how to decide which one to take, // although that's very unlikely bool has_accepted_an_interface = false; for (auto const& interface : config.interfaces()) { // FIXME: Handle multiple interfaces // Interface may coexist at the same time, // but having multiple handles on the same data storage seems like a bad idea, // so: // FIXME: Choose the best supported interface // UAS for example is supposed to be better than BBB, but BBB will always // be the first listed interface of them, when both are supported auto result = checkout_interface(device, interface); if (result.is_error()) continue; has_accepted_an_interface = true; } if (has_accepted_an_interface) return {}; } return ENOTSUP; } ErrorOr MassStorageDriver::initialise_bulk_only_device(USB::Device& device, USBInterface const& interface) { auto const& descriptor = interface.descriptor(); auto const& configuration = interface.configuration(); if (descriptor.interface_sub_class_code != to_underlying(MassStorage::SubclassCode::SCSI_transparent)) return ENOTSUP; TRY(device.control_transfer( USB_REQUEST_RECIPIENT_DEVICE | USB_REQUEST_TYPE_STANDARD | USB_REQUEST_TRANSFER_DIRECTION_HOST_TO_DEVICE, USB_REQUEST_SET_CONFIGURATION, configuration.configuration_id(), 0, 0, nullptr)); u8 max_luns; TRY(device.control_transfer( USB_REQUEST_TYPE_CLASS | USB_REQUEST_RECIPIENT_INTERFACE | USB_REQUEST_TRANSFER_DIRECTION_DEVICE_TO_HOST, to_underlying(MassStorage::RequestCodes::GetMaxLun), 0, interface.descriptor().interface_id, 1, &max_luns)); // FIXME: Devices that do not support multiple LUNs may STALL this command // FIXME: Support multiple LUNs if (max_luns != 0) dmesgln("SCSI/BBB: WARNING: USB Mass Storage Device supports multiple LUNs ({}) only targetting first LUN", max_luns); u8 in_pipe_address = 0xff; u8 in_max_packet_size; u8 out_pipe_address = 0xff; u8 out_max_packet_size; if (interface.descriptor().number_of_endpoints < 2) { dmesgln("SCSI/BBB: Interface does not provide enough endpoints for advertised Bulk-only transfer protocol; Rejecting"); return ENOTSUP; } for (auto const& endpoint : interface.endpoints()) { if (endpoint.endpoint_attributes_bitmap != USBEndpoint::ENDPOINT_ATTRIBUTES_TRANSFER_TYPE_BULK) continue; // The upper bit of the Endpoint address is set to 1, iff it is the Bulk-In Endpoint if (endpoint.endpoint_address & 0x80) { in_pipe_address = endpoint.endpoint_address & 0b1111; in_max_packet_size = endpoint.max_packet_size; } else { out_pipe_address = endpoint.endpoint_address & 0b1111; out_max_packet_size = endpoint.max_packet_size; } } if (in_pipe_address == 0xff || out_pipe_address == 0xff) { dmesgln("SCSI/BBB: Interface did not advertise two Bulk Endpoints; Rejecting"); return ENOTSUP; } auto in_pipe = TRY(BulkInPipe::create(device.controller(), in_pipe_address, in_max_packet_size, device.address())); auto out_pipe = TRY(BulkOutPipe::create(device.controller(), out_pipe_address, out_max_packet_size, device.address())); CommandBlockWrapper command_block {}; command_block.set_command(SCSI::ReadCapacity10 {}); command_block.transfer_length = sizeof(SCSI::ReadCapacity10Parameters); command_block.direction = CBWDirection::DataIn; TRY(out_pipe->submit_bulk_out_transfer(31, &command_block)); SCSI::ReadCapacity10Parameters capacity; TRY(in_pipe->submit_bulk_in_transfer(sizeof(capacity), &capacity)); // FIXME: Handle Stalling CommandStatusWrapper status; TRY(in_pipe->submit_bulk_in_transfer(sizeof(status), &status)); if (status.status != CSWStatus::Passed) { dmesgln("SCSI/BBB: Failed to query USB Drive capacity; Rejecting"); return ENOTSUP; } dmesgln(" Block Size: {}B", capacity.block_size); dmesgln(" Block Count: {}", capacity.block_count); dmesgln(" Total Size: {}MiB", (u64)capacity.block_size * capacity.block_count / MiB); StorageDevice::LUNAddress lun = { device.controller().storage_controller_id(), device.address(), // FIXME: Again, support multiple LUNs per device 0 }; auto bulk_scsi_interface = TRY(DeviceManagement::try_create_device( lun, device.address(), // FIXME: Figure out a better ID to put here capacity.block_size, capacity.block_count, device, move(in_pipe), move(out_pipe))); m_interfaces.append(bulk_scsi_interface); StorageManagement::the().add_device(bulk_scsi_interface); return {}; } void MassStorageDriver::detach(USB::Device& device) { auto&& interface = AK::find_if(m_interfaces.begin(), m_interfaces.end(), [&device](auto& interface) { return &interface.device() == &device; }); StorageManagement::the().remove_device(*interface); m_interfaces.remove(*interface); } }