Add link to an alternative Python library

port soft tone example from WiringPi

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "WiringPi"]
 	path = WiringPi
-	url = http://github.com/wiringPi/WiringPi
+	url = https://github.com/wiringPi/WiringPi

MANIFEST.in

@@ -1,5 +1,5 @@
 recursive-include WiringPi *.h
-include README.md
+include README.rst
 include LICENSE.txt
 include bindings.i
 include constants.py

Makefile

@@ -1,12 +0,0 @@
-all: bindings
-	python setup.py build
-
-bindings:
-	swig3.0 -python -threads wiringpi.i
-
-clean:
-	rm -rf build/
-	rm -rf dist/
-
-install:
-	sudo python setup.py install

README.md

@@ -1,90 +0,0 @@
-### Note
-
-This is an unofficial port of Gordon's WiringPi library. Please do not email Gordon if you have issues, he will not be able to help.
-
-For support, comments, questions, etc please join the WiringPi Discord channel: https://discord.gg/SM4WUVG
-
-# WiringPi for Python
-
-WiringPi: An implementation of most of the Arduino Wiring
-	functions for the Raspberry Pi
-
-WiringPi implements new functions for managing IO expanders.
-
-# Quick Install
-
-`pip install wiringpi`
-
-# Usage
-
-	import wiringpi
-	
-	wiringpi.wiringPiSetup() # For sequential pin numbering, one of these MUST be called before using IO functions
-	# OR
-	wiringpi.wiringPiSetupSys() # For /sys/class/gpio with GPIO pin numbering
-	# OR
-	wiringpi.wiringPiSetupGpio() # For GPIO pin numbering
-
-
-Setting up IO expanders (This example was tested on a quick2wire board with one digital IO expansion board connected via I2C):
-
-	wiringpi.mcp23017Setup(65,0x20)
-	wiringpi.pinMode(65,1)
-	wiringpi.digitalWrite(65,1)
-
-**General IO:**
-
-	wiringpi.pinMode(6,1) # Set pin 6 to 1 ( OUTPUT )
-	wiringpi.digitalWrite(6,1) # Write 1 ( HIGH ) to pin 6
-	wiringpi.digitalRead(6) # Read pin 6
-
-**Setting up a peripheral:**
-WiringPi2 supports expanding your range of available "pins" by setting up a port expander. The implementation details of
-your port expander will be handled transparently, and you can write to the additional pins ( starting from PIN_OFFSET >= 64 )
-as if they were normal pins on the Pi.
-
-	wiringpi.mcp23017Setup(PIN_OFFSET,I2C_ADDR)
-
-**Soft Tone**
-
-Hook a speaker up to your Pi and generate music with softTone. Also useful for generating frequencies for other uses such as modulating A/C.
-
-	wiringpi.softToneCreate(PIN)
-	wiringpi.softToneWrite(PIN,FREQUENCY)
-
-**Bit shifting:**
-
-	wiringpi.shiftOut(1,2,0,123) # Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2
-
-**Serial:**
-
-	serial = wiringpi.serialOpen('/dev/ttyAMA0',9600) # Requires device/baud and returns an ID
-	wiringpi.serialPuts(serial,"hello")
-	wiringpi.serialClose(serial) # Pass in ID
-
-**Full details at:**
-http://www.wiringpi.com
-
-# Manual Build
-
-## Get/setup repo
-```bash
-git clone --recursive https://github.com/WiringPi/WiringPi-Python.git
-cd WiringPi-Python
-```
-
-## Prerequisites
-To rebuild the bindings
-you **must** first have python-dev, python-setuptools and swig installed. Wiring Pi should also be installed system-wide
-for access to the `gpio` tool.
-```bash
-sudo apt-get install python-dev python-setuptools swig wiringpi
-```
-
-## Build & install with
-
-`sudo python setup.py install`
-
-Or Python 3:
-
-`sudo python3 setup.py install`

README.rst

@@ -0,0 +1,152 @@
+Note
+~~~~
+
+This is an unofficial port of Gordon's WiringPi library. Please do not
+email Gordon if you have issues, he will not be able to help.
+
+For support, comments, questions, etc please join the WiringPi Discord
+channel: https://discord.gg/SM4WUVG
+
+WiringPi for Python
+~~~~~~~~~~~~~~~~~~~
+
+WiringPi: An implementation of most of the Arduino Wiring functions for
+the Raspberry Pi.
+
+WiringPi implements new functions for managing IO expanders.
+
+**Alternative**
+
+* `GPIO Zero <https://github.com/gpiozero/gpiozero>`_ is another Python library for controlling GPIO.  It is installed by default in Raspberry Pi OS and is used in the `Raspberry Pi GPIO documentation <https://www.raspberrypi.org/documentation/usage/gpio/python/>`_.
+
+Quick Install
+=============
+
+.. image:: https://badge.fury.io/py/wiringpi.svg
+   :alt: PyPI version badge
+   :target: https://pypi.org/project/wiringpi/
+
+The library is packaged on PyPI and can be installed with pip:
+
+``pip install wiringpi``
+
+Usage
+=====
+
+.. code:: python
+
+    import wiringpi
+
+    # One of the following MUST be called before using IO functions:
+    wiringpi.wiringPiSetup()      # For sequential pin numbering
+    # OR
+    wiringpi.wiringPiSetupSys()   # For /sys/class/gpio with GPIO pin numbering
+    # OR
+    wiringpi.wiringPiSetupGpio()  # For GPIO pin numbering
+
+**General IO:**
+
+.. code:: python
+
+    wiringpi.pinMode(6, 1)       # Set pin 6 to 1 ( OUTPUT )
+    wiringpi.digitalWrite(6, 1)  # Write 1 ( HIGH ) to pin 6
+    wiringpi.digitalRead(6)      # Read pin 6
+
+**Setting up a peripheral:**
+
+WiringPi supports expanding your range of available "pins" by setting up
+a port expander. The implementation details of your port expander will
+be handled transparently, and you can write to the additional pins
+(starting from PIN\_OFFSET >= 64) as if they were normal pins on the Pi.
+
+.. code:: python
+
+    wiringpi.mcp23017Setup(PIN_OFFSET, I2C_ADDR)
+
+This example was tested on a quick2wire board with one digital IO
+expansion board connected via I2C:
+
+.. code:: python
+
+    wiringpi.mcp23017Setup(65, 0x20)
+    wiringpi.pinMode(65, 1)
+    wiringpi.digitalWrite(65, 1)
+
+**Soft Tone:**
+
+Hook a speaker up to your Pi and generate music with softTone. Also
+useful for generating frequencies for other uses such as modulating A/C.
+
+.. code:: python
+
+    wiringpi.softToneCreate(PIN)
+    wiringpi.softToneWrite(PIN, FREQUENCY)
+
+**Bit shifting:**
+
+.. code:: python
+
+    wiringpi.shiftOut(1, 2, 0, 123)  # Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2
+
+**Serial:**
+
+.. code:: python
+
+    serial = wiringpi.serialOpen('/dev/ttyAMA0', 9600)  # Requires device/baud and returns an ID
+    wiringpi.serialPuts(serial, "hello")
+    wiringpi.serialClose(serial)  # Pass in ID
+
+**SPI:**
+
+The ``wiringPiSPIDataRW()`` function needs to be passed a ``bytes``
+object in Python 3. In Python 2, it takes a string. The following should
+work in either Python 2 or 3:
+
+.. code:: python
+
+    wiringpi.wiringPiSPISetup(channel, speed)
+    buf = bytes([your data here])
+    retlen, retdata = wiringpi.wiringPiSPIDataRW(0, buf)
+
+Now, ``retlen`` will contain the number of bytes received/read by the
+call. ``retdata`` will contain the data itself, and in Python 3, ``buf``
+will have been modified to contain it as well (that won't happen in
+Python 2, because then ``buf`` is a string, and strings are immutable).
+
+**Full details of the API at:** http://www.wiringpi.com
+
+Manual Build
+============
+
+Get/setup repo
+--------------
+
+.. code:: bash
+
+    git clone --recursive https://github.com/WiringPi/WiringPi-Python.git
+    cd WiringPi-Python
+
+Don't forget the ``--recursive``; it is required to also pull in the
+WiringPi C code from its own repository.
+
+Prerequisites
+-------------
+
+To rebuild the bindings you **must** first have installed ``swig``,
+``python-dev``, and ``python-setuptools`` (or their ``python3-``
+equivalents). WiringPi should also be installed system-wide for access
+to the ``gpio`` tool.
+
+.. code:: bash
+
+    sudo apt-get install python-dev python-setuptools swig wiringpi
+
+Build & install with
+--------------------
+
+``sudo python setup.py install``
+
+Or Python 3:
+
+``sudo python3 setup.py install``
+

WiringPi

@@ -1 +1 @@
-Subproject commit c9476436016c995d3327e4765a73de7848d4af56
+Subproject commit e9821abdb4b4fe46a2ea9243471d339435fa7bde

constants.py

@@ -38,4 +38,10 @@ INT_EDGE_SETUP = 0;
 INT_EDGE_FALLING = 1;
 INT_EDGE_RISING = 2;
 INT_EDGE_BOTH = 3;
+
+# Shifting (from wiringShift.h)
+
+LSBFIRST = 0;
+MSBFIRST = 1;
+
 %}

examples/softtone.py

@@ -0,0 +1,16 @@
+# Test of the softTone module in wiringPi
+# Plays a scale out on pin 3 - connect pizeo disc to pin 3 & 0v
+import wiringpi
+
+PIN = 3
+
+SCALE = [262, 294, 330, 349, 392, 440, 494, 525]
+
+wiringpi.wiringPiSetup()
+wiringpi.softToneCreate(PIN)
+
+while True:
+    for idx in range(8):
+        print(idx)
+        wiringpi.softToneWrite(PIN, SCALE[idx])
+        wiringpi.delay(500)

setup.cfg

@@ -3,5 +3,5 @@ author = Philip Howard
 author_email = phil@gadgetoid.com
 url = https://github.com/WiringPi/WiringPi-Python/
 description = A python interface to WiringPi 2.0 library which allows for easily interfacing with the GPIO pins of the Raspberry Pi. Also supports i2c and SPI.
-long_description = file:README.md
+long_description = file:README.rst
 license = LGPL

setup.py

@@ -54,12 +54,13 @@ _wiringpi = Extension(
     '_wiringpi',
     include_dirs=['WiringPi/wiringPi','WiringPi/devLib'],
     sources=sources,
+    swig_opts=['-threads'],
     extra_link_args=['-lcrypt', '-lrt']
 )
 
 setup(
     name = 'wiringpi',
-    version = '2.44.4',
+    version = '2.60.1',
     ext_modules = [ _wiringpi ],
     py_modules = ["wiringpi"],
     install_requires=[],

wiringpi.i

@@ -60,12 +60,12 @@
 };
 
 // Grab a Python function object as a Python object.
-%typemap(in) PyObject *pyfunc {
+%typemap(in) PyObject *PyFunc {
-  if (!PyCallable_Check($1)) {
+  if (!PyCallable_Check($input)) {
       PyErr_SetString(PyExc_TypeError, "Need a callable object!");
       return NULL;
   }
-  $1 = $2;
+  $1 = $input;
 }
 
 %{