Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
doc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

grove.py

Build Status

Python library for Seeedstudio Grove Devices on embeded Linux platform, especially good on below platforms:



Architecture

To operate grove sensors, the grove.py depends many hardware interface libraries such as mraa/upm/smbus2.




Installation

For beginner or library user only, please install with online method.
For developer or advanced user, please install dependencies and then install grove.py with source code.

Online install

install/update all dependencies and latest grove.py

curl -sL https://github.com/Seeed-Studio/grove.py/raw/master/install.sh | sudo bash -s -

Install grove.py

From source code

git clone https://github.com/Seeed-Studio/grove.py
cd grove.py
# Python2
sudo pip install .
# Python3
sudo pip3 install .



Usage

Basic GPIO Input & Output demo

import time
from grove.gpio import GPIO

led = GPIO(12, GPIO.OUT)
button = GPIO(22, GPIO.IN)

while True:
    if button.read():
        led.write(1)
    else:
        led.write(0)
    time.sleep(0.1)

See more demos and how to run



API Documentation

click here

how to update me



Contribution

Check list for adding a new grove device, for simple, take grove_led as a example.

  • Add a Class in the python source file, and export with __all__ =
  • Code sytle PEP8 is recommanded
  • The python source could run directly with python <file> and python3 <file>
  • Add demo code at the near top of source file
  • The demo code could run directly with someone python/python3 IDE.
  • Add document to class and it's member and show the result by refering to API document
  • Add a command item in setup.py console_scripts list, take effect by install again
  • Add a item to command table in Usage Doc
  • If the command need argument but not specified, please list available arguments.
  • If specified invalid argument, also output usage document then exit.