u-boot/arch/arm/include/asm/arch-tegra/warmboot.h
Heinrich Schuchardt 185f812c41 doc: replace @return by Return:
Sphinx expects Return: and not @return to indicate a return value.

find . -name '*.c' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

find . -name '*.h' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
2022-01-19 18:11:34 +01:00

133 lines
2.8 KiB
C

/* SPDX-License-Identifier: GPL-2.0+ */
/*
* (C) Copyright 2010, 2011
* NVIDIA Corporation <www.nvidia.com>
*/
#ifndef _WARM_BOOT_H_
#define _WARM_BOOT_H_
#define STRAP_OPT_A_RAM_CODE_SHIFT 4
#define STRAP_OPT_A_RAM_CODE_MASK (0xf << STRAP_OPT_A_RAM_CODE_SHIFT)
/* Defines the supported operating modes */
enum fuse_operating_mode {
MODE_PRODUCTION = 3,
MODE_UNDEFINED,
};
/* Defines the CMAC-AES-128 hash length in 32 bit words. (128 bits = 4 words) */
enum {
HASH_LENGTH = 4
};
/* Defines the storage for a hash value (128 bits) */
struct hash {
u32 hash[HASH_LENGTH];
};
/*
* Defines the code header information for the boot rom.
*
* The code immediately follows the code header.
*
* Note that the code header needs to be 16 bytes aligned to preserve
* the alignment of relevant data for hash and decryption computations without
* requiring extra copies to temporary memory areas.
*/
struct wb_header {
u32 length_insecure; /* length of the code header */
u32 reserved[3];
struct hash hash; /* hash of header+code, starts next field*/
struct hash random_aes_block; /* a data block to aid security. */
u32 length_secure; /* length of the code header */
u32 destination; /* destination address to put the wb code */
u32 entry_point; /* execution address of the wb code */
u32 code_length; /* length of the code */
};
/*
* The warm boot code needs direct access to these registers since it runs in
* SRAM and cannot call other U-Boot code.
*/
union osc_ctrl_reg {
struct {
u32 xoe:1;
u32 xobp:1;
u32 reserved0:2;
u32 xofs:6;
u32 reserved1:2;
u32 xods:5;
u32 reserved2:3;
u32 oscfi_spare:8;
u32 pll_ref_div:2;
u32 osc_freq:2;
};
u32 word;
};
union pllx_base_reg {
struct {
u32 divm:5;
u32 reserved0:3;
u32 divn:10;
u32 reserved1:2;
u32 divp:3;
u32 reserved2:4;
u32 lock:1;
u32 reserved3:1;
u32 ref_dis:1;
u32 enable:1;
u32 bypass:1;
};
u32 word;
};
union pllx_misc_reg {
struct {
u32 vcocon:4;
u32 lfcon:4;
u32 cpcon:4;
u32 lock_sel:6;
u32 reserved0:1;
u32 lock_enable:1;
u32 reserved1:1;
u32 dccon:1;
u32 pts:2;
u32 reserved2:6;
u32 out1_div_byp:1;
u32 out1_inv_clk:1;
};
u32 word;
};
/*
* TODO: This register is not documented in the TRM yet. We could move this
* into the EMC and give it a proper interface, but not while it is
* undocumented.
*/
union scratch3_reg {
struct {
u32 pllx_base_divm:5;
u32 pllx_base_divn:10;
u32 pllx_base_divp:3;
u32 pllx_misc_lfcon:4;
u32 pllx_misc_cpcon:4;
};
u32 word;
};
/**
* Save warmboot memory settings for a later resume
*
* Return: 0 if ok, -1 on error
*/
int warmboot_save_sdram_params(void);
int warmboot_prepare_code(u32 seg_address, u32 seg_length);
int sign_data_block(u8 *source, u32 length, u8 *signature);
void wb_start(void); /* Start of WB assembly code */
void wb_end(void); /* End of WB assembly code */
#endif