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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
"""Collection of abstract classes for type hinting in the rest of the project.
(For students: don't worry about the code that's in here.
These classes are just providing examples of how to use the proximity sensor,
the LED controller, and the touch sensor for type hinting.
The actual implementations of the classes are on the device.
You'll learn more about abstract classes in CS2.)
"""
# We aren't using the abc module because it isn't available on circuitpy.
class ProximitySensor:
"""Abstract proximity sensor."""
@property
def proximity(self) -> int:
"""Integer in [0, 255] indicating proximity of object to sensor.
Lower is farther away and higher is closer.
Example:
`apds.proximity`
"""
raise NotImplementedError
class LEDController:
"""Abstract LED controller."""
def fill(self, color: tuple[int, int, int]) -> None:
"""Change the color of the LED being controlled.
Args:
color: Three-tuple of integers in [0, 255] representing the values
of red, green, and blue to display on the LED.
Example:
`px.fill((0, 0, 0))` turns the LED off
"""
raise NotImplementedError
class TouchSensor:
"""Abstract touch sensor."""
@property
def value(self) -> bool:
"""If the sensor is being touched.
Example:
`touch.value`
"""
raise NotImplementedError