rt-thread-official/bsp/stm32f10x-HAL

STM32F10x-HAL 板级支持包

1. 简介

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

硬件	描述
芯片型号	STM32F10x全系列
CPU	Cortex-M3
主频	48MHz-72MHz

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/stm32f10x-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-stm32.elf
    arm-none-eabi-objcopy -O binary rtthread-stm32.elf rtthread.bin
    arm-none-eabi-size rtthread-stm32.elf
    text    data     bss     dec     hex filename
    46356     424    1520   48300    bcac rtthread-stm32.elf
    scons: done building targets.

如果编译正确无误，会产生rtthread-stm32.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/3
GPIO	支持	自动根据芯片型号选择引脚布局
SPI	支持	SPI1/2
USB Device	支持	OTGFS,暂不支持OTGHS
SDIO	支持	作为块设备，不支持SDIO框架

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

IO号	板级包中的定义
PA9	USART1 TX
PA10	USART1 RX
PA2	USART2 TX
PA3	USART2 RX
PB10	USART3 TX
PB11	USART3 RX
PA5	SPI1 SCK
PA6	SPI1 MISO
PA7	SPI1 MOSI
PB13	SPI2 SCK
PB14	SPI2 MISO
PB15	SPI2 MOSI

5. menuconfig Bsp菜单详解

选项	解释
Device type	选择芯片型号，修改此处需修改MDK/IAR工程为相同芯片型号
Using HSI as clock source	不使用外部时钟源，该选项目前不能开启
HSE Value	外部时钟源的频率，单位(HZ)
Using UART1	开启串口1，串口1的设备名为"uart1"
Using UART2	开启串口2，串口1的设备名为"uart2"
Using UART3	开启串口3，串口1的设备名为"uart3"
Using SPI1	开启SPI1，设备名为"spi1"
Using SPI2	开启SPI2，设备名为"spi2"
Using sdcard with sdio	开启SD卡
SDCARD Rx Using Dma Mode	SD卡使用DMA接收
SDCARD Tx Using Dma Mode	SD卡使用DMA发送

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

6. 联系人信息

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