xref: /device/board/hisilicon/hispark_phoenix/README_zh.md

# HiSpark_Phoenix开发指引<a name="ZH-CN_TOPIC_0000001142448981"></a>

-   [简介](#section11660541593)
-   [目录](#section835037926256)
-   [开发环境搭建](#section161941989596)
    -   [系统要求](#section149127526335)
    -   [IDE方式](#section724948309150)
    -   [安装包方式](#section204672979943)
    
-   [代码下载](#section119744591305)
-   [编译烧录](#section137768191623)
-   [调试说明](#section1312121216216)
    -   [hdc工具](#section129654513264)
    -   [点屏配置](#section864408051434)

-   [相关仓](#section144978787332)
-   [FAQ](#section1371113476307)

## 简介<a name="section11660541593"></a>

HiSpark-Phoenix是基于海思Hi3751V350智能电视芯片的一块高性能开发板，内置高性能多核 ARM A53 CPU，多核MALI T450 GPU，支持NTSC/PAL/SECAM制式解调，支持DTMB/DVB-C/ATSC/ISDB-T等全球数字Demod,可以扩展DVB-T/T2/S/S2,支持USB播放，支持主流的视频格式包括MPGE2、H.264、H.265、RMVB、AVS+等，支持主流音频解码及音效处理，以及海思自研的SWS音效处理，支持LVDS和miniLVDS接口，支持主流的Tconless屏。

**图 1**  HiSpark_Phoenix单板正面外观图<a name="fig4460722185514"></a>  

![hispark_phoenix](docs/figures/zn-cn_image_Hi3751V350.png)

## 目录<a name="section835037926256"></a>
```
.
├── docs // hispark_phoenix资料文档
│   ├── figures
│   └── public_sys-resources
├── linux
│   ├── boot // 预编译镜像分区文件
│   ├── system // 系统资源和配置
│   │   └── cfg
│   └── updater // 升级子系统配置
│       └── cfg
└── peripherals
    └── bluetooth // 蓝牙适配
        └── rtkbt

```

## 开发环境搭建<a name="section161941989596"></a>

在嵌入式开发中，很多开发者习惯于使用Windows进行代码的编辑，比如使用Windows的Visual Studio Code进行OpenHarmony代码的开发。但当前阶段，大部分的开发板源码还不支持在Windows环境下进行编译，如Hi3861、Hi3516系列开发板。因此，建议使用Ubuntu的编译环境对源码进行编译。

在以上的设备开发场景中，可以搭建一套Windows+Ubuntu混合开发的环境，其中使用Windows平台的DevEco Device Tool可视化界面进行相关操作，通过远程连接的方式对接Ubuntu下的DevEco Device Tool（可以不安装Visual Studio Code），然后对Ubuntu下的源码进行开发、编译、烧录等操作。

针对Hispark_phoenix开发板，建议搭建IDE开发环境，方便后面使用IDE烧录。
### 系统要求<a name = "section149127526335"></a>

- Windows系统要求：Windows10 64位系统。
- Ubuntu系统要求：Ubuntu18.04~21.10版本，内存推荐16 GB及以上，python版本要求3.7以上。
- Windows系统和Ubuntu系统的用户名不能包含中文字符。

### 基于IDE（DevEco Device Tool）的环境<a name = "section724948309150"></a>

IDE方式完全采用DevEco Device Tool进行一站式开发，编译依赖工具的<b>安装</b>及<b>编译</b>、<b>烧录</b>、<b>运行</b>都通过IDE可视化操作, 这种方式需要在Windows和Ubuntu系统上安装的DevEco Device Tool 3.0 Release版本以上。

此方式需要进行下面的步骤：
   - [搭建Windows环境][ide_envsetup_windows]
   - [搭建Ubuntu环境][ide_envsetup_ubuntu]
   - [配置远程访问环境][ide_envsetup_remote]
   - [创建工程并获取源码][ide_envsetup_import_project]

[ide_envsetup_windows]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-ide-env-win.md
[ide_envsetup_ubuntu]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-ide-env-ubuntu.md
[ide_envsetup_remote]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-ide-env-remote.md
[ide_envsetup_import_project]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-ide-import-project.md


   > ![icon-note.gif](docs/public_sys-resources/icon-note.gif) **说明：**
   > 详情请参考[快速入门](https://gitee.com/openharmony/docs/tree/master/zh-cn/device-dev/quick-start)

### 基于命令行的环境<a name = "section204672979943"></a>

安装包方式直接在Ubuntu环境下执行命令来安装依赖工具，下载源码，编译构建，然后通过HiTool/IDE工具进行烧录。同时OpenHarmony还为开发者提供了[Docker][OpenHarmony docker]环境，在很大程度上简化了编译前的环境配置，习惯使用安装包方式的开发者也可以选择Docker环境进行编译 。

此方式需要进行下面的步骤：
  - [准备开发环境][pkg-prapare]
  - [安装库和工具集][pkg-installation]
  - [获取源码][aquire-sourcecode]
  - [安装编译工具][install-toolchain]

   > ![icon-note.gif](docs/public_sys-resources/icon-note.gif) **说明：**
   > 详情请参考[快速入门](https://gitee.com/openharmony/docs/tree/master/zh-cn/device-dev/quick-start)

[OpenHarmony docker]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/gettools-acquire.md
[pkg-prapare]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-pkg-prepare.md
[pkg-installation]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-pkg-install-package.md
[aquire-sourcecode]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-pkg-sourcecode.md
[install-toolchain]: https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-pkg-install-tool.md


## 代码下载<a name="section119744591305"></a>

Hispark_phoenix产品可在master和OpenHarmony-3.1-Release分支获取到，OpenHarmony-3.1-Release分支更稳定，建议下载OpenHarmony-3.1-Release分支。请参考[获取源码][aquire-sourcecode]配置git并下载码云repo工具。

- OpenHarmony主干
  - 方式一：通过repo + ssh下载（需注册公钥，请参考码云帮助中心）。

    repo init -u git@gitee.com:openharmony/manifest.git -b master --no-repo-verify  
    repo sync -c  
    repo forall -c 'git lfs pull'  
    bash build/prebuilts_download.sh

  - 方式二：通过repo + https下载。

    repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify  
    repo sync -c  
    repo forall -c 'git lfs pull'  
    bash build/prebuilts_download.sh

- OpenHarmony-3.1-Release分支(推荐)
  - 方式一：通过repo + ssh下载（需注册公钥，请参考码云帮助中心）。

    repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony-3.1-Release    --no-repo-verify  
    repo sync -c  
    repo forall -c 'git lfs pull'  
    bash build/prebuilts_download.sh

  - 方式二：通过repo + https下载。

    repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.1-Release --no-repo-verify  
    repo sync -c  
    repo forall -c 'git lfs pull'  
    bash build/prebuilts_download.sh

   > ![icon-note.gif](docs/public_sys-resources/icon-note.gif) **说明：**
   > 在repo init时加参数--depth=1，能减少网络异常导致的下载失败，下载耗时也更短，缺点是git log信息太少，仅有最新的commit。

## 编译烧录<a name="section137768191623"></a>

### 编译源码
 
* 命令行方式请参考文档[编译Hispark_phoenix](./docs/quickstart-standard-running-hi3751-build.md)。  
* IDE方式编译参考文档[IDE编译Hispark_phoenix](./docs/quickstart-ide-standard-running-hi3751-build.md)。

### 烧录

Hispark_phoenix提供两种烧录方式：

* HiTool方式烧录  
  直接选择分区配置文件//out/hispark_phoenix/packages/phone/images/Hi3751V350-slaveboot-emmc.xml后烧录。此方法仅限于已有Hi3751V35X的HiTool。  
* [IDE烧录](./docs/quickstart-ide-standard-running-hi3751-burning.md)  
  如果镜像是使用命令行方式编译出的，则需要准备IDE开发环境，再进行同样的烧录。

  > ![icon-note.gif](docs/public_sys-resources/icon-note.gif) **说明：**
  > 3.1-Release分支的IDE烧录请参考[3.1烧录临时方案](./docs/ide_hiburn_for_3.1-release.md)。

## 调试<a name="section1312121216216"></a>

### hdc 工具<a name="section129654513264"></a>
hdc工具获取和详细使用方法请参考文档[HDC-OpenHarmony设备连接器](https://gitee.com/openharmony/developtools_hdc)。  
需要注意的是Hi3751V35X仅支持TCP连接方式，且端口固定为34567，请依据本地网络环境配置开发版IP。

    // hdc tcp链接方式：
    ifconfig eth0 xxx.xxx.xxx.xxx netmask 255.255.xxx.xxx
    hdc_std tconn xxx.xxx.xxx.xxx:34567

### 点屏配置<a name="section864408051434"></a>

持续完善中......

## 相关仓<a name="section144978787332"></a>

[vendor_hisilicon](https://gitee.com/openharmony/vendor_hisilicon)  
[device_board_hisilicon](https://gitee.com/openharmony/device_board_hisilicon)
[device_soc_hisilicon](https://gitee.com/openharmony/device_soc_hisilicon)

## FAQ<a name="section1371113476307"></a>