How xilinx/hls_packet_processing works
HLS Packet Processing is a C++/Vivado HLS networking library with example FPGA applications. Its central workflow is to parse packet headers and payloads from streams, apply protocol or queue policy, and emit packets or metadata. The README documents both packet-oriented and stream-oriented APIs, while the applications demonstrate ARP caching, MOLD/ITCH parsing, priority-based packet buffering, and MQTTSN publish/subscribe. Several application internals were not sampled; links to those documented capabilities are shown only where supported or marked unverified.
Main entry points: pynq_mqttsn/app.cpp MQTTSN Protocol · ip.hpp Packet APIs · traffic_manager/app.cpp Traffic Ingress · mold_remover_packet/app.cpp MOLD Packet Parser
Components 17
Packet Libraries
- Packet APIs
apps/common/ip.hpp
State Helpers
- CAM Lookup
apps/common/cam.h - Buffer Allocator
apps/common/allocator.h
Protocol Apps
- ARP Client
apps/arp/app.cpp - ARP Cache
apps/arp/app.h - MOLD Packet Parser
apps/mold_remover_packet/app.cpp - MOLD Stream Parser
apps/mold_remover_stream/app.cpp - MQTTSN Entrypoints
apps/pynq_mqttsn/main.cpp - MQTTSN Protocol
apps/pynq_mqttsn/app.cpp
Packet Scheduling
- Traffic Ingress
apps/traffic_manager/app.cpp - Packet Buffers
apps/traffic_manager/app.cpp - Priority Queue
apps/traffic_manager/app.cpp - Scheduled Output
apps/traffic_manager/app.cpp
Other components
- AXI Stream I/O
- Sensor Hardware
- Runtime Configuration
- Packet Metadata
Connections 23
- ARP Client → Packet APIs: parses headers
apps/arp/app.cpp - ARP Client → ARP Cache: looks up
apps/arp/app.cpp - ARP Cache → CAM Lookup: uses CAM
apps/arp/app.h - AXI Stream I/O → ARP Client: supplies frames
- AXI Stream I/O → MOLD Packet Parser: supplies packets
- AXI Stream I/O → MOLD Stream Parser: supplies packets
- MOLD Packet Parser → Packet APIs: uses packet API
apps/mold_remover_packet/app.cpp - MOLD Stream Parser → Packet APIs: uses stream API
apps/mold_remover_stream/app.cpp - MQTTSN Entrypoints → MQTTSN Protocol: runs protocol
- MQTTSN Protocol → Packet APIs: uses packet API
apps/pynq_mqttsn/app.cpp - MQTTSN Protocol → CAM Lookup: uses lookup
apps/pynq_mqttsn/app.cpp - MQTTSN Protocol → Buffer Allocator: stores messages
apps/pynq_mqttsn/app.cpp - Sensor Hardware → MQTTSN Protocol: provides readings
- Runtime Configuration → MQTTSN Protocol: configures run
- AXI Stream I/O → Traffic Ingress: supplies frames
- Traffic Ingress → Packet APIs: parses headers
apps/traffic_manager/app.cpp - Traffic Ingress → Packet Buffers: stores packets
apps/traffic_manager/app.cpp - Priority Queue → Packet Buffers: selects buffers
apps/traffic_manager/app.cpp - Priority Queue → Scheduled Output: dispatches packets
apps/traffic_manager/app.cpp - Traffic Ingress → Priority Queue: provides length and priority
apps/traffic_manager/app.cpp - Scheduled Output → Packet Metadata: emits packet metadata
- MOLD Packet Parser → Packet Metadata: emits metadata
- MOLD Stream Parser → Packet Metadata: emits metadata