Home

Awesome

grove.py

Build Status

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

<br><br>

Architecture

To operate grove sensors, the grove.py depends on the smbus2 hardware interface library.

<br>

<br><br>

Installation

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

Online install

To install into a virtual environment, first active your virtualenv and type the following command:

curl -sL https://github.com/Seeed-Studio/grove.py/raw/master/install.sh | bash -s -- --user-local --bypass-gui-installation

If you want to install into the system, you can type the following command:

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
# Python3 
sudo pip3 install .
# virutalenv for Python3 (If the installation fails when using pip3)
sudo apt install python3-virtualenv
virtualenv -p python3 env
source env/bin/activate
pip3 install .

<br><br>

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

<br><br>

API Documentation

click here

how to update me

<br><br>

Contribution

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