diff --git a/docs/source/bsp/arm64/hisilicon/index.rst b/docs/source/bsp/arm64/hisilicon/index.rst index 60c8e35f34255014339cb948710077a60ea91f27..4532464046758a4b36d31774dabfc91c638b9e60 100644 --- a/docs/source/bsp/arm64/hisilicon/index.rst +++ b/docs/source/bsp/arm64/hisilicon/index.rst @@ -8,5 +8,6 @@ .. toctree:: :maxdepth: 1 + kp920/kp920.rst hi3093/hi3093.rst hieulerpi/index.rst diff --git a/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst b/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst new file mode 100644 index 0000000000000000000000000000000000000000..0f305e0f60c572d12b73715b4da4933a91be2b37 --- /dev/null +++ b/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst @@ -0,0 +1,67 @@ +.. _board_kp920: + +鲲鹏920 +####### + +基本介绍 +======== + +鲲鹏920是目前业界领先的ARM-based处理器。该处理器采用7nm制造工艺，基于ARM架构授权，由华为公司自主设计完成，主频可达 2.6 GHz。详细配置可参考： `鲲鹏920 介绍 `_ + +目前openEuler Embedded已经支持鲲鹏920的镜像构建、安装及运行。 + +____ + +构建说明 +======== + +1. 参照 :ref:`oebuild_install` 完成oebuild安装，并详细了解构建过程 + + .. code-block:: console + + # 例如 + $ oebuild init my_workspace + + # 上述命令没有指定分支，使用默认分支master + $ cd xxx/my_workspace + $ oebuild update + +2. 依次执行以下命令完成构建 + + .. code-block:: console + + # 生成kp920构建配置文件，若需额外加入特性，见-f列表(oebuild generate -l)，下例启用systemd和软实时功能 + $ oebuild generate -p kp920 -f systemd -f rt -d build_kp920 + + # 按提示进入构建目录 build_kp920 后，执行如下命令进入bitbake环境，进入构建交互终端 + $ oebuild bitbake + + # 构建镜像 + $ bitbake openeuler-image + + # 构建sdk + $ bitbake openeuler-image -c populate_sdk + + 二进制产物介绍（对应output目录）： + + - ``openeuler-glibc-x86_64-openeuler-image-aarch64-kp920-toolchain-.sh``: SDK工具链 + + - ``openeuler-image-kp920-[时间戳].iso``: 适用鲲鹏920的ISO镜像，可直接用于部署 + + - ``vmlinux``: 备用调试内核 + + - ``Image``: 备用内核镜像 + +.. note:: + + 需要其他功能时，请在oebuild初始化时通过 ``-f features`` 添加对应的 feature。见-f列表(oebuild generate -l) + +____ + +安装说明 +======== + +.. seealso:: + + 参考 :ref:`openEuler Embedded ISO 镜像安装说明 `，若使用 BMC 进行安装，请在 BMC 界面挂载光驱并选择光驱启动之后进行镜像安装。 + diff --git a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst index ea34525be89bbac2543d007cef6aafca5265cc11..fe748740d4ee8b766cdfb9f9bdbfcfd00d9137f4 100644 --- a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst +++ b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst @@ -24,6 +24,8 @@ ____ ____ +.. _iso_install: + 安装说明 ======== diff --git a/docs/source/features/epkg.rst b/docs/source/features/epkg.rst new file mode 100644 index 0000000000000000000000000000000000000000..8ceecac5063d6089063b93eee0db1351f9fa6f38 --- /dev/null +++ b/docs/source/features/epkg.rst @@ -0,0 +1,91 @@ +openEuler包管理器EPKG +##################### + +总体介绍 +======== + +epkg 是 openEuler 提出新型包管理工具，能够解决多版本兼容性问题，用户可以在一个操作系统上通过命令安装不同版本的软件包。同时支持环境管理实现环境的创建/切换/使能/回退等操作，实现用户在误操作或安装软件后出现问题时恢复环境。 + +openEuler Embedded 25.03 版本后已默认支持 epkg 包管理器，能够让嵌入式接入epkg软件生态，拥有轻量灵活的包管理能力。 + +____ + +构建指导 +======== + +openEuler Embedded 25.03 版本已默认在 QEMU-ARM64、KP920 中提供 epkg 的支持。若需要在其它镜像中增加 epkg 功能，请通过 oebuild 指定 ``-f epkg`` 进行构建。 + +____ + +使用指导 +======== + +.. seealso:: + + 详细使用方法请参考 `EPKG包管理器使用说明 `_ 。 + +以下为使用示例： + +1. EPKG包管理器命令说明 + + .. code-block:: console + + Usage: + epkg install + epkg remove [-y] + epkg upgrade （开发中...） + + epkg list + + epkg env list + epkg env create [--repo ] + epkg env remove + epkg env activate [--pure] + epkg env deactivate + epkg env register|unregister + epkg env history + epkg env rollback + +2. 安装软件 + + 功能描述：在当前activate的环境中安装软件，若无环境激活，默认安装到main环境中：``epkg env activate `` + + 命令：``epkg install `` + + 示例： + + .. code-block:: console + + $ epkg env create t1 + EPKG_ACTIVE_ENV: + Environment t1 not exist. + Environment 't1' has been created. + Environment 't1' activated. + + $ epkg install htop + EPKG_ACTIVE_ENV: t1 + Warning: The following packages are already installed and will be skipped: + - 6sgyzx3s7624r0x7rpe4w8642p2d181r__fuse__2.9.9__11.oe2403 + - 3gypc46xq6mqd37ya3mhztz2zfkjghw1__libsigsegv__2.14__1.oe2403 + .... + Attention: Install success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 + +3. 卸载软件 + + 功能描述：在当前activate的环境中安装软件，若无环境激活，默认安装到main环境中：``epkg env activate `` + + 命令：``epkg remove `` + + 示例： + + .. code-block:: console + + $ epkg env activate t1 + Environment 't1' activated. + + $ epkg remove htop + Packages to remove: + - v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 + Do you want to continue with uninstallation? (y/n): + y + Attention: Remove success: v0wrq5sv9r5znsgtgxkbax24r7f6nq80__htop__3.3.0__1.oe2403 diff --git a/docs/source/features/index.rst b/docs/source/features/index.rst index e6200b730bd2b7894ebc804ca29113404958481f..28d4e3b55689d90a1d19716750060383926bb5dd 100644 --- a/docs/source/features/index.rst +++ b/docs/source/features/index.rst @@ -10,6 +10,7 @@ mica/index.rst ros.rst + epkg.rst muslc.rst distributed_softbus.rst preempt_rt.rst diff --git a/docs/source/getting_started/index.rst b/docs/source/getting_started/index.rst index ee4668810be19083855e621d7b067a9ba828c9f9..78d238bb21a1190444773bf011503d34f0cc315a 100644 --- a/docs/source/getting_started/index.rst +++ b/docs/source/getting_started/index.rst @@ -23,7 +23,7 @@ openEuler Embedded采用yocto构建，同时设计了基于Python的元工具 `o - | 当前 **仅支持在x86_64位的Linux环境** 下使用 oebuild 进行构建，且需在 **普通用户** 下进行 oebuild 的安装运行。更多关于 oebuild 的介绍请参阅 :ref:`oebuild 介绍 ` 章节。 - - openEuler Embedded 的 CI 会归档最新的构建镜像。若希望快速获取可用的镜像，请访问 `dailybuild `_ ，在 ``dailybuild/openEuler-Mainline/openeuler-xxxx-xx-xx/embedded_img`` 中可以下载镜像。 + - openEuler Embedded 的 CI 会归档最新的构建镜像。若希望快速获取可用的镜像，请访问 `dailybuild `_ ，在 ``embedded_img`` 中可以下载镜像。 1. 安装必要的主机包 -------------------