Skip to content

Latest commit

 

History

History
199 lines (132 loc) · 9.62 KB

README_ZH.md

File metadata and controls

199 lines (132 loc) · 9.62 KB

MaixPy (v4)

Let's Sipeed up, Maximize AI's power!

MaixPy (v4): 快速落地 AI 视觉、听觉应用

GitHub Repo stars Apache 2.0 PyPI PyPI - Downloads GitHub repo size Build MaixCAM Trigger wiki

English | 中文

新的 MaixPy (v4) 和新的硬件平台 MaixCAM 来了(2024.4)!
如果你有任何建议,请在 MaixHub 上告诉我们,或者 Telegram/MaixPy 或 QQ 群: 862340358。

点击右上角的 Star 让我们知道你喜欢它,以鼓励我们开发更多功能。

介绍

使用 MaixPy 轻松创建 AI 视觉项目,只需 10 行代码:

from maix import camera, display, image, nn

classifier = nn.Classifier(model="/root/models/mobilenetv2.mud")
cam = camera.Camera(classifier.input_width(), classifier.input_height(), classifier.input_format())
dis = display.Display()

while 1:
    img = cam.read()
    res = classifier.classify(img)
    max_idx, max_prob = res[0]
    msg = f"{max_prob:5.2f}: {classifier.labels[max_idx]}"
    img.draw_string(10, 10, msg, image.COLOR_RED)
    dis.show(img)

效果视频:

classifier.mp4

建议的代码使用串口等 外设

from maix import uart

devices = uart.list_devices()

serial = uart.UART(devices[0], 115200)
serial.write_str("hello world")
print("received:", serial.read(timeout = 2000))

我们还提供了便捷的 MaixVision 工作站,让开发更简单快速:

maixvision.mp4

以及在线 AI 训练平台 MaixHub, 无需 AI 基础和昂贵的训练设备,一键训练模型,一键部署到 MaixCAM。

MaixHub

功能特点

Python 编程, MaixVision 工作站, AI 视觉, 视频串流, 语音识别, 外设使用 等。

细节和视频展示 请访问官网: wiki.sipeed.com/maixpy/

硬件平台 MaixCAM

提供性能强劲的硬件平台 MaixCAM:

MaixCAM

CPU NPU Memory
- 1GHz RISC-V(Linux)/ARM A53
- 700MHz RISCV-V(RTOS)
- 25~300MHz 8051(LowPower)
1Tops@INT8 NPU, support BF16
support YOLOv5 YOLOv8 etc.
256MB DDR3
Connecting Peripheral MultiMedia Price
USB2.0/WiFi6/BLE5.4 IIC/PWM/SPI/UART/WDT/ADC - 4M Camera
- 2.3" 552x368 Touchscreen
- H.264/H.265/MJPEG codec
¥169/¥249

芯片寄存器级别开放,详情看 MaixCAM

  • 大核在 RISC-V and ARM A53 二选一。
  • Maix-I K210 已过时,MaixPy v4 不支持它, 仍要使用请访问 MaixPy-v1

谁在用 MaixPy?

  • AI 算法工程师: 轻松将你的 AI 模型部署到嵌入式设备。

MaixPy 提供了易于使用的 API 来访问 NPU,以及帮助你开发 AI 模型的文档。

  • STEM:想要教学生 AI 和嵌入式开发的老师。

MaixPy 提供了易于使用的 API,PC 工具,在线 AI 训练服务... 让你专注于教授 AI,而不是硬件和复杂的软件使用。

  • 创客: 想要制作一些酷炫的项目,但不想学习复杂的硬件和软件。

MaixPy 提供了 Python API,所以你需要做的就是学习基础 Python 语法,而 MaixPy 的 API 非常易于使用,你甚至可以在几分钟内完成你的项目。

  • 工程师: 想要做一些项目,但希望尽快有一个原型。

MaixPy 易于构建项目,并提供相应的 C++ SDK,所以你可以直接使用 MaixPy 来部署或在几分钟内将 Python 代码转换为 C++。

  • 学生: 想要学习 AI,嵌入式开发。

我们提供了许多文档和教程,以及大量开源代码,帮助你找到学习路线,并逐步成长。从简单的 Python 编程到视觉,AI,音频,Linux,RTOS等。

  • 企业: 想要开发 AI 视觉产品,但没有时间或工程师来开发复杂的嵌入式系统。

使用 MaixPy 甚至图形编程来开发你的产品,不需要更多的员工和时间。例如,向你的生产线添加一个 AI QA 系统,或者根据你的需求向你的办公室添加一个 AI 安全监控器。

  • 竞赛者: 想要赢得比赛的比赛人们。

MaixPy 集成了许多功能,易于使用,加快你作品产出速度,以在有限的时间内赢得比赛,国内常见比赛都有很多同学使用 MaixPy 赢得比赛。

性能对比

相比上两代 Maix 系列产品有限的 NPU 算子支持和内存限制,MaixCAM 在保持超高性价比的同时,性能和体验有了很大的提升,强烈建议升级到最新的 MaixCAM 以及 MaixPy v4。

特征 Maix-I K210 Maix-II v831 MaixCAM
CPU 400MHz RISC-V x2 800MHz ARM7 1GHz RISC-V(Linux)
700MHz RISC-V(RTOS)
25~300MHz 8051(Low Power)
内存 6MB SRAM 64MB DDR2 256MB DDR3
NPU 0.25Tops@INT8
official says 1T but...
0.25Tops@INT8 1Tops@INT8
Encoder 1080p@30fps 2K@30fps
屏幕 2.4" 320x240 1.3" 240x240 2.28" 552x368 / 5" 1280x720 / 7" 1280x800 / 10“ 1280x800
触摸屏 2.3" 552x368
摄像头 30W 200W 500W
WiFi 2.4G 2.4G WiFi6 2.4G/5G
USB USB2.0 USB2.0
以太网 100M(选配) 100M(选配)
SD 卡接口 SPI SDIO SDIO
BLE BLE5.4
操作系统 RTOS Tina Linux Linux + RTOS
编程语言 C / C++ / MicroPython C / C++ / Python3 C / C++ / Python3
Software MaixPy MaixPy3 MaixCDK + MaixPy v4 + opencv + numpy + ...
PC 软件 MaixPy IDE MaixPy3 IDE MaixVision Workstation
文档 ⭐️⭐️⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
在线 AI 训练 ⭐️⭐️⭐️ ⭐️⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
官方应用 ⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟
AI 分类(224x224) MobileNetv1 50fps
MobileNetv2 ✖
Resnet ✖
MobileNet ✖
Resnet18 20fps
Resnet50 ✖
MobileNetv2 130fps
Resnet18 62fps
Resnet50 28fps
AI 检测 YOLOv2(224x224) 15fps YOLOv2(224x224) 15fps YOLOv5s(224x224) 100fps
YOLOv5s(320x256) 70fps
YOLOv5s(640x640) 15fps
YOLOv8n(640x640) 23fps
易用性 ⭐️⭐️⭐️⭐️ ⭐️⭐️⭐️ 🌟🌟🌟🌟🌟

Maix 生态系统

MaixPy 不仅仅是一个 Python SDK,还有一个完整的生态系统,包括硬件、软件、工具、文档、甚至云平台等。 看下面的图片:

MaixPy v1, MaixPy3 and MaixPy v4 有什么区别?

  • MaixPy v1 使用 MicroPython 编程语言,仅支持 Sipeed Maix-I K210 系列硬件,有限的第三方包。
  • MaixPy3 专为 Sipeed Maix-II-Dock v831 设计,不是长期支持版本。
  • MaixPy v4 使用 Python 编程语言,因此我们可以直接使用许多包。MaixPy v4 支持 Sipeed 的新硬件平台,这是一个长期支持版本,未来的硬件平台将支持这个版本。MaixPy v4 有一个 MaixPy-v1 兼容的 API,所以你可以快速将你的 MaixPy v1 项目迁移到 MaixPy v4。

(MaixPy v4 不支持 Maix-I K210 系列,如果你正在使用 Maix-I K210 系列,建议升级硬件平台以使用此版本,以获得更多功能和更好的性能。)

编译 MaixPy 源码

如果你想从源代码编译 MaixPy 固件,请参考 构建 MaixPy 源码 页面。

开源协议

所有在本仓库中的文件都遵循 Apache License 2.0 Sipeed Ltd. 协议,除了第三方库或者有自己的协议。

社区