Initial commit.

Author: tdicola

.gitignore

@@ -0,0 +1,4 @@
+build/
+dist/
+*.egg-info
+*.pyc

Adafruit_MCP9808/MCP9808.py

@@ -0,0 +1,83 @@
+# Copyright (c) 2014 Adafruit Industries
+# Author: Tony DiCola
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+import logging
+import math
+
+import Adafruit_GPIO.I2C as I2C
+
+# Default I2C address for device.
+MCP9808_I2CADDR_DEFAULT        = 0x18
+
+# Register addresses.
+MCP9808_REG_CONFIG             = 0x01
+MCP9808_REG_UPPER_TEMP         = 0x02
+MCP9808_REG_LOWER_TEMP         = 0x03
+MCP9808_REG_CRIT_TEMP          = 0x04
+MCP9808_REG_AMBIENT_TEMP       = 0x05
+MCP9808_REG_MANUF_ID           = 0x06
+MCP9808_REG_DEVICE_ID          = 0x07
+
+# Configuration register values.
+MCP9808_REG_CONFIG_SHUTDOWN    = 0x0100
+MCP9808_REG_CONFIG_CRITLOCKED  = 0x0080
+MCP9808_REG_CONFIG_WINLOCKED   = 0x0040
+MCP9808_REG_CONFIG_INTCLR      = 0x0020
+MCP9808_REG_CONFIG_ALERTSTAT   = 0x0010
+MCP9808_REG_CONFIG_ALERTCTRL   = 0x0008
+MCP9808_REG_CONFIG_ALERTSEL    = 0x0002
+MCP9808_REG_CONFIG_ALERTPOL    = 0x0002
+MCP9808_REG_CONFIG_ALERTMODE   = 0x0001
+
+
+class MCP9808(object):
+	"""Class to represent an Adafruit MCP9808 precision temperature measurement
+	board.
+	"""
+
+	def __init__(self, address=MCP9808_I2CADDR_DEFAULT, busnum=I2C.get_default_bus()):
+		"""Initialize MCP9808 device on the specified I2C address and bus number.
+		Address defaults to 0x18 and bus number defaults to the appropriate bus
+		for the hardware.
+		"""
+		self._logger = logging.getLogger('Adafruit_MCP9808.MCP9808')
+		self._device = I2C.Device(address, busnum)
+
+	def begin(self):
+		"""Start taking temperature measurements. Returns True if the device is 
+		intialized, False otherwise.
+		"""
+		# Check manufacturer and device ID match expected values.
+		mid = self._device.readU16BE(MCP9808_REG_MANUF_ID)
+		did = self._device.readU16BE(MCP9808_REG_DEVICE_ID)
+		self._logger.debug('Read manufacturer ID: {0:04X}'.format(mid))
+		self._logger.debug('Read device ID: {0:04X}'.format(did))
+		return mid == 0x0054 and did == 0x0400
+
+	def readTempC(self):
+		"""Read sensor and return its value in degrees celsius."""
+		# Read temperature register value.
+		t = self._device.readU16BE(MCP9808_REG_AMBIENT_TEMP)
+		self._logger.debug('Raw ambient temp register value: 0x{0:04X}'.format(t & 0xFFFF))
+		# Scale and convert to signed value.
+		temp = (t & 0x0FFF) / 16.0
+		if t & 0x1000:
+			temp -= 256.0
+		return temp

Adafruit_MCP9808/__init__.py

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Adafruit Industries
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE

@@ -0,0 +1,29 @@
+Adafruit Python MCP9808
+=======================
+
+Python library for accessing the MCP9808 precision temperature sensor on a Raspberry Pi or Beaglebone Black.
+
+Designed specifically to work with the Adafruit MCP9808 sensor ----> https://www.adafruit.com/product/1782
+
+To install, first make sure some dependencies are available by running the following commands (on a Raspbian
+or Beaglebone Black Debian install):
+
+````
+sudo apt-get update
+sudo apt-get install build-essential python-dev python-smbus
+````
+
+Then download the library by clicking the download zip link to the right and unzip the archive somewhere on your Raspberry Pi or Beaglebone Black.  Then execute the following command in the directory of the library:
+
+````
+sudo python setup.py install
+````
+
+Make sure you have internet access on the device so it can download the required dependencies.
+
+See examples of usage in the examples folder.
+
+Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!
+
+Written by Tony DiCola for Adafruit Industries.
+MIT license, all text above must be included in any redistribution

README.md

@@ -0,0 +1,52 @@
+#!/usr/bin/python
+# Copyright (c) 2014 Adafruit Industries
+# Author: Tony DiCola
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+# Can enable debug output by uncommenting:
+#import logging
+#logging.basicConfig(level=logging.DEBUG)
+
+import time
+
+import Adafruit_MCP9808.MCP9808 as MCP9808
+
+
+# Default constructor will use the default I2C address (0x18) and pick a default I2C bus.
+#
+# For the Raspberry Pi this means you should hook up to the only exposed I2C bus
+# from the main GPIO header and the library will figure out the bus number based
+# on the Pi's revision.
+#
+# For the Beaglebone Black the library will assume bus 1 by default, which is
+# exposed with SCL = P9_19 and SDA = P9_20.
+sensor = MCP9808.MCP9808()
+
+# Optionally you can override the address and/or bus number:
+#sensor = MCP9808.MCP9808(address=0x20, busnum=2)
+
+# Initialize communication with the sensor.
+sensor.begin()
+
+# Loop printing measurements every second.
+print 'Press Ctrl-C to quit.'
+while True:
+	print 'Temperature: {0:0.4F} *C'.format(sensor.readTempC())
+	time.sleep(1.0)