summaryrefslogtreecommitdiffstatshomepage
path: root/docs/library/pyb.Switch.rst
blob: 347c2615ea8b61be0bcefd8b75998826e60e0a54 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
class Switch --- switch object
==============================

A Switch object is used to control a push-button switch.

Usage::

     sw = pyb.Switch()       # create a switch object
     sw()                    # get state (True if pressed, False otherwise)
     sw.callback(f)          # register a callback to be called when the
                             #   switch is pressed down
     sw.callback(None)       # remove the callback

Example::

     pyb.Switch().callback(lambda: pyb.LED(1).toggle())


Constructors
------------

.. class:: pyb.Switch()

   Create and return a switch object.


Methods
-------

.. method:: switch()

   Return the switch state: ``True`` if pressed down, ``False`` otherwise.

.. method:: switch.callback(fun)

   Register the given function to be called when the switch is pressed down.
   If ``fun`` is ``None``, then it disables the callback.