From eb1472412bd7c39db96442fdc6337d4e78d73aec Mon Sep 17 00:00:00 2001
From: Wayne Ren <renweihust@gmail.com>
Date: Mon, 28 Apr 2025 10:38:09 +0800
Subject: [PATCH 1/3] release-notes: add 25.03 release notes

- add 25.03 release notes
- optimize some docs reference links

Signed-off-by: Wayne Ren <renweihust@gmail.com>
---
 .../bsp/arm64/hisilicon/hi3093/hi3093.rst     |  2 +
 docs/source/bsp/arm64/hisilicon/index.rst     |  2 +-
 docs/source/bsp/arm64/myir/index.rst          |  2 +-
 .../source/bsp/arm64/myir/myd-ld25x/index.rst |  2 +
 .../bsp/arm64/myir/myir-remi/myir-remi.rst    |  4 +-
 docs/source/bsp/x86/HVAEIPC-M10/m10.rst       |  2 +-
 docs/source/bsp/x86/qemu/qemu.rst             |  2 +
 .../develop/board-support/index.rst           |  2 +-
 docs/source/features/mica/instruction.rst     |  2 +-
 docs/source/features/mica/services/debug.rst  |  2 +-
 .../releases/release-notes-25.03.30.rst       | 54 +++++++++++++++++++
 11 files changed, 69 insertions(+), 7 deletions(-)
 create mode 100644 docs/source/releases/release-notes-25.03.30.rst

diff --git a/docs/source/bsp/arm64/hisilicon/hi3093/hi3093.rst b/docs/source/bsp/arm64/hisilicon/hi3093/hi3093.rst
index d9c783111e0..253d486912c 100644
--- a/docs/source/bsp/arm64/hisilicon/hi3093/hi3093.rst
+++ b/docs/source/bsp/arm64/hisilicon/hi3093/hi3093.rst
@@ -1,3 +1,5 @@
+.. _board_hisilicon_hi3093:
+
 Hi3093 镜像构建与说明                                                              
 #####################
  
diff --git a/docs/source/bsp/arm64/hisilicon/index.rst b/docs/source/bsp/arm64/hisilicon/index.rst
index 09a3ebd9021..60c8e35f342 100644
--- a/docs/source/bsp/arm64/hisilicon/index.rst
+++ b/docs/source/bsp/arm64/hisilicon/index.rst
@@ -1,4 +1,4 @@
-.. _board_hi3093:
+.. _board_hisilicon:
 
 
 基于海思(Hisilicon)SoC的硬件
diff --git a/docs/source/bsp/arm64/myir/index.rst b/docs/source/bsp/arm64/myir/index.rst
index e05a7c06d12..725236a1964 100644
--- a/docs/source/bsp/arm64/myir/index.rst
+++ b/docs/source/bsp/arm64/myir/index.rst
@@ -1,4 +1,4 @@
-.. _board_myir_remi:
+.. _board_myir:
 
 
 米尔系列硬件
diff --git a/docs/source/bsp/arm64/myir/myd-ld25x/index.rst b/docs/source/bsp/arm64/myir/myd-ld25x/index.rst
index cdcee24379a..c63ebe37740 100644
--- a/docs/source/bsp/arm64/myir/myd-ld25x/index.rst
+++ b/docs/source/bsp/arm64/myir/myd-ld25x/index.rst
@@ -1,3 +1,5 @@
+.. _board_myir_myd_ld25x:
+
 米尔科技MYD-LD25X开发板                                                              
 ###########################
  
diff --git a/docs/source/bsp/arm64/myir/myir-remi/myir-remi.rst b/docs/source/bsp/arm64/myir/myir-remi/myir-remi.rst
index 60fb8a94772..fbbb4dfed26 100644
--- a/docs/source/bsp/arm64/myir/myir-remi/myir-remi.rst
+++ b/docs/source/bsp/arm64/myir/myir-remi/myir-remi.rst
@@ -1,4 +1,6 @@
-myir-remi 镜像构建与说明                                                              
+.. _board_myir_remi:
+
+瑞米派镜像构建与说明
 ########################
  
 本章主要介绍openEuler Embedded中myir-remi（瑞米派）系列板卡的镜像构建，使用和特性介绍。
diff --git a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst
index 5aa6da17d2f..ea34525be89 100644
--- a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst
+++ b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst
@@ -1,4 +1,4 @@
-.. _hvaepic-m10:
+.. _board_hvaepic-m10:
 
 工控机HVAEIPC-M10
 #################
diff --git a/docs/source/bsp/x86/qemu/qemu.rst b/docs/source/bsp/x86/qemu/qemu.rst
index 53da09c9c7d..3660356741d 100644
--- a/docs/source/bsp/x86/qemu/qemu.rst
+++ b/docs/source/bsp/x86/qemu/qemu.rst
@@ -1,3 +1,5 @@
+.. _board_qemu_x86_64:
+
 QEMU-X86-64
 ###########
 
diff --git a/docs/source/developer_guide/develop/board-support/index.rst b/docs/source/developer_guide/develop/board-support/index.rst
index ea0c216afa1..ed720e15cb0 100644
--- a/docs/source/developer_guide/develop/board-support/index.rst
+++ b/docs/source/developer_guide/develop/board-support/index.rst
@@ -13,7 +13,7 @@
    add_new_bsp_layer.rst
 
 .. note::
-   如果厂商在 :ref:`board-support-list` 已经支持，可以按照下面的步骤快速新增。
+   如果厂商在 :ref:`bsp` 已经支持，可以按照下面的步骤快速新增。
 
 .. toctree::
    :maxdepth: 1
diff --git a/docs/source/features/mica/instruction.rst b/docs/source/features/mica/instruction.rst
index ace22031a95..961cd09fc59 100644
--- a/docs/source/features/mica/instruction.rst
+++ b/docs/source/features/mica/instruction.rst
@@ -294,7 +294,7 @@ ____
 
    当前 x86 工控机只支持运行 UniProton，并且 x86 的部署方法与 arm64 有所不同，整合工作还在进行中。
 
-首先，需要先根据 :ref:`工控机HVAEIPC-M10 镜像构建安装指导 <hvaepic-m10>` 在工控机上安装 openEuler Embedded 镜像。
+首先，需要先根据 :ref:`工控机HVAEIPC-M10 镜像构建安装指导 <board_hvaepic-m10>` 在工控机上安装 openEuler Embedded 镜像。
 
 之后，我们还需要编译 UniProton 以及 x86环境下需要的额外启动程序 ap_boot，
 请参考 `openEuler Embedded & Uniproton x86 MICA环境安装指导 <https://gitee.com/openeuler/UniProton/blob/master/doc/demo_guide/x86_64_usage.md>`_ 。
diff --git a/docs/source/features/mica/services/debug.rst b/docs/source/features/mica/services/debug.rst
index e7c0503661f..7d0fb543ebb 100644
--- a/docs/source/features/mica/services/debug.rst
+++ b/docs/source/features/mica/services/debug.rst
@@ -166,7 +166,7 @@
 基于x86工控机调测Uniproton
 ============================================
 
-工控机的具体介绍 :ref:`工控机 <hvaepic-m10>` 。
+工控机的具体介绍 :ref:`工控机 <board_hvaepic-m10>` 。
 
 相关接口定义
 -------------
diff --git a/docs/source/releases/release-notes-25.03.30.rst b/docs/source/releases/release-notes-25.03.30.rst
new file mode 100644
index 00000000000..af079dde5c7
--- /dev/null
+++ b/docs/source/releases/release-notes-25.03.30.rst
@@ -0,0 +1,54 @@
+:orphan:
+
+.. _openeuler_embedded_25_03_30:
+
+openEuler Embedded 25.03
+###########################
+
+openEuler Embedded 25.03特性上最大亮点是率先支持了openEuler新一代软件包机制epkg，同时本版本对以往遗留的深层次的问题做了系统性的清理
+本版的主要更新如下：
+
+* 基础设施
+
+  - 修复工具链对C++编译由于使能了--disable-libstdcxx-dual-abi造成ABI不兼容的问题
+
+  - 除软件包配方外，升级Yocto Kirkstone版本到4.0.26
+
+  - 完善构建容器的稳定性和兼容性，容器中的glibc版本降级到2.28
+
+* Linux框架
+
+  - 清理和完善systemd的支持
+
+  - 以鲲鹏920和x86为例子，清理内核配置
+
+  - 例行的内核版本更新
+
+* 关键特性
+
+  - 新增对epkg的支持, 可以在镜像中直接集成epkg, 无需额外的安装，具体使用参考 `epkg使用说明 <https://gitee.com/openeuler/epkg/blob/master/doc/epkg-usage.md>`_
+
+  - 混合关键性部署框架(MICA)
+
+    - 实现对Zephy的从源代码开始的端到端集成
+
+  - 嵌入式弹性底座的探索
+
+    - 完善XEN的支持
+
+* 南北向生态
+
+  - 南向BSP：
+
+    - 新增意法半导体STM32MP257的支持，详见 :ref:`board_myir_myd_ld25x`
+
+    - 新增嘉立创泰山派的支持，详见 :ref:`board_tspi_3566_build`
+
+    - 完善鲲鹏920及鲲鹏模组的支持
+
+    - 完善已有的BSP支持
+
+  - 北向软件：
+
+     - 清理和升级部分软件包支持
+
-- 
Gitee


From c1509c3abf3a7d796b061763a56f29318acf0792 Mon Sep 17 00:00:00 2001
From: Wayne Ren <renweihust@gmail.com>
Date: Mon, 28 Apr 2025 11:23:28 +0800
Subject: [PATCH 2/3] openeuler.bbclass: fix found issues

* fix code typos

Signed-off-by: Wayne Ren <renweihust@gmail.com>
---
 meta-openeuler/classes/openeuler.bbclass | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/meta-openeuler/classes/openeuler.bbclass b/meta-openeuler/classes/openeuler.bbclass
index 00ffab66aa1..092f381c519 100644
--- a/meta-openeuler/classes/openeuler.bbclass
+++ b/meta-openeuler/classes/openeuler.bbclass
@@ -252,7 +252,7 @@ def download_repo(d, repo_dir, repo_url ,version = None):
     # tracked files. You can see more detail by visiting https://git-scm.com/docs/git-sparse-checkout
     def oee_archive_download(oee_archive_dir:str, subdir: str):
         # if exists subdir and return
-        if os.path.exists(os.path.join(oee_archive_dir, sub_dir)):
+        if os.path.exists(os.path.join(oee_archive_dir, subdir)):
             return
         res = subprocess.run("git sparse-checkout init",
                         shell=True,
@@ -260,7 +260,7 @@ def download_repo(d, repo_dir, repo_url ,version = None):
                         text=True,
                         cwd=oee_archive_dir)
         if res.returncode != 0:
-            bb.fatal(f"in oee_archive run git sparse-checkout init faild, error: {res.stderr}")
+            bb.fatal(f"in oee_archive run git sparse-checkout init failed, error: {res.stderr}")
         res = subprocess.run(f"git sparse-checkout list | grep {subdir}", shell=True, cwd=oee_archive_dir)
         if res.returncode == 0:
             return
@@ -270,7 +270,7 @@ def download_repo(d, repo_dir, repo_url ,version = None):
                         text=True,
                         cwd=oee_archive_dir)
         if res.returncode != 0:
-            bb.fatal(f"in oee_archive run git sparse-checkout add {subdir} faild, error: {res.stderr}")
+            bb.fatal(f"in oee_archive run git sparse-checkout add {subdir} failed, error: {res.stderr}")
 
     if "oee_archive" in repo_url:
         sub_dir = d.getVar("OEE_ARCHIVE_SUB_DIR")
@@ -306,7 +306,7 @@ def download_repo(d, repo_dir, repo_url ,version = None):
     try:
         repo.git.checkout(version)
     except:
-        bb.warn("the version %s checkout failed ..." , version)
+        bb.warn("the version %s checkout failed ..." % version)
 
     # if the repo has large file it will has .gitattrbutes
     if os.path.exists(repo_dir+"/.gitattributes"):
-- 
Gitee


From 0d199cdf25e6dde325d91682f04a6c2a75f2e2c8 Mon Sep 17 00:00:00 2001
From: hanzongcheng <hanzongcheng@huawei.com>
Date: Tue, 29 Apr 2025 17:31:54 +0800
Subject: [PATCH 3/3] docs: add documentation for kp920 and epkg

* add documentation for kp920 and epkg

Signed-off-by: hanzongcheng <hanzongcheng@huawei.com>
---
 docs/source/bsp/arm64/hisilicon/index.rst     |  1 +
 .../bsp/arm64/hisilicon/kp920/kp920.rst       | 67 ++++++++++++++
 docs/source/bsp/x86/HVAEIPC-M10/m10.rst       |  2 +
 docs/source/features/epkg.rst                 | 91 +++++++++++++++++++
 docs/source/features/index.rst                |  1 +
 docs/source/getting_started/index.rst         |  2 +-
 6 files changed, 163 insertions(+), 1 deletion(-)
 create mode 100644 docs/source/bsp/arm64/hisilicon/kp920/kp920.rst
 create mode 100644 docs/source/features/epkg.rst

diff --git a/docs/source/bsp/arm64/hisilicon/index.rst b/docs/source/bsp/arm64/hisilicon/index.rst
index 60c8e35f342..45324640467 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 00000000000..0f305e0f60c
--- /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 介绍 <https://www.hisilicon.com/cn/products/Kunpeng/Huawei-Kunpeng/Huawei-Kunpeng-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-<version>.sh``: SDK工具链
+
+   - ``openeuler-image-kp920-[时间戳].iso``: 适用鲲鹏920的ISO镜像，可直接用于部署
+
+   - ``vmlinux``: 备用调试内核
+
+   - ``Image``: 备用内核镜像
+
+.. note::
+
+   需要其他功能时，请在oebuild初始化时通过 ``-f features`` 添加对应的 feature。见-f列表(oebuild generate -l)
+
+____
+
+安装说明
+========
+
+.. seealso::
+
+   参考 :ref:`openEuler Embedded ISO 镜像安装说明 <iso_install>`，若使用 BMC 进行安装，请在 BMC 界面挂载光驱并选择光驱启动之后进行镜像安装。
+
diff --git a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst
index ea34525be89..fe748740d4e 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 00000000000..8ceecac5063
--- /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包管理器使用说明 <https://gitee.com/openeuler/epkg/blob/master/doc/epkg-usage.md#epkg%E5%8C%85%E7%AE%A1%E7%90%86%E5%99%A8%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E>`_ 。
+
+以下为使用示例：
+
+1. EPKG包管理器命令说明
+
+   .. code-block:: console
+
+      Usage:
+          epkg install <package>
+          epkg remove [-y] <package>
+          epkg upgrade <package> （开发中...）
+
+          epkg list <glob-pattern>
+
+          epkg env list
+          epkg env create <env_name> [--repo <repo_name>]
+          epkg env remove <env_name>
+          epkg env activate <env_name> [--pure]
+          epkg env deactivate <env_name>
+          epkg env register|unregister <env_name>
+          epkg env history
+          epkg env rollback <history_id>
+
+2. 安装软件
+
+  功能描述：在当前activate的环境中安装软件，若无环境激活，默认安装到main环境中：``epkg env activate <env_name>``
+
+  命令：``epkg install <package>``
+
+  示例：
+
+  .. 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 <env_name>``
+
+  命令：``epkg remove <package>``
+
+  示例：
+
+  .. 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 e6200b730bd..28d4e3b5568 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 ee4668810be..78d238bb21a 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 介绍 <oebuild_install>` 章节。
 
-   - openEuler Embedded 的 CI 会归档最新的构建镜像。若希望快速获取可用的镜像，请访问 `dailybuild <http://121.36.84.172/dailybuild/openEuler-Mainline/>`_ ，在 ``dailybuild/openEuler-Mainline/openeuler-xxxx-xx-xx/embedded_img`` 中可以下载镜像。
+   - openEuler Embedded 的 CI 会归档最新的构建镜像。若希望快速获取可用的镜像，请访问 `dailybuild <http://121.36.84.172/dailybuild/EBS-openEuler-Mainline/>`_ ，在 ``embedded_img`` 中可以下载镜像。
 
 1. 安装必要的主机包
 -------------------
-- 
Gitee