Administrator/NANOKVM-sipeed_wiki-MIRROR
1
0
Fork 0
mirror of https://github.com/sipeed/sipeed_wiki.git synced 2026-09-11 00:22:49 -05:00
Code Issues Packages Projects Releases Wiki Activity

Enhance en doc content for update_debugger.md

Browse Source
This commit is contained in:
Rosemary_HSN
2025-02-18 23:16:12 +08:00
parent 0c499606ab
commit aae95adafb
12 changed files with 5127 additions and 5122 deletions
Download Patch File Download Diff File Expand all files Collapse all files

234
docs/hardware/en/maixcam/maixcam_pro.md
View File

@@ -1,117 +1,117 @@
---
title: MaixCAM-Pro -- Rapid Deployment of AI Vision and Auditory Applications
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro](/static/image/maixcam_pro.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=846226367137">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://www.aliexpress.com/store/911876460">AliExpress</a>
</div>
## Introduction to MaixCAM-Pro
MaixCAM is a hardware product designed for the rapid implementation of AI vision, auditory, and AIoT applications. It serves as a platform for quickly verifying product prototypes and rapid mass production. MaixCAM-Pro provides a powerful yet cost-effective processor, along with accessories such as a camera, display, WiFi, and a comprehensive, easy-to-use software ecosystem.
<div style="display: flex; justify-content: left">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/maixpy/">For more usage, visit MaixPy</a>
</div>
**Application Scenarios and Target Audience**:
* **AI Algorithm Implementation**: AI algorithm engineers can quickly deploy their AI models onto hardware (MaixCAM) with easy-to-use model conversion tools and SDK.
* **STEM Education**: Offers an easy-to-use MaixPy SDK and development tools, as well as an online model training platform, allowing teachers to focus on teaching without the need for software or hardware development, enabling students to get started quickly.
* **University Research and Education**: Provides rich documentation and tutorials suitable for students at all levels, with RISC-V and AI frontier technologies being helpful for research purposes.
* **A Powerful Tool for Maker and Engineer Prototyping**: Thoughtfully designed hardware, rich peripherals, and extremely easy-to-use software help quickly bring your creative ideas and products to life without getting bogged down in basic software and hardware development.
* **Enterprise Product Upgrades and Deployment**: Quickly deploy products without expensive R&D costs, or use them as an auxiliary tool, for example, in production line QA, or for adding AI vision capabilities to legacy equipment.
* **Competition Assistant**: MaixCAM + MaixPy + MaixCDK can quickly implement various innovations and functions, making it suitable as a designated platform for competitions. Maix products and MaixPy have already been used in various competitions and have won awards.
## Overview of MaixCAM-Pro Hardware
> Compared with [MaixCAM](./README.md), MaixCAM-Pro has redesigned PCB and casing, and upgraded some peripherals. Differences with MaixCAM are in **bold**.
| Component | Description |
| --- | --- |
| CPU Main Core | 1GHz RISC-V C906 processor (plus an optional 1GHz ARM A53 core), running Linux |
| CPU Small Core | 700MHz RISC-V C906, running RTOS |
| CPU Low Power Core | 25~300MHz 8051 processor for low-power applications |
| NPU | 1TOPS@INT8, supports BF16 models, supports operators for common models such as Mobilenetv2, YOLOv5, YOLOv8 |
| Memory | 256MB DDR3 |
| Storage | TF card boot / SD NAND boot |
| Camera | Supports up to 5MP camera, officially supports 4MP GC4653 and OS04A10 cameras (4-lane MIPI CSI input, 22-pin interface, dual CSI split supported) |
| Display | **2.4-inch high-definition IPS capacitive touch screen, resolution 640x480** (2-lane MIPI DSI output, standard 31-pin interface, 6-pin capacitive touch) |
| Audio Output | Built-in PA amplifier + **1W speaker** |
| Audio Input | Built-in analog silicon microphone for direct voice recording |
| Network | Onboard WiFi6 + BLE5.4 module, customizable Ethernet version |
| USB | Type-C USB2.0, support device and host mode, support USB camera |
| IO Interface | **2.54mm PMOD interface, 12 IO + Vsys/3.3v/GND interface + 1.25mm 6-pin extension interface** |
| Buttons | 1 x RST button + 1 x USER (function) button + **1 x power button** |
| LED | Power indicator + User LED + **illumination LED** |
| Codec | H.264 / H.265 / MJPEG hardware decoding, supports 2k@30fps encoding and decoding |
| Peripherals | I2C/SPI/UART/ADC/PWM/WDT, etc. |
| Power | **Independent power management chip AXP2101, supports lithium battery charging and discharging, available with lithium battery version** |
| Case | **3D-printed acrylic case, standard 1/4 inch threaded hole** |
| IMU | **Onboard six-axis IMU sensor (3-axis accelerometer + 3-axis gyroscope)** |
| RTC | **Onboard BM8653 RTC chip + button cell, keeps time even when powered off** |
| Dimensions | **No-battery version: 67x51x12mm, battery version thickness: 16mm** |
## MaixCAM Software Ecosystem
We don't just provide hardware; MaixCAM comes with a complete software ecosystem, including:
| Name | Description | Image/Video |
| --- | --- | --- |
| **[MaixPy](https://wiki.sipeed.com/maixpy/)** | Python development package with rich and easy-to-use APIs optimized for MaixCAM, supporting hardware acceleration, with extensive documentation and tutorials | Visit [MaixPy homepage](https://wiki.sipeed.com/maixpy/) |
| [MaixVision](https://wiki.sipeed.com/maixvision) | AI vision IDE for programming, code execution, real-time image preview, even graphical programming, lowering development and usage thresholds | ![MaixVision](../../assets/maixcam/maixvision.jpg) <video playsinline controls muted preload style="width:100%" src="https://wiki.sipeed.com/maixpy/static/video/maixvision.mp4"></video> |
| [MaixHub](https://maixhub.com) | Online AI model training platform that allows training and deployment of models with a single click, without needing AI knowledge or expensive training equipment | ![MaixVision](../../assets/maixcam/maixhub.jpg) |
| [MaixCDK](https://github.com/sipeed/MaixCDK) | C++ version of MaixPy for developers familiar with C/C++ to get started immediately | Visit [MaixCDK homepage](https://github.com/sipeed/MaixCDK) |
| [App Store](https://maixhub.com/app) | Provides various applications and tools for direct download and use, allowing developers to share their apps | Visit [MaixHub App Store](https://maixhub.com/app) |
| [Community Plaza](https://maixhub.com/share) | Developers share their projects and experiences | Visit [MaixHub Community Plaza](https://maixhub.com/share) |
## Resource Summary
### MaixCAM Exclusive Resources (Provided by Sipeed)
* [MaixCAM-Pro Official Documentation](https://wiki.sipeed.com/maixcam-pro) (This documentation)
* [MaixPy Official Documentation](https://wiki.sipeed.com/maixpy/) (Python SDK) ([MaixPy Source Code](https://github.com/sipeed/MaixPy))
* [MaixCDK](https://github.com/sipeed/MaixCDK) (C/C++ SDK) ([MaixCDK Source Code](https://github.com/sipeed/MaixCDK))
* [System Source Code](https://github.com/sipeed/LicheeRV-Nano-Build)
* [Hardware-related Materials](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM_Pro)
* Case and Stand: See [Case Documentation](./assemble.md). The casing and bracket 3D model files are also open source. Please visit [makerworld.com](https://makerworld.com/) (recommended) or [makerworld.com.cn](https://makerworld.com.cn) and search for `MaixCAM`.
* Interface Diagram:
![maixcam_pro_io](../../assets/maixcam/maixcam_pro_io.png)
### Chip Resources
MaixCAM-Pro is based on the Sophgo SG2002 chip, so the related documents can also be referenced, along with the documents of Sipeed's LicheeRV-Nano core board.
>! Note: MaixCAM-Pro can use the documents of LicheeRV-Nano and SG2002. **LicheeRV-Nano and other SG2002-based products cannot use MaixPy, MaixCDK, or MaixVision software**, so please make sure you purchase the correct product to avoid wasting time and money.
> If you want to get started developing applications quickly, choose MaixCAM. If you are an experienced Linux developer interested in developing based on original SG2002 resources, you may consider choosing LicheeRV-Nano.
* [Datasheet](https://github.com/sophgo/sophgo-doc/releases) (Register-level data)
* [LicheeRV-Nano Development Board Documentation](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html)
* [Toolchain Download](https://sophon-file.sophon.cn/sophon-prod-s3/drive/23/03/07/16/host-tools.tar.gz)
* [Sophgo SDK Development Documentation Summary](https://developer.sophgo.com/thread/471.html)
* [Sophgo HDK Development Documentation Summary](https://developer.sophgo.com/thread/472.html)
* [Sophgo TPU Development Documentation Summary](https://developer.sophgo.com/thread/473.html)
* [Sophgo TDL Development Documentation Summary](https://developer.sophgo.com/thread/556.html) (High-level API encapsulation based on TPU)
### Community Resources
* [MaixHub App Store](https://maixhub.com/app)
* [MaixHub Community Plaza](https://maixhub.com/share)
* [makerworld.com](https://makerworld.com/) (recommended) or [makerworld.com.cn](https://makerworld.com.cn), search for `MaixCAM`
* [Bilibili](https://bilibili.com) - Search for `MaixCAM` or `MaixPy`
## Purchase
* [Sipeed Taobao](https://sipeed.taobao.com/)
* [AliExpress](https://www.aliexpress.com/store/911876460)
---
title: MaixCAM-Pro -- Rapid Deployment of AI Vision and Auditory Applications
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro](/static/image/maixcam_pro.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=846226367137">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://www.aliexpress.com/store/911876460">AliExpress</a>
</div>
## Introduction to MaixCAM-Pro
MaixCAM is a hardware product designed for the rapid implementation of AI vision, auditory, and AIoT applications. It serves as a platform for quickly verifying product prototypes and rapid mass production. MaixCAM-Pro provides a powerful yet cost-effective processor, along with accessories such as a camera, display, WiFi, and a comprehensive, easy-to-use software ecosystem.
<div style="display: flex; justify-content: left">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/maixpy/">For more usage, visit MaixPy</a>
</div>
**Application Scenarios and Target Audience**:
* **AI Algorithm Implementation**: AI algorithm engineers can quickly deploy their AI models onto hardware (MaixCAM) with easy-to-use model conversion tools and SDK.
* **STEM Education**: Offers an easy-to-use MaixPy SDK and development tools, as well as an online model training platform, allowing teachers to focus on teaching without the need for software or hardware development, enabling students to get started quickly.
* **University Research and Education**: Provides rich documentation and tutorials suitable for students at all levels, with RISC-V and AI frontier technologies being helpful for research purposes.
* **A Powerful Tool for Maker and Engineer Prototyping**: Thoughtfully designed hardware, rich peripherals, and extremely easy-to-use software help quickly bring your creative ideas and products to life without getting bogged down in basic software and hardware development.
* **Enterprise Product Upgrades and Deployment**: Quickly deploy products without expensive R&D costs, or use them as an auxiliary tool, for example, in production line QA, or for adding AI vision capabilities to legacy equipment.
* **Competition Assistant**: MaixCAM + MaixPy + MaixCDK can quickly implement various innovations and functions, making it suitable as a designated platform for competitions. Maix products and MaixPy have already been used in various competitions and have won awards.
## Overview of MaixCAM-Pro Hardware
> Compared with [MaixCAM](./README.md), MaixCAM-Pro has redesigned PCB and casing, and upgraded some peripherals. Differences with MaixCAM are in **bold**.
| Component | Description |
| --- | --- |
| CPU Main Core | 1GHz RISC-V C906 processor (plus an optional 1GHz ARM A53 core), running Linux |
| CPU Small Core | 700MHz RISC-V C906, running RTOS |
| CPU Low Power Core | 25~300MHz 8051 processor for low-power applications |
| NPU | 1TOPS@INT8, supports BF16 models, supports operators for common models such as Mobilenetv2, YOLOv5, YOLOv8 |
| Memory | 256MB DDR3 |
| Storage | TF card boot / SD NAND boot |
| Camera | Supports up to 5MP camera, officially supports 4MP GC4653 and OS04A10 cameras (4-lane MIPI CSI input, 22-pin interface, dual CSI split supported) |
| Display | **2.4-inch high-definition IPS capacitive touch screen, resolution 640x480** (2-lane MIPI DSI output, standard 31-pin interface, 6-pin capacitive touch) |
| Audio Output | Built-in PA amplifier + **1W speaker** |
| Audio Input | Built-in analog silicon microphone for direct voice recording |
| Network | Onboard WiFi6 + BLE5.4 module, customizable Ethernet version |
| USB | Type-C USB2.0, support device and host mode, support USB camera |
| IO Interface | **2.54mm PMOD interface, 12 IO + Vsys/3.3v/GND interface + 1.25mm 6-pin extension interface** |
| Buttons | 1 x RST button + 1 x USER (function) button + **1 x power button** |
| LED | Power indicator + User LED + **illumination LED** |
| Codec | H.264 / H.265 / MJPEG hardware decoding, supports 2k@30fps encoding and decoding |
| Peripherals | I2C/SPI/UART/ADC/PWM/WDT, etc. |
| Power | **Independent power management chip AXP2101, supports lithium battery charging and discharging, available with lithium battery version** |
| Case | **3D-printed acrylic case, standard 1/4 inch threaded hole** |
| IMU | **Onboard six-axis IMU sensor (3-axis accelerometer + 3-axis gyroscope)** |
| RTC | **Onboard BM8653 RTC chip + button cell, keeps time even when powered off** |
| Dimensions | **No-battery version: 67x51x12mm, battery version thickness: 16mm** |
## MaixCAM Software Ecosystem
We don't just provide hardware; MaixCAM comes with a complete software ecosystem, including:
| Name | Description | Image/Video |
| --- | --- | --- |
| **[MaixPy](https://wiki.sipeed.com/maixpy/)** | Python development package with rich and easy-to-use APIs optimized for MaixCAM, supporting hardware acceleration, with extensive documentation and tutorials | Visit [MaixPy homepage](https://wiki.sipeed.com/maixpy/) |
| [MaixVision](https://wiki.sipeed.com/maixvision) | AI vision IDE for programming, code execution, real-time image preview, even graphical programming, lowering development and usage thresholds | ![MaixVision](../../assets/maixcam/maixvision.jpg) <video playsinline controls muted preload style="width:100%" src="https://wiki.sipeed.com/maixpy/static/video/maixvision.mp4"></video> |
| [MaixHub](https://maixhub.com) | Online AI model training platform that allows training and deployment of models with a single click, without needing AI knowledge or expensive training equipment | ![MaixVision](../../assets/maixcam/maixhub.jpg) |
| [MaixCDK](https://github.com/sipeed/MaixCDK) | C++ version of MaixPy for developers familiar with C/C++ to get started immediately | Visit [MaixCDK homepage](https://github.com/sipeed/MaixCDK) |
| [App Store](https://maixhub.com/app) | Provides various applications and tools for direct download and use, allowing developers to share their apps | Visit [MaixHub App Store](https://maixhub.com/app) |
| [Community Plaza](https://maixhub.com/share) | Developers share their projects and experiences | Visit [MaixHub Community Plaza](https://maixhub.com/share) |
## Resource Summary
### MaixCAM Exclusive Resources (Provided by Sipeed)
* [MaixCAM-Pro Official Documentation](https://wiki.sipeed.com/maixcam-pro) (This documentation)
* [MaixPy Official Documentation](https://wiki.sipeed.com/maixpy/) (Python SDK) ([MaixPy Source Code](https://github.com/sipeed/MaixPy))
* [MaixCDK](https://github.com/sipeed/MaixCDK) (C/C++ SDK) ([MaixCDK Source Code](https://github.com/sipeed/MaixCDK))
* [System Source Code](https://github.com/sipeed/LicheeRV-Nano-Build)
* [Hardware-related Materials](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM_Pro)
* Case and Stand: See [Case Documentation](./assemble.md). The casing and bracket 3D model files are also open source. Please visit [makerworld.com](https://makerworld.com/) (recommended) or [makerworld.com.cn](https://makerworld.com.cn) and search for `MaixCAM`.
* Interface Diagram:
![maixcam_pro_io](../../assets/maixcam/maixcam_pro_io.png)
### Chip Resources
MaixCAM-Pro is based on the Sophgo SG2002 chip, so the related documents can also be referenced, along with the documents of Sipeed's LicheeRV-Nano core board.
>! Note: MaixCAM-Pro can use the documents of LicheeRV-Nano and SG2002. **LicheeRV-Nano and other SG2002-based products cannot use MaixPy, MaixCDK, or MaixVision software**, so please make sure you purchase the correct product to avoid wasting time and money.
> If you want to get started developing applications quickly, choose MaixCAM. If you are an experienced Linux developer interested in developing based on original SG2002 resources, you may consider choosing LicheeRV-Nano.
* [Datasheet](https://github.com/sophgo/sophgo-doc/releases) (Register-level data)
* [LicheeRV-Nano Development Board Documentation](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html)
* [Toolchain Download](https://sophon-file.sophon.cn/sophon-prod-s3/drive/23/03/07/16/host-tools.tar.gz)
* [Sophgo SDK Development Documentation Summary](https://developer.sophgo.com/thread/471.html)
* [Sophgo HDK Development Documentation Summary](https://developer.sophgo.com/thread/472.html)
* [Sophgo TPU Development Documentation Summary](https://developer.sophgo.com/thread/473.html)
* [Sophgo TDL Development Documentation Summary](https://developer.sophgo.com/thread/556.html) (High-level API encapsulation based on TPU)
### Community Resources
* [MaixHub App Store](https://maixhub.com/app)
* [MaixHub Community Plaza](https://maixhub.com/share)
* [makerworld.com](https://makerworld.com/) (recommended) or [makerworld.com.cn](https://makerworld.com.cn), search for `MaixCAM`
* [Bilibili](https://bilibili.com) - Search for `MaixCAM` or `MaixPy`
## Purchase
* [Sipeed Taobao](https://sipeed.taobao.com/)
* [AliExpress](https://www.aliexpress.com/store/911876460)

234
docs/hardware/en/maixcam/microscope.md
View File

@@ -1,117 +1,117 @@
---
title: Microscope Kit
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro microscope](../../assets/maixcam/maixcam_microscope.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">Aliexpress</a>
</div>
## Microscope Kit
The MaixCAM Microscope Kit transforms your MaixCAM / MaixCAM Pro into a portable digital microscope. It surpasses similarly priced digital microscopes in performance while offering open-source capabilities, allowing you to customize unique functions for your digital microscope.
The MaixCAM Microscope Kit is ideal for soldering small components, observing biological specimens, focus stacking photography, and more. Explore various applications with this versatile kit!
### Single Lens Kit
Includes only the 10mm tapered lens, 10mm spacer ring, and anti-glare flocking stickers. It is suitable for handheld use or if you already have a universal microscope stand.
![Single Lens Kit](../../assets/maixcam/micro_lens.jpg)
**Usage:** Unscrew the original MaixCAM lens and replace it with the tapered lens.
For higher magnification, attach the 10mm spacer ring first, followed by the tapered lens.
![Lens Installation Method](../../assets/maixcam/micro_lens_install.jpg)
- The closer the lens is screwed inward, the lower the magnification, and the lens-to-object distance increases (up to ~10 cm).
- The farther the lens is screwed outward, the higher the magnification, and the lens-to-object distance decreases (down to ~1 cm).
| Installation Method | Optical Magnification | Field of View | Suitable Objects |
|-----------------------------------|-----------------------|---------------|---------------------------|
| 10mm tapered lens (fully inward) | 0.25X | 20.5x11.5mm | PCBs, FPC soldering |
| 10mm tapered lens (fully outward) | 0.6X | 8.5x4.8mm | IC markings, fine soldering|
| Tapered lens + 10mm spacer (inward)| 1.0X | 5.1x2.9mm | IC chips, larger specimens|
| Tapered lens + 10mm spacer (outward)| 2.0X | 2.56x1.44mm | IC chip details, cells |
1. The magnifications above are optical, not exaggerated marketing values like hundreds or thousands of times.
2. Field of view examples are based on GC4653. For OS04A10, scale proportionally by 3/1.8 = 1.67x.
After installation, you can observe and capture images using the built-in camera app on MaixCAM.
For low-light conditions, turn on the flashlight via the app.
If glare occurs, trim the anti-glare flocking and attach it to the inner side of the tapered lens.
![Anti-Glare Flocking Suppression](../../assets/maixcam/xiaoguang.jpg)
### Manual Stand Kit
Includes:
1. **Lens:** 10mm tapered lens, 10mm spacer ring
2. **Stand:** Precision aluminum alloy stand components
3. **Biological Specimen:** Onion epidermis specimen, white stage
4. **Extras:** Anti-glare flocking
![Manual Stand Kit](../../assets/maixcam/focusing_stand_suit.jpg)
Refer to the lens installation method above.
The assembled stand and MaixCAM setup appear as follows. For larger targets like PCBs, the spacer ring is typically unnecessary:
![Stand Installation](../../assets/maixcam/stand_install.jpg)
The package comes with a mounting bracket to help secure the MaixCAM Pro, which can be installed as follows
![Bracket package](../../assets/maixcam/install_bracket.png)
A mini heating table can be added for soldering tasks:
![Soldering with Stand](../../assets/maixcam/stand_solder.jpg)
For small biological specimens, use the spacer ring, enable the flashlight, and optionally activate focus magnification in the camera app.
Place the provided onion epidermis specimen on the white stage and observe with lighting and magnification enabled:
![Onion Epidermis Setup](../../assets/maixcam/stand_onion.jpg)
Example results:
![Onion Epidermis](../../assets/maixcam/onion.jpg)
![Pine Stem Cross-Section](../../assets/maixcam/pine.jpg)
### Motorized Stand Kit
A future release featuring a motorized sliding platform for automatic focusing and stacked photography.
<video playsinline controls muted preload style="width:100%" src="../../assets/maixcam/micro_focus.mp4"></video>
## Performance Comparison
### Specification Table
| | **MaixCAM Microscope Kit** | **Darwin M2 Microscope** |
|---------------|-----------------------------|-------------------------------|
| Sensor Resolution | 2560x1440 | 1600x1200 |
| Display | 2.4-inch 640x480 | 4-inch 800x480 |
| Interaction | Full-screen touch | Physical + touch buttons |
| Aperture | F1:2.5 (brighter) | F1:4.5 |
| Photo Capture | ✓ Adjustable parameters | ✓ Fixed parameters |
| Video Recording | MP4 (smaller size) | AVI (larger size) |
| Timelapse | ✓ | X |
| Optical Magnification | No spacer: 0.25~0.6<br>With spacer: 1.0~2.0 | 0.42~0.92 |
| Single Pixel Size (Max Magnification) | 1µm | 2.7µm |
| Stand | Sturdy aluminum alloy | Basic plastic stand |
### Picture Comparison
Each image below shows the maximum magnification for both microscopes:
- **Top Image:** Darwin M2 Microscope
- **Bottom Image:** MaixCAM Microscope
![c1](../../assets/maixcam/c1.jpg)
![c2](../../assets/maixcam/c2.jpg)
![c3](../../assets/maixcam/c3.jpg)
![c4](../../assets/maixcam/c4.jpg)
![c5](../../assets/maixcam/c5.jpg)
![c6](../../assets/maixcam/c6.jpg)
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">Aliexpress</a>
</div>
---
title: Microscope Kit
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro microscope](../../assets/maixcam/maixcam_microscope.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">Aliexpress</a>
</div>
## Microscope Kit
The MaixCAM Microscope Kit transforms your MaixCAM / MaixCAM Pro into a portable digital microscope. It surpasses similarly priced digital microscopes in performance while offering open-source capabilities, allowing you to customize unique functions for your digital microscope.
The MaixCAM Microscope Kit is ideal for soldering small components, observing biological specimens, focus stacking photography, and more. Explore various applications with this versatile kit!
### Single Lens Kit
Includes only the 10mm tapered lens, 10mm spacer ring, and anti-glare flocking stickers. It is suitable for handheld use or if you already have a universal microscope stand.
![Single Lens Kit](../../assets/maixcam/micro_lens.jpg)
**Usage:** Unscrew the original MaixCAM lens and replace it with the tapered lens.
For higher magnification, attach the 10mm spacer ring first, followed by the tapered lens.
![Lens Installation Method](../../assets/maixcam/micro_lens_install.jpg)
- The closer the lens is screwed inward, the lower the magnification, and the lens-to-object distance increases (up to ~10 cm).
- The farther the lens is screwed outward, the higher the magnification, and the lens-to-object distance decreases (down to ~1 cm).
| Installation Method | Optical Magnification | Field of View | Suitable Objects |
|-----------------------------------|-----------------------|---------------|---------------------------|
| 10mm tapered lens (fully inward) | 0.25X | 20.5x11.5mm | PCBs, FPC soldering |
| 10mm tapered lens (fully outward) | 0.6X | 8.5x4.8mm | IC markings, fine soldering|
| Tapered lens + 10mm spacer (inward)| 1.0X | 5.1x2.9mm | IC chips, larger specimens|
| Tapered lens + 10mm spacer (outward)| 2.0X | 2.56x1.44mm | IC chip details, cells |
1. The magnifications above are optical, not exaggerated marketing values like hundreds or thousands of times.
2. Field of view examples are based on GC4653. For OS04A10, scale proportionally by 3/1.8 = 1.67x.
After installation, you can observe and capture images using the built-in camera app on MaixCAM.
For low-light conditions, turn on the flashlight via the app.
If glare occurs, trim the anti-glare flocking and attach it to the inner side of the tapered lens.
![Anti-Glare Flocking Suppression](../../assets/maixcam/xiaoguang.jpg)
### Manual Stand Kit
Includes:
1. **Lens:** 10mm tapered lens, 10mm spacer ring
2. **Stand:** Precision aluminum alloy stand components
3. **Biological Specimen:** Onion epidermis specimen, white stage
4. **Extras:** Anti-glare flocking
![Manual Stand Kit](../../assets/maixcam/focusing_stand_suit.jpg)
Refer to the lens installation method above.
The assembled stand and MaixCAM setup appear as follows. For larger targets like PCBs, the spacer ring is typically unnecessary:
![Stand Installation](../../assets/maixcam/stand_install.jpg)
The package comes with a mounting bracket to help secure the MaixCAM Pro, which can be installed as follows
![Bracket package](../../assets/maixcam/install_bracket.png)
A mini heating table can be added for soldering tasks:
![Soldering with Stand](../../assets/maixcam/stand_solder.jpg)
For small biological specimens, use the spacer ring, enable the flashlight, and optionally activate focus magnification in the camera app.
Place the provided onion epidermis specimen on the white stage and observe with lighting and magnification enabled:
![Onion Epidermis Setup](../../assets/maixcam/stand_onion.jpg)
Example results:
![Onion Epidermis](../../assets/maixcam/onion.jpg)
![Pine Stem Cross-Section](../../assets/maixcam/pine.jpg)
### Motorized Stand Kit
A future release featuring a motorized sliding platform for automatic focusing and stacked photography.
<video playsinline controls muted preload style="width:100%" src="../../assets/maixcam/micro_focus.mp4"></video>
## Performance Comparison
### Specification Table
| | **MaixCAM Microscope Kit** | **Darwin M2 Microscope** |
|---------------|-----------------------------|-------------------------------|
| Sensor Resolution | 2560x1440 | 1600x1200 |
| Display | 2.4-inch 640x480 | 4-inch 800x480 |
| Interaction | Full-screen touch | Physical + touch buttons |
| Aperture | F1:2.5 (brighter) | F1:4.5 |
| Photo Capture | ✓ Adjustable parameters | ✓ Fixed parameters |
| Video Recording | MP4 (smaller size) | AVI (larger size) |
| Timelapse | ✓ | X |
| Optical Magnification | No spacer: 0.25~0.6<br>With spacer: 1.0~2.0 | 0.42~0.92 |
| Single Pixel Size (Max Magnification) | 1µm | 2.7µm |
| Stand | Sturdy aluminum alloy | Basic plastic stand |
### Picture Comparison
Each image below shows the maximum magnification for both microscopes:
- **Top Image:** Darwin M2 Microscope
- **Bottom Image:** MaixCAM Microscope
![c1](../../assets/maixcam/c1.jpg)
![c2](../../assets/maixcam/c2.jpg)
![c3](../../assets/maixcam/c3.jpg)
![c4](../../assets/maixcam/c4.jpg)
![c5](../../assets/maixcam/c5.jpg)
![c6](../../assets/maixcam/c6.jpg)
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">Taobao</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">Aliexpress</a>
</div>

1200
docs/hardware/en/sidebar.yaml
View File

File diff suppressed because it is too large Load Diff

407
docs/hardware/en/tang/common-doc/update_debugger.md
View File

@@ -1,201 +1,206 @@
---
title: Update debugger
keywords: Sipeed, Gowin, Tang, FPGA, Nano, Primer, Mega
update:
- date: 2025-02-10
version: v0.8
author: Serika
content:
- First release
---
## Overview
All Sipeed Tang series have onboard debugger (except standalone SOM). The debuggers are separate MCUs with their own firmware. Users could update the firmware for these debuggers to get feature updates and bug fixes.
We need to use the [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) to program these onboard debugger chips, and documentation about the ***chips & tools*** can be found [here](https://dev.bouffalolab.com/document/).
Here is a brief step-by-step guide:
- Download and install the corresponding edition of the ***tools*** according to your OS.
- Get the updated debugger firmware for your board from [**Sipeed Download Station**](https://dl.sipeed.com/shareURL/TANG/Debugger/onboard).
- Refer to the official documentation of [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) to update the firmware of the onboard debugger.
- For Windows users, there are detailed step-by-step tutorial below. Also, the steps for other operating systems are similar.
***
## Tutorial
### Preparation for Hardware
To put the onboard debugger into **DFU mode**, press the ***Update Button*** or short the corresponding ***Test Points*** before power on the board or connecting the board's debug USB port with a cable.
Please refer to the below for the corresponding ***Update Button*** and ***Test Points***.
#### Tang nano series
- Tang nano 1k
The 2 **`Test Points`** is in the upper left corner of the board **TOP** side, behind the `KEY-B`.
![nano1k_update](./assets/hardware/nano1k_update.jpg)
- Tang nano 4k
The 2 **`Test Points`** is in the upper left corner of the board **TOP** side, behind the USB-C connector.
![nano4k_update](./assets/hardware/nano4k_update.jpg)
- Tang nano 9k
The 2 **`Test Points`** is in the middle left of the board **TOP** side, behind the USB-C connector.
![nano9k_update](./assets/hardware/nano9k_update.jpg)
- Tang nano 20k
The **`Update Button`** behind the HDMI connector on the **TOP** side has the silkscreen **`UPDATE`**.
![nano20k_update](./assets/hardware/nano20k_update.jpg)
#### Tang Primer series
- Tang Primer 25k Dock
The 2 **`Test Points`** is in the upper left corner of the board **BOT** side, marked as `3V3` & `TDO`.
![Primer25k_update](./assets/hardware/Primer25k_update.jpg)
- Tang Primer 20k Dock
The white **`Update Button`** is on the lower right side of the TOP side of the Dock board between USB-C debug port and HDMI port, marked as **`702-BOOT`**
![Primer20k_update](./assets/hardware/Primer20k_update.jpg)
- ~~Tang Primer 15k Dock~~ (**Not yet released**)
TBD
#### Tang Mega series(include Tang Console)
- Tang Mega Neo Dock(inclede Tang Mega 138K Dock)
The **`Update Button`** is blow the USB-C connector marked as **DEBUG-USB2** on the **TOP** side.
![Mega-neo_update](./assets/hardware/Mega-neo_update.jpg)
- Tang Mega 138K Pro Dock
The **`Update Button`** is on the left of the USB-C connector marked as **JATG|UART** on the **TOP** side.
![Mega-138kpro_update](./assets/hardware/Mega-138kpro_update.jpg)
- Tang Console
The **`Update Button`** is on the other side the USB-C connector on the **TOP** side, the shorter of the 2 buttons marked ad **`BOOT`**.
![Mega-console_update](./assets/hardware/Mega-console_update.jpg)
***
### Preparation for Software
- First, download **BouffaloLabDevCube** from [**BouffaloLab Official Website**](https://dev.bouffalolab.com/download/), The latest version is **`1.9.0`** (February 10, 2025).
![download_BLDevCube](./assets/download_bldc.jpg)
- Unzip the downloaded content and execute the corresponding executable file, for Windows this is **`BLDevCube.exe`**
![run_BLDevCube](./assets/run_bldc.jpg)
- In the pop-up window, select Chip model as BL616/618.
![model-sel_BLDevCube](./assets/model-sel_bldc.jpg)
- In the new window, check the **`Enable`** checkbox in blow the ***Single download option***. Click the **`Browse`** button to select the firmware file to be updated.
![mainwindow_BLDevCube](./assets/mainw_bldc.jpg)
- Let the onboard debugger into [**DFU mode**](#preparation-for-hardware), it should be a CDC-ACM device for both BL702 or BL616. On Windows, this registers a new COM port, in this example is **`COM12`**. For Linux users, CDC-ACM usual register as `/dev/ttyACMx`. For macOS users, it may register as `/dev/tty.usbmodemxxxx` or `/dev/cu.usbmodemxxxx`. (Each `x` represents a digit)
![new_com-port](./assets/new_com-port.jpg)
- Now, set the **BLDevCube** up as shown below. Set the firmware file location, the port for DFU mode, then click **`Open UART`**, and finally click **`Create & Download`**.
![setting_BLDevCube](./assets/set_bldc.jpg)
- Wait for the download to complete as shown in the image below.
![download_complete](./assets/complete_bldc.jpg)
***
### Confirm the results
After completing the above steps, we need to confirm that the firmware of the onboard debugger is successfully burned. Usually replug the USB cable or re-poweron the board will confirm it.
- In Windows, you can see two new devices in the device manager: **`USB Converter A`** and **`USB Converter B`**.
![dual_usbconverter](./assets/ftdi_dual.jpg)
- To confirm the debugger firmware version, double-click any **`USB Converter`** and go to the Details tab. Then select **`Parent`** Options from the drop-down menu:
![detail_usbconverter](./assets/detail_usbconverter.jpg)
- As shown in the figure below, the last 10 digits **`2025102315`** are the serial number of the debugger firmware version. Linux & macOS users could use command **`dmesg`** to check the serial number in kernel log.
![serialnum_usbconverter](./assets/serialnum_usbconverter.jpg)
### Latest firmware
The latest firmware serial numbers of all Tang series onboard debuggers are recorded here:
| Board | MCU model | Download |Serial num.| Firmware SHA256 Checksum |
| ------------- | ---------- | -------------------------------------------------------------------------------------------------------------| --------- |-----------------------------------------------------------------------------------------------------------------------------------------------|
| nano 1K | BL702 | N/A | N/A |N/A |
| nano 4K | BL702 | N/A | N/A |N/A |
| Nano 9K | BL702 | N/A | N/A |N/A |
| Primer 20K | BL702 | N/A | N/A |N/A |
| | | | | |
| nano 20K | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.bin) |2025012315 |[bl616_fpga_partner_20kNano.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.sha256) |
| Primer 25K | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.bin) |2025012315 |[bl616_fpga_partner_25kDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.sha256) |
| Mega NEO | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.bin) |2025012315 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.sha256) |
| Mega 138K Pro | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.bin) |2025012315 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.sha256)|
| Console | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.bin) |2025012319 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.sha256) |
### Troubleshooting
If you encounter any problems during use, or have any comments or suggestions on the document, please feel free to give us your feedback. Contact details are below.
In most cases, BouffaloLab's official documentation is sufficient for troubleshooting. Click [here](https://dev.bouffalolab.com/document/) to get them.
#### FAQ
- TBD, waiting for feedback to be collected before adding.
#### Communication Methods
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- Discussion forum: [maixhub.com/discussion](https://maixhub.com/discussion)
- QQ discussion group: [834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)
- Leave a message directly below this page
- Business email : [support@sipeed.com](support@sipeed.com)
---
title: Update debugger
keywords: Sipeed, Gowin, Tang, FPGA, Nano, Primer, Mega
update:
- date: 2025-02-10
version: v0.8
author: Serika
content:
- First release
- date: 2025-02-18
version: v0.81
author: Serika
content:
- Enhance doc content.
---
## Overview
All Sipeed Tang series have onboard debugger (except standalone SOM). The debuggers are separate MCUs with their own firmware. Users could update the firmware for these debuggers to get feature updates and bug fixes.
We need to use the [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) to program these onboard debugger chips, and documentation about the ***chips & tools*** can be found [here](https://dev.bouffalolab.com/document/).
Here is a brief step-by-step guide:
- Download and install the corresponding edition of the ***tools*** according to your OS.
- Get the updated debugger firmware for your board from [**Sipeed Download Station**](https://dl.sipeed.com/shareURL/TANG/Debugger/onboard).
- Refer to the official documentation of [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) to update the firmware of the onboard debugger.
- For Windows users, there are detailed step-by-step tutorial below. Also, the steps for other operating systems are similar.
***
## Tutorial
### Preparation for Hardware
To put the onboard debugger into **DFU mode**, press the ***Update Button*** or short the corresponding ***Test Points*** before power on the board or connecting the board's debug USB port with a cable.
Please refer to the below for the corresponding ***Update Button*** and ***Test Points***.
#### Tang nano series
- Tang nano 1k
The 2 **`Test Points`** is in the upper left corner of the board **TOP** side, behind the `KEY-B`.
![nano1k_update](./assets/hardware/nano1k_update.jpg)
- Tang nano 4k
The 2 **`Test Points`** is in the upper left corner of the board **TOP** side, behind the USB-C connector.
![nano4k_update](./assets/hardware/nano4k_update.jpg)
- Tang nano 9k
The 2 **`Test Points`** is in the middle left of the board **TOP** side, behind the USB-C connector.
![nano9k_update](./assets/hardware/nano9k_update.jpg)
- Tang nano 20k
The **`Update Button`** behind the HDMI connector on the **TOP** side has the silkscreen **`UPDATE`**.
![nano20k_update](./assets/hardware/nano20k_update.jpg)
#### Tang Primer series
- Tang Primer 25k Dock
The 2 **`Test Points`** is in the upper left corner of the board **BOT** side, marked as `3V3` & `TDO`.
![Primer25k_update](./assets/hardware/Primer25k_update.jpg)
- Tang Primer 20k Dock
The white **`Update Button`** is on the lower right side of the TOP side of the Dock board between USB-C debug port and HDMI port, marked as **`702-BOOT`**
![Primer20k_update](./assets/hardware/Primer20k_update.jpg)
- ~~Tang Primer 15k Dock~~ (**Not yet released**)
TBD
#### Tang Mega series(include Tang Console)
- Tang Mega Neo Dock(inclede Tang Mega 138K Dock)
The **`Update Button`** is blow the USB-C connector marked as **DEBUG-USB2** on the **TOP** side.
![Mega-neo_update](./assets/hardware/Mega-neo_update.jpg)
- Tang Mega 138K Pro Dock
The **`Update Button`** is on the left of the USB-C connector marked as **JATG|UART** on the **TOP** side.
![Mega-138kpro_update](./assets/hardware/Mega-138kpro_update.jpg)
- Tang Console
The **`Update Button`** is on the other side the USB-C connector on the **TOP** side, the shorter of the 2 buttons marked ad **`BOOT`**.
![Mega-console_update](./assets/hardware/Mega-console_update.jpg)
***
### Preparation for Software
- First, download **BouffaloLabDevCube** from [**BouffaloLab Official Website**](https://dev.bouffalolab.com/download/), The latest version is **`1.9.0`** (February 10, 2025).
![download_BLDevCube](./assets/download_bldc.jpg)
- Unzip the downloaded content and execute the corresponding executable file, for Windows this is **`BLDevCube.exe`**
![run_BLDevCube](./assets/run_bldc.jpg)
- In the pop-up window, select Chip model as BL616/618.
![model-sel_BLDevCube](./assets/model-sel_bldc.jpg)
- In the new window, check the **`Enable`** checkbox in blow the ***Single download option***. Click the **`Browse`** button to select the firmware file to be updated.
![mainwindow_BLDevCube](./assets/mainw_bldc.jpg)
- Let the onboard debugger into [**DFU mode**](#preparation-for-hardware), it should be a CDC-ACM device for both BL702 or BL616. On Windows, this registers a new COM port, in this example is **`COM12`**. For Linux users, CDC-ACM usual register as `/dev/ttyACMx`. For macOS users, it may register as `/dev/tty.usbmodemxxxx` or `/dev/cu.usbmodemxxxx`. (Each `x` represents a digit)
![new_com-port](./assets/new_com-port.jpg)
- Now, set the **BLDevCube** up as shown below. Set the firmware file location, the port for DFU mode, then click **`Open UART`**, and finally click **`Create & Download`**.
![setting_BLDevCube](./assets/set_bldc.jpg)
- Wait for the download to complete as shown in the image below.
![download_complete](./assets/complete_bldc.jpg)
***
### Confirm the results
After completing the above steps, we need to confirm that the firmware of the onboard debugger is successfully burned. Usually replug the USB cable or re-poweron the board will confirm it.
- In Windows, you can see two new devices in the device manager: **`USB Converter A`** and **`USB Converter B`**.
![dual_usbconverter](./assets/ftdi_dual.jpg)
- To confirm the debugger firmware version, double-click any **`USB Converter`** and go to the Details tab. Then select **`Parent`** Options from the drop-down menu:
![detail_usbconverter](./assets/detail_usbconverter.jpg)
- As shown in the figure below, the last 10 digits **`2025102315`** are the serial number of the debugger firmware version. Linux & macOS users could use command **`dmesg`** to check the serial number in kernel log.
![serialnum_usbconverter](./assets/serialnum_usbconverter.jpg)
### Latest firmware
The latest firmware serial numbers of all Tang series onboard debuggers are recorded here:
| Board | MCU model | Download |Serial num.| Firmware SHA256 Checksum |
| ------------- | ---------- | -------------------------------------------------------------------------------------------------------------| --------- |-----------------------------------------------------------------------------------------------------------------------------------------------|
| nano 1K | BL702 | N/A | N/A |N/A |
| nano 4K | BL702 | N/A | N/A |N/A |
| Nano 9K | BL702 | N/A | N/A |N/A |
| Primer 20K | BL702 | N/A | N/A |N/A |
| | | | | |
| nano 20K | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.bin) |2025012315 |[bl616_fpga_partner_20kNano.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.sha256) |
| Primer 25K | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.bin) |2025012315 |[bl616_fpga_partner_25kDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.sha256) |
| Mega NEO | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.bin) |2025012315 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.sha256) |
| Mega 138K Pro | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.bin) |2025012315 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.sha256)|
| Console | BL616 | [Click](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.bin) |2025012319 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.sha256) |
### Troubleshooting
If you encounter any problems during use, or have any comments or suggestions on the document, please feel free to give us your feedback. Contact details are below.
In most cases, BouffaloLab's official documentation is sufficient for troubleshooting. Click [here](https://dev.bouffalolab.com/document/) to get them.
#### FAQ
- TBD, waiting for feedback to be collected before adding.
#### Communication Methods
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- Discussion forum: [maixhub.com/discussion](https://maixhub.com/discussion)
- QQ discussion group: [834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)
- Leave a message directly below this page
- Business email : [support@sipeed.com](support@sipeed.com)

442
docs/hardware/en/tang/tang-console/mega-console.md
View File

@@ -1,222 +1,222 @@
---
title: Tang Console
keywords: FPGA, Tang, Console, 60K, 138K
update:
- date: 2025-01-23
version: v0.1
author: Serika
content:
- Create document
---
## Overview
**Tang Console** is an another dock board for **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md) SOM** and **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md) SOM**. It is designed to be small and compact, and is mechanically compatible with the **Raspberry Pi 5b** **`PCIe HAT`**. In addition, it also contains two 5Gbps USB3 device interfaces and two **2x20-pin header connectors**, two **PMOD connectors**. It can meet the needs of IO expansion and high-speed communication at the same time.
At the same time, it is also specially designed for retro games. Maybe you can turn it into a retro game console, or even a handheld, whatever you like.
- Date to Release: Late March , 2025
- Pre-sale link: [Click me](https://sipeed.com/tangconsole)
## Board Features
- Compatible with various SOMs (**[Mega 138k](./../tang-mega-138k/mega-138k.md)** & **[Mega 60k](./../tang-mega-60k/mega-60k.md)**)
- More compact size, more budget choice
- Compatible with Raspberry Pi 5b PCIe HAT
- PCIe 2.0 x 1
- USB3 x 2(5Gbps)
- HDMI TX x 1
- Soft-PHY USB2 x1(480Mbps)
- Onboard 3.7V Li-on battery(1-Series) charge/discharge management
## Product Appearance
<img src="./.assert/console_60k.jpg" width="45%">
## Block Diagram
TBD
## Hardware Parameters
### SOM Board Parameters
Please refer to the link below:
- **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#hardware-parameters) SOM**
- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#hardware-parameters) SOM**
### Dock board Parameters
| Item | Quantity | Remarks |
| :------------------ | ---- | ------------------------------------------------- |
| LEDs | 2(3+3) | 3x Battery-Indicator + 3x User LED (2x RGB LED) |
| Buttons | 2+1 | 2x User-KEY + 1x Reconfig-KEY |
| PCIe | 1 | 1-lane @ 8/5Gbps (Depends on SOM) |
| USB3 | 2 | SERDES lane, SuperSpeed @ 5Gbps (Device mode) |
| USB2 | 1 | IO Soft-PHY, HighSpeed @ 480Mbps (Device mode) |
| DVI(HDMI) | 1 | Compatible with HDMI, supports TX, can also be modified to RX |
| PMOD | 2 | Standard spacing (800mil), Compatible with dual PMOD modules |
| ADC | 2 | 2x differential input channels (One is used to measure the battery voltage) |
| RGB Interface | 1 | Supports RGB888 screen & RGB to VGA Converter |
| microSD Slot | 1 | 4-bit SDIO/MMC or SPI mode |
| BATT CONN. | 1 | Supports 3.7V li-on battery, with built-in charge management |
| FAN CONN. | 1 | Supports a 5V fan, maximum power: 1W |
| Speaker CONN. | 1 | Support mono output, 1x 2W Speaker |
| MS5351 | 1 | Provides RefClk for Serdes: control output via onboard UART |
| USB JTAG & UART | 1 | Supports FPGA programming and provides UART function |
| 2x20P headers | 2 | Independent 2x20P pin header, providing up to 2x38 IOs, can be modified to be compatible with DE10-Nano Kit |
## Hardware Resources
- ~~[Specification](https://dl.sipeed.com/shareURL/TANG/Console/01_Specification)~~
- [Schematics](https://dl.sipeed.com/shareURL/TANG/Console/02_Schematic)
- [PCB BOM](https://dl.sipeed.com/shareURL/TANG/Console/03_Designator_drawing)
- [Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Console/04_Mechanical_drawing)
- [3D Model](https://dl.sipeed.com/shareURL/TANG/Console/05_3D_file)
- [Some Chip Manuals](https://dl.sipeed.com/shareURL/TANG/Console/07_Datasheet)
- [All PIN Constraints](https://dl.sipeed.com/shareURL/TANG/Console/08_Misc)
## Getting Started
Note that **`Tang Mega 60k`** & **`Tang Mega 138k`** is currently not supported by the education version, and you need to download V1.9.11 or a newer version of the commercial IDE for use.
Lic can be applied on the Gowin official website, or you can use the online Lic service provided by Sipeed. In the IDE, select Float Lic and fill in the following information:
~~~
---Server 01---
ip: 45.33.107.56
port: 10559
---Server 02---
ip: 106.55.34.119
port: 10559
~~~
if the ip not work, try use "gowinlic.sipeed.com" domain's IP.
Install IDE [Click me](https://wiki.sipeed.com/hardware/zh/tang/common-doc/get_started/install-the-ide.html)
Example code (Github):
- [60K](https://github.com/sipeed/TangMega-60K-example)
- [138K](https://github.com/sipeed/TangMega-138K-example)
- [TangCores](https://github.com/nand2mario/tangcores)
Special Thanks: **[nand2mario](https://github.com/nand2mario)**
***
- Other Learning Resources
- Free online tutorial: [Verilog Tutorial](https://www.runoob.com/w3cnote/verilog-tutorial.html) (Learn Verilog)
- Free online FPGA tutorial: [Verilog](https://www.asic-world.com/verilog/index.html) (English website)
- Verilog practice website: [HDLBits](https://hdlbits.01xz.net/wiki/Main_Page) (English website)
- Online Gowin Semiconductor reference video tutorials: [Click here](http://www.gowinsemi.com.cn/video_complex.aspx?FId=n15:15:26)
## Communication Methods
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- Discussion forum: [maixhub.com/discussion](https://maixhub.com/discussion)
- QQ discussion group: [834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)
- Leave a message directly below this page
- Goto**[GitHub project page](https://github.com/sipeed/TangMega-60K-example)**and submit issues
- Business email : [support@sipeed.com](support@sipeed.com)
## Precautions
<table>
<tr>
<th>Item</th>
<th>Precautions</th>
</tr>
<tr>
<td>Chip Model</td>
<td>The specific model of the FPGA chip used by Tang Mega 60K is <b>GW5AT-LV60PG484A, and Tang Mega 138K is <b>GW5AST-LV138FPG676A</b>.</b> <br>Please select the package model <b>PBG484A</b> in the IDE.</td>
</tr>
<tr>
<td>Static Electricity</td>
<td>Please avoid static electricity hitting the PCBA; release the static electricity from your hands before touching the PCBA.</td>
</tr>
<tr>
<td>Tolerance Voltage</td>
<td>When using GPIO pin headers for external communication, ensure that the IO voltage is <b>3.3V</b>. Excessive voltage will permanently damage the PCBA.</td>
</tr>
<tr>
<td>FPC Socket</td>
<td>When connecting the FPC soft cable, please ensure that the cable is completely and correctly inserted into the socket without any deviation.</td>
</tr>
<tr>
<td>Plug and Unplug</td>
<td>Please completely power off before plugging and unplugging.</td>
</tr>
<tr>
<td>Avoid Short Circuit</td>
<td>Please avoid any liquid or metal touching the solder pads of the components on the PCBA during the power-on process, otherwise it may cause a short circuit and burn the PCBA.</td>
</tr>
</table>
## Contact
Tang Console can meet different needs of customers in various scenarios. For technical support and business cooperation, please contact [support@sipeed.com](support@sipeed.com)
## Frequently Asked Questions (FAQs)
### The system does not recognize the onboard debugger
- Make sure the USB cable is connected to the port marked with ***MCU***.
- Try connecting directly to the computer instead of through a USB HUB.
- Try using a better quality USB cable.
- Try another computer to rule out the computer being the problem.
- Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### The UART of the onboard debugger cannot be used
- Try reinstall FTDI drivers.
- IF the actual baudrate is always four times the set baudrate or the UART continuously outputs garbled characters. try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### OpenFPGAloader not work
- Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### How to update the firmware for the onboard debugger
- See [Update the debugger](./../common/update_debugger.md) for details.
### IDE cannot find the model
1. The educational version does not support 60K and 138K, please switch to the commercial version. The following image shows the educational version (which does not support 60K);
<img src="../assets/questions/no_model_in_IDE.png" width="35%">
2. IDE version is too low to use, update the IDE version ≥ **1.9.9**.
### How to burn the bitstream to FLASH {#burn_flash}
1. Setting the **Programmer** as shown in the figure below:
<img src="./../assets/flash_mode_GAO.png" alt="flash_mode" width=35%>
### No Response or Undesirable Pin Phenomenon After Burning
1. First, ensure that the IDE has selected the correct model
- For MEGA 60K, **GW5AT-LV60PG484AC1/10**; every parameter in the figure below **MUST** be consistent.
<img src="../tang-mega-60k/assets/partno_60K.png" alt="device_choose" width=35%>
- For MEGA 138K, **GW5AST-LV138PG484AC1/10**; every parameter in the figure below **MUST** be consistent.
<img src="../tang-mega-138k/assets/partno_138K.png" alt="device_choose" width=35%>
2. Then, check your code and the corresponding simulation waveforms to meet the requirements. The GAO tools in GOWIN IDE maybe helpful. For more information, please refer to the GOWIN document [SUG100](https://www.gowinsemi.com/upload/database_doc/1885/document/660bb2366d0b3.pdf)(require login).
---
title: Tang Console
keywords: FPGA, Tang, Console, 60K, 138K
update:
- date: 2025-01-23
version: v0.1
author: Serika
content:
- Create document
---
## Overview
**Tang Console** is an another dock board for **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md) SOM** and **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md) SOM**. It is designed to be small and compact, and is mechanically compatible with the **Raspberry Pi 5b** **`PCIe HAT`**. In addition, it also contains two 5Gbps USB3 device interfaces and two **2x20-pin header connectors**, two **PMOD connectors**. It can meet the needs of IO expansion and high-speed communication at the same time.
At the same time, it is also specially designed for retro games. Maybe you can turn it into a retro game console, or even a handheld, whatever you like.
- Date to Release: Late March , 2025
- Pre-sale link: [Click me](https://sipeed.com/tangconsole)
## Board Features
- Compatible with various SOMs (**[Mega 138k](./../tang-mega-138k/mega-138k.md)** & **[Mega 60k](./../tang-mega-60k/mega-60k.md)**)
- More compact size, more budget choice
- Compatible with Raspberry Pi 5b PCIe HAT
- PCIe 2.0 x 1
- USB3 x 2(5Gbps)
- HDMI TX x 1
- Soft-PHY USB2 x1(480Mbps)
- Onboard 3.7V Li-on battery(1-Series) charge/discharge management
## Product Appearance
<img src="./.assert/console_60k.jpg" width="45%">
## Block Diagram
TBD
## Hardware Parameters
### SOM Board Parameters
Please refer to the link below:
- **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#hardware-parameters) SOM**
- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#hardware-parameters) SOM**
### Dock board Parameters
| Item | Quantity | Remarks |
| :------------------ | ---- | ------------------------------------------------- |
| LEDs | 2(3+3) | 3x Battery-Indicator + 3x User LED (2x RGB LED) |
| Buttons | 2+1 | 2x User-KEY + 1x Reconfig-KEY |
| PCIe | 1 | 1-lane @ 8/5Gbps (Depends on SOM) |
| USB3 | 2 | SERDES lane, SuperSpeed @ 5Gbps (Device mode) |
| USB2 | 1 | IO Soft-PHY, HighSpeed @ 480Mbps (Device mode) |
| DVI(HDMI) | 1 | Compatible with HDMI, supports TX, can also be modified to RX |
| PMOD | 2 | Standard spacing (800mil), Compatible with dual PMOD modules |
| ADC | 2 | 2x differential input channels (One is used to measure the battery voltage) |
| RGB Interface | 1 | Supports RGB888 screen & RGB to VGA Converter |
| microSD Slot | 1 | 4-bit SDIO/MMC or SPI mode |
| BATT CONN. | 1 | Supports 3.7V li-on battery, with built-in charge management |
| FAN CONN. | 1 | Supports a 5V fan, maximum power: 1W |
| Speaker CONN. | 1 | Support mono output, 1x 2W Speaker |
| MS5351 | 1 | Provides RefClk for Serdes: control output via onboard UART |
| USB JTAG & UART | 1 | Supports FPGA programming and provides UART function |
| 2x20P headers | 2 | Independent 2x20P pin header, providing up to 2x38 IOs, can be modified to be compatible with DE10-Nano Kit |
## Hardware Resources
- ~~[Specification](https://dl.sipeed.com/shareURL/TANG/Console/01_Specification)~~
- [Schematics](https://dl.sipeed.com/shareURL/TANG/Console/02_Schematic)
- [PCB BOM](https://dl.sipeed.com/shareURL/TANG/Console/03_Designator_drawing)
- [Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Console/04_Mechanical_drawing)
- [3D Model](https://dl.sipeed.com/shareURL/TANG/Console/05_3D_file)
- [Some Chip Manuals](https://dl.sipeed.com/shareURL/TANG/Console/07_Datasheet)
- [All PIN Constraints](https://dl.sipeed.com/shareURL/TANG/Console/08_Misc)
## Getting Started
Note that **`Tang Mega 60k`** & **`Tang Mega 138k`** is currently not supported by the education version, and you need to download V1.9.11 or a newer version of the commercial IDE for use.
Lic can be applied on the Gowin official website, or you can use the online Lic service provided by Sipeed. In the IDE, select Float Lic and fill in the following information:
~~~
---Server 01---
ip: 45.33.107.56
port: 10559
---Server 02---
ip: 106.55.34.119
port: 10559
~~~
if the ip not work, try use "gowinlic.sipeed.com" domain's IP.
Install IDE [Click me](https://wiki.sipeed.com/hardware/zh/tang/common-doc/get_started/install-the-ide.html)
Example code (Github):
- [60K](https://github.com/sipeed/TangMega-60K-example)
- [138K](https://github.com/sipeed/TangMega-138K-example)
- [TangCores](https://github.com/nand2mario/tangcores)
Special Thanks: **[nand2mario](https://github.com/nand2mario)**
***
- Other Learning Resources
- Free online tutorial: [Verilog Tutorial](https://www.runoob.com/w3cnote/verilog-tutorial.html) (Learn Verilog)
- Free online FPGA tutorial: [Verilog](https://www.asic-world.com/verilog/index.html) (English website)
- Verilog practice website: [HDLBits](https://hdlbits.01xz.net/wiki/Main_Page) (English website)
- Online Gowin Semiconductor reference video tutorials: [Click here](http://www.gowinsemi.com.cn/video_complex.aspx?FId=n15:15:26)
## Communication Methods
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- Discussion forum: [maixhub.com/discussion](https://maixhub.com/discussion)
- QQ discussion group: [834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)
- Leave a message directly below this page
- Goto**[GitHub project page](https://github.com/sipeed/TangMega-60K-example)**and submit issues
- Business email : [support@sipeed.com](support@sipeed.com)
## Precautions
<table>
<tr>
<th>Item</th>
<th>Precautions</th>
</tr>
<tr>
<td>Chip Model</td>
<td>The specific model of the FPGA chip used by Tang Mega 60K is <b>GW5AT-LV60PG484A, and Tang Mega 138K is <b>GW5AST-LV138FPG676A</b>.</b> <br>Please select the package model <b>PBG484A</b> in the IDE.</td>
</tr>
<tr>
<td>Static Electricity</td>
<td>Please avoid static electricity hitting the PCBA; release the static electricity from your hands before touching the PCBA.</td>
</tr>
<tr>
<td>Tolerance Voltage</td>
<td>When using GPIO pin headers for external communication, ensure that the IO voltage is <b>3.3V</b>. Excessive voltage will permanently damage the PCBA.</td>
</tr>
<tr>
<td>FPC Socket</td>
<td>When connecting the FPC soft cable, please ensure that the cable is completely and correctly inserted into the socket without any deviation.</td>
</tr>
<tr>
<td>Plug and Unplug</td>
<td>Please completely power off before plugging and unplugging.</td>
</tr>
<tr>
<td>Avoid Short Circuit</td>
<td>Please avoid any liquid or metal touching the solder pads of the components on the PCBA during the power-on process, otherwise it may cause a short circuit and burn the PCBA.</td>
</tr>
</table>
## Contact
Tang Console can meet different needs of customers in various scenarios. For technical support and business cooperation, please contact [support@sipeed.com](support@sipeed.com)
## Frequently Asked Questions (FAQs)
### The system does not recognize the onboard debugger
- Make sure the USB cable is connected to the port marked with ***MCU***.
- Try connecting directly to the computer instead of through a USB HUB.
- Try using a better quality USB cable.
- Try another computer to rule out the computer being the problem.
- Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### The UART of the onboard debugger cannot be used
- Try reinstall FTDI drivers.
- IF the actual baudrate is always four times the set baudrate or the UART continuously outputs garbled characters. try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### OpenFPGAloader not work
- Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again.
### How to update the firmware for the onboard debugger
- See [Update the debugger](./../common/update_debugger.md) for details.
### IDE cannot find the model
1. The educational version does not support 60K and 138K, please switch to the commercial version. The following image shows the educational version (which does not support 60K);
<img src="../assets/questions/no_model_in_IDE.png" width="35%">
2. IDE version is too low to use, update the IDE version ≥ **1.9.9**.
### How to burn the bitstream to FLASH {#burn_flash}
1. Setting the **Programmer** as shown in the figure below:
<img src="./../assets/flash_mode_GAO.png" alt="flash_mode" width=35%>
### No Response or Undesirable Pin Phenomenon After Burning
1. First, ensure that the IDE has selected the correct model
- For MEGA 60K, **GW5AT-LV60PG484AC1/10**; every parameter in the figure below **MUST** be consistent.
<img src="../tang-mega-60k/assets/partno_60K.png" alt="device_choose" width=35%>
- For MEGA 138K, **GW5AST-LV138PG484AC1/10**; every parameter in the figure below **MUST** be consistent.
<img src="../tang-mega-138k/assets/partno_138K.png" alt="device_choose" width=35%>
2. Then, check your code and the corresponding simulation waveforms to meet the requirements. The GAO tools in GOWIN IDE maybe helpful. For more information, please refer to the GOWIN document [SUG100](https://www.gowinsemi.com/upload/database_doc/1885/document/660bb2366d0b3.pdf)(require login).
### For more questions and solutions, go to [Related Questions](./../common-doc/questions.md) to view

246
docs/hardware/zh/maixcam/maixcam_pro.md
View File

@@ -1,123 +1,123 @@
---
title: MaixCAM-Pro -- 快速落地 AI 视觉、听觉应用
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro](/static/image/maixcam_pro.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=846226367137">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://www.aliexpress.com/store/911876460">速卖通</a>
</div>
## MaixCAM-Pro 简介
MaixCAM 是为更好地落地 AI 视觉、听觉和 AIOT 应用而设计的一款硬件产品，一个能快速验证产品原型且能快速量产的平台。
提供了强大且高性价比的处理器，配套的摄像头、屏幕、WiFi 等，以及完善和非常易用的软件生态。
<div style="display: flex; justify-content: left">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/maixpy/">更多功能介绍请看 MaixPy 主页</a>
</div>
<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=113485669204279&bvid=BV1ncmRYmEDv&cid=26768769718&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
**应用场景和人群**：
* **AI算法落地**： AI 算法工程师可以快速将自己的 AI 模型部署到实体硬件（MaixCAM)上，提供易用的模型转换工具和 SDK。
* **STEM 教育**： 提供易用的 MaixPy SDK 和配套开发工具，以及在线模型训练平台，老师无需软硬件开发，专注教学，学生可以快速上手。
* **高校科研和教育**： 提供丰富的文档和教程，高校学生各个阶段的学生都有合适的学习路线，RISC-V 和 AI 前沿技术也是科研的好帮手。
* **创客和工程师的原型开发利器**：精心设计的硬件，丰富的外设，超易用的软件，让你的有趣想法和产品快速落地，不用身陷基础软硬件开发的泥潭。
* **企业产品升级、落地**：无需昂贵的研发成本快速落地产品，或者用于辅助产品比如产线 QA，旧设备使用 AI 视觉实现智能化等。
* **竞赛好帮手**：MaixCAM + MaixPy + MaixCDK 可以快速实现很多创新和功能，适合作为比赛指定软硬件平台，选手也可以依靠生态的开发效率赢得比赛， Maix 系列产品和 MaixPy 已经被用在各种比赛中获得奖项。
## MaixCAM-Pro 硬件简介
> MaixCAM-Pro 相比 [MaixCAM](./README.md) 重新设计了 PCB 和外壳以及有部分外设升级， 加粗为和 MaixCAM 的不同处
| 组件 | 描述 |
| --- | --- |
| CPU 大核 | 1GHz RISC-V C906 处理器（另外还有一个 1GHz ARM A53 核心可二选一使用），跑 Linux |
| CPU 小核 | 700MHz RISC-V C906， 跑 RTOS |
| CPU 低功耗核 | 25~300MHz 8051 处理器，用于低功耗应用 |
| NPU | 1TOPS@INT8， 支持 BF16 模型，算子支持丰富，支持常见模型比如 Mobilenetv2, YOLOv5, YOLOv8等 |
| 内存 | 256MB DDR3 |
| 存储 | TF 卡启动 / SD NAND 启动 |
| 摄像头 | 最高支持 5M 摄像头，官方支持 4M GC4653 和 OS04A10 摄像头（4 lane MIPI CSI 输入，22Pin 接口，支持拆分双路 CSI） |
| 屏幕 | **2.4 寸高清 IPS 电容触摸屏， 分辨率 640x480**（2 lane MIPI DSI 输出，标准 31pin 接口，6pin 电容触摸屏） |
| 音频输出 | 板载PA功放 + **1W 喇叭** |
| 音频输入 | 板载模拟硅麦，可直接收音 |
| 网络 | 板载 WiFi6 + BLE5.4 模组，可定制 以太网版本 |
| USB | Type-C USB2.0，支持Device和Host模式，支持 USB 摄像头 |
| IO 接口 | **2.54mm PMOD 接口， 引出 12 个 IO + Vsys/3.3v/GND 接口 + 1.25mm 6pin扩展接口**|
| 按键 | 1 x RST 按键 + 1 x USER（功能） 按键 + **1 x 电源按钮**|
| LED | 电源指示灯 + 用户 LED + **照明 LED** |
| 编解码 | H.264 / H.265 / MJPEG 硬解码， 支持 2k@30fps 编解码 |
| 外设 | I2C/SPI/UART/ADC/PWM/WDT 等常见外设 |
| 电源 | **独立电源管理芯片AXP2101，支持锂电池充放电管理，并且提供带锂电池版本** |
| 外壳 | **3D 打印+亚克力外壳， 1/4 英寸标准螺纹固定孔** |
| IMU | **板载六轴 IMU 传感器（三轴加速度+三轴角速度）** |
| RTC | **板载 BM8653 RTC 芯片+纽扣电池，断电时间仍然正确** |
| 尺寸 | **无电池版本外壳 67x51x12mm, 带电池版本厚度 16mm** |
## MaixCAM 软件生态
我们不只是做了硬件，更为 MaixCAM 提供了一套完整的软件生态，包括：
| 名称 | 描述 | 图片/视频 |
| --- | --- | --- |
| **[MaixPy](https://wiki.sipeed.com/maixpy/)** | Python 开发包， 提供丰富且使用简单的 API，针对 MaixCAM 进行优化，支持硬件加速，提供丰富文档教程 | 请看[MaixPy 主页](https://wiki.sipeed.com/maixpy/) |
| [MaixVision](https://wiki.sipeed.com/maixvision) | AI 视觉 IDE，编程、代码运行、图像实时预览，甚至图形化编程等等，大大降低开发环境搭建难度和使用门槛 | ![MaixVision](../../assets/maixcam/maixvision.jpg) <video playsinline controls muted preload style="width:100%" src="https://wiki.sipeed.com/maixpy/static/video/maixvision.mp4"></video> |
| [MaixHub](https://maixhub.com) | 在线 AI 模型训练平台，无需 AI 知识和昂贵的训练设备，一键训练模型，一键部署到 MaixCAM | ![MaixVision](../../assets/maixcam/maixhub.jpg) |
| [MaixCDK](https://github.com/sipeed/MaixCDK) | MaixPy 的 C++版本，熟悉 C/C++ 的开发者立刻上手 | 请看[MaixCDK 主页](https://github.com/sipeed/MaixCDK) |
| [应用商城](https://maixhub.com/app) | 提供各种应用和工具，无需开发直接下载使用，开发者也可以上传分享应用 | 请看 [MaixHub 应用商城](https://maixhub.com/app) |
| [分享广场](https://maixhub.com/share) | 开发者分享经验和项目 | 请看 [MaixHub 分享广场](https://maixhub.com/share) |
## 资料汇总
### MaixCAM 专属资料（Sipeed 提供）
* [MaixCAM-Pro 官方文档](https://wiki.sipeed.com/maixcam-pro)（本文档）
* [MaixPy 官方文档](https://wiki.sipeed.com/maixpy/)（Python SDK）（[MaixPy 源码](https://github.com/sipeed/MaixPy)）
* [MaixCDK](https://github.com/sipeed/MaixCDK)（C/C++ SDK）（[MaixCDK 源码](https://github.com/sipeed/MaixCDK)）
* [系统源码](https://github.com/sipeed/LicheeRV-Nano-Build)
* [硬件相关资料](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM_Pro)
* 外壳和支架：可以在[外壳文档](./assemble.md) 看到介绍，另外还开源了 外壳、支架等 3D 模型文件，请到[makerworld.com](https://makerworld.com/)（推荐） 或[makerworld.com.cn](https://makerworld.com.cn) 搜索 `MaixCAM`。
* 接口图：
![maixcam_pro_io](../../assets/maixcam/maixcam_pro_io.png)
### 芯片资料
MaixCAM-Pro 其基于算能的SG2002 芯片，所以也可以参考它们的资料，也可以参考 Sipeed 的 LiecheeRV-Nano 核心板文档。
>! 注意：MaixCAM-Pro 可以使用 LicheeRV-Nano 和 SG2002 的资料， 反之 **LicheeRV-Nano 和其它 SG2002 芯片产品没法使用 MaixPy MaixCDK MaixVision 等软件**，请不要购买错误浪费时间和金钱。
> 如果你希望快速上手开发应用，请选择 MaixCAM, 如果你是资深 Linux 开发者，只想基于 SG2002 原厂资料开发，可以选择 LicheeRV-Nano。
* [Datasheet](https://github.com/sophgo/sophgo-doc/releases) （寄存器级别的资料）
* [LicheeRV-Nano 开发板资料](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html)
* [工具链下载](https://sophon-file.sophon.cn/sophon-prod-s3/drive/23/03/07/16/host-tools.tar.gz)
* [算能 SDK 开发文档汇总](https://developer.sophgo.com/thread/471.html)
* [算能 HDK 开发文档汇总](https://developer.sophgo.com/thread/472.html)
* [算能 TPU 开发文档汇总](https://developer.sophgo.com/thread/473.html)
* [算能 TDL 开发文档汇总](https://developer.sophgo.com/thread/556.html)（基于 TPU 的高层API 封装）
### 社区资料
* [MaixHub 应用商城](https://maixhub.com/app)
* [MaixHub 分享广场](https://maixhub.com/share)
* [makerworld.com](https://makerworld.com/)(推荐) 或者 [makerworld.com.cn](https://makerworld.com.cn) 搜索 `MaixCAM`
* [Bilibili](https://bilibili.com) 搜索 `MaixCAM` 或者 `MaixPy`
## 购买
* [Sipeed 淘宝](https://sipeed.taobao.com/)
* [AliExpress](https://www.aliexpress.com/store/911876460)
---
title: MaixCAM-Pro -- 快速落地 AI 视觉、听觉应用
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro](/static/image/maixcam_pro.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=846226367137">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://www.aliexpress.com/store/911876460">速卖通</a>
</div>
## MaixCAM-Pro 简介
MaixCAM 是为更好地落地 AI 视觉、听觉和 AIOT 应用而设计的一款硬件产品，一个能快速验证产品原型且能快速量产的平台。
提供了强大且高性价比的处理器，配套的摄像头、屏幕、WiFi 等，以及完善和非常易用的软件生态。
<div style="display: flex; justify-content: left">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/maixpy/">更多功能介绍请看 MaixPy 主页</a>
</div>
<iframe src="//player.bilibili.com/player.html?isOutside=true&aid=113485669204279&bvid=BV1ncmRYmEDv&cid=26768769718&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"></iframe>
**应用场景和人群**：
* **AI算法落地**： AI 算法工程师可以快速将自己的 AI 模型部署到实体硬件（MaixCAM)上，提供易用的模型转换工具和 SDK。
* **STEM 教育**： 提供易用的 MaixPy SDK 和配套开发工具，以及在线模型训练平台，老师无需软硬件开发，专注教学，学生可以快速上手。
* **高校科研和教育**： 提供丰富的文档和教程，高校学生各个阶段的学生都有合适的学习路线，RISC-V 和 AI 前沿技术也是科研的好帮手。
* **创客和工程师的原型开发利器**：精心设计的硬件，丰富的外设，超易用的软件，让你的有趣想法和产品快速落地，不用身陷基础软硬件开发的泥潭。
* **企业产品升级、落地**：无需昂贵的研发成本快速落地产品，或者用于辅助产品比如产线 QA，旧设备使用 AI 视觉实现智能化等。
* **竞赛好帮手**：MaixCAM + MaixPy + MaixCDK 可以快速实现很多创新和功能，适合作为比赛指定软硬件平台，选手也可以依靠生态的开发效率赢得比赛， Maix 系列产品和 MaixPy 已经被用在各种比赛中获得奖项。
## MaixCAM-Pro 硬件简介
> MaixCAM-Pro 相比 [MaixCAM](./README.md) 重新设计了 PCB 和外壳以及有部分外设升级， 加粗为和 MaixCAM 的不同处
| 组件 | 描述 |
| --- | --- |
| CPU 大核 | 1GHz RISC-V C906 处理器（另外还有一个 1GHz ARM A53 核心可二选一使用），跑 Linux |
| CPU 小核 | 700MHz RISC-V C906， 跑 RTOS |
| CPU 低功耗核 | 25~300MHz 8051 处理器，用于低功耗应用 |
| NPU | 1TOPS@INT8， 支持 BF16 模型，算子支持丰富，支持常见模型比如 Mobilenetv2, YOLOv5, YOLOv8等 |
| 内存 | 256MB DDR3 |
| 存储 | TF 卡启动 / SD NAND 启动 |
| 摄像头 | 最高支持 5M 摄像头，官方支持 4M GC4653 和 OS04A10 摄像头（4 lane MIPI CSI 输入，22Pin 接口，支持拆分双路 CSI） |
| 屏幕 | **2.4 寸高清 IPS 电容触摸屏， 分辨率 640x480**（2 lane MIPI DSI 输出，标准 31pin 接口，6pin 电容触摸屏） |
| 音频输出 | 板载PA功放 + **1W 喇叭** |
| 音频输入 | 板载模拟硅麦，可直接收音 |
| 网络 | 板载 WiFi6 + BLE5.4 模组，可定制 以太网版本 |
| USB | Type-C USB2.0，支持Device和Host模式，支持 USB 摄像头 |
| IO 接口 | **2.54mm PMOD 接口， 引出 12 个 IO + Vsys/3.3v/GND 接口 + 1.25mm 6pin扩展接口**|
| 按键 | 1 x RST 按键 + 1 x USER（功能） 按键 + **1 x 电源按钮**|
| LED | 电源指示灯 + 用户 LED + **照明 LED** |
| 编解码 | H.264 / H.265 / MJPEG 硬解码， 支持 2k@30fps 编解码 |
| 外设 | I2C/SPI/UART/ADC/PWM/WDT 等常见外设 |
| 电源 | **独立电源管理芯片AXP2101，支持锂电池充放电管理，并且提供带锂电池版本** |
| 外壳 | **3D 打印+亚克力外壳， 1/4 英寸标准螺纹固定孔** |
| IMU | **板载六轴 IMU 传感器（三轴加速度+三轴角速度）** |
| RTC | **板载 BM8653 RTC 芯片+纽扣电池，断电时间仍然正确** |
| 尺寸 | **无电池版本外壳 67x51x12mm, 带电池版本厚度 16mm** |
## MaixCAM 软件生态
我们不只是做了硬件，更为 MaixCAM 提供了一套完整的软件生态，包括：
| 名称 | 描述 | 图片/视频 |
| --- | --- | --- |
| **[MaixPy](https://wiki.sipeed.com/maixpy/)** | Python 开发包， 提供丰富且使用简单的 API，针对 MaixCAM 进行优化，支持硬件加速，提供丰富文档教程 | 请看[MaixPy 主页](https://wiki.sipeed.com/maixpy/) |
| [MaixVision](https://wiki.sipeed.com/maixvision) | AI 视觉 IDE，编程、代码运行、图像实时预览，甚至图形化编程等等，大大降低开发环境搭建难度和使用门槛 | ![MaixVision](../../assets/maixcam/maixvision.jpg) <video playsinline controls muted preload style="width:100%" src="https://wiki.sipeed.com/maixpy/static/video/maixvision.mp4"></video> |
| [MaixHub](https://maixhub.com) | 在线 AI 模型训练平台，无需 AI 知识和昂贵的训练设备，一键训练模型，一键部署到 MaixCAM | ![MaixVision](../../assets/maixcam/maixhub.jpg) |
| [MaixCDK](https://github.com/sipeed/MaixCDK) | MaixPy 的 C++版本，熟悉 C/C++ 的开发者立刻上手 | 请看[MaixCDK 主页](https://github.com/sipeed/MaixCDK) |
| [应用商城](https://maixhub.com/app) | 提供各种应用和工具，无需开发直接下载使用，开发者也可以上传分享应用 | 请看 [MaixHub 应用商城](https://maixhub.com/app) |
| [分享广场](https://maixhub.com/share) | 开发者分享经验和项目 | 请看 [MaixHub 分享广场](https://maixhub.com/share) |
## 资料汇总
### MaixCAM 专属资料（Sipeed 提供）
* [MaixCAM-Pro 官方文档](https://wiki.sipeed.com/maixcam-pro)（本文档）
* [MaixPy 官方文档](https://wiki.sipeed.com/maixpy/)（Python SDK）（[MaixPy 源码](https://github.com/sipeed/MaixPy)）
* [MaixCDK](https://github.com/sipeed/MaixCDK)（C/C++ SDK）（[MaixCDK 源码](https://github.com/sipeed/MaixCDK)）
* [系统源码](https://github.com/sipeed/LicheeRV-Nano-Build)
* [硬件相关资料](https://dl.sipeed.com/shareURL/MaixCAM/MaixCAM_Pro)
* 外壳和支架：可以在[外壳文档](./assemble.md) 看到介绍，另外还开源了 外壳、支架等 3D 模型文件，请到[makerworld.com](https://makerworld.com/)（推荐） 或[makerworld.com.cn](https://makerworld.com.cn) 搜索 `MaixCAM`。
* 接口图：
![maixcam_pro_io](../../assets/maixcam/maixcam_pro_io.png)
### 芯片资料
MaixCAM-Pro 其基于算能的SG2002 芯片，所以也可以参考它们的资料，也可以参考 Sipeed 的 LiecheeRV-Nano 核心板文档。
>! 注意：MaixCAM-Pro 可以使用 LicheeRV-Nano 和 SG2002 的资料， 反之 **LicheeRV-Nano 和其它 SG2002 芯片产品没法使用 MaixPy MaixCDK MaixVision 等软件**，请不要购买错误浪费时间和金钱。
> 如果你希望快速上手开发应用，请选择 MaixCAM, 如果你是资深 Linux 开发者，只想基于 SG2002 原厂资料开发，可以选择 LicheeRV-Nano。
* [Datasheet](https://github.com/sophgo/sophgo-doc/releases) （寄存器级别的资料）
* [LicheeRV-Nano 开发板资料](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html)
* [工具链下载](https://sophon-file.sophon.cn/sophon-prod-s3/drive/23/03/07/16/host-tools.tar.gz)
* [算能 SDK 开发文档汇总](https://developer.sophgo.com/thread/471.html)
* [算能 HDK 开发文档汇总](https://developer.sophgo.com/thread/472.html)
* [算能 TPU 开发文档汇总](https://developer.sophgo.com/thread/473.html)
* [算能 TDL 开发文档汇总](https://developer.sophgo.com/thread/556.html)（基于 TPU 的高层API 封装）
### 社区资料
* [MaixHub 应用商城](https://maixhub.com/app)
* [MaixHub 分享广场](https://maixhub.com/share)
* [makerworld.com](https://makerworld.com/)(推荐) 或者 [makerworld.com.cn](https://makerworld.com.cn) 搜索 `MaixCAM`
* [Bilibili](https://bilibili.com) 搜索 `MaixCAM` 或者 `MaixPy`
## 购买
* [Sipeed 淘宝](https://sipeed.taobao.com/)
* [AliExpress](https://www.aliexpress.com/store/911876460)

238
docs/hardware/zh/maixcam/microscope.md
View File

@@ -1,119 +1,119 @@
---
title: 数码显微镜套餐
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro microscope](../../assets/maixcam/maixcam_microscope.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">速卖通</a>
</div>
## 数码显微镜套餐
MaixCAM 显微套件可将你的MaixCAM / MaixCAM Pro 转化为便携式数码显微镜， 在各方面性能上都超越同价位数码显微镜，并具备开源特性，你可以打造属于你自己独有功能的数码显微镜！
MaixCAM 显微套餐 适用于 细小元件放大焊接，生物标本观察，显微堆叠摄影 等场景，更多应用方式等你来挖掘！
### 单镜头套餐
仅包含10mm锥形镜头，10mm增距环 和 消光绒贴纸，适用于手持观察，或者你已有通用显微镜支架
![单镜头套餐](../../assets/maixcam/micro_lens.jpg)
使用方法：将maixcam的原镜头旋下，更换上锥形镜头即可
如果需要更大放大倍数，可以先旋上10mm增距环，再旋上锥形镜头。
![镜头安装方式](../../assets/maixcam/micro_lens_install.jpg)
镜头旋得越靠内，倍数越小，镜头距离物体越远（最远大概10cm左右）
镜头旋得越靠外，倍数越大，镜头距离物体越近（最近大概1cm左右）
|安装方式 | 光学倍率 | 视野 | 适合观察的物体 |
|-----------|------------------|------------------|------------------|
|10mm锥形镜头旋到最内| 0.25X|20.5x11.5mm|适合观察PCB，焊接FPC|
|10mm锥形镜头旋到最外| 0.6X|8.5x4.8mm |适合观察芯片丝印，细小飞线焊接|
|10mm锥形镜头+10mm增距环旋到最内| 1.0X| 5.1x2.9mm | 适合观察 芯片晶元整体，水蚤等较大浮游生物|
|10mm锥形镜头+10mm增距环旋到最外| 2.0X|2.56x1.44mm| 适合观察 芯片晶元细节，典型生物细胞切片|
1. 注意这里的倍率是光学倍率，非普通显微镜厂家宣称的几百倍，几千倍的虚标倍率。
2. 这里的视野以GC4653为例；如果是OS04A10,则等比例放大 3/1.8=1.67倍
安装完成后即可在MaixCAM内置的相机APP里对目标物体进行观察，拍摄。
如果光线不足，也可在APP左侧栏目打开闪光灯进行补光操作。
如果使用的时候发现画面内泛白，即说明镜头内有炫光，可以裁剪适合的消光绒片段，粘贴于锥形镜头内侧。
![消光绒抑制炫光](../../assets/maixcam/xiaoguang.jpg)
### 手动支架套餐
包含以下内容：
1. 镜头：10mm锥形镜头， 10mm增距环
2. 支架：精密铝合金支架 散件
3. 生物标本：洋葱表皮标本， 白色载物台
4. 其它：消光绒
![支架套餐](../../assets/maixcam/focusing_stand_suit.jpg)
镜头的安装方式参见上节。
支架组装及安放MaixCAM效果如下，在观察电路板等较大目标时一般不需要安装增距环：
![支架套餐](../../assets/maixcam/stand_install.jpg)
套餐内配有固定支架可以帮助固定MaixCAM Pro，安装方法如下
![支架套餐](../../assets/maixcam/install_bracket.png)
用户还可以选配迷你加热台进行焊接操作：
![支架焊接](../../assets/maixcam/stand_solder.jpg)
在观察微小生物标本时，一般需要安装增距环，打开补光灯，有必要还可以使能相机APP中的对焦放大功能。
如下图所示，将附赠的洋葱表皮标本置于白色载物台上，打开补光灯和对焦放大功能观察的效果：
![支架拍摄洋葱表皮](../../assets/maixcam/stand_onion.jpg)
实拍效果展示：
![洋葱表皮](../../assets/maixcam/onion.jpg)
![松树茎横切](../../assets/maixcam/pine.jpg)
### 电动支架套餐
可能在未来推出，使用步进电机滑台实现电动自动对焦，堆栈拍摄功能。
<video playsinline controls muted preload style="width:100%" src="../../assets/maixcam/micro_focus.mp4"></video>
## 效果对比
### 参数对照表
| |**MaixCAM显微套餐**|**当当狸M2B显微镜**|
|-----------|------------------|-----------------|
|Sensor分辨率| 2560x1440 | 1600x1200 |
|显示屏 | 2.4寸 640x480 | 4寸 800x480 |
|交互操作 | 全屏触摸 |物理按键+触摸按键 |
|相对孔径 | F1:2.5 更大更明亮 | F1:4.5 |
|照片拍摄 | ✓ 可调参数 |✓ 固定参数 |
|视频录制拍摄 | MP4 体积更小 | AVI 体积庞大 |
|延时摄影 | ✓ | X |
|光学放大倍率 | 无增距环:0.25～0.6<br>加增距环: 1.0~2.0 | 0.42～0.92|
|最大放大倍率下<br>单像素物理尺寸|1um | 2.7um |
|支架 | 稳固铝合金支架 | 普通塑料支架 |
### 实拍对比
每张对比图中，上图为 当当狸M2B显微镜 最大倍数拍摄效果，下图为 MaixCAM显微镜 最大倍数拍摄效果
![c1](../../assets/maixcam/c1.jpg)
![c2](../../assets/maixcam/c2.jpg)
![c3](../../assets/maixcam/c3.jpg)
![c4](../../assets/maixcam/c4.jpg)
![c5](../../assets/maixcam/c5.jpg)
![c6](../../assets/maixcam/c6.jpg)
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">速卖通</a>
</div>
---
title: 数码显微镜套餐
---
<div style="width:100%; display:flex;justify-content: center;">
![maixcam-pro microscope](../../assets/maixcam/maixcam_microscope.png)
</div>
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">速卖通</a>
</div>
## 数码显微镜套餐
MaixCAM 显微套件可将你的MaixCAM / MaixCAM Pro 转化为便携式数码显微镜， 在各方面性能上都超越同价位数码显微镜，并具备开源特性，你可以打造属于你自己独有功能的数码显微镜！
MaixCAM 显微套餐 适用于 细小元件放大焊接，生物标本观察，显微堆叠摄影 等场景，更多应用方式等你来挖掘！
### 单镜头套餐
仅包含10mm锥形镜头，10mm增距环 和 消光绒贴纸，适用于手持观察，或者你已有通用显微镜支架
![单镜头套餐](../../assets/maixcam/micro_lens.jpg)
使用方法：将maixcam的原镜头旋下，更换上锥形镜头即可
如果需要更大放大倍数，可以先旋上10mm增距环，再旋上锥形镜头。
![镜头安装方式](../../assets/maixcam/micro_lens_install.jpg)
镜头旋得越靠内，倍数越小，镜头距离物体越远（最远大概10cm左右）
镜头旋得越靠外，倍数越大，镜头距离物体越近（最近大概1cm左右）
|安装方式 | 光学倍率 | 视野 | 适合观察的物体 |
|-----------|------------------|------------------|------------------|
|10mm锥形镜头旋到最内| 0.25X|20.5x11.5mm|适合观察PCB，焊接FPC|
|10mm锥形镜头旋到最外| 0.6X|8.5x4.8mm |适合观察芯片丝印，细小飞线焊接|
|10mm锥形镜头+10mm增距环旋到最内| 1.0X| 5.1x2.9mm | 适合观察 芯片晶元整体，水蚤等较大浮游生物|
|10mm锥形镜头+10mm增距环旋到最外| 2.0X|2.56x1.44mm| 适合观察 芯片晶元细节，典型生物细胞切片|
1. 注意这里的倍率是光学倍率，非普通显微镜厂家宣称的几百倍，几千倍的虚标倍率。
2. 这里的视野以GC4653为例；如果是OS04A10,则等比例放大 3/1.8=1.67倍
安装完成后即可在MaixCAM内置的相机APP里对目标物体进行观察，拍摄。
如果光线不足，也可在APP左侧栏目打开闪光灯进行补光操作。
如果使用的时候发现画面内泛白，即说明镜头内有炫光，可以裁剪适合的消光绒片段，粘贴于锥形镜头内侧。
![消光绒抑制炫光](../../assets/maixcam/xiaoguang.jpg)
### 手动支架套餐
包含以下内容：
1. 镜头：10mm锥形镜头， 10mm增距环
2. 支架：精密铝合金支架 散件
3. 生物标本：洋葱表皮标本， 白色载物台
4. 其它：消光绒
![支架套餐](../../assets/maixcam/focusing_stand_suit.jpg)
镜头的安装方式参见上节。
支架组装及安放MaixCAM效果如下，在观察电路板等较大目标时一般不需要安装增距环：
![支架套餐](../../assets/maixcam/stand_install.jpg)
套餐内配有固定支架可以帮助固定MaixCAM Pro，安装方法如下
![支架套餐](../../assets/maixcam/install_bracket.png)
用户还可以选配迷你加热台进行焊接操作：
![支架焊接](../../assets/maixcam/stand_solder.jpg)
在观察微小生物标本时，一般需要安装增距环，打开补光灯，有必要还可以使能相机APP中的对焦放大功能。
如下图所示，将附赠的洋葱表皮标本置于白色载物台上，打开补光灯和对焦放大功能观察的效果：
![支架拍摄洋葱表皮](../../assets/maixcam/stand_onion.jpg)
实拍效果展示：
![洋葱表皮](../../assets/maixcam/onion.jpg)
![松树茎横切](../../assets/maixcam/pine.jpg)
### 电动支架套餐
可能在未来推出，使用步进电机滑台实现电动自动对焦，堆栈拍摄功能。
<video playsinline controls muted preload style="width:100%" src="../../assets/maixcam/micro_focus.mp4"></video>
## 效果对比
### 参数对照表
| |**MaixCAM显微套餐**|**当当狸M2B显微镜**|
|-----------|------------------|-----------------|
|Sensor分辨率| 2560x1440 | 1600x1200 |
|显示屏 | 2.4寸 640x480 | 4寸 800x480 |
|交互操作 | 全屏触摸 |物理按键+触摸按键 |
|相对孔径 | F1:2.5 更大更明亮 | F1:4.5 |
|照片拍摄 | ✓ 可调参数 |✓ 固定参数 |
|视频录制拍摄 | MP4 体积更小 | AVI 体积庞大 |
|延时摄影 | ✓ | X |
|光学放大倍率 | 无增距环:0.25～0.6<br>加增距环: 1.0~2.0 | 0.42～0.92|
|最大放大倍率下<br>单像素物理尺寸|1um | 2.7um |
|支架 | 稳固铝合金支架 | 普通塑料支架 |
### 实拍对比
每张对比图中，上图为 当当狸M2B显微镜 最大倍数拍摄效果，下图为 MaixCAM显微镜 最大倍数拍摄效果
![c1](../../assets/maixcam/c1.jpg)
![c2](../../assets/maixcam/c2.jpg)
![c3](../../assets/maixcam/c3.jpg)
![c4](../../assets/maixcam/c4.jpg)
![c5](../../assets/maixcam/c5.jpg)
![c6](../../assets/maixcam/c6.jpg)
<div style="padding: 1em 0 0 0; display: flex; justify-content: center">
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://item.taobao.com/item.htm?id=878126152834">淘宝</a>
<a target="_blank" style="margin: 1em;color: white; font-size: 0.9em; border-radius: 0.3em; padding: 0.5em 2em; background-color: #a80202" href="https://wiki.sipeed.com/store">速卖通</a>
</div>

1248
docs/hardware/zh/sidebar.yaml
View File

File diff suppressed because it is too large Load Diff

888
docs/hardware/zh/tang/common-doc/update_debugger.md
View File

@@ -1,444 +1,444 @@
---
title: 更新板载调试器（固件）
keywords: Sipeed, Gowin, Tang, FPGA, Nano, Primer, Mega
update:
- date: 2025-02-18
version: v0.8
author: Serika
content:
- First release
---
## 概述
所有 Sipeed Tang 系列均有板载调试器（独立的 SOM 除外）。调试器是具有自己固件的独立 **MCU**。用户可以自行更新这些调试器的固件以获取功能更新和错误修复。
我们需要使用 [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) 对这些板载调试器主控进行编程，有关 **博流MCU** 的 ***芯片 & 工具*** 的文档可以在此处找到 [【点我跳转】](https://dev.bouffalolab.com/document/)。
这里有一个简略的步骤说明：
- 首先，根据您所使用的操作系统，选择下载并安装相应版本的**更新工具**，如[**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/)；
- 从 [**Sipeed 下载站**](https://dl.sipeed.com/shareURL/TANG/Debugger/onboard) 获取适用于您主板的更新调试器固件，请注意区分您的开发板的型号；
- 请参阅 [**博流智能官方网站**](https://dev.bouffalolab.com/download/) 上相应的官方文档来更新板载调试器的固件；
- 对于 **Windows** 用户，下方有详细的分步骤教程。其他操作系统的用户请参考 **Windows** 的步骤并根据实际情况相应变通。
## 教程
### 硬件准备
要将板载调试器置于 **DFU 模式**，请在打开电路板电源或使用电缆连接电路板的调试 USB 端口之前`按下` ***更新按钮*** 或`短接`相应的 ***测试点***。
请参阅下文了解相应的 ***更新按钮*** 和 ***测试点***。
#### **Tang nano 系列**
- **Tang nano 1K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的左上角，按键`KEY-B` 后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wideof 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 1K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano1k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano4k_update](./assets/hardware/nano1k_update.jpg) -->
- **Tang nano 4K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的左上角，`USB-C` 连接器后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wideof 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 4K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano4k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano4k_update](./assets/hardware/nano4k_update.jpg) -->
- **Tang nano 9K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的中间左侧，`USB-C` 连接器后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 9K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano9k_update](./assets/hardware/nano9k_update.jpg) -->
- **Tang nano 20K**
**`更新按钮`** 位于PCB的 **TOP** 面的 HDMI 连接器后面的，旁边有丝印 **`UPDATE`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 20K的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/nano20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano20k_update](./assets/hardware/nano20k_update.jpg) -->
#### **Tang Primer 系列**
- **Tang Primer 20K Dock**
**`更新按钮`** 位于PCB的 **TOP** 面的 HDMI 连接器后面的，旁边有丝印 **`UPDATE`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 20K Dock的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/Primer20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer20k_update](./assets/hardware/Primer20k_update.jpg) -->
- **Tang Primer 25K Dock**
2 个 **`测试点`** 位于PCB的 **BOT** 面的左上角，丝印标记为 `3V3` 和 `TDO`。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 25K Dock的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Primer25k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer25k_update](./assets/hardware/Primer25k_update.jpg) -->
- ~~**Tang Primer 15K Dock**~~（尚未发布）
***TBD***
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 15K Dock的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Primer15k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer15k_update](./assets/hardware/Primer15k_update.jpg) -->
#### **Tang MEGA 系列**（包含Tang Console）
- **Tang MEGA NEO Dock**（包含 Tang MEGA 138K Dock）
**`更新按钮`** 位于 PCB 的 **TOP** 面 `USB-C` 连接器下方，丝印标记为 **DEBUG-USB2**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看MEGA NEO Dock的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/Mega-neo_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-neo_update](./assets/hardware/Mega-neo_update.jpg) -->
- **Tang MEGA 138K Pro Dock**
**`更新按钮`** 位于 `USB-C` 连接器的左侧，在PCB的 **TOP** 面标记为 **JATG|UART**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看MEGA 138K Pro Dock的下载器更新按钮的位置</font></summary>
<img src="./assets/hardware/Mega-138kpro_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-138kpro_update](./assets/hardware/Mega-138kpro_update.jpg) -->
- **Tang Console**
**`更新按钮`** 位于 `USB-C` 连接器的另一侧，在 PCB 的 **TOP** 面，是两个按钮中较矮的一个，丝印标记为 **`BOOT`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看 Console 的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Mega-console_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-console_update](./assets/hardware/Mega-console_update.jpg) -->
***
### 软件准备
- 首先从 [**BouffaloLab 官网**](https://dev.bouffalolab.com/download/) 下载 **BouffaloLabDevCube**，最新版本为 **`1.9.0`** (2025 年 2 月 10 日)
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/download_bldc.jpg">
</details>
<br>
<!-- ![download_BLDevCube](./assets/download_bldc.jpg) -->
- 解压下载的内容，并执行相应的可执行文件，在 Windows 下是 **`BLDevCube.exe`**
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/run_bldc.jpg">
</details>
<br>
<!-- ![run_BLDevCube](./assets/run_bldc.jpg) -->
- 在弹出的窗口中，选择芯片型号为 BL616/618
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/model-sel_bldc.jpg">
</details>
<br>
<!-- ![model-sel_BLDevCube](./assets/model-sel_bldc.jpg) -->
- 在新窗口中，选中 ***Single download option*** 下方的 **`Enable`** 复选框。单击 **`Browse`** 按钮选择要更新的固件档案
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/mainw_bldc.jpg">
</details>
<br>
<!-- ![mainwindow_BLDevCube](./assets/mainw_bldc.jpg) -->
- 让板载调试器进入 **DFU模式**，它应该是 BL702 或 BL616 的 CDC-ACM 设备。在 Windows 上这会注册一个新的 COM 端口，在此示例中为 **`COM12`**
- 关于如何让板载调试器进入 **DFU模式**，请参考上一章节[【点我跳转】](#硬件准备)
- 对于 Linux 用户，CDC-ACM 通常注册为 `/dev/ttyACMx`
- 对于 macOS 用户，它可能注册为 `/dev/tty.usbmodemxxxx` 或`/dev/cu.usbmodemxxxx` （每个 `x` 代表一位数字）
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/new_com-port.jpg">
</details>
<br>
<!-- ![new_com-port](./assets/new_com-port.jpg) -->
- 然后设置 **BLDevCube**，如下所示。设置固件档案位置、DFU 模式的端口，然后单击 **`Open UART`**，最后单击 **`Create & Download`**。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/set_bldc.jpg">
</details>
<br>
<!--
![setting_BLDevCube](./assets/set_bldc.jpg) -->
- 等待下载完成，如下图所示绿色进度条到100%，下方 **log** 提示 **`[All Success]`** 即为下载完成
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/complete_bldc.jpg">
</details>
<br>
<!-- ![download_complete](./assets/complete_bldc.jpg) -->
***
### 确认结果
完成以上步骤后，我们需要确认板载调试器的固件是否烧录成功。通常重新插拔 USB 线或重新给板子上电即可确认。
- 在 Windows 中，可以在设备管理器中看到两个新设备：**`USB Converter A`** 和 **`USB Converter B`**。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/ftdi_dual.jpg">
</details>
<br>
<!-- ![dual_usbconverter](./assets/ftdi_dual.jpg) -->
- 要确认调试器固件版本，请双击任意一个 **`USB Converter`**，然后转到“Details”选项卡。然后从下拉菜单中选择 **`父系`** 或 **`上层`** 选项：
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/detail_usbconverter.jpg">
</details>
<br>
<!-- ![detail_usbconverter](./assets/detail_usbconverter.jpg) -->
- 如下图所示，最后 10 位数字 **`2025102315`** 是调试器固件版本的序列号。 Linux 和 macOS 用户可以使用命令 **`dmesg`** 检查内核日志中的序列号。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/serialnum_usbconverter.jpg">
</details>
<br>
<!--
![serialnum_usbconverter](./assets/serialnum_usbconverter.jpg) -->
### 最新固件
所有Tang系列板载调试器的最新固件序列号记录在这里：
| 开发板型号 | MCU 型号 | 下载链接 |串号| SHA256 杂凑/校验 |
| ------------- | ---------- | -------------------------------------------------------------------------------------------------------------| --------- |-----------------------------------------------------------------------------------------------------------------------------------------------|
| nano 1K | BL702 | N/A | N/A |N/A |
| nano 4K | BL702 | N/A | N/A |N/A |
| Nano 9K | BL702 | N/A | N/A |N/A |
| Primer 20K | BL702 | N/A | N/A |N/A |
| | | | | |
| nano 20K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.bin) |2025012315 |[bl616_fpga_partner_20kNano.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.sha256) |
| Primer 25K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.bin) |2025012315 |[bl616_fpga_partner_25kDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.sha256) |
| Mega NEO | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.bin) |2025012315 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.sha256) |
| Mega 138K Pro | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.bin) |2025012315 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.sha256)|
| Console | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.bin) |2025012319 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.sha256) |
### 故障排除
如果您在使用过程中遇到任何问题，或者对文档有任何意见或建议，请随时向我们反馈。联系方式如下。
- **交流论坛: [maixhub.com/discussion](https://maixhub.com/discussion)**
- **QQ 交流群：[834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)**
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- 商业邮箱 : [support@sipeed.com](support@sipeed.com)
- 直接本页下方留言
>在大多数情况下，对于MCU相关的问题 ***博流智能*** 的官方文档足以进行故障排除。[【点击这里】](https://dev.bouffalolab.com/document/)以访问相关文档。
#### 常见问题
- TBD，等待收集反馈后再添加。
---
title: 更新板载调试器（固件）
keywords: Sipeed, Gowin, Tang, FPGA, Nano, Primer, Mega
update:
- date: 2025-02-18
version: v0.8
author: Serika
content:
- First release
---
## 概述
所有 Sipeed Tang 系列均有板载调试器（独立的 SOM 除外）。调试器是具有自己固件的独立 **MCU**。用户可以自行更新这些调试器的固件以获取功能更新和错误修复。
我们需要使用 [**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/) 对这些板载调试器主控进行编程，有关 **博流MCU** 的 ***芯片 & 工具*** 的文档可以在此处找到 [【点我跳转】](https://dev.bouffalolab.com/document/)。
这里有一个简略的步骤说明：
- 首先，根据您所使用的操作系统，选择下载并安装相应版本的**更新工具**，如[**BouffaloLabDevCube**](https://dev.bouffalolab.com/download/)；
- 从 [**Sipeed 下载站**](https://dl.sipeed.com/shareURL/TANG/Debugger/onboard) 获取适用于您主板的更新调试器固件，请注意区分您的开发板的型号；
- 请参阅 [**博流智能官方网站**](https://dev.bouffalolab.com/download/) 上相应的官方文档来更新板载调试器的固件；
- 对于 **Windows** 用户，下方有详细的分步骤教程。其他操作系统的用户请参考 **Windows** 的步骤并根据实际情况相应变通。
## 教程
### 硬件准备
要将板载调试器置于 **DFU 模式**，请在打开电路板电源或使用电缆连接电路板的调试 USB 端口之前`按下` ***更新按钮*** 或`短接`相应的 ***测试点***。
请参阅下文了解相应的 ***更新按钮*** 和 ***测试点***。
#### **Tang nano 系列**
- **Tang nano 1K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的左上角，按键`KEY-B` 后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wideof 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 1K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano1k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano4k_update](./assets/hardware/nano1k_update.jpg) -->
- **Tang nano 4K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的左上角，`USB-C` 连接器后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wideof 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 4K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano4k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano4k_update](./assets/hardware/nano4k_update.jpg) -->
- **Tang nano 9K**
2 个 **`测试点`** 位于PCB的 **TOP** 面的中间左侧，`USB-C` 连接器后面。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 9K的下载器测试点的位置</font></summary>
<img src="./assets/hardware/nano20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano9k_update](./assets/hardware/nano9k_update.jpg) -->
- **Tang nano 20K**
**`更新按钮`** 位于PCB的 **TOP** 面的 HDMI 连接器后面的，旁边有丝印 **`UPDATE`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看nano 20K的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/nano20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![nano20k_update](./assets/hardware/nano20k_update.jpg) -->
#### **Tang Primer 系列**
- **Tang Primer 20K Dock**
**`更新按钮`** 位于PCB的 **TOP** 面的 HDMI 连接器后面的，旁边有丝印 **`UPDATE`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 20K Dock的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/Primer20k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer20k_update](./assets/hardware/Primer20k_update.jpg) -->
- **Tang Primer 25K Dock**
2 个 **`测试点`** 位于PCB的 **BOT** 面的左上角，丝印标记为 `3V3` 和 `TDO`。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 25K Dock的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Primer25k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer25k_update](./assets/hardware/Primer25k_update.jpg) -->
- ~~**Tang Primer 15K Dock**~~（尚未发布）
***TBD***
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看Primer 15K Dock的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Primer15k_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Primer15k_update](./assets/hardware/Primer15k_update.jpg) -->
#### **Tang MEGA 系列**（包含Tang Console）
- **Tang MEGA NEO Dock**（包含 Tang MEGA 138K Dock）
**`更新按钮`** 位于 PCB 的 **TOP** 面 `USB-C` 连接器下方，丝印标记为 **DEBUG-USB2**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看MEGA NEO Dock的下载器测更新按钮的位置</font></summary>
<img src="./assets/hardware/Mega-neo_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-neo_update](./assets/hardware/Mega-neo_update.jpg) -->
- **Tang MEGA 138K Pro Dock**
**`更新按钮`** 位于 `USB-C` 连接器的左侧，在PCB的 **TOP** 面标记为 **JATG|UART**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看MEGA 138K Pro Dock的下载器更新按钮的位置</font></summary>
<img src="./assets/hardware/Mega-138kpro_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-138kpro_update](./assets/hardware/Mega-138kpro_update.jpg) -->
- **Tang Console**
**`更新按钮`** 位于 `USB-C` 连接器的另一侧，在 PCB 的 **TOP** 面，是两个按钮中较矮的一个，丝印标记为 **`BOOT`**。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>CSS Indentation</title>
<style>
.indent {
margin-left: 0ch; /* wide of 0 characters */
}
</style>
</head>
<body>
<details class="indent">
<summary><font color="#4F84FF">点击此处查看 Console 的下载器测试点的位置</font></summary>
<img src="./assets/hardware/Mega-console_update.jpg">
</details>
</body>
<br>
</html>
<!-- ![Mega-console_update](./assets/hardware/Mega-console_update.jpg) -->
***
### 软件准备
- 首先从 [**BouffaloLab 官网**](https://dev.bouffalolab.com/download/) 下载 **BouffaloLabDevCube**，最新版本为 **`1.9.0`** (2025 年 2 月 10 日)
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/download_bldc.jpg">
</details>
<br>
<!-- ![download_BLDevCube](./assets/download_bldc.jpg) -->
- 解压下载的内容，并执行相应的可执行文件，在 Windows 下是 **`BLDevCube.exe`**
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/run_bldc.jpg">
</details>
<br>
<!-- ![run_BLDevCube](./assets/run_bldc.jpg) -->
- 在弹出的窗口中，选择芯片型号为 BL616/618
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/model-sel_bldc.jpg">
</details>
<br>
<!-- ![model-sel_BLDevCube](./assets/model-sel_bldc.jpg) -->
- 在新窗口中，选中 ***Single download option*** 下方的 **`Enable`** 复选框。单击 **`Browse`** 按钮选择要更新的固件档案
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/mainw_bldc.jpg">
</details>
<br>
<!-- ![mainwindow_BLDevCube](./assets/mainw_bldc.jpg) -->
- 让板载调试器进入 **DFU模式**，它应该是 BL702 或 BL616 的 CDC-ACM 设备。在 Windows 上这会注册一个新的 COM 端口，在此示例中为 **`COM12`**
- 关于如何让板载调试器进入 **DFU模式**，请参考上一章节[【点我跳转】](#硬件准备)
- 对于 Linux 用户，CDC-ACM 通常注册为 `/dev/ttyACMx`
- 对于 macOS 用户，它可能注册为 `/dev/tty.usbmodemxxxx` 或`/dev/cu.usbmodemxxxx` （每个 `x` 代表一位数字）
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/new_com-port.jpg">
</details>
<br>
<!-- ![new_com-port](./assets/new_com-port.jpg) -->
- 然后设置 **BLDevCube**，如下所示。设置固件档案位置、DFU 模式的端口，然后单击 **`Open UART`**，最后单击 **`Create & Download`**。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/set_bldc.jpg">
</details>
<br>
<!--
![setting_BLDevCube](./assets/set_bldc.jpg) -->
- 等待下载完成，如下图所示绿色进度条到100%，下方 **log** 提示 **`[All Success]`** 即为下载完成
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/complete_bldc.jpg">
</details>
<br>
<!-- ![download_complete](./assets/complete_bldc.jpg) -->
***
### 确认结果
完成以上步骤后，我们需要确认板载调试器的固件是否烧录成功。通常重新插拔 USB 线或重新给板子上电即可确认。
- 在 Windows 中，可以在设备管理器中看到两个新设备：**`USB Converter A`** 和 **`USB Converter B`**。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/ftdi_dual.jpg">
</details>
<br>
<!-- ![dual_usbconverter](./assets/ftdi_dual.jpg) -->
- 要确认调试器固件版本，请双击任意一个 **`USB Converter`**，然后转到“Details”选项卡。然后从下拉菜单中选择 **`父系`** 或 **`上层`** 选项：
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/detail_usbconverter.jpg">
</details>
<br>
<!-- ![detail_usbconverter](./assets/detail_usbconverter.jpg) -->
- 如下图所示，最后 10 位数字 **`2025102315`** 是调试器固件版本的序列号。 Linux 和 macOS 用户可以使用命令 **`dmesg`** 检查内核日志中的序列号。
<details>
<summary><font color="#4F84FF">点击查看图片详情</font></summary>
<img src="./assets/serialnum_usbconverter.jpg">
</details>
<br>
<!--
![serialnum_usbconverter](./assets/serialnum_usbconverter.jpg) -->
### 最新固件
所有Tang系列板载调试器的最新固件序列号记录在这里：
| 开发板型号 | MCU 型号 | 下载链接 |串号| SHA256 杂凑/校验 |
| ------------- | ---------- | -------------------------------------------------------------------------------------------------------------| --------- |-----------------------------------------------------------------------------------------------------------------------------------------------|
| nano 1K | BL702 | N/A | N/A |N/A |
| nano 4K | BL702 | N/A | N/A |N/A |
| Nano 9K | BL702 | N/A | N/A |N/A |
| Primer 20K | BL702 | N/A | N/A |N/A |
| | | | | |
| nano 20K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.bin) |2025012315 |[bl616_fpga_partner_20kNano.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_20kNano.sha256) |
| Primer 25K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.bin) |2025012315 |[bl616_fpga_partner_25kDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_25kDock.sha256) |
| Mega NEO | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.bin) |2025012315 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_NeoDock.sha256) |
| Mega 138K Pro | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.bin) |2025012315 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.sha256)|
| Console | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.bin) |2025012319 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_Console.sha256) |
### 故障排除
如果您在使用过程中遇到任何问题，或者对文档有任何意见或建议，请随时向我们反馈。联系方式如下。
- **交流论坛: [maixhub.com/discussion](https://maixhub.com/discussion)**
- **QQ 交流群：[834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)**
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- 商业邮箱 : [support@sipeed.com](support@sipeed.com)
- 直接本页下方留言
>在大多数情况下，对于MCU相关的问题 ***博流智能*** 的官方文档足以进行故障排除。[【点击这里】](https://dev.bouffalolab.com/document/)以访问相关文档。
#### 常见问题
- TBD，等待收集反馈后再添加。

1744
docs/soft/maixpy3/zh/usage/vision/maixpy3-example.ipynb
View File

File diff suppressed because one or more lines are too long

1684
layout/locales/en/LC_MESSAGES/messages.po
View File

File diff suppressed because it is too large Load Diff

1684
layout/locales/zh/LC_MESSAGES/messages.po
View File

File diff suppressed because it is too large Load Diff