Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions source/vicharak_sbcs/axon/axon-os-configuration/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,3 +14,4 @@ Axon OS Configuration
Tailscale Support <tailscale-support>
Vicharak Config <vicharak-config/index>
Vicharak Dao ( Remote Access For Vicharak Boards ) <vicharak-dao/index>
OBS Setup <obs-setup>
82 changes: 82 additions & 0 deletions source/vicharak_sbcs/axon/axon-os-configuration/obs-setup.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
######################
OBS Setup
######################

Requirements
============

- Ubuntu 24.04.3
- Kernel image ``6.1.75-axon``

Mesa3D Configuration
====================

Check your OpenGL version to verify Mesa3D installation:

.. code-block:: bash

glxinfo | grep "version"
glxinfo | grep "renderer"

For the RK3588, Mesa (Panfrost) only supports **OpenGL 3.1**. OBS requires **OpenGL 3.3 or higher**. To bypass this check (temporarily), you can override the Mesa version:

.. warning::

Mesa version override is not recommended for general use, but it works fine for running OBS.

.. code-block:: bash

export DRI_DRIVER=panfrost
export MESA_GL_VERSION_OVERRIDE=3.3
export MESA_GLSL_VERSION_OVERRIDE=330

Dependencies
============

Install required development libraries:

.. code-block:: bash

sudo apt install libobs-dev libasound2-dev

OBS Installation
================

Install OBS Studio using the official PPA:

.. code-block:: bash

sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt update
sudo apt install obs-studio

Axon OBS Video Capture Plugin
===============

Install the ``v4l2-obs-plugin-axon`` for camera capturing:

.. code-block:: bash

git clone https://github.com/vicharak-in/v4l2-obs-plugin-axon.git
cd v4l2-obs-plugin-axon
mkdir build && cd build
cmake ..
make
sudo make install

The plugin installs to ``/home/vicharak/.config/obs-studio/plugins``.

.. code-block:: text

/usr/local/lib/obs-plugins/obs-plugin-axon.so

Run OBS
============

Launch OBS with verbose logs:

.. code-block:: bash

obs --verbose

Select the plugin named ``V4L2 axon camera`` for capturing capturing.