mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
3349c99882
We fixed some flash bugs in bootloader, but for the users used the old vrsion bootloader, they can not fix these bugs via OTA, the solution is add these updates in app startup. These updates include: 1. SPI flash gpio matrix and drive strength configuration 2. SPI flash clock configuration 3. SPI flash read dummy configuration 4. SPI flash cs timing configuration 5. Update flash id of g_rom_flashchip
118 lines
4.8 KiB
C
118 lines
4.8 KiB
C
// Copyright 2018 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#pragma once
|
|
#include "esp_flash_data_types.h"
|
|
#include "esp_image_format.h"
|
|
|
|
/// Type of hold a GPIO in low state
|
|
typedef enum {
|
|
GPIO_LONG_HOLD = 1, /*!< The long hold GPIO */
|
|
GPIO_SHORT_HOLD = -1, /*!< The short hold GPIO */
|
|
GPIO_NOT_HOLD = 0 /*!< If the GPIO input is not low */
|
|
} esp_comm_gpio_hold_t;
|
|
|
|
/**
|
|
* @brief Calculate crc for the OTA data partition.
|
|
*
|
|
* @param[in] ota_data The OTA data partition.
|
|
* @return Returns crc value.
|
|
*/
|
|
uint32_t bootloader_common_ota_select_crc(const esp_ota_select_entry_t *s);
|
|
|
|
/**
|
|
* @brief Verifies the validity of the OTA data partition
|
|
*
|
|
* @param[in] ota_data The OTA data partition.
|
|
* @return Returns true on valid, false otherwise.
|
|
*/
|
|
bool bootloader_common_ota_select_valid(const esp_ota_select_entry_t *s);
|
|
|
|
/**
|
|
* @brief Check if the GPIO input is a long hold or a short hold.
|
|
*
|
|
* Number of the GPIO input will be configured as an input with internal pull-up enabled.
|
|
* If the GPIO input is held low continuously for delay_sec period then it is a long hold.
|
|
* If the GPIO input is held low for less period then it is a short hold.
|
|
*
|
|
* @param[in] num_pin Number of the GPIO input.
|
|
* @param[in] delay_sec Input must be driven low for at least this long, continuously.
|
|
* @return esp_comm_gpio_hold_t Defines type of hold a GPIO in low state.
|
|
*/
|
|
esp_comm_gpio_hold_t bootloader_common_check_long_hold_gpio(uint32_t num_pin, uint32_t delay_sec);
|
|
|
|
/**
|
|
* @brief Erase the partition data that is specified in the transferred list.
|
|
*
|
|
* @param[in] list_erase String containing a list of cleared partitions. Like this "nvs, phy". The string must be null-terminal.
|
|
* @param[in] ota_data_erase If true then the OTA data partition will be cleared (if there is it in partition table).
|
|
* @return Returns true on success, false otherwise.
|
|
*/
|
|
bool bootloader_common_erase_part_type_data(const char *list_erase, bool ota_data_erase);
|
|
|
|
/**
|
|
* @brief Determines if the list contains the label
|
|
*
|
|
* @param[in] list A string of names delimited by commas or spaces. Like this "nvs, phy, data". The string must be null-terminated.
|
|
* @param[in] label The substring that will be searched in the list.
|
|
* @return Returns true if the list contains the label, false otherwise.
|
|
*/
|
|
bool bootloader_common_label_search(const char *list, char *label);
|
|
|
|
/**
|
|
* @brief Calculates a sha-256 for a given partition or returns a appended digest.
|
|
*
|
|
* This function can be used to return the SHA-256 digest of application, bootloader and data partitions.
|
|
* For apps with SHA-256 appended to the app image, the result is the appended SHA-256 value for the app image content.
|
|
* The hash is verified before returning, if app content is invalid then the function returns ESP_ERR_IMAGE_INVALID.
|
|
* For apps without SHA-256 appended to the image, the result is the SHA-256 of all bytes in the app image.
|
|
* For other partition types, the result is the SHA-256 of the entire partition.
|
|
*
|
|
* @param[in] address Address of partition.
|
|
* @param[in] size Size of partition.
|
|
* @param[in] type Type of partition. For applications the type is 0, otherwise type is data.
|
|
* @param[out] out_sha_256 Returned SHA-256 digest for a given partition.
|
|
*
|
|
* @return
|
|
* - ESP_OK: In case of successful operation.
|
|
* - ESP_ERR_INVALID_ARG: The size was 0 or the sha_256 was NULL.
|
|
* - ESP_ERR_NO_MEM: Cannot allocate memory for sha256 operation.
|
|
* - ESP_ERR_IMAGE_INVALID: App partition doesn't contain a valid app image.
|
|
* - ESP_FAIL: An allocation error occurred.
|
|
*/
|
|
esp_err_t bootloader_common_get_sha256_of_partition(uint32_t address, uint32_t size, int type, uint8_t *out_sha_256);
|
|
|
|
/**
|
|
* @brief Get chip revision
|
|
*
|
|
* @return Chip revision number
|
|
*/
|
|
uint8_t bootloader_common_get_chip_revision(void);
|
|
|
|
/**
|
|
* @brief Check if the image (bootloader and application) has valid chip ID and revision
|
|
*
|
|
* @param img_hdr: image header
|
|
* @return
|
|
* - ESP_OK: image and chip are matched well
|
|
* - ESP_FAIL: image doesn't match to the chip
|
|
*/
|
|
esp_err_t bootloader_common_check_chip_validity(const esp_image_header_t* img_hdr);
|
|
|
|
|
|
/**
|
|
* @brief Configure VDDSDIO, call this API to rise VDDSDIO to 1.9V when VDDSDIO regulator is enabled as 1.8V mode.
|
|
*/
|
|
void bootloader_common_vddsdio_configure();
|