231 lines
9.0 KiB
Markdown
231 lines
9.0 KiB
Markdown
|
# 芯来科技蜂鸟FPGA评估板 #
|
|||
|
|
|
|||
|
|
## 简介
|
|||
|
|
|
|||
|
|
**蜂鸟FPGA评估板** 是由芯来科技公司推出的用于测试评估芯来RISC-V内核处理器的FPGA评估板。
|
|||
|
|
|
|||
|
|
更多关于 **蜂鸟FPGA评估板** 开发板的详细资料请参见 [蜂鸟FPGA评估板](https://nucleisys.com/developboard.php)
|
|||
|
|
|
|||
|
|
### 板载资源
|
|||
|
|
|
|||
|
|
| 硬件 | 描述 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 内核 | Nuclei RISC-V N/NX/UX 内核 |
|
|||
|
|
| 架构 | RV32 or RV64 |
|
|||
|
|
| 主频 | 8MHz or uncertain freq |
|
|||
|
|
|
|||
|
|
**注意**: 这个上面烧写的是FPGA bitstream文件，所以处理器内核版本根据型号来定，通过修改**rtconfig.py**中的**NUCLEI_SDK_CORE**.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 工具安装
|
|||
|
|
|
|||
|
|
### 安装工具链
|
|||
|
|
|
|||
|
|
请根据[安装Nuclei RISC-V GCC Toolchain和OpenOCD](https://doc.nucleisys.com/nuclei_sdk/quickstart.html#setup-tools-and-environment) 来安装依赖的工具。
|
|||
|
|
|
|||
|
|
### 添加环境变量
|
|||
|
|
|
|||
|
|
将Nuclei RISC-V GCC Toolchain和OpenOCD的环境变量进行设置。
|
|||
|
|
|
|||
|
|
#### Windows
|
|||
|
|
|
|||
|
|
假设工具安装在 **D:\Software\Nuclei**目录下, 则可以修改系统环境变量**PATH**,
|
|||
|
|
将**D:\Software\Nuclei\gcc\bin;D:\Software\Nuclei\openocd\bin;**增加到**PATH**中。
|
|||
|
|
|
|||
|
|
或者在ENV工具命令行中运行
|
|||
|
|
|
|||
|
|
~~~cmd
|
|||
|
|
set PATH=D:\Software\Nuclei\gcc\bin;D:\Software\Nuclei\openocd\bin;%PATH%
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
#### Linux
|
|||
|
|
|
|||
|
|
假设工具安装在 **~/Software/Nuclei**目录下, 通过在Linux的``.bashrc``增加如下一行代码
|
|||
|
|
来添加环境变量。
|
|||
|
|
|
|||
|
|
~~~bash
|
|||
|
|
export PATH=~/Software/Nuclei/gcc/bin:~/Software/Nuclei/openocd/bin:$PATH
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
或者在ENV工具命令行中运行
|
|||
|
|
|
|||
|
|
~~~bash
|
|||
|
|
export PATH=~/Software/Nuclei/gcc/bin:~/Software/Nuclei/openocd/bin:$PATH
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
**注意**: 对应的RISC-V GCC和OPENOCD的路径请替换成自己安装的路径。
|
|||
|
|
|
|||
|
|
## 烧写及执行
|
|||
|
|
|
|||
|
|
### [驱动设置](https://nucleisys.com/developboard.php)
|
|||
|
|
|
|||
|
|
### 编译程序
|
|||
|
|
|
|||
|
|
下载好[RT-Thread](https://github.com/RT-Thread/rt-thread)的代码和[ENV工具](https://www.rt-thread.org/document/site/tutorial/env-video/)以后。
|
|||
|
|
|
|||
|
|
按照ENV工具的教程, 在**rt-thread\bsp\nuclei\hbird_eval**目录打开ENV工具命令行。
|
|||
|
|
|
|||
|
|
**注意**: 请确保Nuclei GCC和Nuclei OpenOCD的路径设置正确无误。
|
|||
|
|
|
|||
|
|
1. 运行 ``pkgs --update``来下载最新的依赖的**Nuclei SDK**开发包
|
|||
|
|
2. **可选**: 运行 ``menuconfig``来进行内核配置
|
|||
|
|
3. 运行 ``scons -c``清理之前的编译结果
|
|||
|
|
4. 运行 ``scons``来进行代码的编译
|
|||
|
|
|
|||
|
|
### 下载程序
|
|||
|
|
|
|||
|
|
在保证程序能够正常编译后, 在相同ENV终端执行``scons --run upload``进行代码的下载。
|
|||
|
|
|
|||
|
|
正常下载的输出如下:
|
|||
|
|
|
|||
|
|
~~~
|
|||
|
|
scons: Reading SConscript files ...
|
|||
|
|
Supported downloaded modes for board hbird_eval are ('ilm', 'flash', 'flashxip'), chosen downloaded mode is ilm
|
|||
|
|
Upload application rtthread.elf using openocd and gdb
|
|||
|
|
riscv-nuclei-elf-gdb rtthread.elf -ex "set remotetimeout 240" -ex "target remote | openocd --pipe -f D:/workspace/Sourcecode/rt-thread/bsp/nuclei/hbird_eval/packages/nuclei_sdk-latest/SoC/hbird/Board/hbird_eval/openocd_hbird.cfg"
|
|||
|
|
--batch -ex "monitor halt" -ex "monitor flash protect 0 0 last off" -ex "load" -ex "monitor resume" -ex "monitor shutdown" -ex "quit"
|
|||
|
|
D:\Software\Nuclei\gcc\bin\riscv-nuclei-elf-gdb.exe: warning: Couldn't determine a path for the index cache directory.
|
|||
|
|
Nuclei OpenOCD, i386 Open On-Chip Debugger 0.10.0+dev-g11f0cf429 (2020-07-15-04:09)
|
|||
|
|
Licensed under GNU GPL v2
|
|||
|
|
For bug reports, read
|
|||
|
|
http://openocd.org/doc/doxygen/bugs.html
|
|||
|
|
rt_thread_idle_entry (parameter=<optimized out>) at D:\workspace\Sourcecode\rt-thread\src\idle.c:249
|
|||
|
|
249 for (i = 0; i < RT_IDLE_HOOK_LIST_SIZE; i++)
|
|||
|
|
cleared protection for sectors 0 through 63 on flash bank 0
|
|||
|
|
|
|||
|
|
Loading section .init, size 0x284 lma 0x80000000
|
|||
|
|
Loading section .text, size 0xb57e lma 0x800002c0
|
|||
|
|
Loading section .rodata, size 0x3248 lma 0x8000b840
|
|||
|
|
Loading section .data, size 0x350 lma 0x8000ea88
|
|||
|
|
Start address 0x80000198, load size 60826
|
|||
|
|
Transfer rate: 49 KB/sec, 10137 bytes/write.
|
|||
|
|
shutdown command invoked
|
|||
|
|
A debugging session is active.
|
|||
|
|
|
|||
|
|
Inferior 1 [Remote target] will be detached.
|
|||
|
|
|
|||
|
|
Quit anyway? (y or n) [answered Y; input not from terminal]
|
|||
|
|
Remote communication error. Target disconnected.: Success.
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
下载程序之后, 连接**串口(57600-N-8-1)**, 可以看到 RT-Thread 的输出信息:
|
|||
|
|
|
|||
|
|
> 由于FPGA评估的Nuclei RISC-V内核主频一般在8MHz左右, 而评估SoC串口
|
|||
|
|
> 在8MHz主频下，工作大于在115200 bps时，串口读取工作不正常，因此这里设置
|
|||
|
|
> 波特率为57600bps，特此说明.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
initialize rti_board_start:0 done
|
|||
|
|
|
|||
|
|
\ | /
|
|||
|
|
- RT - Thread Operating System
|
|||
|
|
/ | \ 4.0.3 build Apr 23 2020
|
|||
|
|
2006 - 2020 Copyright by rt-thread team
|
|||
|
|
do components initialization.
|
|||
|
|
initialize rti_board_end:0 done
|
|||
|
|
initialize dfs_init:0 done
|
|||
|
|
initialize libc_system_init:0 done
|
|||
|
|
initialize finsh_system_init:0 done
|
|||
|
|
msh />
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在串口终端(我这里使用的是TeraTerm)输入``ps``即可查看当前线程工作情况:
|
|||
|
|
|
|||
|
|
~~~
|
|||
|
|
msh />ps
|
|||
|
|
thread pri status sp stack size max used left tick error
|
|||
|
|
-------- --- ------- ---------- ---------- ------ ---------- ---
|
|||
|
|
thread01 19 suspend 0x00000158 0x0000018c 87% 0x00000005 000
|
|||
|
|
thread00 19 suspend 0x00000158 0x0000018c 87% 0x00000005 000
|
|||
|
|
tshell 20 running 0x00000258 0x00001000 18% 0x00000004 000
|
|||
|
|
tidle0 31 ready 0x000000a8 0x0000018c 59% 0x0000000e 000
|
|||
|
|
timer 4 suspend 0x000000f8 0x00000200 49% 0x00000009 000
|
|||
|
|
main 10 suspend 0x00000168 0x00000800 36% 0x00000006 000
|
|||
|
|
msh />
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
### 调试程序
|
|||
|
|
|
|||
|
|
在保证程序编译成功后, 在相同ENV终端执行``scons --run debug``进行代码在命令行下进行GDB调试。
|
|||
|
|
|
|||
|
|
正常的调试输出如下:
|
|||
|
|
|
|||
|
|
~~~
|
|||
|
|
scons: Reading SConscript files ...
|
|||
|
|
Supported downloaded modes for board hbird_eval are ('ilm', 'flash', 'flashxip'), chosen downloaded mode is ilm
|
|||
|
|
Debug application rtthread.elf using openocd and gdb
|
|||
|
|
riscv-nuclei-elf-gdb rtthread.elf -ex "set remotetimeout 240" -ex "target remote | openocd --pipe -f D:/workspace/Sourcecode/rt-thread/bsp/nuclei/hbird_eval/packages/nuclei_sdk-latest/SoC/hbird/Board/hbird_eval/openocd_hbird.cfg"
|
|||
|
|
D:\Software\Nuclei\gcc\bin\riscv-nuclei-elf-gdb.exe: warning: Couldn't determine a path for the index cache directory.
|
|||
|
|
GNU gdb (GDB) 8.3.0.20190516-git
|
|||
|
|
Copyright (C) 2019 Free Software Foundation, Inc.
|
|||
|
|
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
|
|||
|
|
This is free software: you are free to change and redistribute it.
|
|||
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|||
|
|
Type "show copying" and "show warranty" for details.
|
|||
|
|
This GDB was configured as "--host=i686-w64-mingw32 --target=riscv-nuclei-elf".
|
|||
|
|
Type "show configuration" for configuration details.
|
|||
|
|
For bug reporting instructions, please see:
|
|||
|
|
<http://www.gnu.org/software/gdb/bugs/>.
|
|||
|
|
Find the GDB manual and other documentation resources online at:
|
|||
|
|
<http://www.gnu.org/software/gdb/documentation/>.
|
|||
|
|
|
|||
|
|
For help, type "help".
|
|||
|
|
Type "apropos word" to search for commands related to "word"...
|
|||
|
|
Reading symbols from rtthread.elf...
|
|||
|
|
Remote debugging using | openocd --pipe -f D:/workspace/Sourcecode/rt-thread/bsp/nuclei/hbird_eval/packages/nuclei_sdk-latest/SoC/hbird/Board/hbird_eval/openocd_hbird.cfg
|
|||
|
|
Nuclei OpenOCD, i386 Open On-Chip Debugger 0.10.0+dev-g11f0cf429 (2020-07-15-04:09)
|
|||
|
|
Licensed under GNU GPL v2
|
|||
|
|
For bug reports, read
|
|||
|
|
http://openocd.org/doc/doxygen/bugs.html
|
|||
|
|
0x0000000080000f14 in _has_defunct_thread () at D:\workspace\Sourcecode\rt-thread\src\idle.c:153
|
|||
|
|
153 while (_has_defunct_thread())
|
|||
|
|
(gdb) load
|
|||
|
|
Loading section .init, size 0x284 lma 0x80000000
|
|||
|
|
Loading section .text, size 0xb57e lma 0x800002c0
|
|||
|
|
Loading section .rodata, size 0x3248 lma 0x8000b840
|
|||
|
|
Loading section .data, size 0x350 lma 0x8000ea88
|
|||
|
|
Start address 0x80000198, load size 60826
|
|||
|
|
Transfer rate: 48 KB/sec, 10137 bytes/write.
|
|||
|
|
(gdb) b main
|
|||
|
|
Breakpoint 1 at 0x800002c0: file applications\main.c, line 95.
|
|||
|
|
(gdb) c
|
|||
|
|
Continuing.
|
|||
|
|
|
|||
|
|
Breakpoint 1, main () at applications\main.c:95
|
|||
|
|
95 board_gpio_init();
|
|||
|
|
(gdb) n
|
|||
|
|
96 create_thread_demo();
|
|||
|
|
(gdb) n
|
|||
|
|
99 board_serial_init();
|
|||
|
|
(gdb) c
|
|||
|
|
Continuing.
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
调试例子参见如下文档:
|
|||
|
|
|
|||
|
|
* https://doc.nucleisys.com/nuclei_sdk/quickstart.html#debug-application
|
|||
|
|
|
|||
|
|
为了更方便的进行调试, 也可以下载**Nuclei Studio**集成开发环境, 创建一个Debug Configuration, 选择编译好的
|
|||
|
|
ELF文件, 然后配置OPENOCD和GDB即可, OPENOCD配置文件路径为**bsp\nuclei\hbird_eval\packages\nuclei_sdk-latest\SoC\hbird\Board\hbird_eval\openocd_hbird.cfg**
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 驱动支持情况
|
|||
|
|
|
|||
|
|
| 驱动 | 支持情况 | 备注 |
|
|||
|
|
| ------ | ---- | :------: |
|
|||
|
|
| UART | 支持 | 蜂鸟开发板载串口是UART0 |
|
|||
|
|
|
|||
|
|
**注:**
|
|||
|
|
|
|||
|
|
- 适配RT-Thread的驱动框架的代码在 [../libraries/hbird/HAL_Drivers](../libraries/hbird/HAL_Drivers)目录下。
|
|||
|
|
- 如果有开发者想适配更多的驱动, 请在对应目录下增加驱动适配支持。
|
|||
|
|
- 目前串口读取功能在主频为8MHz情况下需要工作在57600bps
|
|||
|
|
- 目前串口读取没有采用中断的方式进行，而是采用单独的任务来读取，等中断信号接入后可以直接中断方式读取
|
|||
|
|
|
|||
|
|
## 联系人信息
|
|||
|
|
|
|||
|
|
维护人:
|
|||
|
|
|
|||
|
|
- [fanghuaqi](https://github.com/fanghuaqi)
|
|||
|
|
|