Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | /* SPDX-License-Identifier: GPL-2.0+ */ /* * (C) Copyright 2015 Google, Inc * Written by Simon Glass <sjg@chromium.org> */ #ifndef _RKCOMMON_H #define _RKCOMMON_H enum { RK_BLK_SIZE = 512, RK_SIZE_ALIGN = 2048, RK_INIT_OFFSET = 4, RK_MAX_BOOT_SIZE = 512 << 10, RK_SPL_HDR_START = RK_INIT_OFFSET * RK_BLK_SIZE, RK_SPL_HDR_SIZE = 4, }; /** * rkcommon_check_params() - check params * * Return: 0 if OK, -1 if ERROR. */ int rkcommon_check_params(struct imgtool *itl); /** * rkcommon_get_spl_hdr() - get 4-bytes spl hdr for a Rockchip boot image * * Rockchip's bootrom requires the spl loader to start with a 4-bytes * header. The content of this header depends on the chip type. */ const char *rkcommon_get_spl_hdr(struct imgtool *itl); /** * rkcommon_get_spl_size() - get spl size for a Rockchip boot image * * Different chip may have different sram size. And if we want to jump * back to the bootrom after spl, we may need to reserve some sram space * for the bootrom. * The spl loader size should be sram size minus reserved size(if needed) */ int rkcommon_get_spl_size(struct imgtool *itl); /** * rkcommon_set_header() - set up the header for a Rockchip boot image * * This sets up a 2KB header which can be interpreted by the Rockchip boot ROM. * * @buf: Pointer to header place (must be at least 2KB in size) */ void rkcommon_set_header(void *buf, struct stat *sbuf, int ifd, struct imgtool *itl); /** * rkcommon_verify_header() - verify the header for a Rockchip boot image * * @buf: Pointer to the image file * @file_size: Size of entire bootable image file (incl. all padding) * Return: 0 if OK */ int rkcommon_verify_header(unsigned char *buf, int size, struct imgtool *itl); /** * rkcommon_print_header() - print the header for a Rockchip boot image * * This prints the header, spl_name and whether this is a SD/MMC or SPI image. * * @buf: Pointer to the image (can be a read-only file-mapping) */ void rkcommon_print_header(const void *buf, struct imgtool *itl); /** * rkcommon_need_rc4_spl() - check if rc4 encoded spl is required * * Some socs cannot disable the rc4-encryption of the spl binary. * rc4 encryption is disabled normally except on socs that cannot * handle unencrypted binaries. * Return: true or false depending on rc4 being required. */ bool rkcommon_need_rc4_spl(struct imgtool *itl); /** * rkcommon_rc4_encode_spl() - encode the spl binary * * Encrypts the SPL binary using the generic rc4 key as required * by some socs. * * @buf: Pointer to the SPL data (header and SPL binary) * @offset: offset inside buf to start at * @size: number of bytes to encode */ void rkcommon_rc4_encode_spl(void *buf, unsigned int offset, unsigned int size); /** * rkcommon_vrec_header() - allocate memory for the header * * @itl: Pointer to the tool params structure * @tparams: Pointer tot the image type structure (for setting * the header and header_size) * * Return: 0 (always) */ int rkcommon_vrec_header(struct imgtool *itl, struct imgtool_funcs *tparams); #endif |