Luxonis OS
Luxonis OS is a custom Linux distribution based on Yocto. It is custom-designed for the cameras built around the RVC4 chip, as the chip has 8core ARM CPU. The OS is pre-installed on all OAK4 cameras and can be updated for latest features.To check the current OS version, first connect to the device (ADB or SSH, instructions here) run the following command on the device:Command Line
1cat /etc/os-release
OS Compatibility Chart
RVC4 OS version | oakctl version | Command |
---|---|---|
OS 1.14.1 | 0.11.0 | oakctl self-update -v 0.11.0 (current stable) |
OS 1.11 | 0.9.0 | oakctl self-update -v 0.9.0 |
OS 1.8 | 0.4.2 | oakctl self-update -v 0.4.2 |
OS 1.6 | 0.2.11 | oakctl self-update -v 0.2.11 |
Updating OS
oakctl
OS Update
Full OS Flash
oakctl
The recommended and easiest way to update the device OS is to use oakctl.Compatibility
Updating via oakctl is only supported for OAK4 devices with OS 1.11 and later. If you have an older OS version, please refer to OS Update or Full OS Flash sections.
Steps
Make sure you have the latest oakctl version installed.Command Line
1oakctl self-update
Command Line
1oakctl device update
Example output
Command Line
1$ oakctl device update
2> Do you want to update to the latest firmware? Yes
3✔ Starting firmware update...
4 ✔ Update processed
5✔ Device is offline, should be back online soon.
6✔ Device is back online.
7✔ Device updated successfully!
8Device Info:
9 OS: Luxonis OS RVC4 1.14.1
10 Architecture: linux/arm64
11 Model: Luxonis, Inc. KalamaP OAK4-D R2
12 Platform: rvc4
Enabling SSH
In some older OS versions SSH is disabled by default. To enable it, you first need to connect to the device via ADB and enable the SSH.- Download the sshd_config file - right-click and save as
sshd_config
. - Open terminal and push the downloaded file to the device by running
Command Line
1adb root && adb push sshd_config /etc/ssh/sshd_config
- Reboot the device
- [Optional] Now you can connect to the device via SSH (default password
oelinux123
). If you wish to disable password, runpasswd -d root
when connected to the device (either via ADB or SSH).
pip
By default,pip
isn't installed on the OS, so user has to install it manually:Command Line
1python3 -m ensurepip
Use oakctl
Ideally, one should use oakctl and install containerized apps on the device, as it's the recommended way to deploy applications on OAK4.
Changelog
1.14.1
(24 Jun 2025) – OTA update, Full OS Flash- og05b10 sensor: optimize driver for OAK4S custom setup
- The sensor is powered and clocked from a custom CBA board
- Do not turn on VIO/VANA/VDIO power
- Do not set MCLK
- Add longer delays on reset line since it goes through level shifter 1v8 -> 3v3
- Optimize timings
- Update STM Firmware with M8 external frame sync support
- Fix -25C spine-net-run test Bump VDD_CX voltage from NOMINAL_L1 to TURBO_L1 for 3.2GHz and 3.6GHz
- Revert: "Fix overlay corruption on powerloss" which produces corrupted filesystem on factory-reset
1.13.1
(20 Jun 2025) – OTA update, Full OS Flash- Fix sporadic reboot issue causing device to enter Sahara mode
- Introduce og05b10 colour global‑shutter sensor
- 2592 × 1944 @ 50 FPS
- 1920 × 1080 @ 90 FPS (end‑crop)
- Free‑running & slave configuration
- AEC control
- Make IMX586 more robust on stream start (2nd iteration)
- Apply correct accelerometer & gyro orientation for OAK4S & OAK4D
- Fix overlay corruption on power‑loss
- Remove unused packages: Qualcomm data packages for modem & TFTP server
- Add
fsync-stm-output
notation in DTS - Update default oak‑app to 1.1.5
- Update oak‑agent & oakctl to 0.11.0
- Update agentconfd with M8 support
- Expose baseboard EEPROM with fix for reads bigger than page‑size
- Enable STM for SOM‑based devices, OAK4S & OAK4SR
- Simplify actuator probe on camera discovery
- Improve STM start‑up sequence by removing redundant firmware update
- Make IMX586 more robust on start stream (first iteration)
- Update agentconfd to 1.4.2
- OTA: added status LED behaviour
- OTA: utilise
/data
dir to avoid full OS in RAM - Provide DEVKIT default configuration
1.11.0
(22nd of May) - OTA update, Full OS Flash- New Features:
- Expose eeproms to device agnostic paths for calibration and baseboard eeproms at
/sys/bus/nvmem/devices/calibration-eeprom/nvmem
and/sys/bus/nvmem/devices/baseboard-eeprom/nvmem
- Add dynamic actuator functionality with actuator detection support
- If actuator device is not functional, mark as actuator not present
- Corner case: actuator IC present but lens mechanics not detected from OS (DAI should read eeprom)
- Add mechanism for loading custom overlay DTBs & driver modules at runtime
- Update setup-app to work for OAK4S R5 & OAK4D R7
- Add support for MIRA220 sensor (1600x1400@30fps):
- Master and slave (fsync) modes
- Add 1280x1120 MIRA220 4/5 scale ISP output
- Fix real gain to "artificial" digital gain conversion to avoid noise from ISPDigital gain
- Add r8125 Realtek custom driver & linuxptp 4.4 targeting r8125 driver (currently disabled)
- Add network development tools: iperf3 and ethtool
- Enable direct devmem access for IO runtime configuration
- Introduce public SDK for 3rd party development
- Update SNPE to 2.32 version
- Update DepthAI Gate to v0.23
- Update oak apps:
- oakctl v0.9.0
- oak-agent v0.9.0
- default-app v0.11.17
- Expose eeproms to device agnostic paths for calibration and baseboard eeproms at
- Fixes and Improvements:
- Improve handling for runtime storage with tmp directory cleanup
- Hotfix for IMU perf drop on ICM: Revert changes and use LSM IMU instead of ICM
- Improve camera discovery: do not fail when one of the specified sensor driver is not present
- OAK4S fix: perform USB_SEL change only for R2 revision
1.8.0
(9th of Apr)- Introduced OAK4D R7 version to match hardware revisions in production (no functional change).
- Introduced OAK4S R5 version to match hardware revisions in production (no functional change).
- Extended UEFI bootloader to use FORCE_USB_BOOT for factory reset with active high logic.
- Added OS power profiles.
1.6
(12 Mar 2025) – OTA update, Full OS Flash- Added support for 48 MP resolution (IMX586) on OAK4 cameras (max 18 FPS).
- Updated dot‑projector settings for improved safety.
1.5
(27 Feb 2025) – OTA update, Full OS Flash- Updated oakctl, oak‑agent and depthai‑gate versions.
- Added
RTW88
driver for RLT8811CU Wi‑Fi chip. - Moved to ICM4x IMU sensor as default accelerometer & gyroscope.
- Fixed factory‑reset process.
- Corrected flood‑light pins on OAK4D R2.
.tar.xz
. To get the OTA (.zip
) file, extract the archive.1.4.1
(14 Feb 2025) – Download- Fixed IMU/Mic not working without USB connected.
- Reduced power‑consumption.
- Fixed I2C‑bus and FSYNC issues.
1.4
(11 Feb 2025) – Download- Added support for the RVC4 DevKit (R2).
- Updated
agentconfd
/ oak‑agent; now supports OTA updates.
1.3
(29 Jan 2025) – Download- Enabled performance optimizations → faster boot‑up & improved CPU performance.
- Improved Ethernet‐driver stability.
- Added support for IMX586 QBC HDR mode.
1.2
(10 Jan 2025) – Download/home
is now read/write and persists across OTA updates.- Fixed CDAF autofocus.
- Added manual‑focus actuator control.
- Updated oak‑agent and bundled default apps.
- Tested with DepthAI v3 – 3.0.0a11.
1.1
(17 Dec 2024) – Issue with DepthAI v3 compatibility- Improved factory‑mode without overlaying
/etc
. - Fixed camera‑sensor enumerations from 1.0 release.
- Fixed Luxonis OUI MAC assignment when NIC unprogrammed.
1.0
(9 Dec 2024) – Issue with DepthAI v3 compatibility- Increased system (
rootfs
) & user‑data storage to 5 GB and 76 GB respectively. - Kept system
rootfs
read‑only. - Unified ID for EDL and ADB based on SoC ID.
- Added low‑power detection on POE (note: when powered by sufficient USB‑PD, device may still report low‑power until boot‑complete).
- Extended OTA update to include UEFI‑bootloader binary.
0.26
(4 Dec 2024) – Download- Fixed automatic USB‑role detection on boot.
- Upgraded SNPE to v2.23.
- Updated depthai‑gate to v0.21.
- Disabled factory‑mode by default.
- Added support for OAK4‑S R2 and OAK4‑D R2.
0.25
(19 Nov 2024) – Download- Requires DepthAI 3.0.0a8.
- Added multiple SNPE versions.
- Added USB support for Mediatek MT7601U Wi‑Fi chip.
- Fixed communication with Windows host (USB‑peripheral mode).
- Fixed status LED behaviour.
- Assigned MAC on Ethernet if not already flashed.
- Fixed R8169 driver (Realtek NIC).
0.24
(20 Oct 2024) – Download- Integrated oak‑agent into the OS.
- Introduced factory‑mode.
0.23
(4 Oct 2024) – Download- Improved IR‑LED driving logic for FSYNC STM on OAK4‑D.
- Enhanced image‑quality on OV9282 sensors (driver improvements).
0.22
(23 Sep 2024) – Download- Added support for AK0991x magnetometer.
- Implemented sensor‑fusion for
rotv
&game_rv
algorithms. - Added FSYNC support using STM co‑processor.
- Added EEPROM driver to enable calibration EEPROM.
0.21
(8 Sep 2024) – Download- Fixed colour‑sensor on OAK4‑D.
- Fixed USB2 communication on OAK4‑S.
- Added factory‑reset button (
USB_BOOT
) support on OAK4‑S & OAK4‑D. - Added IMU support on OAK4 cameras.
- Fixed IMX582 sensor support.
0.20
(2 Aug 2024) – Download- Added board‑identification support.
- Added hardware‑in‑loop tests.
- Updated depthai‑gate to v0.0.20.
- Updated system libraries.