mirror of
https://github.com/KevinMidboe/python-gpiozero.git
synced 2025-10-29 17:50:37 +00:00
This PR adds a software SPI implementation. Firstly this removes the absolute necessity for spidev (#140), which also means when it's not present things still work (effectively fixes #185), and also enables any four pins to be used for SPI devices (which don't require the hardware implementation). The software implementation is simplistic but still supports clock polarity and phase, select-high, and variable bits per word. However it doesn't allow precise speeds to be implemented because it just wibbles the clock as fast as it can (which being pure Python isn't actually that fast). Finally, because this PR involves creating a framework for "shared" devices (like SPI devices with multiple channels), it made sense to bung Energenie (#69) in as wells as this is a really simple shared device.
112 lines
3.9 KiB
Python
112 lines
3.9 KiB
Python
from __future__ import (
|
|
unicode_literals,
|
|
print_function,
|
|
absolute_import,
|
|
division,
|
|
)
|
|
str = type('')
|
|
|
|
|
|
class GPIOZeroError(Exception):
|
|
"Base class for all exceptions in GPIO Zero"
|
|
|
|
class DeviceClosed(GPIOZeroError):
|
|
"Error raised when an operation is attempted on a closed device"
|
|
|
|
class CompositeDeviceError(GPIOZeroError):
|
|
"Base class for errors specific to the CompositeDevice hierarchy"
|
|
|
|
class CompositeDeviceBadName(CompositeDeviceError, ValueError):
|
|
"Error raised when a composite device is constructed with a reserved name"
|
|
|
|
class EnergenieSocketMissing(CompositeDeviceError, ValueError):
|
|
"Error raised when socket number is not specified"
|
|
|
|
class EnergenieBadSocket(CompositeDeviceError, ValueError):
|
|
"Error raised when an invalid socket number is passed to :class:`Energenie`"
|
|
|
|
class SPIError(GPIOZeroError):
|
|
"Base class for errors related to the SPI implementation"
|
|
|
|
class SPIBadArgs(SPIError, ValueError):
|
|
"Error raised when invalid arguments are given while constructing :class:`SPIDevice`"
|
|
|
|
class GPIODeviceError(GPIOZeroError):
|
|
"Base class for errors specific to the GPIODevice hierarchy"
|
|
|
|
class GPIODeviceClosed(GPIODeviceError):
|
|
"Deprecated descendent of :exc:`DeviceClosed`"
|
|
|
|
class GPIOPinInUse(GPIODeviceError):
|
|
"Error raised when attempting to use a pin already in use by another device"
|
|
|
|
class GPIOPinMissing(GPIODeviceError, ValueError):
|
|
"Error raised when a pin number is not specified"
|
|
|
|
class GPIOBadQueueLen(GPIODeviceError, ValueError):
|
|
"Error raised when non-positive queue length is specified"
|
|
|
|
class GPIOBadSampleWait(GPIODeviceError, ValueError):
|
|
"Error raised when a negative sampling wait period is specified"
|
|
|
|
class GPIOBadSourceDelay(GPIODeviceError, ValueError):
|
|
"Error raised when a negative source delay is specified"
|
|
|
|
class InputDeviceError(GPIODeviceError):
|
|
"Base class for errors specific to the InputDevice hierarchy"
|
|
|
|
class OutputDeviceError(GPIODeviceError):
|
|
"Base class for errors specified to the OutputDevice hierarchy"
|
|
|
|
class OutputDeviceBadValue(OutputDeviceError, ValueError):
|
|
"Error raised when ``value`` is set to an invalid value"
|
|
|
|
class PinError(GPIOZeroError):
|
|
"Base class for errors related to pin implementations"
|
|
|
|
class PinFixedFunction(PinError, AttributeError):
|
|
"Error raised when attempting to change the function of a fixed type pin"
|
|
|
|
class PinInvalidFunction(PinError, ValueError):
|
|
"Error raised when attempting to change the function of a pin to an invalid value"
|
|
|
|
class PinInvalidState(PinError, ValueError):
|
|
"Error raised when attempting to assign an invalid state to a pin"
|
|
|
|
class PinInvalidPull(PinError, ValueError):
|
|
"Error raised when attempting to assign an invalid pull-up to a pin"
|
|
|
|
class PinInvalidEdges(PinError, ValueError):
|
|
"Error raised when attempting to assign an invalid edge detection to a pin"
|
|
|
|
class PinInvalidBounce(PinError, ValueError):
|
|
"Error raised when attempting to assign an invalid bounce time to a pin"
|
|
|
|
class PinSetInput(PinError, AttributeError):
|
|
"Error raised when attempting to set a read-only pin"
|
|
|
|
class PinFixedPull(PinError, AttributeError):
|
|
"Error raised when attempting to set the pull of a pin with fixed pull-up"
|
|
|
|
class PinEdgeDetectUnsupported(PinError, AttributeError):
|
|
"Error raised when attempting to use edge detection on unsupported pins"
|
|
|
|
class PinPWMError(PinError):
|
|
"Base class for errors related to PWM implementations"
|
|
|
|
class PinPWMUnsupported(PinPWMError, AttributeError):
|
|
"Error raised when attempting to activate PWM on unsupported pins"
|
|
|
|
class PinPWMFixedValue(PinPWMError, AttributeError):
|
|
"Error raised when attempting to initialize PWM on an input pin"
|
|
|
|
class GPIOZeroWarning(Warning):
|
|
"Base class for all warnings in GPIO Zero"
|
|
|
|
class SPIWarning(GPIOZeroWarning):
|
|
"Base class for warnings related to the SPI implementation"
|
|
|
|
class SPISoftwareFallback(SPIWarning):
|
|
"Warning raised when falling back to the software implementation"
|
|
|