zpal_bootloader.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Silicon Laboratories Inc. <https://www.silabs.com/>
//
// SPDX-License-Identifier: BSD-3-Clause
 
#ifndef ZPAL_BOOTLOADER_H_
#define ZPAL_BOOTLOADER_H_
 
#include <stdbool.h>
#include "zpal_status.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum
{
  ZPAL_BOOTLOADER_NOT_PRESENT = 0,  
  ZPAL_BOOTLOADER_PRESENT     = 1,  
} zpal_bootloader_type_t;
 
typedef struct {
  zpal_bootloader_type_t type;  
  uint32_t version;             
  uint32_t capabilities;        
} zpal_bootloader_info_t;
 
#define ZPAL_BOOTLOADER_CAPABILITY_STORAGE                     (1 << 0)
 
#define ZPAL_BOOTLOADER_VERSION_MAJOR_SHIFT (24U)
#define ZPAL_BOOTLOADER_VERSION_MINOR_SHIFT (16U)
#define ZPAL_BOOTLOADER_VERSION_BUGFIX_SHIFT (0U)
#define ZPAL_BOOTLOADER_VERSION_MAJOR_MASK  (0xFF000000U)
#define ZPAL_BOOTLOADER_VERSION_MINOR_MASK  (0x00FF0000U)
#define ZPAL_BOOTLOADER_VERSION_BUGFIX_MASK (0x0000FFFFU)
void zpal_bootloader_get_info(zpal_bootloader_info_t *info);
 
zpal_status_t zpal_bootloader_init(void);
 
void zpal_bootloader_reboot_and_install(void);
 
zpal_status_t zpal_bootloader_verify_image(void);
 
zpal_status_t zpal_bootloader_write_data(uint32_t offset, uint8_t * data, uint16_t length);
 
bool zpal_bootloader_is_first_boot(bool *updated_successfully);
 
void zpal_bootloader_reset_page_counters(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZPAL_BOOTLOADER_H_ */