Contents

• For all permission issues
• Software Developer Portal News
  • Roaming test report
• NHX-SDK-ODM code repository
• Software module
• NHX SDK software framework
• Framework Process Icon Description
• NHX-PACKAGES-OPEN framework
• Git Repositories
  • Git Credential Helper Configuration (Recommended, only for bitswrt-clients repositories)
  • Git Usage Examples
    • 1. Clone Main Repository
    • 2. Pull Latest Code
    • 3. View Repository Status
    • 4. Switch Branches
    • 5. View Remote Repository Information
    • 6. Common Problem Resolution
  • Token Expiration: Update and Handling
• Firmware Release

For all permission issues

• For access to developer resources, please contact sales or technical support for approval.
  • README

Software Developer Portal News

Roaming test report

---

NHX-SDK-ODM code repository

Note:

• For access to code repositories, please contact sales or technical support for approval.
  • README

Permission Group Link	Project Name	openwrt	Driver	Kernel	SDK	Supported Models	Remarks
NHX4019-QSDK-11.5-ODM	NHX4019-QSDK-11.5-ODM	15.05	qsdk-11.5	v4.4	nhxwrt sdk source code; vendor-restricted binaries (e.g. QSDK drivers) not included	NHX4019	LTS Recommended
NHX5018-QSDK-11.5-ODM	NHX5018-QSDK-11.5-ODM	15.05	qsdk-11.5	v4.4	nhxwrt sdk source code; vendor-restricted binaries (e.g. QSDK drivers) not included	NHX5018	LTS
NHX53X2-QSDK-12.5-ODM	NHX53X2-QSDK-12.5-ODM	23.05	qsdk-12.5	v5.4	nhxwrt sdk source code; vendor-restricted binaries (e.g. QSDK drivers) not included	NHX53X2	LTS
NHX6018-QSDK-11.5-ODM	NHX6018-QSDK-11.5-ODM	15.05	qsdk-11.5	v4.4	nhxwrt sdk source code; vendor-restricted binaries (e.g. QSDK drivers) not included	NHX6018	LTS
NHX6018-QSDK-12.5-ODM	NHX6018-QSDK-12.5-ODM	23.05	qsdk-12.5	v5.4	nhxwrt sdk source code; vendor-restricted binaries (e.g. QSDK drivers) not included	NHX6018	LTS

Software module

Note:

• Software module permissions inherit repository access permissions.
  • README

Project Wiki	code delivery	supported models	remarks	Performance pk advantage level
NHX-STAROAM-BIN	pkg-bin	NHX4019, NHX5018, NHX6018, NHX53X2	Wireless roaming application	A
NHX-API-BIN	pkg-bin	NHX4019, NHX5018, NHX6018, NHX53X2	API Application
NHX-IAC-BIN	pkg-bin	NHX4019, NHX5018, NHX6018, NHX53X2	Wireless Controller Application
NHX-MESH-BIN	pkg-bin	NHX4019, NHX5018, NHX6018, NHX53X2	Mesh Application	A
NHX-VUE-ODM	pkg-src	NHX4019、NHX5018、NHX6018、NHX53X2	vue source code
nhxweb	pkg-bin	NHX4019、NHX5018、NHX6018、NHX53X2	vue binary web file
NHX-PACKAGES-OPEN	pkg-src	NHX4019、NHX5018、NHX6018、NHX53X2	Open Source Applications
NHX-DL	—	NHX4019、NHX5018、NHX6018、NHX53X2	Compile dependency cache library
NHX__-SDK	src	NHX4019、NHX5018、NHX6018、NHX53X2	Model file; dts file
nhx_longbridge	nhxwifiko	NHX5018、NHX6018、NHX53X2	Long distance transmission NHX-QSDK-12.2-ODM support	A
nhxpcf	nhxwifiko	NHX4019, NHX5018, NHX6018, NHX53X2	802.11 PCF	A
nhxhcf	nhxwifiko	NHX4019, NHX5018, NHX6018, NHX53X2	802.11 HCF	A
nhxant	nhxwifiko	NHX4019、NHX5018、NHX6018、NHX53X2	Smart antenna
nhxtdma	nhxwifiko	NHX5018、NHX6018、NHX53X2	TDMA	A

---

NHX SDK software framework

1. master branch: Source code for qsdk sdk kit excluding vendor-restricted binaries (e.g. the QSDK driver)

• master_nhx4019
• master_nhx5018
• master_nhx6018

1. nhxwrt branch: Source code for nhxwrt sdk kit excluding vendor-restricted binaries (e.g. the nhxwifiko driver); Deeply optimized driver; supports nhx applications

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

---

Framework Process Icon Description

graph LR
1>Project Node]
2[code repository node]
3[[Developer feeds node]]
4{{code repository branch node}}
5((public feeds node))

---

NHX-PACKAGES-OPEN framework

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"

---

Git Repositories

Usage:

• Access project: https://dev.bitswrt.com/devs/projects/project-name
• Click “Copy Clone Link” to get the complete repository address with token
• Use the provided token for code cloning

Git Credential Helper Configuration (Recommended, only for bitswrt-clients repositories)

1. Install Git Credential Manager

   • Ubuntu:

     # First visit https://github.com/GitCredentialManager/git-credential-manager/releases
     # Find the latest version and the corresponding tar.gz file name (e.g. v2.6.1, file: gcm-linux_amd64.2.6.1.tar.gz)
     # Example for v2.6.1:
     wget https://github.com/GitCredentialManager/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.tar.gz
     tar -xzf gcm-linux_amd64.2.6.1.tar.gz
     sudo mv git-credential-manager /usr/local/bin/
     sudo chmod +x /usr/local/bin/git-credential-manager
     rm gcm-linux_amd64.2.6.1.tar.gz
     
     # Verify installation
     git-credential-manager --version

2. Configure Git Credential Manager

   Execute the following commands in terminal:

   # Configure Git Credential Manager only for bitswrt-clients repositories
   git config --global credential.https://github.com/bitswrt-clients.helper manager
   
   # Set credential store (recommended for desktop environments)
   git config --global credential.credentialStore secretservice
   
   # Or use cache for server/headless environments
   # git config --global credential.credentialStore cache

3. Verify configuration

   Execute the following command to verify the configuration is correct:

   git config --global --list | grep credential

   You should see:

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

4. Automatic effect when cloning repositories

   When you clone or operate any repository under https://github.com/bitswrt-clients/, Git Credential Manager will be used automatically, and you do not need to enter your username and token every time.

5. Remove/reset configuration (if needed)

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

Git Usage Examples

After configuration, you can perform the following Git operations:

1. Clone Main Repository

# Clone NHX-QSDK-11.5-ODM main repository
# Username: bitswrt
# Project link already contains repository token and git link, copy and use directly
git clone https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# Use complete link format (recommended)
git clone https://bitswrt:[email protected]/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# Clone to specified directory
git clone https://bitswrt:[email protected]/bitswrt-clients/NHX-QSDK-11.5-ODM.git nhx-sdk-project

Get Complete Clone Link:

1. Visit project page: https://dev.bitswrt.com/devs/projects/NHX-QSDK-11.5-ODM
2. Click “Copy Clone Link” button
3. The copied link already contains username(bitswrt), token and repository address, can be used directly

2. Pull Latest Code

# Enter project directory
cd NHX-QSDK-11.5-ODM

# Pull latest code
git pull origin master

# Or specify branch
git pull origin nhxwrt

3. View Repository Status

# View current status
git status

# View branch information
git branch -a

# View commit history
git log --oneline -10

4. Switch Branches

# Switch to nhxwrt branch
git checkout nhxwrt

# Create and switch to new branch
git checkout -b feature/new-feature

# Switch to specific model branch
git checkout nhxwrt_nhx6018

5. View Remote Repository Information

# View remote repositories
git remote -v

# Add remote repository
git remote add upstream https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

6. Common Problem Resolution

# If authentication issues occur, clear credentials
git credential-manager reject https://github.com/bitswrt-clients/NHX-QSDK-11.5-ODM.git

# Force pull (overwrite local changes)
git fetch origin
git reset --hard origin/master

# View Git configuration
git config --list | grep credential

Note: On first operation, Git Credential Manager will pop up an authentication window. Enter your username and access token. After successful authentication, subsequent operations will automatically use saved credentials.

---

Token Expiration: Update and Handling

If your access token has a limited validity period due to security policies, please follow these steps after expiration:

1. Obtain a new access token
   Go to the project page (e.g., https://dev.bitswrt.com/devs/projects/project-name ) to generate and copy a new access token.

2. Clear locally saved old credentials
   It is recommended to use Git Credential Manager to clear credentials for the specific repository:

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

   Or use the following command to clear all credentials for the bitswrt-clients organization:

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

   To erase credentials for a specific repository (optional):

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

   Note: protocol specifies the protocol, host specifies the host, and path specifies the bitswrt-clients organization or specific repository.

3. Re-authenticate
   When you perform git pull, git push, or git clone, the system will prompt for your username (e.g., bitswrt) and the new access token.
   After successful authentication, Git Credential Manager will automatically save the new credentials until the token expires again.

For automated credential cleanup and update, you may write scripts as needed.

---

Firmware Release