https://github.com/derekstavis/python-sysfs-gpio

Pure Python native GPIO access. Edge-triggered interrupts included.
https://github.com/derekstavis/python-sysfs-gpio

Last synced: about 8 hours ago
JSON representation

Pure Python native GPIO access. Edge-triggered interrupts included.

• Host: GitHub
• URL: https://github.com/derekstavis/python-sysfs-gpio
• Owner: derekstavis
• License: mit
• Created: 2014-05-12T18:09:01.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-08-09T15:10:47.000Z (about 7 years ago)
• Last Synced: 2023-03-28T21:45:01.708Z (over 1 year ago)
• Language: Python
• Size: 18.6 KB
• Stars: 51
• Watchers: 8
• Forks: 26
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Linux SysFS GPIO access via Python

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

This package offer Python classes to work with GPIO on Linux.

## System Requirements

As this package relies on modern techniques provided by Linux kernel, so your kernel version should support at least EPoll and SysFS interfaces.

## Package Requirements

This package is based on Twisted main loop. To build the package you will also

need setuptools.

## How to use it

1. Download this repository

```shell

    git clone https://github.com/derekstavis/python-sysfs-gpio.git

```

2. Inside it, issue:

```shell

    sudo python setup.py install

```

3. On your code:

```python

    # Import Twisted mainloop

    

    from twisted.internet import reactor

    

    # Import this package objects

    

    from sysfs.gpio import Controller, OUTPUT, INPUT, RISING

    

    # Refer to your chip GPIO numbers and set them this way

    

    Controller.available_pins = [1, 2, 3, 4]

    

    # Allocate a pin as Output signal

    

    pin = Controller.alloc_pin(1, OUTPUT)

    pin.set()   # Sets pin to high logic level

    pin.reset() # Sets pin to low logic level

    pin.read()  # Reads pin logic level

    

    # Allocate a pin as simple Input signal

    

    pin = Controller.alloc_pin(1, INPUT)

    pin.read()  # Reads pin logic level

    

    # Allocate a pin as level triggered Input signal

    

    def pin_changed(number, state):

        print("Pin '%d' changed to %d state" % (number, state))

    

    pin = Controller.alloc_pin(1, INPUT, pin_changed, RISING)

    pin.read()  # Reads pin logic level

```

4. Don't forget to start reactor loop!

```python

    reactor.run()

```

## Contributing

If you think that there's work that can be done to make this module better 

(and that's the only certainty), fork this repo, make some changes and create

a pull request. I will be glad to accept it! :)