概述

1. OpenHarmony【官方网址】,【源码仓库】，【源码下载】，【历史发布版本】。OpenHarmony系统分为：{ L0:轻量级系统， L1：小型系统， L2:标准系统 } 。
2. 目前君正平台支持OpenHarmony小型系统L1。版本为 OpenHarmony-V3.0-LTS。【点击下载XTS兼容性测试认证和测试报告】。
3. 君正支持的是L1 级别的系统（即小型系统），其API为：【轻量级智能穿戴开发】， 其它接口需要自行封装 。
4. 功能开发：【预置功能】
5. 开发流程： 首先烧录编译好的镜像 并更新固件 ，确认功能正常，然后再下载工程进行开发。

镜像烧录

1. 支持的开发板：(x2600e_halley7 /Hippo / halley5 / halley6 )【说明： halley7采用君正X2600e芯片，halley6采用君正X1600芯片， halley5采用君正X2000芯片， Hippo采用君正X2500芯片】
2. 镜像下载(x2600e_halley7 / halley6 / halley5 / hippo_v11 / hippo_v12)【 版本发布测试报告 】【 版本发布列表 】
3. 烧录工具下载
4. 烧录工具使用说明 （推荐在ubuntu系统下烧录）
5. 点击查看烧录工具的板级选项配置
6. 固件更新: 【camera效果】（2022-7-20）

源码下载与编译

1. 环境搭建

2. 代码下载

   (1) OpenHarmony源码下载

   【 x2600e_halley7 】（2023-11-24）

   【 halley5 】（2022-10-9）

   【 hippo_v11 】（2022-10-9）

   【 hippo_v12 】（2022-10-9）

   【 halley6 】 (2023-6-19)

   (2) 将在网盘下载的压缩包解压，进入工程后进行编译操作。

3. 编译

   halley5、halley6、halley7、hippo_v11、hippo_v12 编译步骤如下：

   # 选择板级，进行首次编译
   hb set
   
   # 根据开发板选择不同的板级。
   # Halley5 选择 halley5_spi_nand_flash
   # Halley5 横屏 选择halley5_rotator_spi_nand_flash
   # Hippo_V1.1 选择 hippo_spi_nand_flash
   # Hippo_V1.2 选择 hippo_msc_flash
   # x2600e halley7 选择 halley7_spi_nand_flash
   # 编译
   hb build -f
   
   # 如果要重新编译 
   rm  out/ -rf 然后hb build -f。

4. 镜像

   # 生成的镜像位置： 
   out/芯片型号/开发板板级/ 例如： out/x2000/halley5_spi_nand_flash/ 
   # 生成的镜像： 
   uboot， xImage， rootfs_ubifs.img

5. 烧录

   将生成的三个镜像烧录到开发板上进行开发，烧录过程请参照【镜像烧录】

应用开发

1. 应用编译

   1.1 下载IDE：DevEco Studio 3.0 Beta2 for HarmonyOS（官网下载链接）

   #注：下载选择 DevEco Studio 3.0 Beta2 for HarmonyOS
   
   #为保证DevEco Studio正常运行，建议电脑配置满足如下要求：
       操作系统：Windows10 64位 / macOS 10.14/10.15/11.2.2
       内存：8GB及以上
       硬盘：100GB及以上
       分辨率：1280*800像素及以上

   1.2 软件安装与官方使用指南

   1.3 应用开发工程创建指引与常见问题

2. 应用安装

   
   #进入开发板并创建文件夹apps
   adb shell
   
   mkdir -p /apps
   
   #退出开发板系统，进入pc本地
   exit
   
   #将编译生成的hap包放到开发板，电脑hap包目录下执行
   adb push 应用名.hap /apps/
   
   #开发板中执行
   mv dev_tools/bin/bm /bin 
   
   #禁用证书验证
   bm set -s disable
   
   #安装应用
   bm install -p apps/*.hap 
   
   #卸载应用 
   bm uninstall -n [应用名： 对应/storage/app/run/下目录名]

3. 预置应用

   (1) 预置hap包

    # 应用hap包路径:上述网盘下载的工程源码的/iot/oh-apps/hap/ 路径下
    # 应用资源路径:上述网盘下载的工程源码的/iot/oh-apps/music/和/iot/oh-apps/videos/ 路径下
    # 将应用和资源放入开发板中, adb push oh-apps/hap/开发板名称 /apps
    (例如： adb push oh-apps/hap/halley5 /apps)
           adb push oh-apps/music /music 
           adb push oh-apps/videos /video

   (2) 预置源码

    # 应用源码路径:上述网盘下载的工程源码的/iot/oh-apps/source-code/开发板名称/ 路径下
    # 将应用文件夹用上述IDE打开并编译，可在 应用名称/build/outputs/hap/debug/smartVision/目录下生成hap包
   （例如：Airconditioner/build/outputs/hap/debug/smartVision/entry-debug-lite-unsigned.hap）
    # 安装上述hap包，安装过程参考上述安装过程即可

框架开发

1. AI算法插件 【人脸识别算法插件】

2. 依赖库编译

   # 单独编译库
   hb build -T //库的路径:库的名称 -f
   # 查看库对应的 BUILD.gn 获取路径及名称
   # 例:  hb build -T //foundation/graphic/ui:ui -f

3. 屏幕分辨率适配修改 【点击查看具体方法】

4. 屏幕ROTATE适配修改

   (1)dts 设备树配置文件:

   dpu 需要配置:

   ingenic,disable-rdma-fb = <0> ;
   ingenic,layer-exported = <0 0 0 0>;

   (2)defconfig 配置:

   CONFIG_FB_VSYNC_SKIP_DISABLE=y
   CONFIG_FB_INGENIC_NR_FRAMES=7
   CONFIG_VIDEO_INGENIC_ROTATE=y

   (3)在 vendor 目录下查找对应板级的 S99WmsStart 文件，配置环境变量如下

   export env_ingenic_rotate=90        # 0 / 90 / 180 / 270

5. JS与CPP接口调用参考与简介 【点击查看具体方法】

平台开发

1. kernel开发
   

   [1]. 【点击下载查看X2000-Halley5内核开发手册】 【点击下载查看X2500-Hippo内核开发手册】
   文档备注：ingenic的内核开发源码地址全部放在module_drivers下对应的driver目录下。

   [2]. 自定义编译 kernel

   #配置编译工具链
   在源码目录下查找编译工具链位置： find -name mips-linux-gnu-gcc
   会给出多个路径:./device/ingenic/芯片平台/prebuilt/gcc/linux-x86/mips/mips-gcc720-glibc229/bin/mips-linux-gnu-gcc
   例如源码在/home/user/openharmony/目录下， 选择halley5平台，添加环境变量[绝对路径]： 
   export PATH=$PATH:/home/user/openharmony/device/ingenic/x2000/prebuilt/gcc/linux-x86/mips/mips-gcc720-glibc229/bin
   注：x2500 与 x2000 共用编译工具链
   
   #导出产品环境变量
   export PRODUCT_PATH=vendor/ingenic/开发板板级
   例如halley5开发板：export PRODUCT_PATH=vendor/ingenic/halley5
   
   #进入 kernel 源码
   cd device/ingenic/src/kernel/kernel-5.10
   
   #根据板级对应的defconfig文件配置kernel。 备注：也可以使用 make menuconfig 自行裁剪。
   Halley5 开发板：     make  halley5_v30_openharmony_defconfig
   Hippo_v1.1 开发板：  make  hippo_v10_openharmony_defconfig
   Hippo_v1.2 开发板：  make  hippo_v12_openharmony_defconfig
      
   #编译 kernel
   make xImage -j32

​
2. u-boot开发
uboot编译和配置

3. 平台应用 （TODO)
   平台应用位置：
   平台应用编译：
   平台应用运行：（1）禁用OpenHarmony框架。

应用分析

1. 【视频播放】 2.【人脸识别】

常见问题

1. 【详情请点击链接查看】
2. 【openharmony问题交流论坛】
3. 【平台内存占用细节介绍】
4. 技术支持： support@ingenic.com 市场电话：（010）56345127