踩过的坑，帮你一次性避掉

90% 是数据线问题 —— 很多 Type-C 线只有充电功能，没有数据脚。请换一根确认支持数据传输的线。 此外 Windows 用户需要先装 CH340 / CP210x 驱动， 安装后重启一次电脑，再插入开发板查看设备管理器是否出现 COM 端口。

烧录前请按住板子上的 BOOT 键再插上 USB（部分型号需要按着 BOOT 再上电）， 之后点击 Download。若仍失败，尝试降低串口波特率到 1.5Mbps， 或更换 USB Hub（部分笔记本 USB 3.0 电流不稳会导致传输失败）。

Maix Bit 出厂默认带 1.3 寸 IPS 屏幕，但没有摄像头。需要在 Sipeed 官方店额外购买 OV2640 或 GC0328 摄像头模组（排线接口一致），安装时注意金色触点朝下。

① 确认串口没被其它软件（kflash_gui、PuTTY、串口监视器）占用；
② IDE 左下角点击 串口 图标确认当前选的是开发板对应的 COM 端口；
③ 按下板子的 RST 复位键，观察是否出现启动日志；
④ 如果仍无反应，尝试升级 / 降级固件版本。

K210 总 SRAM 仅 8MB，大模型推理时图像缓冲 + 权重很容易撑爆。 建议：① 降低摄像头分辨率（如 QVGA）；② 减少同时加载的模型数量；③ 用 gc.collect() 主动释放内存；④ 加载模型时把 layer_mode 设为 layer_mode=0xFFFFFFFF（整层加载）， 或分块推理。

常见原因：① 烧录的是 _minimum 最小固件，没有内置某些模块。请改烧 _minimum_with_openmv_kmodel_v4 全功能固件；② SD 卡没插入或文件系统未挂载， 复制模块文件到 /flash 或 /sd 后重启。

使用 nncase（Kendryte 官方）执行量化与编译：

$ nncase compile --input model.tflite \
  --output model.kmodel \
  --dataset images/ \
  --input-shape 1,224,224,3 \
  --quantize uint8

推荐先在云端 GPU 跑出 FP32 模型，再用 nncase 做 PTQ（训练后量化）， 8-bit 量化后模型通常压缩到原来的 1/4，精度损失 < 1%。

① 改用 kpu.load_kmodel(...) 替代 kpu.load 获得更快的加载速度；
② 把摄像头分辨率降到 QVGA (320×240) 或 QQVGA (160×120)；
③ 模型量化时选择 uint8（不要用 fp16）；
④ 关闭非必要外设与 LCD 帧率限制；
⑤ 把耗时 IO 操作放到另一个线程，避免阻塞主循环。

K210 的 KPU 主要支持 Conv2D / DepthwiseConv / Pooling / ElementWise / MatMul 等算子。 训练时尽量避免复杂结构（如 SE 模块、LSTM、Soft Attention）。 建议使用 MobileNetV1/V2 主干 + 简单检测头，并通过 ONNX 工具 Netron 预览算子兼容性。

① CPU 频率可由默认 400MHz 降到 200MHz，功耗可降低约 40%；
② 不需要屏幕时通过 lcd.display_off() 关闭 LCD 节省约 30mA；
③ 用 machine.lightsleep() 进入轻度睡眠，外设唤醒时间 < 5ms；
④ 大循环中加入 time.sleep_ms(1) 让出 CPU。

K210 本身不含无线模块，需要外挂：
① 经典方案：Maix Dock 板载 ESP32，串口通信共享网络；
② 自己接 ESP-12F 模组，AT 指令连 Wi-Fi；
③ 工业场景建议接 4G Cat.1 模组（如 Air724），稳定性更高。