.. _state_led_reset:

state_led_reset
------------------------------------------
This function resets the robot's **state LED** to its default configuration and color.  
It clears any previously set LED state or user-defined color and restores  
the LED behavior defined by the default controller settings.

Available in Auto mode only, on controller v3.4 or later. In other modes, or on an older controller, the function returns false. The mode check uses the value returned by :ref:`get_robot_mode <get_robot_mode>`.

**Definition** |br|
``DRFLEx.h`` within class `CDRFLEx`, public section

.. code-block:: cpp

    bool state_led_reset()
    {
        return _state_led_reset(_rbtCtrl);
    };

**Parameter** |br|
None

**Return**

.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - **Value**
     - **Description**
   * - 0
     - Fail — LED reset request failed
   * - 1
     - Success — LED successfully reset to default state

.. Note::

   A return of true does not confirm that the LED changed.

**Example**

.. code-block:: cpp

    // Assumes control authority is held; the LED functions work only in Auto mode
    if (!Drfl.set_robot_mode(ROBOT_MODE_AUTONOMOUS)) {
        printf("set_robot_mode failed.\n");
        return 1;
    }

    // Indicate that the robot is in "operation" mode by setting LED to green
    if (Drfl.set_state_led_color(0, 1, 0))  // Green color
        printf("LED set to green: robot in operation mode.\n");

    // Simulate task execution (e.g., motion or pick & place)
    std::this_thread::sleep_for(std::chrono::seconds(3));

    // Indicate task completion by setting LED to blue
    if (Drfl.set_state_led_color(0, 0, 1))  // Blue color
        printf("LED set to blue: task complete.\n");

    // After finishing all operations, reset LED to default system color
    if (Drfl.state_led_reset())
        printf("LED reset to default system color.\n");

This example simulates LED usage for visual task indication.  
The LED is set to **green** during operation, changed to **blue** upon completion,  
and finally reset to its default color configuration using `state_led_reset()`.