* update qrcode.md

Author: lxowalle

components/maix/CMakeLists.txt

@@ -23,7 +23,7 @@ append_srcs_dir(ADD_SRCS "src")     # append source file in src dir to var ADD_S
 ###############################################
 
 ###### Add required/dependent components ######
-list(APPEND ADD_REQUIREMENTS pybind11 python3 basic nn peripheral ext_dev vision comm network voice)
+list(APPEND ADD_REQUIREMENTS pybind11 python3 basic nn peripheral ext_dev vision comm network voice vision_extra)
 ###############################################
 
 ###### Add link search path for requirements/libs ######

docs/doc/en/vision/qrcode.md

@@ -94,3 +94,66 @@ List common parameters and their explanations. If you cannot find parameters tha
 | qrcoder_type | Set the QR code library decoder type; you can choose either `image.QRCodeDecoderType.QRCODE_DECODER_TYPE_ZBAR` or `image::QRCodeDecoderType::QRCODE_DECODER_TYPE_QUIRC`. `QRCODE_DECODER_TYPE_ZBAR` offers faster recognition speed and higher accuracy at lower resolutions. `QRCODE_DECODER_TYPE_QUIRC` is relatively faster at higher resolutions but with slightly lower accuracy. By default, `QRCODE_DECODER_TYPE_ZBAR` is used.<br />Effective in version 4.7.7 and later. | img.find_qrcodes(decoder_type=image.QRCodeDecoderType.QRCODE_DECODER_TYPE_ZBAR) |
 
 This article introduces common methods. For more API details, refer to the [image](../../../api/maix/image.md) section of the API documentation.
+
+## Using Hardware Acceleration for QR Code Detection
+
+MaixPy includes a built-in `image.QRCodeDetector` object that can use hardware acceleration for QR code detection. At a resolution of 320x224, the maximum frame rate for a single-frame algorithm can reach 60+ fps.
+
+> Note: This feature is supported in MaixPy v4.7.9 and later versions
+
+### Usage
+
+```python
+from maix import camera, display, app, image
+
+cam = camera.Camera(320, 224)
+disp = display.Display()
+detector = image.QRCodeDetector()
+
+while not app.need_exit():
+    img = cam.read()
+
+    qrcodes = detector.detect(img)
+    for q in qrcodes:
+        img.draw_string(0, 0, "payload: " + q.payload(), image.COLOR_BLUE)
+
+    disp.show(img)
+```
+
+Steps:
+
+1. Import the `image`, `camera`, and `display` modules:
+
+   ```python
+   from maix import camera, display, app, image
+   ```
+
+2. Capture and display the image:
+
+   ```python
+   cam = camera.Camera(320, 224)
+   disp = display.Display()
+   
+   while not app.need_exit():
+       img = cam.read()
+       disp.show(img)
+   ```
+
+   - Create `Camera` and `Display` objects. Use the `cam.read()` method to capture the image and the `disp.show()` method to display it.
+
+3. Create a `QRCodeDetector` object for QR code detection:
+
+   ```python
+   detector = image.QRCodeDetector()
+   ```
+
+4. Use the `detect` method to detect QR codes, saving the results in the `qrcodes` variable:
+
+   ```python
+   qrcodes = detector.detect(img)
+   for q in qrcodes:
+       img.draw_string(0, 0, "payload: " + q.payload(), image.COLOR_BLUE)
+   ```
+
+   - Note: The detection process will utilize NPU resources. If other models are using the NPU at the same time, it may cause unexpected results.
+   - The structure of the detection result is the same as the data returned by `find_qrcodes`. Refer to the `QRCode` object's methods to access the detection results. For example, calling `q.payload()` will retrieve the QR code's content string.

docs/doc/zh/vision/qrcode.md

@@ -5,6 +5,7 @@ update:
     author: lxowalle
     version: 1.0.0
     content: 初版文档
+              
 ---
 
 阅读本文前，确保已经知晓如何开发MaixCAM，详情请阅读[快速开始](../README.md)
@@ -96,3 +97,65 @@ while 1:
 
 本文介绍常用方法，更多 API 请看 API 文档的 [image](../../../api/maix/image.md) 部分。
 
+## 使用硬件加速的方法识别二维码
+
+MaixPy内置了一个`image.QRCodeDetector`对象可以使用硬件加速的方法识别二维码，在320x224分辨率下单帧算法最高速度可以到60+fps
+
+> 注：MaixPy v4.7.8之后的版本支持该方法（不包括v4.7.8）
+
+### 使用方法
+
+```python
+from maix import camera, display, app, image
+
+cam = camera.Camera(320, 224)
+disp = display.Display()
+detector = image.QRCodeDetector()
+
+while not app.need_exit():
+    img = cam.read()
+
+    qrcodes = detector.detect(img)
+    for q in qrcodes:
+        img.draw_string(0, 0, "payload: " + q.payload(), image.COLOR_BLUE)
+
+    disp.show(img)
+```
+
+步骤：
+
+1. 导入image、camera、display模块
+
+   ```python
+   from maix import camera, display, app, image
+   ```
+
+2. 捕获和显示图像
+
+   ```python
+   cam = camera.Camera(320, 224)
+   disp = display.Display()
+   
+   while not app.need_exit():
+       img = cam.read()
+       disp.show(img)
+   ```
+
+   - 创建`Camera`和`Display`对象，通过`cam.read()`方法来捕获图像，用`disp.show()`方法来显示图像
+
+3. 创建`QRCodeDetector`对象来检测二维码
+
+   ```python
+   detector = image.QRCodeDetector()
+   ```
+
+4. 使用`detect`方法来检测二维码，检测结果保存到`qrcodes`变量中
+
+   ```python
+   qrcodes = detector.detect(img)
+   for q in qrcodes:
+       img.draw_string(0, 0, "payload: " + q.payload(), image.COLOR_BLUE)
+   ```
+
+   - 注意：检测过程中会占用NPU资源，如果此时有其他模型也再使用，则可能导致意外的结果
+   - 检测的结果与`find_qrcodes`返回结果的数据结构一致，参考`QRCode`对象的方法来获取检测结果。例如：调用`q.payload()`即可获取二维码的内容字符串。

examples/vision/image_basic/qrcode_detect.py

@@ -0,0 +1,20 @@
+from maix import camera, display, app, time, image
+
+cam = camera.Camera(320, 224)
+disp = display.Display()
+detector = image.QRCodeDetector()
+while not app.need_exit():
+    img = cam.read()
+
+    t = time.ticks_ms()
+    qrcodes = detector.detect(img)
+    t2 = time.ticks_ms()
+    print(f"detect use {t2 - t} ms, fps:{1000 / (t2 - t)}")
+    for q in qrcodes:
+        corners = q.corners()
+        for i in range(4):
+            img.draw_line(corners[i][0], corners[i][1], corners[(i + 1) % 4][0], corners[(i + 1) % 4][1], image.COLOR_RED)
+        img.draw_string(0, 0, "payload: " + q.payload(), image.COLOR_BLUE)
+
+    disp.show(img)
+