step.calibration.calibrate_wfl_dsl
==================================

.. py:module:: step.calibration.calibrate_wfl_dsl

.. autoapi-nested-parse::

   Auto-generated step builders and DSL functions — DO NOT EDIT.

   Source: calibrate_wfl.py



Classes
-------

.. autoapisummary::

   step.calibration.calibrate_wfl_dsl.CalibrateWaitForLightBuilder


Functions
---------

.. autoapisummary::

   step.calibration.calibrate_wfl_dsl.calibrate_wait_for_light


Module Contents
---------------

.. py:class:: CalibrateWaitForLightBuilder

   Bases: :py:obj:`raccoon.step.step_builder.StepBuilder`


   Builder for CalibrateWaitForLight. Auto-generated — do not edit.


   .. py:method:: sensor(value: raccoon.hal.AnalogSensor)


.. py:function:: calibrate_wait_for_light(sensor: raccoon.hal.AnalogSensor = _UNSET)

   Calibrate a wait-for-light sensor via interactive measurement.

   Guides the operator through a two-step measurement flow: first cover
   the sensor (dark reading), then expose it to the start lamp (light
   reading). The midpoint threshold is computed and stored so the
   ``wait_for_light_legacy`` step can detect the lamp signal.

   The operator can retry measurements if the values look wrong before
   confirming the calibration.

   :param sensor: The AnalogSensor instance to calibrate.

   :returns: A CalibrateWaitForLightBuilder (chainable via ``.sensor()``, ``.on_anomaly()``, ``.skip_timing()``).

   Example::

       from raccoon.step.calibration import calibrate_wait_for_light

       calibrate_wait_for_light(robot.defs.wait_for_light_sensor)