diff --git a/config/config_en.json b/config/config_en.json index fe991729..8ae063de 100755 --- a/config/config_en.json +++ b/config/config_en.json @@ -91,7 +91,7 @@ ] }, { - "label":"Articles", + "label":"News", "url":"/news/", "position":"left" }, diff --git a/config/config_zh.json b/config/config_zh.json index a0bdadd4..60fd6493 100755 --- a/config/config_zh.json +++ b/config/config_zh.json @@ -60,7 +60,7 @@ "position": "left" }, { - "label":"博文精选", + "label":"最新动态", "url":"/news/", "position":"left" }, @@ -224,7 +224,7 @@ "teedoc-plugin-thumbs-up": { "config": { "label_up": "有帮助", - "label_down": "没帮助", + "label_down": "待改进", "msg_already_voted": "您已经投过票了", "msg_thanks": "感谢您的反馈", "msg_down_prompt": "感谢反馈，请告诉我们可以改进什么地方?（最少 10 个字）", diff --git a/docs/hardware/zh/maix/M1n.md b/docs/hardware/zh/maix/M1n.md index 1e3b18fc..d8b27a8b 100644 --- a/docs/hardware/zh/maix/M1n.md +++ b/docs/hardware/zh/maix/M1n.md @@ -119,6 +119,11 @@ M1n模块以K210作为核心单元，功能非常很强大，芯片内置64位 M1n 资料下载: [Click me](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-M1n) M1n 原理图下载：[Sipeed M1n Datasheet V1.0.pdf](https://dl.sipeed.com/fileList/MAIX/HDK/Sipeed-M1n/Sipeed%20M1n%20Datasheet%20V1.0.pdf) +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) ## 产品技术支持 + Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 diff --git a/docs/hardware/zh/maix/assets/dk_board/maix_duino/maixduino_pins_1080.png b/docs/hardware/zh/maix/assets/dk_board/maix_duino/maixduino_pins_1080.png new file mode 100644 index 00000000..5aed78a4 Binary files /dev/null and b/docs/hardware/zh/maix/assets/dk_board/maix_duino/maixduino_pins_1080.png differ diff --git a/docs/hardware/zh/maix/core_module.md b/docs/hardware/zh/maix/core_module.md index 80dde560..80f3ce7e 100644 --- a/docs/hardware/zh/maix/core_module.md +++ b/docs/hardware/zh/maix/core_module.md @@ -146,6 +146,14 @@ M1/M1W Al模块系统主要由电源(3 Channel DC-DC)、Flash芯片(16M)电路 芯片 K210 Datasheet: [Kendryte 官网](https://canaan-creative.com/) M1W 资料下载: [dl.sipeed.com](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-M1&M1W) +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) + ## 产品技术支持 -Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 \ No newline at end of file + +Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 + + diff --git a/docs/hardware/zh/maix/maixpy_develop_kit_board/Maix_dock.md b/docs/hardware/zh/maix/maixpy_develop_kit_board/Maix_dock.md index 19459d0c..71807d54 100644 --- a/docs/hardware/zh/maix/maixpy_develop_kit_board/Maix_dock.md +++ b/docs/hardware/zh/maix/maixpy_develop_kit_board/Maix_dock.md @@ -126,5 +126,11 @@ Sipeed-Maix-Dock 规格书下载：[Sipeed-Maix-Dock](https://dl.sipeed.com/shar Sipeed-Maix-Dock 原理图下载：[Sipeed-Maix-Dock](https://dl.sipeed.com/fileList/MAIX/HDK/Sipeed-Maix-Dock/Maix-Dock_11.27/Maix-Dock_11.27-schematic.pdf) +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) + + ## 产品技术支持 Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 \ No newline at end of file diff --git a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_Amigo.md b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_Amigo.md index d2b618b4..6bd3f0d3 100644 --- a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_Amigo.md +++ b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_Amigo.md @@ -227,5 +227,11 @@ Maix-Amigo IPS 版本 原理图下载：Maix_Amigo_2960(Schematic).pdf +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) + + ## 产品技术支持 Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 \ No newline at end of file diff --git a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_bit.md b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_bit.md index 7818b786..da0b5c5f 100644 --- a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_bit.md +++ b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_bit.md @@ -117,11 +117,18 @@ MaixBit开发板以K210作为核心单元，功能非常很强大，芯片内置 ## 资料下载 + Sipeed-Maix-Bit 资料下载：[Sipeed-Maix-Bit](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-Maix-Bit/Maix-Bit_V2.0_with_MEMS_microphone) Sipeed-Maix-Bit 规格书下载：[Sipeed-Maix-Bit](https://dl.sipeed.com/fileList/MAIX/HDK/Sipeed-Maix-Bit/Specifications/Sipeed%20Maix-Bit%20%E8%A7%84%E6%A0%BC%E4%B9%A6%20V2.0.pdf) Sipeed-Maix-Bit 原理图下载：[Sipeed-Maix-Bit](https://dl.sipeed.com/fileList/MAIX/HDK/Sipeed-Maix-Bit/Maix-Bit_V2.0_with_MEMS_microphone/Maix-Bit_V2.0_Schematic.pdf) +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) + ## 产品技术支持 + Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 diff --git a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_cube.md b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_cube.md index 1a9fd96f..025c6b75 100644 --- a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_cube.md +++ b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_cube.md @@ -211,12 +211,18 @@ MaixCube 板载 I2C 传感器/IC ## 相关资料下载 + Sipeed-Maix-Cube 资料下载：[Sipeed-Maix-Cube](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-Maix-Cube) Sipeed-Maix-Cube 规格书下载：[Sipeed-Maix-Cube](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-Maix-Cube/ProductSpecification/Sipeed%20Maix%20Cube%20Datasheet%20V1.0.pdf) Sipeed-Maix-Cube 原理图下载：[Sipeed-Maix-Cube.pdf](https://dl.sipeed.com/shareURL/MAIX/HDK/Sipeed-Maix-Cube/Maix-Cube-2757) +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) + ## 产品技术支持 Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 \ No newline at end of file diff --git a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_duino.md b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_duino.md index fd413939..0de3c01b 100644 --- a/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_duino.md +++ b/docs/hardware/zh/maix/maixpy_develop_kit_board/maix_duino.md @@ -13,6 +13,11 @@ ![MaixDuino](./../assets/dk_board/maix_duino/maixduino_1.png) ![MaixDuino](./../assets/dk_board/maix_duino/maixduino_2.png) + +### 引脚图 + +![maixduino pins](../assets/dk_board/maix_duino/maixduino_pins_1080.png) + ### 板载功能介绍 - 电源输入 DC05: 6~12V 直流 @@ -154,5 +159,12 @@ Maixduino开发板以M1Al模块作为核心单元，功能非常很强大，模 - MaixPy的使用教程入口 （推荐） - arduino的使用教程入口 +## 软件开发 + +1. [MaixPy](https://wiki.sipeed.com/maixpy)：MicroPython 语言开发 +2. C 语言 SDK: [kendryte-standalone-sdk](https://github.com/kendryte/kendryte-standalone-sdk) +3. [Maixduino](https://github.com/sipeed/Maixduino): 适配 Arduino 库开发环境 + + ## 产品技术支持 Maix系列产品可以在多种场景实现客户不同方面的需要，在AIoT上已经广泛的使用，品质和性能在行业内已经有非常好的口碑，专业的技术团队为广大客户解决硬件设计和软件功能上的各种各样问题。专业技术支持和更详细资料请联系商务。 \ No newline at end of file diff --git a/docs/hardware/zh/maixII/M2/asserts/A2C742FF.jpg b/docs/hardware/zh/maixII/M2/asserts/A2C742FF.jpg deleted file mode 100644 index f8527634..00000000 Binary files a/docs/hardware/zh/maixII/M2/asserts/A2C742FF.jpg and /dev/null differ diff --git a/docs/hardware/zh/maixII/M2/asserts/M2Dock_pin.svg b/docs/hardware/zh/maixII/M2/asserts/M2Dock_pin.svg index 8cc9ecb0..b1622693 100644 --- a/docs/hardware/zh/maixII/M2/asserts/M2Dock_pin.svg +++ b/docs/hardware/zh/maixII/M2/asserts/M2Dock_pin.svg @@ -51,7 +51,7 @@ - + diff --git a/docs/hardware/zh/maixII/M2/asserts/m2dock.jpg b/docs/hardware/zh/maixII/M2/asserts/m2dock.jpg new file mode 100644 index 00000000..243ff4c8 Binary files /dev/null and b/docs/hardware/zh/maixII/M2/asserts/m2dock.jpg differ diff --git a/docs/hardware/zh/maixII/M2/asserts/maixhub_app_start.png b/docs/hardware/zh/maixII/M2/asserts/maixhub_app_start.png new file mode 100644 index 00000000..6f12dea4 Binary files /dev/null and b/docs/hardware/zh/maixII/M2/asserts/maixhub_app_start.png differ diff --git a/docs/hardware/zh/maixII/M2/faq.md b/docs/hardware/zh/maixII/M2/faq.md index 8c9276d0..92df4a6a 100644 --- a/docs/hardware/zh/maixII/M2/faq.md +++ b/docs/hardware/zh/maixII/M2/faq.md @@ -60,3 +60,8 @@ M2DOCK 不能本地编译以及本地 pip安装，只能搭配 Maixpy3 使用。 对于 M2Dock，前面说过开机启动代码顺序是 `/root/app/main.py > /root/main.py` ，所以在保存的时候自己注意下保存位置。 +## 文件系统只读 + +使用开发板虚拟的 U 盘时在断电前一定要记得弹出 U 盘，否则可能引起文件系统损坏，导致文件系统只读。 +最简单粗暴的方法时重烧系统镜像。 + diff --git a/docs/hardware/zh/maixII/M2/flash.md b/docs/hardware/zh/maixII/M2/flash.md index c2f89f2f..e910c277 100644 --- a/docs/hardware/zh/maixII/M2/flash.md +++ b/docs/hardware/zh/maixII/M2/flash.md @@ -2,47 +2,55 @@ title: MaixII-Dock 烧录系统 keywords: MaixII, MaixPy3, Python, Python3, M2dock desc: maixpy MaixII M2dock 烧录系统 +update: + - date: 2021.03.20 + author: dls + content: 新建文档，开始编写内容 + - date: 2021.12.8 + author: Rui & 点灯鼠 + content: 整理并更新烧录方式 + - date: 2022.3.8 + author: Rui + content: 修改烧录的注意事项 + - date: 2023.7.31 + author: Neucrack + content: 精简描述， 解决修复 livesuit 无法使用的问题 --- -> 编辑时间2022.04.27 +> 注意事项！ +> - 烧录会清空 TF 卡中所有数据，有重要数据请提前备份 +> - 部分 AMD 平台的电脑存在无法烧录的情况 +> - 少部分 TF 卡可能无法烧录镜像，建议用户购买官方的镜像 TF 卡 -| 文档更新时间 | 负责人 | 更新内容 | -| :----------: | :----------: | :--------------------: | -| 2021.03.20 | 大老鼠 | 新建文档，开始编写内容 | -| 2021.12.8 | Rui & 点灯鼠 | 整理并更新烧录方式 | -| 2022.3.8 | Rui | 修改烧录的注意事项 | +## 烧录系统简介 -注意事项！！！ -- 1、非必要的情况下，请不要随意镜像烧录。 -- 2、部分 AMD 平台的电脑存在无法烧录的情况 -- 3、不能保证所有的卡都可以成功的烧录镜像，所以建议用户直接购买官方的镜像卡 +因为 MAIX-II 的芯片是 V831，需要运行一个操作系统（Linux），软件都是在这个操作系统的基础上运行的。 +所以我们需要学会如何烧录系统（/升级系统），方便更新系统和出现问题时重刷系统。 -## 获取镜像文件 -从下载站获取最新的 V831 系统镜像 [SDK_MaixII/release](https://dl.sipeed.com/shareURL/MaixII/MaixII-Dock/SDK/release) ,得到一个压缩包，解压之后就得到一个 .img 文件，这个就是系统镜像文件 +## 获取系统镜像文件 + +从[下载站](https://dl.sipeed.com/shareURL/MaixII/MaixII-Dock/SDK/release)获取最新的 V831 系统镜像,得到一个压缩包，解压之后就得到一个 .img 文件，这个就是系统镜像文件 > 如果下载站下载的很慢，建议使用百度网盘进行下载，下载站的下载带宽有限。链接：[点我](https://pan.baidu.com/s/1vCExI3_48Q90JrxO70JdiQ) -### 镜像文件命名说明 +### 系统镜像文件命名说明 -对于 V831 的镜像文件名字是有对应的规则，以后大家可以根据自己的需求来进行下载 - -就拿`v831-m2dock-maixhub-0.5.1-20220701.zip`和 ` v831-m2dock-maixpy3-0.5.1-20220701.zip` 这两个镜像文件来说 +比如 `v831-m2dock-maixhub-0.5.1-20220701.zip`和 ` v831-m2dock-maixpy3-0.5.1-20220701.zip`： | 名称 | 含义 | | ------------- | ----------------------------------------------------------------------------------------------------------------- | -| maixpy3-0.5.1 | 此镜像是给 [MaixPy3](https://wiki.sipeed.com/maixpy3) 专用，并内置了`0.5.1`的版本，但其中 **无** 内置 maixhub app | -| maixhub-0.5.1 | 此镜像是给 [MaixPy3](https://wiki.sipeed.com/maixpy3) 专用，并内置了`0.5.1`的版本，但其中 内置 maixhub app | -| m2dock | 可使用 MaixII-Dock 开发板平台 | -| 20220701 | 镜像更新日期 | +| maixhub-0.5.1(推荐) | 此镜像是内置了 [MaixPy3](https://wiki.sipeed.com/maixpy3)`0.5.1`的版本，且内置 [maixhub app](https://maixhub.com/app/1) | +| maixpy3-0.5.1 | 此镜像是内置了 [MaixPy3](https://wiki.sipeed.com/maixpy3)`0.5.1`的版本，但其中 **无** 内置 [maixhub app](https://maixhub.com/app/1) | -> 上述镜像均为开源版，只适用于 TF 卡烧录启动 - -在内置 maixhub 的镜像中，删除 `/root/app` 文件夹里面的内容就等同于烧录了不含 maixhub 的镜像。 -在没有内置 maixhub 的系统镜像镜像中，按照 [maixhub app](https://maixhub.com/app/1) 页面的说明，将 app 文件夹存放到正确的位置，就相当于烧录了内置 maixhub 的镜像。 +> 注意点： +> * 上述镜像均为开源版，如果需要从 Flash 启动而不是从 TF 卡启动的镜像，请联系 support@sipeed.com 或者商业支持。 +> * 内置 maixhub app 的镜像就是没有内置 maixhub app 版本在 `/root/app` 放置了 [maixhub app](https://maixhub.com/app/1) ## Windows 上使用 PhoenixCard 烧录镜像 +PhoenixCard 是用来烧录全志科技芯片的工具，前者通过 USB 烧录到板载的 flash，后者用于烧录镜像到 TF 卡中。 + PhoenixSuit 和 PhoenixCard 是常用来烧录全志科技芯片的两种工具，前者通过 USB 烧录到板载的 flash，后者用于烧录镜像到 TF 卡中。 零售开源版的 M2 模组上没有焊接 Flash，因此需要使用 TF 卡来作为启动介质，需要用 PhoenixCard 烧录镜像到 TF 卡中来启动 @@ -111,9 +119,27 @@ PhoenixSuit 和 PhoenixCard 是常用来烧录全志科技芯片的两种工具 ```shell git clone https://github.com/linux-sunxi/sunxi-livesuite.git cd sunxi-livesuite - chmod +x LiveSuit.sh - sudo ./LiveSuit.sh + cd awusb + sudo dkms install . ``` + > **问题1**： 报错`make[2]: *** 没有规则可制作目标“arch/x86/entry/syscalls/syscall_32.tbl”，由“arch/x86/include/generated/uapi/asm/unistd_32.h” 需求。 停止。`的话， + > 参考[issue](https://github.com/linux-sunxi/sunxi-livesuite/issues/17)修改Makefile的 `SUBDIR`字符为`M`就可以编译通过的到`ko`文件。 + > + > **问题2**： 遇到`module: x86/modules: Skipping invalid relocation target, existing value is nonzero for type 1, loc 0000000094ea3f48, val ffffffffc2034d37` + > ``` + > sudo apt update && sudo apt upgrade + > sudo apt remove --purge linux-headers-* # 可以具体一个一个移除 + > sudo apt autoremove && sudo apt autoclean + > sudo apt install linux-headers-`uname -r` + > ``` + 保证`sudo dkms install .`成功执行 + + ``` + cd .. + chmod +x LiveSuit.sh + sudo ./LiveSuit.sh + ``` + **注意一定要加 sudo** ### 使用 Livesuit 烧录 @@ -132,7 +158,8 @@ PhoenixSuit 和 PhoenixCard 是常用来烧录全志科技芯片的两种工具 ![](./asserts/flash_21.png) -## 附录 +## 其它 + ### 烧录系统到 flash 中 [烧录方式](./no_sd_flash.md) @@ -143,4 +170,5 @@ PhoenixSuit 和 PhoenixCard 是常用来烧录全志科技芯片的两种工具 ### 使用 dd 烧录 -官方没有做 MaixII-Dock 的 dd 镜像相关支持，有需要的可以自行去学习如何制作 dd 镜像的[制作](https://www.cnblogs.com/USTHzhanglu/p/15431249.html)。 +官方没有做 MaixII-Dock 的 dd 镜像相关支持，可以自己烧录到 TF 卡后，用读卡器在电脑上自行制作。 +> 这里有个不算完美方法的[参考](https://www.cnblogs.com/USTHzhanglu/p/15431249.html)。 diff --git a/docs/hardware/zh/maixII/M2/maixhub_train.md b/docs/hardware/zh/maixII/M2/maixhub_train.md new file mode 100644 index 00000000..269bf06d --- /dev/null +++ b/docs/hardware/zh/maixII/M2/maixhub_train.md @@ -0,0 +1,71 @@ +--- +title: 体验在 MaixHub 训练自己的 AI 检测模型，并快速部署到 Maix-II-Dock +keywords: MaixII, m2dock, maixhub +update: + - date: 2023.7.31 + author: Neucrack + version: v1.0 + content: 添加文档 +--- + +你没看错，接触这款开发板的第一件事情，竟然是可以直接训练 AI 模型！ + +在进行写代码开发前，让我们一起来**零代码**体验一下训练一个自己的物体检测 AI 模型，并且快速部署到 Maix-II-Dock。 + + +## AI 物体检测模型简介 + +**目标**： +顾名思义，就是用 AI 来检测物体，比如检测人脸、玩具、卡片、车辆、水果等等。 + +开发板（设备）通过摄像头拍摄到画面（图片），然后通过 AI 模型来检测画面中的物体，包括坐标、大小、物体名称，然后将检测结果显示在屏幕上。 + +**原理**： +利用了一个叫作 YOLOv2 的物体检测模型和方法，具体怎么做到的这里先不管，后期再学习，先把它当成一个黑盒，输入图片，输出检测结果。 +而 MAIX-II 拥有硬件神经网络加速单元，可以非常快速地运行这个模型，可以实时检测画面中的物体。 + +## MaixHub 简介 + +MaixHub 是由 Sipeed 推出的 AI 平台和分享社区，可以在线训练 AI 模型，不需要开发基础，也不需要昂贵的机器，并且可以免费使用，非常适合 AI 初学者体验学习，也适合简单场景应用快速落地。 + +同时也是开发者分享社区，可以在上面找到很多大家分享的模型，以及开发经验等等。 + + +## 准备工作 + +* 确保开发板连接好了 WiFi 天线，因为需要连接互联网。 +* 准备好一个能够连接互联网的 WiFi 环境，比如路由器，手机热点等。 +* 确保在上一篇文档[烧录系统](./flash.md)中已经烧录了**最新**的文件名带有`maixhub`字样的镜像，这样上电启动后会自动进入 MaixHub APP 界面，如下： +![maixhub app](./asserts/maixhub_app_start.png) +> 另外你也可以手动[下载最新的 MaixHub APP](https://maixhub.com/app/1) 手动更新，方法见链接里面的文档说明。 + +然后可以看到界面可以切换功能，可以先切换语言选择中文，然后有其它功能比如**WiFi**、**采集图片**、**部署模型**等等。 + +* 进入 WiFi 界面，根据提示在浏览器打开 [maixhub.com/wifi](https://maixhub.com/wifi)，填写 WiFi 的 SSID 和密码生成二维码，然后开发板扫描二维码连接 WiFi。 + + +## 如何在 MaixHub 训练自己的 AI 模型及部署到 Maix-II-Dock + +* 访问[MaixHub](https://maixhub.com/)， 注册登录账号。 +* 成功登录后，首页有**AI知识** 和 **视频教程**，可以观看并学习使用。 + + +这里写一下主要的步骤，大家可以看 MaixHub 的教程以及自行举一反三摸索。 +* 创建在线训练项目，选择**图像检测**。 +* 创建数据集，选择开发板（设备）的**采集图片**功能上传图片，尽量多采集图片，尽量多覆盖使用场景。 +* 标注数据集。 +* 创建训练任务，等待云端训练完成。 +* 开发板（设备）打开**部署模型**功能，扫码部署模型。 +* 摄像头对着被检测的物体，查看检测效果。 + +## 将识别结果通过串口发送到单片机 + +下载模型，里面有`main.py`程序，里面有串口发送结果的代码，通过引脚`G6`（`TX`）发送数据，波特率为`115200`。 +将所有文件放再在 U盘`app/`目录下替换原有文件（没有`app`目录则手动新建一个），重启开发板即可自动运行。 + + + + + + + diff --git a/docs/hardware/zh/maixII/M2/other.md b/docs/hardware/zh/maixII/M2/other.md index ed6643ee..693cce0d 100644 --- a/docs/hardware/zh/maixII/M2/other.md +++ b/docs/hardware/zh/maixII/M2/other.md @@ -10,6 +10,22 @@ desc: maixpy 其他事项 以下替换设备相关操作完成后，名称为 `maixhub` 的镜像里的 app 应用不再可用 + +## 测试屏幕方法 + +- 请测试前观察系统上电后屏幕是否会闪烁一次；这表示屏幕已经通电、驱动起来，并对其复位（RST）后产生的。 + +在 Linux Shell 运行 `cat /dev/urandom > /dev/fb0` 就会输入随机数据到 fb0 产生雪花屏了，这表示屏幕显示是正常的。 + +
+ +
+ 帧缓冲相关知识 + 帧缓冲（framebuffer）是 Linux 为显示设备提供的一个接口，把显存抽象后的一种设备。 + 它允许上层应用程序在图形模式下直接对显示缓冲区进行 读写操作。framebuffer 是 LCD 对应的一种 HAL（硬件抽象层），提供抽象的，统一的接口操作，用户不必关心硬件层是怎么实施的。这些都是由 Framebuffer 设备驱动来完成的。帧缓冲设备对应的设备文件为 /dev/fb*，如果系统有多个显示卡，Linux下还可支持多个帧缓冲设备，最多可达 32 个，分别为 /dev/fb0 到 /dev/fb31，而 /dev/fb 则为当前缺省的帧缓冲设备，通常指向 /dev/fb0，在嵌入式系统中支持一个显示设备就够了。帧缓冲设备为标准字 符设备，主设备号为 29 ，次设备号则从 0 到 31 。分别对应 /dev/fb0-/dev/fb31 。 +
+ + ## 切换屏幕 目前开发板支持的屏幕有 1.3寸、2.4寸、2.8寸 的 IPS 屏，且只是支持在[我们淘宝](https://sipeed.taobao.com/)上售卖的显示屏；对于别的屏幕有需求的，可以走商务通道进行定制。 @@ -134,3 +150,29 @@ reboot #重启设备来更新配置 在[下载站](https://dl.sipeed.com/shareURL/MaixII/MaixII-Dock/SDK/Toolchain)里有一个名为 `toolchain-sunxi-musl-pack-2021-01-09.tar.xz` 的文件，这是在 Linux 系统下为 V831 所使用的编译链。 有需求的可以自行尝试，但是对于 V831 还是推荐使用 MaixPy3 和 MaixHub。 + + +## 怎么样使用 USB 摄像头 + +M2Dock 有两个 TypeC 接口。其中一个标识有 UART，作为板子与电脑进行串口通信的接口。另一个口有 OTG 标识，默认是作为 USB 从机来使用的，比如我们能够在电脑上使用 `adb` 来操作 M2Dock 就是因为这个接口默认是从机模式。 + +需要注意的是 M2Dock 系统默认将 OTG 标识设置为 adb 设备，可以在 PC 端通过 `adb` 命令来操作板子，也可以通过使得电脑上的 jypyter 通过 `adb forward` 功能在板子上运行 python 代码。 + +想要连接摄像头，需要手动更改这个端口为主机模式。从板子上的 USB UART 来操作板子，并执行下面的命令就可以将 OTG 口作为主机模式使用。 + +要注意的是之子那个下面的命令后，板子上将与电脑通过 USB OTG 口进行通信。 + +```bash +echo "usb_host" > /sys/devices/platform/soc/usbc0/otg_role +``` + +接着就能向通常的 linux 系统一样操作 /dev 目录下的摄像头了。 + +## 如何将 USB OTG 口作为从机 + +M2Dock 默认的 OTG 口就是 USB 从机设备了，要是有因为其他原因需要重新设置成从机设备的话，在 M2Dock 上执行下面的命令就可以了。 + +```bash +echo "usb_device" > /sys/devices/platform/soc/usbc0/otg_role +``` + diff --git a/docs/hardware/zh/maixII/M2/resources.md b/docs/hardware/zh/maixII/M2/resources.md index 839d6254..e8bfdfc8 100644 --- a/docs/hardware/zh/maixII/M2/resources.md +++ b/docs/hardware/zh/maixII/M2/resources.md @@ -4,26 +4,34 @@ keywords: MaixII, MaixPy3, Python, Python3, M2dock desc: 板级资源介绍 --- -Maix-II-Dock 定位于高性价比的 AIOT 开发板， 支持常规 Linux 开发的同时， 有特有的 **AI 硬件加速** 特性，配合 Sipeed 提供的完整的软件生态，让你快速实现你的边缘 AI 应用。 +Maix-II-Dock 是一块精致小巧的 `AI` + `IOT` + `音视频处理` 开发板， 支持常规 Linux 开发的同时， 有特有的 **AI 硬件加速** 特性，配合 Sipeed 提供的易用的软件生态，快速让你的边缘 AI 应用落地。 -* **硬件**上， 基于全志 V831 芯片， 以【核心板】+【底板】的形式组成开发板，可以直接使用开发板，也可以只使用核心板根据需求自行设计底板，方便快速完成开发。 -* **软件**上， 除了可以直接使用全志提供的资料进行开发（部分可能需要找全志获取）外，Sipeed 提供了非常方便的 Python SDK（[MaixPy3](/maixpy3)）以及 C SDK （[libmaix](https://github.com/sipeed/libmaix)）； -更是提供了在线模型训练服务（[MaixHub](https://maixhub.com)），方便刚入门也能快速训练能使用的 AI 模型。 -* **购买**：[sipeed.taobao.com](https://item.taobao.com/item.htm?id=635874427363) +Maix-II Dock 已经集成了大量开箱即用的功能，比如 `AI 图像和物体识别`，`AI 语音识别`，`AI 人脸识别`，`AI 车牌识别`，`小车巡线`， 传统`OpenCV`支持，`常用硬件外设库`等等。 +下面是部分功能展示视频：

+常见应用场景：`STEM 和大学教育`, `工业流水线工具`，`智能家居`，`智能机器人`，`智能监控场景`等等。 + +**硬件**上， 基于全志 V831 芯片， 以【核心板】+【底板】的形式组成开发板，可以直接使用开发板，也可以只使用核心板根据需求自行设计底板，方便快速完成开发。 +**软件**上， 除了可以直接使用全志提供的资料进行开发（部分可能需要找全志获取）外，Sipeed 提供了非常方便的 Python SDK（[MaixPy3](/maixpy3)）以及 C SDK （[libmaix](https://github.com/sipeed/libmaix)）。 +**平台**上，提供在线模型训练服务（[MaixHub](https://maixhub.com)），方便刚入门也能无门槛快速训练 AI 模型。 +**购买**：[sipeed.taobao.com](https://item.taobao.com/item.htm?id=635874427363) + + ## M2 核心板 +22mm x 24.5mm 的尺寸，使用金手指引出引脚，体积小巧又方便开发。 + core_board > 核心板硬件资料下载 [Sipeed_Maix_II_3101](https://api.dl.sipeed.com/shareURL/MaixII/MaixII-Dock/HDK/Sipeed_MaixII_V831/Sipeed_Maix_II_3101) ### V831 芯片介绍 -全志 V831, 单核 Cortex-A7 800MHz， 64MiB 片内 DDR2 内存， 高性价比能跑 Linux 的SOC，同时支持硬件 AI 加速（0.2Tops 算力），可以当成普通 Linux SOC 使用， 也可以用于边缘 AI 应用， 更详细的参数请看手册和下文。 +全志 V831, 单核 Cortex-A7 800MHz， 64MiB 片内 DDR2 内存， 高性价比能跑 Linux 的SOC，同时支持硬件 AI 加速（0.2Tops 算力）(yolov2 45 ms ~ 60 ms)，可以当成普通 Linux SOC 使用， 也可以用于边缘 AI 应用， 更详细的参数请看手册和下文。 芯片手册： [V833／V831 Datasheet V1.0.pdf](https://linux-sunxi.org/images/b/b9/V833%EF%BC%8FV831_Datasheet_V1.0.pdf) @@ -39,7 +47,7 @@ Maix-II-Dock 定位于高性价比的 AIOT 开发板， 支持常规 Linux 开 | ---------------------------- | ------------------------------------ | ------------------------------------------------------------------------------ | | 主控芯片
CPU | 400~600Mhz | 800~1000Mhz | | 视频编码器
Video encoder | None | H.264, up to 1080p@30fps
H265, up to 1080p@30fps
JPEG, up to 1080p@30fps | -| AI加速器
NPU | 0.23TOPS
support Conv+BN+ACT+POOL | 0.2TOPS
support Conv,Inner_Product,Pool,Eltwise,ACT,BN,Split,Concat | +| AI加速器
NPU | 0.23TOPS（官方宣称 1TOPS 计算方法不同）
support Conv+BN+ACT+POOL | 0.2TOPS
support Conv,Inner_Product,Pool,Eltwise,ACT,BN,Split,Concat | | 内存
Memory | 8MB SRAM | SIP 64MB DDR2 | | 存储
Storage | 16MB SPI Nor Flash | 可选的16M flash(默认空贴) | | 摄像头
Camera | DVP, 最高输入30W像素 | 2lane MIPI, 最高支持1080P@60fps | @@ -51,7 +59,7 @@ Maix-II-Dock 定位于高性价比的 AIOT 开发板， 支持常规 Linux 开 | Ethernet | None | 10/100 Mbit/s Ethernet port with RMII interface | | ADC | None | 1-ch 6bit LRADC for key | | Audio | None | LINEOUTP + MICIN1P/N | -| 开发软件 | Maixpy/C | MaixPy3/linux | +| 开发软件 | Maixpy/C | MaixPy3/C/linux | ## 底板 @@ -96,18 +104,18 @@ Maix-II-Dock 定位于高性价比的 AIOT 开发板， 支持常规 Linux 开 硬件: [MaixII 硬件资料库](https://api.dl.sipeed.com/shareURL/MaixII/MaixII-Dock/HDK) 软件： -* Python SDK： [MaixPy3 软件文档](/maixpy3) -* C SDK: [libmiax](https://github.com/sipeed/libmaix) +* Python SDK： [MaixPy3 软件文档](/maixpy3) （Python 语法，有大量易用 API，适合上手开发） +* C SDK: [libmiax](https://github.com/sipeed/libmaix) （适合高级开发者，另外要使用 OpenCV 也推荐使用此 SDK， Python 版本的 OpenCV 占用内存比较大，可能会导致内存不足） * MaixHub 模型平台（AI 模型下载、在线训练、项目分享）： [MaixHub](https://maixhub.com) * 全志 tina-V83x SDK： [Tina-Linux/tina-V83x](https://github.com/Tina-Linux/tina-V83x) * 工具链： [dl.sipeed.com](https://dl.sipeed.com/shareURL/MaixII/MaixII-Dock/SDK/Toolchain) 或者 [github](https://github.com/sipeed/libmaix/releases/download/v0.1.0/toolchain-sunxi-musl-pack-2021-01-09.tar.xz) ## Maix-II-Dock 上手开发路线指南 -* 因为需要使用 linux 系统（tina-linx）， 所以需要先学习烧录系统镜像，就类似学会电脑重装系统一样，这样在遇到问题就可以重来，在左侧目录找到“烧录系统”文章查看 +* **烧录系统镜像**： 因为需要使用 Linux 系统（tina-linux）， 所以需要先学习烧录系统镜像，就类似学会电脑重装系统一样，这样在遇到问题就可以重来，在左侧目录找到“烧录系统”文章查看 -* 学会基础的 Linux 操作，比如如何打开终端，基础的终端命令，以及如何传输文件到开发板等，比如 串口使用， adb 使用等等基础操作 -* 选择开发语言： - * 如果你熟悉 C 有一定的开发经验，可以选择使用[libmaix](https://github.com/sipeed/libmaix) +* **基本 Linux 操作**： 学会基础的 Linux 操作，比如如何打开终端，基础的终端命令，以及如何传输文件到开发板等，比如 串口使用， adb 使用等等基础操作 +* **选择开发语言**： + * 如果你熟悉 C 有一定的开发经验，可以选择使用[libmaix](https://github.com/sipeed/libmaix)，按照其 `REAME.md` 文档搭建开发环境 * 如果你希望快速上手，并使用 Python 语言开发， 请使用[MaixPy3](/maixpy3)，仔细阅读其文档即可 -* 如果需要使用 AI 功能，可以搭配 [MaixHub](https://maixhub.com) 在线训练平台使用，平台提供了 AI 模型或者项目分享功能，节约大家不少时间。 \ No newline at end of file +* **平台和分享**：如果需要使用 AI 功能，可以搭配 [MaixHub](https://maixhub.com) 在线训练平台使用，平台提供了 AI 模型或者项目分享功能，节约大家不少时间。 \ No newline at end of file diff --git a/docs/hardware/zh/maixII/M2/usage.md b/docs/hardware/zh/maixII/M2/usage.md index 9d97b42b..fc87835f 100644 --- a/docs/hardware/zh/maixII/M2/usage.md +++ b/docs/hardware/zh/maixII/M2/usage.md @@ -1,119 +1,147 @@ --- -title: 进阶使用 -keywords: MaixII, MaixPy3, Python, Python3, M2dock, Tina, Openwrt -desc: maixpy MaixII M2dock 上手使用 +title: Maix-II Dock 基础使用 --- -> 没有 Linux 系统使用基础的同学，不推荐以下的使用方式 +## 连接电脑 -阅读 [MaixII-Dock Maixpy3](https://wiki.sipeed.com/soft/maixpy3/zh/tools/0.MaixII-Dock.html) 来查看更多用法 + -## 认识 openwrt 系统 +如图，有两个 Type-C 口，一个 `USB UART`，一个 `USB OTG`。 -> 全志 V831 使用 Tina Linux 系统，移植自 [OpenWrt](https://openwrt.org) 。 +两者都可以给板子 5V 供电。 -OpenWrt 可以被描述为一个嵌入式的 Linux 发行版，详情可看 [官方网址](https://openwrt.org) 和 [官方开源仓库](https://github.com/openwrt/openwrt)。 +`USB UART` 是 板子的系统交互串口转 USB，连接此接口可以通过电脑的串口终端工具和开发板交互。 +`USB OTG` 是 `USB` 从机接口，连接此接口可以通过电脑的 `adb` 工具和开发板交互。 -OpenWRT 是一个高度模块化、高度自动化的嵌入式 Linux 系统，拥有强大的网络组件和扩展性，常常被用于工控设备、电话、小型机器人、智能家居、路由器以及 VOIP 设备中。 同时，它还提供了 100 多个已编译好的软件，而且数量还在不断增加，而 OpenWrt SDK 更简化了开发软件的工序。 +在前面文档中已经烧录了系统，现在只需要讲电脑与板子`USB OTG`口连接起来即可，等待开机，等一会儿，电脑会出现一个 `U盘`。 +> 如果开发板屏幕已经有画面了，但是电脑没有弹出 U盘，可以在电脑`设备管理器`中卸载`Android Device` -> `Android ADB Interface`，注意勾选`删除此设备的驱动软件`。 +> 如果还没出现则拔掉开发板重新插上尝试，一般都是 `ADB` 驱动问题。 +> ![](/news/MaixPy3/v831_usage/assest/adb.jpg) +> ![](/news/MaixPy3/v831_usage/assest/delete.jpg) -V831 tina 系统支持使用 adb 来操作系统。需要将主机于板子的OTG标识的接口相连。 +在 U盘 里面我们可以看到一个 `app` 文件夹，默认是[MaixHub APP](https://maixhub.com/app/1) 应用，上电会自动执行`app`目录下的`main.py`或者`main.sh`文件，可以在此目录下替换自己的应用。 +> 在给开发板断电前，一定要记得**弹出 U盘**，否则会损坏开发板文件系统导致文件系统只读（只读后可以通过烧录系统来恢复）。 + +## 在 Linux shell 执行命令 + +保证前面 U盘 会出现的情况下，我们可以通过 ADB 来和开发板进行交互。 + +ADB 程序在 windows 下需要手动安装， Linux 或者 MacOS，一般直接内置 adb 命令。 + + +Windows 安装 ADB 有两种方法： +1. 直接下载 [ADB driver](https://adbdriver.com/downloads/) 安装（不需要使用 Python 开发可以用这种方式）。 +2. 直接安装 [MaixPy3 IDE](https://dl.sipeed.com/shareURL/MaixII/MaixPy3-IDE)([百度网盘连接](https://pan.baidu.com/s/1d5zbIDSOBUvIta_rRhLx_A)) 会同时自动安装 adb 驱动。 + + +然后键盘`Win+R`输入 `cmd`进入终端，输入`adb shell`即可进入开发板的 shell 环境。 +然后我们就可以执行`Linux`命令了，比如`ls`查看目录下文件，`cd /root`进入到`/root`目录，执行`Python`文件用`python3 main.py`等。 +比如我看看`/root`目录下有什么文件： + +```bash +root@sipeed:/# ls /root +app +``` +可以看到和 U盘一样的 `app` 文件夹。 +> 更多 Linux 常用命令可自行学习，注意 这里的 Linux 实际上是一个定制版本的 OpenWrt 系统，叫作 Tina Linux，所以有些命令和 PC 的 Linux 可能会有写差异。 + + +## 通过串口与 shell 交互 + +除了通过 ADB 交互，开发板的另一个串口也可以用来交互。 +* 板子 USB UART 口连接电脑 +* 使用串口终端软件，比如 putty 或者 mobaxterm， 具体教程查看【如何使用 mobaxterm】 + +![mobaxterm_connect](./asserts/usage/mobaxterm_connect.png) + + +## Python 开发 + +### Hello world + +通过上面的终端交互的方法： +``` +cd /root +vim hello.py +``` +然后输入`i`进入编辑模式，输入下面的代码： +```python +print("Hello world") +``` +然后按`ESC`退出编辑模式，输入`:wq`保存并退出。 +然后执行`python3 hello.py`即可看到输出`Hello world`。 + +### MaixPy3 开发 + + +MaixPy3 提供了大量的易用 API，这里可以先测试一下摄像头和屏幕： +基于上面的 hello world 代码，我们创建一个`camera_show.py`： + +```python +from maix import camera, display +while 1: + img = camera.capture() + display.show(img) +``` + +在执行代码之前，确保屏幕和摄像头没有程序在使用，比如默认的`MaixHub APP`，可以操作按钮选择`退出`功能来退出`MaixHub APP`。 + +然后在终端执行`python3 camera_show.py` 就可以在屏幕看到摄像头的画面了。 + +更多使用方法参考 [MaixPy3 文档](/maixpy3) ---- -- Windows 系统需要先下载最新的 adb 然后将其解压并添加到系统路径，接着就可以在命令行中使用 adb shell 连接上 v831. -- 对于 linux 直接安装 adb 即可，然后在终端执行 adb shell 连接 V831 ---- ## M2Dock 联网 M2Dock 带有 2.4G 无线模组，可以用来连接 2.4G 频段的无线网络。 -因为镜像更新会更改部分内容，所以下面以 V0.5.4 版本的系统镜像和 V0.5.4 之前的镜像来分别说明怎么样来使用 M2Dock 连接到无线网络。 +**推荐**：可以用 [MaixHub APP](https://maixhub.com/app/1) 扫码连接。 -### V0.5.4 +也可以通过以下方式在命令行连接。 +v0.5.4 版本系统镜像和之前的镜像联网方法未兼容，根据烧录的镜像版本选择对应的联网方法： -在 0.5.4 (时间戳为 20230207 )的镜像中，移除了之前编辑配置文件然后再连接网络的方法，改为用命令行来连接无线网络。 +* v0.5.4 +.. details::, 点击展开 + 在 0.5.4 的镜像中，移除了之前编辑配置文件然后再连接网络的方法，改为用命令行来连接无线网络。 -可以看到板子中内置了许多 wifi 相关的命令（按 TAB 补全剩余命令，没有就自己手动敲完整） + 可以看到板子中内置了许多 wifi 相关的命令（按 TAB 补全剩余命令，没有就自己手动敲完整） -![wifi_test_command_list](./asserts/usage/wifi_test_command_list.jpg) + ![wifi_test_command_list](./asserts/usage/wifi_test_command_list.jpg) -这里只使用 `wifi_connect_ap_test` 命令来连接无线网络，在使用之前可以先直接执行 `wifi_scan_results_test` 命令来扫描周围网络，确定板子可以识别到目标无线网络。 + 这里只使用 `wifi_connect_ap_test` 命令来连接无线网络，在使用之前可以先直接执行 `wifi_scan_results_test` 命令来扫描周围网络，确定板子可以识别到目标无线网络。 -使用下面的命令来连接名称为 `Sipeed_Guest`， 且密码为 `qwert123` 的无线网络。 + 使用下面的命令来连接名称为 `Sipeed_Guest`， 且密码为 `qwert123` 的无线网络。 -```bash -wifi_connect_ap_test Sipeed_Guest qwert123 -``` + ```bash + wifi_connect_ap_test Sipeed_Guest qwert123 + ``` -![wifi_test_connect_wireless](./asserts/usage/wifi_test_connect_wireless.jpg) + ![wifi_test_connect_wireless](./asserts/usage/wifi_test_connect_wireless.jpg) -在连接的信息中可以看到 `192.168.3.158` 这串数字，这是板子在当前网络环境中的 IP 地址。 + 在连接的信息中可以看到 `192.168.3.158` 这串数字，这是板子在当前网络环境中的 IP 地址。 -执行 `ifconfig` 命令可以看到 wlan0 的 IP 地址为 `192.168.3.158`，与连接 WiFi 时候的信息一样。 + 执行 `ifconfig` 命令可以看到 wlan0 的 IP 地址为 `192.168.3.158`，与连接 WiFi 时候的信息一样。 -![wifi_test_ifconfig](./asserts/usage/wifi_test_ifconfig.jpg) + ![wifi_test_ifconfig](./asserts/usage/wifi_test_ifconfig.jpg) -### V0.5.4 之前的镜像 -开发板上的 OTG 接口与电脑连接之后，就会在资源管理器中得到一个 U 盘 设备。通过编辑器打开里面名为 `wpa_supplicant.conf` 文件 +* v0.5.4 前 -![wap_conf_png](./asserts/usage/wap_conf.png) +.. details::, 点击展开 + 开发板上的 OTG 接口与电脑连接之后，就会在资源管理器中得到一个 U 盘 设备。通过编辑器打开里面名为 `wpa_supplicant.conf` 文件 -可以看到里面有 `yourWIFIname` 和 `yourWIFIpassword` 两项，将他们更改成你想要连接的无线网络和对应的无线网络密码并保存后，使用电脑系统自带的弹出 U 盘操作方式来移除 U 盘，这样可以避免损坏 U 盘的文件系统。接着在 m2dock 命令行终端执行 `reboot` 命令来重启板卡，开机后就自动连接 WiFi 了。 + ![wap_conf_png](./asserts/usage/wap_conf.png) -![wap_conf_gif](./asserts/usage/wap_conf.gif) + 可以看到里面有 `yourWIFIname` 和 `yourWIFIpassword` 两项，将他们更改成你想要连接的无线网络和对应的无线网络密码并保存后，使用电脑系统自带的弹出 U 盘操作方式来移除 U 盘，这样可以避免损坏 U 盘的文件系统。接着在 m2dock 命令行终端执行 `reboot` 命令来重启板卡，开机后就自动连接 WiFi 了。 -### 如何更新 MaixPy3 包 + ![wap_conf_gif](./asserts/usage/wap_conf.gif) -可以手动下载最新的 MaixPy3 [安装包](https://pypi.org/project/maixpy3/#history) -![maixpy3_download](./asserts/usage/maixpy3_download.png) +## Opkg 软件包管理器 -下载带有 cp8 的安装包，cp9 是给别的平台使用的。将这个安装的名字修改成 `maixpy3-9.9.9-cp38-cp38-linux_armv7l.whl`,直接存放到开发板中，重启开发板就会自动更新和安装 MaixPy3。 +在命令行可以通过包管理器命令安装新的软件。 -![maixpy3_install](./asserts/usage/maixpy3_install.png) - -更新前请关闭 IDE 或不接 OTG 口，防止有其他操作影响系统的软件更新，在放入 U 盘后，断电开机会看到如下画面，如果超过 3 分钟画面没有变化，那可能就是失败了，就请重烧系统吧。（2022 年 1 月 14 日至今还没出现过失败样本） - -### 更多连接方式 - -使用 mobaxterm 可以进行串口连接和 ssh 连接，具体教程查看【如何使用 mobaxterm】 - -![mobaxterm_connect](./asserts/usage/mobaxterm_connect.png) - -## 部分常用 Linux 命令 - -
- 点击查看部分常用命令 - 
-ls 查看目录下文件
-cd 打开目录
-pwd 打印当前目录
-mv 移动/重命名 文件/文件夹
-cp 复制 文件/文件夹
-rm 删除
-vi 编辑文件内容 #需要使用特定的adb版本能正常显示内容
-top 查看系统内存
-df 查看磁盘信息
-time 查看时间
-ifconfig 查看网络信息
-free 查看剩余内存
-ps 查看运行的进程
-kill 终止进程
-killall 终止所有进程
-chmod 更改 文件/文件夹 权限
-passwd 设置/更改 用户密码
-cat 查看文件内容
-ping 检测某网址是否连通
-wget 下载某链接文件
-grep 搜索文件内容
-ln 建立文件链接
-
-
- -## Opkg 包管理器 - -Opkg 是一个轻量快速的套件管理系统，目前已成为 Opensource 界嵌入式系统标准。常用于 路由、 交换机等 嵌入式设备中，用来管理软件包的安装升级与下载。 +Opkg 是一个轻量快速的套件管理系统，类似 Ubuntu 下面的 apt 工具， 目前已成为 Opensource 界嵌入式系统标准。常用于 路由、 交换机等 嵌入式设备中，用来管理软件包的安装升级与下载。 ### 相关常用命令 @@ -122,7 +150,7 @@ Opkg 是一个轻量快速的套件管理系统，目前已成为 Opensource 界 - opkg list 获取软件列表 - opkg install 安装指定的软件包 - opkg remove 卸载已经安装的指定的软件包 - + 例如： ```bash @@ -140,23 +168,21 @@ eyesee-mpp-middleware - 1.0-1 eyesee-mpp-system - 1.0-1 ``` -## pip 包管理器 +## Python 包管理器 -[pip](https://pypi.org/project/pip/) 是 Python 包管理工具，该工具提供了对 Python 包的查找、下载、安装、卸载的功能。 - -> 以下讯息由[YanxingLiu](https://github.com/YanxingLiu)提供与测试。 +[pip](https://pypi.org/project/pip/) 是 Python 包管理工具，该工具提供了对 Python 软件包的查找、下载、安装、卸载的功能。 ### pip换源 -在安装系统后可以更换镜像源，加速 pip 安装。 +对于国内可能只接访问 pypi.org 速度比较慢，用国内的镜像源可以加速 pip 安装。 ### 临时使用 ```python -pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package +pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package-name ``` -some-package 请自行更换成你想要安装的包 +package-name 更换成你想要安装的包名 ### 设为默认 @@ -171,95 +197,3 @@ pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pip -U ```python pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple ``` - -## 测试屏幕方法 - -- 请测试前观察系统上电后屏幕是否会闪烁一次；这表示屏幕已经通电、驱动起来，并对其复位（RST）后产生的。 - -在 Linux Shell 运行 `cat /dev/urandom > /dev/fb0` 就会输入随机数据到 fb0 产生雪花屏了，这表示屏幕显示是正常的。 - -
- -
- 帧缓冲相关知识 - 帧缓冲（framebuffer）是 Linux 为显示设备提供的一个接口，把显存抽象后的一种设备。 - 它允许上层应用程序在图形模式下直接对显示缓冲区进行 读写操作。framebuffer 是 LCD 对应的一种 HAL（硬件抽象层），提供抽象的，统一的接口操作，用户不必关心硬件层是怎么实施的。这些都是由 Framebuffer 设备驱动来完成的。帧缓冲设备对应的设备文件为 /dev/fb*，如果系统有多个显示卡，Linux下还可支持多个帧缓冲设备，最多可达 32 个，分别为 /dev/fb0 到 /dev/fb31，而 /dev/fb 则为当前缺省的帧缓冲设备，通常指向 /dev/fb0，在嵌入式系统中支持一个显示设备就够了。帧缓冲设备为标准字 符设备，主设备号为 29 ，次设备号则从 0 到 31 。分别对应 /dev/fb0-/dev/fb31 。 -
- -## 运行 Python3 解释器 - -在 Linux 上使用 Python 编程只需要在 adb shell 命令行交互的接口输入 python3 即可启动，可直接复制代码粘贴后按回车键运行。 - -```python -import platform -print(platform.uname()) -``` - -2022年7月6日 实际操作结果： - -```bash - __ _ - / / (_)__ __ ____ __ ------------------------ - / /__/ / _ \/ // /\ \ / sipeed.com (Neptune) -/____/_/_//_/\_,_//_\_\ ------------------------ - -root@sipeed:/# python3 -Python 3.8.5 (default, Jun 14 2022, 09:51:56) -[GCC 6.4.1] on linux -Type "help", "copyright", "credits" or "license" for more information. ->>> import platform ->>> print(platform.uname()) -uname_result(system='Linux', node='sipeed', release='4.9.118', version='#3242 PREEMPT Tue Jun 28 04:03:38 UTC 2022', -machine='armv7l', processor='') -``` - -## 测试拍照功能 - -这里我们使用 [MaixPy3](/maixpy3) 来测试一下摄像头，先以交互模式启动一下 Python, - -```python -from maix import camera, display, image -display.show(camera.capture()) -``` - -
- -> 如果屏幕没有显示内容。那么首先确认一下镜像镜像版本，并且确认一下外设和驱动对的上 - -## 怎么样使用 USB 摄像头 - -M2Dock 有两个 TypeC 接口。其中一个标识有 UART，作为板子与电脑进行串口通信的接口。另一个口有 OTG 标识，默认是作为 USB 从机来使用的，比如我们能够在电脑上使用 `adb` 来操作 M2Dock 就是因为这个接口默认是从机模式。 - -需要注意的是 M2Dock 系统默认将 OTG 标识设置为 adb 设备，可以在 PC 端通过 `adb` 命令来操作板子，也可以通过使得电脑上的 jypyter 通过 `adb forward` 功能在板子上运行 python 代码。 - -想要连接摄像头，需要手动更改这个端口为主机模式。从板子上的 USB UART 来操作板子，并执行下面的命令就可以将 OTG 口作为主机模式使用。 - -要注意的是之子那个下面的命令后，板子上将与电脑通过 USB OTG 口进行通信。 - -```bash -echo "usb_host" > /sys/devices/platform/soc/usbc0/otg_role -``` - -接着就能向通常的 linux 系统一样操作 /dev 目录下的摄像头了。 - -## 如何将 USB OTG 口作为从机 - -M2Dock 默认的 OTG 口就是 USB 从机设备了，要是有因为其他原因需要重新设置成从机设备的话，在 M2Dock 上执行下面的命令就可以了。 - -```bash -echo "usb_device" > /sys/devices/platform/soc/usbc0/otg_role -``` - -## 工具链 - -[这里](https://dl.sipeed.com/shareURL/MaixII/MaixII-Dock/SDK/Toolchain)提供了在 linux 系统下的编译工具链，有能力的可以自己试一下。无相关支持 - -建议使用 [MaixPy3](/soft/maixpy3/zh/index.html) 来操作设备 - -## MaixPy3 - -本设备建议使用 [MaixPy3](/soft/maixpy3/zh/index.html) 来进行相应的快速开发，相关文档请仔细阅读 - -## 源码 - -V831 的源码已经放在 https://github.com/Tina-Linux/tina-V83x ，有需要的可以自行尝试一下 diff --git a/docs/hardware/zh/maixIII/ax-pi/axpi.md b/docs/hardware/zh/maixIII/ax-pi/axpi.md index 89d9fe4b..acb91679 100644 --- a/docs/hardware/zh/maixIII/ax-pi/axpi.md +++ b/docs/hardware/zh/maixIII/ax-pi/axpi.md @@ -107,88 +107,33 @@ keywords: MAIX-III, AXera-Pi, Maix3, Sipeed, ax620a, axera, sipeed, AI, model, m ![models](./../assets/models.jpg) -还可以在 [AXERA-TECH/ax-samples](https://github.com/AXERA-TECH/ax-samples) 仓库也可以找到模型，板子系统里也预置了模型资源，后续模型更新会在这里[「ax-models」](https://github.com/AXERA-TECH/ax-models)，而 [ AX-Samples 将不断更新最流行的、实用的、有趣的示例代码](https://github.com/AXERA-TECH/ax-samples/tree/main/examples#examples)，目前有如下模型支持列表： +还可以在 [AXERA-TECH/ax-samples](https://github.com/AXERA-TECH/ax-samples) 仓库也可以找到模型，板子系统里也预置了模型资源，后续模型更新会在这里[「ax-models」](https://github.com/AXERA-TECH/ax-models)，而 [ AX-Samples 将不断更新最流行的、实用的、有趣的示例代码](https://github.com/AXERA-TECH/ax-samples/tree/main/examples#examples)，目前比较典型的模型支持： -- 物体分类 - - MobileNetv1 - - [MobileNetv2](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#MobileNetv2) - - MobileOne-s0 - - ResNet18 - - ResNet50 - - Others...... -- 物体检测 - - [PP-YOLOv3](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#yolov3paddle) - - YOLOv3 - - YOLOv3-Tiny - - YOLOv4 - - YOLOv4-Tiny - - YOLOv4-Tiny-3l - - [YOLOv5s](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOv5s) - - [YOLOv5-Lite](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOv5-Lite)([original model](https://github.com/ppogg/YOLOv5-Lite)) - - [YOLOv7-Tiny](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOv7-Tiny) - - [YOLOv8s](https://github.com/AXERA-TECH/ax-samples/tree/main/examples#YOLOv8s) - - [YOLOX-S](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOX-S) - - YOLO-Fastest-XL - - NanoDet -- 人型检测 - - YOLO-Fastest-Body -- 人脸检测 - - [scrfd](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#Scrfd) - - [YOLOv5-Face](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOv5-Face)([original model](https://github.com/deepcam-cn/yolov5-face)) -- 人脸分割 - - Face_Parsing -- 障碍物检测 (扫地机场景) - - Robot-Obstacle-Detect -- 无人机视角物体检测 - - [YOLOv5s_visdrone](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#YOLOv5s_visdrone) -- 3D单目车辆检测 - - [Monodlex](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#Monodlex) -- 人体关键点 - - [HRNet](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#HRNet) - - [AX-POSE-PPL](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#AX-POSE-PPL) - - [HandPose](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#HandPose) -- 人体分割 - - [PP-HumanSeg](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#PP-HumanSeg) -- 语义分割 - - [PP-Seg](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#MobileSeg) -- 传统 CV 操作 - - CropResize -- Pipeline 示例 - - NV12 -> CropResize -> NN(Classification) +- 物体分类: MobileNet, Resnet +- 物体检测: YOLO v3~v8 +- 分割: Face_Parsing, [PP-HumanSeg](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#PP-HumanSeg) +- 3D单目车辆检测： [Monodlex](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#Monodlex) +- 人体关键点：[HRNet](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#HRNet)，[AX-POSE-PPL](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#AX-POSE-PPL)， [HandPose](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#HandPose) +- 语义分割: [PP-Seg](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/ax620/README.md#MobileSeg) +- 传统 CV 操作: CropResize 加速 -想要在板子上运行模型请看[「部署模型到 Maix-III AXera-Pi 开发板」](/ai/zh/deploy/ax-pi.html) - -

- -

### 在线训练模型吧！ -如今 [新版 MaixHub 正式上线啦！](https://wiki.sipeed.com/news/maixhub/new_maixhub.html)下为 maixhub 在线训练模型流程示意。 +支持 零代码，免费云端服务器的 [MaixHub](https://wiki.sipeed.com/news/maixhub/new_maixhub.html)在线训练，小白也能定制自己的 AI 模型！ -

- -

+### 移植自己的模型 -> m3axpi 不支持上一代 m2dock 的扫码部署，只能选择本地上传文件部署。 +想要在板子上移植你的模型请看[「部署模型到 Maix-III AXera-Pi 开发板」](/ai/zh/deploy/ax-pi.html) -

- -

### 分享有趣的模型！ -在你部署成功后会有一份模型文件，以及能运行模型的代码或程序，你可以将这些文件分享到 [MaixHub 模型库](https://maixhub.com/model/zoo) ，大家一起交流学习成长！（请开始你的表演吧） +* 社区可以找到大家分享的模型，方便快速验证想法。 +* 在线训练的模型，或者移植的自己的模型，均可以分享到 [MaixHub 模型库](https://maixhub.com/model/zoo) ，大家一起交流学习成长！（请开始你的表演吧） -

- -

-

- -

- -## 活跃 の 社区资源 +## 活跃的社区资源 产品相关的专栏内容有（官方维护）： @@ -243,7 +188,80 @@ keywords: MAIX-III, AXera-Pi, Maix3, Sipeed, ax620a, axera, sipeed, AI, model, m

-## 丰富 の Linux 内容 +## 硬件参数 + +

+ + + +

+ +### 硬件标注图 + +

+ layout_axpi_2 + layout_axpi_1 +

+ +### 核心板参数 + +| 项目 | 参数 | +| ---------- | ------------------------------------- | +| CPU | 四核 Cortex-A7, 支持 NEON 和 FPU | +| NPU | 14.4Tops@int4，3.6Tops@int8 | +| ISP | 4K@30fps | +| 编解码格式 | H.264, H.265 | +| 视频编码 | 4K@30fps | +| 视频解码 | 1080P@60fps | +| Ethernet | 支持双路RGMII / RMII 接口模式的以太网 | +| 显示输出 | MIPI DSI 4 Lane，最高支持4K@30FPS | +| DRAM | 2GB LPDDR4X 3733Mhz | +| 存储 | 可选16GB EMMC（默认是 TF 卡启动） | +| IO 引出 | DDR4 SODIMM 260P 金手指全 IO 引出 | + +### 底板参数 + +| 项目 | 参数 | +| ---------- | ------------------------------------- | +| 摄像头输入 | （默认单摄）最高支持 3 摄:1个MIPI4-LANE+2个MIPI2-LANE | +| 屏幕输出 | 支持最高 4-LANE MIPI DSI 屏幕 | +| SD 插槽 | 默认从 SD 卡启动 | +| 录音输入 | 板载两个 MEMS MIC 支持双麦降噪 | +| 音频输出 | 3.5MM耳机接口 支持立体声输入和 MIC 输入 | +| 网络接口 | 支持 千兆以太网（ETH） 和 2.4GHZ WI-FI 板载天线 | +| USB 接口 | 1xUSB2.0HS 支持 OTG 或 HOST 功能，1xUSB-UART 系统串口 | +| 其他资源 | 1x用户按键，3x系统按键，1xRTC时钟，2xLED | +| 对外接口 | 引出CJTAG，可自行连接相应调试器，引出2x12排针，4个M2.5螺丝定位孔 | + +### 摄像头一览 + +- 低配 gc4653 400w 基础体验版本。 + +

+ +

+ +- 高配 os04a10 400w 夜景增强版本。 + +

+ +

+ +> [更换摄像头常见问题](https://wiki.sipeed.com/hardware/zh/maixIII/ax-pi/faq_axpi.html) + +## 硬件资源 + +[硬件资源汇总链接](https://dl.sipeed.com/shareURL/MaixIII/AXera) + +- [产品规格书](https://dl.sipeed.com/shareURL/MaixIII/AXera/01_Specification) +- [原理图](https://dl.sipeed.com/shareURL/MaixIII/AXera/02_Schematic) +- [点位图](https://dl.sipeed.com/shareURL/MaixIII/AXera/03_Bit_number_map) +- [模型文件](https://dl.sipeed.com/shareURL/MaixIII/AXera/05_3D_file) +- [尺寸图](https://dl.sipeed.com/shareURL/MaixIII/AXera/04_Dimensional_drawing) +- [GC4653 摄像头参考使用手册](https://dl.sipeed.com/shareURL/MaixIII/AXera/07_Chip_manual) + + +## 软件开发 ### 超高性价比与能效比 @@ -330,83 +348,6 @@ AX-Pipeline 由爱芯主导开发。该项目基于 AXera-Pi 展示 ISP、图像 4. [如何调整图像方向](https://github.com/AXERA-TECH/ax-pipeline/blob/main/docs/how_to_adjust_image_orientation.md) 5. [ModelZoo](https://github.com/AXERA-TECH/ax-pipeline/blob/main/docs/modelzoo.md) 一些支持或将支持的模型和一些模型的说明。 -## 选择 M3AXPI 的理由 - ->为什么要选择 M3AXPI 呢？由这个视频来回答你的所有疑问吧！ - -视频简述了 M3AXPI 比起 M2DOCK 的优势，还有超多实际使用效果案例以及彩蛋！ - - - -## 相关硬件参数 - -

- - - -

- -### 硬件标注图 - -

- layout_axpi_2 - layout_axpi_1 -

- -### 核心板参数 - -| 项目 | 参数 | -| ---------- | ------------------------------------- | -| CPU | 四核 Cortex-A7, 支持 NEON 和 FPU | -| NPU | 14.4Tops@int4，3.6Tops@int8 | -| ISP | 4K@30fps | -| 编解码格式 | H.264, H.265 | -| 视频编码 | 4K@30fps | -| 视频解码 | 1080P@60fps | -| Ethernet | 支持双路RGMII / RMII 接口模式的以太网 | -| 显示输出 | MIPI DSI 4 Lane，最高支持4K@30FPS | -| DRAM | 2GB LPDDR4X 3733Mhz | -| 存储 | 可选16GB EMMC（默认是 TF 卡启动） | -| IO 引出 | DDR4 SODIMM 260P 金手指全 IO 引出 | - -### 底板参数 - -| 项目 | 参数 | -| ---------- | ------------------------------------- | -| 摄像头输入 | （默认单摄）最高支持 3 摄:1个MIPI4-LANE+2个MIPI2-LANE | -| 屏幕输出 | 支持最高 4-LANE MIPI DSI 屏幕 | -| SD 插槽 | 默认从 SD 卡启动 | -| 录音输入 | 板载两个 MEMS MIC 支持双麦降噪 | -| 音频输出 | 3.5MM耳机接口 支持立体声输入和 MIC 输入 | -| 网络接口 | 支持 千兆以太网（ETH） 和 2.4GHZ WI-FI 板载天线 | -| USB 接口 | 1xUSB2.0HS 支持 OTG 或 HOST 功能，1xUSB-UART 系统串口 | -| 其他资源 | 1x用户按键，3x系统按键，1xRTC时钟，2xLED | -| 对外接口 | 引出CJTAG，可自行连接相应调试器，引出2x12排针，4个M2.5螺丝定位孔 | - -[硬件资源汇总链接](https://dl.sipeed.com/shareURL/MaixIII/AXera) - -- [产品规格书](https://dl.sipeed.com/shareURL/MaixIII/AXera/01_Specification) -- [原理图](https://dl.sipeed.com/shareURL/MaixIII/AXera/02_Schematic) -- [点位图](https://dl.sipeed.com/shareURL/MaixIII/AXera/03_Bit_number_map) -- [模型文件](https://dl.sipeed.com/shareURL/MaixIII/AXera/05_3D_file) -- [尺寸图](https://dl.sipeed.com/shareURL/MaixIII/AXera/04_Dimensional_drawing) -- [GC4653 摄像头参考使用手册](https://dl.sipeed.com/shareURL/MaixIII/AXera/07_Chip_manual) - -### 摄像头一览 - -- 低配 gc4653 400w 基础体验版本。 - -

- -

- -- 高配 os04a10 400w 夜景增强版本。 - -

- -

- -> [更换摄像头常见问题](https://wiki.sipeed.com/hardware/zh/maixIII/ax-pi/faq_axpi.html) ## 常见问题（FAQ） diff --git a/docs/hardware/zh/sidebar.yaml b/docs/hardware/zh/sidebar.yaml index dff810df..45524e98 100644 --- a/docs/hardware/zh/sidebar.yaml +++ b/docs/hardware/zh/sidebar.yaml @@ -57,8 +57,6 @@ items: file: maix/m1s/other/start.md - label: 其他事项（摄像头和外壳） file: maix/m1s/other/others.md - - label: Maix M1a - # items: [] - label: Maix-II items: - label: MaixII-Dock @@ -66,11 +64,13 @@ items: items: - label: 烧录系统 file: maixII/M2/flash.md + - label: 训练自己的 AI 模型 + file: maixII/M2/maixhub_train.md - label: 基础使用 file: maixII/M2/usage.md - label: 其他事项 file: maixII/M2/other.md - - label: 连接MaixPy3 + - label: 使用 MaixPy3 开发 file: ../../soft/maixpy3/zh/tools/0.MaixII-Dock.ipynb target: _blank - label: FAQ diff --git a/docs/soft/maixpy3/zh/api/maix/nn.md b/docs/soft/maixpy3/zh/api/maix/nn.md index 472e7394..ef2227da 100644 --- a/docs/soft/maixpy3/zh/api/maix/nn.md +++ b/docs/soft/maixpy3/zh/api/maix/nn.md @@ -10,7 +10,7 @@ desc: MaixPy3 nn模块 API文档, 以及使用说明 * 准备模型 -比如从 MaixHub 下载, 这里以边缘检测模型为例, 先[下载模型](https://maixhub.com/modelInfo?modelId=24)(需要先注册登录) +比如从 MaixHub 下载, 这里以边缘检测模型为例, 先[下载模型](https://maixhub.com/model/zoo/67)(需要先注册登录) * 准备一张 `224 x 224` 分辨率的图像, 比如这里放到了开发板文件系统的`/root/test.png`位置 @@ -370,7 +370,7 @@ class FaceRecognize: [这里](https://github.com/sipeed/MaixPy3/blob/main/ext_modules/_maix_nn/example/face_recognize.py)有一个`Face_Recognizer`类提供了人脸识别的简单封装， 推荐使用 -使用的模型可以到[这里下载](https://maixhub.com/modelInfo?modelId=29) +使用的模型可以到[这里下载](https://maixhub.com/model/zoo/59) ##### 构造方法: __init__(self, model_detect, model_fea, fea_len, input_shape, threshold, nms, max_face_num) diff --git a/docs/soft/maixpy3/zh/install/install.md b/docs/soft/maixpy3/zh/install/install.md index e09b5026..93061f9b 100644 --- a/docs/soft/maixpy3/zh/install/install.md +++ b/docs/soft/maixpy3/zh/install/install.md @@ -62,10 +62,22 @@ display.show(camera.capture().draw_string(0, 0, "hello world!")) ## MaixII-Dock (m2dock) 安装与更新 MaixPy3 -MaixII-Dock 需要[烧录官方提供预置 MaixPy3 的 Openwrt 镜像](https://wiki.sipeed.com/hardware/zh/maixII/M2/flash.html)，你也可以手动 pip 安装更新 whl 软件包。 +MaixII-Dock 需要[烧录官方已预置 MaixPy3 的镜像](https://wiki.sipeed.com/hardware/zh/maixII/M2/flash.html)，你也可以手动 pip 安装更新 whl 软件包。 ![](./asserts/V831.jpg) +**如何更新 MaixPy3 包**： + +可以手动下载最新的 MaixPy3 [安装包](https://pypi.org/project/maixpy3/#history) + +![maixpy3_download](/hardware/zh/maixII/M2/asserts/usage/maixpy3_download.png) + +下载带有 cp8 的安装包，cp9 是给别的平台使用的。将这个安装的名字修改成 `maixpy3-9.9.9-cp38-cp38-linux_armv7l.whl`,直接存放到开发板中，重启开发板就会自动更新和安装 MaixPy3。 + +![maixpy3_install](/hardware/zh/maixII/M2/asserts/usage/maixpy3_install.png) + +更新前请关闭 IDE 或不接 OTG 口，防止有其他操作影响系统的软件更新，在放入 U 盘后，断电开机会看到如下画面，如果超过 3 分钟画面没有变化，那可能就是失败了，就请重烧系统吧。（2022 年 1 月 14 日至今还没出现过失败样本） + ## MaixSense 安装 MaixPy3 MaixSense 需要[烧录官方提供预置 MaixPy3 的 Armbian 镜像](https://wiki.sipeed.com/hardware/zh/maixII/M2A/flash_system.html)，你也可以手动 pip 安装更新 whl 软件包。 diff --git a/docs/soft/maixpy3/zh/readme.md b/docs/soft/maixpy3/zh/readme.md index 2c394816..775be3a8 100644 --- a/docs/soft/maixpy3/zh/readme.md +++ b/docs/soft/maixpy3/zh/readme.md @@ -4,23 +4,12 @@ keywords: Maixpy3 官方文档 desc: maixpy MaixPy3 是什么？能做什么？ --- -中国的 [Sipeed 开源组织](https://github.com/sipeed) 在 2020 年底推出了 [MaixPy3](https://github.com/sipeed/MaixPy3) 开源软件，这是一款基于 [linux cpython](https://github.com/python/cpython) 的 Python3 软件开发工具包（SDK），借助开源 Python 编程语言实现跨平台统一和简化 Linux 嵌入式设备上开发 AIoT （人工智能物联网） = AI（人工智能） + IoT（物联网）应用，意在打造可落地的视觉 AI 应用生态，帮助更多人了解、使用 AI 技术来解决实际问题，推进全球边缘 AI 的落地化进程。 +中国的 [Sipeed 开源组织](https://github.com/sipeed) 在 2020 年底推出了 [MaixPy3](https://github.com/sipeed/MaixPy3) 开源软件，这是一款基于 Python3 语言的软件开发工具包（SDK），借助开源 Python 编程语言实现跨平台统一和简化 Linux 嵌入式设备上开发 AIoT （人工智能物联网） = AI（人工智能） + IoT（物联网）应用，意在打造可落地的视觉 AI 应用生态，帮助更多人了解、使用 AI 技术来解决实际问题，推进全球边缘 AI 的落地化进程。 ## MaixPy3 能做什么？ > 以下内容均是社区用户基于 MaixPy3 开发的成果分享，本文档不提供他人的二次开发成果。 -### MaixPy3 开源项目自述 - -- 大佬鼠自述：MaixPy3项目开发的心路历程 - -

- -

- -> 在 2022年01月21日 该视频只说了为什么要做这款开源产品系列，此时还没有做【在线 AI 训练】和【突出产品亮点】，最终是**想要让初学者【学会视觉 AI 应用】和【开发出可落地的产品】** -> 在 2022年06月01日 儿童节的时候【在线 AI 训练】已公开集标注训练部署一体的服务。 - ### M2DOCK 产品功能速览 - M2DOCK：国产全志 V831 开源 人工智能 神经网络 视觉 AI Python开发板 diff --git a/docs/soft/maixpy3/zh/sidebar.json b/docs/soft/maixpy3/zh/sidebar.json index 2fb0fe2f..aa8fbb3a 100644 --- a/docs/soft/maixpy3/zh/sidebar.json +++ b/docs/soft/maixpy3/zh/sidebar.json @@ -73,7 +73,7 @@ ] }, { - "label":"开发者更新速览", + "label":"开发者更新日志", "file": "develop/readme.md", "items": [ { diff --git a/docs/soft/maixpy3/zh/tools/0.MaixII-Dock.ipynb b/docs/soft/maixpy3/zh/tools/0.MaixII-Dock.ipynb index a720a536..408f4b4a 100644 --- a/docs/soft/maixpy3/zh/tools/0.MaixII-Dock.ipynb +++ b/docs/soft/maixpy3/zh/tools/0.MaixII-Dock.ipynb @@ -1,6 +1,7 @@ { "cells": [ { + "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ @@ -41,17 +42,17 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "| 时间 | 负责人 | 更新内容 |\n", + "| 时间 | 负责人 | 更新内容 |\n", "| ---------- | ------------ | :------------------------------------------------: |\n", "| 2021-12-3 | Rui | 制定文档初稿 |\n", - "| 2021-12-7 | 大老鼠 & Ray | 微调排版及审核 |\n", + "| 2021-12-7 | dls & Ray | 微调排版及审核 |\n", "| 2021-12-8 | Rui | 添加 IDE 基本的使用介绍,MaixPy3 入门目录 |\n", - "| 2022-01-14 | dalaoshu | 配合 IDE 更新优化了用户使用体验 |\n", - "| 2022-01-17 | dalaoshu | 根据小徐同学的视频反馈，修订了用词和补充 SD 卡说明 |\n", + "| 2022-01-14 | dls | 配合 IDE 更新优化了用户使用体验 |\n", + "| 2022-01-17 | dls | 根据小徐同学的视频反馈，修订了用词和补充 SD 卡说明 |\n", "| 2022-03-02 | Rui | 添加 MaixII-Dock 开箱视频，修改部分表述错误 |\n", "| 2022-04-14 | Coty | 添加 main.py 会被 kill 掉的解决方法 |\n", - "| 2022-06-09 | dalaoshu | 重新强调了 m2dock 必须有 U 盘出现才能使用 |\n", - "| 2022-07-13 | dalaoshu | 更新到最新的 0.5.1 了 |\n", + "| 2022-06-09 | dls | 重新强调了 m2dock 必须有 U 盘出现才能使用 |\n", + "| 2022-07-13 | dls | 更新到最新的 0.5.1 了 |\n", "| 2023-02-07 | wonder | 添加版本 0.5.4 之后的镜像联网方法 |\n", "\n", "# 使用 MaixPy3 IDE 连接 MaixII-Dock\n", diff --git a/docs/soft/maixpy3/zh/tools/MaixPy3_IDE.md b/docs/soft/maixpy3/zh/tools/MaixPy3_IDE.md index 8613468d..1341ef6c 100644 --- a/docs/soft/maixpy3/zh/tools/MaixPy3_IDE.md +++ b/docs/soft/maixpy3/zh/tools/MaixPy3_IDE.md @@ -37,7 +37,7 @@ desc: maixpy 如何连接并使用 MaixPy3 的 IDE ## 如何安装 MaixPy3 IDE ？ -> **软件安装方法和注意事项要严格看本文说明（大佬鼠宣）** +> **软件安装方法和注意事项要严格看本文说明** MaixPy3 IDE 的构成主要如下： diff --git a/layout/home.html b/layout/home.html index 3a3dbcdd..08ba6aa0 100644 --- a/layout/home.html +++ b/layout/home.html @@ -1,7 +1,5 @@ {% extends "page_base.html" %} @@ -11,1076 +9,314 @@ -
- - - - - - + + - - - - - - - - - - - + + + {[ $t(product.rbtn_text) ]} + + + + + + + + + + diff --git a/pages/index/zh/community.md b/pages/index/zh/community.md index 8fe1cc7a..df85b8f8 100644 --- a/pages/index/zh/community.md +++ b/pages/index/zh/community.md @@ -2,10 +2,10 @@ sipeed_logo
-- 建议到 [Sipeed 社区(bbs)](https://bbs.sipeed.com) 交流和提问, 提问时请使用图文完整阐述问题和复现问题的详细过程； 在群里提问时最好发提问贴的链接, -方便大家快速了解到你的问题,提高问题被快速解决的可能性~ +>! 社区尽量用来分享你的经验和作品。 +> 有问题请先在 [FAQ](/faq.html) 里面寻找答案，如果在社区提问，想要你的问题有人解答，请先阅读 **[如何有雅提问](./how_to_ask.md)**。 -- QQ群数量有限, 加的伙伴比较多, 群满之后会清理长期未发言的账户, 如果不小心被移除了可以再次加回来, 理解万岁!! +> QQ群数量有限, 加的伙伴比较多, 群满之后会清理长期未发言的账户, 如果不小心被移除了可以再次加回来, 理解万岁!! diff --git a/pages/index/zh/how_to_ask.md b/pages/index/zh/how_to_ask.md new file mode 100644 index 00000000..c50e1a14 --- /dev/null +++ b/pages/index/zh/how_to_ask.md @@ -0,0 +1,111 @@ +--- +title: 如何优雅提问 +--- + + +## 在各个地方提问时， 大家会发现有几个现象： + +* 提问题后没人回答，甚至没人理睬 +* 提的问题过了很久才有人回答 +* 对方老是嫌弃自己太菜 + + +## 问问题前，确认自己已经学习了基础知识，并且搜索了文档和社区， 仍然无法解决问题，才需要提问 + + +很多问题会在这个过程中解决， 切忌一开始就到 QQ群、论坛 、issue， 或者邮件随便提问。 +这些问题一般不会得到回答和响应（因为大家每天都在看到问重复的已经解答过的问题）： +* 在文档中一开始就说明了的简单问题，大家一看你就没好好读文档，当然懒得理你。 +* 在 [FAQ](./faq.md) 已经整理过的问题。 +* 提问语句不通顺，一个句子连基础的 主谓宾 都没有，谁也不想和难沟通的人说话。 +* 没有前因后果，没有你想要什么目标，你做了什么，现象是什么，要理解大家时间都有限，没人想一点一点来问你想要做什么，做了什么，问题是什么。 +* 日志截图不全，总是截了一小块，大家也看不到关键信息，尽量截图大一点，信息全面一点。 +* 态度趾高气昂，比如在店里买了开发板，到社区来叫嚣需要技术支持服务，不好好提问，大家肯定懒得理你。 +* 不好好看代码，连代码都没有阅读过一遍，就到处问，大家一看就知道你没看代码，懒得理你。 +* 不好好看日志或者日志不往上翻阅，明明日志上写了错误原因甚至解决方法，大家只会觉得你太懒了，交流起来一定很吃力，懒得理你。 +* 。。。可能还有其它明显的问题，希望自己提问前想想，你作为回答者，你会愿意回答这样的问题吗？ + + +## 提问时，尽量做到以下几点，会大大提高问题被快速解决的几率： + +### 时刻站在回答者的角度思考问题 + +每次提问，都要站在解答者的角度思考： +* 假设解答者都是大佬，他们时间宝贵。 +* 如何让大家在一瞥之间就能看懂我的提问，最好是不要让回答者来追问我做了什么，目的是什么等基础问题。 +* 如果让大家愿意回答我的问题，比如是有技术讨论深度，还是说能让回答者感受到至高无上的被崇敬的感觉，还是说我能直接打钱。 +* 不要让回答者觉得我懒，没有看文档，没有看代码，没有看日志，没有搜索过，没有思考过，没有尝试过，没有做过任何努力，就直接来问问题。 + + +### 缕清问题， 弄清楚到底发生了什么，以及我做了什么，包括： + +* 我想实现什么效果，什么功能？ + +* 为了实现这个效果，我是怎么做的， 详细的过程是什么？ + +* 实施的过程中， 什么错误发生了， 现象是什么（比如报错了， 报了什么错，**完整**的错误内容是什么？切忌只看最后几行，尽量往前多看看日志） + +* 我是否认真看了报错的信息， 报错信息中是否有提示了错误的原因和解决的方法？ + +* 根据这些报错信息， 仔细思考， 是否能解决问题？ + +* 搜索 文档、 FAQ， issue， 以及用搜索引擎能不能搜索到问题的解决方法 + +### 如果问题自己实在不能解决， 需要请教于人， 需要考虑： + +* 请教谁，在哪里请教， 谁会更有几率回答我的问题？以及实时性如何？ + +* 我应该给他提供什么数据和现象他才能愿意快速帮我解决问题？ + * 提供我的目的 （方便让回答者知道你在做什么事情） + * 提供完整的实施过程， 以及过程中出现的现象 （方便回答者跟着你的流程去做一遍， 即问题复现） + * 给出错误的地方， 指明哪里出现的现象或结果和自己预期的不一样！ （让回答者知道，哪里没达到预期） + * 提供出现的错误信息， 需要完整， 尽可能更多地截图， 更多的日志，千万别小气地截一张小图，或者之给出日志的一部分（ 因为回答者可能很久没做这件事情了，忘记了一些细节，需要靠截图和完整日志来快速回忆起来; 而且根据详细的日志可以快速定位到问题处在哪里） + +* 怎么提问态度显得比较诚恳，就算我再小白，大家也愿意回答 + + + +### 提问模板 + + +提问尽量做到提问优雅，不需要添加多余的语气词，抱怨的词汇，斟酌每一个词和标点符号，站在回答人的角度思考问题，如何让回答的人快速帮助自己解决问题， 字数太少描述不清楚， 字数太多则让人没有耐心 + +#### 标题 + +无论在哪里提问（包括`QQ群`）， 给自己的问题拟定一个`30`个字左右标题， 阐明问题的中心思想，包括： +* 问题类别， 是问题请教，还是 BUG提交，还是经验分享等等。让大家在满是文字的屏幕上可以立马定位到你想做什么 +* 一句话阐明问题的中心你思想，比如遇到 `运行摄像头示例程序，报错 reset fail， 可能是硬件问题吗` + +所以综合后标题可以是这样： +* `【MaixPy 提问】 运行摄像头示例程序，报错 reset fail， 可能是硬件问题吗` + +这样的标题一定**不能**出现: +* `啊啊啊啊啊为什么我的板子又不行了` +* `为什么我的代码不能运行了` +* `为什么我的屏幕黑屏了` +* `reset fail 是什么错啊` +* `【MaixPy 提问】 收到了开发板，开发板屏幕是红的，一行小字，为什么呢？` +* `我运行xxx程序，出了问题` + +可以这样问： +* `【MaixPy 提问】我的板子在我接反电源后，现在板子无法启动，怎么判断板子哪里烧毁了，如果可以，怎么救活呢` +* `【MaixPy BUG】image.pix_to_ai 没有对最后一个像素进行转换` + +#### 内容 + +首先站在回答者的角度， 如果被问问题: +* 首先要知道对方要做什么，实现什么目标 +* 为了实现这个目标，他是参考了哪里的步骤做的 +* 实际上采用了哪些具体的步骤，然后在那一步出现了问题， 方便我照着他的步骤去尝试复现一下现象。如果这个问题看起来不好解决，又没有复现的步骤，那可能要花很多时间去复现，先放一放先解决其它问题吧 +* 具体出现的问题是什么，如果他只说出了问题，我怎么知道他出了什么问题，也许是身体不适？所以这很重要，需要让他说明出问题时的现象，并指明与预期有什么不同，不然我还得去猜去对比和预期有什么不同，解决问题的时长又增加了 +* 出问题了，我可能需要他的日志文件，方便我根据日志去看源码等进行分析，不然可能会很难解决问题，那这个问题可以放到后面慢慢看吧 + +综上， 可以这么提问： + +* 详细阐明自己的目标，想做什么事情， 现象应该是什么样的 +* 我有没有参考哪里的文档、代码或者教学 +* 如何复现错误：具体怎么做的， 每一个步骤写详细，直到问题出现 +* 详细阐述错误出现时的现象，以及和期望的相比哪里不一样，需要证明问题确实出现了 +* 附带日志文件，以及截图，甚至是视频，日志和截图一定要完整，不要只截取一小部分，回答者可能会从你的完整日志和截图中发现一些你没注意到的问题，这很重要！ +* 另外，粘贴代码注意格式，别粘贴后显示很乱，无法入目，尽量能复制后 直接能运行 +* 最后，对解答问题的社区朋友们表达感谢，或者是在提问时就表达感觉（无论是口头还是实际的金钱感谢都可） diff --git a/site_config.json b/site_config.json index c65bcd68..cb0fca46 100755 --- a/site_config.json +++ b/site_config.json @@ -168,7 +168,7 @@ "config": { "type": "hint", "label": "☆", - "content": "新版 MaixHub 已上线，在线标注、一键部署，更稳定的网络和流畅的体验，支持Maix-I, Maix-II, 手机, web，快来体验吧！
最新开源项目TinyMaix，运行在任意单片机上的模型推理库，甚至能在低至2KiB内存Arduino上跑", + "content": "无需本地 GPU 环境，云端免费一键 AI 模型训练、部署，快来MaixHub 体验！
和大家分享你的项目和开发经验吧！新分享广场上线，管理员真金白银打赏中，在线等！", "show_after_s": 432000, "date": "2022-06-01 14:00" }