# Appendices

## Debug software issues

The following procedure shows how to use the GNU Debugger (GDB) `dump` and `restore` commands for debugging software issues:

1. Set up the board to use CH347.
2. Configure and run GDB:

    1. Enter the `SDK\tools\jtag\openocd\ch347` folder.
    2. Modify the `gdb.gdbinit` file and set the `symbol-file` parameter to the path of `FERMION_QCLI_DEMO.elf`.
    3. Run `ch347_openocd_gdb.bat`.
3. Run the following command to get backtrace information:

> 
> 
> bt
>         Copy to clipboard
4. Run the following command to get register information:

info reg
        Copy to clipboard
5. Use GDB dump:

    - Dump binary format:

dump binary memory dump.bin 0x0 0xa0000
            Copy to clipboard
    - Dump HEX format:

dump ihex memory dump_hex.bin 0 0xa0000
            Copy to clipboard
6. Use GDB restore:

    - Restore binary format:

restore dump.bin binary 0 0 0xa0000
            Copy to clipboard
    - Restore HEX format:

restore dump_hex.bin ihex 0 0 0xa0000
            Copy to clipboard

## Download the code in WSL

The following instructions show how to set up the Git and Repo tools in Windows Subsystem for Linux (WSL), and then download the code from CodeLinaro.

Note

WSL 2 requires Windows 11 or Windows 10 (version 1903 or later).

### Enable the WSL and Virtual Machine Platform features

Perform the following steps to enable WSL and a virtual machine.

1. Open Command Prompt or PowerShell as an administrator.
2. Run the following command to enable WSL:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
        Copy to clipboard
3. Run the following command to enable a virtual machine:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
        Copy to clipboard
4. Restart the computer to apply the changes.

Note

`dism.exe` is usually built into Windows and is available in the Command shell or PowerShell. If it’s unavailable, see the instructions available at [learn.microsoft.com](https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/use-dism-in-windows-powershell-s14?view=windows-11)

### Install Ubuntu 22.04

Before you install Ubuntu in WSL, verify that virtualization is enabled in the BIOS and the Virtual Machine Platform feature is turned on in Windows. Run the following commands in PowerShell to install Ubuntu 22.04.

1. Update WSL.

wsl.exe --update
        Copy to clipboard
2. Set the WSL version to the default version `2`.

wsl.exe --set-default-version 2
        Copy to clipboard
3. Verify that you can install Ubuntu 22.04.

wsl.exe --list --online
        Copy to clipboard
4. Install Ubuntu 22.04.

wsl.exe --install Ubuntu-22.04
        Copy to clipboard
5. After the installation is complete, verify whether the installation has been done correctly.

wsl.exe --list
        Copy to clipboard

### Set up Git and Repo

1. Open a WSL Linux shell. To do this, search for **WSL** in the Windows search bar and open it.
2. Install the Repo tool by running the following commands:

sudo apt-get update
        sudo apt-get install repo
        Copy to clipboard
3. After installation, run the following commands to configure your Git username and email:

git config --global user.name "<your_name>"
        git config --global user.email "<your_email>"
        Copy to clipboard

    Replace `<your_name>` and `<your_email>` with the name and email you want to use in Git.

Note

CodeLinaro doesn’t require registration to access public resources. However, you still need to configure a Git user locally.

### Download the code from CodeLinaro

The following example shows how to download the code under WSL and access it from Windows.

1. Run the following command in Command Prompt to open a WSL Linux shell:

wsl -d Ubuntu-22.04
        Copy to clipboard
2. Create a folder under the `/mnt` directory in WSL, for example, `/mnt/c/workspace`, so that the content of this folder is accessible from both Windows and WSL. Run the following command in the WSL Linux shell:

mkdir /mnt/c/workspace/qcc730_fr_10
        Copy to clipboard
3. Go to the newly created folder:

cd /mnt/c/workspace/qcc730_fr_10
        Copy to clipboard
4. Run the following command to initialize the Repo client and configure the workspace:

repo init -u https://git.codelinaro.org/clo/le/le/product/manifest.git -b release -m AU_LINUX_EMBEDDED_IOT.FM.1.0.R1_TARGET_ALL.01.09.071.xml --repo-url=https://git.codelinaro.org/clo/tools/repo.git --repo-branch=aosp-new/stable
        Copy to clipboard

Note

The manifest file in the command is just an example. See the latest [QCC730.FR.1.0 Release Notes](https://docs.qualcomm.com/list?product=1601111739956092&amp;query=&amp;facetSoftwareReleases=Software%20Releases%2FQCC730.FR.1.0&amp;isFacet=true) for the current manifest file.
5. Run the following command to download the code from CodeLinaro:

repo sync -c --no-tags -j8
        Copy to clipboard

After the download is complete, you can access the code in the `C:\workspace\qcc730_fr_10` directory from Windows.

Last Published: Jun 16, 2026

[Previous Topic
Develop a sample application](https://docs.qualcomm.com/bundle/publicresource/80-Y8730-251/topics/dev_sample_app.md)