Skip to content

Commit 31b404a

Browse files
committed
docs: update libcamera installation to use Debian official packaging repository
- Changed libcamera compilation from git.linuxtv.org to Debian official packaging repository (https://salsa.debian.org/multimedia-team/libcamera) debian/0.4.0-7 branch - Updated camera startup examples to use GStreamer with libcamera element -> autovideosink element - Affected files: - docs/dragon/q6a/accessories/camera-12m-577.md - docs/dragon/q6a/accessories/camera-8m-219.md - docs/dragon/q6a/accessories/camera-4k.md - docs/dragon/q6a/accessories/camera-13m-214.md - Corresponding English versions in i18n/en/ directory
1 parent e26a26c commit 31b404a

File tree

8 files changed

+299
-152
lines changed

8 files changed

+299
-152
lines changed

docs/dragon/q6a/accessories/camera-12m-577.md

Lines changed: 38 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -42,24 +42,31 @@ sudo apt install \
4242

4343
</NewCodeBlock>
4444

45-
### 编译安装 libcamera
45+
### 使用 Debian 官方打包仓库自打包安装 libcamera
4646

4747
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
4848

4949
```bash
50-
git clone https://git.linuxtv.org/libcamera.git
50+
# 安装构建依赖
51+
sudo apt update
52+
sudo apt install -y devscripts build-essential debhelper dh-make quilt git
53+
54+
# 克隆 Debian 官方 libcamera 仓库
55+
git clone https://salsa.debian.org/multimedia-team/libcamera.git
5156
cd libcamera
52-
git checkout 02277d4c1a5ae7fee582f635936877435a12db64 # Optional. The following test steps are based on this version of libcamera.
53-
meson setup build --wipe \
54-
-Dpipelines=simple \
55-
-Dcam=enabled \
56-
-Dgstreamer=disabled \
57-
-Dv4l2=enabled \
58-
-Dlc-compliance=disabled \
59-
-Dqcam=enabled
60-
ninja -C build -j$(nproc)
61-
sudo ninja -C build install
62-
sudo ldconfig
57+
58+
# 切换到 debian/0.4.0-7 分支
59+
git checkout debian/0.4.0-7
60+
61+
# 安装构建依赖
62+
sudo mk-build-deps --install --remove debian/control
63+
64+
# 构建 deb 包
65+
dpkg-buildpackage -us -uc -b
66+
67+
# 安装构建的 deb 包
68+
cd ..
69+
sudo dpkg -i libcamera*.deb libcamera-dev*.deb libcamera-tools*.deb || sudo apt-get install -f -y
6370
```
6471

6572
</NewCodeBlock>
@@ -74,15 +81,29 @@ sudo chmod 666 /dev/dma_heap/*
7481

7582
</NewCodeBlock>
7683

77-
### 启动摄像头
84+
### 启动摄像头(使用 GStreamer)
85+
86+
使用 GStreamer 管道启动摄像头,使用 libcamera 元素 -> autovideosink 元素:
87+
88+
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
89+
90+
```bash
91+
# 安装 GStreamer 相关包
92+
sudo apt install -y gstreamer1.0-tools gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly
93+
94+
# 启动摄像头预览
95+
gst-launch-1.0 libcamerasrc ! autovideosink
96+
```
97+
98+
</NewCodeBlock>
7899

79-
打开系统桌面终端,进入 libcamera 的 build 目录,启动 qcam。
100+
如果要指定摄像头参数,可以使用:
80101

81102
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
82103

83104
```bash
84-
cd libcamera/build/src/apps/qcam/
85-
./qcam --stream pixelformat=YUYV,width=1920,height=1080
105+
# 指定分辨率、帧率等参数
106+
gst-launch-1.0 libcamerasrc ! video/x-raw,width=1920,height=1080,framerate=30/1 ! autovideosink
86107
```
87108

88109
</NewCodeBlock>

docs/dragon/q6a/accessories/camera-13m-214.md

Lines changed: 38 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -42,24 +42,31 @@ sudo apt install \
4242

4343
</NewCodeBlock>
4444

45-
### 编译安装 libcamera
45+
### 使用 Debian 官方打包仓库自打包安装 libcamera
4646

4747
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
4848

4949
```bash
50-
git clone https://git.linuxtv.org/libcamera.git
50+
# 安装构建依赖
51+
sudo apt update
52+
sudo apt install -y devscripts build-essential debhelper dh-make quilt git
53+
54+
# 克隆 Debian 官方 libcamera 仓库
55+
git clone https://salsa.debian.org/multimedia-team/libcamera.git
5156
cd libcamera
52-
git checkout 02277d4c1a5ae7fee582f635936877435a12db64 # Optional. The following test steps are based on this version of libcamera.
53-
meson setup build --wipe \
54-
-Dpipelines=simple \
55-
-Dcam=enabled \
56-
-Dgstreamer=disabled \
57-
-Dv4l2=enabled \
58-
-Dlc-compliance=disabled \
59-
-Dqcam=enabled
60-
ninja -C build -j$(nproc)
61-
sudo ninja -C build install
62-
sudo ldconfig
57+
58+
# 切换到 debian/0.4.0-7 分支
59+
git checkout debian/0.4.0-7
60+
61+
# 安装构建依赖
62+
sudo mk-build-deps --install --remove debian/control
63+
64+
# 构建 deb 包
65+
dpkg-buildpackage -us -uc -b
66+
67+
# 安装构建的 deb 包
68+
cd ..
69+
sudo dpkg -i libcamera*.deb libcamera-dev*.deb libcamera-tools*.deb || sudo apt-get install -f -y
6370
```
6471

6572
</NewCodeBlock>
@@ -74,15 +81,29 @@ sudo chmod 666 /dev/dma_heap/*
7481

7582
</NewCodeBlock>
7683

77-
### 启动摄像头
84+
### 启动摄像头(使用 GStreamer)
85+
86+
使用 GStreamer 管道启动摄像头,使用 libcamera 元素 -> autovideosink 元素:
87+
88+
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
89+
90+
```bash
91+
# 安装 GStreamer 相关包
92+
sudo apt install -y gstreamer1.0-tools gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly
93+
94+
# 启动摄像头预览
95+
gst-launch-1.0 libcamerasrc ! autovideosink
96+
```
97+
98+
</NewCodeBlock>
7899

79-
打开系统桌面终端,进入 libcamera 的 build 目录,启动 qcam。
100+
如果要指定摄像头参数,可以使用:
80101

81102
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
82103

83104
```bash
84-
cd libcamera/build/src/apps/qcam/
85-
./qcam --stream pixelformat=YUYV,width=1920,height=1080
105+
# 指定分辨率、帧率等参数
106+
gst-launch-1.0 libcamerasrc ! video/x-raw,width=1920,height=1080,framerate=30/1 ! autovideosink
86107
```
87108

88109
</NewCodeBlock>

docs/dragon/q6a/accessories/camera-4k.md

Lines changed: 19 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -42,47 +42,41 @@ sudo apt install \
4242

4343
</NewCodeBlock>
4444

45-
### 编译安装 libcamera
45+
### 使用 Debian 官方打包仓库自打包安装 libcamera
4646

4747
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
4848

4949
```bash
50-
git clone https://git.linuxtv.org/libcamera.git
50+
# 安装构建依赖
51+
sudo apt update
52+
sudo apt install -y devscripts build-essential debhelper dh-make quilt git
53+
54+
# 克隆 Debian 官方 libcamera 仓库
55+
git clone https://salsa.debian.org/multimedia-team/libcamera.git
5156
cd libcamera
52-
git checkout 02277d4c1a5ae7fee582f635936877435a12db64 # Optional. The following test steps are based on this version of libcamera.
53-
meson setup build --wipe \
54-
-Dpipelines=simple \
55-
-Dcam=enabled \
56-
-Dgstreamer=disabled \
57-
-Dv4l2=enabled \
58-
-Dlc-compliance=disabled \
59-
-Dqcam=enabled
60-
ninja -C build -j$(nproc)
61-
sudo ninja -C build install
62-
sudo ldconfig
63-
```
6457

65-
</NewCodeBlock>
58+
# 切换到 debian/0.4.0-7 分支
59+
git checkout debian/0.4.0-7
6660

67-
### 设置权限
61+
# 安装构建依赖
62+
sudo mk-build-deps --install --remove debian/control
6863

69-
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
64+
# 构建 deb 包
65+
dpkg-buildpackage -us -uc -b
7066

71-
```bash
72-
sudo chmod 666 /dev/dma_heap/*
67+
# 安装构建的 deb 包
68+
cd ..
69+
sudo dpkg -i libcamera*.deb libcamera-dev*.deb libcamera-tools*.deb || sudo apt-get install -f -y
7370
```
7471

7572
</NewCodeBlock>
7673

77-
### 启动摄像头
78-
79-
打开系统桌面终端,进入 libcamera 的 build 目录,启动 qcam。
74+
### 设置权限
8075

8176
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
8277

8378
```bash
84-
cd libcamera/build/src/apps/qcam/
85-
./qcam --stream pixelformat=YUYV,width=1920,height=1080
79+
sudo chmod 666 /dev/dma_heap/*
8680
```
8781

88-
</NewCodeBlock>
82+

docs/dragon/q6a/accessories/camera-8m-219.md

Lines changed: 45 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -42,42 +42,52 @@ sudo apt install \
4242

4343
</NewCodeBlock>
4444

45-
### 编译安装 libcamera
45+
### 使用 Debian 官方打包仓库自打包安装 libcamera
4646

4747
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
4848

4949
```bash
50-
git clone https://git.linuxtv.org/libcamera.git
50+
# 安装构建依赖
51+
sudo apt update
52+
sudo apt install -y devscripts build-essential debhelper dh-make quilt git
53+
54+
# 克隆 Debian 官方 libcamera 仓库
55+
git clone https://salsa.debian.org/multimedia-team/libcamera.git
5156
cd libcamera
52-
git checkout 02277d4c1a5ae7fee582f635936877435a12db64 # Optional. The following test steps are based on this version of libcamera.
53-
meson setup build --wipe \
54-
-Dpipelines=simple \
55-
-Dcam=enabled \
56-
-Dgstreamer=disabled \
57-
-Dv4l2=enabled \
58-
-Dlc-compliance=disabled \
59-
-Dqcam=enabled
60-
ninja -C build -j$(nproc)
61-
sudo ninja -C build install
62-
sudo ldconfig
57+
58+
# 切换到 debian/0.4.0-7 分支
59+
git checkout debian/0.4.0-7
60+
61+
# 安装构建依赖
62+
sudo mk-build-deps --install --remove debian/control
63+
64+
# 构建 deb 包
65+
dpkg-buildpackage -us -uc -b
66+
67+
# 安装构建的 deb 包
68+
cd ..
69+
sudo dpkg -i libcamera*.deb libcamera-dev*.deb libcamera-tools*.deb || sudo apt-get install -f -y
6370
```
6471

6572
</NewCodeBlock>
6673

6774
### 修改配置文件
6875

69-
进入 `libcamera` 目录,修改 `libcamera/src/ipa/simple/data/imx219.yaml`文件。
76+
由于使用 Debian 打包的 libcamera,配置文件路径可能不同。如果需要修改配置文件:
7077

7178
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
7279

7380
```bash
74-
cd libcamera
75-
sudo nano src/ipa/simple/data/imx219.yaml
81+
# 查找 libcamera 配置文件位置
82+
find /usr -name "imx219.yaml" -type f 2>/dev/null
83+
84+
# 如果找到配置文件,可以编辑它
85+
# sudo nano /找到的路径/imx219.yaml
7686
```
7787

7888
</NewCodeBlock>
7989

80-
将下面内容复制到 `src/ipa/simple/data/imx219.yaml`文件。
90+
将下面内容复制到相应的配置文件中(如果需要):
8191

8292
```bash
8393
# SPDX-License-Identifier: CC0-1.0
@@ -117,15 +127,29 @@ sudo chmod 666 /dev/dma_heap/*
117127

118128
</NewCodeBlock>
119129

120-
### 启动摄像头
130+
### 启动摄像头(使用 GStreamer)
131+
132+
使用 GStreamer 管道启动摄像头,使用 libcamera 元素 -> autovideosink 元素:
133+
134+
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
135+
136+
```bash
137+
# 安装 GStreamer 相关包
138+
sudo apt install -y gstreamer1.0-tools gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly
139+
140+
# 启动摄像头预览
141+
gst-launch-1.0 libcamerasrc ! autovideosink
142+
```
143+
144+
</NewCodeBlock>
121145

122-
打开系统桌面终端,进入 libcamera 的 build 目录,启动 qcam。
146+
如果要指定摄像头参数,可以使用:
123147

124148
<NewCodeBlock tip='radxa@dragon-q6a$' type="device">
125149

126150
```bash
127-
cd libcamera/build/src/apps/qcam/
128-
./qcam --stream pixelformat=YUYV,width=1920,height=1080
151+
# 指定分辨率、帧率等参数
152+
gst-launch-1.0 libcamerasrc ! video/x-raw,width=1920,height=1080,framerate=30/1 ! autovideosink
129153
```
130154

131155
</NewCodeBlock>

0 commit comments

Comments
 (0)