154 lines
5.1 KiB
C
154 lines
5.1 KiB
C
/*
|
|
* Copyright (c) 2014, NVIDIA CORPORATION. All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
* DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef __NVKM_SECBOOT_LS_UCODE_H__
|
|
#define __NVKM_SECBOOT_LS_UCODE_H__
|
|
|
|
#include <core/os.h>
|
|
#include <core/subdev.h>
|
|
#include <subdev/secboot.h>
|
|
|
|
|
|
/**
|
|
* struct ls_ucode_img_desc - descriptor of firmware image
|
|
* @descriptor_size: size of this descriptor
|
|
* @image_size: size of the whole image
|
|
* @bootloader_start_offset: start offset of the bootloader in ucode image
|
|
* @bootloader_size: size of the bootloader
|
|
* @bootloader_imem_offset: start off set of the bootloader in IMEM
|
|
* @bootloader_entry_point: entry point of the bootloader in IMEM
|
|
* @app_start_offset: start offset of the LS firmware
|
|
* @app_size: size of the LS firmware's code and data
|
|
* @app_imem_offset: offset of the app in IMEM
|
|
* @app_imem_entry: entry point of the app in IMEM
|
|
* @app_dmem_offset: offset of the data in DMEM
|
|
* @app_resident_code_offset: offset of app code from app_start_offset
|
|
* @app_resident_code_size: size of the code
|
|
* @app_resident_data_offset: offset of data from app_start_offset
|
|
* @app_resident_data_size: size of data
|
|
*
|
|
* A firmware image contains the code, data, and bootloader of a given LS
|
|
* falcon in a single blob. This structure describes where everything is.
|
|
*
|
|
* This can be generated from a (bootloader, code, data) set if they have
|
|
* been loaded separately, or come directly from a file.
|
|
*/
|
|
struct ls_ucode_img_desc {
|
|
u32 descriptor_size;
|
|
u32 image_size;
|
|
u32 tools_version;
|
|
u32 app_version;
|
|
char date[64];
|
|
u32 bootloader_start_offset;
|
|
u32 bootloader_size;
|
|
u32 bootloader_imem_offset;
|
|
u32 bootloader_entry_point;
|
|
u32 app_start_offset;
|
|
u32 app_size;
|
|
u32 app_imem_offset;
|
|
u32 app_imem_entry;
|
|
u32 app_dmem_offset;
|
|
u32 app_resident_code_offset;
|
|
u32 app_resident_code_size;
|
|
u32 app_resident_data_offset;
|
|
u32 app_resident_data_size;
|
|
u32 nb_overlays;
|
|
struct {u32 start; u32 size; } load_ovl[64];
|
|
u32 compressed;
|
|
};
|
|
|
|
/**
|
|
* struct ls_ucode_img - temporary storage for loaded LS firmwares
|
|
* @node: to link within lsf_ucode_mgr
|
|
* @falcon_id: ID of the falcon this LS firmware is for
|
|
* @ucode_desc: loaded or generated map of ucode_data
|
|
* @ucode_data: firmware payload (code and data)
|
|
* @ucode_size: size in bytes of data in ucode_data
|
|
* @ucode_off: offset of the ucode in ucode_data
|
|
* @sig: signature for this firmware
|
|
* @sig:size: size of the signature in bytes
|
|
*
|
|
* Preparing the WPR LS blob requires information about all the LS firmwares
|
|
* (size, etc) to be known. This structure contains all the data of one LS
|
|
* firmware.
|
|
*/
|
|
struct ls_ucode_img {
|
|
struct list_head node;
|
|
enum nvkm_secboot_falcon falcon_id;
|
|
|
|
struct ls_ucode_img_desc ucode_desc;
|
|
u8 *ucode_data;
|
|
u32 ucode_size;
|
|
u32 ucode_off;
|
|
|
|
u8 *sig;
|
|
u32 sig_size;
|
|
};
|
|
|
|
/**
|
|
* struct fw_bin_header - header of firmware files
|
|
* @bin_magic: always 0x3b1d14f0
|
|
* @bin_ver: version of the bin format
|
|
* @bin_size: entire image size including this header
|
|
* @header_offset: offset of the firmware/bootloader header in the file
|
|
* @data_offset: offset of the firmware/bootloader payload in the file
|
|
* @data_size: size of the payload
|
|
*
|
|
* This header is located at the beginning of the HS firmware and HS bootloader
|
|
* files, to describe where the headers and data can be found.
|
|
*/
|
|
struct fw_bin_header {
|
|
u32 bin_magic;
|
|
u32 bin_ver;
|
|
u32 bin_size;
|
|
u32 header_offset;
|
|
u32 data_offset;
|
|
u32 data_size;
|
|
};
|
|
|
|
/**
|
|
* struct fw_bl_desc - firmware bootloader descriptor
|
|
* @start_tag: starting tag of bootloader
|
|
* @desc_dmem_load_off: DMEM offset of flcn_bl_dmem_desc
|
|
* @code_off: offset of code section
|
|
* @code_size: size of code section
|
|
* @data_off: offset of data section
|
|
* @data_size: size of data section
|
|
*
|
|
* This structure is embedded in bootloader firmware files at to describe the
|
|
* IMEM and DMEM layout expected by the bootloader.
|
|
*/
|
|
struct fw_bl_desc {
|
|
u32 start_tag;
|
|
u32 dmem_load_off;
|
|
u32 code_off;
|
|
u32 code_size;
|
|
u32 data_off;
|
|
u32 data_size;
|
|
};
|
|
|
|
int acr_ls_ucode_load_fecs(const struct nvkm_subdev *, struct ls_ucode_img *);
|
|
int acr_ls_ucode_load_gpccs(const struct nvkm_subdev *, struct ls_ucode_img *);
|
|
|
|
|
|
#endif
|