added interrupt example

Author: siddacious

docs/examples.rst

@@ -7,3 +7,8 @@ Ensure your device works with these simple tests.
     :caption: examples/lsm303agr_mag_simpletest.py
     :linenos:
 
+.. literalinclude:: ../examples/lsm303agr_mag_interrupt.py
+    :caption: examples/lsm303agr_mag_interrupt.py
+    :linenos:
+
+examples/lsm303agr_mag_interrupt.py

examples/lsm303agr_mag_interrupt.py

@@ -0,0 +1,20 @@
+import time
+import board
+import busio
+import adafruit_lsm303agr_mag
+
+i2c = busio.I2C(board.SCL, board.SDA)
+lsm_mag = adafruit_lsm303agr_mag.LSM303AGR_Mag(i2c)
+lsm_mag.interrupt_threshold = 80
+lsm_mag.interrupt_enabled = True
+
+while True:
+    x_hi, y_hi, z_hi, x_lo, y_lo, z_lo, int_triggered = lsm_mag.faults
+
+    print(lsm_mag.magnetic)
+    print("Xhi:%s\tYhi:%s\tZhi:%s"%(x_hi, y_hi, z_hi))
+    print("Xlo:%s\tYlo:%s\tZlo:%s"%(x_lo, y_lo, z_lo))
+    print("Int triggered: %s"%int_triggered)
+    print()
+
+    time.sleep(1)