rt-thread/bsp/stm32f4xx-HAL

STM32F4xx-HAL 板级支持包

1. 简介

STM32F4 是由意法半导体推出的Cortex-M4内核的高性能单片机 包括如下硬件特性：

| 硬件 | 描述 | | -- | -- | |芯片型号| STM32F4全系列 | |CPU| Cortex-M4 | |主频| 84MHz-208MHz |

2. 编译说明

环境	说明
PC操作系统	Linux/MacOS/Windows
编译器	arm-none-eabi-gcc version 6.3.1 20170620 (release)/armcc/iar
构建工具	scons/mdk5/iar
依赖软件环境	Env工具/(MDK或IAR或arm-none-eabi-gcc)/git/调试器驱动

1) 下载源码

    git clone https://github.com/RT-Thread/rt-thread.git

2) 配置工程并准备env

（Linux/Mac）

    cd rt-thread/bsp/stm32f4xx-HAL
    scons --menuconfig
    source ~/.env/env.sh
    pkgs --upgrade

（Windows）

在RT-Thread官网下载ENV工具包

3) 配置芯片型号

（Linux/Mac）

    scons --menuconfig

（Windows(ENV环境中)）

    menuconfig

在menuconfig页面配置并选择对应的芯片型号，若开发环境为MDK/IAR，则需要生成工程

4) 生成工程(Mac/Linux下请跳过此步骤)

（Windows IAR）

    SET RTT_CC=iar
    scons --target=iar -s

（Windows MDK5）*

    scons --target=mdk5 -s

*该板级支持包不支持生成mdk4的工程

MDK 与 IAR 在生成完成工程之后一定要在工程中手动选择一次芯片信号，否则会产生严重编译错误

5) 编译

使用MDK或IAR请参见对应教程

（Windows arm-none-eabi-gcc） 使用以下指令设置gcc路径

    SET RTT_EXEC_PATH=[GCC路径]

（Linux/Mac arm-none-eabi-gcc） 使用以下指令设置gcc路径

    export RTT_EXEC_PATH=[GCC路径]

编译（WindowsLinux/Mac arm-none-eabi-gcc）

    scons -j4

出现下列信息即为编译成功

    LINK rtthread-stm32f4xx.elf
    arm-none-eabi-objcopy -O binary rtthread-stm32f4xx.elf rtthread.bin
    arm-none-eabi-size rtthread-stm32f4xx.elf
    text    data     bss     dec     hex filename
    41596     356    1456   43408    a990 rtthread-stm32f4xx.elf
    scons: done building targets.

如果编译正确无误，会产生rtthread-stm23f4xx.elf、rtthread.bin文件。其中rtthread.bin为二进制固件

3. 烧写及执行

烧写可以使用仿真器 ISP等多种方式 此处不再赘述

3.1 运行结果

如果编译 & 烧写无误，会在串口2*上看到RT-Thread的启动logo信息：

 \ | /
- RT -     Thread Operating System
 / | \     3.0.4 build May 15 2018
 2006 - 2018 Copyright by rt-thread team
msh />

*默认串口

4. 驱动支持情况及计划

驱动	支持情况	备注
UART	支持	UART1/2/6
GPIO	支持	自动根据芯片型号选择引脚布局
SPI	支持	SPI1/2/3
SPI Flash	支持	W25QXX
USB Device	支持	OTGFS,暂不支持OTGHS
USB Host	支持	OTGFS,暂不支持OTGHS
IWG	支持	/
I2c	支持	软件I2C
RTC	支持	RTC时钟自动配置

4.1 IO在板级支持包中的映射情况

| IO号 | 板级包中的定义 | | -- | -- | | PB6 | I2C SCL | | PB7 | I2C SDA | | PA9 | USART1 TX | | PA10 | USART1 RX | | PA2 | USART2 TX | | PA3 | USART2 RX | | PC6 | USART6 TX | | PC7 | USART6 RX | | PA5 | SPI1 SCK | | PA6 | SPI1 MISO | | PA7 | SPI1 MOSI | | PB13 |SPI2 SCK | | PB14 |SPI2 MISO | | PB15 |SPI2 MOSI | | PC10 |SPI3 SCK | | PC11 |SPI3 MISO | | PC12 |SPI3 MOSI |

5. menuconfig Bsp菜单详解

| 选项 | 解释 | | -- | -- | | Device type | 选择芯片型号，修改此处需修改MDK/IAR工程为相同芯片型号 | | Using HSI as clock source | 不使用外部时钟源，该选项目前不能开启 | | HSE Value | 外部时钟源的频率，单位(HZ) | | System Clock Value | 系统时钟频率，该值会自动计算时钟树，某些特定频率下无法通过PLLQ产生48M时钟，可能导致USB SDIO等设备时钟异常，可使用STM32 Cube MX工具配置需要的时钟树替换board.c中的时钟初始化部分 | | Using UART1 | 开启串口1，串口1的设备名为"uart1" | | Using UART2 | 开启串口2，串口1的设备名为"uart2" | | Using UART6 | 开启串口6，串口1的设备名为"uart6" | | Using SPI1 | 开启SPI1，设备名为"spi1" | | Using SPI2 | 开启SPI2，设备名为"spi2" | | Using SPI3 | 开启SPI3，设备名为"spi3" | | W25QXX CS Pin index | SPI flash 的片选，接入单片机的引脚号 | | W25QXX Spi bus name | SPI flash 所使用的总线设备名称 | | USB Host Config | USB主机模式的配置菜单 | | using a gpio control usb power | 根据具体硬件，选择是否使用一个GPIO来控制USB主机的电源开启 | | power control pin | 控制USB主机的电源控制引脚号 | | current check pin | USB主机的电流过载检测引脚号 | | using vbus check pin | 选择是否开启USB VBUS检测 |

*部分选项需要在RT-Thread组件菜单中开启对应的设备框架才能显示。

6. 联系人信息

维护人: uestczyh222 < lymz@foxmail.com >