Contents

• 对于所有权限问题
• 软件开发者门户新闻
  • 漫游测试报告
• NHX-SDK-ODM 代码仓库
• 软件模块
• NHX SDK 软件框架
• 框架流程图标说明
• NHX-PACKAGES-OPEN 框架
• pipelines
  • NHX-SDK pipelines
  • NHX-PACKAGES-BIN pipelines
  • NHX-PACKAGES-OPEN pipelines
• Git 存储库
  • Git 使用示例
    • 1. 克隆主仓库
    • 2. 拉取最新代码
    • 3. 查看仓库状态
    • 4. 切换分支
    • 5. 查看远程仓库信息
    • 6. 常见问题解决
  • Token 过期后的更新与处理
• 固件发布

对于所有权限问题

• 如需访问开发者资源，请联系销售或技术支持审批
  • README

软件开发者门户新闻

漫游测试报告

---

• 烦请认真仔细查看！烦请认真仔细查看！烦请认真仔细查看！
• 烦请认真仔细查看！烦请认真仔细查看！烦请认真仔细查看！
• 烦请认真仔细查看！烦请认真仔细查看！烦请认真仔细查看！

---

NHX-SDK-ODM 代码仓库

备注:

• 如需访问代码仓库，请联系销售或技术支持审批
  • README

权限组链接	仓库	openwrt	Driver	内核	SDK	支持机种	备注
FAE-NHX-QSDK-11.5-ODM	NHX-QSDK-11.5-ODM	15.05	qsdk-11.5	v4.4	nhxwrt sdk 套件的源代码; 不包括供应商限制的二进制文件（例如 QSDK 驱动程序）	NHX4019 NHX5018 NHX6018	LTS 推荐
FAE-NHX-QSDK-12.2-ODM	NHX-QSDK-12.2-ODM	19.07	qsdk-12.2	v5.4	nhxwrt sdk 套件的源代码; 不包括供应商限制的二进制文件（例如 QSDK 驱动程序）	NHX5018 NHX6018 NHX53X2-V01 NHX53X2-V03	LTS
FAE-NHX-QSDK-12.5-ODM	NHX-QSDK-12.5-ODM	23.05	qsdk-12.5	v5.4	nhxwrt sdk 套件的源代码; 不包括供应商限制的二进制文件（例如 QSDK 驱动程序）	NHX5018 NHX6018 NHX53X2	LTS
Requires project permission group	NHX-ATH11K-ODM	21.02	ath11k	v5.4	Open-source wireless drivers (ath11k)	NHX4019 NHX5018 NHX6018

软件模块

备注:

• 软件模块权限继承仓库访问权限。
  • README

项目wiki	Git 仓库	代码交付	支持机种	功能	性能pk优势等级
NHX-STAROAM-BIN	NHX-STAROAM	pkg_bin	NHX4019、NHX5018、NHX6018、NHX53X2	无线漫游应用	A
NHX-API-BIN	NHX-API	pkg_bin	NHX4019、NHX5018、NHX6018、NHX53X2	api应用
NHX-IAC-BIN	NHX-IAC	pkg_bin	NHX4019、NHX5018、NHX6018、NHX53X2	无线控制器应用
NHX-MESH-BIN	NHX-MESH	pkg_bin	NHX4019、NHX5018、NHX6018、NHX53X2	mesh应用	A
NHX-VUE-ODM	NHX-VUE	pkg_src	NHX4019、NHX5018、NHX6018、NHX53X2	vue web 源代码
nhxweb	nhxweb	pkg_bin	NHX4019、NHX5018、NHX6018、NHX53X2	vue web 二进制
NHX-PACKAGES-OPEN	NHX-PACKAGES-OPEN	pkg_src	NHX4019、NHX5018、NHX6018、NHX53X2	开源应用库
NHX-DL	NHX-DL	—	NHX4019、NHX5018、NHX6018、NHX53X2	编译依赖缓存库
NHX__-SDK	NHX-SDK	src	NHX4019、NHX5018、NHX6018、NHX53X2	机种文件;dts文件
nhx_longbridge	nhx_longbridge	nhxwifiko	NHX5018、NHX6018、NHX53X2	远距离传输 NHX-QSDK-12.2-ODM 支持	A
nhxdcs	nhxdcs	nhxwifiko	NHX4019、NHX5018、NHX6018、NHX53X2	动态信道选择 避让干扰信道	A
nhxpcf	nhxpcf	nhxwifiko	NHX4019、NHX5018、NHX6018、NHX53X2	802.11 PCF	A
nhxhcf	nhxhcf	nhxwifiko	NHX4019、NHX5018、NHX6018、NHX53X2	802.11 HCF	A
nhxant	nhxant	nhxwifiko	NHX4019、NHX5018、NHX6018、NHX53X2	Smart antenna
nhxtdma	nhxtdma	nhxwifiko	NHX5018、NHX6018、NHX53X2	TDMA	A

---

NHX SDK 软件框架

1. master分支: qsdk sdk 套件的源代码，不包括供应商限制的二进制文件（例如 QSDK 驱动程序）

• master_nhx6018
• master_nhx5018
• master_nhx4019

1. nhxwrt分支: nhxwrt sdk 套件的源代码，不包括供应商限制的二进制文件（例如 nhxwifiko 驱动程序）;深度优化驱动;支持nhx应用

• nhxwrt_NHX53X2
• nhxwrt_NHX6018
• nhxwrt_nhx6018 4g
• nhxwrt_nhx6018-64bit
• nhxwrt_nhx6018-64bit-4g
• nhxwrt_NHX5018
• nhxwrt_NHX4019

---

框架流程图标说明

graph LR
1>项目节点]
2[代码仓库节点]
3[[开发者 feeds 节点]]
4{{代码仓库分支节点}}
5((公共 feeds 节点))

---

NHX-PACKAGES-OPEN 框架

graph LR
A>NHX-PACKAGES-OPEN]-.Repos..->B[[NHX-PACKAGES-OPEN]]
B ---> B1[network]
B ---> B2[firmware]

B1 ---> B101[iperf]
B1 ---> B102[iperf3]

B101-.ipk..->Z((docs.bitswrt.com))
B102-.ipk..->Z
B2-.ipk..->Z

subgraph all package-open repos
B
end

subgraph all package-open ipk
Z
end

click Z "http://docs.bitswrt.com"
click A "https://dev.azure.com/lede/NHX-PACKAGES-OPEN"

---

pipelines

NHX-SDK pipelines

• Publish firmware to docs.bitswrt.com azure-build/NHX6018-Product model.yml azure-build/NHX5018-Product model.yml azure-build/NHX4019-Product model.yml azure-build/CPE7621-Product model.yml

---

NHX-PACKAGES-BIN pipelines

• Publish to Repos [packages name] Naming rules for pipelines:qca-packages name-bin.yml mtk-packages name-bin.yml PKG naming rules:qca-packages name-bin mtk-packages name-bin Note: each private PKG corresponds to a PKG feed warehouse

NHX-PACKAGES-OPEN pipelines

• Publish to docs.bitswrt.com (ipk file) Naming rules for pipelines:mtk-package-bin.yml mtk-package-bin.yml PKG naming rules:packages name

---

Git 存储库

使用方法：

• 访问项目：https://dev.bitswrt.com/devs/projects/项目名称
• 点击”复制Clone链接”获取包含token的完整仓库地址
• 使用提供的token进行代码克隆

Git Credential Helper 配置（推荐，仅对 bitswrt-clients 仓库生效）：

1. 安装 Git Credential Manager

   • macOS：

     brew install git-credential-manager

   • Windows： 已集成在 Git for Windows 中，无需单独安装。
   • Linux（Debian/Ubuntu）：

     sudo apt-get update
     sudo apt-get install git-credential-manager

   • Linux（CentOS/RHEL）：

     sudo yum install git-credential-manager

2. 只针对 bitswrt-clients 仓库配置 credential helper

   在终端执行：

   git config --global credential.https://github.com/bitswrt-clients.helper manager

3. 验证配置

   执行：

   git config --global --list | grep credential

   你应该能看到：

   credential.https://github.com/bitswrt-clients.helper=manager

4. 克隆仓库时自动生效

   以后你在克隆或操作 https://github.com/bitswrt-clients/ 下的所有仓库时，都会自动使用 Git Credential Manager，无需每次输入用户名和密码。

5. 取消/重置配置（如需）

   git config --global --unset credential.https://github.com/bitswrt-clients.helper

Git 使用示例

配置完成后，您可以进行以下Git操作：

1. 克隆主仓库

# 克隆NHX-QSDK-11.5-ODM主仓库
# 用户名: bitswrt
# 项目链接已包含仓库token和git链接，直接复制使用即可
git clone https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# 使用完整链接格式（推荐）
git clone https://bitswrt:[email protected]/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# 克隆到指定目录
git clone https://bitswrt:[email protected]/bitswrt-clients/NHX-QSDK-11.5-ODM.git nhx-sdk-project

获取完整克隆链接:

1. 访问项目页面: https://dev.bitswrt.com/devs/projects/NHX-QSDK-11.5-ODM
2. 点击”复制Clone链接”按钮
3. 复制的链接已包含用户名(bitswrt)、token和仓库地址，可直接使用

2. 拉取最新代码

# 进入项目目录
cd NHX-QSDK-11.5-ODM

# 拉取最新代码
git pull origin master

# 或者指定分支
git pull origin nhxwrt

3. 查看仓库状态

# 查看当前状态
git status

# 查看分支信息
git branch -a

# 查看提交历史
git log --oneline -10

4. 切换分支

# 切换到nhxwrt分支
git checkout nhxwrt

# 创建并切换到新分支
git checkout -b feature/new-feature

# 切换到指定机种分支
git checkout nhxwrt_nhx6018

5. 查看远程仓库信息

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add upstream https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

6. 常见问题解决

# 如果遇到认证问题，清除凭证
git credential-manager reject https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# 强制拉取（覆盖本地更改）
git fetch origin
git reset --hard origin/master

# 查看Git配置
git config --list | grep credential

注意: 首次操作时，Git Credential Manager会弹出认证窗口，输入您的用户名和访问令牌即可。认证成功后，后续操作将自动使用保存的凭证。

---

Token 过期后的更新与处理

如因安全策略，访问令牌（Token）存在有效期限制，过期后请按以下步骤操作：

1. 获取新的访问令牌
   请前往项目页面（如 https://dev.bitswrt.com/devs/projects/项目名称 ）生成并复制新的访问令牌。

2. 清除本地已保存的旧凭证
   推荐使用 Git Credential Manager 命令清除指定仓库的旧凭证：

   git credential-manager reject https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

   或使用以下命令清除 bitswrt-clients 组织的所有凭证：

   printf "protocol=https\nhost=github.com\npath=bitswrt-clients\n" | git credential-manager erase

   如需清除特定仓库的凭证（可选）：

   printf "protocol=https\nhost=github.com\npath=bitswrt-clients/NHX-QSDK-11.5-ODM.git\n" | git credential-manager erase

   说明：protocol 为协议，host 为主机，path 指定 bitswrt-clients 组织或具体仓库。

3. 重新认证
   当您执行 git pull、git push 或 git clone 时，系统会提示您输入用户名（例如 bitswrt）和新的访问令牌。
   认证成功后，Git Credential Manager 将自动保存新的凭据，直到令牌再次过期。

如需自动清理和更新凭据，您可以根据需要编写脚本。

---

固件发布