D430 Alternating emitter (on/off) mode control

[ev-mp]

A new depth sensor feature introduced for D430, D435 and D435i devices (Global shutter/ Active):

Setting laser into (per-frame) on/off alternating mode.

Mode of operation:

• (a) Turn on laser emitter (RS2_OPTION_EMITTER_ENABLED)
• (b) Toggle on the alternating emitter (RS2_OPTION_EMITTER_ON_OFF)

Limitations:

• Turning laser emitter off whilst alternating mode is active is not allowed
• Turning alternating mode on whilst laser emitter is off is not allowed

Per-frame illumination on/off can be established for depth and ir sensors via reading frame's metadata attribute:

...
auto fs = pipe.wait_for_frames();
auto df = fs.get_depth_frame();
if (df.supports_frame_metadata(RS2_FRAME_METADATA_FRAME_LASER_POWER_MODE))
auto emitter_on = df.get_frame_metadata(RS2_FRAME_METADATA_FRAME_LASER_POWER_MODE);

Requires FW version 5.12.0+

Fixes:
[Realsense-viewer] :

• Refresh all XU/PU controls on stream start/stop events.
• Enforce update of read-only options on stop to ensure that volatile controls (emitter_on_off) are updated in a timely manner
  [Windows]: - Fix backend timestamp generation for HID device

Tracked on: DSO-11825. in #482, #1299. This implementation is a further evolvement of PR2829

[drhalftone]

How do you get firmware 5.12.0?

[mhkabir]

@dorodnic @ev-mp Any updates on when the new firmware will be released?