mur/l500/test-bad-conditions.cpp

Go to the documentation of this file.

// License: Apache 2.0. See LICENSE file in root directory.
// Copyright(c) 2021 Intel Corporation. All Rights Reserved.

//#test:tag max-usable-range
//#test:device L500*

#include "../../func-common.h"

// Test group description:
//       * This tests group verifies depth sensor max usable range option restrictions,
//         according to [RS-8358]
//
// Current test description:
//       * Enabling Max Usable Range option while streaming require Visual Preset = 'Max Range' ,
//         If not an exception should be thrown
//       * Enabling Max Usable Range option while streaming require Sensor Mode = 'VGA' 
//         If not an exception should be thrown
//       * Reading Max Usable Range while Max Usable Range option is off or not streaming - expect exception thrown
//       
// Note: * L515 specific test
//       * Test will pass if no L515 device is connected
//       * Test will be performed on the first L515 device detected.

TEST_CASE( "Max Usable Range option require Max Range Preset while streaming",
           "[max-usable-range]" )
{
    auto depth_sensor
        = find_first_supported_depth_sensor_or_exit( "L515", RS2_OPTION_ENABLE_MAX_USABLE_RANGE );
    auto mur = depth_sensor.as< rs2::max_usable_range_sensor >();
    REQUIRE(mur);
    mur.set_option( RS2_OPTION_VISUAL_PRESET, RS2_L500_VISUAL_PRESET_LOW_AMBIENT );
    auto depth_vga_profile
        = get_profile_by_stream_parameters( mur, RS2_STREAM_DEPTH, RS2_FORMAT_Z16, 640, 480, 30 );

    REQUIRE( depth_vga_profile );

    mur.open( depth_vga_profile );
    mur.start( []( rs2::frame f ) {} );
    // Verify failure when visual preset != Max Range
    CHECK_THROWS( mur.set_option( RS2_OPTION_ENABLE_MAX_USABLE_RANGE, 1.f ) );
    // Verify stay off
    CHECK_FALSE( mur.get_option( RS2_OPTION_ENABLE_MAX_USABLE_RANGE ) );

    mur.stop();
    mur.close();
}

TEST_CASE("Max Usable Range option require VGA sensor mode while streaming", "[max-usable-range]")
{
    auto depth_sensor
        = find_first_supported_depth_sensor_or_exit("L515", RS2_OPTION_ENABLE_MAX_USABLE_RANGE);
    auto mur = depth_sensor.as< rs2::max_usable_range_sensor >();
    REQUIRE(mur);
    mur.set_option(RS2_OPTION_VISUAL_PRESET, RS2_L500_VISUAL_PRESET_MAX_RANGE);
    auto profiles = mur.get_stream_profiles();
    // Find a profile that sensor mode != VGA
    auto non_vga_depth_profile
        = std::find_if(profiles.begin(), profiles.end(), [](rs2::stream_profile sp) {
        auto vp = sp.as< rs2::video_stream_profile >();

        return ((sp.stream_type() == RS2_STREAM_DEPTH) && (sp.format() == RS2_FORMAT_Z16)
            && (vp.width() != 640) && (vp.height() != 480));
            });

    REQUIRE(non_vga_depth_profile != profiles.end());
    mur.open(*non_vga_depth_profile);

    mur.start([](rs2::frame f) {});
    // Verify failure when sensor mode != VGA
    CHECK_THROWS(mur.set_option(RS2_OPTION_ENABLE_MAX_USABLE_RANGE, 1.f));
    // Verify stay off
    CHECK_FALSE(mur.get_option(RS2_OPTION_ENABLE_MAX_USABLE_RANGE));

    mur.stop();
    mur.close();
}

TEST_CASE("Reading Max Usable Range while option is off or not streaming", "[max-usable-range]")
{
    auto depth_sensor
        = find_first_supported_depth_sensor_or_exit("L515", RS2_OPTION_ENABLE_MAX_USABLE_RANGE);
    auto mur = depth_sensor.as< rs2::max_usable_range_sensor >();
    REQUIRE(mur);
    auto depth_vga_profile
        = get_profile_by_stream_parameters( mur, RS2_STREAM_DEPTH, RS2_FORMAT_Z16, 640, 480, 30 );

    REQUIRE(depth_vga_profile);

    mur.open(depth_vga_profile);
    mur.start([](rs2::frame f) {});

    // Verify MUR option is off
    mur.set_option(RS2_OPTION_ENABLE_MAX_USABLE_RANGE, 0);

    // Verify function throws when MUR option is off
    CHECK_THROWS(mur.get_max_usable_depth_range());

    mur.stop();
    mur.close();

    // Turn on  MUR option
    mur.set_option(RS2_OPTION_ENABLE_MAX_USABLE_RANGE, 1);

    // Verify function throws when not streaming
    CHECK_THROWS(mur.get_max_usable_depth_range());

}