udpate projects

Author: Neutree

docs/doc/en/projects/README.md

@@ -1,38 +1,98 @@
 ---
-title: Practical Projects with MaixCAM MaixPy, Introduction and Collection
+title: Introduction and Summary of MaixCAM MaixPy Project Practices
 ---
 
 ## Introduction
 
-Here we provide some common practical project examples for community members to refer to and replicate for use. This also helps to inspire everyone to create more and better applications and projects.
+This section provides:
 
-There are several ways to find projects implemented with MaixPy:
+* Several common project practice examples for community members to reference and replicate, as well as to inspire more and better applications and projects.
+* Some open-source projects from community members for learning and reference.
 
-## MaixPy Official Documentation
+Besides this document, there are several other ways to find MaixPy-based projects:
 
-You can find practical projects in the documentation on the left, such as "Line Following Car."
+### MaixPy Official Documentation
 
-If you have a good project or a recommended project, you can also contribute by adding it to the documentation.
+You can find practical projects in the menu on the left side of this documentation, such as `Line Following Car`.
 
+If you have a good project or a recommended one, you're very welcome to click the "Edit this page" button in the top right corner and submit a PR (Pull Request) to add it to the documentation.
 
-## MaixHub Project Sharing Square
+### MaixHub Project Sharing Plaza
 
-Projects can be found in the [MaixHub Project Sharing](https://maixhub.com/share?type=project) section.
+You can find shared projects in the [MaixHub Project Sharing](https://maixhub.com/share?type=project) section.
 
-High-quality shares will also be linked to the MaixPy official documentation.
+High-quality projects may also be linked in the MaixPy official documentation.
 
-You can also share your project-making methods, which will receive official rewards (guaranteed) and cash tips from community members (usually, high-quality projects that meet urgent needs are more likely to be tipped).
+You’re encouraged to share your project tutorials there—this earns you official (guaranteed) and community member cash rewards (especially for high-quality, urgently needed solutions).
 
-Recommend Projects:
-* maixcam deploy yolov5s model: https://maixhub.com/share/23
+### MaixHub App Sharing
 
+Besides project sharing, you can also find runnable applications in the [MaixHub App Store](https://maixhub.com/app). Some of them may be written with MaixPy, and if the author provides source code or detailed tutorials, they’re worth learning from.
 
+### GitHub Search
 
-## MaixHub App Sharing
+Searching for `MaixPy` or `MaixCAM` on [GitHub](https://github.com) can also lead you to many high-quality open-source projects.
 
-In addition to project sharing, you can also find directly runnable applications at the [MaixHub App Store](https://maixhub.com/app), some of which might be written in MaixPy. If the author has provided the source code or written detailed tutorials, these can also be referred to.
 
-Recommend Projects:
-* Simple HTTP Streaming Server: https://maixhub.com/app/19
-* Desktop Computer Performance Monitor: https://maixhub.com/app/13
-* Safety Helmet Detection Model Application: https://maixhub.com/app/10
+## Open Source Project Summary
+
+These are usually complete projects that include source code, documentation, demo videos, and more.
+
+### Tools
+
+* [MaixPy-UI-Lib](https://github.com/aristorechina/MaixPy-UI-Lib): A lightweight UI library developed with MaixPy, written in pure Python. It supports a variety of widgets, is easy to use and extend, and includes many example codes such as LAB/HSV offline threshold tuning tools.
+* [Offline Threshold Tuning Tool Based on MaixPy](https://maixhub.com/share/103): A class-based offline threshold tuning tool with no third-party dependencies—ready to use directly.
+* [Using Serial Screen for Offline Threshold Adjustment on Maixcam](https://maixhub.com/share/104): Connects to an external serial screen to enable offline threshold adjustment, suitable for applications requiring an external display.
+* [CAM Offline Manual Threshold Editor](https://maixhub.com/share/102): Another manual offline threshold editor with simple and easy-to-understand code, great for learning and reference.
+
+### Competition
+
+* [MaixCam-Tic-Tac-Toe – 2024 National College Student Electronic Design Competition (Problem E - Tic-Tac-Toe Game Device)](https://github.com/HYK-X/MaixCam_Tic_Tac_Toe_2024): A tic-tac-toe robot project based on the Sipeed Maix series development board, using computer vision techniques. This is a complete solution for the 2024 National College Student Electronic Design Competition (Problem E - Tic-Tac-Toe Game Device).
+
+### Photography
+
+Waiting for your contribution.
+
+### Surveillance and Smart Home
+
+Waiting for your contribution.
+
+### Automation & Efficiency Tools
+
+Waiting for your contribution.
+
+### Robotics
+
+Waiting for your contribution.
+
+### More
+
+For more categories, feel free to submit an issue to discuss and suggest additions.
+
+
+## Experience Sharing Summary
+
+These are usually simpler tips, experiences, and code snippets shared by the community, useful for learning and reference.
+
+
+### UI Related
+
+* [MaixPy-UI-Lib](https://github.com/aristorechina/MaixPy-UI-Lib): A lightweight UI library written in pure Python for MaixPy, supporting multiple widgets, simple to use, easy to extend, and includes many example codes like LAB/HSV offline threshold tuning tools.
+* [Offline Threshold Tuning Tool based on MaixPy](https://maixhub.com/share/103): A class-wrapped threshold tuning tool with no third-party dependencies—ready to use.
+* [Using Serial Screen for Offline Threshold Adjustment on maixcam](https://maixhub.com/share/104): Connects to a serial screen to enable offline threshold adjustment, suitable for external screen applications.
+* [CAM Offline Manual Threshold Editor](https://maixhub.com/share/102): Another simple and easy-to-understand offline threshold editor, ideal for learning and reference.
+
+### Peripheral Related
+
+* [Driving WS2812 for Lighting and Color Compensation with MaixCam](https://maixhub.com/share/90): Uses MaixCAM to drive WS2812 LED lights via hardware SPI.
+* [Capturing PWM Frequency and Duty Cycle with MaixCAM-Pro](https://maixhub.com/share/98): Captures PWM frequency and duty cycle using SPI, suitable for measuring PWM signals.
+* [Using MaixCAM Bluetooth Function · Hardware Part](https://maixhub.com/share/58)
+
+### Image Algorithm Related
+
+* [Open-source: Simple Pose Estimation under Perspective Projection using cv2.solvePnP](https://maixhub.com/share/93): Detects the 3D pose of an object.
+* [Generating QR Codes with MaixPy](https://maixhub.com/share/79): Generates QR codes using the `qrcode` library.
+
+## More
+
+This summary is not updated in real-time. For more resources, please refer to the methods mentioned at the beginning of this article.

docs/doc/zh/projects/README.md

@@ -4,18 +4,20 @@ title: MaixCAM MaixPy 项目实战 介绍和汇总
 
 ## 简介
 
-这里提供一些常见的项目实战示例，方便社区成员可以参考复现使用，也方便激发大家的灵感做出更多更好的应用和项目出来。
+这里提供：
+* 一些常见的项目实战示例，方便社区成员可以参考复现使用，也方便激发大家的灵感做出更多更好的应用和项目出来。
+* 一些社区成员的开源项目，方便大家参考学习。
 
-要找到用 MaixPy 实现的相关的项目，有几种方式：
+除了这里，要找到用 MaixPy 实现的相关的项目，还有有几种方式：
 
-## MaixPy 官方文档
+### MaixPy 官方文档
 
 也就是本文档左边目录可以找到的项目实战，比如`小车巡线`。
 
-如果你有好的项目，或者好的项目推荐，也可以贡献文档添加进来。
+如果你有好的项目，或者好的项目推荐，也可以点击右上角编辑文档，添加 PR（Pull Request） 添加到文档，非常欢迎。
 
 
-## MaixHub 项目分享广场
+### MaixHub 项目分享广场
 
 
 在[MaixHub 项目分享](https://maixhub.com/share?type=project) 栏目可以找到项目分享。
@@ -25,17 +27,78 @@ title: MaixCAM MaixPy 项目实战 介绍和汇总
 你也可以分享你的项目制作方法，会获得官方（必获得）以及社区成员的现金打赏（通常高质量能解决急需需求的更容易被打赏）。
 
 
-推荐项目：
-* maixcam部署yolov5s 自定义模型: https://maixhub.com/share/23
+### MaixHub 应用分享
 
+除了项目分享以外，还可以在[MaixHub 应用商店](https://maixhub.com/app) 找到可以直接运行的应用，有部分应用可能是用 MaixPy 编写的，如果作者提供了源码或者写了详细的教程也都可以参考。
 
-## MaixHub 应用分享
+### GitHub 搜索
+
+在 [GitHub](https://github.com) 上搜索 `MaixPy` 或者 `MaixCAM` 也可以找到一些高质量的开源项目。
+
+
+## 开源项目汇总
+
+通常是完整的项目，包含代码、文档、演示视频等。
+
+### 工具类
+
+* [MaixPy-UI-Lib](https://github.com/aristorechina/MaixPy-UI-Lib): 一款基于 MaixPy 编写的轻量 UI 库，纯 Python 实现，支持多种控件，使用简单方便，也方便学习扩展，里面还有很多示例代码，比如 LAB/HSV 脱机阈值调试工具。
+* [基于 MaixPy 实现的脱机阈值调试](https://maixhub.com/share/103)：实现了一个类封装脱机阈值调试工具，无三方依赖，直接调用即可使用。
+* [maixcam 脱机使用串口屏调节阈值](https://maixhub.com/share/104)：外接一个串口屏，实现了脱机调节阈值的功能，适合需要外接屏幕的场景。
+* [CAM脱机手动阈值编辑器](https://maixhub.com/share/102)： 又一个脱机手动阈值编辑器，代码简单易懂，适合学习和参考。
+
+### 竞赛类
+
+* [MaixCam-Tic-Tac-Toe 2024年全国大学生电子设计竞赛（E题 - 三子棋游戏装置）](https://github.com/HYK-X/MaixCam_Tic_Tac_Toe_2024): 基于 Sipeed Maix 系列开发板，使用计算机视觉技术实现的三子棋（井字棋）对弈机器人项目。该项目是 2024年全国大学生电子设计竞赛（E题 - 三子棋游戏装置） 的一个完整解决方案。
+
+### 拍摄类
+
+等你来分享。
+
+### 监控和智能家居类
+
+等你来分享。
+
+### 自动化提高效率
+
+等你来分享。
+
+### 机器人
+
+等你来分享。
+
+### 更多
+
+更多分类提交 issue 讨论添加。
+
+
+
+## 经验分享汇总
+
+通常是比较简单的经验和代码片段分享，方便大家学习和参考。
+
+### UI 相关
+
+* [MaixPy-UI-Lib](https://github.com/aristorechina/MaixPy-UI-Lib): 一款基于 MaixPy 编写的轻量 UI 库，纯 Python 实现，支持多种控件，使用简单方便，也方便学习扩展，里面还有很多示例代码，比如 LAB/HSV 脱机阈值调试工具。
+* [基于 MaixPy 实现的脱机阈值调试](https://maixhub.com/share/103)：实现了一个类封装脱机阈值调试工具，无三方依赖，直接调用即可使用。
+* [maixcam 脱机使用串口屏调节阈值](https://maixhub.com/share/104)：外接一个串口屏，实现了脱机调节阈值的功能，适合需要外接屏幕的场景。
+* [CAM脱机手动阈值编辑器](https://maixhub.com/share/102)： 又一个脱机手动阈值编辑器，代码简单易懂，适合学习和参考。
+
+### 外设相关
+
+* [MaixCam驱动WS2812进行补光和颜色补偿](https://maixhub.com/share/90): 使用 MaixCAM 驱动 WS2812 LED 灯（使用了硬件 SPI驱动）。
+* [使用 MaixCAM-Pro 捕获 PWM 的频率和占空比](https://maixhub.com/share/98): 使用 SPI 捕获 PWM 的频率和占空比，适合需要测量 PWM 信号的场景。
+* [使用MaixCAM的蓝牙功能 · 硬件篇](https://maixhub.com/share/58)
+* [使用MaixCAM的蓝牙功能 · 软件篇](https://maixhub.com/share/62)
+
+### 图像算法相关
+
+* [MaixCam-Tic-Tac-Toe 2024年全国大学生电子设计竞赛（E题 - 三子棋游戏装置）](https://github.com/HYK-X/MaixCam_Tic_Tac_Toe_2024): 基于 Sipeed Maix 系列开发板，使用计算机视觉技术实现的三子棋（井字棋）对弈机器人项目。该项目是 2024年全国大学生电子设计竞赛（E题 - 三子棋游戏装置） 的一个完整解决方案。
+* [开源一个很简单的通过cv2.solvePnP实现透视投影下的位姿估计](https://maixhub.com/share/93): 检测物体的3D位姿。
+* [使用MaixPy生成二维码](https://maixhub.com/share/79): 使用 qrcode 库生成二维码。
 
-除了项目分享以外，还可以在[MaixHub 应用商店](https://maixhub.com/app) 找到可以直接运行的应用，有部分应用可能是用 MaixPy 编写的，如果作者提供了源码或者写了详细的教程也都可以参考。
 
 
-推荐项目：
+## 更多
 
-* 简易HTTP串流服务器: https://maixhub.com/app/19
-* 桌面电脑性能监视器: https://maixhub.com/app/13
-* 安全帽检测模型应用: https://maixhub.com/app/10
+这里收录不是很及时，更多请按照本文开头的方式寻找。

docs/doc/zh/sidebar.yaml

@@ -222,10 +222,10 @@ items:
     -   file: modules/bluetooth.md
         label: 蓝牙
 
--   label: 项目实战
+-   label: 项目实战和开源项目
     items:
     -   file: projects/README.md
-        label: 介绍和汇总
+        label: 介绍和开源项目汇总
     -   file: projects/line_tracking_robot.md
         label: 小车巡线
     -   file: projects/face_tracking.md

projects/app_gimbal_laser/README.md

@@ -0,0 +1,12 @@
+# Face Tracking
+
+## Description
+
+Face recognition and tracking is accomplished using a gimbal consisting of two servos and MaixCAM.
+
+![](../../docs/doc/assets/face_tracking1.jpg)
+
+
+![](../../docs/doc/assets/face_tracking2.jpg)
+
+**See [Wiki](../../docs/doc/en/projects/face_tracking.md) for more details.**

projects/app_gimbal_laser/app.yaml

@@ -0,0 +1,13 @@
+id: face_tracking
+name: face_tracking
+name[zh]: 人脸追踪
+version: 1.0.2
+author: Sipeed Ltd
+icon: assets/face_tracking.png
+desc: Face tracking with MaixCAM and gimbal.
+desc[zh]: 使用 MaixCAM 和云台进行人脸跟踪。
+files:
+  - app.yaml
+  - assets
+  - README.md
+  - face_tracking