Merge branch 'dev'

Author: francois-berder

letmecreate/click/__init__.py

@@ -1,15 +1,28 @@
 """Python binding of the click part of the LetMeCreate library.
 
 It defines binding for the following click boards:
-  - Thermo3
-  - Proximity
-  - Accel
-  - Relay2
-  - Motion
+  - 7Seg
   - 8x8R (LED matrix)
-  - Joystick
+  - Accel
+  - ADC
+  - Alcohol
+  - Bargraph
+  - CO
   - Color
+  - Color2
+  - Eve
+  - IR distance
+  - IR eclipse
+  - Joystick
+  - Motion
+  - Proximity
+  - Relay (partial support: only relay 1 working)
+  - Relay2
+  - Relay4
+  - Thermo3
 """
 
-__all__ = ['thermo3', 'proximity', 'accel', 'relay2', 'motion', 'led_matrix',
-           'joystick', 'color']
+__all__ = ['seven_seg', 'led_matrix', 'accel', 'adc', 'alcohol', 'bargraph',
+           'color', 'color2', 'eve', 'ir_distance', 'ir_eclipse', 'joystick',
+           'motion', 'proximity', 'relay', 'relay2', 'relay4', 'thermo3',
+           'CO']

letmecreate/click/adc.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+"""Python binding of ADC Click Wrapper of LetMeCreate library.
+
+You must initialise the SPI bus and select the right one before calling
+get_raw_value.
+"""
+
+import ctypes
+
+_LIB = ctypes.CDLL('libletmecreate_click.so')
+
+ADC_CLICK_CHANNEL_1 = 0
+ADC_CLICK_CHANNEL_2 = 1
+ADC_CLICK_CHANNEL_3 = 2
+ADC_CLICK_CHANNEL_4 = 3
+
+
+def get_raw_value(channel):
+    """Read raw value from ADC Click in range 0..4095
+
+    channel: must be in range 0-3. Channel 2 is not available on Ci40.
+
+    Note: An exception is thrown if it fails to communicate with the click.
+    """
+    value = ctypes.c_uint16(0)
+    ret = _LIB.adc_click_get_raw_value(channel, ctypes.byref(value))
+    if ret < 0:
+        raise Exception("adc click get raw value failed")
+    return value.value

letmecreate/click/alcohol.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""Python binding of Alcohol Click wrapper of LetMeCreate library."""
+import ctypes
+
+_LIB = ctypes.CDLL('libletmecreate_click.so')
+
+
+def get_measure(mikrobus_index):
+    """Returns a 16-bit integer from the Accel Click.
+
+    mikrobus_index: must be 0 (MIKROBUS_1) or 1 (MIKROBUS_2)
+
+    Note: An exception is thrown if it fails to get a measure from the click.
+    """
+    measure = ctypes.c_uint16(0)
+    ret = _LIB.alcohol_click_get_measure(mikrobus_index, ctypes.byref(measure))
+    if ret < 0:
+        raise Exception("alcohol click get measure failed")
+    return measure.value

letmecreate/click/bargraph.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""Python binding of Bargraph Click wrapper of LetMeCreate library.
+
+You must configure and select the right SPI bus before using any of these
+functions.
+"""
+
+import ctypes
+
+_LIB = ctypes.CDLL('libletmecreate_click.so')
+
+
+def set_value(value):
+    """Switch on/off LED's of the Bargraph Click.
+
+    value: 8-bit integer used as a bit string. Least significant bit
+    controls the left-most LED.
+
+    Note: An exception is thrown if it fails to switch on/off LED's.
+    """
+    ret = _LIB.bargraph_click_set_value(value)
+    if ret < 0:
+        raise Exception("bargrah click set value failed")
+
+
+def set_intensity(mikrobus_index, intensity):
+    """Control the brightness of the LED's of the Bargraph Click.
+
+    mikrobus_index: must be 0 (MIKROBUS_1) or 1 (MIKROBUS_2)
+
+    intensity: Percentage of intensity of the LED's, must be in range 0.0-10.0
+
+    Note: An exception is thrown if it fails to switch on/off LED's.
+    """
+    ret = _LIB.bargraph_click_set_intensity(mikrobus_index,
+                                            ctypes.c_float(intensity))
+    if ret < 0:
+        raise Exception("bargrah click set intensity failed")

letmecreate/click/co.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Python binding of CO Click wrapper of LetMeCreate library."""
+
+import ctypes
+
+_LIB = ctypes.CDLL('libletmecreate_click.so')
+
+
+def get_measure(mikrobus_index):
+    """Measure the CO concentration in the air using the CO click.
+
+    mikrobus_index: must be 0 (MIKROBUS_1) or 1 (MIKROBUS_2)
+
+    Note: An exception is thrown if it fails to communicate with the CO click.
+    """
+    value = ctypes.c_uint16_t(0)
+    ret = _LIB.co_click_get_measure(mikrobus_index, ctypes.byref(value))
+    if ret < 0:
+        raise Exception("co click read ppm failed")
+    return value.value

letmecreate/click/color2.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+"""Python binding of Color2 Click wrapper of LetMeCreate library."""
+import ctypes
+
+_LIB = ctypes.CDLL('libletmecreate_click.so')
+
+
+def enable():
+    """Enable the Color2 Click.
+
+    Note: An exception is thrown if it fails to enable the chip.
+    """
+    ret = _LIB.color2_click_enable()
+    if ret < 0:
+        raise Exception("color2 click enable failed")
+
+
+def get_color():
+    """Returns the rgb color measurement as a tuple.
+
+    Note: An exception is thrown if it fails to get a measurement from
+    the click.
+    """
+    red = ctypes.c_uint16(0)
+    green = ctypes.c_uint16(0)
+    blue = ctypes.c_uint16(0)
+    ret = _LIB.color2_click_get_color(ctypes.byref(red),
+                                      ctypes.byref(green),
+                                      ctypes.byref(blue))
+    if ret < 0:
+        raise Exception("color2 click get color failed")
+    return (red.value, green.value, blue.value)
+
+
+def disable():
+    """Disable the Color2 Click.
+
+    Note: An exception is thrown if it fails to disable the chip.
+    """
+    ret = _LIB.color2_click_disable()
+    if ret < 0:
+        raise Exception("color2 click disable failed")