Ug266 Gecko Bootloader User Guide

• Table of Contents
• 1. Overview
  • 1.1 Core
    • 1.1.1 Shared Memory
  • 1.2 Drivers
  • 1.3 Plugins
    • 1.3.1 Communication
    • 1.3.2 Compression
    • 1.3.3 Debug
    • 1.3.4 GPIO Activation
    • 1.3.5 Security
    • 1.3.6 Storage
• 2. Gecko Bootloader Operation - Application Upgrade
  • 2.1 Standalone Bootloader Operation
    • 2.1.1 Rebooting Into the Bootloader
    • 2.1.2 Downloading and Applying a GBL Upgrade File
    • 2.1.3 Booting Into the Application
    • 2.1.4 Error handling
  • 2.2 Application Bootloader Operation
    • 2.2.1 Downloading and Storing a GBL Image Upgrade File
    • 2.2.2 Rebooting and Applying a GBL Upgrade File
    • 2.2.3 Booting Into the Application
• 3. Gecko Bootloader Operation - Bootloader Upgrade
  • 3.1 Bootloader Upgrade on Bootloaders With Communication Interface (Standalone Bootloaders)
    • 3.1.1 Downloading and Applying a Bootloader GBL Upgrade File
    • 3.1.2 Downloading and Applying an Application GBL Upgrade File
  • 3.2 Bootloader Upgrade on Bootloaders With Storage
    • 3.2.1 Storage Space Size Configuration
• 4. Gecko Bootloader Operation - Secure Element Upgrade
  • 4.1 Secure Element Upgrade on Bootloaders with Communication Interface (Standalone Bootloaders)
    • 4.1.1 Downloading and Applying a Secure Element GBL Upgrade File
    • 4.1.2 Downloading and Applying an Application GBL Upgrade File
  • 4.2 Secure Element Upgrade on Bootloaders with Storage
    • 4.2.1 Storage Space Size Configuration
  • 4.3 Downloading the Secure Element Images
• 5. Getting Started with the Gecko Bootloader
• 6. Configuring the Gecko Bootloader
  • 6.1 Configuring Storage
    • 6.1.1 SPI Flash Storage Configuration
    • 6.1.2 Internal Storage Configuration
  • 6.2 Compressed Upgrade Images
    • 6.2.1 LZMA Compression Settings
  • 6.3 Bootloader Example Configurations
    • 6.3.1 UART XMODEM Bootloader
    • 6.3.2 BGAPI UART DFU Bootloader
    • 6.3.3 EZSP SPI Bootloader
    • 6.3.4 SPI Flash Storage Bootloader
    • 6.3.5 Internal Storage Bootloader
      • 6.3.5.1 Storage Slot Configuration on Single Internal Storage with 512 kB Flash Memory
      • 6.3.5.2 Storage Slot Configuration on Single Internal Storage with 1024 kB Flash Memory
    • 6.3.6 Bluetooth In-Place OTA DFU Bootloader
  • 6.4 Setting a Version Number For The Bootloader
  • 6.5 Hardware Configuration
  • 6.6 Size Requirements for Different Bootloader Configurations
• 7. Simplicity Commander and the Gecko Bootloader
  • 7.1 Creating GBL Files Using Simplicity Commander
• 8. Gecko Bootloader Security Features
  • 8.1 About Security Features
    • 8.1.1 Secure Boot Procedure
    • 8.1.2 Secure Firmware Upgrade
  • 8.2 Using Gecko Bootloader Security Features
    • 8.2.1 Generating Keys
    • 8.2.2 Signing an Application Image for Secure Boot
    • 8.2.3 Creating a Signed and Encrypted GBL Upgrade Image File From an Application
  • 8.3 System Security Considerations
    • 8.3.1 Key Storage
    • 8.3.2 Write Protecting the Bootloader
    • 8.3.3 Write-Protecting the Application
    • 8.3.4 Debug Access
• 9. Application Interface
  • 9.1 Application Properties
  • 9.2 Error Codes