ArmSoM-Sige RK3588开发板使用手册

Sige7 使用手册，帮助用户了解Sige7的基本使用和需要的准备工作。当您拿到产品的时候，您需要知道它的型号以及硬件版本，这些信息都可以在板子上的丝印找到。我们会尽可能详细地向您介绍产品的信息。

入门准备

在开始使用 ArmSoM-Sige7 之前，请准备好以下物品

工具准备

Sige7 主板
电源: USB Type-C PD
- 支持 9V/2A, 12V/2A, 15V/2A
系统安装（二选一）
- MicroSD卡/TF卡启动
  - MicroSD卡/TF卡，Class 10或以上至少8GB SDHC 和读卡器
  - 以下是经过ArmSoM团队测试验证的高速TF卡
    - SanDisk 32GB TF（MicroSD）（开发者推荐）
    - SanDisk 32GB TF（MicroSD）行车记录仪&安防监控专用存储卡（长期运行推荐）
    - 闪迪 TF 8G Class10 microSD
    - 闪迪 TF 128G Class10 microSD XC TF 128G 48MB/S：
- 板载eMMC启动
  - USB Type-C数据线，从 typec 端口在 Sige7 上写入镜像，您需要 Type-C 数据线连接 Sige7 和 PC。

可选选项

USB 键盘鼠标
HDMI显示器和HDMI线
- Sige7配备了全尺寸 HDMI 接口，最高支持 8K@60 显示。
- HDMI EDID用于确定最佳显示分辨率。在支持 1080p（或 4K/8K）的显示器和电视上，将选择此分辨率。如果不支持 1080p，EDID会找到的下一个可用分辨率。
Ethernet 线（网线）
- Sige7 支持以太网上网，最高支持2.5Gb。
- 网线用于将 Sige7 连接到本地网络和互联网。
摄像头模块
- Sige7 支持拍照功能。
- 推荐使用imx415模组，可找ArmSoM官方店淘宝客服购买。
LCD显示屏
- Sige7 支持LCD显示功能。
- 推荐使用 ArmSoM Display 10.1 HD，可找ArmSoM官方店淘宝客服购买。
音频线
- 可以使用0.8mm立式插座。
USB-A型转USB-C型数据线

烧录方式选择

系统镜像烧录

接口设置

如果您是首次使用 ArmSoM-Sige7，请先熟悉下外设接口，以便于您更好的理解后续的内容。

调试串口

如下所示连接 USB 转 TTL 串口线：

armsom-sige7-debug

Sige7	连接	串口模块
GND (pin 6)	<--->	GND
TX (pin 8)	<--->	RX
RX (pin 10)	<--->	TX

2.5G 以太网口

如果您使用的是以太网有线上网方式，请将网线对准 ArmSoM-Sige7 上的 RJ45 端口插入，系统桌面就会弹出有线连接。

通过命令 ifconfig 检查以太网是否正常，它会显示网卡 enP2p33s0 或 enP4p65s0 以及以太网 IP 地址。此外，使用工具 ping 判断是否连通网络。

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34"><span style="color:#d73a49">ifconfig</span>
</span><span style="color:#393a34"><span style="color:#d73a49">ping</span> mi.com
</span></code></span></span></span>

如果无法ping通，尝试

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">$ <span style="color:#d73a49">sudo</span> dhclient enP2p33s0
</span><span style="color:#393a34">or
</span><span style="color:#393a34">$ <span style="color:#d73a49">sudo</span> dhclient enP4p65s0
</span></code></span></span></span>

WIFI

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34"># 1. Open the WIFI
</span><span style="color:#393a34">armsom@armsom-sige7:/# nmcli r wifi on
</span><span style="color:#393a34"># 2. Scan WIFI
</span><span style="color:#393a34">armsom@armsom-sige7:/# nmcli dev wifi
</span><span style="color:#393a34"># 3. Connect to WIFI network
</span><span style="color:#393a34">armsom@armsom-sige7:/# nmcli dev wifi connect "wifi_name" password "wifi_password"
</span></code></span></span></span>

BT

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34"># 1. 激活蓝牙
</span><span style="color:#393a34">armsom@armsom-sige7:/# service bluetooth start
</span><span style="color:#393a34"># 2. 进入bluetoothctl
</span><span style="color:#393a34">armsom@armsom-sige7:/# bluetoothctl
</span><span style="color:#393a34"># 3. 输入以下命令即可连接
</span><span style="color:#393a34">armsom@armsom-sige7:/# power on
</span><span style="color:#393a34">armsom@armsom-sige7:/# agent on
</span><span style="color:#393a34">armsom@armsom-sige7:/# default-agent
</span><span style="color:#393a34">armsom@armsom-sige7:/# scan on
</span><span style="color:#393a34">armsom@armsom-sige7:/# pair yourDeviceMAC
</span></code></span></span></span>

HDMI

ArmSoM-Sige7 有HDMI 输出端口，支持 CEC 和 HDMI 2.1，分辨率最高支持 8Kp60。

USB接口

ArmSoM-Sige7 提供一个 USB 2.0 和一个 USB 3.0 端口。

USB3.0 Camera

连接usb3.0摄像头后，您可以下载 cheese 然后使用以下命令使用摄像机:

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7: <span style="color:#d73a49">sudo</span> <span style="color:#d73a49">apt</span> update
</span><span style="color:#393a34">armsom@armsom-sige7: <span style="color:#d73a49">sudo</span> <span style="color:#d73a49">apt</span> <span style="color:#d73a49">install</span> cheese
</span></code></span></span></span>

同时，您也可以使用终端命令打开相机预览:

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">gst-launch-1.0 v4l2src <span style="color:#36acaa">device</span><span style="color:#393a34">=</span>/dev/video0 io-mode<span style="color:#393a34">=</span><span style="color:#36acaa">4</span> <span style="color:#393a34">!</span> videoconvert <span style="color:#393a34">!</span> video/x-raw,format<span style="color:#393a34">=</span>NV12,width<span style="color:#393a34">=</span><span style="color:#36acaa">1920</span>,height<span style="color:#393a34">=</span><span style="color:#36acaa">1080</span> <span style="color:#393a34">!</span> xvimagesink<span style="color:#393a34">;</span>
</span></code></span></span></span>

命令拍照:

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">gst-launch-1.0 v4l2src <span style="color:#36acaa">device</span><span style="color:#393a34">=</span>/dev/video0 io-mode<span style="color:#393a34">=</span><span style="color:#36acaa">4</span> <span style="color:#393a34">!</span> videoconvert <span style="color:#393a34">!</span> video/x-raw,format<span style="color:#393a34">=</span>NV12,width<span style="color:#393a34">=</span><span style="color:#36acaa">1920</span>,height<span style="color:#393a34">=</span><span style="color:#36acaa">1080</span> <span style="color:#393a34">!</span> jpegenc <span style="color:#393a34">!</span> multifilesink <span style="color:#36acaa">location</span><span style="color:#393a34">=</span>/home/armsom/test.jpg<span style="color:#393a34">;</span>
</span></code></span></span></span>

命令拍摄视频:

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">gst-launch-1.0 v4l2src num-buffers<span style="color:#393a34">=</span><span style="color:#36acaa">512</span> <span style="color:#36acaa">device</span><span style="color:#393a34">=</span>/dev/video0 io-mode<span style="color:#393a34">=</span><span style="color:#36acaa">4</span> <span style="color:#393a34">!</span> videoconvert <span style="color:#393a34">!</span> video/x-raw, <span style="color:#36acaa">format</span><span style="color:#393a34">=</span>NV12, <span style="color:#36acaa">width</span><span style="color:#393a34">=</span><span style="color:#36acaa">1920</span>, <span style="color:#36acaa">height</span><span style="color:#393a34">=</span><span style="color:#36acaa">1080</span>, <span style="color:#36acaa">framerate</span><span style="color:#393a34">=</span><span style="color:#36acaa">30</span>/1 <span style="color:#393a34">!</span> <span style="color:#d73a49">tee</span> <span style="color:#36acaa">name</span><span style="color:#393a34">=</span>t <span style="color:#393a34">!</span> queue <span style="color:#393a34">!</span> mpph264enc <span style="color:#393a34">!</span> queue <span style="color:#393a34">!</span> h264parse <span style="color:#393a34">!</span> mpegtsmux <span style="color:#393a34">!</span> filesink <span style="color:#36acaa">location</span><span style="color:#393a34">=</span>/home/armsom/test.mp4
</span></code></span></span></span>

armsom-sige7-gst

音频

查看系统中的声卡。

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># aplay -l</em></span>
</span><span style="color:#393a34">**** List of PLAYBACK Hardware Devices ****
</span><span style="color:#393a34">card <span style="color:#36acaa">0</span>: rockchipdp0 <span style="color:#393a34">[</span>rockchip,dp0<span style="color:#393a34">]</span>, device <span style="color:#36acaa">0</span>: rockchip,dp0 spdif-hifi-0 <span style="color:#393a34">[</span>rockchip,dp0 spdif-hifi-0<span style="color:#393a34">]</span>
</span><span style="color:#393a34"> Subdevices: <span style="color:#36acaa">1</span>/1
</span><span style="color:#393a34"> Subdevice <span style="color:#999988"><em>#0: subdevice #0</em></span>
</span><span style="color:#393a34">card <span style="color:#36acaa">1</span>: rockchipes8316 <span style="color:#393a34">[</span>rockchip-es8316<span style="color:#393a34">]</span>, device <span style="color:#36acaa">0</span>: fe470000.i2s-ES8316 HiFi es8316.7-0011-0 <span style="color:#393a34">[</span>fe470000.i2s-ES8316 HiFi es8316.7-0011-0<span style="color:#393a34">]</span>
</span><span style="color:#393a34">  Subdevices: <span style="color:#36acaa">1</span>/1
</span><span style="color:#393a34">  Subdevice <span style="color:#999988"><em>#0: subdevice #0</em></span>
</span><span style="color:#393a34">card <span style="color:#36acaa">2</span>: rockchiphdmi0 <span style="color:#393a34">[</span>rockchip-hdmi0<span style="color:#393a34">]</span>, device <span style="color:#36acaa">0</span>: rockchip-hdmi0 i2s-hifi-0 <span style="color:#393a34">[</span>rockchip-hdmi0 i2s-hifi-0<span style="color:#393a34">]</span>
</span><span style="color:#393a34">  Subdevices: <span style="color:#36acaa">1</span>/1
</span><span style="color:#393a34">  Subdevice <span style="color:#999988"><em>#0: subdevice #0</em></span>
</span></code></span></span></span>

风扇

Sige7 配备一个 5V 的风扇，使用 0.8mm 的连接器

目前风扇默认五个状态

温度	状态	PWM转速
小于50°	0	0
50°-55°	1	50
55°-60°	2	100
60°-65°	3	150
65°-70°	4	200
70°以上	5	250

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">// 查看当前转速 
</span><span style="color:#393a34">armsom@armsom-sige7:/# cat /sys/class/hwmon/hwmon9/pwm1
</span></code></span></span></span>

Type-C

Sige7 配备全功能 USB Type‑C™ 3.1 端口，支持高达 4Kp60 的 DP 显示

40Pin

Sige7 提供了一个40pin针脚的GPIO座子，兼容于市面上大部分传感器的应用。

RGB LED

Sige7 具有两个用户灯 LED 绿灯和红灯。

用户绿灯默认情况下，其常亮表示系统运行正常。
用户红灯默认情况下不亮，可由用户自行操控。

用户可通过命令控制

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/# sudo su
</span><span style="color:#393a34">armsom@armsom-sige7:/# echo timer > /sys/class/leds/red/trigger
</span><span style="color:#393a34">armsom@armsom-sige7:/# echo activity > /sys/class/leds/red/trigger
</span></code></span></span></span>

RTC

Sige7配备了一颗RTC IC hym8563。
首先，使用2pin的排针接口，插入RTC电池给RTC IC供电。
请注意，我们应该将 RTC 电池保留在 RTC 连接器中，并确认 rtc hym8563 设备已创建

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em>#  dmesg | grep rtc</em></span>
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">6.407133</span><span style="color:#393a34">]</span> rtc-hym8563 <span style="color:#36acaa">6</span>-0051: rtc information is valid
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">6.412731</span><span style="color:#393a34">]</span> rtc-hym8563 <span style="color:#36acaa">6</span>-0051: registered as rtc0
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">6.413779</span><span style="color:#393a34">]</span> rtc-hym8563 <span style="color:#36acaa">6</span>-0051: setting system clock to <span style="color:#36acaa">2022</span>-06-22T01:22:26 UTC <span style="color:#393a34">(</span><span style="color:#36acaa">1655860946</span><span style="color:#393a34">)</span>
</span></code></span></span></span>

找到rtc0，然后使用以下命令设置系统时间并同步到rtc0。

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># hwclock -r</em></span>
</span><span style="color:#393a34"><span style="color:#36acaa">2023</span>-11-03 <span style="color:#36acaa">10</span>:32:40.461910+00:00
</span><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># date</em></span>
</span><span style="color:#393a34"><span style="color:#36acaa">2023</span>年 <span style="color:#36acaa">11</span>月 03日 星期五 <span style="color:#36acaa">10</span>:33:12 UTC
</span><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># hwclock -w</em></span>
</span><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># hwclock -r</em></span>
</span><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># poweroff</em></span>
</span></code></span></span></span>

关闭RTC电池，10分钟或更长时间后，插入RTC电池并启动Sige7，检查RTC是否与系统时钟同步

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># hwclock -r</em></span>
</span><span style="color:#393a34"><span style="color:#36acaa">2023</span>-11-03 <span style="color:#36acaa">10</span>:35:40.461910+00:00
</span><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># date</em></span>
</span><span style="color:#393a34"><span style="color:#36acaa">2023</span>年 <span style="color:#36acaa">11</span>月 03日 星期五 <span style="color:#36acaa">10</span>:36:01 UTC
</span></code></span></span></span>

M.2接口

ArmSoM-Sige7 提供 M.2 连接器：

产品的背面有一个带有四通道 PCIe 3.0 接口的 M.2 M Key 连接器。板上有一个标准的 M.2 2280 安装孔，可以部署 M.2 2280 NVMe SSD。
注意：该 M.2 接口不支持 M.2 SATA SSD。

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/# mkdir temp
</span><span style="color:#393a34">armsom@armsom-sige7:/# mount /dev/nvme0n1 temp
</span></code></span></span></span>

摄像头

MIPI-CSI

摄像头采用IMX415模组，摄像头模组连接并上电后可以查看启动日志。

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">armsom@armsom-sige7:/<span style="color:#999988"><em># dmesg | grep imx415</em></span>
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547754</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: driver version: 00.01.08
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547767</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a:  Get hdr mode failed<span style="color:#393a34">!</span> no hdr default
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547819</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: Failed to get power-gpios
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547826</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: could not get default pinstate
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547831</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: could not get <span style="color:#d73a49">sleep</span> pinstate
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547850</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: supply dvdd not found, using dummy regulator
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547918</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: supply dovdd not found, using dummy regulator
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.547945</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: supply avdd not found, using dummy regulator
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.613843</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: Detected imx415 <span style="color:#d73a49">id</span> 0000e0
</span><span style="color:#393a34"><span style="color:#393a34">[</span>    <span style="color:#36acaa">2.613890</span><span style="color:#393a34">]</span> rockchip-csi2-dphy csi2-dphy0: dphy0 matches m00_b_imx415 <span style="color:#36acaa">3</span>-001a:bus type <span style="color:#36acaa">5</span>
</span><span style="color:#393a34"><span style="color:#393a34">[</span>   <span style="color:#36acaa">18.386174</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: set fmt: cur_mode: 3864x2192, hdr: <span style="color:#36acaa">0</span>
</span><span style="color:#393a34"><span style="color:#393a34">[</span>   <span style="color:#36acaa">18.389067</span><span style="color:#393a34">]</span> imx415 <span style="color:#36acaa">3</span>-001a: set exposure<span style="color:#393a34">(</span>shr0<span style="color:#393a34">)</span> <span style="color:#36acaa">2047</span> <span style="color:#393a34">=</span> cur_vts<span style="color:#393a34">(</span><span style="color:#36acaa">2250</span><span style="color:#393a34">)</span> - val<span style="color:#393a34">(</span><span style="color:#36acaa">203</span><span style="color:#393a34">)</span>
</span></code></span></span></span>

使用v4l2-ctl进行抓图

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">// MIPI-CSI1
</span><span style="color:#393a34">armsom@armsom-sige7:/# v4l2-ctl -d /dev/video31 --set-fmt-video=width=3840,height=2160,pixelformat=NV12 --stream-mmap=3 --stream-skip=60 --stream-to=/tmp/cif73.out --stream-count=3 --stream-poll
</span>
<span style="color:#393a34">// MIPI-CSI2
</span><span style="color:#393a34">armsom@armsom-sige7:/# v4l2-ctl -d /dev/video22 --set-fmt-video=width=3840,height=2160,pixelformat=NV12 --stream-mmap=3 --stream-skip=60 --stream-to=/tmp/cif73.out --stream-count=3 --stream-poll
</span></code></span></span></span>

使用gst-launch-1.0可直接录像

<span style="color:var(--prism-color)"><span style="background-color:var(--ifm-pre-background)"><span style="color:var(--ifm-pre-color)"><code><span style="color:#393a34">// MIPI-CSI1
</span><span style="color:#393a34">armsom@armsom-sige7:/# gst-launch-1.0 v4l2src device=/dev/video31 ! video/x-raw,format=NV12,width=3840,height=2160, framerate=30/1 ! xvimagesink
</span>
<span style="color:#393a34">// MIPI-CSI2
</span><span style="color:#393a34">armsom@armsom-sige7:/# gst-launch-1.0 v4l2src device=/dev/video22 ! video/x-raw,format=NV12,width=3840,height=2160, framerate=30/1 ! xvimagesink
</span></code></span></span></span>

armsom-w3-imx415-camera