update doc for no screen board

docs/doc/en/README.md

@@ -52,6 +52,9 @@ title: MaixCAM MaixPy Quick Start
 
 >! Note that currently only the MaixCAM development board is supported. Other development boards with the same chip are not supported, including Sipeed's development boards with the same chip. Please be careful not to purchase the wrong board, which could result in unnecessary waste of time and money.
 
+If you use screenless version, please refer to the [Quick Start (Screenless Version)](./README_no_screen.md) document.
+
+
 ## Getting Started
 
 ### Prepare the TF Image Card and Insert it into the Device

docs/doc/en/README_no_screen.md

@@ -0,0 +1,141 @@
+---
+title: MaixCAM MaixPy Screenless Edition Quick Start
+---
+
+## About This Document
+
+As mentioned in the [Quick Start Guide](./README.md), it is **strongly recommended** to purchase the version with a screen for development, as it provides a better development experience, including using the built-in APP, accessing apps from the MaixHub App Store, and easier debugging (e.g., common settings can be completed directly by touching the screen interface, and images can be viewed in real-time).
+
+However, if you are unable to purchase the version with a screen or require a screenless version for mass production, please refer to this document.
+
+## Getting a MaixCAM Device
+
+* **MaixCAM**: Purchase it from the [Sipeed Taobao Store](https://item.taobao.com/item.htm?id=784724795837) or the [Sipeed Aliexpress Store](https://www.aliexpress.com/store/911876460). You can find more information about MaixCAM [here](https://wiki.sipeed.com/maixcam).
+
+## Initial Setup
+
+### Preparing the TF Image Card and Inserting it into the Device
+
+If your package includes a TF card, it already contains the factory image. If the TF card was not installed in the device during manufacturing, carefully open the case (be careful not to disconnect any cables inside) and insert the TF card. Additionally, since the factory firmware may be outdated, it is **essential** to update the system to the latest version by following the [Upgrade and Flash System](https://wiki.sipeed.com/maixpy/doc/zh/basic/os.html) instructions; otherwise, some applications and APIs may not function properly.
+
+If you did not purchase a TF card, you will need to flash the system onto your own TF card. Follow the [Upgrade and Flash System](./basic/os.md) guide, then install the card into the board.
+
+### Powering On
+
+Use a `Type-C` data cable to connect the `MaixCAM` device to provide power and wait for the device to boot.
+
+**Firstly**: Ensure that the USB cable is of good quality and that the USB port on your computer is reliable (power supply >= 5V 500mA, normal interference resistance). The first boot may take about 20 seconds, after which your computer will detect one or two virtual network adapters (visible in your computer's network manager).
+
+If the virtual network adapter is not detected:
+* Ensure that you purchased the TF card package. If you have confirmed that the TF card is inserted into the device, try [updating to the latest system](./basic/os.md).
+* If you did not purchase the TF card package, you need to flash the latest system onto the TF card following the [Upgrade and Flash System](./basic/os.md) guide.
+* Check if the USB connection is loose and whether the USB cable is of good quality; you can try using a better-quality cable.
+* Ensure that the USB port provides sufficient power. You can try another USB port or even another computer if possible.
+
+## Preparing to Connect the Computer and Device
+
+To enable communication between your computer (PC) and the device (MaixCAM), they need to be on the same local area network. Two methods are provided; we will first use Method 1:
+* **Method 1**: Wired connection. The device connects to the computer via a USB cable, and it will be recognized as a virtual USB network adapter, placing it on the same local area network as the computer. If you encounter issues, refer to the [FAQ](./faq.md) for common problems.
+.. details::Method 2 involves driver installation on different computer systems:
+    :open: true
+    There are two default USB virtual network adapter drivers (NCM and RNDIS) to meet the needs of different systems:
+    * **Windows**: All Windows systems will automatically install the RNDIS driver. Only Win11 will automatically install the NCM driver. **Either one that works is fine** (NCM is faster than RNDIS).
+      * Open Task Manager -> Performance, and you will see a virtual Ethernet connection with an IP, for example, `10.131.167.100` is the computer's IP, and the device's IP is the same except the last digit changed to `1`, i.e., `10.131.167.1`. If it's Win11, you will see two virtual network adapters; you can use any one of the IPs.
+      * Additionally, you can open the `Device Manager` on your computer (search `Device Manager` in the search bar). If the RNDIS and NCM drivers are correctly installed, **either one that works is fine**:
+        ![RNDIS ok](../../static/image/rndis_windows.jpg) ![NCM ok](../../static/image/windows_ncm_ok.png)
+    * **Linux**: No extra setup is required. Just plug in the USB cable. Use `ifconfig` or `ip addr` to see `usb0` and `usb1` network adapters, and you can use either IP. **Note** that the IP, for example, `10.131.167.100`, is the computer's IP, and the device's IP is the same except the last digit changed to `1`, i.e., `10.131.167.1`.
+    * **MacOS**: Check the `usb` network adapter in `System Settings` -> `Network`. **Note** that the IP, for example, `10.131.167.100`, is the computer's IP, and the device's IP is the same except the last digit changed to `1`, i.e., `10.131.167.1`.
+* **Method 2**: Wireless connection. The device connects to the same router or WiFi hotspot that the computer is connected to (if you experience screen lag or high latency with WiFi, use a wired connection). There are two methods for connecting to a wireless hotspot:
+  * Modify the `wifi.ssid` and `wifi.pass` files in the TF card's boot partition and reboot to connect. Modification methods:
+    * If you are familiar with SSH, you can connect to the device via SSH (if wired connection is available) and modify the files in the `/boot` directory.
+    * You can also enter upgrade mode as described in the previous section, after which a USB drive will appear on the computer. Modify the files in it, ensuring to safely eject the drive before rebooting.
+    * You can also use a card reader, and a USB drive will appear on the computer. Modify the `wifi.ssid` and `wifi.pass` files in it, ensuring to safely eject the drive before rebooting.
+  * If the wired connection is already available, you can follow the next step and use MaixVision to run code. Modify the `tools/wifi_connect.py` script with your SSID and PASSWORD, then run it.
+
+## Preparing the Development Environment
+
+* First, ensure that the computer and device are on the same local area network.
+* Download and install [MaixVision](https://wiki.sipeed.com/maixvision).
+* Use a Type-C cable to connect the device and computer, open MaixVision, and click the `Connect` button at the bottom left. The software will automatically search for the device. Wait a moment until the device appears, then click the device to connect.
+
+If **the device is not detected**, you can find solutions in the [FAQ](./faq.md).
+
+Here is a video tutorial on using MaixVision:
+
+<video style="width:100%" controls muted preload src="/static/video/maixvision.mp4"></video>
+
+### Connecting to the Internet
+
+The first run requires a network connection to activate the device and install the runtime library. If you do not have a router, you can use your phone to create a hotspot.
+
+In MaixVision, modify the `tools/wifi_connect.py` script with your SSID and PASSWORD, then run it. For other WiFi connection methods, see the previous section.
+
+### Upgrading the Runtime Library
+
+**This step is very important!!!** If this step is not completed, other applications and features may not function properly (e.g., crashing).
+
+* First, ensure that the WiFi connection from the previous step is completed and that you have an IP address with internet access.
+* Run the `tools/install_runtime.py` script from the MaixVision examples to install the latest runtime library.
+
+If `Request failed` or a similar error appears, please check if the network is connected and able to access the internet. If the problem persists, take a photo and contact customer service for assistance.
+
+## Running Examples
+
+Click on the `Example Code` on the left side of MaixVision, select an example, and click the `Run` button at the bottom left to send the code to the device for execution.
+
+For example:
+* `hello_maix.py`, click the `Run` button, and you will see messages printed by the device in the MaixVision terminal, and an image will appear in the top right corner.
+* `camera_display.py`, this example opens the camera and displays the camera feed on the screen.
+```python
+from maix import camera, display, app
+
+disp = display.Display()          # Create a display object and initialize the screen
+cam = camera.Camera(640, 480)     # Create a camera object, manually setting the resolution to 640x480, and initialize the camera
+while not app.need_exit():        # Keep looping until the program exits (can exit by pressing the device's function button or clicking the stop button in MaixVision)
+    img = cam.read()              # Read the camera feed into the img variable, print(img) can be used to print img details
+    disp.show
+
+(img)                # Display img on the screen
+```
+* `yolov5.py` detects objects in the camera feed, draws bounding boxes around them, and displays them on the screen. It supports detecting 80 different objects. For more details, see [YOLOv5 Object Detection](./vision/yolov5.md).
+
+You can try other examples on your own.
+
+> If you experience image lag when using the camera examples, it may be due to poor network connection, low-quality USB cable, or poor USB port quality on the host. Try changing the connection method or using a different cable, USB port, or computer.
+
+## Installing Applications on the Device
+
+The above steps allow you to run code on the device. Once `MaixVision` is disconnected, the code will stop running. If you want the code to appear in the boot menu, you can package it as an application and install it on the device.
+
+Click the install application button at the bottom left of `MaixVision`, fill in the application information, and it will be installed on the device. You will then see the application on the device.
+You can also choose to package the application and share it on the [MaixHub App Store](https://maixhub.com/app).
+
+> The default examples do not include an explicit exit function. Press the device's function button to exit the application (for MaixCAM, it is the user button).
+
+If you want the program to start automatically at boot, you can modify and run the `tools/set_autostart.py` script.
+
+## Next Steps
+
+If you like what you've seen so far, **please make sure to visit [GitHub](https://github.com/sipeed/MaixPy) and give the MaixPy open-source project a star (you need to log in to GitHub first). Your star and support are our motivation to keep maintaining and adding new features!**
+
+You have now completed a basic usage and development process. Next, you can learn more about `MaixPy` syntax and features by following the directory on the left. If you encounter any issues with the `API`, you can find help in the [API Documentation](/api/).
+
+It's best to learn with a specific goal in mind, such as working on an interesting project. This will improve your learning experience. You can also share your projects and experiences on the [MaixHub Sharing Platform](https://maixhub.com/share) to earn cash rewards!
+
+## Frequently Asked Questions (FAQ)
+
+If you encounter any issues, first check the [FAQ](./faq.md). If you can't find a solution, you can ask questions in the forum or group below, or submit a code issue on [MaixPy issue](https://github.com/sipeed/MaixPy/issues).
+
+## Share and Communicate
+
+* **[MaixHub Project and Experience Sharing](https://maixhub.com/share)**: Share your projects and experiences to earn cash rewards. To receive official rewards, your content should meet the following criteria:
+  * **Reproducibility**: A fairly complete project reproduction process.
+  * **Showcase**: Projects without a detailed reproduction process but with an attractive presentation.
+  * Bug Solution Experience: Share your process and specific solution to a difficult problem.
+* [MaixPy Official Forum](https://maixhub.com/discussion/maixpy) (for questions and discussions)
+* QQ Group: (It's recommended to post first before asking in the QQ group so others can quickly understand your problem and reproduction process)
+  * MaixPy (v4) AI Vision Group: 862340358
+* Telegram: [MaixPy](https://t.me/maixpy)
+* MaixPy Code Issues: [MaixPy issue](https://github.com/sipeed/MaixPy/issues)
+* For business cooperation or bulk purchases, please contact support@sipeed.com.
+

docs/doc/en/faq.md

@@ -125,3 +125,11 @@ The remaining memory is reserved for low-level drivers and the kernel, which are
 
 If you want to adjust the memory allocation, you would need to compile the system yourself and modify the `ION_SIZE` in the `memmap.py` file located in the `LicheeRV-Nano-Build/build/boards/sg200x/sg2002_licheervnano_sd/` directory(refer to [customize system doc](./pro/compile_os.md)).
 
+## Why Am I Unable to Install the Runtime Library, and an Error "Request Failed" Is Displayed?
+
+* Ensure that the device is successfully connected to the internet. You can try connecting to a different mobile hotspot.
+* Verify that the system image you flashed is the latest version.
+* If you see an error related to DNS resolution failure, it might be due to DNS settings issues on your network. You can try connecting to a different mobile hotspot or manually modify the DNS server settings in `/boot/resolv.conf` (modifying this file requires a reboot) and `/etc/resolv.conf` (modifying this file does not require a reboot, but rebooting will overwrite it with the contents of the former).
+* Make sure you have purchased a genuine MaixCAM from Sipeed.
+* Contact customer service, providing the system version and device_key (which can be found after disconnecting from MaixVision or, if you have a screen, in `System Settings -> System Information`).
+

docs/doc/en/sidebar.yaml

@@ -1,6 +1,8 @@
 items:
 -   file: README.md
     label: Quick Start
+-   file: README_no_screen.md
+    label: Quick Start(no screen)
 -   file: faq.md
     label: FAQ
 

docs/doc/zh/README.md

@@ -68,12 +68,14 @@ title: MaixCAM MaixPy 快速开始
 
 >! 注意，目前只支持 MaixCAM 开发板，其它同型号芯片的开发板均不支持，包括 Sipeed 的同型号芯片开发板，请注意不要买错造成不必要的时间和金钱浪费。
 
+如果你使用的是无屏幕版本，请看[快速开始（无屏幕版本）](./README_no_screen.md)文档。
+
 
 ## 上手配置
 
 ### 准备 TF 镜像卡和插入到设备
 
-如果你买的套餐里面有 TF 卡，里面已经有出厂镜像了，如果出厂时 TF 卡没有安装到设备，需要先小心打开外壳（注意里面有排线连接不要扯断了），然后插入 TF 卡。另外因为出厂的固件可能比较老旧，**强烈建议**按照[升级和烧录系统](https://wiki.sipeed.com/maixpy/doc/zh/basic/os.html)先将系统升级到最新版本，否则可能会遇到某些应用 和 API 无法使用的问题。
+如果你买的套餐里面有 TF 卡，里面已经有出厂镜像了，如果出厂时 TF 卡没有安装到设备，需要先小心打开外壳（注意里面有排线连接不要扯断了），然后插入 TF 卡。另外因为出厂的固件可能比较老旧，**务必**按照[升级和烧录系统](https://wiki.sipeed.com/maixpy/doc/zh/basic/os.html)先将系统升级到最新版本，否则可能会遇到某些应用 和 API 无法使用的问题。
 
 如果没买 TF 卡，则需要将系统烧录进自备的 TF 卡中，烧录方法请看[升级和烧录系统](./basic/os.md)，然后再安装到板子。