From: Cody Kang <[email protected]>

The Saturn display processing unit is programmed through a set of
register blocks (composer, RDMA, timing generator, cmdlist engine,
display MMU) laid out identically in both SoC instances. Add the block
address map, the per-field word offset and mask tables consumed by the
field accessors, the interrupt bit layout and the compositor and
output-format ID encodings. The address map describes the whole
IP block on purpose, including blocks the driver does not touch; the
field tables carry the fields the driver programs, with each block's
full word count kept as its NWORDS extent.

Consumers arrive with the following patches; the driver only becomes
buildable once the final patch adds the Kconfig and Makefile glue.

Signed-off-by: Cody Kang <[email protected]>
---
 drivers/gpu/drm/spacemit/dpu/saturn_regs/dpu_int.h |  25 ++
 .../gpu/drm/spacemit/dpu/saturn_regs/reg_map_hee.h |  64 +++++
 .../drm/spacemit/dpu/saturn_regs/saturn_fields.h   | 298 +++++++++++++++++++++
 drivers/gpu/drm/spacemit/spacemit_dpu_ids.h        |  22 ++
 4 files changed, 409 insertions(+)

diff --git a/drivers/gpu/drm/spacemit/dpu/saturn_regs/dpu_int.h 
b/drivers/gpu/drm/spacemit/dpu/saturn_regs/dpu_int.h
new file mode 100644
index 000000000000..2c7fa00ba31e
--- /dev/null
+++ b/drivers/gpu/drm/spacemit/dpu/saturn_regs/dpu_int.h
@@ -0,0 +1,25 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright (C) 2025-2026 SpacemiT Co., Ltd.
+ *
+ */
+
+#ifndef DPU_INT_REG_H
+#define DPU_INT_REG_H
+
+#include <linux/bits.h>
+
+#define DPU_INT_CMDLIST_CH_FRM_CFG_DONE_MASK   (0xff)
+#define DPU_INT_CMDLIST_CH_FRM_CFG_DONE                
(DPU_INT_CMDLIST_CH_FRM_CFG_DONE_MASK << 11)
+#define DPU_INT_FRM_TIMING_UNFLOW              BIT(8)
+#define DPU_INT_CFG_RDY_CLR                    BIT(5)
+#define DPU_INT_FRM_TIMING_CFG_LINE            BIT(4)
+#define DPU_INT_FRM_TIMING_CFG_EOF             (BIT(2) | BIT(3))
+#define DPU_INT_FRM_TIMING_EOF                 BIT(1)
+#define DPU_INT_FRM_TIMING_VSYNC               BIT(0)
+#define DPU_REST_INT_BITS                      (DPU_INT_FRM_TIMING_CFG_EOF | \
+                                                DPU_INT_FRM_TIMING_CFG_LINE | \
+                                                DPU_INT_FRM_TIMING_EOF | \
+                                                
DPU_INT_CMDLIST_CH_FRM_CFG_DONE)
+
+#endif
diff --git a/drivers/gpu/drm/spacemit/dpu/saturn_regs/reg_map_hee.h 
b/drivers/gpu/drm/spacemit/dpu/saturn_regs/reg_map_hee.h
new file mode 100644
index 000000000000..9490021cdb91
--- /dev/null
+++ b/drivers/gpu/drm/spacemit/dpu/saturn_regs/reg_map_hee.h
@@ -0,0 +1,64 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright (C) 2025-2026 SpacemiT Co., Ltd.
+ *
+ */
+
+#ifndef _SATURN_REG_MAP_hee_H_
+#define _SATURN_REG_MAP_hee_H_
+
+#include "dpu_int.h"
+
+/* Base address, then bit definitions */
+
+#define DPU_TOP_BASE_ADDR 0x0
+#define DPU_CTRL_BASE_ADDR 0x3c0 /* dpu_ctl_top start address */
+#define CMDLIST_BASE_ADDR 0x500
+#define DPU_INT_BASE_ADDR 0x700
+
+#define DPU_ONLINE_IRQ_MSK     (3 * 4)
+#define DPU_ONLINE_IRQ_STS     (12 * 4)
+
+#define DMA_TOP_BASE_ADDR (RDMA0_BASE_ADDR + 0x280)
+
+#define RDMA0_BASE_ADDR (0x00001000)
+#define RDMA1_BASE_ADDR (RDMA0_BASE_ADDR + 0x1000)
+#define RDMA2_BASE_ADDR (RDMA0_BASE_ADDR + 0xa000)
+#define RDMA3_BASE_ADDR (RDMA0_BASE_ADDR + 0xb000)
+
+#define MMU_BASE_ADDR (0x1100)
+#define MMU_TOP_BASE_ADDR (MMU_BASE_ADDR + 0x100)
+
+#define TBU0_ADDR 0x1100
+#define TBU1_ADDR 0x1180
+#define TBU2_ADDR 0x2100
+#define TBU3_ADDR 0x2180
+#define TBU4_ADDR 0xb100
+#define TBU5_ADDR 0xb180
+#define TBU6_ADDR 0xc100
+#define TBU7_ADDR 0xc180
+
+#define CMP0_BASE_ADDR 0x00018000
+#define CMP1_BASE_ADDR (CMP0_BASE_ADDR + 0x18000)
+#define CMP2_BASE_ADDR (CMP0_BASE_ADDR + 0x30000)
+
+#define PREPIPE_SCAL0_BASE_ADDR 0x14000
+#define PREPIPE_SCAL1_BASE_ADDR 0x14400
+#define PREPIPE_SCAL2_BASE_ADDR 0x14800
+#define PREPIPE_SCAL3_BASE_ADDR 0x14c00
+
+#define POST_PIPE_ADDR (CMP1_BASE_ADDR + 0x300)
+
+#define EE_ADDR (CMP1_BASE_ADDR + 0xd00)
+
+#define DPU_SCENE_CTL_BASE_ADDR (0x300)
+#define DPU_SCENE_CTL_SIZE 0x40
+#define DPU_SCENE_CTL_ADDR(i) (DPU_SCENE_CTL_BASE_ADDR + (i) * 
DPU_SCENE_CTL_SIZE)
+
+#define TMG0_BASE_ADDR (0x00051000 + 0x200)
+
+#define CMDLIST_CH_Y                 0x188
+#define CMDLIST_CH_START_CMPS_Y      0x90
+#define CMDLIST_CFG_READY            0x34
+
+#endif
diff --git a/drivers/gpu/drm/spacemit/dpu/saturn_regs/saturn_fields.h 
b/drivers/gpu/drm/spacemit/dpu/saturn_regs/saturn_fields.h
new file mode 100644
index 000000000000..f745dfdaa83d
--- /dev/null
+++ b/drivers/gpu/drm/spacemit/dpu/saturn_regs/saturn_fields.h
@@ -0,0 +1,298 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright (C) 2025-2026 SpacemiT Co., Ltd.
+ *
+ * Saturn DPU register field map: word offset and mask per field, consumed by
+ * the dpu_write()/dpu_read() accessors.
+ */
+
+#ifndef SATURN_FIELDS_H
+#define SATURN_FIELDS_H
+
+#include <linux/bits.h>
+
+/* CMDLIST_REG: 128 x 32-bit registers */
+#define CMDLIST_REG__NWORDS    128
+#define CMDLIST_REG__cmdlist_reg_0__cmdlist_ch_start_addrl_WORD(i)     (0 + 
(i))
+#define CMDLIST_REG__cmdlist_reg_0__cmdlist_ch_start_addrl_MASK        
GENMASK(31, 4)
+#define CMDLIST_REG__cmdlist_reg_16__cmdlist_ch_start_addrh_WORD(i)    (16 + 
(i))
+#define CMDLIST_REG__cmdlist_reg_16__cmdlist_ch_start_addrh_MASK       
GENMASK(5, 0)
+#define CMDLIST_REG__cmdlist_reg_48__cmdlist_ch_y_first_WORD(i)        (48 + 
(i))
+#define CMDLIST_REG__cmdlist_reg_48__cmdlist_ch_y_first_MASK   GENMASK(24, 12)
+
+/* CMPS_X_REG: 146 x 32-bit registers */
+#define CMPS_X_REG__NWORDS     146
+#define CMPS_X_REG__module_enable_WORD 0
+#define CMPS_X_REG__module_enable_MASK GENMASK(0, 0)
+#define CMPS_X_REG__dst_w_WORD 1
+#define CMPS_X_REG__dst_w_MASK GENMASK(15, 0)
+#define CMPS_X_REG__dst_h_WORD 1
+#define CMPS_X_REG__dst_h_MASK GENMASK(31, 16)
+#define CMPS_X_REG__bg_color_r_WORD    2
+#define CMPS_X_REG__bg_color_r_MASK    GENMASK(9, 0)
+#define CMPS_X_REG__bg_color_g_WORD    3
+#define CMPS_X_REG__bg_color_g_MASK    GENMASK(9, 0)
+#define CMPS_X_REG__bg_color_b_WORD    4
+#define CMPS_X_REG__bg_color_b_MASK    GENMASK(9, 0)
+#define CMPS_X_REG__bg_color_a_WORD    5
+#define CMPS_X_REG__bg_color_a_MASK    GENMASK(7, 0)
+#define CMPS_X_REG__layer00_area_left_WORD     8
+#define CMPS_X_REG__layer00_area_left_MASK     GENMASK(15, 0)
+#define CMPS_X_REG__layer00_area_right_WORD    8
+#define CMPS_X_REG__layer00_area_right_MASK    GENMASK(31, 16)
+#define CMPS_X_REG__layer00_area_top_WORD      9
+#define CMPS_X_REG__layer00_area_top_MASK      GENMASK(15, 0)
+#define CMPS_X_REG__layer00_area_bottom_WORD   9
+#define CMPS_X_REG__layer00_area_bottom_MASK   GENMASK(31, 16)
+#define CMPS_X_REG__layer00_solid_color_r_WORD 10
+#define CMPS_X_REG__layer00_solid_color_r_MASK GENMASK(9, 0)
+#define CMPS_X_REG__layer00_solid_color_g_WORD 11
+#define CMPS_X_REG__layer00_solid_color_g_MASK GENMASK(9, 0)
+#define CMPS_X_REG__layer00_solid_color_b_WORD 12
+#define CMPS_X_REG__layer00_solid_color_b_MASK GENMASK(9, 0)
+#define CMPS_X_REG__layer00_solid_color_a_WORD 13
+#define CMPS_X_REG__layer00_solid_color_a_MASK GENMASK(7, 0)
+#define CMPS_X_REG__layer00_blend_mode_WORD    13
+#define CMPS_X_REG__layer00_blend_mode_MASK    GENMASK(15, 14)
+#define CMPS_X_REG__layer00_colorkey_en_WORD   13
+#define CMPS_X_REG__layer00_colorkey_en_MASK   GENMASK(18, 18)
+#define CMPS_X_REG__layer00_en_WORD    14
+#define CMPS_X_REG__layer00_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer00_blend_sel_WORD     14
+#define CMPS_X_REG__layer00_blend_sel_MASK     GENMASK(2, 1)
+#define CMPS_X_REG__layer00_solid_en_WORD      14
+#define CMPS_X_REG__layer00_solid_en_MASK      GENMASK(3, 3)
+#define CMPS_X_REG__layer00_dma_id_WORD        14
+#define CMPS_X_REG__layer00_dma_id_MASK        GENMASK(7, 4)
+#define CMPS_X_REG__layer00_layer_alpha_WORD   14
+#define CMPS_X_REG__layer00_layer_alpha_MASK   GENMASK(15, 8)
+#define CMPS_X_REG__layer00_alpha_ratio_WORD   14
+#define CMPS_X_REG__layer00_alpha_ratio_MASK   GENMASK(23, 16)
+#define CMPS_X_REG__layer01_en_WORD    21
+#define CMPS_X_REG__layer01_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer02_en_WORD    28
+#define CMPS_X_REG__layer02_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer03_en_WORD    35
+#define CMPS_X_REG__layer03_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer04_en_WORD    42
+#define CMPS_X_REG__layer04_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer05_en_WORD    49
+#define CMPS_X_REG__layer05_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer06_en_WORD    56
+#define CMPS_X_REG__layer06_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer07_en_WORD    63
+#define CMPS_X_REG__layer07_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer08_en_WORD    70
+#define CMPS_X_REG__layer08_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer09_en_WORD    77
+#define CMPS_X_REG__layer09_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer10_en_WORD    84
+#define CMPS_X_REG__layer10_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer11_en_WORD    91
+#define CMPS_X_REG__layer11_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer12_en_WORD    98
+#define CMPS_X_REG__layer12_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer13_en_WORD    105
+#define CMPS_X_REG__layer13_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer14_en_WORD    112
+#define CMPS_X_REG__layer14_en_MASK    GENMASK(0, 0)
+#define CMPS_X_REG__layer15_en_WORD    119
+#define CMPS_X_REG__layer15_en_MASK    GENMASK(0, 0)
+
+/* DMA_TOP_REG: 25 x 32-bit registers */
+#define DMA_TOP_REG__NWORDS    25
+#define DMA_TOP_REG__image_rr_ratio_WORD       1
+#define DMA_TOP_REG__image_rr_ratio_MASK       GENMASK(7, 0)
+#define DMA_TOP_REG__pixel_num_th_WORD 1
+#define DMA_TOP_REG__pixel_num_th_MASK GENMASK(14, 9)
+#define DMA_TOP_REG__rdma_timeout_limit_WORD   2
+#define DMA_TOP_REG__rdma_timeout_limit_MASK   GENMASK(15, 0)
+#define DMA_TOP_REG__wdma_timeout_limit_WORD   2
+#define DMA_TOP_REG__wdma_timeout_limit_MASK   GENMASK(31, 16)
+
+/* DPU_CTL_REG: 15 x 32-bit registers */
+#define DPU_CTL_REG__NWORDS    15
+#define DPU_CTL_REG__nml_rch_en_WORD   0
+#define DPU_CTL_REG__nml_rch_en_MASK   GENMASK(9, 0)
+#define DPU_CTL_REG__nml_scl_en_WORD   0
+#define DPU_CTL_REG__nml_scl_en_MASK   GENMASK(13, 10)
+#define DPU_CTL_REG__nml_outctl_en_WORD        0
+#define DPU_CTL_REG__nml_outctl_en_MASK        GENMASK(18, 18)
+#define DPU_CTL_REG__nml_frm_timing_en_WORD    0
+#define DPU_CTL_REG__nml_frm_timing_en_MASK    GENMASK(25, 23)
+#define DPU_CTL_REG__both_cfg_rdy_WORD 2
+#define DPU_CTL_REG__both_cfg_rdy_MASK GENMASK(0, 0)
+#define DPU_CTL_REG__video_mod_WORD    3
+#define DPU_CTL_REG__video_mod_MASK    GENMASK(0, 0)
+#define DPU_CTL_REG__dbg_mod_WORD      3
+#define DPU_CTL_REG__dbg_mod_MASK      GENMASK(1, 1)
+#define DPU_CTL_REG__timing_inter0_WORD        3
+#define DPU_CTL_REG__timing_inter0_MASK        GENMASK(7, 2)
+#define DPU_CTL_REG__timing_inter1_WORD        3
+#define DPU_CTL_REG__timing_inter1_MASK        GENMASK(13, 8)
+#define DPU_CTL_REG__sw_start_WORD     4
+#define DPU_CTL_REG__sw_start_MASK     GENMASK(0, 0)
+#define DPU_CTL_REG__nml_rch_vrt_reuse_WORD    7
+#define DPU_CTL_REG__nml_rch_vrt_reuse_MASK    GENMASK(9, 0)
+
+/* DPU_CTL_TOP_REG: 53 x 32-bit registers */
+#define DPU_CTL_TOP_REG__NWORDS        53
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_0__cmdlist_rch_en_WORD(i)     (0 + 
(i))
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_0__cmdlist_rch_en_MASK        
GENMASK(0, 0)
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_10__cmdlist_cmps_other_en_WORD(i)     
(10 + (i))
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_10__cmdlist_cmps_other_en_MASK        
GENMASK(0, 0)
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_10__cmdlist_cmps_top_en_WORD(i)       
(10 + (i))
+#define DPU_CTL_TOP_REG__dpu_ctl_top_reg_10__cmdlist_cmps_top_en_MASK  
GENMASK(1, 1)
+
+/* DPU_INTP_REG: 50 x 32-bit registers */
+#define DPU_INTP_REG__NWORDS   50
+
+/* EE_REG: 51 x 32-bit registers */
+#define EE_REG__NWORDS 51
+#define EE_REG__m_benable_WORD 0
+#define EE_REG__m_benable_MASK GENMASK(0, 0)
+
+/* MMU_TBU_REG: 21 x 32-bit registers */
+#define MMU_TBU_REG__NWORDS    21
+#define MMU_TBU_REG__tbu_base_addr0_low_WORD   1
+#define MMU_TBU_REG__tbu_base_addr0_low_MASK   GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_base_addr0_high_WORD  2
+#define MMU_TBU_REG__tbu_base_addr0_high_MASK  GENMASK(11, 0)
+#define MMU_TBU_REG__tbu_base_addr1_low_WORD   3
+#define MMU_TBU_REG__tbu_base_addr1_low_MASK   GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_base_addr1_high_WORD  4
+#define MMU_TBU_REG__tbu_base_addr1_high_MASK  GENMASK(11, 0)
+#define MMU_TBU_REG__tbu_base_addr2_low_WORD   5
+#define MMU_TBU_REG__tbu_base_addr2_low_MASK   GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_base_addr2_high_WORD  6
+#define MMU_TBU_REG__tbu_base_addr2_high_MASK  GENMASK(11, 0)
+#define MMU_TBU_REG__tbu_va0_WORD      7
+#define MMU_TBU_REG__tbu_va0_MASK      GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_va1_WORD      8
+#define MMU_TBU_REG__tbu_va1_MASK      GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_va2_WORD      9
+#define MMU_TBU_REG__tbu_va2_MASK      GENMASK(31, 0)
+#define MMU_TBU_REG__tbu_size0_WORD    10
+#define MMU_TBU_REG__tbu_size0_MASK    GENMASK(15, 0)
+#define MMU_TBU_REG__tbu_size1_WORD    11
+#define MMU_TBU_REG__tbu_size1_MASK    GENMASK(15, 0)
+#define MMU_TBU_REG__tbu_size2_WORD    12
+#define MMU_TBU_REG__tbu_size2_MASK    GENMASK(15, 0)
+#define MMU_TBU_REG__vsync_update_en_WORD      13
+#define MMU_TBU_REG__vsync_update_en_MASK      GENMASK(1, 1)
+
+/* MMU_TOP_REG: 23 x 32-bit registers */
+#define MMU_TOP_REG__NWORDS    23
+#define MMU_TOP_REG__rdma_timelimit_WORD       0
+#define MMU_TOP_REG__rdma_timelimit_MASK       GENMASK(31, 16)
+#define MMU_TOP_REG__sram0_tlb_axi_port_sel_WORD       1
+#define MMU_TOP_REG__sram0_tlb_axi_port_sel_MASK       GENMASK(1, 0)
+#define MMU_TOP_REG__sram1_tlb_axi_port_sel_WORD       1
+#define MMU_TOP_REG__sram1_tlb_axi_port_sel_MASK       GENMASK(3, 2)
+#define MMU_TOP_REG__dmac0_rd_outs_num_WORD    2
+#define MMU_TOP_REG__dmac0_rd_outs_num_MASK    GENMASK(7, 0)
+#define MMU_TOP_REG__dmac1_rd_outs_num_WORD    3
+#define MMU_TOP_REG__dmac1_rd_outs_num_MASK    GENMASK(7, 0)
+
+/* POSTPIPE_REG: 50 x 32-bit registers */
+#define POSTPIPE_REG__NWORDS   50
+#define POSTPIPE_REG__m_inwidth_WORD   13
+#define POSTPIPE_REG__m_inwidth_MASK   GENMASK(15, 0)
+#define POSTPIPE_REG__m_inheight_WORD  13
+#define POSTPIPE_REG__m_inheight_MASK  GENMASK(31, 16)
+
+/* RDMA_PATH_X_REG: 60 x 32-bit registers */
+#define RDMA_PATH_X_REG__NWORDS        60
+#define RDMA_PATH_X_REG__layer_mode_WORD       0
+#define RDMA_PATH_X_REG__layer_mode_MASK       GENMASK(1, 0)
+#define RDMA_PATH_X_REG__layer_cmpsr_id_WORD   0
+#define RDMA_PATH_X_REG__layer_cmpsr_id_MASK   GENMASK(15, 13)
+#define RDMA_PATH_X_REG__is_two_layers_WORD    1
+#define RDMA_PATH_X_REG__is_two_layers_MASK    GENMASK(0, 0)
+#define RDMA_PATH_X_REG__is_offline_WORD       1
+#define RDMA_PATH_X_REG__is_offline_MASK       GENMASK(1, 1)
+#define RDMA_PATH_X_REG__base_addr0_low_ly0_WORD       9
+#define RDMA_PATH_X_REG__base_addr0_low_ly0_MASK       GENMASK(31, 0)
+#define RDMA_PATH_X_REG__base_addr0_high_ly0_WORD      10
+#define RDMA_PATH_X_REG__base_addr0_high_ly0_MASK      GENMASK(1, 0)
+#define RDMA_PATH_X_REG__base_addr1_low_ly0_WORD       11
+#define RDMA_PATH_X_REG__base_addr1_low_ly0_MASK       GENMASK(31, 0)
+#define RDMA_PATH_X_REG__base_addr1_high_ly0_WORD      12
+#define RDMA_PATH_X_REG__base_addr1_high_ly0_MASK      GENMASK(1, 0)
+#define RDMA_PATH_X_REG__base_addr2_low_ly0_WORD       13
+#define RDMA_PATH_X_REG__base_addr2_low_ly0_MASK       GENMASK(31, 0)
+#define RDMA_PATH_X_REG__base_addr2_high_ly0_WORD      14
+#define RDMA_PATH_X_REG__base_addr2_high_ly0_MASK      GENMASK(1, 0)
+#define RDMA_PATH_X_REG__rdma_stride0_layer0_WORD      15
+#define RDMA_PATH_X_REG__rdma_stride0_layer0_MASK      GENMASK(15, 0)
+#define RDMA_PATH_X_REG__rdma_stride1_layer0_WORD      15
+#define RDMA_PATH_X_REG__rdma_stride1_layer0_MASK      GENMASK(31, 16)
+#define RDMA_PATH_X_REG__img_width_ly0_WORD    16
+#define RDMA_PATH_X_REG__img_width_ly0_MASK    GENMASK(15, 0)
+#define RDMA_PATH_X_REG__img_height_ly0_WORD   16
+#define RDMA_PATH_X_REG__img_height_ly0_MASK   GENMASK(31, 16)
+#define RDMA_PATH_X_REG__bbox_start_x_ly0_WORD 17
+#define RDMA_PATH_X_REG__bbox_start_x_ly0_MASK GENMASK(15, 0)
+#define RDMA_PATH_X_REG__bbox_start_y_ly0_WORD 17
+#define RDMA_PATH_X_REG__bbox_start_y_ly0_MASK GENMASK(31, 16)
+#define RDMA_PATH_X_REG__bbox_end_x_ly0_WORD   18
+#define RDMA_PATH_X_REG__bbox_end_x_ly0_MASK   GENMASK(15, 0)
+#define RDMA_PATH_X_REG__bbox_end_y_ly0_WORD   18
+#define RDMA_PATH_X_REG__bbox_end_y_ly0_MASK   GENMASK(31, 16)
+#define RDMA_PATH_X_REG__pixel_format_WORD     29
+#define RDMA_PATH_X_REG__pixel_format_MASK     GENMASK(5, 0)
+#define RDMA_PATH_X_REG__uv_swap_WORD  29
+#define RDMA_PATH_X_REG__uv_swap_MASK  GENMASK(6, 6)
+#define RDMA_PATH_X_REG__rot_mode_ly0_WORD     29
+#define RDMA_PATH_X_REG__rot_mode_ly0_MASK     GENMASK(10, 8)
+
+/* TMG_REG: 30 x 32-bit registers */
+#define TMG_REG__NWORDS        30
+#define TMG_REG__split_en_WORD 0
+#define TMG_REG__split_en_MASK GENMASK(0, 0)
+#define TMG_REG__cmd_screen_WORD       0
+#define TMG_REG__cmd_screen_MASK       GENMASK(1, 1)
+#define TMG_REG__fm_timing_en_WORD     0
+#define TMG_REG__fm_timing_en_MASK     GENMASK(2, 2)
+#define TMG_REG__cmd_wait_en_WORD      0
+#define TMG_REG__cmd_wait_en_MASK      GENMASK(3, 3)
+#define TMG_REG__cmd_wait_te_WORD      0
+#define TMG_REG__cmd_wait_te_MASK      GENMASK(4, 4)
+#define TMG_REG__disp_ready_man_en_WORD        0
+#define TMG_REG__disp_ready_man_en_MASK        GENMASK(5, 5)
+#define TMG_REG__hsp_WORD      0
+#define TMG_REG__hsp_MASK      GENMASK(7, 7)
+#define TMG_REG__vsp_WORD      0
+#define TMG_REG__vsp_MASK      GENMASK(8, 8)
+#define TMG_REG__user_WORD     2
+#define TMG_REG__user_MASK     GENMASK(15, 12)
+#define TMG_REG__hfp_WORD      3
+#define TMG_REG__hfp_MASK      GENMASK(27, 16)
+#define TMG_REG__hsync_width_WORD      4
+#define TMG_REG__hsync_width_MASK      GENMASK(9, 0)
+#define TMG_REG__hbp_WORD      4
+#define TMG_REG__hbp_MASK      GENMASK(27, 16)
+#define TMG_REG__vfp_WORD      5
+#define TMG_REG__vfp_MASK      GENMASK(15, 0)
+#define TMG_REG__vsync_width_WORD      5
+#define TMG_REG__vsync_width_MASK      GENMASK(25, 16)
+#define TMG_REG__vbp_WORD      6
+#define TMG_REG__vbp_MASK      GENMASK(11, 0)
+#define TMG_REG__h_active_WORD 6
+#define TMG_REG__h_active_MASK GENMASK(29, 16)
+#define TMG_REG__v_active_WORD 7
+#define TMG_REG__v_active_MASK GENMASK(13, 0)
+#define TMG_REG__background_r_WORD     9
+#define TMG_REG__background_r_MASK     GENMASK(11, 0)
+#define TMG_REG__background_g_WORD     9
+#define TMG_REG__background_g_MASK     GENMASK(27, 16)
+#define TMG_REG__background_b_WORD     10
+#define TMG_REG__background_b_MASK     GENMASK(11, 0)
+#define TMG_REG__eof_1st_ln_dly_num_WORD       11
+#define TMG_REG__eof_1st_ln_dly_num_MASK       GENMASK(15, 0)
+#define TMG_REG__eof_2nd_ln_dly_num_WORD       11
+#define TMG_REG__eof_2nd_ln_dly_num_MASK       GENMASK(31, 16)
+#define TMG_REG__sof_pre_ln_num_WORD   14
+#define TMG_REG__sof_pre_ln_num_MASK   GENMASK(16, 0)
+
+#endif /* SATURN_FIELDS_H */
diff --git a/drivers/gpu/drm/spacemit/spacemit_dpu_ids.h 
b/drivers/gpu/drm/spacemit/spacemit_dpu_ids.h
new file mode 100644
index 000000000000..41014dda927b
--- /dev/null
+++ b/drivers/gpu/drm/spacemit/spacemit_dpu_ids.h
@@ -0,0 +1,22 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright (C) 2025-2026 SpacemiT Co., Ltd.
+ */
+
+#ifndef _SPACEMIT_DPU_IDS_H_
+#define _SPACEMIT_DPU_IDS_H_
+
+/* Saturn online compositor instance ids (hardware IRQ-table indices). */
+#define COMPOSER0      0
+#define COMPOSER1      1
+#define COMPOSER2      2
+#define COMPOSER3      3
+
+/* DPU output-format field encoding (dpuctrl out-format register). */
+#define OUTFMT_RGB121212       0
+#define OUTFMT_RGB101010       1
+#define OUTFMT_RGB888          2
+#define OUTFMT_RGB666          12
+#define OUTFMT_RGB565          13
+
+#endif /* _SPACEMIT_DPU_IDS_H_ */

-- 
2.43.0


Reply via email to