Skip to content

feat(realworld): add LUMOS V4L2 camera backend#1146

Open
Brunch-Life wants to merge 4 commits into
RLinf:mainfrom
Brunch-Life:feature/lumos
Open

feat(realworld): add LUMOS V4L2 camera backend#1146
Brunch-Life wants to merge 4 commits into
RLinf:mainfrom
Brunch-Life:feature/lumos

Conversation

@Brunch-Life
Copy link
Copy Markdown
Collaborator

Add a third camera backend alongside RealSense and ZED for LUMOS USB cameras.

FrankaRobot gains a "lumos" branch in camera enumeration and SDK validation; the only runtime dependency is opencv-python (cv2).

Mirroring the ZED smoke script, toolkits/realworld_check/test_lumos_camera.py provides a hardware-in-loop sanity check.

Motivation and Context

Add Lumos camera support for RLinf.

How has this been tested?

It can pass the realworld test. Also the test_lumos_camera.py can pass.

Additional information (optional, e.g., figures and logs):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Documentation update (Document-only update)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Add a third camera backend alongside RealSense and ZED for LUMOS USB
cameras, which expose a raw I420 (YU12) V4L2 stream. LumosCamera
disables OpenCV's built-in RGB conversion, reshapes the packed YUV
buffer, and does the I420->BGR conversion manually so the output
matches the RealSense / ZED backends (BGR uint8). Depth is not
available from this V4L2 interface.

FrankaRobot gains a "lumos" branch in camera enumeration and SDK
validation; the only runtime dependency is opencv-python (cv2).

Mirroring the ZED smoke script, toolkits/realworld_check/test_lumos_camera.py
provides a hardware-in-loop sanity check.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Brunch-Life <brunchlife@hotmail.com>
Comment thread rlinf/envs/realworld/common/camera/lumos_camera.py
@QuanluZhang QuanluZhang requested a review from jx-qiu May 14, 2026 08:47
@zoeyuchao zoeyuchao added the run-ci Enable CI tests label May 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants