Over-the-Air Download (OAD)

The following sections aim to describe the lower layers of OAD software that are common across all protocol stack implementations. This includes the OAD image header, the flash layout, Boot Image Manager, and the oad_image_tool.

• Introduction
  • OAD Topology Overview
• OAD Type Comparison
• Boot Image Manager (BIM)
  • Overview & Software Architecture
  • Boot procedure
    • Device trim
  • Locating and Preparing a user application
• BIM for Off-Chip OAD
• BIM for On-Chip OAD (Split Image)
  • Application Execution switching using RAM
• OAD Image Header
  • OAD Image Header Overview
  • OAD Core Image Header
    • OAD Image Identification Value
    • CRC
    • BIM Version
    • Image Header Version
    • Wireless Technology
    • Image Information
    • Image Validation
    • Image Length
    • Program Entry Address
    • Software version
    • Image End Address
    • Header Length
  • OAD Image Header segments
    • Segment Header
      • Segment Type
      • Wireless Technology
      • Reserved
      • Payload Length
    • Boundary Information Segment
      • Stack Entry Address
      • Stack Boundary Address (ICALL_STACK0_ADDR)
      • Lower RAM Boundary (RAM_START_ADDR)
      • Upper RAM Boundary (RAM_END_ADDR)
    • Contiguous Image Information Segment
      • Image Start Address
    • Security Information Segment
      • Verification status
      • Security Version
      • Security Timestamp
      • Certificate Payload
• OAD External Flash Image Header
  • Additional Fields in External Flash Image Header
• Flash Layout for Off-Chip OAD
  • Constraints and Requirements for Off-chip OAD
  • Internal Flash Memory Layout
  • External Flash Memory Layout
• Flash Layout for On-Chip OAD
  • Constraints and Requirements for On-chip OAD (split image)
  • Internal Flash Memory Layout
• OAD Image Tool
  • Running the tool
  • Running the Tool from Source
  • Generating new security keys (Embedded)
  • Required Arguments/Getting help

The following sections aim to describe the BLE-Stack specific application and profile layer of the OAD solution. The OAD application section will describe the BLE OAD process from a high level in terms of events and states, and the profile section will cover the actual structures that are sent over the air.

• OAD Application
  • OAD Module Architecture
  • OAD State Machine
    • Device Reset/Image Switching
    • OAD Module State Diagram
    • Image Validation
    • Image Block Transfers
    • Completion of the OAD Process
• BLE-Stack OAD Profile
  • Over the Air Message Sequence
  • OAD Service (0xFFC0)
    • OAD Image Identify (0xFFC1)
    • OAD Image Block Characteristic (0xFFC2)
    • OAD Control Point Characteristic (0xFFC5)
      • Get OAD Block Size CMD/RSP
      • Set Image Count CMD/RSP
      • Start OAD CMD/RSP
      • Enable OAD Image CMD/RSP
      • Cancel OAD CMD/RSP
      • Disable OAD Image Block Write CMD/RSP
      • Get Software Version CMD/RSP
      • Get OAD Image Status CMD/RSP
      • Get Profile Version CMD/RSP
      • Get Device Type CMD/RSP
      • Image Block Write Char RSP
      • Erase All Bonds REQ/RSP
  • OAD Reset Service (0xFFD0)
    • OAD Start/Reset Characteristic (0xFFD1)
  • OAD Return Values
  • OAD Block Size Rules

The following sections cover the out of the box demo for OAD using the BLE-Stack. Additionally, the steps are included on how to add OAD to an existing project.

• Setting up the BLE OAD Environment
  • Prerequisites
  • OAD Target Setup
  • OAD Distributor Setup
    • Flashing the host_test Image
    • Connecting BTool to host_test
• Performing a BLE OAD
  • Modifying the Image Version
  • OAD using BTool
  • Generating new security keys (BTool)
• Creating a Production Image
  • Change to Release BIM
  • Secure OAD: Change default keys
  • Loading a Production Image
• Adding BLE OAD to an Existing Project