系统安装

IP获取

• 方式一：

# 安装 net-tools
sudo apt-get install net-tools
# 查看IP
sudo ifconfig

• 方式二：

# 查看本机 IP
ip addr show

eth0 接口为网线 IP，wlan0 为 WiFi IP

WiFi配置

• 推荐使用图形化界面进行操作，这里也提供终端操作命令

# 查看 WiFi 设备名称
nmcli device status
# 关闭 WiFi
sudo nmcli radio wifi off
# 开启 WiFi
sudo nmcli radio wifi on
# 验证状态（enabled 表示开启，disabled 表示关闭）
nmcli radio wifi

• 输入 nmtui 进入网络配置的图形化界面
  

• 选择第二个选项
  

• 选择要连接的WiFi，WiFi最末尾的 * 号表示信号强度
  

• 输入密码，按下回车
  

• 对应WiFi前出现一个 * 号表示连接成功
  

• 按下 Esc 键，回退到主界面，选择第一个选项
  

• 如图所示的地方出现刚刚连接的 WiFi 名称，表示系统已将这个WiFi记住，下次开机后会自动尝试连接
  

• 回到终端，输入 ifconfig 命令，此时可以看到，WiFi 以获取到IP，并将真实的 MAC 地址显示出来了
  

• Ubuntu系统的操作与上述的操作一致，只是多了一个选项 Radio，用于开启或者关闭WiFi，需要使用 sudo nmtui 命令进入网络配置的图形化界面
  

SSH连接

• 目前赛昉官方提供两种以编译打包好镜像文件，Debian、Ubuntu
• Debian 的 SSH 默认打开，直接连接即可
• Ubuntu 的 SSH 默认关闭，需要手动进行启动
• 启动 SSH

sudo systemctl start ssh

• 检查 SSH 的状态，如果看到 active (running) 字样，说明 SSH 服务已成功启动。

sudo systemctl status ssh

• 设置开机自启

sudo systemctl enable ssh

• 使用 root 用户进行 SSH 连接；执行下面的命令，然后重启 SSH 服务，否则将一直无法连接上

# 运行命令
echo 'PermitRootLogin=yes'   | sudo tee -a /etc/ssh/sshd_config
# 重启SSH服务器
sudo systemctl restart ssh.service

安装必要软件包

• 某些软件包无法通过 apt/apt-get 下载，而是由StarFive apt 源提供：

Node.js 18.19.1
v8 10.2.154.13
libsdl2-dev 2.0-0
QT 5.15.13
Firefox 126.0.1-1
LibreOffice 4:24.2.7
NW.js 0.65.1
FFmpeg 7:6.1.1-3ubuntu5
GStreamer 1.24.2-1ubuntu0.1
v4l2test（这是一个用于使用CSI摄像头的自定义shell脚本）1.1-OK5

• 直接使用系统预设的脚本

cd /opt
sudo ./install_full.sh

• 安装 nano 编辑器

sudo apt update 
sudo apt install nano -y

CSI摄像头使用

• 目前仅支持 IMX219 感光芯片的摄像头
• 下面的命令为Debian、Ubuntu通用命令，Debian镜像的CSI操作还可以参考VisionFive2

识别摄像头

• 列出 libcamera 识别的摄像头

libcamera-hello --list-cameras

拍照

• 用 libcamera 工具捕获图像

libcamera-jpeg -o test.jpg
libcamera-jpeg -o test.jpg --nopreview  # 推荐使用

--nopreview 为禁用预览，避免出现 DRM 窗口崩溃问题

• 预览 5 秒，然后拍摄最后一帧图片

libcamera-still --output test.jpg --width 1920 --height 1080 --timeout 5000

• 查看照片

#安装 eog
sudo apt install eog
eog test.jpg

录像

• 录制 10 秒视频（保存为 H.264 格式）

libcamera-vid -o test.h264 -t 10000
libcamera-vid -o test.h264 -t 10000 --nopreview

--nopreview 禁用预览

• 播放视频：

# 安装 mpv
sudo apt install mpv
mpv test.h264  

实时显示摄像头画面

• 方法一

libcamera-still --output test.jpg --width 1920 --height 1080 --timeout 0
# 或
libcamera-still --output test.jpg --width 1920 --height 1080 --timeout 0 --nopreview false

• 方法二

libcamera-vid --width 1920 --height 1080 --timeout 0 --nopreview false

解除设备占用

• 在执行完成一次图像获取命令后，CSI设备可能继续被占用，或者短时间内没有被完全释放，会导致二次调用采集的图像出现问题
• 因此需要执行下面的命令后并等待一段时间后，二次执行

# 查找并杀死所有与 libcamera 相关的进程
sudo pkill -f "libcamera"
# 清除 libcamera 运行时缓存
rm -rf ~/.cache/libcamera/

GPIO使用

• GPIO引脚分布

• 使用方法与 VisionFive2 基本一致，这里提供一个通过命令行操作GPIO的方式
• 本命令使用的用户为普通用户，以GPIO55脚为例

# 导出 GPIO55 引脚
echo 55 | sudo tee /sys/class/gpio/export > /dev/null
# 设置为输出模式
echo out | sudo tee /sys/class/gpio/gpio55/direction > /dev/null
# 输出高电平
echo 1 | sudo tee /sys/class/gpio/gpio55/value > /dev/null
# 输出低电平
echo 0 | sudo tee /sys/class/gpio/gpio55/value > /dev/null
# 取消导出
echo 55 | sudo tee /sys/class/gpio/unexport > /dev/null

# 设置为输入模式
echo in | sudo tee /sys/class/gpio/gpio55/direction > /dev/null
# 读取输入值
cat /sys/class/gpio/gpio55/value

资料

原理图

• VisionFive2 Lite原理图

官方资料/论坛地址

• 英文资料地址
  
• 中文资料地址
  
• 英文论坛地址
  
• 中文论坛地址
  

SDK

GitHub链接（外网）

• StarFiveTech VisionFive2 SDK

Debian 镜像

• 官方最新镜像

Ubuntu 镜像

• 百度网盘
• GitHub（最新）

开发软件

• SDFormatter
• Win32DiskImager
• MobaXterm

更新Flash

• 板载Flash固件更新