Authorized Online Retailers:
In previous lesson - Prepare GPIO tool-WiringPi utility , We learned how to use WiringPi and C langugage to control GPIO and light a LED. In this lesson, we will do same job through another powerful programming language - Python.
Python is a programming language which can run Linux, Windows, Mac iOS. To learn more about Python, please visit Python official website.
RPi.GPIO API (library)
For a C programmer, the most frequently used GPIO library is WiringPi which is taught in our previous lesson. If programming language changes to Python, normally we use another GPIO library called RPi.GPIO which comes with Raspbian Jessie OS .
*RPi.GPIO pin definition is different from wiringPi. To learn the RPi.GPIO pin definition detail, please read our Lesson Two Introduction Of Raspberry Pi GPIO carefully.
The Raspbian Jessie 2015-05-27 release or above has RPi.GPIO pre-installed, and you can use it directly. In the subsequent tutorials, the RPi.GPIO will be used to program Raspberry pi GPIO from time to time. To learn more about RPi.GPIO, please visit here.
Thanks to the Python experts' effort, we now have an advance tool called Development and Learning Environment(IDLE) for Python. You no need remember any running and compiling command. It is a Graphic User Interface(GUI) which is easy to use and convenient for debug.
Raspbian Jessie PIXEL Operation System comes with python IDLE . You can open IDLE from applications menu -> Programming -> Python 3(IDLE) as following picture:
There are two version IDLE, python2 and python3. Recommend the new version-python 3, because program via python3 can't run via python2. To Learn more about IDLE， please visit here
Sample Project to use RPi.GPIO
In following tutorial, we use IDLE to make a Python program to control a LED which was done through C language in our previous Lesson 3 .
Connect LED to raspberry Pi GPIO, and then the program output high or low level to this GPIO to control the LED blink.
**B17 in above graph is the physical pin#11, wiringPi Pin# 0,BCM pin# 17
Note: B means BCM(Broadcom pin number). If you don’t know what is BCM pin#, Physical pin#, wiringPi#, please review our lesson 2: Introduction Of Raspberry Pi GPIO
3) Running the Python program
Method A: Running Python code in IDLE
If Raspberry pi connects to a monitor, you're recommended to take the following steps.
a) Open IDLE，click File->New File to open a new window, and copy the code in this window. Or donwload the pythontest.py file and double click it to open
b)Press "ctrl" + "S" to save the program in the path /home/pi(default) or other path as you like. Keep the file extension(.py or pyw) and name the file as you like when saving the file. For example, the file is named as pythontest.py in the following photo:
c) After saving the file, please click F5 or clickRun->Run Module F5 to run this project
Method B) Running Python code in command line
If your Pi is not connected to monitor or you are accessing Raspberry Pi remotely, you can running the Python program as following steps:
a) Run the following command to create and download /pythontest.py code
import RPi.GPIO as GPIO import time # set GPIO 0 as LED pin LEDPIN = 17
Import is keyword which adds a specific library into Python environment, "import RPi.GPIO as GPIO" will add RPi.GPIO library and "Import time" will add time module library.
Python RPi.GPIO use BCM naming system, "LEDPIN = 17 " we will use BCM pin#17 to send signal.
BCM Pin#17, physical pin# is 11, in wiringPi, its name is GPIO. 0 or pin# 0. Learn more information about Raspberry Pi GPIO. You can run the command gpio readallto see the GPIO layout.
#print message at the beginning ---custom function def print_message(): print ('|*********************************|') print ('| blink LED |') print ('| ------------------------- |') print ('| LED connect to GPIO |') print ('| |') print ('| LED will blink at 500ms |') print ('| ------------------------- |') print ('| |') print ('| OSOYOO |') print ('**********************************\n') print ('Program is running...') print ('Please press Ctrl+C to end the program...')
Def means definition of a function.
Print_message is a custom (edited by yourself) function, and show print message on the terminal. To learn more information about function definition, please click here.
#setup function for some setup---custom function def setup(): GPIO.setwarnings(False) #set the gpio modes to BCM numbering GPIO.setmode(GPIO.BCM) #set LedPin's mode to output,and initial level to LOW(0V) GPIO.setup(LEDPIN,GPIO.OUT,initial=GPIO.LOW)
GPIO.setmode(GPIO.BCM) function sets up BCM numbering method as GPIO numbering method. GPIO.setup(LedPin,GPIO.OUT,initial=GPIO.LOW) function sets up LedPin as output mode and set low level as LedPin’s initial level.
#main function def main(): #print info print_message() while True: GPIO.output(LEDPIN,GPIO.HIGH) print('...LED ON\n') time.sleep(0.5) GPIO.output(LEDPIN,GPIO.LOW) print('LED OFF...\n') time.sleep(0.5) pass pass
Main function will change Led pin level times and times to make the LED blink and send print message to terminal.