"""generic_agnostic_board pin interface"""
import random
+# Values for sine wave
+# (data points = 20, amplitude=100, frequency=1)
+sine_wave = [
+ 0,
+ 31,
+ 59,
+ 81,
+ 95,
+ 100,
+ 95,
+ 81,
+ 59,
+ 31,
+ 0,
+ -31,
+ -59,
+ -81,
+ -95,
+ -100,
+ -95,
+ -81,
+ -59,
+ -31,
+]
+
+# Values for a sawtooth wave
+# (data points = 20, amplitude=100)
+sawtooth_wave = [
+ -100,
+ -80,
+ -60,
+ -40,
+ -20,
+ 0,
+ 20,
+ 40,
+ 60,
+ 80,
+ -100,
+ -80,
+ -60,
+ -40,
+ -20,
+ 0,
+ 20,
+ 40,
+ 60,
+ 80,
+]
+
class Pin:
"""A basic Pin class for use with generic_agnostic_board"""
# pin values
LOW = 0
HIGH = 1
+ # pin pulls
+ PULL_NONE = 0
+ PULL_UP = 1
+ PULL_DOWN = 2
def return_toggle(self):
"""Returns the pin's expected value, toggling between True and False"""
"""Returns the first five digits of Pi, 31415"""
return 31415
+ def return_sine_wave(self):
+ """Returns the next value in the sine wave"""
+ if self._wave_idx is None:
+ self._wave_idx = 0
+ else:
+ self._wave_idx = (self._wave_idx + 1) % len(sine_wave)
+ return sine_wave[self._wave_idx]
+
+ def return_sawtooth_wave(self):
+ """Returns the next value in the sawtooth wave"""
+ if self._wave_idx is None:
+ self._wave_idx = 0
+ else:
+ self._wave_idx = (self._wave_idx + 1) % len(sawtooth_wave)
+ return sawtooth_wave[self._wave_idx]
+
def __init__(self, pin_id=None):
self.id = pin_id
self._mode = None
- self.previous_value = None
+ self._pull = None
+ self.previous_value = False
self.current_value = None
- # TODO: Can we simplify the pin behavior dict and the pin map dict?
+ self._wave_idx = None
+
# mapping of pin definition names to expected behavior
- self.expected_pin_behavior = {
- "Dx_INPUT_TRUE": self.return_true,
- "Dx_INPUT_FALSE": self.return_false,
- "Dx_INPUT_TRUE_THEN_FALSE": self.return_toggle,
- "Dx_INPUT_TRUE_PULL_UP": self.return_true,
- "Dx_INPUT_TRUE_PULL_DOWN": self.return_true,
- "Dx_OUTPUT_TRUE": self.return_true,
- "Dx_OUTPUT_FALSE": self.return_false,
- "Ax_INPUT_RAND_INT": self.return_random_int,
- }
- # mapping of pin numbers to pin definition names
- self.pin_number_to_pin_definition_name = {
- 0: "Dx_INPUT_TRUE",
- 1: "Dx_INPUT_FALSE",
- 2: "Dx_INPUT_TRUE_PULL_UP",
- 3: "Dx_INPUT_TRUE_PULL_DOWN",
- 4: "Dx_OUTPUT_TRUE",
- 5: "Dx_OUTPUT_FALSE",
- 6: "NEOPIXEL",
- 7: "Ax_INPUT_RAND_INT",
- 8: "Ax_INPUT_FIXED_INT_PI",
- 9: "Ax_OUTPUT_WAVE_SINE",
- 10: "Ax_OUTPUT_WAVE_SAWTOOTH",
+ self.pin_behavior = {
+ 0: self.return_true, # Dx_INPUT_TRUE
+ 1: self.return_false, # Dx_INPUT_FALSE
+ 2: self.return_true, # Dx_INPUT_TRUE_PULL_UP
+ 3: self.return_true, # Dx_INPUT_TRUE_PULL_DOWN
+ 4: self.return_true, # Dx_OUTPUT
+ 7: self.return_random_int, # Ax_INPUT_RAND_INT
+ 8: self.return_fixed_int_pi, # Ax_INPUT_FIXED_INT_PI
+ 9: self.return_sine_wave, # Ax_INPUT_WAVE_SINE
+ 10: self.return_sawtooth_wave, # Ax_INPUT_WAVE_SAW
+ 11: self.return_toggle, # Dx_INPUT_TOGGLE
}
def init(self, mode=IN, pull=None):
"""Initialize the Pin"""
if self.id is None:
raise RuntimeError("Can not init a None type pin.")
- if pull is not None:
- raise NotImplementedError("Internal pullups and pulldowns not supported")
+ pull = Pin.PULL_NONE if pull is None else pull
+ self._pull = pull
self._mode = mode
def write(self, new_value):
def read(self):
"""Returns the pin's expected value."""
self.previous_value = self.current_value
- # lookup the pin id's name from the mapping
- pin_name = self.pin_number_to_pin_definition_name.get(self.id)
- if pin_name:
- self.current_value = self.expected_pin_behavior[pin_name]()
- else: # default to False if the pin is not in the mapping
+ # perform a lookup on the pin_behavior dict to get the value
+ self.current_value = self.pin_behavior.get(self.id)()
+
+ # is pin a pull up and pin is LOW?
+ if self._pull == Pin.PULL_UP and self.current_value == False:
+ self.current_value = False
+ # is pin a pull down and pin is HIGH?
+ if self._pull == Pin.PULL_DOWN and self.current_value == True:
self.current_value = False
return self.current_value
# Analog Out
if self._mode == Pin.DAC:
if val is None:
- # write only
- raise AttributeError("unreadable attribute")
+ self.previous_value = self.current_value
+ return self.current_value
self.write(val)
return None
raise RuntimeError(
D2 = Pin(2)
D3 = Pin(3)
D4 = Pin(4)
-D5 = Pin(5)
# Special "digital" pins
D6 = Pin(6)
# Analog pins
A1 = Pin(8)
A2 = Pin(9)
A3 = Pin(10)
+A4 = Pin(12)
+
+D7 = Pin(11)
# I2C pins
SDA = Pin()