I am on an H573 and trying to rd/wr a file on a fat32-formatted USB memory stick using the mass storage controller.
To jump right into the problem (details further below), I am trying to understand what to do about this block when I am running in standalone mode. This snip comes from the example code which is in RTOS mode. I want standalone mode.
--Background--
As a starting point, I grabbed the Ux_MSC_Host example, and got that working with no difficulties on the H573 dev kit MB1677. That demo uses FileX, UsbX, ThreadX, and some power delivery peripherals.
Then I started some changes:
- I now have hardware that does not have power delivery. There is a 5v rail turned on and powering the memory stick.
- For various reasons I do not want ThreadX enabled; so:
- I setup FileX and UsbX, and added some short snips in main.c, to finish initialization and loop on _ux_host_stack_tasks_run.
- With this, I am able to enumerate and get into the ux_host_event_callback.
But...
When I tried to implement something meaningful in UX_DEVICE_INSERTION status, it turns out that the expression
media = &storage_media->ux_host_class_storage_media;
fails to compile because the type "FX_MEDIA" is undefined. I need FX_MEDIA so I can use functions like fx_file_open or fx_file_read.
Apart from the undefined type, the field itself is if-def'ed away within ux_host_class_storage.h:
typedef struct UX_HOST_CLASS_STORAGE_MEDIA_STRUCT
{
#if !defined(UX_HOST_CLASS_STORAGE_NO_FILEX)
UX_MEDIA ux_host_class_storage_media;
ULONG ux_host_class_storage_media_partition_start;
VOID *ux_host_class_storage_media_memory;
ULONG ux_host_class_storage_media_status;
ULONG ux_host_class_storage_media_lun;
ULONG ux_host_class_storage_media_sector_size;
#else
struct UX_HOST_CLASS_STORAGE_STRUCT
*ux_host_class_storage_media_storage;
ULONG ux_host_class_storage_media_number_sectors;
USHORT ux_host_class_storage_media_sector_size;
UCHAR ux_host_class_storage_media_lun;
UCHAR ux_host_class_storage_media_status;
#endif
} UX_HOST_CLASS_STORAGE_MEDIA;
and the #defines are set earlier:
#if defined(UX_HOST_STANDALONE) && !defined(UX_HOST_CLASS_STORAGE_NO_FILEX)
#define UX_HOST_CLASS_STORAGE_NO_FILEX
#endif
I thought maybe I could tweak this vendor file (slightly queasy about that). But that's when I found statements like this littered throughout the library:
I want FileX (and picked it in Cube), so this #define is confusing. I guess the question is: what is the proper configuration of #defines to bring all these pieces together properly? Or is standalone host msc not a supported feature? Are there lib tweaks I can make that will fake it?
I have found these informative - but they vary:
- (for device, not host) https://community.st.com/t5/stm32-mcus-embedded-software/usbx-device-msc-in-standalone-mode/m-p/721071#M51412
- (FileX without ThreadX) https://github.com/STMicroelectronics/x-cube-azrtos-f4/tree/main/Projects/STM32F429ZI-Nucleo/Applications/FileX/Fx_SRAM_File_Edit_Standalone
- (again, device not host) https://community.st.com/t5/stm32-mcus/how-to-implement-usbx-in-standalone-mode/ta-p/614435
Lastly, I attached the ioc and a pdf with recap/screenshots of what I changed.
Yes, I did get that working.
host library (unmodified)
https://github.com/STMicroelectronics/stm32_mw_usb_host/blob/master/
fatfs library (unmodified)
https://github.com/STMicroelectronics/stm32_mw_fatfs/blob/master/
stm32mxcube init
for an STM32U5(95)...
stm32mxcube - Connectivity -> USB_OTG_HS:
GPIO: D+/- to PA12/PA11
MODE: Internal HS PHY, Host only
Host Channels: 16
Speed: High 480
IP DMA: Disabled
Physical: Internal HS PHY
VBUS: Disabled
Signal SoF: Disabled
Ref Clock: 32Mhz
stm32mxcube - NVIC:
USB OTG HS Global Interrupt enabled, prio 5, sub prio 0
stm32mxcube - CLOCK:
I have a 16Mhz external HSE
PLL1Source Mux: HSE = 16
PLL1M: div/1 = 16
PLL1m*n: mult*10 = 160
PLL1M/p: div/5 = 32
This results in PLL1P being 32Mhz
Selected OTG-HS-Clock-Mux as PLL1P
Thus USB kernel clocked at 32Mhz, to match the ref clock selected in the periph aboveThen I went looking for some example code on how to stitch these together.
- Using the Cube example selector for an stm32U5, there wasn't an example for MSC that didn't use Ux (and thus ThreadX)
- However... if I looked for examples targetting stm32F4, there are a bunch of MSC_Standalone examples.
Specifically, in the example filters, I picked...
MCU/MPU: stm32f
Middleware: USB_Host (NOT the USBXHOST)I extracted a number of these examples and did a diff to see how they varied.
I ended up swiping (and modifying):
usbh_conf.c
- this has some extern linkage to a specific HCD_HandleTypeDef - updated to link
- USBH_LL_Init and USBH_LL_SetTimer also needed extern name updates
- USBH_LL_Init was updated to match the register names, ex: "HCD_PHY_EMBEDDED" (F4xx) changed to "USB_OTG_HS_EMBEDDED_PHY" (U5xx) - this wasn't exactly formulaic, it was looking through the headers to see what the updated variable names are for my different chip.
usb_host.c/h
- MX_USB_HOST_Init needed to init using the HOST_HS instead of HOST_FS (to match the U59x)
- stm32u5xx_hal_msp
(note the comment & c.f. that url if you want more details)
void HAL_MspInit(void)
{
/* USER CODE BEGIN MspInit 0 */
//from https://community.st.com/t5/stm32-mcus-products/stm32u5ax-usb-corereset-timeout/m-p/578564#M219799
//cube isn't enabling one of the clocks that usb needs
//without this enabled, then USB_CoreReset() times out.
__HAL_RCC_SYSCFG_CLK_ENABLE();
/* USER CODE END MspInit 0 */
__HAL_RCC_PWR_CLK_ENABLE();
/* System interrupt init*/
/* PendSV_IRQn interrupt configuration */
HAL_NVIC_SetPriority(PendSV_IRQn, 15, 0);
/* USER CODE BEGIN MspInit 1 */
/* USER CODE END MspInit 1 */
}
updated defines in usbh_conf.h
#define HOST_HS 1
#define HOST_FS 0
in usbh_diskio_config.h, usbh_diskio.c/h
- there was an "extern USBH_HandleTypeDef hUsbHostFS;" that didn't match the new cube-generated name
file_operations.c/h and explorer.c
- used as inspiration for how to iterate over files and so forth
the ISR was already set up by Cube
To summarize, the resulting structure, including the libs is this:
the first and last folders are where I touched anything; the two middle folders (fatfs & usbhost), are unmodified. The cube generated folder sits parallel to these four folders but I didn't include that here because it contains some proprietary folder names.
AppLogic is somewhat chip agnostic, I've tried it on three flavors of chips; whereas the Port folder (which contains some headers) is what has to be tweaked for each micro. -- i.e., if you're highspeed, fullspeed, the name of the typedef Cube made for you, and so forth.
