diff --git a/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_one.jpg b/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_one.jpg new file mode 100644 index 00000000..f2f6903c Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_one.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_two.jpg b/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_two.jpg new file mode 100644 index 00000000..389052fd Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/axpi/demo_two.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/assets/axpi/share_model.jpg b/docs/hardware/en/maixIII/ax-pi/assets/axpi/share_model.jpg new file mode 100644 index 00000000..2d1c43da Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/axpi/share_model.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/assets/axpi/test_maixhub.jpg b/docs/hardware/en/maixIII/ax-pi/assets/axpi/test_maixhub.jpg new file mode 100644 index 00000000..c60a22f3 Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/axpi/test_maixhub.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_1.jpg b/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_1.jpg new file mode 100644 index 00000000..c7f6d2be Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_1.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_2.jpg b/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_2.jpg new file mode 100644 index 00000000..0e4d93fb Binary files /dev/null and b/docs/hardware/en/maixIII/ax-pi/assets/qa/qa_switcg_os04a10_2.jpg differ diff --git a/docs/hardware/en/maixIII/ax-pi/axpi.md b/docs/hardware/en/maixIII/ax-pi/axpi.md index 3c005d79..d361c7b4 100644 --- a/docs/hardware/en/maixIII/ax-pi/axpi.md +++ b/docs/hardware/en/maixIII/ax-pi/axpi.md @@ -11,9 +11,9 @@ update: > This page is on building, please use translation application to see https://wiki.sipeed.com/m3axpi instead. -If you think this AI development board are excellent enough and your friends may be interested with this, just share with them this link [http://wiki.sipeed.com/m3axpi](http://wiki.sipeed.com/m3axpi) +If you think this AI development board are excellent enough and your friends may be interested with this, just share with them this link [http://wiki.sipeed.com/m3axpi](http://wiki.sipeed.com/en/m3axpi) -![maixiii_axpi](./../../../../../static/home/maixiii_axpi.jpg) +![maixiii_axpi](./../../../../../static/home/maixiii_axpi_en.jpg) > [Official Online Store](https://www.aliexpress.com/item/1005005016931077.html) @@ -21,27 +21,11 @@ In the past few years, many Linux AI chips come out. Raspberry Pi and Jetson Nano these boards are really popular by their good performance, but now MAIX-III AXera-Pi comes out, equipped with the high-performance 3.6TOPs@INT8 chip ax620a, which will be your good choice and provice you a really good experience. - -

img

-We design this chip into a core module, which is convenient if you want to design the ext-board for yourself. +We design a core module for this chip, which is convenient if you want to design the ext-board for yourself. @@ -129,13 +113,6 @@ So, why is this AI development board good? - Bad camera result? This chip is aimed for AI ISP night vision enhancement, we have adjust the camera to best state. - Too expensive? This board sold about 100$, chiper than any other similar board. - - ## Features ### Camera effect @@ -176,24 +153,21 @@ So, why is this AI development board good?

-### AI advantages +### AI resources -#### Support many Operator +#### Support many Operators ![many_operator](./assets/axpi/many_operator.jpg) Screenshots of part operators. [Click me to see whole operator support list](https://pulsar-docs.readthedocs.io/en/latest/appendix/op_support_list.html) -#### Many AI models +#### Many archived models Before receiving this board, visit [MaixHub](https://maixhub.com/model/zoo) to see your interested model, choose Platform `axera-pi` at the Lower left corner to find model can be deployed on `AX-PI` ![maixhub_zoo.jpg](./assets/axpi/maixhub_zoo.jpg) -Apart from these, the models are uploaded to [github AXERA-TECH/ax-samples](https://github.com/AXERA-TECH/ax-samples), and there are also some models in the system image, flashing the system and boot it you will get some models too. The supported models are as followings: - - +Apart from these, many models are uploaded to [github AXERA-TECH/ax-samples](https://github.com/AXERA-TECH/ax-samples), and we also put sme models in sustem image, just burn the system image into SD card and boot it on board to experience these models. Up to now the supported models are as follows: - Objects Classification - MobileNetv1 @@ -252,75 +226,39 @@ Visit [Deploy models to AX-Pi (Maix-III(M3) series) board](/ai/en/deploy/ax-pi.h Now the [MaixHub](https://maixhub.com/welcome) has been upgraded, with more friendly interface and more functions, here are steps to tranning model online.

- +

-> m3axpi doec not support deploy model by scanning QR code while m2dock can do, m3axpi only can be deployed models by local operations. + -#### Share model +#### Share your model -There will be a model file and codes or programs to run the code, you can share these on [Maixhub](https://maixhub.com/model/zoo) to other people, let's build the model Community together. +There are your model and codes or programs to run the model after you finish training the model, you can share these on [Maixhub](https://maixhub.com/model/zoo) to others, let's have fun and build the model Community together.

- +

-

- -

- -### Defaule cases +### Cases > Updated in 20221205

- - + +

### Linux development - - -#### Based on debian - -We provide debian11 Linux distribution, and support boot from SD card and burn system by dd(A linux command), make it easiler for user to use. Besides, it's really conveient to program AI application by Python API. - -1. Burning image: [WIKI AXera-Pi Burn image](./flash_system.md) +1. Burning image: [WIKI AXera-Pi Burn image](./flash_system.md#burn-system-image) 2. Basic usage：[WIKI AXera-Pi guide](./flash_system.md) @@ -332,11 +270,11 @@ We provide debian11 Linux distribution, and support boot from SD card and burn s #### BSP SDK -We provide source code, api documents, sdk usage, visit [sdk usage](https://wiki.sipeed.com/hardware/zh/maixIII/ax-pi/sdk_usage.html) to get more. +We provide source code, api documents, sdk usages, visit [sdk usage](https://wiki.sipeed.com/hardware/zh/maixIII/ax-pi/sdk_usage.html) to get more. ##### [ax-sample](https://github.com/AXERA-TECH/ax-samples) -Here are AI models provided by Axera for development, evaluation and verification, those who are good at AI development or want to test these models can have a try, and there models are not involved with peripherals. +Here are typical AI models provided by Axera for development, evaluation and verification, those who are good at AI development or want to test these models can have a try, and there models are not involved with peripherals. 1. [examples](https://github.com/AXERA-TECH/ax-samples/tree/main/examples) 2. [PP-YOLOv3](https://github.com/AXERA-TECH/ax-samples/blob/main/examples/README.md#yolov3paddle) @@ -345,7 +283,7 @@ Here are AI models provided by Axera for development, evaluation and verificatio ##### [libmaix](https://github.com/sipeed/libmaix) -A unified embedded development environment created by SIPEED, aimed to camera, screen, vision, image processing, deployment pipelines-related routines, is suitable for those who want to learn embedded Linux. +A unified embedded development environment come by SIPEED, aimed to camera, screen, vision, image processing and pipelines-related deployment routines, is suitable for those who want to learn embedded Linux. 1. [Test screen display](https://github.com/sipeed/libmaix/tree/release/examples/display) 2. [Screen displays camera content](https://github.com/sipeed/libmaix/tree/release/examples/axpi) @@ -535,20 +473,12 @@ AX-Pipeline is provided by Axera. With m3axpi, this project is used for pepole t

-> [How to change camera](https://wiki.sipeed.com/hardware/en/maixIII/ax-pi/faq_axpi.html) +> [How to change camera](./faq_axpi.md) ## Others - - - Online AI: http://maixhub.com - Documents: http://wiki.sipeed.com - Github: http://github.com/sipeed - - - > Visit [Maix-III AXera-Pi (FAQ)](./faq_axpi.md) if you have trobule. diff --git a/docs/hardware/en/maixIII/ax-pi/faq_axpi.md b/docs/hardware/en/maixIII/ax-pi/faq_axpi.md index e69de29b..a4dd74cf 100644 --- a/docs/hardware/en/maixIII/ax-pi/faq_axpi.md +++ b/docs/hardware/en/maixIII/ax-pi/faq_axpi.md @@ -0,0 +1,114 @@ +--- +title: Maix-III AXera-Pi Q&A +--- + +## Q：Device not work + +A: Try to plug connect the 2 USB on m3axpi, by this m3axpi can get enough power to boot. m3axpi comsume 5V*1A maximum. + +## Q：How to switch to os04a10 camera？ + +A：**Change the parameter, or edit code** + +- For examples like [`sample_vin_vo`](./basic_usage.md#video), we can change the parameter `-c 2` into `-c 0` to switch camera. +- Like to edit the code `COMMON_SYS_CASE_E eSysCase = SYS_CASE_SINGLE_GC4653;`, visit [github libmaix](https://github.com/sipeed/libmaix/blob/release/components/libmaix/lib/arch/axpi/libmaix_cam/libmaix_cam.cpp) to know more. + +
+ qa_switcg_os04a10_1 + qa_switcg_os04a10_2 +
+ +## Q：Error `i2c_read: Failed to read reg: Remote I/O error.!` when using camera + +A: Make sure you have connected the camera and board correctly, and run the command correctly, like using the mismatched camera parameters or wrong parameters in command. If these are all right but this error still occurs, there are some errors on the device. + +## Q：How to use the other screen？ + +A：Up to now we only provide screen with 5 inches, and for other screens you need to build the driver, edit the device tree and the application codes to display. + +## Q：Error `locale.Error: unsupported locale setting !` when running `xxxx menuconfig` + +A: Run `sudo localedef -i en_US -f UTF-8 en_US.UTF-8` to restore the configuration to slove this. + +## Q：Error `VCEncInit:ERROR codecFormat NOT support by HW !` when running `IPC ODM` + +A: Try to reboot device by pressing the RST key onboard or replug device. + +## Q：Screen display wrong + +![faq_display](./../../../zh/maixIII/assets/faq_display.jpg) + +A: Check if you have set the correct camera parameters. + +## Q：Screen shows opposite camera content + +A: This occurs because of the different batches of products, connecting them with 180° rotation. + +![faq_video_a](./../../../zh/maixIII/assets/faq_video_a.jpg) + +Those who have shell for AXera-Pi can connect them like in the following pictures: + + + + + + +## Q：Error `Bus Error！` + +![faq_bus](./../../../zh/maixIII/assets/faq_bus.jpg) + +A：This happens when data in the tf card system is broken because of the bad quality of tf card. + +- Try to use a good tf card, like what we sell, and you can choose your tf card based on our test: [Choose tf card](./flash_system.md#choose-tf-card) + +## Q：No eth0 ip address after running `ifconfig -a` + +A：There is no ip address if the ethernet is not connected to the Internet, check your ethernet connection. Or use command `dhclient eth0` to get the ip address mannaly or visit [config eth0](./basic_usage.md#config-eth0) to know more. + +## Q：Device not found after running uvc + +A：This might happen on Windows. Check if there is an error in Windows device manager, remove the incorrect device then this error will be solved. + +## Q：The device is stuck after running uvc + +A：Reboot the board + +## Q：No wlan0 shown in result after running command `ifconfig` + +A： +- Maybe the bad connection between Core Model and ext-board because of the express, reconnect them to fix this bad connection. +- The wireless module is changed in `20221219`, so it's need to change the configration file, run the following command: + +```bash +ls /boot/ +cp /boot/kernel.img.rtl8189fs kernel.img +``` + +## Q：Error `packet_write_wait: Connection to 10.xxx.xxx.xxx port 22: Broken pipe！` after login by ssh + +A: Reboot device after run Run command `python3 -c "import os, binascii; os.system('sed -i \'/iface eth0 inet dhcp/ahwaddress ether {}\' /etc/network/interfaces'.format(binascii.hexlify(bytes.fromhex(open('/proc/ax_proc/uid').read().split('0x')[1][:-5]),':').decode('iso8859-1'))) if os.system('grep \'hwaddress ether\' /etc/network/interfaces -q') != 0 else exit();"` in serial port. + +## Q：The screen is blurred after booting. +## Q：Sticking Image on screen + + + + + + +A：Because of the because of the different batches of products, the configuration for screen is different, replace the `dtb` file in `/boot/` folder. + +```bash +ls /boot/ +cp /boot/dtb.img.lcd20220830 dtb.img #dtb.img.lcd20221025 dtb.img +``` + +## Q：Error `can't open camera by index` when running opencv. + +A：Check if the camera in the code matches the camera you use. [switch camera](#qhow-to-switch-to-os04a10-camera) + +## Q：`XERA-UBOOT=>` is shown from serial port. + +A：This happens when autoboot is canceled when booting device, use command `boot` to start system. + +![faq_boot](./../../../zh/maixIII/assets/faq_boot.jpg) \ No newline at end of file diff --git a/docs/hardware/zh/maixIII/ax-pi/axpi.md b/docs/hardware/zh/maixIII/ax-pi/axpi.md index e1a2843d..7b34a3d6 100644 --- a/docs/hardware/zh/maixIII/ax-pi/axpi.md +++ b/docs/hardware/zh/maixIII/ax-pi/axpi.md @@ -182,11 +182,11 @@ title: MAIX-III AXera-Pi 是什么？ 在你部署成功后会有一份模型文件，以及能运行模型的代码或程序，你可以将这些文件分享到 [MaixHub 模型库](https://maixhub.com/model/zoo) ，大家一起交流学习成长！（请开始你的表演吧）

- +

- +

### 众多开箱案例 diff --git a/static/home/maixiii_axpi_en.jpg b/static/home/maixiii_axpi_en.jpg new file mode 100644 index 00000000..b600a6cf Binary files /dev/null and b/static/home/maixiii_axpi_en.jpg differ