Release Notes — R58.7 (v1.0.8.2) — PRE-RELEASE

• Range: v1.0.7.18 → v1.0.8.2
• Date range: 2026-11-01 – 2026-11-05
• Driver: D4XX / D5XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Status: pre-release — validation still in progress; not recommended for production deployment.

Highlights

• SerDes teardown & probe robustness (RSDEV-15191) — Harden SerDes unbind/rebind paths with deadlock prevention, resource unwinding, and lifecycle fixes across MAX96712/MAX96724 and VI file-close handling. Prevents crashes during unload/rebind testing and serializes control refresh with VI unregister.
• D585 980 kHz I2C DFU (RSDEV-11627) — Enable fast-mode I2C (980 kHz) for D585 DFU on JP5/6 with link preparation, ownership tracking, and automatic restoration. Legacy 400 kHz muxed DFU entry and JP7 behavior preserved.

SerDes & Multi-Camera

Platform & Camera Support

Bug Fixes / Stability

Upgrade Notes

• Pre-release — this build is published for integration and validation. Do not deploy to production until R58.7 is promoted to a full release.
• Driver version line — moves from 1.0.7.x to 1.0.8.x. Driver version continues to be auto-incremented via the Jenkins pipeline (driver_version.sh).
• SerDes teardown robustness (RSDEV-15191): fixes critical stability issues during module unload/rebind testing. While these paths are not exercised during normal streaming operation, systems performing frequent module rebinds or debugging SerDes issues should update. The VI lifecycle fixes prevent crashes on repeated unbind. Camera I2C protocol, metadata ABI, stream formats and CSI routing remain unchanged.
• D585 980 kHz I2C DFU (RSDEV-11627): D585 DFU operations now use fast-mode I2C (980 kHz) on JP5/6 for faster firmware updates. Legacy 400 kHz muxed DFU entry is preserved for backward compatibility, and JP7 clock behavior is unchanged. No DT, SDK or kernel adapter ABI changes. Systems performing D585 DFU should verify compatibility; rejected DFU opens preserve state.
• MAX96712/MAX96724 teardown (RSDEV-15191): the MAX96712 remove path prevents deadlock under the device lock, and MAX96724 balances regulator enable on removal. Systems using multi-camera configurations should verify clean module removal and rebind behavior.
• VI control serialization (RSDEV-15191): runtime control refresh is now serialized with VI unregister to prevent use-after-free. This is transparent to userspace but critical for module stability during unbind.
• Focuser lifecycle (RSDEV-15191): focusers are now identified through the file-held video_device instead of the potentially-cleared chan->video. Applications using focuser controls should verify behavior during stream start/stop.

Contributors

zhou, pinquanw, Yogev Modlin, ejgoldik

Full Commit Log (dev branch)

Codebase commits (dev) since v1.0.7.18 (2026-11-01) to v1.0.8.2 (2026-11-05):

0199910 [RSDEV-15191][host][stable] fix: harden SerDes teardown and probe rollback
72f8d3d [RSDEV-11627] Add 980 kHz I2C switching for D585 DFU

Release Notes — R58.6 (v1.0.7.18) — PRE-RELEASE

• Range: v1.0.6.17 → v1.0.7.18
• Date range: 2026-09-17 – 2026-11-01
• Driver: D4XX / D5XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Status: pre-release — validation still in progress; not recommended for production deployment.

Highlights

• Control descriptor architecture (RSDEV-15375, RSDEV-15373) — V4L2 controls are now parsed from the camera's format descriptor (§12.2) and registered at probe, replacing hard-coded control tables. Controls re-sync live after a HW reset or DFU, the REG/HWMC executors return FW results as V4L2 errno, and HW reset readiness is tracked through scratch register 0x400E. Design documented in docs/camera-control-descriptor.md.
• D58x aligned depth control suite (RSDEV-14700, RSDEV-15754, RSDEV-15676) — new Enable Aligned Depth control at FW register 0x4599, settable while 3C color streams and while only the IMU streams.
• D58X 2C Passive Depth Mode control (RSDEV-14783) — new V4L2 control to enable/disable 2C passive depth mode, letting userspace toggle between active and passive depth sensing.
• D500 DPP struct pass-through (RSDEV-15386) — the complete DPP (depth pre-processing) structure is passed between firmware and userspace, with sanity checks on read/write and the full header gated while streaming.
• MinZ runtime updates and accelerometer sensitivity (RSDEV-14893, RSDEV-14851) — supported MinZ fields can update while streaming, and MIPI accelerometer sensitivity is exposed as a V4L2 control.
• Compressed colour over GMSL (RSDEV-13306) — H.264/JPEG compressed colour carried on carrier lines with cleared buffers; each sensor mux now lists its own format table.
• D585 shared RSVL capture and PD distance control (RSDEV-13372, RSDEV-14726) — D585 GMSL_MUX supports shared RSVL capture and programmable PD distance control.
• D585 multi-camera overlays — FG12-16CH and FG12-4CH D585 overlays (RSDEV-14346), FG12-12CH single/dual-camera overlays (RSDSO-21993) and an FG12-4CH D5xx/3D4xx overlay (RSDEV-15311).
• Read-to-clear FW error code (RSDSO-21898) — D4xx GMSL exposes a read-to-clear firmware error code control for polling transient FW errors.
• Format-descriptor library split (RSDEV-14884) — the driver is now a composite kernel module (d4xx_main.c + d4xx_desc.c) for cleaner separation of core logic and descriptor handling.
• JetPack 5.x install robustness — install_to_kernel.sh supports any JP 5.0.x / 5.1.x, installs MAX96717/MAX96724 when needed and fails early on missing artifacts; UVC metadata PIDs added for L4T 35.4.1/35.6.4.

SerDes & Multi-Camera

Platform & Camera Support

V4L2 Controls, Metadata & Streaming

Bug Fixes / Stability

Build / CI / Tooling

Upgrade Notes

• Pre-release — this build is published for integration and validation. Do not deploy to production until R58.6 is promoted to a full release.
• Driver version line — moves from 1.0.6.x to 1.0.7.x. Driver version continues to be auto-incremented via the Jenkins pipeline (driver_version.sh).
• Control descriptor architecture (RSDEV-15375): controls are registered from the camera descriptor instead of hard-coded tables, so the control set follows the connected camera/FW and re-syncs after HW reset/DFU. Control executors return firmware results as V4L2 errno values. Rebuild and deploy the whole module set.
• D58x Enable Aligned Depth control (RSDEV-14700, RSDEV-15754, RSDEV-15676): new control to enable/disable aligned depth, settable with 3C color or IMU-only streams active. Applications using aligned depth should verify compatibility, and host logic that assumed -EBUSY in those states should be re-checked.
• D58X 2C Passive Depth Mode (RSDEV-14783): new V4L2 control to toggle between active and passive depth sensing. Applications using depth streaming should verify compatibility.
• Breaking — D500 DPP struct pass-through (RSDEV-15386): D500 DPP controls now pass the complete structure between FW and userspace. Applications that previously wrote individual DPP fields must now update the entire structure. The driver gates full-header updates while streaming.
• MinZ runtime updates (RSDEV-14893): supported MinZ fields can now be updated while streaming. Applications using MinZ controls should verify compatibility.
• MIPI accelerometer sensitivity (RSDEV-14851): new V4L2 control to adjust accelerometer sensitivity. IMU applications should verify compatibility.
• Read-to-clear FW error code (RSDSO-21898): D4xx GMSL exposes a new read-to-clear firmware error code control. Applications should poll this control to detect and acknowledge transient firmware errors; any read consumes the latched error.
• Compressed colour over GMSL (RSDEV-13306): compressed RGB formats are supported over GMSL with carrier-line configuration and buffer clearing. Each sensor mux now advertises its own format list; re-test RGB streaming and format enumeration.
• D585 shared RSVL capture (RSDEV-13372, RSDEV-14726): D585 GMSL_MUX supports shared RSVL capture and PD distance control. Update userspace applications to leverage these capabilities.
• D585 256x144 frame rate limit (RSDEV-13487): the 256x144 resolution is clamped to a maximum of 90 FPS. Applications that previously set higher frame rates for this resolution will...

Release Notes — R58.5 (v1.0.6.17)

• Range: v1.0.5.20 (R58.4) → v1.0.6.17
• Date range: 2026-08-06 – 2026-09-17
• Driver: D4XX / D5XX GMSL MIPI CSI-2 for NVIDIA Jetson

Highlights

• Camera-supplied format descriptors (RSDEV-13342) — the per-SKU format tables are read from the camera at probe (versioned blob at I2C 0x6000) instead of being carried in the driver; built-in tables remain the fallback when the blob is absent or invalid. Documented in docs/camera-format-descriptor.md.
• DPP control suite — D585 GMSL DPP controls (RSDEV-13973, RSDEV-9182, RSDEV-9184), composite decimation/temporal controls (RSDEV-14843) and GMSL gyro sensitivity (RSDEV-14097).
• D500 control-surface alignment (RSDEV-13639) — CIDs renamed, function names aligned, D58X Device Mode / 2C AE moved onto the XU bridge.
• Variable height buffers (RSDEV-14304) — variable-length data formats with a per-format VI datatype override, JP 6.0 / 6.2 / 7.0 / 7.1 / 7.2.
• D585 GMSL link configuration — tunnel CSI lane rates, MAX96712 4-lane rate raised to 1300 Mbps, D585 external sync on FG12-16CH, prototype recovery after HW reset, MAX96712 instability fix.
• Generic VC mapping (RSDSO-21887) — MAX96717 accepts VC IDs up to 15 and generic VC remapping is enabled on every MAX96712 overlay.
• VI robustness — VI metadata paired per capture descriptor, VI5 recovery teardown lifetime fix, BA10 used exclusively for RGB calibration.

SerDes & Multi-Camera

Platform & Camera Support

V4L2 Controls, Metadata & Streaming

Bug Fixes / Stability

Build / CI / Tooling

Upgrade Notes

• Driver version line — moves from 1.0.5.x to 1.0.6.x, auto-incremented by the Jenkins pipeline (driver_version.sh).
• Camera format descriptors (RSDEV-13342) — the driver prefers the camera-supplied blob over its built-in tables; on a malformed or unversioned blob it falls back. Check dmesg for the descriptor-validation message if a SKU advertises an unexpected format set.
• Breaking — composite DPP controls (RSDEV-14843) — decimation and temporal are composite U32 array controls; userspace driving the old scalar controls must switch.
• Breaking — variable height buffer (RSDEV-14304) — changes VI datatype handling; verify existing capture pipelines.
• D500 / D58X control changes (RSDEV-13639) — CIDs renamed; D58X Device Mode and 2C AE go through the XU bridge. Update userspace that references them.
• 2C/3C controls disabled (RSDEV-14092) when not applicable.
• D5xx RGB gain range is now 16–248.
• RGB calibration transport now uses BA10 instead of GR16; re-check userspace that pinned the FourCC.
• MAX96712 lane rate / VC mapping — all MAX96712 overlays use 1300 Mbps on 4 lanes and generic VC mapping; re-verify bandwidth and update custom overlays relying on fixed VC assignments.
• New overlays — FG12-16CH cams-0-1-d5xx and cams-0-1-2-3-d5xx-3d4xx; select the one matching your camera configuration.
• JP 5.1.6 — missing geometry patch added; re-apply patches and rebuild.

Contributors

Nir Azkiel, Yogev Modlin, ejgoldik, pinquanw, shuaili2, zhou

Full Commit Log (dev branch)

Codebase commits (dev) since v1.0.5.20 (2026-08-06) to v1.0.6.17 (2026-09-17):

23f689c [RSDEV-14843] Expose composite DPP controls
bc4e836 [RSDEV-13342] MIPI driver descriptors
0ba17dc [D500][gmsl][fix]: use BA10 exclusively for RGB calibration
900eff5 [D500][GMSL][fix]: pair VI metadata per capture descriptor
a722fff [RSDEV-14304] variable height buffer
8381dfa [RSDEV-13487] Add 256x144 D58x depth and infrared profiles
837a3a1 RSDEV-14319 add missing geometry patch for JP5.1.6
0b49d88 RSDEV-14092 2C 3C controls disable
d150cb7 [RSDEV-13621][D58x] Fix GMSL DFU completion and re-enumeration
202c6e8 RSDEV-14097 Expose GMSL gyro sensitivity control
ce02956 Added fg12-16ch-cams-0-1-d5xx overlay
690ad64 Added fg12-16ch-cams-0-1-2-3-d5xx-3d4xx overlay
52c0817 [RSDEV-13973][RSDEV-9182][RSDEV-9184][D585][GMSL] Expose DPP controls
772df55 D401_dual_RGB_fix_exposed_res
481b391 RSDSO-21887_max96717_allow_vc_id_upto_15
bc0b7e1 Align idVendor indentation with surrounding entries in the JP5 patch
3a03e46 Add RealSense VID 0x38E5 wildcard entry to UVC metadata patches
939087c Recover D585 prototype after hardware reset
f278f31 RSDSO 21902 21903 D585 max 96712 instability fix
f155939 RSDSO-21887 enable generic vc mapping
16cf74a [RSDEV-13639] Rename D500 camera control CIDs
e036af5 [RSDEV-13639][D500] Align product-specific function names
0240dce [RSDEV-13639][D58X] Use XU bridge for Device Mode and 2C AE
fcbbf2d [RSDSO-21880][D585] Receive flat NV12 over a RAW8 carrier via format row
6e181c5 Enable vi5_fops dt override for D585 RGB+IR calib
b07a7f8 Remove_unused_JP5_serdes_sources
7dba404 [D585][gmsl] fix: address tunnel lane-rate review
00982c0 [D585][GMSL] Configure tunnel CSI lane rates
f72a75d Update max96717.c
94f3e88 RSDEV-13332 D585 External sync on Fangzhu-12-16CH
7ec01e3 max96712 update 4 lane rate to 1300Mbps
de396fa [D5xx] Set RGB gain range to 16-248
453a6af Use D5xx compatible string for MAX96712 overlays
6a0dfce Bump driver version to 1.0.6.0
e73fcb2 [Jetson][VI5] fix recovery teardown resource lifetime

Release Notes — R58.4 (v1.0.5.20) — PRE-RELEASE — CUMULATIVE

• Range: v1.0.4.9 → v1.0.5.20
• Date range: 2026-06-30 – 2026-08-06
• Driver: D4XX / D5XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Status: pre-release — validation still in progress; not recommended for production deployment.

Highlights

• D5XX (D585) family bring-up — first release with D58x GMSL support: MAX96712 pixel-mode bring-up, MAX96724 tunnel mode ported into the unified driver, a new MAX96717 serializer driver, D58x pixel-mode FW gating with padded IMU lines, D58x RGB controls + telemetry, and a set of D5xx device-tree overlays (seeed nano, FG24-4CH, joint D5xx/D4xx 4-lane).
• Fangzhu FG12-4CH support — FG12-4CH D457 overlays for AGX Orin, plus a 4-camera FG12-4CH configuration on Orin Nano / Orin NX.
• GMSL link-reset rework — the one-shot link flush moved out of __max96712_set_pipe into cold bring-up / HW-reset recovery (RSDEV-12608), then corrected so a multi-camera MAX96712 link is flushed exactly once on cold bring-up (RSDSO-21786).
• JetPack 5.x streaming fixes — JP 5.1.6 G_PARM EINVAL and the D457 color-path kernel panic / recovery path fixed; JP 5.1.2 module copy handled in install/deploy; JetPack-mismatched kernels blocked on JP5.
• Breaking interface changes — GVD control size enlarged (D4xx 276 B, D5xx 606 B, RSDEV-13118) and metadata payload extended to 255 B for HKR (RSDEV-9250). Userspace/SDK must allocate the larger buffers.
• Timestamp correctness — BACKEND_TIMESTAMP > TIME_OF_ARRIVAL on GMSL fixed across JP 5.0.2 / 5.1.2 / 5.1.6 (RSDSO-20101).
• D58x V4L2 control expansion — RGB scalar controls ported to the unified driver, selecting D58x extension offsets by detected device type (RSDEV-12730); D58x manual laser power exposed as 0–540 in steps of 45 (default 225), with control creation gated on device type and legacy metadata preserved for other products (RSDEV-13457).
• Y16I/RGB calib pixel mode for D585 — calib pixel mode enabled for both the Y16I and RGB streams (RSDSO-21787), the now-redundant vi5_fops Y12I error-ignore removed (RSDEV-13252), and a follow-up rebalanced the Y16I patch hunk context so apply_patches_ext.sh's GNU-patch pipeline applies cleanly on every JetPack.
• More FangZhu/JP7 overlays — a JP7 4-camera FG12-16CH overlay (links 0-3) added and the 1-cam overlay renamed to match JP6 naming; a new FG12 4-channel D5xx overlay; every MAX96712-based overlay realigned to 4 MIPI lanes (RSDSO-21762); D5xx video node enumeration order fixed and D585 advertised modes aligned with USB.
• Merge-queue CI gating — a new merge-queue-gate.yml workflow bridges the GitHub merge queue to the D4xx_Kernel_Module_Jetson_JP6 Jenkins job, labeling the gated build with every PR batched in the queue.
• D401 dual-RGB CSI passthrough (POC) — squashed proof-of-concept for RAW8 dual-RGB CSI passthrough on the OV9782 (FW CSI-PT mode, Bayer RGGB→BGGR correction, 1612x808 @ 60 fps advertised).

New Platform & Camera Support

SerDes & Multi-Camera

V4L2 Controls, Metadata & Streaming

Bug Fixes / Stability

Build / CI / Tooling

Upgrade Notes

• Pre-release — this build is published for integration and validation. Do not deploy to production until R58.4 is promoted to a full release.
• Driver version line —...

Release Notes — R58.3 (v1.0.4.9) — CUMULATIVE

• Range: v1.0.3.18 → v1.0.4.9
• Date range: 2026-05-26 – 2026-06-26
• Driver: D4XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Commits: 38 (23 substantive + 15 auto-increment version bumps) | 235 files changed | 15,357 insertions / 21,380 deletions
• Versions covered: 1.0.3.13, 1.0.3.14, 1.0.3.15, 1.0.3.16, 1.0.3.17, 1.0.4.0, 1.0.4.1, 1.0.4.2, 1.0.4.3, 1.0.4.4, 1.0.4.5, 1.0.4.6, 1.0.4.7, 1.0.4.8, 1.0.4.9 (the 1.0.3.13–1.0.3.17 revisions were skipped by the manual bump to the v1.0.3.18 tag and are first reported here)

Highlights

• JetPack 7.2 (L4T R39.2) bring-up — JP7.2 support on Advantech AGX Thor GMSL (RSDSO-21610), plus single-camera Fangzhu (FG12-16CH) overlay bring-up on AGX Orin (RSDSO-21616).
• Advantech Thor multi-camera scaling — 6-camera (RSDSO-21522) and 8-camera configurations on Advantech Thor.
• New V4L2 controls — RGB ISP controls exposed on the GMSL stack (RSDEV-5918), AE-type control (RSDSO-21570), and a readout-shaping XU control (RSDSO-21508).
• External sync expansion — external sync enabled for D41X (D415) cameras (RSDSO-21490); sync mode simplified to a 3-value public API (RSDEV-6449); ext_sync_gen.py allows re-enable while already enabled.
• Reliability fixes — ds5_hwmc_wait bounded by a wall-clock deadline (RSDEV-12089), MIPI DFU recovery after an interrupted FW upgrade (RSDSO-21588), and a unified YUV422 1X16 Tegra format.
• Codebase cleanup — EOL JetPack 4 (4.6.1) tooling removed (RSDSO-21420), unused D46x code dropped (RSDSO-20950), and JP6.x nvidia-oot patches reorganized by subject with embedded-metadata blocker fixes.

New Platform Support

Multi-Camera & SerDes

V4L2 Controls & Streaming

External Sync

Bug Fixes / Stability

Build / CI / Tooling / Cleanup

Upgrade Notes

• Driver version line — this release moves the driver from the 1.0.3.x series to 1.0.4.x. Driver version continues to be auto-incremented via the Jenkins pipeline (driver_version.sh).
• JetPack 7.2 — new platform target (L4T R39.2) on Advantech AGX Thor and AGX Orin (Fangzhu FG12-16CH). Select the matching device-tree overlay and do not rebuild the BSP NVIDIA display stack on JP7.
• JetPack 4.6.1 removed — EOL JetPack 4 manual patches and tooling have been removed (RSDSO-21420); JP4-based deployments are no longer supported by this branch.
• D46x removed — unused D46x code has been dropped (RSDSO-20950).
• External sync — external sync is now available on D41X (D415); the sync-mode interface is simplified to a 3-value public API (RSDEV-6449) — verify userspace against the new contract.
• New V4L2 controls — RGB ISP controls (RSDEV-5918), AE-type (RSDSO-21570), and readout-shaping (RSDSO-21508) are exposed as V4L2 controls; clients should query the control set rather than assuming fixed IDs.

Contributors

ejgoldik, Yogev Modlin, ipilchin1, Nikolai-L, remibettan, pinquanw, Nir Azkiel

Version Progression

v1.0.3.18 → v1.0.3.13 … v1.0.3.17 → v1.0.4.0 → v1.0.4.1 → v1.0.4.2 → v1.0.4.3 → v1.0.4.4 → v1.0.4.5 → v1.0.4.6 → v1.0.4.7 → v1.0.4.8 → v1.0.4.9

Release Notes — R58.2 (v1.0.3.18) — CUMULATIVE

• Range: v1.0.2.34 → v1.0.3.18
• Date range: 2026-04-13 – 2026-06-04
• Driver: D4XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Net change vs v1.0.2.34: 25 files changed | 6,004 insertions / 846 deletions

Highlights

• Seeed Orin Nano support — new carrier-board platform bring-up (RSDSO-20614).
• On-demand ESYNC GPIO tunneling — on-demand GPIO tunneling for external sync, with a design document; JP5 external-sync configuration aligned (RSDEV-6847).
• Reset / probe robustness — reset and probe path optimized, endless-HW-reset on inaccessible cameras fixed, unnecessary probe-time reset logic removed, and MIPI DFU recovery after an interrupted FW upgrade fixed (RSDSO-21588).
• MAX96712 per-link one-shot reset — one-shot reset issued per link on set_pipe.
• Test & CI — standalone parallel-stream test, quad depth-RGB sync test, auto-increment driver-versioning pipeline, and CI-instability fixes.

New Platform Support

External Sync / GPIO Tunneling

SerDes / Multi-Camera

Bug Fixes / Stability

Build / CI / Tooling

Testing

Already delivered in v1.0.2.34

These were released in v1.0.2.34 and remain in the v1.0.3.18 codebase; they are listed here only for completeness and are not new in this release:

• RSDSO-20613 — Fangzhu / MAX96712 full-slave mode and quad D457 camera support
• MAX96712 MFP6 configuration for links B–D
• RSDSO-21407 — external sync via TSC PWM
• MAX96712 lane data rate raised to 2500 Mbps

Upgrade Notes

• Driver version line — this release moves the driver from the 1.0.2.x series to 1.0.3.x. Driver version is auto-incremented via the Jenkins pipeline (driver_version.sh).
• DFU recovery — if firmware upgrades may be interrupted, this release keeps the device recoverable over MIPI (RSDSO-21588).
• External sync — JP5 deployments should re-verify external-sync configuration against d467803; on-demand ESYNC GPIO tunneling is available per RSDEV-6847.
• Seeed Orin Nano — new carrier target; select the matching device-tree overlay when deploying.

Contributors

ejgoldik, ipilchin1, Nikolai-L, Uzi Sarel (Uzi), Inessa Chernoguz (cinessa), Yogev Modlin

Version Progression

v1.0.2.34 → v1.0.3.0 → … → v1.0.3.12 → v1.0.3.18

Release Notes — v1.0.2.34 (CUMULATIVE)

• Range: v1.0.2.23 → v1.0.2.34
• Date range: 2026-03-16 – 2026-05-07
• Driver: D4XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Commits: 33 | 175 files changed | 15,702 insertions / 5,308 deletions
• Versions covered: 1.0.2.24, 1.0.2.25, 1.0.2.26, 1.0.2.27, 1.0.2.30, 1.0.2.31, 1.0.2.32, 1.0.2.33, 1.0.2.34

Highlights

• JetPack 7 on NVIDIA Thor (MIPI) — new platform support tracked under RSDSO-20559.
• JetPack 5.1.6 and JetPack 6.2.2 — additional NVIDIA L4T versions added (RSDSO-21191, RSDSO-21146).
• MAX96712 multi-camera up to quad D457 — multi-camera deserializer support, dual-camera per deserializer on JP6.x, and quad-D457 enablement via MAX96712 full-slave mode (Fangzhu) (RSDSO-20613).
• External sync via TSC PWM — Thor-friendly external sync path using TSC PWM, plus restored MAX9296 GPIO tunneling and consolidated MAX9295 GPIO tunneling for external sync (RSDSO-21407).
• Carrier board support — Advantech (Orin, JP6 and JP7) and AVerMedia (JP6.x) carrier/deserializer boards.
• MAX96712 link tuning — lane data rate raised to 2500 Mbps; MFP6 configuration added for links B–D.
• Driver stability fixes — DS5 reset/detection rework, MAX9296 power_off underflow fix that caused spurious XCLR during probe, and DTB copy fix for JP6.x deploy.

Known Issues:

• Camera doesn't appear in recovery mode after interrupting the upgrade process
  This has been fixed at R58.2 (v1.3.0.18) please update if required [RSDSO-21588] .

New Platform Support

Multi-Camera & SerDes

External Sync / GPIO Tunneling

Carrier Board Support

Bug Fixes

Per-version Summary

Upgrade Notes

• Patch directory renames — if you maintain external patch overlays, refresh against apply_patches_ext.sh changes in ee7e0ba.
• MAX9295 GPIO tunneling — patch 0017 was removed and folded into 0016; downstream forks rebasing manually must drop 0017.
• JP6.x DTB deploy — re-deploy DTBs after upgrading; base platform DTBs are now copied to rootfs/boot/dtb/.
• MAX96712 lane rate — new 2500 Mbps lane rate requires compatible board routing and SerDes calibration; verify on custom carriers before deploying.
• Full-slave / quad-D457 — requires MAX96712 board configured for full-slave mode; review device tree variant selection in hardware/realsense/.

Contributors

ejgoldik, Uzi (Uzi Sarel), Inga Pilchin (ipilchin1), Nikolai-L, KONTRA

Version Progression

v1.0.2.23 → v1.0.2.24 → v1.0.2.25 → v1.0.2.26 → v1.0.2.27 → v1.0.2.30 → v1.0.2.31 → v1.0.2.32 → v1.0.2.33 → v1.0.2.34

Release Notes — R58.2+ (v1.0.2.33) — PRE-RELEASE

• Range: v1.0.2.23 → v1.0.2.33
• Date range: 2026-03-22 – 2026-05-05
• Driver: D4XX / D5XX GMSL MIPI CSI-2 for NVIDIA Jetson
• Status: pre-release — validation still in progress; not recommended for production deployment.

Highlights

• MAX96712 multi-camera support — initial multi-camera overlay configurations for FG12-16CH (2-camera and 4-camera), enabling quad D457 camera support with MAX96712 full slave mode
• GPIO tunneling for external sync — on-demand ESYNC GPIO tunneling support added for MAX9295 and MAX96712A, enabling external sync support across JetPack 5.x and 6.x platforms
• Expanded platform support — new carrier board support including Advantech (Orin, JP6.x, JP7.x), AVerMedia (JP6.x), Seeed Orin Nano, plus JetPack 5.1.6 and 6.2.2 compatibility
• SerDes driver improvements — MAX9295/MAX9296 regmap cache type changed to REGCACHE_FLAT to prevent initialization delays and improve reliability
• Probe and reset optimization — driver probe function optimized to eliminate unnecessary reset logic and reduce spurious XCLR resets, improving camera detection reliability
• Stream restart robustness — stream restart upon capture timeout added across all supported JetPacks (4.6.1, 5.0.2, 5.1.2, 5.1.6, 6.0, 6.1, 6.2.x, 7.0, 7.1)

SerDes & Multi-Camera

Platform & Camera Support

Bug Fixes / Stability

Build / CI / Tooling

Upgrade Notes

• Pre-release — this build is published for integration and validation. Do not deploy to production until promoted to a full release.
• Driver version line — moves from 1.0.2.23 to 1.0.2.33. Driver version continues to be auto-incremented via the Jenkins pipeline.
• External sync support — cameras using external sync should enable GPIO tunneling via device-tree properties or kernel module parameters for MAX9295 and MAX96712A.
• New JetPack versions — JetPack 5.1.6 and 6.2.2 are now supported; ensure you use the correct patch set and device-tree overlays for your target platform.
• Carrier board overlays — new overlays added for Advantech (JP6.x, JP7.x), AVerMedia (JP6.x), and Seeed Orin Nano; select the appropriate overlay for your hardware configuration.
• Multi-camera configurations — FG12-16CH now supports 2-camera and 4-camera configurations via new overlay files (tegra234-camera-d4xx-overlay-fg12-16ch-cams-0-1.dts and ...-cams-0-1-2-3.dts).
• SerDes patches reorganized — GPIO tunneling patches have been consolidated; if you maintain custom patches, review the new patch numbering (GPIO tunneling is now in patch 0016 instead of separate 0017).

Contributors

ejgoldik, ipilchin1, Nikolai-L, Uzi, Uzi Sarel, KONTRA

Full Commit Log (dev branch)

Codebase commits from dev branch (v1.0.2.23 → v1.0.2.33):

d467803 Align JP5 esync configuration (#431)
01f4858 RSDEV-6847: On-demand ESYNC GPIO tunneling for external sync (#429)
6da8282 Add mfp6 config for links b to d (#430)
41edd02 [RSDSO-20614] - Seeed orin nano support (#428)
0e86a8e Remove unnecessary reset logic from probe function (#427)
8e5cdbc Fix endless HW reset when camera inaccessible (#425)
477a4d2 RSDSO-20613: enable quad D457 camera support with MAX96712 full slave mode (#426)
3a73aa5 RSDSO-20613: enable Fangzhu full slave mode in patches (#424)
54bcf16 Optimize reset and probe (#416)
1917489 Fix max9296 power_off underflow causing spurious XCLR reset during probe
e75b5f6 Use left port for Advantech on Orin
9a7985b Enable Advantech board on JP7.x
2b748fa Fixed dtb copy for JP6.x
4f32ea1 Fix Advantech dtso for JP7 (#408)
224bae0 AVerMedia deserializer board support for JP6.x (#410)
ee7e0ba [FIX] Update apply_patches_ext.sh for renamed DT patch directories (#409)
870da69 Advantech board orin support (#406)
180432a Update max9295 and max9296 driver configurations and patches (#405)
e9082f1 Max96712 multicamera (#404)
f1f0c97 Tracked on RSDSO-21191 Support Nvidia JP 5.1.x/RSDSO-21146 Support Nvidia JP6.2.2 (#402)
1bedc08 Restore max9296 GPIO tunneling for external sync (#403)
c2b8ee6 Remove 0017; MAX9295 GPIO tunneling consolidated into 0016
518bf98 Remove 0017; MAX9295 GPIO tunneling consolidated into 0016
44c7419 [FIX] Remove unused variable 'retry' in ds5_probe function
a7ea226 Fix ds5 reset and detection (#400)
f304653 Add GPIO tunneling for MAX96712A external sync support

🤖 Generated with Claude Code

Release Notes — v1.0.2.23

Date: 2026-03-16
Previous release: v1.0.1.33 (2026-01-22)
Driver: D4XX GMSL MIPI CSI-2 for NVIDIA Jetson
Diff: 57 commits, 85+ files changed (~1,974 insertions / 881 deletions in d4xx.c alone)

Highlights

• Comprehensive HW-reset recovery for GMSL cameras — the driver now detects hardware resets mid-operation, re-establishes SerDes links, re-probes sensors, and resumes streaming with minimal disruption. This spanned 12+ incremental patches (v1.0.2.5 → v1.0.2.23).
• D401 GMSL support — first-class support for D401 cameras over GMSL with POR-aligned resolutions (up to 60 FPS at 480p) and 5 FPS mode.
• JetPack 6.2.1 support — compilation and patching support added for L4T 36.4.4.
• Fangzhu FG12-16ch support — multi-camera carrier board support extended to JP 5.0.2 and JP 6.0.

New Features

HW Reset Recovery (major feature, 15+ patches)

A complete hardware-reset recovery mechanism was developed across versions v1.0.2.5 through v1.0.2.23:

• Initial implementation — detect HW reset via generation counters, re-establish GMSL SerDes links, recover streaming state (bbb0814)
• Regression fix — fix recovery regression in initial release (4fdddfe)
• Reset generation tracking — atomic generation counters with lazy cache invalidation across sensor instances (1a483d4)
• Device type polling — poll device-type register after HW reset for proper re-initialization (c39e16f, 1066a30)
• Per-stream-instance recovery — fix recovery for the per-stream-instance architecture; register all instances in serdes_inited[]; fix EBUSY loop (fdba0ec, ebb67d5, 1afe702)
• IMU probe fix — fix D457 probe failure on 4th instance (IMU) after HW reset (019d69d)
• Post-reset HWMC readiness — add HWMC readiness gate and fix GVD retry logic after reset (0ecf9a1)
• Format table fix — fix wrong format tables when device-type register returns 0 after HW reset (048d43a)
• D401 I2C stability — fix D401 post-reset I2C instability and GMSL link degradation (a26e6a5)
• Stability checks — add stability verification with primary instance handling (be53fef)
• Light path — conditional SERDES recovery (light path), deferred pipe release, remove serializer init from non-critical path (2012bef, 4580502)
• Streaming state management — enhanced recovery ↔ streaming interaction, force stop on generation mismatch (f969628, 559ce09, b367c4a, 5bf5cea)

Bug Fixes

Stability & Refactoring

Infrastructure & CI

Documentation

• README links migrated to realsenseai GitHub org (1c48909)
• README updated to remove Intel references (0c5c992)
• JP6 README minimized (f3bada8)
• README: add initrd deployment step (a6dc94c)
• Added CLAUDE.md, copilot-instructions.md, hw-reset follow-up plan doc

Contributors

Ejgoldik, Ilya Pilchin, Nikolai L., Nir Azkiel, Uzi Sarel, Yogev Modlin

Version Progression

v1.0.1.33 → v1.0.2.4 → v1.0.2.5 → v1.0.2.6 → v1.0.2.7 → v1.0.2.8 → v1.0.2.9 → v1.0.2.10 → v1.0.2.12 → v1.0.2.13 → (14–22 untagged) → v1.0.2.23

Full Changelog: v1.0.2.13...v1.0.2.23

What's Changed

• Fix Y12I streaming error handling in vi5_capture_dequeue
• CI: testing frame order and fps by @Kontra2B in #331
• Add scripts for kernel module aggregation and deployment by @ymodlin in #336

Full Changelog: v1.0.1.32...v1.0.1.33