Update

• Introduction
• Directory Structure
• Constraints
• Usage
• Repositories Involved

Introduction

Over the Air (OTA) provides the remote device update capability. Your devices will be able to support OTA update through secondary development on the provided APIs.

By providing unified update APIs externally, the update subsystem shields the differences of underlying chips.

Directory Structure

/base/update/ota_lite
├── frameworks         # OTA update implementation, including update package parsing, verification, writing, and updating
├── interfaces/kits    # External APIs for OTA update
├── hals               # Chip adaptation code, for example, HiSilicon chip adaptation code is located at device\hisilicon\hardware\update

Constraints

The update subsystem is compiled using the C language. Currently, only the Hi3518E V300, Hi3516D V300, and Hi3861 development boards are supported. If you want to support devices that use other chips, you can implement the OpenHarmony integration APIs in the vendor directory. Currently, only the full-package update is supported.

Usage

Add the dependency on the update subsystem. The following uses the Hi3516D V300 development board as an example.

• Add update to the subsystem_list field in the vendor\hisilicon\ipcamera_hi3516dv300_liteos\config.json file, and add the following code under subsystem_list:

  {
          "subsystem": "update",
          "components": [
            { "component": "hota", "features": [] }
          ]
   },
  

• Add the update.json file to the build\lite\components directory.

  "components": [
      {
        "component": "hota",
        "description": "",
        "optional": "false",
        "dirs": [
          "base/update/ota_lite/frameworks",
          "base/update/ota_lite/interfaces/kits"
        ],
        "targets": [
          "//base/update/ota_lite/frameworks:ota_lite"
        ],
  ...
  

• Add test code. For example, add subsystem_test to the base\update\ota_lite\frameworks\BUILD.gn file.

• Run the following commands to compile the system. You can experience the OTA update function after flashing the system to the Hi3516 chip.

  hb set
  hb build
  

Repositories Involved

Update subsystem

update_ota_lite

device_hisilicon_hardware