Add RTSP deployment infrastructure and documentation
- Add .gitignore to exclude build artifacts and mediamtx binary - Add deploy-rtsp.sh script for automated MediaMTX setup - Add mediamtx.yml configuration with detailed comments - Update README with RTSP usage instructions and architecture - Document ISP processing pipeline and performance metrics
This commit is contained in:
yuquanjun
parent
c32fd1b233
commit
96cf5579bd
|
|
@ -0,0 +1,23 @@
|
||||||
|
# Kernel module artifacts
|
||||||
|
*.o
|
||||||
|
*.ko
|
||||||
|
*.mod.c
|
||||||
|
*.mod.o
|
||||||
|
*.cmd
|
||||||
|
modules.order
|
||||||
|
Module.symvers
|
||||||
|
|
||||||
|
# Build artifacts
|
||||||
|
build/
|
||||||
|
.*.tmp_versions/
|
||||||
|
*.symtypes
|
||||||
|
|
||||||
|
# RTSP server binary (too large, downloaded at deploy time)
|
||||||
|
mediamtx
|
||||||
|
mediamtx.tar.gz
|
||||||
|
|
||||||
|
# Temporary files
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
.DS_Store
|
||||||
98
README.md
98
README.md
|
|
@ -153,8 +153,106 @@ ffmpeg -f rawvideo -pix_fmt bayer_bggr16le -s 1920x1080 -r 30 \
|
||||||
|
|
||||||
GPL v2
|
GPL v2
|
||||||
|
|
||||||
|
## RTSP 网络流服务器
|
||||||
|
|
||||||
|
本驱动集成 libcamera 支持，可通过 MediaMTX 实现 RTSP 网络直播。
|
||||||
|
|
||||||
|
### 快速启动
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# SSH 连接到 Zero 2W
|
||||||
|
ssh root@<board-ip>
|
||||||
|
|
||||||
|
# 下载并启动 RTSP 服务器
|
||||||
|
cd /root
|
||||||
|
./deploy-rtsp.sh start
|
||||||
|
|
||||||
|
# 查看日志
|
||||||
|
cat /var/log/mediamtx.log
|
||||||
|
|
||||||
|
# 停止服务
|
||||||
|
./deploy-rtsp.sh stop
|
||||||
|
```
|
||||||
|
|
||||||
|
### 在 Windows/macOS/Linux 上播放
|
||||||
|
|
||||||
|
#### VLC 方式
|
||||||
|
```bash
|
||||||
|
vlc "rtsp://<board-ip>:8554/cam"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### ffplay 方式
|
||||||
|
```bash
|
||||||
|
ffplay "rtsp://<board-ip>:8554/cam"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Python + OpenCV 方式
|
||||||
|
```python
|
||||||
|
import cv2
|
||||||
|
cap = cv2.VideoCapture("rtsp://<board-ip>:8554/cam")
|
||||||
|
while True:
|
||||||
|
ret, frame = cap.read()
|
||||||
|
if ret:
|
||||||
|
cv2.imshow("SC235HAI", frame)
|
||||||
|
if cv2.waitKey(1) & 0xFF == ord('q'):
|
||||||
|
break
|
||||||
|
cap.release()
|
||||||
|
cv2.destroyAllWindows()
|
||||||
|
```
|
||||||
|
|
||||||
|
### 配置说明
|
||||||
|
|
||||||
|
编辑 `mediamtx.yml` 调整以下参数：
|
||||||
|
|
||||||
|
| 参数 | 默认值 | 说明 |
|
||||||
|
|------|--------|------|
|
||||||
|
| rpiCameraWidth | 1920 | 分辨率宽 |
|
||||||
|
| rpiCameraHeight | 1080 | 分辨率高 |
|
||||||
|
| rpiCameraFPS | 30 | 帧率 |
|
||||||
|
| rpiCameraCodec | hardwareH264 | 编码器（硬件H264） |
|
||||||
|
| rpiCameraIDRPeriod | 60 | I 帧间隔 |
|
||||||
|
| rtspAddress | :8554 | RTSP 监听端口 |
|
||||||
|
|
||||||
|
### 架构
|
||||||
|
|
||||||
|
```
|
||||||
|
SC235HAI 传感器
|
||||||
|
↓ MIPI CSI-2 (2-lane)
|
||||||
|
Unicam (CSI 接收器) → ISP (Raspberry Pi V3D ISP)
|
||||||
|
↓ YUV420
|
||||||
|
libcamera (0.6.0) → rpicam-apps
|
||||||
|
↓ H.264 编码（硬件）
|
||||||
|
MediaMTX → RTSP/HLS/WebRTC/SRT
|
||||||
|
↓
|
||||||
|
VLC / ffplay / 流媒体播放器
|
||||||
|
```
|
||||||
|
|
||||||
|
### ISP 处理流程
|
||||||
|
|
||||||
|
驱动通过 libcamera 实现的 ISP 处理：
|
||||||
|
1. **Raw Bayer** (1920x1080-SBGGR10) 从传感器捕获
|
||||||
|
2. **Demosaicing** - Bayer to RGB 转换
|
||||||
|
3. **Color Space** - RGB to YUV420 转换
|
||||||
|
4. **ISP Pipeline** - 曝光、增益、白平衡、去噪等
|
||||||
|
5. **H.264 编码** - 硬件编码器压缩
|
||||||
|
6. **网络传输** - RTSP 协议发送
|
||||||
|
|
||||||
|
### 性能指标
|
||||||
|
|
||||||
|
- **帧率**: 30 fps
|
||||||
|
- **分辨率**: 1920x1080
|
||||||
|
- **编码**: H.264 (硬件加速)
|
||||||
|
- **码率**: 自适应 (~2-4 Mbps)
|
||||||
|
- **延迟**: ~500ms
|
||||||
|
|
||||||
## 更新日志
|
## 更新日志
|
||||||
|
|
||||||
|
### 2026-04-19
|
||||||
|
- 添加 V4L2 完整 control 接口（EXPOSURE/GAIN/VBLANK/HBLANK/PIXEL_RATE/LINK_FREQ）
|
||||||
|
- 支持 libcamera v0.6.0 ISP 处理
|
||||||
|
- 集成 MediaMTX RTSP 服务器
|
||||||
|
- 实现网络视频直播
|
||||||
|
|
||||||
### 2026-04-14
|
### 2026-04-14
|
||||||
- 初始版本发布
|
- 初始版本发布
|
||||||
- 支持 1920x1080@30fps RAW10 输出
|
- 支持 1920x1080@30fps RAW10 输出
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,84 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# deploy-rtsp.sh - SC235HAI RTSP Streaming Server Deployment
|
||||||
|
# Usage: ./deploy-rtsp.sh [start|stop|restart]
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
RTSP_DIR="/root"
|
||||||
|
MEDIAMTX_VERSION="v1.9.3"
|
||||||
|
MEDIAMTX_URL="https://github.com/bluenviron/mediamtx/releases/download/${MEDIAMTX_VERSION}/mediamtx_${MEDIAMTX_VERSION}_linux_arm64v8.tar.gz"
|
||||||
|
MEDIAMTX_BIN="${RTSP_DIR}/mediamtx"
|
||||||
|
MEDIAMTX_CONFIG="${RTSP_DIR}/mediamtx.yml"
|
||||||
|
RTSP_PORT=8554
|
||||||
|
|
||||||
|
download_mediamtx() {
|
||||||
|
if [ ! -f "$MEDIAMTX_BIN" ]; then
|
||||||
|
echo "[INFO] Downloading mediamtx ${MEDIAMTX_VERSION}..."
|
||||||
|
cd "$RTSP_DIR"
|
||||||
|
curl -L -o mediamtx.tar.gz "$MEDIAMTX_URL"
|
||||||
|
tar -xzf mediamtx.tar.gz mediamtx mediamtx.yml
|
||||||
|
rm -f mediamtx.tar.gz
|
||||||
|
chmod +x "$MEDIAMTX_BIN"
|
||||||
|
echo "[OK] mediamtx installed at $MEDIAMTX_BIN"
|
||||||
|
else
|
||||||
|
echo "[OK] mediamtx already installed"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
start_rtsp() {
|
||||||
|
download_mediamtx
|
||||||
|
|
||||||
|
# Kill any existing instance
|
||||||
|
pkill -f "mediamtx" 2>/dev/null || true
|
||||||
|
sleep 1
|
||||||
|
|
||||||
|
# Copy config from script directory if present
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
if [ -f "${SCRIPT_DIR}/mediamtx.yml" ]; then
|
||||||
|
cp "${SCRIPT_DIR}/mediamtx.yml" "$MEDIAMTX_CONFIG"
|
||||||
|
echo "[OK] Using mediamtx.yml from script directory"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Start mediamtx
|
||||||
|
cd "$RTSP_DIR"
|
||||||
|
nohup "$MEDIAMTX_BIN" "$MEDIAMTX_CONFIG" > /var/log/mediamtx.log 2>&1 &
|
||||||
|
PID=$!
|
||||||
|
sleep 3
|
||||||
|
|
||||||
|
# Verify it's running
|
||||||
|
if kill -0 $PID 2>/dev/null; then
|
||||||
|
echo "[OK] MediaMTX started (PID: $PID)"
|
||||||
|
echo "[OK] RTSP stream available at: rtsp://$(hostname -I | awk '{print $1}'):${RTSP_PORT}/cam"
|
||||||
|
else
|
||||||
|
echo "[ERROR] Failed to start MediaMTX"
|
||||||
|
cat /var/log/mediamtx.log
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
stop_rtsp() {
|
||||||
|
pkill -f "mediamtx" 2>/dev/null || true
|
||||||
|
echo "[OK] MediaMTX stopped"
|
||||||
|
}
|
||||||
|
|
||||||
|
restart_rtsp() {
|
||||||
|
stop_rtsp
|
||||||
|
sleep 1
|
||||||
|
start_rtsp
|
||||||
|
}
|
||||||
|
|
||||||
|
case "${1:-start}" in
|
||||||
|
start)
|
||||||
|
start_rtsp
|
||||||
|
;;
|
||||||
|
stop)
|
||||||
|
stop_rtsp
|
||||||
|
;;
|
||||||
|
restart)
|
||||||
|
restart_rtsp
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "Usage: $0 {start|stop|restart}"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
@ -0,0 +1,51 @@
|
||||||
|
# MediaMTX configuration for SC235HAI RTSP streaming
|
||||||
|
# https://github.com/bluenviron/mediamtx
|
||||||
|
|
||||||
|
logLevel: info
|
||||||
|
|
||||||
|
# RTSP server settings
|
||||||
|
rtspAddress: :8554
|
||||||
|
rtspReadTimeout: 10s
|
||||||
|
rtspWriteTimeout: 10s
|
||||||
|
|
||||||
|
# UDP/RTP settings
|
||||||
|
rtpAddress: :8000
|
||||||
|
rtcpAddress: :8001
|
||||||
|
|
||||||
|
# HLS (HTTP Live Streaming) - for web browsers
|
||||||
|
hlsAddress: :8888
|
||||||
|
hlsVariant: main
|
||||||
|
hlsSegmentCount: 3
|
||||||
|
hlsSegmentDuration: 1s
|
||||||
|
|
||||||
|
# WebRTC settings
|
||||||
|
webRTCAddress: :8889
|
||||||
|
webRTCICEUDPMuxAddress: :8189
|
||||||
|
|
||||||
|
# SRT (Secure Reliable Transport)
|
||||||
|
srtAddress: :8890
|
||||||
|
|
||||||
|
# Paths configuration
|
||||||
|
paths:
|
||||||
|
# Main camera stream: rtsp://[host]:8554/cam
|
||||||
|
cam:
|
||||||
|
source: rpiCamera
|
||||||
|
|
||||||
|
# Camera settings (must match SC235HAI resolution)
|
||||||
|
rpiCameraWidth: 1920
|
||||||
|
rpiCameraHeight: 1080
|
||||||
|
rpiCameraFPS: 30
|
||||||
|
|
||||||
|
# Video codec and encoding
|
||||||
|
rpiCameraCodec: hardwareH264 # Use hardware H.264 encoder
|
||||||
|
rpiCameraIDRPeriod: 60 # IDR frame interval (keyframe every 60 frames)
|
||||||
|
|
||||||
|
# Camera tuning and processing
|
||||||
|
rpiCameraTuningFile: "/usr/share/libcamera/ipa/rpi/vc4/ov5647.json"
|
||||||
|
rpiCameraExposure: normal
|
||||||
|
rpiCameraAWB: auto
|
||||||
|
rpiCameraDenoise: "off"
|
||||||
|
rpiCameraMetering: centre
|
||||||
|
|
||||||
|
# Output bitrate (0 = auto)
|
||||||
|
# rpiCameraBitrate: 2500000 # Uncomment to limit bitrate to 2.5 Mbps
|
||||||
Loading…
Reference in New Issue