https://github.com/pcfens/raspberrypi-as3935

A basic library for working with the AS3935 that's connected to the Raspberry Pi.
https://github.com/pcfens/raspberrypi-as3935

as3935 hacktoberfest raspberrypi

Last synced: 3 months ago
JSON representation

A basic library for working with the AS3935 that's connected to the Raspberry Pi.

• Host: GitHub
• URL: https://github.com/pcfens/raspberrypi-as3935
• Owner: pcfens
• License: other
• Created: 2013-03-24T03:36:18.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2021-03-28T19:15:19.000Z (almost 4 years ago)
• Last Synced: 2024-10-11T17:21:01.126Z (3 months ago)
• Topics: as3935, hacktoberfest, raspberrypi
• Language: Python
• Homepage:
• Size: 39.1 KB
• Stars: 52
• Watchers: 16
• Forks: 24
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
RaspberryPi-AS3935

==================

[![Build Status](https://travis-ci.org/pcfens/RaspberryPi-AS3935.png?branch=master)](https://travis-ci.org/pcfens/RaspberryPi-AS3935)

A python library and demo script for interacting with the

[AMS Franklin Lightning Sensor](http://ams.com/eng/Products/Lightning-Sensor/Franklin-Lightning-Sensor/AS3935).

This script will only work if the correct kernel modules are loaded

on your Pi.  Adafruit has a nice [tutorial](http://learn.adafruit.com/adafruits-raspberry-pi-lesson-4-gpio-setup/configuring-i2c)

set up, though depending on the breakout board that you use, you may 

not see anything show up when you run `i2cdetect`.

## Installation

You can install this module by running

```

pip install RPi_AS3935

```

or you can clone this repository and run

```

python setup.py install

```

## Breakout Board

The AS3935 is a small chip, and rather than trying to solder it myself

I purchased a (v2) breakout board from [Embedded Adventures](http://www.embeddedadventures.com/as3935_lightning_sensor_module_mod-1016.html).

## Connecting the AS3935

In my test setup I connected my breakout board to the Pi as shown

| AS3935 Pin | Raspberry Pi Pin |

| ---------: | :--------------- |

| 4 (GND)    | 25 (Ground)      |

| 5 (VDD)    | 1 (3v3 Power)    |

| 10 (IRQ)   | 11 (GPIO 17)     |

| 11 (I2CL)  | 5 (SCL)          |

| 13 (I2CD)  | 3 (SDA)          |

## Known Issues

### Addressing 

You may need edit line 12 of demo.py so that the correct address is read.

| Breakout Board | Default Address |

| :------------- | :-------------- |

| Embedded Adventures v2 | 0x00 |

| Embedded Adventures v4/v8 | 0x03 |

| Tautic Electronics (untested) | 0x00 |

### RaspberryPi Model

If you have one of the newer 512MB Pi boards, then you need to adjust line 12

in the demo script to read

```python

sensor = RPi_AS3935(address = 0x00, bus = 1)

```