diff --git a/config/config_zh.json b/config/config_zh.json index a63f9dbf..e0ff6750 100755 --- a/config/config_zh.json +++ b/config/config_zh.json @@ -10,6 +10,7 @@ "items": [ { "label": "产品", + "url": "/hardware/zh/index.html", "position": "left", "type": "list", "items": [ diff --git a/docs/hardware/zh/README.md b/docs/hardware/zh/README.md index 9d67a3be..570fb9b0 100644 --- a/docs/hardware/zh/README.md +++ b/docs/hardware/zh/README.md @@ -10,20 +10,26 @@ desc: 矽速科技的硬件资料站 [![](./../assets/maix.jpg)](./maix/readme.md) +## MaixII & III 系列 -## MaixII Linux AI 开发板系列 +Linux AI 开发板 [![](./../assets/maixii.jpg)](./maixII/readme.md) -## Lichee Linux 开发板系列 +## Lichee 系列 + +Linux 开发板 [![](./../assets/lichee.jpg)](./lichee/readme.md) ## Tang 系列 + FPGA 开发板 [![](./../assets/tang.jpg)](./tang/readme.md) ## Longon 系列 +MCU 开发板 + [![](./../assets/longan_nano.jpg)](./longan/readme.md) \ No newline at end of file diff --git a/docs/hardware/zh/maixII/M2A/config_system.md b/docs/hardware/zh/maixII/M2A/config_system.md index 4211e01c..29361c9b 100644 --- a/docs/hardware/zh/maixII/M2A/config_system.md +++ b/docs/hardware/zh/maixII/M2A/config_system.md @@ -1,34 +1,76 @@ # 配置系统 -配置系统我们需要将电脑与板子先连接上，然后使用[串口](https://baike.baidu.com/item/%E4%B8%B2%E8%A1%8C%E7%AB%AF%E5%8F%A3/7353286)来通信，接着可以正常操作板子了。 - Lichee MaixSense 的引脚图如下: -![](./assets/R329-pin.jpg) +pinmap -直接将电脑与上图中所示的板子上的 TTYS0 的口(默认在板子上DEBUG标识附近的口)相连就行，这样就已经完成了电脑与板子的连接。 +## 连接串口 -为了能够正常通信，我们还需要安装 [CH340 驱动](https://dl.sipeed.com/fileList/MAIX/tools/ch340_ch341_driver/CH341SER.EXE) +连接串口是为了使电脑与板子能够进行通信。 -## Tina系统配置 +相关操作： 使用 Type-C 线将电脑与上图所标注处的 `USB转系统串口` 相连即可，然后根据电脑系统执行不同的下方操作 -一般建议使用 armbian 系统，对于 Tina 系统还是经验丰富的用户来使用比较好。 +### Linux & macOS + +Linux 不需要装驱动，系统自带了，使用 `ls /dev/ttyUSB*` 命令即可看到设备号 + +### Windows + +Lichee MaixSense 使用了 CH340 作为串口芯片。Windows 用户需要安装 CH340 的驱动。 + +Windows 下载 [ch340 ch341 driver](https://api.dl.sipeed.com/shareURL/MAIX/tools/ch340_ch341_driver) 安装即可，然后可以在设备管理器中看到串口设备和端口号。 + +## Tina 系统配置 + +一般建议使用 armbian 系统，对于 Tina 系统用户需要有一定的使用基础才能够使用。 Lichee MaixSense 的 Tina 系统配置和 [M2dock](./../M2/usage.md) 基本相同，这里不另作赘述。 -- 可以使用串口连接上板子后再使用串口工具软件比如 [Mobaxterm](./../M2/tools/mobaxterm.md) 来操作板子 -- 可以将板子上的摄像头拆下来后再将电脑与该接口相连然后使用 [adb](https://developer.android.google.cn/studio/releases/platform-tools?hl=zh-cn) 。工具来操作板子因为不推荐小白使用 Tina 系统所以不再深说 +- 可以将板子上的摄像头拆下来后再将电脑与该接口相连然后使用 [adb](https://developer.android.google.cn/studio/releases/platform-tools?hl=zh-cn) 工具来操作板子，此操作仅限 Tina 系统。因为不推荐小白使用 Tina 系统，所以此处不再细说 -## armbian系统配置 +## armbian 系统配置 根据本文开头描述来将电脑与板子连接且安装 [CH340 驱动](https://dl.sipeed.com/fileList/MAIX/tools/ch340_ch341_driver/CH341SER.EXE) 后，可以在串口软件比如 Xshell 或者 [Mobaxterm](./../M2/tools/mobaxterm.md)中，设置波特率 (baudrate) 为115200，选择板子的串口，连接上板子。 -**如果自己的板子启动和下面的动图不一样那么直接进入基础使用就好了 [点我](./Usages.md)** +由于所提供的下载镜像分为内置 MaixPy3 的镜像和无 MaixPy3的镜像，所以下面分为两种来说明相关操作。 -板子初始化结束后，可能需要输入登录密码，请多次尝试（配置完后直接 `passwd -d root` 就可以删除密码了） +### 默认含有 MaixPy3 的镜像 -> 烧录带有 MaixPy3 的镜像只需要输入账号密码登录即可，不需要进行系统配置 -> 如果需要用户名和密码的话建议尝试 用户名：root 密码：root +用户名和密码均为 `root` ，登陆进去即可。输入的时候要是输错了就是直接按回车重来吧，最好输入时无更改。 + +成功登录的 log 参考如下： + +```bash +Armbian 21.08.0-trunk Bullseye ttyS0 + +maixsense login: root +Password: + __ __ _ ____ +| \/ | __ _(_)_ __/ ___| ___ _ __ ___ ___ +| |\/| |/ _` | \ \/ /\___ \ / _ \ '_ \/ __|/ _ \ +| | | | (_| | |> < ___) | __/ | | \__ \ __/ +|_| |_|\__,_|_/_/\_\|____/ \___|_| |_|___/\___| + +Welcome to Armbian 21.08.0-trunk Bullseye with bleeding edge Linux 5.14.0-rc7-sun50iw11 + +No end-user support: built from trunk & unsupported (bullseye) userspace! + +System load: 133% Up time: 0 min +Memory usage: 53% of 231M Zram usage: 23% of 115M IP: 192.168.0.251 +CPU temp: 50°C Usage of /: 77% of 2.9G + +[ 0 security updates available, 66 updates total: apt upgrade ] +Last check: 2022-08-31 01:45 + +[ General system configuration (beta): armbian-config ] + +Last login: Tue Aug 30 10:34:06 UTC 2022 on ttyS0 +root@maixsense: +``` + +### 不含 MaixPy3 的镜像 + +由于是全新的镜像，所以首次登录需要设置密码。密码过短或者过于简单的话会被要求重新设置。 ```bash New to Armbian? Documentation: https://docs.armbian.com Support: https://forum.armbian.com @@ -37,7 +79,7 @@ New root password: ********** Repeat password: ********** ``` -然后设置默认 shell,一般选择 bash +设置完密码后需要自行设置默认 shell,一般选择 bash ```bash Choose default system command shell: @@ -48,7 +90,7 @@ Choose default system command shell: Shell: BASH ``` -然后可以设置一个非 root 用户日常操作用 +然后会要求新建一个用户，自定义用户名和登录密码即可。 ```bash Creating a new user account. Press to abort @@ -58,4 +100,19 @@ Create password: ********* Repeat password: ********* ``` +新建用户后默认给新建的用户授予了 root 权限，以后可以直接使用新建的用户来操作板子。 + +可以只用 `passwd -d 你新建的用户名` 来删除所新创建用户密码，其中 `你新建的用户名` 应该改成你上面所新建的用户名称。 + +另外可以直接使用 `passwd 你新建的用户名` 来修改你所创建的用户的密码。 + +```bash +root@maixsense:~# passwd ll +New password: +Retype new password: +passwd: password updated successfully +``` + +下面是部分示例~ + ![2021080511-46-52](./assets/2021080511-46-52.gif) diff --git a/docs/hardware/zh/maixII/M2A/flash_system.md b/docs/hardware/zh/maixII/M2A/flash_system.md index 51ab2b6c..35abb4ce 100644 --- a/docs/hardware/zh/maixII/M2A/flash_system.md +++ b/docs/hardware/zh/maixII/M2A/flash_system.md @@ -22,7 +22,7 @@ armbian 镜像获取： > 链接：[点我](https://eyun.baidu.com/s/3htTXfaG#sharelink/path=%2F%E4%B8%8B%E8%BD%BD%E7%AB%99%E6%96%87%E4%BB%B6%2FMaixII%2FMaixII-A%2FSDK&parent_path=%2F%E6%B7%B1%E5%9C%B3%E7%9F%BD%E9%80%9F%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8) -其中带有 MaixPy3 名称的是已经装载了 MaixPy3 库和相关驱动的镜像包。 +其中以 maixpy3 开头命名的镜像文件的是已经装载了 MaixPy3 库和相关驱动的镜像包。 armbian 镜像所打包的方法为 [dd](https://baike.baidu.com/item/DD/2654972); 可以选用适合当前系统的 [Etcher](https://www.balena.io/etcher/ "Etcher") 软件来烧录。 @@ -30,15 +30,16 @@ armbian 镜像所打包的方法为 [dd](https://baike.baidu.com/item/DD/2654972 Tina 系统需要自己进行编译，具体编译方式参考 [https://github.com/sipeed/R329-Tina-jishu](https://github.com/sipeed/R329-Tina-jishu) -Tina 系统的烧录方式和 MaixII Dock 通用，可参考[MaixII M2dock 烧录系统 - Sipeed Wiki](./../M2/flash.md)，这里不多做介绍 ## 烧录镜像 -### 资源获取 +### armbian 镜像烧录 + +#### 资源获取 - 下载[Etcher](https://www.balena.io/etcher/ "Etcher") -### 烧录步骤 +#### 烧录步骤 首先解压所下载的镜像压缩包，得到 `.img` 镜像文件，打开 [Etcher](https://www.balena.io/etcher/ "Etcher") 软件，点击 `Flash from file` ,选中解压出来的 `.img ` 文件镜像，然后点击 `Select target` 选中sd卡，最后点击 `Flash` 进行烧录，等待完成即可。 @@ -50,4 +51,8 @@ Tina 系统的烧录方式和 MaixII Dock 通用，可参考[MaixII M2dock 烧 ![下载结束](./assets/finish_flash.png) -如果烧录失败了，请手动格式化一下 sd 卡。Windows 和 MacOS 可以使用 [SD Card Formatter](https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip)来格式化 sd 卡，Linux 系统可以使用 [Gparted](https://gparted.org/)来格式化。 \ No newline at end of file +如果烧录失败了，请手动格式化一下 sd 卡。Windows 和 MacOS 可以使用 [SD Card Formatter](https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip)来格式化 sd 卡，Linux 系统可以使用 [Gparted](https://gparted.org/)来格式化。 + +### Tina 镜像烧录 + +Tina 系统的烧录方式和 MaixII Dock 通用，可参考[MaixII M2dock 烧录系统 - Sipeed Wiki](./../M2/flash.md)，这里不多做介绍 \ No newline at end of file diff --git a/docs/hardware/zh/modules/micarray.md b/docs/hardware/zh/modules/micarray.md index 17e6e482..3165868e 100644 --- a/docs/hardware/zh/modules/micarray.md +++ b/docs/hardware/zh/modules/micarray.md @@ -66,6 +66,10 @@ 因为 K210 的 FPIOA 的特性, 支持每个外设随意映射到任意引脚；所以将上面的表格中的 `I/O 口` 与自己的板子上带有数字标识的引脚连起来即可，类似于标有 GND 这种特殊标识的就不算所谓的数字标识引脚。连接完引脚后可以查看下面代码下方关于代码中引脚的说明。 +### 烧录固件 + +前往 [下载站](https://dl.sipeed.com/shareURL/MAIX/MaixPy/release/master/maixpy_v0.6.2_84_g8fcd84a58) 下载固件，下载 [固件说明](https://wiki.sipeed.com/soft/maixpy/zh/get_started/upgrade_maixpy_firmware.html#%E5%9B%BA%E4%BB%B6%E5%91%BD%E5%90%8D%E8%AF%B4%E6%98%8E) 里面的默认固件即可使用。 + ### python代码 ```python diff --git a/docs/hardware/zh/sidebar.json b/docs/hardware/zh/sidebar.json index f931c55c..3445ce14 100644 --- a/docs/hardware/zh/sidebar.json +++ b/docs/hardware/zh/sidebar.json @@ -59,7 +59,7 @@ ] }, { - "label": "Maix-II", + "label": "Maix-II & III", "file": "maixII/readme.md", "items": [ { @@ -307,9 +307,6 @@ ] } ] - }, - { - "label": "Coming soon" } ] }, @@ -328,7 +325,7 @@ ] }, { - "label": "MF 人脸识别模块", + "label": "MaixFace", "items": [ { "label": "MF0&&MF0 Dock", @@ -353,128 +350,134 @@ ] }, { - "label": "SP-MOD外设模组", - "items": [ + "label":"外设模组", + "items":[ { - "label": "转接板类", - "collapsed": false, + "label": "SP-MOD外设模组", "items": [ { - "label": "SP-Extender", - "file": "modules_spmod/spmod_extender.md" - }, - { - "label": "SP-Grove", - "file": "modules_spmod/spmod_grove.md" - }, - { - "label": "SP-FPC", - "file": "modules_spmod/spmod_fpc.md" - }, - { - "label": "SP-MicArray", - "file": "modules_spmod/spmod_micarray.md" - }, - { - "label": "SP-JotStick", - "file": "modules_spmod/spmod_joystick.md" - }, - { - "label": "SP-Servo", - "file": "modules_spmod/spmod_servo.md" - }, - { - "label": "SP-TypeC", - "file": "" - } - ] - }, - { - "label": "传感器类", - "collapsed": false, - "items": [ - { - "label": "SP-Weather", - "file": "modules_spmod/spmod_weather.md" - }, - { - "label": "SP-TOF-1P", - "file": "modules_spmod/spmod_tof.md" - } - ] - }, - { - "label": "通信类", - "collapsed": false, - "items": [ - { - "label": "SP-BT", - "file": "modules_spmod/spmod_bt.md" - }, - { - "label": "SP-LoRa", - "file": "modules_spmod/spmod_lora.md" - }, - { - "label": "SP-PSRAM", - "file": "modules_spmod/spmod_psram.md" - }, - { - "label": "SP-RFID", - "file": "modules_spmod/spmod_rfid.md" - }, - { - "label": "SP-Ethernet", - "file": "modules_spmod/spmod_ethernet.md" - } - ] - }, - { - "label": "显示类", - "collapsed": false, - "items": [ - { - "label": "SP-LCD 1.14", - "file": "modules_spmod/spmod_lcd1.14.md" - }, - { - "label": "SP-Eink", - "file": "modules_spmod/spmod_eink.md" - } - ] - } - ] - }, - { - "label": "模块&&调试器", - "items": [ - { - "label": "调试器&&串口模块", - "file": "modules/debugger_and_uart.md" - }, - { - "label": "模块", - "collapsed": false, - "items": [ - { - "label": "摄像头", - "file": "modules/camera_summary.md" - }, - { - "label": "麦克风模块", + "label": "转接板类", + "collapsed": false, "items": [ { - "label": "麦克风阵列", - "file": "modules/micarray.md" + "label": "SP-Extender", + "file": "modules_spmod/spmod_extender.md" + }, + { + "label": "SP-Grove", + "file": "modules_spmod/spmod_grove.md" + }, + { + "label": "SP-FPC", + "file": "modules_spmod/spmod_fpc.md" + }, + { + "label": "SP-MicArray", + "file": "modules_spmod/spmod_micarray.md" + }, + { + "label": "SP-JotStick", + "file": "modules_spmod/spmod_joystick.md" + }, + { + "label": "SP-Servo", + "file": "modules_spmod/spmod_servo.md" + }, + { + "label": "SP-TypeC", + "file": "" } ] }, { - "label": "Sipeed Gamepad", - "file": "modules/Gamepad.md" + "label": "传感器类", + "collapsed": false, + "items": [ + { + "label": "SP-Weather", + "file": "modules_spmod/spmod_weather.md" + }, + { + "label": "SP-TOF-1P", + "file": "modules_spmod/spmod_tof.md" + } + ] + }, + { + "label": "通信类", + "collapsed": false, + "items": [ + { + "label": "SP-BT", + "file": "modules_spmod/spmod_bt.md" + }, + { + "label": "SP-LoRa", + "file": "modules_spmod/spmod_lora.md" + }, + { + "label": "SP-PSRAM", + "file": "modules_spmod/spmod_psram.md" + }, + { + "label": "SP-RFID", + "file": "modules_spmod/spmod_rfid.md" + }, + { + "label": "SP-Ethernet", + "file": "modules_spmod/spmod_ethernet.md" + } + ] + }, + { + "label": "显示类", + "collapsed": false, + "items": [ + { + "label": "SP-LCD 1.14", + "file": "modules_spmod/spmod_lcd1.14.md" + }, + { + "label": "SP-Eink", + "file": "modules_spmod/spmod_eink.md" + } + ] + } + ] + }, + { + "label": "模块&&调试器", + "items": [ + { + "label": "调试器&&串口模块", + "file": "modules/debugger_and_uart.md" + }, + { + "label": "模块", + "collapsed": false, + "items": [ + { + "label": "摄像头", + "file": "modules/camera_summary.md" + }, + { + "label": "麦克风模块", + "items": [ + { + "label": "麦克风阵列", + "file": "modules/micarray.md" + } + ] + }, + { + "label": "Sipeed Gamepad", + "file": "modules/Gamepad.md" + } + ] } ] } + ] } ] diff --git a/docs/hardware/zh/tang/Tang-Nano-Doc/questions.md b/docs/hardware/zh/tang/Tang-Nano-Doc/questions.md index da6c115a..2a6176b5 100644 --- a/docs/hardware/zh/tang/Tang-Nano-Doc/questions.md +++ b/docs/hardware/zh/tang/Tang-Nano-Doc/questions.md @@ -52,12 +52,22 @@ title: Note 对于其他板子选择型号的时候与芯片丝印相对应就行。 -### 下载卡住 +### 下载卡住、下载非常慢 不要选中带有 Verify 选项的。 ![](./../assets/questions/never_choose_verify.png) +自己注意设置一下下载频率，一般设置为 2.5MHZ 不会有异常 + +
+ 点开查看操作步骤图片 + +

点击下图中的 Frequency

+ +

接着再点击 Save 即可

+
+ ### 找不到下载文件 一般来说生成的下载文件（拓展后缀为.fs）在工程目录下的 impl/pnr 文件夹里面。 @@ -92,7 +102,7 @@ title: Note ### 烧录结束后没反应 -一般这种情况是没有选择正确的烧录文件。自己在 +一般这种情况是没有选择正确的烧录文件。可以自己先对应着各个板子点灯文档里所选择的芯片型号来检查一下自己的工程，然后看看自己的代码是否有问题。 ## IDE 使用相关 diff --git a/docs/soft/maixpy/zh/others/maixpy_faq.md b/docs/soft/maixpy/zh/others/maixpy_faq.md index d6fee7f1..140277f9 100644 --- a/docs/soft/maixpy/zh/others/maixpy_faq.md +++ b/docs/soft/maixpy/zh/others/maixpy_faq.md @@ -266,7 +266,9 @@ SDCard.remount() ## 烧录模型或者固件，出现花屏、屏幕颜色不对、屏幕颜色单一 -这时需要使用，使用 kflash 来对 flash 整片擦除，然后再重新进行对应的 固件 和 模型烧录。烧录模型到 flsah 的时候一定要注意烧录的位置，是否正确（数清楚对应 0 的个数）。 +这时需要使用，使用 kflash 来对 flash 整片擦除，然后再重新进行对应的 固件 和 模型烧录。 + +烧录模型到 flsah 的时候一定要注意烧录的位置，是否正确（数清楚对应 0 的个数）。 比如常见的白色花屏就是固件烧错，需要擦除重烧标准固件就正常了，主要因为屏幕配置不同导致的。 @@ -274,6 +276,8 @@ SDCard.remount() 比如红屏是正常的，但需要用户下载程序。 +蓝屏的话需要完全擦除片内 flash 后再重新烧录。 + ## TypeError: Can't convert to type 错误 Maixpy ide 挂着运行时内存不足，就会出现的常见错误，解决方法，换成菜单的打开终端运行，或让内存有一定预留就不会出现了。 @@ -315,4 +319,8 @@ Maixpy ide 挂着运行时内存不足，就会出现的常见错误，解决方 如果有足够内存，就一次性把几个模型加载到内存， 然后分别分时运行推理。 -如果内存不足，加载第一个模型，运行后注销（使用 `kpu.deinit`），再加载运行第二个模型部分或全部模型。使用 `load_flash` 的方式加载模型，实时从 flash 读取内容。 \ No newline at end of file +如果内存不足，加载第一个模型，运行后注销（使用 `kpu.deinit`），再加载运行第二个模型部分或全部模型。使用 `load_flash` 的方式加载模型，实时从 flash 读取内容。 + +## could not open port 'COMxx':Permission 错误 + +这种情况是因为串口被占用了，自己将使用过串口的程序关闭掉就行。实在不会解决的话重启电脑也能达到关闭所有使用串口程序的效果。 diff --git a/pages/index/zh/longan.md b/pages/index/zh/longan.md index 60554443..bc159b47 100644 --- a/pages/index/zh/longan.md +++ b/pages/index/zh/longan.md @@ -1,5 +1,5 @@ --- layout: redirect -redirect_url: /soft/longan/zh/index.html +redirect_url: https://wiki.sipeed.com/hardware/zh/longan/Nano/Longan_nano.html --- \ No newline at end of file diff --git a/pages/index/zh/m2dock.md b/pages/index/zh/m2dock.md index 12dd40ad..dc640a0f 100644 --- a/pages/index/zh/m2dock.md +++ b/pages/index/zh/m2dock.md @@ -1,4 +1,4 @@ --- layout: redirect -redirect_url: https://wiki.sipeed.com/hardware/zh/maixII/index.html +redirect_url: https://wiki.sipeed.com/hardware/zh/maixII/M2/resources.html ---