Skip to content
Merged

Dev #172

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/doc/en/mllm/vlm_internvl.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Refer to the [Large Model User Guide](./basic.md) to download the model.
```python
from maix import nn, err, log, sys, image, display

model = "/root/models/InternVL2.5-1B/model.mud"
model = "/root/models/InternVL2.5-1B-maixcam2/model.mud"
log.set_log_level(log.LogLevel.LEVEL_ERROR, color = False)
disp = display.Display()

Expand Down
2 changes: 1 addition & 1 deletion docs/doc/en/peripheral/pinmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,4 +140,4 @@ See the detailed [Pinmap API Docs](../../../api/maix/peripheral/pinmap.md).
| ------------ | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MaixCAM | ![](https://wiki.sipeed.com/hardware/zh/lichee/assets/RV_Nano/intro/RV_Nano_3.jpg) | Refer to `MaixCAM-Pro` | 1. `UART0` is system log + default serial port<br>WiFi (SDIO1 + A26)<br>2. `A14` is system status LED; after setting to `GPIO`, it can be used as normal output<br>3. User button already has a system `key` driver; not recommended to read via `GPIO`<br>4. IO is `3.3V` — do not connect `5V` directly |
| MaixCAM-Pro | ![maixcam\_pro\_io](/static/image/maixcam_pro_io.png) | 1. Refer to silkscreen, e.g. `29` = GPIO, `RX` = UART<br>2. `6pin` defaults to UART and I2C | 1. Same as `MaixCAM`<br>2. `B3` drives a lighting LED, active high |
| MaixCAM2 | ![maixcam2\_io](/static/image/maixcam2_io.png) | 1. Refer to silkscreen, e.g. `A4` = GPIO, `U2R` = UART<br>2. `6pin` defaults to UART and I2C | 1. `B25` drives a lighting LED, active high<br>2. `A6` drives system status LED; can be used as GPIO output after init<br>3. IO is `3.3V` — do not connect `5V` directly |
| MaixCAM2 | ![maixcam2\_io](https://wiki.sipeed.com/hardware/assets/maixcam/maixcam2_pins.jpg) | 1. Refer to silkscreen, e.g. `A4` = GPIO, `U2R` = UART<br>2. `6pin` defaults to UART and I2C | 1. `B25` drives a lighting LED, active high<br>2. `A6` drives system status LED; can be used as GPIO output after init<br>3. IO is `3.3V` — do not connect `5V` directly |
2 changes: 1 addition & 1 deletion docs/doc/en/peripheral/pwm.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ First, we need to know which pins and PWM channels the device provides, as shown
| ------- | ------- | --- |
| MaixCAM | ![](https://wiki.sipeed.com/hardware/zh/lichee/assets/RV_Nano/intro/RV_Nano_3.jpg) | On the silkscreen, for example, `A19` is the pin name and `PWM7` is the function name |
| MaixCAM-Pro | ![maixcam_pro_io](/static/image/maixcam_pro_io.png) | The first name, such as `A19`, is the pin name; the corresponding `PWM7` is the function name |
| MaixCAM2 | ![maixcam2_io](/static/image/maixcam2_io.png) | The first name, such as `B25`, is the pin name; the corresponding `PWM6` is the function name |
| MaixCAM2 | ![maixcam2_io](https://wiki.sipeed.com/hardware/assets/maixcam/maixcam2_pins.jpg) | The first name, such as `B25`, is the pin name; the corresponding `PWM6` is the function name |

Note that pins may be used for other purposes by default; it’s best to avoid those pins. See the [pinmap](./pinmap.md) documentation for details.

Expand Down
2 changes: 1 addition & 1 deletion docs/doc/en/peripheral/spi.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ First, we need to know which pins and SPI interfaces the device provides, as sho
| ------- | ------- | --- |
| MaixCAM | ![](https://wiki.sipeed.com/hardware/zh/lichee/assets/RV_Nano/intro/RV_Nano_3.jpg) | On the silkscreen, `A24` is the pin name, `SPI4_CS` is the function name |
| MaixCAM-Pro | ![maixcam_pro_io](/static/image/maixcam_pro_io.png) | The first name, such as `A24`, is the pin name; `SPI4_CS` is the function name |
| MaixCAM2 | ![maixcam2_io](/static/image/maixcam2_io.png) | The first name, such as `B21`, is the pin name; `SPI2_CS1` is the function name |
| MaixCAM2 | ![maixcam2_io](https://wiki.sipeed.com/hardware/assets/maixcam/maixcam2_pins.jpg) | The first name, such as `B21`, is the pin name; `SPI2_CS1` is the function name |

Note that pins may be used for other purposes by default; it’s best to avoid those pins. See the [pinmap](./pinmap.md) documentation for details.

Expand Down
4 changes: 2 additions & 2 deletions docs/doc/en/peripheral/uart.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ First, we need to know which pins and I2C interfaces are available on the device
| ------------ | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| MaixCAM | ![](https://wiki.sipeed.com/hardware/zh/lichee/assets/RV_Nano/intro/RV_Nano_3.jpg) | The board’s silkscreen shows the pin name (e.g., `A19`) and function name (e.g., `UART1_TX`). |
| MaixCAM-Pro | ![maixcam\_pro\_io](/static/image/maixcam_pro_io.png) | The first label (e.g., `A19`) is the pin name, corresponding to the function name (e.g., `UART1_TX`). |
| MaixCAM2 | ![maixcam2\_io](/static/image/maixcam2_io.png) | The first label (e.g., `A21`) is the pin name, corresponding to the function name (e.g., `UART4_TX`). |
| MaixCAM2 | ![maixcam2\_io](https://wiki.sipeed.com/hardware/assets/maixcam/maixcam2_pins.jpg) | The first label (e.g., `A21`) is the pin name, corresponding to the function name (e.g., `UART4_TX`). |

Note: Pins may be used for other purposes by default. It’s best to avoid these pins—see the [pinmap](./pinmap.md) documentation.

Expand Down Expand Up @@ -305,7 +305,7 @@ print(content)

### Binary Communication Protocol

The character protocol above has a clear characteristic of using visible characters to transmit data. The advantage is simplicity and human readability. However, it uses an inconsistent number of characters and larger data volumes. For example, `$10,20*` and `$1000,2000*` have varying lengths, with `1000` using 4 characters, which means 4 bytes. We know an unsigned short integer (`uint16`) can represent values ranging from `0~65535` using only two bytes. This reduces the transmission data.
The character protocol above has a clear characteristic of using visible characters to transmit data. The advantage is simplicity and human readability. However, it uses an inconsistent number of characters and larger data volumes. For example, `$10,20*` and `$1000,2000*` have varying lengths, with `1000` using 4 characters, which means 4 bytes. We know an unsigned short integer (`uint16`) can represent values ranging from `0~65535` using only two bytes. This reduces the transmission data.

We also know visible characters can be converted to binary via ASCII tables, such as `$1000` being `0x24 0x31 0x30 0x30 0x30` in binary, requiring 5 bytes. If we directly encode `1000` in binary as `0x03E8`, we can send `0x24 0x03 0xE8` in just 3 bytes, reducing communication overhead.

Expand Down
73 changes: 36 additions & 37 deletions docs/doc/en/projects/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,56 +42,55 @@ These are usually complete projects that include source code, documentation, dem

Applications pre-installed on platforms such as `MaixCAM`, `MaixCAM Pro`, and `MaixCAM2`

Here is the translation of the table into English:

| Built-in Application | Supported Platforms | Description | Documentation |
| :--- | :--- | :--- | :--- |
| **App Store** | `MaixCAM`, `MaixCAM Pro` | Install other applications | [Documentation](https://maixhub.com/app/225) |
| **Settings** | `MaixCAM`, `MaixCAM Pro` | Modify system settings | [Documentation](https://maixhub.com/app/224) |
| **Benchmark** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Tests the comprehensive performance of hardware such as CPU/NPU | [Documentation](https://maixhub.com/app/188) |
| **App Store** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Install other applications | [Documentation](https://maixhub.com/app/225) |
| **Settings** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Modify system settings | [Documentation](https://maixhub.com/app/224) |
| **Benchmark** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Tests comprehensive performance of CPU/NPU and other hardware | [Documentation](https://maixhub.com/app/188) |
| **Local Chat** | `MaixCAM2` | Offline voice chat | [Documentation](https://maixhub.com/app/187) |
| **Desktop Monitor** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Host performance monitoring tool | [Documentation](https://maixhub.com/app/13) |
| **Facial Expression** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Emotion recognition | [Documentation](https://maixhub.com/app/189) |
| **Facial Key Points** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Key point recognition | [Documentation](https://maixhub.com/app/186) |
| **Face Recognition** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Face recognition | [Documentation](https://maixhub.com/app/190) |
| **Desktop Monitor** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Host performance monitoring gadget | [Documentation](https://maixhub.com/app/13) |
| **Face Emotion** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Emotion recognition | [Documentation](https://maixhub.com/app/189) |
| **Face Landmarks** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Key point recognition | [Documentation](https://maixhub.com/app/186) |
| **Face Recognizer** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Face recognition | [Documentation](https://maixhub.com/app/190) |
| **Face Tracking** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Face tracking | [Documentation](https://maixhub.com/app/31) |
| **Hand Gesture Classification** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Recognize different hand gestures | [Documentation](https://maixhub.com/app/192) |
| **Hand Key Points** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Hand key point detection | [Documentation](https://maixhub.com/app/192) |
| **Gesture Classifier** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Recognize different gestures | [Documentation](https://maixhub.com/app/192) |
| **Hand Landmarks** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Hand key point detection | [Documentation](https://maixhub.com/app/227) |
| **HTTP File Browser** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | View and download files via browser | [Documentation](https://maixhub.com/app/59) |
| **Human Pose** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Human pose recognition | [Documentation](https://maixhub.com/app/191) |
| **Human Pose Classification** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Recognize different human poses | [Documentation](https://maixhub.com/app/193) |
| **Pose Classifier** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Recognize different human poses | [Documentation](https://maixhub.com/app/193) |
| **Image Generation** | `MaixCAM2` | Text-to-Image, Image-to-Image | [Documentation](https://maixhub.com/app/198) |
| **Pose Calculation** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | IMU data calculation | [Documentation](https://maixhub.com/app/128) |
| **IMU AHRS** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | IMU data calculation | [Documentation](https://maixhub.com/app/128) |
| **MaixHub Client** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Interact with MaixHub | [Documentation](https://maixhub.com/app/48) |
| **Depth Estimation** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Monocular depth estimation | [Documentation](https://maixhub.com/app/195) |
| **Mouse Simulation** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Use the device as a mouse | [Documentation](https://maixhub.com/app/196) |
| **Text Recognition (OCR)** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Text recognition | [Documentation](https://maixhub.com/app/70) |
| **RTMP Live Streaming** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | RTMP streaming | [Documentation](https://maixhub.com/app/35) |
| **RTSP Streaming** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | RTSP streaming | [Documentation](https://maixhub.com/app/197) |
| **QR Code Scanner** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Scan and recognize barcodes, QR codes, Apriltag | [Documentation](https://maixhub.com/app/199) |
| **Self-learning Classification** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Learn targets and classify | [Documentation](https://maixhub.com/app/200) |
| **Self-learning Detector** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Learn targets and detect | [Documentation](https://maixhub.com/app/62) |
| **Thermal Camera 256** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | External thermal imaging module | [Documentation](https://maixhub.com/app/208) |
| **Thermal Fusion Night Vision** | `MaixCAM2` | Fusion of thermal camera and AI night vision | [Documentation](https://maixhub.com/app/210) |
| **Tracking & Counting** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | People counting | [Documentation](https://maixhub.com/app/61) |
| **Gesture Control Mouse** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Control mouse via gestures | [Documentation](https://maixhub.com/app/223) |
| **Pose Control Keyboard** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Control keyboard via human posture | [Documentation](https://maixhub.com/app/178) |
| **Local Visual LLM** | `MaixCAM2` | Image-to-Text | [Documentation](https://maixhub.com/app/194) |
| **WebRTC Streaming** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | WebRTC streaming | [Documentation](https://maixhub.com/app/202) |
| **OBB Detection** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Image detection with rotation angle | [Documentation](https://maixhub.com/app/203) |
| **YOLO11 Segmentation** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Image segmentation | [Documentation](https://maixhub.com/app/204) |
| **YOLO-World** | `MaixCAM2` | YOLO-World detection | [Documentation](https://maixhub.com/app/205) |
| **Camera** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Take photos and record videos | [Documentation](https://maixhub.com/app/221) |
| **Album** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Display photos | [Documentation](https://maixhub.com/app/222) |
| **AI Classifier** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | AI Classification | [Documentation](https://maixhub.com/app/211) |
| **AI Detector** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | AI Detection | [Documentation](https://maixhub.com/app/213) |
| **Find Color Blob** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Find color blocks | [Documentation](https://maixhub.com/app/33) |
| **Line Patrol** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Find straight lines | [Documentation](https://maixhub.com/app/215) |
| **Mouse Simulator** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Use device as a mouse | [Documentation](https://maixhub.com/app/196) |
| **OCR** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Text recognition (OCR) | [Documentation](https://maixhub.com/app/70) |
| **RTMP Live** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | RTMP streaming | [Documentation](https://maixhub.com/app/35) |
| **RTSP Stream** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | RTSP streaming | [Documentation](https://maixhub.com/app/197) |
| **Scan QR Code** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Scan and recognize barcodes, QR codes, Apriltag | [Documentation](https://maixhub.com/app/199) |
| **Self Learn Classifier** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Learn targets and classify | [Documentation](https://maixhub.com/app/200) |
| **Self Learn Tracker** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Learn targets and detect | [Documentation](https://maixhub.com/app/62) |
| **Thermal256 Camera** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | External thermal imaging module | [Documentation](https://maixhub.com/app/208) |
| **Thermal Night Vision** | `MaixCAM2` | Fusion of thermal camera and AI night vision | [Documentation](https://maixhub.com/app/228) |
| **Tracker Counter** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | People flow counting | [Documentation](https://maixhub.com/app/61) |
| **USB Hand Contrl** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Control mouse via gestures | [Documentation](https://maixhub.com/app/223) |
| **USB Pose Mario** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Control keyboard via human pose | [Documentation](https://maixhub.com/app/178) |
| **Local LLM** | `MaixCAM2` | Image-to-text | [Documentation](https://maixhub.com/app/194) |
| **WebRTC Stream** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | WebRTC streaming | [Documentation](https://maixhub.com/app/202) |
| **YOLO11 OBB** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Image detection with rotation angle | [Documentation](https://maixhub.com/app/203) |
| **YOLO11 Seg** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Image segmentation | [Documentation](https://maixhub.com/app/204) |
| **YOLO-World** | `MaixCAM2` | YOLO-World detection | [Documentation](https://maixhub.com/app/229) |
| **Camera** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Take photos, record videos | [Documentation](https://maixhub.com/app/221) |
| **Photos** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Display photos | [Documentation](https://maixhub.com/app/222) |
| **AI Classifier** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | AI classification | [Documentation](https://maixhub.com/app/211) |
| **AI Detector** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | AI detection | [Documentation](https://maixhub.com/app/213) |
| **Find blobs** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Find color blocks | [Documentation](https://maixhub.com/app/33) |
| **Line tracking** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Find lines | [Documentation](https://maixhub.com/app/215) |
| **Speech Recognition (Maix-Speech)** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | Speech to text | [Documentation](https://maixhub.com/app/216) |
| **Speech Recognition (AI LLM)** | `MaixCAM2` | Speech to text | [Documentation](https://maixhub.com/app/217) |
| **Thermal Camera** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | External thermal camera module (PMOD_Thermal32) | [Documentation](https://maixhub.com/app/218) |
| **ToF Camera** | `MaixCAM`, `MaixCAM Pro`, `MaixCAM2` | External ToF module (ToF100) | [Documentation](https://maixhub.com/app/219) |
| **UVC Camera** | `MaixCAM`, `MaixCAM Pro` | Act as a USB camera | [Documentation](https://maixhub.com/app/220) |
| **UVC Camera** | `MaixCAM`, `MaixCAM Pro` | Act as USB camera | [Documentation](https://maixhub.com/app/220) |


### Tools

Expand Down
3 changes: 1 addition & 2 deletions docs/doc/en/vision/camera.md
Original file line number Diff line number Diff line change
Expand Up @@ -305,8 +305,7 @@ MaixCAM uses M12 lens by default and supports lens replacement. Notes:
4. Want a zoom lens? Buy M12 zoom lens.
5. Default is manual focus. Auto-focus lenses require driver support; MaixCAM lacks AF circuit—you may need to write control program.

## Use USB Camera

## Use USB Camera (UVC)
Besides built-in MIPI camera, you can use USB camera.

Steps:
Expand Down
2 changes: 1 addition & 1 deletion docs/doc/zh/peripheral/gpio.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ title: MaixCAM MaixPy 使用 GPIO
| ------- | ------- | --- |
| MaixCAM | ![](https://wiki.sipeed.com/hardware/zh/lichee/assets/RV_Nano/intro/RV_Nano_3.jpg) | 板子丝印比如`A19`是引脚名,`GPIOA19/PWM7`是功能名 |
| MaixCAM-Pro | ![maixcam_pro_io](/static/image/maixcam_pro_io.png) | 第一个名如`A19`是引脚名,对应`GPIOA19/PWM7`是功能名 |
| MaixCAM2 | ![maixcam2_io](/static/image/maixcam2_io.png) | 第一个名如`A2`是引脚名,对应`GPIOA2/SPI1_CS0`是功能名,即使用`GPIO`功能只需要在`IO`名前面加一个`GPIO`即可。 |
| MaixCAM2 | ![maixcam2_io](https://wiki.sipeed.com/hardware/assets/maixcam/maixcam2_pins.jpg) | 第一个名如`A2`是引脚名,对应`GPIOA2/SPI1_CS0`是功能名,即使用`GPIO`功能只需要在`IO`名前面加一个`GPIO`即可。 |

需要注意的是,引脚默认可能用做其它用途,最好避开这些引脚,请看[pinmap](./pinmap.md) 文档中的说明。

Expand Down
Loading