/*************************************************************************** * Copyright (c) 2024 Microsoft Corporation * Copyright (c) 2026-present Eclipse ThreadX contributors * * This program and the accompanying materials are made available under the * terms of the MIT License which is available at * https://opensource.org/licenses/MIT. * * SPDX-License-Identifier: MIT **************************************************************************/ /**************************************************************************/ /**************************************************************************/ /** */ /** USBX Component */ /** */ /** Storage Class */ /** */ /**************************************************************************/ /**************************************************************************/ /* Include necessary system files. */ #define UX_SOURCE_CODE #include "ux_api.h" #include "ux_host_class_storage.h" #include "ux_host_stack.h" #if !defined(UX_HOST_STANDALONE) /**************************************************************************/ /* */ /* FUNCTION RELEASE */ /* */ /* _ux_host_class_storage_thread_entry PORTABLE C */ /* 6.1.11 */ /* AUTHOR */ /* */ /* Chaoqiong Xiao, Microsoft Corporation */ /* */ /* DESCRIPTION */ /* */ /* This function is awaken every 2 seconds to check if there was a */ /* device insertion on a specific media. This is the only way we can */ /* remount a media after the storage instance has opened the media to */ /* UX_MEDIA (default FileX) and the media is either not present */ /* or was removed and is being re-inserted. */ /* */ /* It's for RTOS mode. */ /* */ /* INPUT */ /* */ /* class_address Class address */ /* */ /* OUTPUT */ /* */ /* None */ /* */ /* CALLS */ /* */ /* ux_media_close Close media */ /* _ux_host_class_storage_device_reset Reset device */ /* _ux_host_class_storage_media_mount Mount the media */ /* _ux_host_class_storage_unit_ready_test */ /* Test for unit ready */ /* _ux_host_class_storage_media_characteristics_get */ /* Get media characteristics */ /* _ux_host_class_storage_media_format_capacity_get */ /* Get media format capacity */ /* _ux_utility_memory_free Free memory block */ /* _ux_host_semaphore_get Get a semaphore */ /* _ux_host_semaphore_put Put a semaphore */ /* _ux_utility_delay_ms Thread sleep */ /* */ /* CALLED BY */ /* */ /* ThreadX */ /* */ /**************************************************************************/ VOID _ux_host_class_storage_thread_entry(ULONG class_address) { UX_HOST_CLASS *class_inst; UX_HOST_CLASS_STORAGE *storage; UINT status; ULONG lun_index; UX_HOST_CLASS_STORAGE_MEDIA *storage_media; UINT media_index; #if !defined(UX_HOST_CLASS_STORAGE_NO_FILEX) UX_MEDIA *media; UCHAR *memory; #endif /* Setup pointer to class. */ UX_THREAD_EXTENSION_PTR_GET(class_inst, UX_HOST_CLASS, class_address) /* This thread goes on forever once started. */ while(1) { /* We need to wake every 2 seconds or so. */ _ux_utility_delay_ms(UX_HOST_CLASS_STORAGE_THREAD_SLEEP_TIME); /* We need to parse all the storage instances and check for a removable media flag. */ storage = (UX_HOST_CLASS_STORAGE *) class_inst -> ux_host_class_first_instance; while (storage != UX_NULL) { /* Check if the instance is live and the device is removable. */ if ((storage -> ux_host_class_storage_state == UX_HOST_CLASS_INSTANCE_LIVE)) { /* We need to ensure nobody is accessing this storage instance. We use the storage class instance semaphore to protect. */ status = _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); if (status != UX_SUCCESS) break; /* Each LUN must be parsed and mounted. */ for (lun_index = 0; lun_index <= storage -> ux_host_class_storage_max_lun; lun_index++) { if (storage -> ux_host_class_storage_lun_removable_media_flags[lun_index] != UX_HOST_CLASS_STORAGE_MEDIA_REMOVABLE) continue; /* Check the type of LUN, we only deal with the ones we know how to mount. */ if ((storage -> ux_host_class_storage_lun_types[lun_index] == UX_HOST_CLASS_STORAGE_MEDIA_FAT_DISK) || (storage -> ux_host_class_storage_lun_types[lun_index] == UX_HOST_CLASS_STORAGE_MEDIA_OPTICAL_DISK) || (storage -> ux_host_class_storage_lun_types[lun_index] == UX_HOST_CLASS_STORAGE_MEDIA_IOMEGA_CLICK)) { /* Set the LUN into the storage instance. */ storage -> ux_host_class_storage_lun = lun_index; /* Check if the device is now ready. */ status = _ux_host_class_storage_unit_ready_test(storage); /* If we have an transport failure here, we are in trouble! The storage device is in an unstable state and should be reset completely. */ if (status != UX_SUCCESS) { /* Reset device. */ _ux_host_class_storage_device_reset(storage); break; } /* Process relative to device status. */ switch(storage -> ux_host_class_storage_sense_code >> 16) { case UX_HOST_CLASS_STORAGE_SENSE_KEY_NOT_READY: /* We may need to unmount this partition if it was mounted before. To do so, we need to parse the existing media instance and find out if this partition was already mounted. */ storage_media = (UX_HOST_CLASS_STORAGE_MEDIA *) class_inst -> ux_host_class_media; /* Scan all instances of media. */ for (media_index = 0; media_index < UX_HOST_CLASS_STORAGE_MAX_MEDIA; storage_media++, media_index++) { #if !defined(UX_HOST_CLASS_STORAGE_NO_FILEX) /* Get the UX_MEDIA (default FileX) Media attached to this media. */ media = &storage_media -> ux_host_class_storage_media; /* Check for the storage instance and lun number. */ if ((ux_media_id_get(media) != 0) && (ux_media_driver_info_get(media) == (VOID *) storage) && (storage_media -> ux_host_class_storage_media_lun == storage -> ux_host_class_storage_lun)) { /* We preserve the memory used by this media. */ memory = storage_media -> ux_host_class_storage_media_memory; /* Let UX_MEDIA (default FileX) use this instance. */ _ux_host_semaphore_put(&storage -> ux_host_class_storage_semaphore); /* Ask UX_MEDIA (default FileX) to unmount the partition. */ ux_media_close(media); /* This device is now unmounted. */ storage_media -> ux_host_class_storage_media_status = UX_HOST_CLASS_STORAGE_MEDIA_UNMOUNTED; /* Reset the media ID. */ ux_media_id_set(media, 0); /* Now, we protect the storage instance. */ status = _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); if (status != UX_SUCCESS) break; /* Free the memory block used for data transfer on behalf of UX_MEDIA (default FileX). */ _ux_utility_memory_free(memory); } #else /* Check storage instance and lun number. */ if (storage_media -> ux_host_class_storage_media_status != UX_USED) continue; if (storage_media -> ux_host_class_storage_media_storage != storage) continue; if (storage_media -> ux_host_class_storage_media_lun != storage -> ux_host_class_storage_lun) continue; /* Release the instance. */ status = _ux_host_semaphore_put_rc(&storage -> ux_host_class_storage_semaphore); /* Free the storage media. */ storage_media -> ux_host_class_storage_media_status = UX_UNUSED; /* Invoke callback for media removal. */ if (_ux_system_host -> ux_system_host_change_function != UX_NULL) { /* Call system change function. */ _ux_system_host -> ux_system_host_change_function(UX_STORAGE_MEDIA_REMOVAL, storage -> ux_host_class_storage_class, (VOID *) storage_media); } /* Now, we protect the storage instance. */ status = _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); if (status != UX_SUCCESS) break; #endif } break; case UX_HOST_CLASS_STORAGE_SENSE_KEY_UNIT_ATTENTION: /* We may need to unmount this partition if it was mounted before. To do so, we need to parse the existing media instance and find out if this partition was already mounted. */ storage_media = (UX_HOST_CLASS_STORAGE_MEDIA *) class_inst -> ux_host_class_media; /* Scan all instances of media. */ for (media_index = 0; media_index < UX_HOST_CLASS_STORAGE_MAX_MEDIA; storage_media++, media_index++) { #if !defined(UX_HOST_CLASS_STORAGE_NO_FILEX) /* Get the UX_MEDIA (default FileX) Media attached to this media. */ media = &storage_media -> ux_host_class_storage_media; /* Check for the storage instance and lun number. */ if ((ux_media_id_get(media) != 0) && (ux_media_driver_info_get(media) == (VOID *) storage) && (storage_media -> ux_host_class_storage_media_lun == storage -> ux_host_class_storage_lun)) { /* We preserve the memory used by this media. */ memory = storage_media -> ux_host_class_storage_media_memory; /* Let UX_MEDIA (default FileX) use this instance. */ _ux_host_semaphore_put(&storage -> ux_host_class_storage_semaphore); /* Ask UX_MEDIA (default FileX) to unmount the partition. */ ux_media_close(media); /* This device is now unmounted. */ storage_media -> ux_host_class_storage_media_status = UX_HOST_CLASS_STORAGE_MEDIA_UNMOUNTED; /* Reset the media ID. */ ux_media_id_set(media, 0); /* Now, we protect the storage instance. */ status = _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); if (status != UX_SUCCESS) break; /* Free the memory block used for data transfer on behalf of FileX. */ _ux_utility_memory_free(memory); } #else /* Check storage instance and lun number. */ if (storage_media -> ux_host_class_storage_media_status != UX_USED) continue; if (storage_media -> ux_host_class_storage_media_storage != storage) continue; if (storage_media -> ux_host_class_storage_media_lun != storage -> ux_host_class_storage_lun) continue; /* Release the instance. */ status = _ux_host_semaphore_put_rc(&storage -> ux_host_class_storage_semaphore); /* Free the storage media. */ storage_media -> ux_host_class_storage_media_status = UX_UNUSED; /* Invoke callback for media removal. */ if (_ux_system_host -> ux_system_host_change_function != UX_NULL) { /* Call system change function. */ _ux_system_host -> ux_system_host_change_function(UX_STORAGE_MEDIA_REMOVAL, storage -> ux_host_class_storage_class, (VOID *) storage_media); } /* Now, we protect the storage instance. */ status = _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); if (status != UX_SUCCESS) break; #endif } /* Now, we need to retest the media to see if it is there. */ status = _ux_host_class_storage_unit_ready_test(storage); /* If we have an transport failure here, we are in trouble! The storage device is in an unstable state and should be reset completely. */ if (status != UX_SUCCESS) { /* Reset device. */ _ux_host_class_storage_device_reset(storage); break; } if (storage -> ux_host_class_storage_sense_code == 0) { /* Get the media type supported by this storage device. */ status = _ux_host_class_storage_media_characteristics_get(storage); if (status != UX_SUCCESS) break; /* Get the format capacity of this storage device. */ status = _ux_host_class_storage_media_format_capacity_get(storage); if (status != UX_SUCCESS) break; /* Let UX_MEDIA (default FileX) use this instance. */ _ux_host_semaphore_put(&storage -> ux_host_class_storage_semaphore); #if !defined(UX_HOST_CLASS_STORAGE_NO_FILEX) /* The device seems to have been inserted, try to mount it. */ _ux_host_class_storage_media_mount(storage, 0); #else /* Find a free media slot for inserted media. */ storage_media = (UX_HOST_CLASS_STORAGE_MEDIA *) class_inst -> ux_host_class_media; for (media_index = 0; media_index < UX_HOST_CLASS_STORAGE_MAX_MEDIA; storage_media ++, media_index ++) { /* Skip used storage media slots. */ if (storage_media -> ux_host_class_storage_media_status == UX_USED) continue; /* Use this free storage media slot. */ storage_media -> ux_host_class_storage_media_status = UX_USED; storage_media -> ux_host_class_storage_media_storage = storage; /* Save media information. */ storage_media -> ux_host_class_storage_media_lun = (UCHAR)storage -> ux_host_class_storage_lun; storage_media -> ux_host_class_storage_media_sector_size = (USHORT)storage -> ux_host_class_storage_sector_size; storage_media -> ux_host_class_storage_media_number_sectors = storage -> ux_host_class_storage_last_sector_number + 1; /* Invoke callback for media insertion. */ if (_ux_system_host -> ux_system_host_change_function != UX_NULL) { /* Call system change function. */ _ux_system_host -> ux_system_host_change_function(UX_STORAGE_MEDIA_INSERTION, storage -> ux_host_class_storage_class, (VOID *) storage_media); } } #endif /* Now, we protect the storage instance. */ _ux_host_semaphore_get(&storage -> ux_host_class_storage_semaphore, UX_WAIT_FOREVER); } break; default: break; } } } /* Other threads are now allowed to access this storage instance. */ _ux_host_semaphore_put(&storage -> ux_host_class_storage_semaphore); } /* Move to the next entry in the storage instances link. */ storage = storage -> ux_host_class_storage_next_instance; } } } #endif