Skip to content

Conversation

@zifeng-radxa
Copy link
Contributor

docs: add ONNXRuntime QNN Execution Provider zh docs

@zifeng-radxa zifeng-radxa requested review from a team, akgnah and xzuoqi as code owners December 22, 2025 07:36
Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 To request another review, post a new comment with "/windsurf-review".

</NewCodeBlock>

:::tip
请提根据实际 QAIRT SDK 路径修改 `backend_path` 路径
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a typo in this tip section. '请提根据实际 QAIRT SDK 路径修改' should be '请根据实际 QAIRT SDK 路径修改'.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@zifeng-radxa
Copy link
Contributor Author

/windsurf-review

Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 To request another review, post a new comment with "/windsurf-review".

<NewCodeBlock tip="Device" type="device">

```bash
pip3 install -r requirement.txt
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a typo in the pip install command for requirements. The correct filename should be 'requirements.txt' (with an 's').

Suggested change
pip3 install -r requirement.txt
pip3 install -r requirements.txt

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@zifeng-radxa
Copy link
Contributor Author

/windsurf-review

Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 To request another review, post a new comment with "/windsurf-review".


```bash
pip3 install -r requirements.txt
./build.sh --use_qnn --qnn_home [QNN_SDK_PATH] --build_shared_lib --build_wheel --config Release --parallel --skip_tests --build_dir build/Linux
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The build.sh command contains --qnn_home [QNN_SDK_PATH] but doesn't explain what value should replace [QNN_SDK_PATH]. Consider adding a note explaining this should be replaced with the path to the QAIRT SDK installation directory.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add tip. done


# Create an ONNX Runtime session.
# TODO: Provide the path to your ONNX model
session = onnxruntime.InferenceSession("job_jpy6ye005_optimized_onnx/model.onnx",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The example code uses a hardcoded model path job_jpy6ye005_optimized_onnx/model.onnx which won't match what users download. Consider replacing this with a more generic path and adding a comment to remind users to update it with their actual downloaded model path.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add tip. done

session = onnxruntime.InferenceSession("job_jpy6ye005_optimized_onnx/model.onnx",
sess_options=options,
providers=["QNNExecutionProvider"],
provider_options=[{"backend_path": "libQnnHtp.so"}]) # Provide path to Htp dll in QNN SDK
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The backend_path parameter is set to just "libQnnHtp.so" without a full path. This will only work if the library is in the system's library search path. Consider updating this to use a full path like "$QNN_SDK_ROOT/lib/aarch64-oe-linux-gcc11.2/libQnnHtp.so" or adding a note explaining how to specify the correct full path.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add tip, done

@zifeng-radxa
Copy link
Contributor Author

/windsurf-review

Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me 🤙

💡 To request another review, post a new comment with "/windsurf-review".

@peterwang2050 peterwang2050 merged commit e9334b4 into radxa-docs:main Dec 23, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants