引言

展示的是可以如何使用 AXI Video Direct Memory Access (VDMA) IP 來實現視頻剪裁、畫中畫或軟模式生成器功能。

示例 1：使用 AXI VDMA IP 的視頻裁剪

視頻裁剪

在某些情況下，您可能需要輸出分辨率比輸入分辨率小。視頻剪裁是您可以通過 AXI 視頻直接存儲器訪問(VDMA) IP 執行的一項操作。

視頻剪裁是對圖像的特定部分進行的“剪切”。我們可以通過只讀取傳入視頻的一部分來完成此操作。

通過AXI VDMA IP來實現

在此示例中，我要將測試模式生成器(TPG) IP 用作源，并且將 AXI VDMA IP 配置為已啟用讀寫通道。這與視頻系列 24 中的設計相同。

在這個應用中，我要把TPG IP設置為可以生成分辨率為1024x768的視頻（而會把HDMI輸出分辨率固定為800x600）

//Configure the TPG
app_hdmi_conf_tpg(&tpg_inst, 768, 1024, 0x2, XTPG_BKGND_COLOR_BARS);

必須完成的主要配置是 AXI VDMA IP。

寫入接口被設置為1024x768

//S2MM Frame delay / Stride register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA8, 1024*2);
// S2MM HSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA4, 1024*2);
// S2MM VSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA0, 768);

讀取接口被設置為 800x600。

// MM2S Frame delay / Stride register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x58, 1024*2);
// MM2S HSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x54, 800*2);
// MM2S VSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x50, 600);

請注意，此處的 STRIDE 參數不等于 HSIZE 參數。這是我們確實可以使用此參數的一種情況。

如果 STRIDE 等于 HSIZE，那么 AXI VDMA IP 會在沒有任何跳轉的情況下讀取幀緩存。但是，由于輸入大小大于輸出大小，我們需要在地址之間跳轉以便能夠正確地對齊下一行的開頭。

STRIDE 參數用于描述每個視頻行第一個像素之間的地址的字節數。

如果我們想在輸入幀中移動剪裁窗口，我們只需在幀緩存地址中添加偏移，使 HSIZE 和 STRIDE 參數值保持一致即可。

例如，如果我們想要讓剪裁窗口水平居中，可以為讀取接口的幀緩存地址添加 224 的偏移((hsize_in –hsize_out)/2 * bytes/pixel = (1024 - 800)/2 * 2 = 224)。

// MM2S Start Address 1
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x5C, 0x10000000 + 224);
// MM2S Start Address 2
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x60, 0x10200000 + 224);
// MM2S Start Address 3
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0x64, 0x10400000 + 224);

注意：在此示例中，偏移需要是存儲器映射數據寬度字節（32 位）的倍數，因為在“AXI VDMA IP”配置中未啟用“Allow Unaligned Transfers”。

示例 2：使用 AXI VDMA IP 的畫中畫

畫中畫

如果設計中的輸入分辨率小于輸出分辨率，則可能采用的解決方案就是使用畫中畫。例如，我們可以添加藍色背景，然后使輸入居中。

通過AXI VDMA IP來實現

設計的硬件與示例 1 中的硬件相同。

在這個應用中，TPG IP被設置為可以生成分辨率為640x480的視頻（而HDMI輸出分辨率固定為800x600）

//Configure the TPG
app_hdmi_conf_tpg(&tpg_inst,480,640, 0x2, XTPG_BKGND_COLOR_BARS);

我們需要做的第一件事就是用背景的藍色填充幀緩存。

這是通過代碼中的以下行來完成的：

UINTPTR Addr1=0x10000000,Addr2=0x10200000,Addr3=0x10400000;
…
print("Initialize frame buffer data...");
//Disable the data cache to initialize the frame buffer with a blue color
Xil_DCacheDisable();
//Write a blue background in the memory
for(line=0; line < OUTPUT_HEIGHT; line++)
{
for(column=0; column < OUTPUT_WIDTH/2; column++)
{
//Write the blue color to the frame buffer(0x6B1DFF1D in YUV422)
Xil_Out32(Addr1, 0x6B1DFF1D);
Xil_Out32(Addr2, 0x6B1DFF1D);
Xil_Out32(Addr3, 0x6B1DFF1D);

Addr1+=4;
Addr2+=4;
Addr3+=4;
}

}
//Re-enable the data cache
Xil_DCacheEnable();
print("Done

");

您可以看到，在將數據寫入內存之前，我會禁用數據高速緩存（Xil_DCacheDisable（））并在寫入完成后重新啟用它。

寫入或讀入高速緩存存儲器而不是 DDR 存儲器是一個常見的錯誤。使用內存時，您需要確保從正確的位置讀取/寫入。

然后，在進行 AXI VDMA IP 配置時，我們將執行與示例 1 中所執行操作相反的操作。

在這個示例中，我們會使用寫入接口（而不是前面示例中的讀取接口）上的步幅（現在已與 HSIZE 不同）在 800 * 600背景上正確地寫入內存。

對于緩存存儲器地址，我添加了一個偏移以便能夠使輸入水平和垂直居中。

//Offset to center the pattern on the buffer
offset = 0x177A0;
//S2MM Start Address 1
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xAC, 0x10000000 + offset);
//S2MM Start Address 2
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xB0, 0x10200000 + offset);
//S2MM Start Address 3
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xB4, 0x10400000 + offset);
//S2MM Frame delay / Stride register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA8, OUTPUT_WIDTH*2);
// S2MM HSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA4, 640*2);
// S2MM VSIZE register
Xil_Out32(XPAR_AXI_VDMA_0_BASEADDR + 0xA0, 480);

示例 3：使用 AXI VDMA IP 的軟模式發生器

通過AXI VDMA IP來實現

在此示例中，AXI VDMA IP 配置為僅啟用讀取接口。

在應用開始時，處理器在 DDR 中寫入模式。

在 Vivado Design 中，我刪除了“測試模式生成器”：

因為我們正在讀取一個靜止模式，所以在 AXI VDMA IP 讀取時不會同時寫入與幀緩存對應的存儲器。因此，AAXI VDMA IP 中只需要一個幀緩存器。

寫入存儲器的方式與示例 2 中所用的方式類似，在需要訪問 DDR 存儲器時禁用高速緩存。

另外請注意，在配置 AXI VDMA IP 的 MM2S 接口時，同步鎖相會被禁用。

構建SDK工作空間和Vivado Designs

注意：這些示例僅針對 ZC702 電路板。

構建SDK工程

1. 下載教程文件，然后解壓縮文件夾。

2. 啟動賽靈思軟件命令行工具(XSCT) 2018.1。

• 從 Windows 菜單中選擇以下內容：

“Start > All Program > Xilinx Design Tools > Xilinx Software Command Line Tool 2018.1”。

• 從命令行：

使用 xsct 命令（需要設置 SDK 2018.1 的環境變量）。

3. 在 xsct 中，使用 cd 導航到您要構建的示例的路徑(example_x/sw)。
   
   然后輸入下列命令：
   source create_SW_proj.tcl

4. 打開 SDK，然后選擇“example_x/sw/sdk_workspace”作為工作空間。

構建Vivado Design

1. 打開 Vivado 。

2. 在 Tcl 控制臺中，使用 cd 導航到解壓縮的目錄(cd example_x/hw)。

3. 在 Tcl 控制臺中，用 source 來寫腳本 tcl (source ./create_proj.tcl)。