4. Gamma校正RTL设计（一）：基于查找表（LUT）的Gamma校正架构设计、双端口RAM实现、地址映射逻辑

Gamma校正，说白了就是给像素值做一个非线性的映射。人眼对暗部细节敏感，对亮部变化迟钝，而传感器和显示器往往是线性的。为了让显示效果更自然，我们需要在硬件里把这个映射做出来。

我个人习惯用查找表（LUT）来实现。为什么？因为Gamma曲线是固定的，查表速度快，延迟确定，而且不占太多逻辑资源。你想想看，一个8-bit的输入，256个深度，每个深度存一个校正后的值，这多直接。

4.1 架构概览：LUT-based Gamma校正

整个模块的核心就三部分：地址映射逻辑、双端口RAM（LUT存储体）、输出流水线。数据流是这样的：像素值进来，经过地址映射，去RAM里把校正后的值读出来，再经过一级流水输出。

4.2 双端口RAM实现

双端口RAM是LUT的物理载体。一个端口（Port A）专门用来读校正值，另一个端口（Port B）用来写配置。这样，在系统运行时，我们可以通过Port B更新Gamma曲线，而Port A的读操作完全不受影响。

我在项目中遇到过一个问题：如果RAM的读延迟是1个时钟周期，那地址映射逻辑就要提前一拍把地址准备好。否则流水线会断，数据对不上。

// 双端口RAM模块示例
module gamma_lut_ram #(
    parameter ADDR_WIDTH = 8,   // 256深度
    parameter DATA_WIDTH = 8    // 8-bit输出
)(
    input  wire                clk,
    // Port A: 读校正值
    input  wire [ADDR_WIDTH-1:0] addr_a,
    output reg  [DATA_WIDTH-1:0] data_a,
    // Port B: 写配置
    input  wire [ADDR_WIDTH-1:0] addr_b,
    input  wire [DATA_WIDTH-1:0] data_b,
    input  wire                  we_b
);

    reg [DATA_WIDTH-1:0] mem [0:(1<<ADDR_WIDTH)-1];

    // Port A: 读操作
    always @(posedge clk) begin
        data_a <= mem[addr_a];
    end

    // Port B: 写操作
    always @(posedge clk) begin
        if (we_b)
            mem[addr_b] <= data_b;
    end

endmodule

4.3 地址映射逻辑

地址映射逻辑，就是把输入的像素值转换成RAM的读地址。听起来很简单？嗯，这里有个坑。

如果输入是8-bit，那像素值本身就是0~255，直接作为地址就行。但如果输入是10-bit，而RAM只有256深度，怎么办？这时候就需要做映射：把10-bit的输入压缩到8-bit的地址空间。

输入位宽	RAM深度	地址映射方式	精度损失
8-bit	256	直接映射	无
10-bit	256	右移2位（取高8位）	低2位丢失
10-bit	1024	直接映射	无
12-bit	256	右移4位（取高8位）	低4位丢失

我曾经在一个项目中，为了节省RAM资源，把10-bit输入映射到256深度的LUT。结果画面暗部出现明显的色阶断层。后来我改用1024深度的LUT，问题就解决了。所以，精度和资源之间需要权衡。

4.4 地址映射的RTL实现

直接映射很简单，就是像素值直接连到地址线上。压缩映射则需要做移位或查表。下面是一个10-bit输入映射到8-bit地址的例子：

// 地址映射逻辑示例
module addr_mapping #(
    parameter IN_WIDTH  = 10,
    parameter OUT_WIDTH = 8
)(
    input  wire [IN_WIDTH-1:0]  pixel_in,
    output reg  [OUT_WIDTH-1:0] addr_out
);

    // 压缩映射：取高8位
    always @(*) begin
        addr_out = pixel_in[IN_WIDTH-1 : IN_WIDTH-OUT_WIDTH];
    end

endmodule

你可能会问：为什么不直接用低8位？因为高8位保留了像素的主要信息，低2位只是细节。丢掉低2位，对整体亮度影响不大。但如果你对暗部细节要求高，那就得用1024深度的LUT。

4.5 完整的Gamma校正模块

把地址映射、双端口RAM、输出流水线组合起来，就是一个完整的Gamma校正模块。我个人习惯在输出端再加一级寄存器，用来改善时序。

// Gamma校正顶层模块
module gamma_correction #(
    parameter IN_WIDTH  = 8,
    parameter OUT_WIDTH = 8,
    parameter LUT_DEPTH = 256
)(
    input  wire                clk,
    input  wire                rst_n,
    // 像素输入
    input  wire [IN_WIDTH-1:0] pixel_in,
    input  wire                valid_in,
    // 像素输出
    output reg  [OUT_WIDTH-1:0] pixel_out,
    output reg                  valid_out,
    // 配置接口
    input  wire [7:0]           cfg_addr,
    input  wire [OUT_WIDTH-1:0] cfg_data,
    input  wire                 cfg_wr
);

    // 内部信号
    wire [7:0] lut_addr;
    wire [OUT_WIDTH-1:0] lut_data;

    // 地址映射
    addr_mapping #(
        .IN_WIDTH (IN_WIDTH),
        .OUT_WIDTH(8)
    ) u_addr_map (
        .pixel_in (pixel_in),
        .addr_out (lut_addr)
    );

    // 双端口RAM
    gamma_lut_ram #(
        .ADDR_WIDTH(8),
        .DATA_WIDTH(OUT_WIDTH)
    ) u_lut_ram (
        .clk    (clk),
        .addr_a (lut_addr),
        .data_a (lut_data),
        .addr_b (cfg_addr),
        .data_b (cfg_data),
        .we_b   (cfg_wr)
    );

    // 输出流水线
    always @(posedge clk or negedge rst_n) begin
        if (!rst_n) begin
            pixel_out <= 0;
            valid_out <= 0;
        end else begin
            pixel_out <= lut_data;
            valid_out <= valid_in;
        end
    end

endmodule