blob: 809a9cd7482a2ab5fc50d278cb2211ee2ae0ef12 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
# 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) 下载源码
```bash
git clone https://github.com/RT-Thread/rt-thread.git
```
2) 配置工程并准备env
（Linux/Mac）
```bash
cd rt-thread/bsp/stm32f10x-HAL
scons --menuconfig
source ~/.env/env.sh
pkgs --upgrade
```
（Windows）
>在[RT-Thread官网][1]下载ENV工具包
3) 配置芯片型号
（Linux/Mac）
```bash
scons --menuconfig
```
（Windows(ENV环境中)）
```bash
menuconfig
```
在menuconfig页面配置并选择对应的芯片型号，若开发环境为MDK/IAR，则需要生成工程
4) 生成工程(Mac/Linux下请跳过此步骤)
（Windows IAR）
```bash
SET RTT_CC=iar
scons --target=iar -s
```
（Windows MDK5）*
```bash
scons --target=mdk5 -s
```
*该板级支持包不支持生成mdk4的工程
**MDK 与 IAR 在生成完成工程之后一定要在工程中手动选择一次芯片信号，否则会产生严重编译错误**
5) 编译
使用MDK或IAR请参见对应教程
（Windows arm-none-eabi-gcc）
使用以下指令设置gcc路径
```bash
SET RTT_EXEC_PATH=[GCC路径]
```
（Linux/Mac arm-none-eabi-gcc）
使用以下指令设置gcc路径
```bash
export RTT_EXEC_PATH=[GCC路径]
```
编译（WindowsLinux/Mac arm-none-eabi-gcc）
```bash
scons -j4
```
出现下列信息即为编译成功
```bash
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信息：
```bash
\ | /
- 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][4] < [[email protected]][5] >
[1]: https://www.rt-thread.org/page/download.html
[4]: https://github.com/uestczyh222
[5]: mailto:[email protected]
|
