MCUPM is a hardware module which is used for MCUSYS Power Management. MCUPM firmware (mcupm.bin) is loaded into MCUPM SRAM at system initialization.
Coreboot will load MCUPM at ramstage. It will copy mcupm.bin to MCUPM SRAM.
mcupm.binUse CBFS to load mcupm.bin, then set normal boot flag and release software reset pin of MCUPM.
No return value.
$ strings mcupm.bin | grep "MCUPM firmware"
SSPM is “Secure System Power Manager” that provides power control in secure domain. SSPM provides power related features, e.g. CPU DVFS, thermal control, to offload application processor for security reason.
SSPM firmware is loaded into SSPM SRAM at system initialization.
Coreboot will load sspm.bin to SSPM SRAM at ramstage.
sspm.binUse CBFS to load sspm.bin. No need to pass other parameters to SSPM.
No return value.
$ strings sspm.bin | grep "SSPM firmware"
SPM is able to turn off more power such as DRAM self-refresh mode and 26M clock off when system is in suspend. Also, SPM helps support Vcore DVFS feature.
Linux kernel system suspend and Vcore DVFS.
spm_fimware.binUse CBFS to load spm_fimware.bin to DRAM and SPM DMA loads it from dram to SPM SRAM.
No return value.
$ strings spm_firmware.bin | grep pcm_suspend
dram.elf introductiondram.elf is an ELF format file, which performs DRAM full calibration and returns the trained calibration parameters to the caller. The caller may store the parameters on NOR/NAND or eMMC for faster subsequent bootups.
Coreboot loads dram.elf during the first bootup if no valid DRAM parameters are found on NOR/NAND or eMMC.
dram.elfCoreboot locates dram.elf file, locates the entry point _start, passes a dramc_param struct argument dparam to it, and calls _start(&dparam) to execute dram.elf.
struct dramc_param {
struct dramc_param_header header; // see below
void (*do_putc)(unsigned char c);
struct dramc_data dramc_datas; // see below
};
Below shows the internal structure of dramc_param:
struct dramc_param_header {
u16 version; /* DRAMC_PARAM_HEADER_VERSION, update in the coreboot */
u16 size; /* size of whole dramc_param, update in the coreboot */
u16 status; /* DRAMC_PARAM_STATUS_CODES, update in the dram blob */
u16 flags; /* DRAMC_PARAM_FLAGS, update in the dram blob */
};
struct sdram_info {
u32 ddr_type; /* SDRAM_DDR_TYPE */
u32 ddr_geometry; /* SDRAM_DDR_GEOMETRY_TYPE */
};
struct sdram_params {
u32 rank_num;
u16 num_dlycell_perT;
u16 delay_cell_timex100;
/* duty */
s8 duty_clk_delay[CHANNEL_MAX][RANK_MAX];
s8 duty_dqs_delay[CHANNEL_MAX][DQS_NUMBER_LP4];
s8 duty_wck_delay[CHANNEL_MAX][DQS_NUMBER_LP4];
.......
.......
};
struct emi_mdl {
u32 cona_val;
u32 conh_val;
u32 conf_val;
u32 chn_cona_val;
};
struct ddr_base_info {
u32 config_dvfs; /* SDRAM_DVFS_FLAG */
struct sdram_info sdram;
u32 voltage_type; /* SDRAM_VOLTAGE_TYPE */
u32 support_ranks;
u64 rank_size[RANK_MAX];
struct emi_mdl emi_config;
DRAM_CBT_MODE_T cbt_mode[RANK_MAX];
};
struct dramc_data {
struct ddr_base_info ddr_info;
struct sdram_params freq_params[DRAM_DFS_SHU_MAX];
};
dram.elfdram.elf configures suitable dramc settings and returns the DRAM parameters. Then, Coreboot saves the parameters on the specified firmware flash section: "RW_MRC_CACHE".
0 on success; < 0 on failure.
$ strings dram.elf | grep "firmware version"
DPM is a hardware module for DRAM Power Management, which is used for DRAM low power. For example: self refresh, disable PLL/DLL when not in use.
DPM includes two parts of images: data part (dpm.dm) and program part (dpm.pm).
Coreboot loads dpm at ramstage, and copies dpm.dm & dpm.pm to DPM SRAM.
Use CBFS to load dpm.dm and dpm.pm. No need to pass other parameters to DPM.
No return value.
$ echo -n 'DPMD Firmware version: x.x' >> dpm.dm $ echo -n 'DPMP Firmware version: x.x' >> dpm.pm
$ strings dpm.dm | grep version $ strings dpm.pm | grep version