From d46008d6fd307ea38ab4db474ec50e07da88fda6 Mon Sep 17 00:00:00 2001
From: ouki-wang <358023925@qq.com>
Date: Thu, 15 Nov 2018 18:18:06 +0800
Subject: [PATCH] add raspberry

---
 RaspberryPi/Python/README.md                  |  62 +++++++++++
 .../Python/example/DFRobot_AS3935_detailed.py | 104 ++++++++++++++++++
 ...t_AS3935.py => DFRobot_AS3935_ordinary.py} |   4 +-
 3 files changed, 169 insertions(+), 1 deletion(-)
 create mode 100644 RaspberryPi/Python/example/DFRobot_AS3935_detailed.py
 rename RaspberryPi/Python/example/{DFRobot_AS3935.py => DFRobot_AS3935_ordinary.py} (97%)

diff --git a/RaspberryPi/Python/README.md b/RaspberryPi/Python/README.md
index 9c1b6b1..7028320 100644
--- a/RaspberryPi/Python/README.md
+++ b/RaspberryPi/Python/README.md
@@ -83,6 +83,68 @@ def setLcoFdiv(self,fdiv);
  */
 def setIrqOutputSource(self, irqSelect);
 
+/*
+ * @brief Set to the outdoor model
+ */
+def setOutdoors(self);
+
+/*
+ * @brief Set to the indoor model
+ */
+def setIndoors(self);
+
+/*
+ * @brief Disturber detection enabled
+ */
+def disturberEn(self);
+
+/*
+ * @brief Disturber detection disenabled
+ */
+def disturberDis(self);
+
+/*
+ * @brief Set the noise level
+ *
+ * @param 0~7,More than 7 will use the default value:2
+ */
+def setNoiseFloorLv1(self, nfSel);
+
+/*
+ * @brief Get the noise level
+ *
+ * @return 0~7
+ */
+def getNoiseFloorLv1(self);
+
+/*
+ * @brief Set an anti-interference rating
+ *
+ * @param 0~7,More than 7 will use the default value:1
+ */
+def setWatchdogThreshold(self, wdth);
+
+/*
+ * @brief read WDTH
+ *
+ * @return 0~7
+ */
+def getWatchdogThreshold(self);
+
+/*
+ * @brief Modify SREJ (spike rejection)
+ *
+ * @param 0~7,More than 7 will use the default value:2
+ */
+def setSpikeRejection(self, srej);
+
+/*
+ * @brief read SREJ (spike rejection)
+ *
+ * @return 0~7
+ */
+def getSpikeRejection(self);
+
 ```
 ## Credits
 
diff --git a/RaspberryPi/Python/example/DFRobot_AS3935_detailed.py b/RaspberryPi/Python/example/DFRobot_AS3935_detailed.py
new file mode 100644
index 0000000..b9cf0ff
--- /dev/null
+++ b/RaspberryPi/Python/example/DFRobot_AS3935_detailed.py
@@ -0,0 +1,104 @@
+# file DFRobot_AS3935_detailed.py
+#
+# SEN0290 Lightning Sensor
+# This sensor can detect lightning and display the distance and intensity of the lightning within 40 km
+# It can be set as indoor or outdoor mode.
+# The module has three I2C, these addresses are:
+# AS3935_ADD1  0x01   A0 = High  A1 = Low
+# AS3935_ADD3  0x03   A0 = High  A1 = High
+# AS3935_ADD2  0x02   A0 = Low   A1 = High
+#
+#
+# Copyright    [DFRobot](http://www.dfrobot.com), 2018
+# Copyright    GNU Lesser General Public License
+#
+# version  V0.1
+# date  2018-11-13
+
+import sys
+sys.path.append('../')
+import time
+from DFRobot_AS3935_Lib import DFRobot_AS3935
+import RPi.GPIO as GPIO
+from datetime import datetime
+
+#I2C address
+AS3935_I2C_ADDR1 = 0X01
+AS3935_I2C_ADDR2 = 0X02
+AS3935_I2C_ADDR3 = 0X03
+
+#Antenna tuning capcitance (must be integer multiple of 8, 8 - 120 pf)
+AS3935_CAPACITANCE = 96
+IRQ_PIN = 37
+
+#Indoor/outdoor mode selection
+AS3935_INDOORS = 0
+AS3935_OUTDOORS = 1
+AS3935_MODE = AS3935_INDOORS
+
+#Enable/disable disturber detection
+AS3935_DIST_DIS = 0
+AS3935_DIST_EN = 1
+AS3935_DIST = AS3935_DIST_EN
+
+GPIO.setmode(GPIO.BOARD)
+
+sensor = DFRobot_AS3935(AS3935_I2C_ADDR3, bus = 1)
+sensor.reset()
+#Configure sensor
+sensor.manualCal(AS3935_CAPACITANCE, AS3935_MODE, AS3935_DIST)
+
+#set indoors or outdoors models
+sensor.setIndoors()
+#sensor.setOutdoors()
+
+#disturber detection
+sensor.disturberEn()
+#sensor.disturberDis()
+
+# Connect the IRQ and GND pin to the oscilloscope.
+# uncomment the following sentences to fine tune the antenna for better performance.
+# This will dispaly the antenna's resonance frequency/16 on IRQ pin (The resonance frequency will be divided by 16 on this pin)
+# Tuning AS3935_CAPACITANCE to make the frequency within 500/16 kHz ± 3.5%
+#
+# sensor.setLcoFdiv(0)
+# sensor.setIrqOutputSource(3)
+
+#Set the noise level,use a default value greater than 7
+sensor.setNoiseFloorLv1(2)
+#noiseLv = sensor.getNoiseFloorLv1()
+
+#used to modify WDTH,alues should only be between 0x00 and 0x0F (0 and 7)
+sensor.setWatchdogThreshold(0)
+#wtdgThreshold = sensor.getWatchdogThreshold()
+
+#used to modify SREJ (spike rejection),values should only be between 0x00 and 0x0F (0 and 7)
+sensor.setSpikeRejection(2)
+#spikeRejection = sensor.getSpikeRejection()
+
+def callback_handle(channel):
+    global sensor
+    time.sleep(0.005)
+    intSrc = sensor.getInterruptSrc()
+    if intSrc == 1:
+        lightningDistKm = sensor.getLightningDistKm()
+        print('Lightning occurs!')
+        print('Distance: %dkm'%lightningDistKm)
+
+        lightningEnergyVal = sensor.getStrikeEnergyRaw()
+        print('Intensity: %d '%lightningEnergyVal)
+    elif intSrc == 2:
+        print('Disturber discovered!')
+    elif intSrc == 3:
+        print('Noise level too high!')
+    else:
+        pass
+#Set to input mode
+GPIO.setup(IRQ_PIN, GPIO.IN)
+#Set the interrupt pin, the interrupt function, rising along the trigger
+GPIO.add_event_detect(IRQ_PIN, GPIO.RISING, callback = callback_handle)
+
+while True:
+    time.sleep(1.0)
+
+
diff --git a/RaspberryPi/Python/example/DFRobot_AS3935.py b/RaspberryPi/Python/example/DFRobot_AS3935_ordinary.py
similarity index 97%
rename from RaspberryPi/Python/example/DFRobot_AS3935.py
rename to RaspberryPi/Python/example/DFRobot_AS3935_ordinary.py
index 44b8fb0..e36e186 100644
--- a/RaspberryPi/Python/example/DFRobot_AS3935.py
+++ b/RaspberryPi/Python/example/DFRobot_AS3935_ordinary.py
@@ -1,4 +1,4 @@
-# file DFRobot_AS3935_lightning_sensor.py
+# file DFRobot_AS3935_ordinary.py
 #
 # SEN0290 Lightning Sensor
 # This sensor can detect lightning and display the distance and intensity of the lightning within 40 km
@@ -15,6 +15,8 @@
 # version  V0.1
 # date  2018-11-13
 
+import sys
+sys.path.append('../')
 import time
 from DFRobot_AS3935_Lib import DFRobot_AS3935
 import RPi.GPIO as GPIO