# OpenHarmony

**Repository Path**: wicom-ingenic/openharmony

## Basic Information

- **Project Name**: OpenHarmony
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 12
- **Forks**: 0
- **Created**: 2022-05-18
- **Last Updated**: 2025-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 概述
1. 本连接只支持OpenHarmony小型系统L1。版本为 **OpenHarmony-V3.0-LTS**。【[点击查看XTS兼容性测试认证和测试报告](./README附件/概述/证书和报告)】。
2. OpenHarmony【[官方网址](https://www.openharmony.cn/)】,【[源码仓库](https://gitee.com/openharmony)】，【[源码下载](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/sourcecode-acquire.md)】，【[历史发布版本](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/Readme.md)】。OpenHarmony系统分为：{ L0:轻量级系统，  L1：小型系统，  L2:标准系统 } 。
 3. 本链接支持的是**L1** 级别的系统（即小型系统），其API为：【[轻量级智能穿戴开发](https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-framework-file-0000001671873957)】， **其它接口需要自行封装** 。

### 镜像烧录

1.  支持的开发板：([x2600e_halley7](http://www.ingenic.com/?product/id/56.html) / [halley6](http://www.ingenic.com/?product2/id/50.html) )【说明： halley7采用君正X2600e芯片，halley6采用君正X1600芯片】
2.  镜像下载([x2600e_halley7](https://pan.baidu.com/s/1RLQAbOmZqLAdyFWVntyj3Q?pwd=q3q5) / [halley6](https://pan.baidu.com/s/1eP30LJkrhQsKI_O0N6JlQw?pwd=75kk) )
3.  [烧录工具下载](https://pan.baidu.com/s/1vdSXvc4wSixspPvyYNCNKA?pwd=BJJZ ) 
4.  [烧录工具使用说明](./README附件/镜像烧录/烧录工具使用说明/usb_cloner.md) （推荐在ubuntu系统下烧录）
5.  [点击查看烧录工具的板级选项配置](./README附件/镜像烧录/烧录工具使用说明/usb_cloner板级选择.md)

### 源码下载与编译

1. [环境搭建](./README附件/镜像编译/环境搭建.md)

2. 代码下载

   (1) OpenHarmony源码下载 

    【 [x2600e_halley7](https://pan.baidu.com/s/1TtXSllAOpelFMiQBINiCeQ?pwd=h9gc) 】（2023-11-24）

    【 [halley6](https://pan.baidu.com/s/1SWyw0rj9HY2QdAs48hzUdw?pwd=u3xw) 】 (2023-6-19)   



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


3. 编译

   halley6、halley7编译步骤如下：


   ```shell
   # 选择板级，进行首次编译
   hb set
   
   # 根据开发板选择不同的板级。
   # x2600e halley7 选择 halley7_spi_nand_flash
   # 编译
   hb build -f
   
   # 如果要重新编译 
   rm  out/ -rf 然后hb build -f。
   ```

4. 镜像

   ```sh
   # 生成的镜像位置： 
   out/芯片型号/开发板板级/ 例如： out/x2600/halley7_spi_nand_flash/ 
   # 生成的镜像： 
   uboot， uImage， rootfs_ubifs.img
   ```
5. 烧录
   
    将生成的三个镜像烧录到开发板上进行开发，烧录过程请参照【**镜像烧录**】


### 应用开发
1. 应用编译

    1.1 下载IDE：DevEco Studio 3.0 Beta2 for HarmonyOS（[官网下载链接](https://developer.harmonyos.com/cn/develop/deveco-studio#download_beta)）

    ```shell
    #注：下载选择 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 [软件安装与官方使用指南](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/software_install-0000001053582415)
    
    1.3 [应用开发工程创建指引与常见问题](./README附件/应用开发/appset.md)

2. 应用安装

    ```shell

    #进入开发板并创建文件夹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包

   ```shell
    # 应用hap包路径:上述网盘下载的工程源码的/iot/oh-apps/hap/ 路径下
    # 应用资源路径:上述网盘下载的工程源码的/iot/oh-apps/music/和/iot/oh-apps/videos/ 路径下
    # 将应用和资源放入开发板中, adb push oh-apps/hap/开发板名称 /apps
   ```
   
   (2) 预置源码
   
   ```shell
    # 应用源码路径:上述网盘下载的工程源码的/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. 依赖库编译

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

2. 屏幕分辨率适配修改
    【[点击查看具体方法](./README附件/框架开发/框架层修改屏幕分辨率的相关操作.md)】

3. 屏幕ROTATE适配修改

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

    dpu 需要配置:

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

    (2)defconfig 配置:

    ```c
    CONFIG_FB_VSYNC_SKIP_DISABLE=y
    CONFIG_FB_INGENIC_NR_FRAMES=7
    CONFIG_VIDEO_INGENIC_ROTATE=y
    ```

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

    ```shell
    export env_ingenic_rotate=90        # 0 / 90 / 180 / 270
    ```
4. JS与CPP接口调用参考与简介
    【[点击查看具体方法](./README附件/框架开发/JS与CPP接口调用参考与简介.md)】  

### 平台开发

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


​    
2.  u-boot开发
    <br>[uboot编译和配置](./README附件/驱动开发/uboot编译和配置.md)

### 常见问题

1. 【[详情请点击链接查看](./README附件/常见问题/常见问题.md)】
2. 【[openharmony问题交流论坛](https://zulip.openharmony.cn/)】
4. 技术支持： support@ingenic.com 市场电话：（010）56345127