mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-09-15 17:42:53 +00:00
8a11f91252
This is a USB controller driver for STM32F4xx devices using the STM32 Cube HAL_PCD framework. This has been tested with the cdc_acm driver on a 96b_carbon board (STM32F401RE). This is a refactoring of: usb: usb_dc_stm: Add support for STM32Cube HAL_PCD USB driver Signed-off-by: Christer Weinigel <christer@weinigel.se> [daniel.thompson@linaro.org: Removed STM32F40(157) defconfig changes together with STM32F4Discovery pinmux and defconfig changes, updated clock settings and pad configuration to match latest mainline] Signed-off-by: Daniel Thompson <daniel.thompson@linaro.org> [giannis.damigos@gmail.com: Change uint*_t types to u*_t types, change SYS_LOG_USB_DC_STM_LEVEL to SYS_LOG_USB_DRIVER_LEVEL and update pinmux to match latest arm branch] Signed-off-by: Yannis Damigos <giannis.damigos@gmail.com> Signed-off-by: Loic Poulain <loic.poulain@linaro.org> |
||
|---|---|---|
| .. | ||
| stm32f1xx | ||
| stm32f3xx | ||
| stm32f4xx | ||
| stm32f7xx | ||
| stm32l4xx | ||
| Kbuild | ||
| Kconfig | ||
| Makefile | ||
| README | ||
How to introduce a new version of stm32cube:
============================================
Original STM32Cube tree structure has been modified to a minimum
structure for a better fit into Zephyr.
STM32Cube is divided into drivers and soc section, with:
drivers/
include/ contains Cube HAL/LL files from:
STM32Cube_FW_F1_VX.X.X/Drivers/STM32YYxx_HAL_Driver/Inc/*
src/ contains:
STM32Cube_FW_F1_VX.X.X/Drivers/STM32YYxx_HAL_Driver/Src/*
soc/ contains STM32 CMSIS files from
*STM32Cube_FW_F1_VX.X.X/Drivers/CMSIS/Device/ST/STM32F1xx/Include/*
*STM32Cube_FW_F1_VX.X.X/Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/system_stm32f1xx.c
One file needs to be renamed:
driver/include/stm32f1xx_hal_conf_template.h
into:
driver/include/stm32f1xx_hal_conf.h
IMPORTANT:
----------
STM32Cube, as an external library, is not supposed to be modifid.
In practice, it might be required to patch it
When updating a STM32Cube package to a new version, please have a look
to the patch list in dedicated README file, to make sure you don't overwrite
some earlier modifications of the package.
In case of doubt, contact Zephyr code owner for stm32cube.
How to use STM32Cube:
=====================
In order to enjoy ST CMSIS definitions:
*CONFIG_HAS_STM32CUBE should be defined
*stm32yyxx.h should be included in soc.h
**E.g.: #include <stm32f1xx.h>
In order to use STM32Cube HAL, these files should be compiled:
In /ext/hal/st/stm32cube/Kbuild :
obj-y += stm32yyxx/drivers/src/stm32yyxx_hal.o
obj-y += stm32yyxx/drivers/src/stm32yyxx_hal_rcc.o
obj-y += stm32yyxx/soc/system_stm32yyxx.o
Plus add HAL driver file (when needed):
obj-$(CONFIG_SERIAL_HAS_DRIVER) += stm32yyxx/drivers/src/stm32yyxx_hal_uart.o
Additionally, in order to use STM32Cube LL (when needed):
*include stm32yyxx_ll_usart.h in soc.h
**E.g.: #include <stm32f1xx_ll_usart.h>