GPIO
====

.. py:module:: Nets
    :noindex:

.. py:class:: GPIO
    
    Class for controlling GPIO nets

    .. py:method:: set(self, mode)

        Set GPIO Mode

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

            from lager.pcb.net import Net, NetType

            reset = Net.get('RESET',
                        type=NetType.GPIO,
                        setup_function=None,
                        teardown_function=None)
            reset.enable()
            reset.set(GPIOMode.OUT)

        :param GPIOMode mode: Set mode of GPIO trace

    .. py:method:: output(self, level)

        Set GPIO Output Level

        .. code-block:: python
            :emphasize-lines: 9,10,11,12

            from lager.pcb.net import Net, NetType

            reset = Net.get('RESET',
                        type=NetType.GPIO,
                        setup_function=None,
                        teardown_function=None)
            reset.enable()
            reset.set(GPIOMode.OUT)
            reset.output(GPIOLevel.HIGH) # can use High/Low
            reset.output(GPIOLevel.LOW) 
            reset.output(GPIOLevel.ON) # or On/Off
            reset.output(GPIOLevel.OFF)                                 

        :param GPIOLevel level: Set level for GPIO output nets   

    .. py:method:: input(self)

        Read GPIO level

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

            from lager.pcb.net import Net, NetType

            stat = Net.get('STAT',
                        type=NetType.GPIO,
                        setup_function=None,
                        teardown_function=None)
            stat.enable()
            stat.set(GPIOMode.IN)
            level = stat.input()
            print(level)                                

        :return: gpio level
        :rtype: GPIOLevel      

.. py:class:: GPIOMode(enum)

    GPIO as input or as output

    .. py:data:: IN

    .. py:data:: OUT

.. py:class:: GPIOLevel(enum)

    .. py:data:: ON

    .. py:data:: OFF

    .. py:data:: HIGH

    .. py:data:: LOW