Skip to content

Commit

Permalink
update faq
Browse files Browse the repository at this point in the history
  • Loading branch information
Neutree committed Jul 8, 2024
1 parent 2c67d1e commit 40271bb
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 0 deletions.
5 changes: 5 additions & 0 deletions docs/doc/en/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ However, if you are an expert, we welcome you to submit a pull request!
## Model running error: cvimodel built for xxxcv181x CANNOT run on platform cv181x.

Failure to parse the model file is generally caused by file corruption. Ensure that your model file is not damaged. For example:
* Editing a binary file with an editor caused the file to become corrupted. For example, opening a `cvimodel` file with MaixVision can corrupt the binary file due to MaixVision's auto-save feature. Therefore, do not open and save binary files with text editors like MaixVision (this issue will be fixed in a future update of MaixVision by removing the auto-save feature).
* If it was downloaded from the internet, make sure the download was not corrupted. Typically, files on the internet provide sha256sum/md5 checksums. After downloading, you can compare these values; for specific methods, please search online or ask ChatGPT.
* If it comes from a compressed archive, ensure that the decompression process was error-free. You can decompress the archive again to make sure there were no errors in the process.
* Ensure that the file was not damaged during the transfer to the device. You can compare the sha256sum values of the file on the device and on your computer; for specific methods, please search online or ask ChatGPT.
Expand Down Expand Up @@ -91,3 +92,7 @@ labels = person, bicycle, car, motorcycle, airplane, bus, train, truck, boat, tr
```
Here, the `model` is specified as the `yolov5s_224_int8.cvimodel` file relative to the directory of this `.mud` file. If you have changed `yolov5s_224_int8.cvimodel` to another name, you need to update it here as well.


## MaixVision Shows Red Wavy Line on `import maix`

This error occurs because MaixVision's code hinting feature cannot find the `maix` module. It's important to understand that MaixVision's code hinting relies on the local Python packages on your computer, while the code execution depends on the Python packages on the device. To enable MaixVision's code hinting, you need to install Python and the `MaixPy` package on your computer. For more details, refer to the [MaixVision User Documentation](./basic/maixvision.md).
5 changes: 5 additions & 0 deletions docs/doc/zh/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ MaixPy 目前仅支持 MaixCAM 系列板子,其它同款芯片的板子也不

解析模型文件失败了,一般情况是模型文件损坏造成的,确保你的模型文件是没有损坏的。
比如:
* 用编辑器编辑了二进制文件导致文件损坏。比如用 maixvision 打开了 cvimodel 文件,由于 maixvision 的自动保存功能会破坏二进制文件,所以不要用 maixvision 等文本编辑器打开二进制文件并保存(后面 MaixVision 会修复这个问题,即去掉 maixvision 的自动保存功能)。
* 如果是从网上下载的,保证下载没有出问题,一般网上的文件提供 sha256sum/md5 校验值,下载下来后可以对比一下,具体方法请自行搜索或者问 ChatGPT。
* 如果是来自压缩包,请确认解压过程没有出错,可以从压缩包重新解压一遍保证中间没有出错。
* 保证传输到设备的过程没有造成文件损坏,可以对比一下设备中的文件和电脑中的文件 sha256sum 值,具体方法请自性搜索或者问 ChatGPT。
Expand Down Expand Up @@ -91,3 +92,7 @@ labels = person, bicycle, car, motorcycle, airplane, bus, train, truck, boat, tr
```
这里制定了 `model` 为相对这个`.mud`文件目录的 `yolov5s_224_int8.cvimodel` 文件为模型文件,如果你改了`yolov5s_224_int8.cvimodel` 为其它名,那也需要改这里。

## MaixVision import maix 显示红色波浪线

这是 MaixVision 的代码提示功能报错找不到 maix 模块。
这里需要搞清楚一个概念: MaixVision 的代码提示依赖的是电脑本地的 Python 包,代码运行依赖的设备端的 Python 包,所以要让 MaixVision 能够提示就要在电脑上也安装 Python 和 `MaixPy` 包。具体请看[MaixVision 使用文档](./basic/maixvision.md)

0 comments on commit 40271bb

Please sign in to comment.