CloudSoftwareHardware
Software Stack
DepthAI
OAK Apps
AI Models

ON THIS PAGE

  • Luxonis OS
  • OS Compatibility Chart
  • Updating OS
  • Enabling SSH
  • pip
  • Changelog

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.110.9.0 oakctl self-update -v 0.9.0 (current stable)
OS 1.80.4.2oakctl self-update -v 0.4.2
OS 1.60.2.11oakctl self-update -v 0.2.11

Updating OS

OS Update
Full OS Flash

OS Update

  1. Download the OTA update file for the latest version. See Changelog section below for details.
  2. Copy the downloaded full_update_luxonis_ext4-[version].zip image (via scp or adb push) to the device, see Direct access to the device
  3. Run the following commands on the device:
Command Line
1# ADB/SSH into the device first
2(rvc4)$ recovery --wipe_cache --update_package=/data/full_update_luxonis_ext4-[version].zip
3(rvc4)$ reboot

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, run passwd -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

Changelog

  • 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
    • 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 (12th of Mar) - OTA update, Full OS Flash
    • Added support for 48MP resolution (on IMX586) on OAK4 cameras. Max 18 FPS.
    • Updated dot projector settings for better safety.
  • 1.5 (27th of Feb) - OTA update, Full OS Flash
    • Update oakctl, oak-agent and depthai-gate versions
    • Add RTW88 driver for RLT8811CU chip
    • Move to ICM4x IMU sensor as default accelerometer & gyroscope
    • Fix factory reset
    • Fix to correct flood light pins on OAK4D R2
Below versions contain both OTA and Full OS Flash updates in a single .tar.xz. To get OTA (.zip) file, you need to extract the .tar.xz file.
  • 1.4.1 (14th of Feb) - Download link
    • Fix IMU/Mic not working without USB connected
    • Fix increased power consumption
    • FIx I2C bus and FSYNC issues
  • 1.4 (11th of Feb) - Download link
  • 1.3 (29th of Jan) - Download link
    • Enabled performance optimizations, device now has faster bootup and slightly better CPU performance
    • Improved ethernet driver, now it's more stable
    • Support for IMX586 QBC HDR mode
  • 1.2 (10th of Jan) - Download link
    • /home is not read/write, and will not get changed after OTA update
    • Fixed CDAF autofocus
    • Add Manual Focus for direct actuator lens position adjustment
    • Updated oak-agent and added default apps
    • Tested with DepthAI v3 versions: DepthAI 3.0.0a11
  • 1.1 (17th of Dec) - [Issue with DepthAIv3 compatibility]
    • Improve factory-mode without overlaying /etc
    • Fix camera sensor enumerations in 1.0 release
    • Fix Luxonis OUI MAC assignment if NIC unprogrammed
  • 1.0 (9th of Dec) - [Issue with DepthAIv3 compatibility]
    • Increase system (rootfs) & user data storage to 5GB and 76GB respectively
    • Keep system rootfs as Read Only
    • Use common ID for EDL and ADB, based on soc ID
    • Add low power detection on POE. Note: Know misbehaviour, if the device powered via USB PD with enough power, it will signal as low power until it boots
    • Extend OTA update to contain uefi bootloader binary
  • 0.26 (4th of Dec) - Download link
    • Fix automatic usb role detection on boot
    • Change the default SNPE to v2.23
    • Update depthai_gate to v0.21
    • Disable factory mode by default
    • Support for OAK4-S R2 and OAK4-D R2 version
  • 0.25 (19th Nov) - Download link
    • Requires DepthAI 3.0.0a8
    • Added multiple SNPE versions
    • Added USB support for Mediatek MT7601U WiFi chip
    • Fixed communication with Windows host computer (peripheral mode)
    • Fixed status LED
    • Assign MAC on ETH if it's not already flashed
    • Fixed R8169 driver (realtek network chip)
  • 0.24 (20th Oct) - Download link
    • Integrate oak-agent into the OS
    • Introduced factory mode
  • 0.23 (4th Oct) - Download link
    • Improve IR LED driving logic for FSYNC STM on OAK4-D
    • Improve image quality on OV9282 (improve driver)
  • 0.22 (23rd Sep) - Download link
    • Support for magnetometer (AK0991x)
    • Sensor fusion for rotv & game_rv algorithms
    • Added FSYNC support using STM coprocessor
    • Added eeprom driver to enable calibration eeprom
  • 0.21 (8th Sep) - Download link
    • OAK4-D fix color sensor
    • OAK4-S fix USB2 communication
    • Support factory reset button (USB_BOOT) for OAK4-S and OAK4-D
    • Support IMU on OAK4 cameras
    • Fix IMX582 sensor support
  • 0.20 (2nd Aug) - Download link
    • Added board identification
    • HIL tests
    • Updated depthai-gate to 0.0.20
    • Updated system libraries