Logic
=====

.. py:module:: Nets
    :noindex:

.. py:class:: Logic

    Signals that can be insepected with a logic analyzer

    .. py:method:: start_capture()

        Start capturing logic of net's waveform.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Logic,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.start_capture()     

    .. py:method:: stop_capture()

        Stop capturing logic of net's waveform.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Logic,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.stop_capture()            

    .. py:method:: start_single_capture()

        Start capture logic of net's waveform, but then stop after first capture.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.start_single_capture()             

    .. py:method:: trigger_force()

        Force a trigger to capture the net's waveform.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.trigger_force()

    .. py:method:: size_large()

        Set the size of the waveform on logic analyzer screen to largest.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.size_large()

    .. py:method:: size_medium()

        Set the size of the waveform on logic analyzer screen to medium.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.size_medium()

    .. py:method:: size_small()

        Set the size of the waveform on logic analyzer screen to small.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()
            sda_net.size_small()

    .. py:method:: set_signal_threshold(voltage)

        Set minimum signal voltage threshold for logic analyzer to capture in volts.

        .. code-block:: python
            :emphasize-lines: 8

            from lager import Net, NetType

            sda_net = Net.get('I2C.SDA',
                        type=NetType.Analog,
                        setup_function=setup_net,
                        teardown_function=teardown_net)
            sda_net.enable()                        
            sda_net.set_signal_threshold(1.5)

        :param float voltage: threshold voltage