Qiu Group · FPGA 入门工作流 · Hardware onboarding

HLS → MicroBlaze 工作流

从一个 C 函数开始,经过四步,做到由 MicroBlaze 软件控制的以太网帧改写。每一步只多引入一样新东西:先是 HLS 出 IP,再是流接口,再是 CPU 平台,最后把核挂进系统。

器件xc7a100tcsg324-1
工具Vitis HLS · Vivado 2022.2
时钟10 ns · 100 MHz
源码Tutorial/workflow/
00 · OVERVIEW

每一步走到工具链的哪一段Where each step sits in the toolchain

横向是工具链顺序,纵向是四个步骤。实心点表示这一步用到了该环节,格子里是对应的手写文件。

C / C++源码 VITIS HLS综合并导出 IP VIVADO SIM行为仿真 BLOCK DESIGN块设计 + 比特流 BARE-METALMicroBlaze 程序 HOST主机端
01 加法核Adder core
simple_add.cpp
Simple_Add IP,ap_ctrl 端口
Sim_Top.v
—
—
—
02 流式安全开关Security switch
Security_Switch.cpp/.h
64 位 AXIS 进出
sim_Stream.v + Up/Down_Stream + data/*.txt
—
—
—
03 MicroBlaze 平台CPU platform
—
—
—
MicroBlaze · BRAM · MIG · UART Lite · MDM
hello_world 工程
串口
04 以太网帧改写Core in the system
Ethernet_Processor.cpp
32 位 AXIS + AXI-Lite 寄存器
—
平台 + AXI-Stream FIFO + 核
helloworld.c
test.py(Scapy 造帧)
HLS / 仿真环节系统集成环节

主线:控制信号从哪里来Where the control comes from

01端口x、y 直接是输入端口,ap_start 由测试平台拉高
02每拍的 TUSER动作跟着数据走,每一拍可以不一样
03CPU 上线有了 MicroBlaze 和到主机的串口,还没有自定义核
04AXI-Lite 寄存器软件写一次 MAC 和 Transform,之后对每一帧生效
01 · ADDER CORE

加法核One C function becomes an IP

0 ns 5 ns ap_start x 1 128 y 2 1000 ap_return 3 1128
Sim_Top.v 的激励:ap_start 一直为 1,先算 1+2,5 ns 后改成 128+1000。

int Simple_Add(int x, int y) 经 Vitis HLS 综合成 IP,端口是 ap_start / ap_done / ap_ready / ap_idle,加上 x、y 和 ap_return。

  • 这一步要看懂的是 HLS 的块级握手 ap_ctrl_hs:C 函数的参数变成数据端口,返回值变成 ap_return。
  • Sim_Top.v 没有接时钟,例化的 Simple_Add_0 也没有 ap_clk:一个加法综合出来是 0 延迟的组合逻辑,输入一变输出就跟着变。
  • 流程:HLS 里 C 综合 → Export RTL 得到 IP → Vivado 工程加 IP 仓库并例化 → 跑行为仿真看波形。
02 · STREAMING SECURITY SWITCH

流式安全开关AXI-Stream in, AXI-Stream out

64 位 AXI-Stream 进,64 位 AXI-Stream 出。每一拍要做什么写在这一拍的 TUSER 里,所以同一条流里每拍的处理可以不同。

data/*.txt up_stream_data up_stream_user up_stream_keep up_stream_indicator $readmem Up_Stream.v AXIS 主机,按拍送出 AXIS 64 Security_Switch_0 HLS 导出的 IP ap_start=1 · ap_clk 10 ns AXIS 64 Down_Stream.v 收进数组 sim_Stream.v 把三块接在一起 · TDATA / TKEEP / TUSER / TLAST / TVALID / TREADY
测试平台不需要主机或 CPU:激励从文本读,结果收进数组,在 Vivado 波形里看。

TUSER 的位定义8-bit sideband

[7:6] 未用[5:2] 宽度码 → 改写 TKEEP[1:0] 操作

四种操作op = TUSER[1:0]

op动作输出
00丢掉这一拍不写出
01清零0
10只留所选宽度的高半段data & mask
11加上同宽度 LFSR 的当前值data + lfsr

宽度码 0–3 对应 8/16/32/64 位,同时把 TKEEP 改成 00000001、00000011、00001111、11111111。

16 拍激励正好覆盖 4 × 4 种组合The stimulus file, decoded

每格是 data/ 里的一拍:上面是输入 TDATA,下面是按代码推出的输出。点一个格子,上方的 TUSER 位图会跟着变。

03 · MICROBLAZE PLATFORM

MicroBlaze 平台A CPU and a serial line to the host

这一步没有手写 RTL,全部在 Vivado 块设计里搭。它给第 04 步提供 CPU 和一条到主机的串口。下图虚线框是第 04 步才加进来的部分。

本地 BRAM LMB · 32 KB 0x0000_0000 I/D LMB MicroBlaze v11.0 · 100 MHz cache SmartConnect MIG 7-series DDR 控制器 DDR 128 MB 0x8000_0000 MDM JTAG 下载与调试 M_AXI_DP AXI Interconnect(外设总线) AXI UART Lite 0x4060_0000 9600 baud AXI-Stream FIFO axi_fifo_mm_s 0x44A1_0000 s_axi_control Ethernet_Processor HLS IP · ap_start ← 常量 1 寄存器 0x44A0_0000 TXD → In RXD ← Out 04 新增 04 新增 主机 PC test.py · Scapy /dev/ttyUSB1 USB-UART
AXI4 / LMB 存储映射 AXI-Lite 控制寄存器 AXI-Stream 串口
来自 ethernet_processor/…/main.bd。第 03 步的 hello_world 工程就是去掉两个虚线框后的样子。报文走串口,块设计里没有以太网 PHY。

地址映射MicroBlaze data address space

基地址大小设备
0x0000_000032 KB本地 BRAM(指令 + 数据 LMB)
0x4060_000064 KBAXI UART Lite
0x44A0_000064 KBEthernet_Processor 控制寄存器 04
0x44A1_000064 KBAXI-Stream FIFO 04
0x8000_0000128 MBDDR(经 MIG)

各部分的作用What each block is for

  • MicroBlaze:软核 CPU,跑裸机程序。
  • 本地 BRAM:片上存储,经 LMB 直连,放小程序。
  • MIG + DDR:板上 DDR 的控制器,提供 128 MB 外存。
  • UART Lite:printf / scanf 走这里,到主机的唯一数据通道。
  • MDM:经 JTAG 下载程序和调试。
  • 时钟由 Clocking Wizard 产生 100 MHz,外设和第 04 步的核都在这个时钟域。
04 · CORE IN THE SYSTEM

以太网帧改写Software-controlled frame rewrite

HLS 核改成 32 位 AXI-Stream,一帧 16 个字(64 字节)。控制从 TUSER 移到 AXI-Lite 寄存器,由 MicroBlaze 写入。

寄存器s_axi_control @ 0x44A0_0000

偏移内容helloworld.c 写入
0x10Target_Mac[31:0]0x00155de9
0x14Target_Mac[47:32]0x000076f7
0x1CTransform[7:0]0xff

测试 MAC 是 00:15:5d:e9:76:f7。0x10 存的是前 4 字节,0x14 存后 2 字节。

核里的规则Ethernet_Processor.cpp

  • 4 位计数器 write_ptr 数字号,数到 16 回 0,认作一帧。
  • 字 0 与 Target_Mac[31:0] 比;字 1 的高 16 位与 Target_Mac[47:32] 比。任一不等,match 置 0。
  • 命中且 Transform == 0xFF 时:字 12 低 16 位清零,字 13、字 14 整字清零。
  • 字 15 把 match 复位为 1。每个字都会写出,不丢拍。
目的 MAC
Transform

输入帧 · test.py 造的 64 字节16 × 32 bit

输出帧 · FIFO 读回printf("%08x")

以太网头 IPv4 头 UDP 头 负载 "123456789abcdef1234567" 参与 MAC 比对 被清零
帧内容按 test.py 的参数算出:Ether(src 11:11:11:11:11:11) / IP(192.168.0.1 → 192.168.0.2) / UDP(1 → 2, chksum=0) / 22 字节负载,正好 64 字节,不含 FCS。

一个字的往返One word, end to end

  1. test.pyScapy 造帧,转成 16 个 8 位十六进制字符串,逐个写串口,每个后面跟 \r
  2. UART Lite9600 baud 收字符,MicroBlaze 的 scanf("%x") 拼成一个 u32
  3. helloworld.cXLlFifo_TxPutWord 写入 FIFO,再 XLlFifo_iTxSetLen(4) 发出这 4 字节
  4. Ethernet_Processor从 TXD 收一个字,按 write_ptr 比对或清零,写到 RXD
  5. helloworld.cXLlFifo_RxGetWord 读回,printf("%08x") 打印 8 个字符
  6. test.py读 16 × 8 个字符,切回 16 个字
步骤 2–5 在 while(1) 里每个字执行一次 · 启动时先 setup_parameter() 写三个寄存器,并回读打印 Dst Mac / Transform
! · DISCUSSION

读代码时发现的点Things worth raising

以下是对照源码推出来的,没有上板复现过,组会上可以和学长确认。

可能的 BUG

LFSR 不会真正“跑”起来

new_bit 声明成 static,只在第一次初始化时算一次。初值 0xCC… 的 bit0、bit1 都是 0,反馈位恒为 0,每次调用只是右移补 0。8/16/32/64 次调用后寄存器归零,op 11 退化成加 0。

移位写在 if(!InStream.empty()) 外面,没数据时也在移。改法:去掉 new_bit 的 static,每次调用重新计算。

02 · Security_Switch.cpp
设计限制

帧边界只靠计数器

核用 4 位 write_ptr 数满 16 个字算一帧,不看 TLAST。串口多收或少收一个字,之后每一帧都会错位,MAC 比对和清零都打在错的字上。

想改成看 TLAST,软件也要一起改:现在每个字都调用一次 TxSetLen(4),FIFO 会把每个字当成一个包、每拍都拉 TLAST;要整帧写完再 TxSetLen(64)。

04 · Ethernet_Processor.cpp · helloworld.c
易混点

MAC 寄存器的字节顺序

0x10 写 0x00155de9(MAC 前 4 字节),0x14 写 0x76f7(后 2 字节)。这样能对上,因为核拿 Target_Mac[31:0] 比字 0。但作为 48 位整数读出来是 0x76f7_00155de9,不是自然顺序的 MAC,换 MAC 时容易写反。

04 · setup_parameter()
性能

瓶颈在串口

9600 baud,8N1 每字符 10 位。每个字发 9 个字符、收 8 个,一帧 16 字约 272 字符,约 0.28 秒。核在 100 MHz 下处理一个字只要几个时钟周期,两者差好几个数量级。

这条链路用来验证功能,测不了核的吞吐。

04 · test.py · UART Lite
≡ · INDEX

工程与源码索引Where to open things

路径相对 General/General/Tutorial/。workflow/ 只放手写源码;Vivado / HLS 工程仍从原目录打开。solution1、.gen、.runs、.cache、.sim 是工具生成物。

步骤手写源码(workflow/)HLS 工程Vivado 工程
0101_add/simple_add.cpp
01_add/Sim_Top.v
HLS_Tutorial/Add/hlsHLS_Tutorial/Add/vivado/vivado.xpr
0202_security_switch/Security_Switch.cpp/.h
Up_Stream.v · Down_Stream.v · sim_Stream.v
data/*.txt
HLS_Tutorial/Security_Switch/hls_exampleHLS_Tutorial/Security_Switch/
vivado_example/vivado_example.xpr
0303_microblaze_platform/README.md—Microbalze_Tutorial/hello_world/
vivado_example/vivado_example.xpr
0404_ethernet_on_microblaze/
Ethernet_Processor.cpp · helloworld.c · test.py
Microbalze_Tutorial/hls_exampleMicrobalze_Tutorial/ethernet_processor/
vivado_example/vivado_example.xpr