Added magic default serial port for pi2, pi3 and macos

Author: Thomas Preston

CHANGELOG

@@ -1,6 +1,11 @@
 Change Log
 ==========
 
+v0.8.1
+------
+- Figures out default serial port for Raspberry Pi 2 and below,
+  Raspberry Pi 3 and above and MacOS.
+
 v0.8.0
 ------
 - Added servo support.

codebug_tether/core.py

@@ -6,7 +6,27 @@
 from codebug_tether.serial_channel_device import SerialChannelDevice
 
 
-DEFAULT_SERIAL_PORT = '/dev/ttyACM0'
+# setup default serial port (different on MacOS and >=Raspberry Pi 3)
+if os.uname().sysname == 'Darwin':
+    # OSX
+    DEFAULT_SERIAL_PORT = '/dev/tty.USBmodem'
+else:
+    # assume we're on Raspberry Pi/Linux
+    def get_rpi_revision():
+        """Returns the version number from the revision line."""
+        for line in open("/proc/cpuinfo"):
+            if "Revision" in line:
+                import re
+                return re.sub('Revision\t: ([a-z0-9]+)\n', r'\1', line)
+
+    rpi_revision = get_rpi_revision()
+    if rpi_revision and rpi_revision != 'Beta' and int('0x'+rpi_revision, 16) >= 0xa02082:
+        # RPi 3 and above
+        DEFAULT_SERIAL_PORT = '/dev/ttyS0'
+    else:
+        # RPi 2 and below
+        DEFAULT_SERIAL_PORT = '/dev/ttyACM0'
+
 
 IO_DIGITAL_OUTPUT = 0
 IO_DIGITAL_INPUT = 1

codebug_tether/version.py

@@ -1 +1 @@
-__version__ = '0.8.0'
+__version__ = '0.8.1'

docs/conf.py

@@ -50,9 +50,9 @@
 #
 # The short X.Y version.
 # The short X.Y version.
-version = '0.8.0'
+version = '0.8.1'
 # The full version, including alpha/beta/rc tags.
-release = '0.8.0'
+release = '0.8.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/example.rst

@@ -38,8 +38,8 @@ Basics
 
 
 .. note:: You can specify a different serial device for CodeBug by passing
-          the class a string. For example, OSX users might use:
-          ``codebug = codebug_tether.CodeBug('/dev/tty.USBmodem')``.
+          the class a string. For example:
+          ``codebug = codebug_tether.CodeBug(serial_port='/dev/tty.USBmodem')``.
 
 
 Sprites