Merge branch 'master' of https://github.com/adafruit/adafruit-beaglebone-io-python

Author: jpbarraca

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,47 @@
+Thank you for opening an issue on an Adafruit Python library repository.  To
+improve the speed of resolution please review the following guidelines and
+common troubleshooting steps below before creating the issue:
+
+- **Do not use GitHub issues for troubleshooting projects and issues.**  Instead use
+  the forums at http://forums.adafruit.com to ask questions and troubleshoot why
+  something isn't working as expected.  In many cases the problem is a common issue
+  that you will more quickly receive help from the forum community.  GitHub issues
+  are meant for known defects in the code.  If you don't know if there is a defect
+  in the code then start with troubleshooting on the forum first.
+
+- **If following a tutorial or guide be sure you didn't miss a step.** Carefully
+  check all of the steps and commands to run have been followed.  Consult the
+  forum if you're unsure or have questions about steps in a guide/tutorial.
+
+- **For Python/Raspberry Pi projects check these very common issues to ensure they don't apply**:
+
+  - If you are receiving an **ImportError: No module named...** error then a
+    library the code depends on is not installed.  Check the tutorial/guide or
+    README to ensure you have installed the necessary libraries.  Usually the
+    missing library can be installed with the `pip` tool, but check the tutorial/guide
+    for the exact command.  
+
+  - **Be sure you are supplying adequate power to the board.**  Check the specs of
+    your board and power in an external power supply.  In many cases just
+    plugging a board into your computer is not enough to power it and other
+    peripherals.
+
+  - **Double check all soldering joints and connections.**  Flakey connections
+    cause many mysterious problems.  See the [guide to excellent soldering](https://learn.adafruit.com/adafruit-guide-excellent-soldering/tools) for examples of good solder joints.
+
+If you're sure this issue is a defect in the code and checked the steps above
+please fill in the following fields to provide enough troubleshooting information.
+You may delete the guideline and text above to just leave the following details:
+
+- Platform/operating system (i.e. Raspberry Pi with Raspbian operating system,
+  Windows 32-bit, Windows 64-bit, Mac OSX 64-bit, etc.):  **INSERT PLATFORM/OPERATING
+  SYSTEM HERE**
+
+- Python version (run `python -version` or `python3 -version`):  **INSERT PYTHON
+  VERSION HERE**
+
+- Error message you are receiving, including any Python exception traces:  **INSERT
+  ERROR MESAGE/EXCEPTION TRACES HERE***
+
+- List the steps to reproduce the problem below (if possible attach code or commands
+  to run): **LIST REPRO STEPS BELOW**

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,26 @@
+Thank you for creating a pull request to contribute to Adafruit's GitHub code!
+Before you open the request please review the following guidelines and tips to
+help it be more easily integrated:
+
+- **Describe the scope of your change--i.e. what the change does and what parts
+  of the code were modified.**  This will help us understand any risks of integrating
+  the code.
+
+- **Describe any known limitations with your change.**  For example if the change
+  doesn't apply to a supported platform of the library please mention it.
+
+- **Please run any tests or examples that can exercise your modified code.**  We
+  strive to not break users of the code and running tests/examples helps with this
+  process.
+
+Thank you again for contributing!  We will try to test and integrate the change
+as soon as we can, but be aware we have many GitHub repositories to manage and
+can't immediately respond to every request.  There is no need to bump or check in
+on a pull request (it will clutter the discussion of the request).
+
+Also don't be worried if the request is closed or not integrated--sometimes the
+priorities of Adafruit's GitHub code (education, ease of use) might not match the
+priorities of the pull request.  Don't fret, the open source community thrives on
+forks and GitHub makes it easy to keep your changes in a forked repo.
+
+After reviewing the guidelines above you can delete this text from the pull request.

.gitignore

@@ -28,3 +28,7 @@ nosetests.xml
 
 # Translations
 *.mo
+
+# Annoying MacOSX files.
+.DS_Store
+._.DS_Store

.travis.yml

@@ -0,0 +1,5 @@
+language: python
+install:
+  - pip install tox 
+script:
+  - tox

Adafruit_I2C.py

@@ -4,8 +4,8 @@
 
 # ===========================================================================
 # Adafruit_I2C Class
-# Adafruit_I2C.py is essentially a fork of the Adafruit Raspberry Pi I2C module. 
-# Any pull requests for this module should be directed to the following, and I 
+# Adafruit_I2C.py is essentially a fork of the Adafruit Raspberry Pi I2C module.
+# Any pull requests for this module should be directed to the following, and I
 # can pull them. I'd rather not deviate from the original:
 # https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code/tree/master/Adafruit_I2C
 # ===========================================================================
@@ -28,59 +28,59 @@ def reverseByteOrder(self, data):
     return val
 
   def errMsg(self):
-    print "Error accessing 0x%02X: Check your I2C address" % self.address
+    print("Error accessing 0x%02X: Check your I2C address" % self.address)
     return -1
 
   def write8(self, reg, value):
     "Writes an 8-bit value to the specified register/address"
     try:
       self.bus.write_byte_data(self.address, reg, value)
       if self.debug:
-        print "I2C: Wrote 0x%02X to register 0x%02X" % (value, reg)
-    except IOError, err:
+        print("I2C: Wrote 0x%02X to register 0x%02X" % (value, reg))
+    except IOError as err:
       return self.errMsg()
 
   def write16(self, reg, value):
     "Writes a 16-bit value to the specified register/address pair"
     try:
       self.bus.write_word_data(self.address, reg, value)
       if self.debug:
-        print ("I2C: Wrote 0x%02X to register pair 0x%02X,0x%02X" %
+        print("I2C: Wrote 0x%02X to register pair 0x%02X,0x%02X" %
          (value, reg, reg+1))
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def writeList(self, reg, list):
     "Writes an array of bytes using I2C format"
     try:
       if self.debug:
-        print "I2C: Writing list to register 0x%02X:" % reg
-        print list
+        print("I2C: Writing list to register 0x%02X:" % reg)
+        print(list)
       self.bus.write_i2c_block_data(self.address, reg, list)
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def readList(self, reg, length):
     "Read a list of bytes from the I2C device"
     try:
       results = self.bus.read_i2c_block_data(self.address, reg, length)
       if self.debug:
-        print ("I2C: Device 0x%02X returned the following from reg 0x%02X" %
+        print("I2C: Device 0x%02X returned the following from reg 0x%02X" %
          (self.address, reg))
-        print results
+        print(results)
       return results
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def readU8(self, reg):
     "Read an unsigned byte from the I2C device"
     try:
       result = self.bus.read_byte_data(self.address, reg)
       if self.debug:
-        print ("I2C: Device 0x%02X returned 0x%02X from reg 0x%02X" %
+        print("I2C: Device 0x%02X returned 0x%02X from reg 0x%02X" %
          (self.address, result & 0xFF, reg))
       return result
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def readS8(self, reg):
@@ -89,35 +89,35 @@ def readS8(self, reg):
       result = self.bus.read_byte_data(self.address, reg)
       if result > 127: result -= 256
       if self.debug:
-        print ("I2C: Device 0x%02X returned 0x%02X from reg 0x%02X" %
+        print("I2C: Device 0x%02X returned 0x%02X from reg 0x%02X" %
          (self.address, result & 0xFF, reg))
       return result
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def readU16(self, reg):
     "Reads an unsigned 16-bit value from the I2C device"
     try:
       result = self.bus.read_word_data(self.address,reg)
       if (self.debug):
-        print "I2C: Device 0x%02X returned 0x%04X from reg 0x%02X" % (self.address, result & 0xFFFF, reg)
+        print("I2C: Device 0x%02X returned 0x%04X from reg 0x%02X" % (self.address, result & 0xFFFF, reg))
       return result
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
   def readS16(self, reg):
     "Reads a signed 16-bit value from the I2C device"
     try:
       result = self.bus.read_word_data(self.address,reg)
       if (self.debug):
-        print "I2C: Device 0x%02X returned 0x%04X from reg 0x%02X" % (self.address, result & 0xFFFF, reg)
+        print("I2C: Device 0x%02X returned 0x%04X from reg 0x%02X" % (self.address, result & 0xFFFF, reg))
       return result
-    except IOError, err:
+    except IOError as err:
       return self.errMsg()
 
 if __name__ == '__main__':
   try:
     bus = Adafruit_I2C(address=0)
-    print "Default I2C bus is accessible"
+    print("Default I2C bus is accessible")
   except:
-    print "Error accessing default I2C bus"
+    print("Error accessing default I2C bus")

CHANGELOG.rst

@@ -1,3 +1,21 @@
+1.0.0
+----
+* Merge pull request #108 from MatthewWest for PWM support in Linux kernel 4.1+
+* Merge pull request #96 from  PeteLawler for ADC support in Linux kernel 4.1+
+* Finally publish new version to PyPi 
+* Bump major version number to signify long duration since last release
+
+0.0.30
+-----
+* Merge Python 3 compatibility fixes from Github user westphahl.
+* Moved old Angstrom build fix for missing py_compile from setup.py to separate file.
+
+0.0.20
+----
+* Fix for SPI not loading spidevX.X correctly based on load order
+* Initialize ctrl_dir in unload_device_tree #63
+* Clean up unused/dead code
+
 0.0.19
 ----
 * Fix for SPI.xfer crashes python after 3 calls

Makefile

@@ -17,3 +17,16 @@ build:
 
 install: build
 	python setup.py install --force
+
+build2:
+	python2 setup.py build --force
+
+install2: build2
+	python2 setup.py install --force
+
+build3:
+	python3 setup.py build --force
+
+install3: build3
+	python3 setup.py install --force
+

README.rst

@@ -70,6 +70,28 @@ Setup the pin for output, and write GPIO.HIGH or GPIO.LOW. Or you can use 1 or 0
 
     import Adafruit_BBIO.GPIO as GPIO
     GPIO.setup("P8_14", GPIO.OUT) GPIO.output("P8_14", GPIO.HIGH)
+
+**On-Board LEDs**
+
+On-board LEDs (USR0-USR3) are handled by LED class driver rather than the GPIO pin driver.
+
+They have a different path in the /sys/ filesystem.
+
+Setup the pin for output and write GPIO.HIGH or GPIO.LOW::
+
+    import Adafruit_BBIO.GPIO as GPIO
+    import time
+    
+    for i in range(4):
+        GPIO.setup("USR%d" % i, GPIO.OUT)
+
+    while True:
+        for i in range(4):
+            GPIO.output("USR%d" % i, GPIO.HIGH)
+            time.sleep(1)
+        for i in range(4):
+            GPIO.output("USR%d" % i, GPIO.LOW)
+            time.sleep(1)
     
 **GPIO Input**
 

fix_py_compile.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python2
+# Some Angstrom images are missing the py_compile module; get it if not
+# present:
+# Fix credit:https://github.com/alexanderhiam/PyBBIO/blob/master/setup.py
+import random, os
+python_lib_path = random.__file__.split('random')[0]
+if not os.path.exists(python_lib_path + 'py_compile.py'):
+  print "py_compile module missing; installing to %spy_compile.py" %\
+                                                          python_lib_path
+  import urllib2
+  url = "http://hg.python.org/cpython/raw-file/4ebe1ede981e/Lib/py_compile.py"
+  py_compile = urllib2.urlopen(url)
+  with open(python_lib_path+'py_compile.py', 'w') as f:
+    f.write(py_compile.read())
+  print "testing py_compile..."
+  try:
+    import py_compile
+    print "py_compile installed successfully"
+  except Exception, e:
+    print "*py_compile install failed, could not import"
+    print "*Exception raised:"
+    raise e

overlays/ADAFRUIT-SPI0-00A0.dts

@@ -10,6 +10,14 @@
     /* version */
     version = "00A0";
 
+    exclusive-use =
+        /* the pin header uses */
+        "P9.17",
+        "P9.18",
+        "P9.21",
+        "P9.22",
+        "spi0";
+
     fragment@0 {
         target = <&am33xx_pinmux>;
         __overlay__ {