Merge pull request #610 from 0x754C/main

update licheervnano doc

docs/hardware/zh/lichee/RV_Nano/3_images.md

@@ -0,0 +1,20 @@
+---
+title: LicheeRV Nano Image
+keywords: riscv, licheerv,nano
+update:
+  - date: 2024-1-26
+    version: v0.1
+    author: 0x754C
+---
+
+## 镜像格式
+
+镜像使用xz进行压缩，解压后使用rufs/win32diskimager/dd工具写入到SD卡
+
+## 基于官方SDK的镜像
+
+[下载地址](https://github.com/sipeed/LicheeRV-Nano-Build/releases)
+
+## 基于主线buildroot sdk的镜像 (WORK-IN-PROGRESS)
+
+[下载地址](https://github.com/0x754C/sipeed-toolchain/releases)

docs/hardware/zh/lichee/RV_Nano/4_burn_image.md

@@ -0,0 +1,32 @@
+---
+title: LicheeRV Nano Burn Image
+keywords: riscv, licheerv,nano
+update:
+  - date: 2024-1-26
+    version: v0.1
+    author: 0x754C
+---
+
+## 镜像格式
+
+镜像使用xz进行压缩，解压后使用rufs/win32diskimager/dd工具写入到SD卡
+
+## Linux
+
+```
+curl -O https://github.com/sipeed/LicheeRV-Nano-Build/releases/download/20240124/licheervnano-20230124.img.xz
+# 将sdX替换为SD卡的节点
+xzcat https://github.com/sipeed/LicheeRV-Nano-Build/releases/download/20240124/licheervnano-20230124.img.xz | dd of=/dev/sdX conv=sync
+```
+
+## Windows
+
+使用7zip工具进行解压:
+
+https://www.7-zip.org/download.html
+
+使用 rufs/win32diskiamger 写入到SD卡
+
+https://rufus.ie/
+
+https://sourceforge.net/projects/win32diskimager/

docs/hardware/zh/lichee/RV_Nano/5_peripheral.md

@@ -0,0 +1,198 @@
+---
+title: LicheeRV Nano Peri Use
+keywords: riscv, licheerv,nano
+update:
+  - date: 2024-1-26
+    version: v0.1
+    author: 0x754C
+---
+
+## 连接到板子
+
+### UART0
+
+将UART串口连接到板子的:
+
+A17 A16 GND
+
+然后使用终端软件连接串口，波特率115200
+
+
+### usb cdc acm 串口
+
+将板子的usb typec口连接到电脑时会提供一个usb cdc acm串口设备(linux gadget 提供)
+
+Linux:
+
+```
+# 将/dev/ttyACMX替换为具体的设备，取决于你的电脑
+picoco -b 9600 /dev/ttyACMX
+```
+
+Windows:
+
+Win + R devmgmt.msc 回车
+
+在串口设备处找到新的设备的串口号
+
+然后使用putty或超级终端进行连接
+
+### usb rndis 网口
+
+将板子的usb typec口连接到电脑时会提供一个usb rndis网卡设备(linux gadget 提供)
+
+PC会使用DHCP自动获取地址
+
+将自动获取的IPv4地址最后一位换成1即是板子的IPv4地址:
+
+```
+10.44.55.66 PC机的IPv4地址
+10.44.55.1  板子的IPv4地址
+```
+
+然后使用 ssh root@板子的IP地址进行连接:
+
+用户名: root
+密码:   cvitek
+
+
+### 网线连接
+
+将网线连接到板子，板子开机时会使用DHCP自动获取地址
+
+板子镜像默认启用了MDNS服务
+
+使用命令:
+
+```
+avahi-browse -art | grep lpirvnano
+```
+
+列出广播域中域名带有的lpirvnano的设备
+
+
+
+然后使用:
+
+```
+ssh root@lpirvnano-XXXX.local
+```
+
+连接板子
+
+
+## 关闭镜像的的开机DEMO
+
+```
+# 清空rc.local
+echo '#!/bin/sh' > /etc/rc.local
+# 重启
+reboot
+```
+
+## LCD
+
+将屏幕的排线接到板子的MIPI接口，注意线序
+
+编辑板子上的/opt/fb_load.sh，将具体型号的初始化命令的注释去掉
+
+然后执行:
+
+```
+/opt/fb_load.sh # 初始化屏幕驱动
+devmem # 测试彩条
+```
+
+测试是否可用，如果可用，可以加入到开机脚本:
+
+```
+echo /opt/fb_load.sh >> /etc/rc.local
+```
+
+LCD会提供framebuffer供用户空间程序访问
+
+建议使用QT5，SDL1.2，或LVGL进行界面开发，也可以直接写入Framebuffer
+
+直接写入framebuffer可以参考板子文件系统内的/opt/src/vendortest
+
+## 触摸屏
+
+将触摸屏排线接到板子的触摸屏接口，注意线序
+
+然后执行:
+
+```
+/opt/touch.sh # 加载触摸屏驱动
+```
+
+然后执行:
+
+```
+echo 2 | evtest
+```
+
+点击触摸屏会在终端看到具体坐标
+
+读取坐标和点击事件可以参考/opt/src/vendortest里面的输入部分
+
+## WIFI
+
+将天线安装到WIFI模块的天线座子上
+
+然后将AP的SSID和密码写入 /etc/wpa_supplicant.conf 文件:
+
+```
+network={
+        ssid="ssid"
+   		psk="password"
+}
+```
+
+然后执行:
+
+```
+/opt/wifi.sh
+```
+
+验证网络是否可用:
+
+```
+ping 你的网关地址
+```
+
+如果可用，可以加入到开机脚本:
+
+```
+echo '/opt/wifi.sh' >> /etc/rc.local
+```
+
+## 摄像头
+
+将摄像头安装到摄像头座子，注意线序
+
+然后执行:
+
+```
+/opt/camera.sh 0
+
+echo "
+1
+0
+1
+255" | sensor_test # 捕获一张图片，保存在当前目录
+```
+
+## 按键
+
+使用命令查看按键事件:
+
+```
+echo 1 | evtest
+```
+
+然后按下USER按键，可以在终端看到对应的事件报告
+
+
+## HelloWorld
+
+https://github.com/sipeed/LicheeRV-Nano-Build/blob/v4.1.0/build/boards/cv181x/cv1812cp_licheerv_nano_sd/readme.md#compile-program-use-vendors-toolchain