faq.md

MaixCDK FAQ

You can also find FAQ from:

• MaixPy FAQ
• MaixCAM FAQ
• MaixPy 源码 FAQ

常见编译错误的通用解决方法

• 提示解压失败等错误: 可以尝试删除掉dl/pkgs和dl/extracted目录下的对应文件让重新编译下载即可。
• 编译报错：
  • 执行maixcdk build --verbose 查看哪里报错，仔细看报错日志一步一步探寻问题。
  • 执行 maixcdk distclean 清理临时文件后重新编译。
  • 到github 提交记录处看到每个提交的自动测试是否通过（绿色的勾勾✅就是通过，红色叉叉❌就是失败），可以将本地代码切换到测试通过的提交✅再编译（本地执行git checkout 提交号比如git checkout 3aba2fe3fa9de9f638bb9cb34eca0c2e0f5f3813， 如果切换失败请自行搜索 git 用法或者直接从头来过，注意备份自己修改的代码）。

Downloading ippicv_2021.8_lnx_intel64_20230330_general.tgz takes a long time or fail

Manually download according to the log's url, and put it into: MaixCDK -> components -> opencv -> opencv4 -> .cache -> ippicv The file name is 43219bdc7e3805adcbe3a1e2f1f3ef3b-ippicv_2021.8_lnx_intel64_20230330_general.tgz, File name and url can also be found in MaixCDK/components/3rd_party/opencv/opencv4/3rdparty/ippicv/ippicv.cmake

So the same as ade cache file .cache/ade/4f93a0844dfc463c617d83b09011819a-v0.1.2b.zip

Exception: parse_api_from_header **.hpp error: 'members'

API comment not complete. e.g.

/**
 * Class for communication protocol
 */
class CommProtocol
{
    /**
     * Read data to buffer, and try to decode it as maix.protocol.MSG object
     * @return decoded data, if nullptr, means no valid frame found.
     *         Attentioin, delete it after use in C++.
     * @maixpy maix.comm.CommProtocol.get_msg
     */
    protocol::MSG *get_msg();
}

Here class CommProtocol not add @maixpy maix.comm.CommProtocol but its method get_msg add it. So we add @maixpy maix.comm.CommProtocol to class CommProtocol comment will fix this error.

使用WSL编译OpenSSL时出错的修复方法

当我在工程中使用openssl时：

编译报错：

用verbose查看命令发现， Path里是包含“（”的，这是windows的Path将WSL的path污染了。

参照网上的方法，在WSL中：

sudo nano /etc/wsl.conf

如果没有则新建，内容如下：

[interop]
appendWindowsPath = false

重启WSL后， Path干净了。

编译openssl也成功了。