/* * Copyright (C) 2010-2016 Freescale Semiconductor, Inc. * Copyright 2017 NXP * * SPDX-License-Identifier: GPL-2.0+ */ #ifndef FSL_FASTBOOT_H #define FSL_FASTBOOT_H #include #include #define FASTBOOT_PTENTRY_FLAGS_REPEAT(n) (n & 0x0f) #define FASTBOOT_PTENTRY_FLAGS_REPEAT_MASK 0x0000000F /* Writes happen a block at a time. If the write fails, go to next block NEXT_GOOD_BLOCK and CONTIGOUS_BLOCK can not both be set */ #define FASTBOOT_PTENTRY_FLAGS_WRITE_NEXT_GOOD_BLOCK 0x00000010 /* Find a contiguous block big enough for a the whole file NEXT_GOOD_BLOCK and CONTIGOUS_BLOCK can not both be set */ #define FASTBOOT_PTENTRY_FLAGS_WRITE_CONTIGUOUS_BLOCK 0x00000020 /* Write the file with write.i */ #define FASTBOOT_PTENTRY_FLAGS_WRITE_I 0x00000100 /* Write the file with write.trimffs */ #define FASTBOOT_PTENTRY_FLAGS_WRITE_TRIMFFS 0x00000200 /* Write the file as a series of variable/value pairs using the setenv and saveenv commands */ #define FASTBOOT_PTENTRY_FLAGS_WRITE_ENV 0x00000400 /* Uneraseable partition */ #define FASTBOOT_PTENTRY_FLAGS_UNERASEABLE 0x00000800 #define FASTBOOT_MMC_BOOT_PARTITION_ID 1 #define FASTBOOT_MMC_USER_PARTITION_ID 0 #define FASTBOOT_MMC_NONE_PARTITION_ID -1 #define FASTBOOT_MMC_BOOT1_PARTITION_ID 2 #define FASTBOOT_PARTITION_TEE "tos" #define FASTBOOT_PARTITION_PRDATA "presistdata" #ifdef CONFIG_AVB_SUPPORT #define FASTBOOT_PARTITION_AVBKEY "avbkey" #endif #ifdef CONFIG_FLASH_MCUFIRMWARE_SUPPORT #define FASTBOOT_MCU_FIRMWARE_PARTITION "m4_os" #endif #ifdef CONFIG_ANDROID_AB_SUPPORT #define FASTBOOT_PARTITION_BOOT_A "boot_a" #define FASTBOOT_PARTITION_RECOVERY "recovery" #define FASTBOOT_PARTITION_SYSTEM_A "system_a" #define FASTBOOT_PARTITION_BOOTLOADER "bootloader0" #define FASTBOOT_PARTITION_DATA "userdata" #define FASTBOOT_PARTITION_BOOT_B "boot_b" #define FASTBOOT_PARTITION_SYSTEM_B "system_b" #define FASTBOOT_PARTITION_OEM_A "oem_a" #define FASTBOOT_PARTITION_VENDOR_A "vendor_a" #define FASTBOOT_PARTITION_OEM_B "oem_b" #define FASTBOOT_PARTITION_VENDOR_B "vendor_b" #ifdef CONFIG_AVB_SUPPORT #define FASTBOOT_PARTITION_VBMETA_A "vbmeta_a" #define FASTBOOT_PARTITION_VBMETA_B "vbmeta_b" #endif #define FASTBOOT_PARTITION_MISC "misc" #define FASTBOOT_PARTITION_GPT "gpt" #define FASTBOOT_PARTITION_FBMISC "fbmisc" #else #define FASTBOOT_PARTITION_BOOT "boot" #define FASTBOOT_PARTITION_RECOVERY "recovery" #define FASTBOOT_PARTITION_SYSTEM "system" #define FASTBOOT_PARTITION_CACHE "cache" #define FASTBOOT_PARTITION_DEVICE "device" #define FASTBOOT_PARTITION_BOOTLOADER "bootloader" #define FASTBOOT_PARTITION_DATA "userdata" #define FASTBOOT_PARTITION_GPT "gpt" #define FASTBOOT_PARTITION_MISC "misc" #define FASTBOOT_PARTITION_FBMISC "fbmisc" #endif #ifdef CONFIG_IMX_TRUSTY_OS #ifndef CONFIG_AVB_ATX #define FASTBOOT_SET_RPMB_KEY "set-rpmb-key" #define FASTBOOT_SET_RPMB_RANDOM_KEY "set-rpmb-random-key" #define FASTBOOT_SET_VBMETA_PUBLIC_KEY "set-public-key" #endif #define FASTBOOT_SET_CA_RESP "at-set-ca-response" #define FASTBOOT_GET_CA_REQ "at-get-ca-request" #define FASTBOOT_SET_RSA_ATTESTATION_KEY "set-rsa-atte-key" #define FASTBOOT_SET_EC_ATTESTATION_KEY "set-ec-atte-key" #define FASTBOOT_APPEND_RSA_ATTESTATION_CERT "append-rsa-atte-cert" #define FASTBOOT_APPEND_EC_ATTESTATION_CERT "append-ec-atte-cert" #endif #ifdef CONFIG_ANDROID_THINGS_SUPPORT #define FASTBOOT_BOOTLOADER_VBOOT_KEY "fuse at-bootloader-vboot-key" #ifdef CONFIG_AVB_ATX #define FASTBOOT_AVB_AT_PERM_ATTR "fuse at-perm-attr" #define FASTBOOT_AT_UNLOCK_VBOOT "at-unlock-vboot" #define FASTBOOT_AT_LOCK_VBOOT "at-lock-vboot" #define FASTBOOT_AT_DISABLE_UNLOCK_VBOOT "at-disable-unlock-vboot" #define FASTBOOT_AT_GET_UNLOCK_CHALLENGE "at-get-vboot-unlock-challenge" #endif /* CONFIG_AVB_ATX */ #endif /* CONFIG_ANDROID_THINGS_SUPPORT */ enum { DEV_SATA, DEV_MMC, DEV_NAND, #ifdef CONFIG_FLASH_MCUFIRMWARE_SUPPORT /* SPI Flash */ DEV_SF #endif }; typedef enum { #ifdef CONFIG_ANDROID_RECOVERY /* Revoery boot due to combo keys pressed */ BOOTMODE_RECOVERY_KEY_PRESSED, /* Recovery boot due to boot-recovery cmd in misc parition */ BOOTMODE_RECOVERY_BCB_CMD, #endif /* Fastboot boot due to bootonce-bootloader cmd in misc parition */ BOOTMODE_FASTBOOT_BCB_CMD, /* Normal boot */ BOOTMODE_NORMAL }FbBootMode; struct cmd_fastboot_interface { /* This function is called when a buffer has been recieved from the client app. The buffer is a supplied by the board layer and must be unmodified. The buffer_size is how much data is passed in. Returns 0 on success Returns 1 on failure Set by cmd_fastboot */ int (*rx_handler)(const unsigned char *buffer, unsigned int buffer_size); /* This function is called when an exception has occurred in the device code and the state off fastboot needs to be reset Set by cmd_fastboot */ void (*reset_handler)(void); /* A getvar string for the product name It can have a maximum of 60 characters Set by board */ char *product_name; /* A getvar string for the serial number It can have a maximum of 60 characters Set by board */ char *serial_no; /* Nand block size Supports the write option WRITE_NEXT_GOOD_BLOCK Set by board */ unsigned int nand_block_size; /* Nand oob size Set by board */ unsigned int nand_oob_size; /* Transfer buffer, for handling flash updates Should be multiple of the nand_block_size Care should be take so it does not overrun bootloader memory Controlled by the configure variable CFG_FASTBOOT_TRANSFER_BUFFER Set by board */ unsigned char *transfer_buffer; /* How big is the transfer buffer Controlled by the configure variable CFG_FASTBOOT_TRANSFER_BUFFER_SIZE Set by board */ unsigned int transfer_buffer_size; }; /* flash partitions are defined in terms of blocks ** (flash erase units) */ struct fastboot_ptentry { /* The logical name for this partition, null terminated */ char name[20]; /* The start wrt the nand part, must be multiple of nand block size */ unsigned int start; /* The length of the partition, must be multiple of nand block size */ unsigned int length; /* Controls the details of how operations are done on the partition See the FASTBOOT_PTENTRY_FLAGS_*'s defined below */ unsigned int flags; /* partition id: 0 - normal partition; 1 - boot partition */ unsigned int partition_id; /* partition number in block device */ unsigned int partition_index; /* partition file system type in string */ char fstype[16]; /* filesystem UUID as string, if exists */ #ifdef CONFIG_PARTITION_UUIDS char uuid[37]; #endif }; struct fastboot_device_info { unsigned char type; unsigned char dev_id; }; extern struct fastboot_device_info fastboot_devinfo; /* Prepare the fastboot environments, * should be executed before "fastboot" cmd */ void fastboot_setup(void); /* The Android-style flash handling */ /* tools to populate and query the partition table */ void fastboot_flash_add_ptn(struct fastboot_ptentry *ptn); struct fastboot_ptentry *fastboot_flash_find_ptn(const char *name); struct fastboot_ptentry *fastboot_flash_get_ptn(unsigned n); unsigned int fastboot_flash_get_ptn_count(void); void fastboot_flash_dump_ptn(void); /* Make board into special boot mode */ void fastboot_run_bootmode(void); /*Setup board-relative fastboot environment */ void board_fastboot_setup(void); /*return partition index according name*/ int fastboot_flash_find_index(const char *name); /*check whether bootloader is overlay with GPT table*/ bool bootloader_gpt_overlay(void); /* Check whether the combo keys pressed * Return 1 if combo keys pressed for recovery boot * Return 0 if no combo keys pressed */ int is_recovery_key_pressing(void); #ifdef CONFIG_FASTBOOT_STORAGE_NAND /*Save parameters for NAND storage partitions */ void save_parts_values(struct fastboot_ptentry *ptn, unsigned int offset, unsigned int size); /* Checks parameters for NAND storage partitions * Return 1 if the parameter is not set * Return 0 if the parameter has been set */ int check_parts_values(struct fastboot_ptentry *ptn); #endif /*CONFIG_FASTBOOT_STORAGE_NAND*/ /* Reads |num_bytes| from offset |offset| from partition with name * |partition| (NUL-terminated UTF-8 string). If |offset| is * negative, its absolute value should be interpreted as the number * of bytes from the end of the partition. * It's basically copied from fsl_read_from_partition_multi() because * we may want to read partition when AVB is not enabled. */ int read_from_partition_multi(const char* partition, int64_t offset, size_t num_bytes,void* buffer, size_t* out_num_read); #endif /* FSL_FASTBOOT_H */