5 727 octets ajoutés
, 1 octobre 2013 à 06:53
{{Pi-WiringPi-NAV}}
== Commande "gpio" ==
{{bloc-etroit|text= WiringPi comes with a separate program to help manage the GPIO. This program, called '''gpio''', can also be used in scripts to manipulate the GPIO pins – set outputs and read inputs. It’s even possible to write entire programs just using the '''gpio''' command in a shell-script, although it’s not terribly efficient doing it that way… Another way to call it is using the system() function in C/C++ or it’s equivalent in other programming languages.
{{ambox|text= The '''gpio''' command is designed to be installed as a setuid program and called by a normal user without using the sudo command (or logging in as root). }}
}}
In addition to using the gpio utility to control the GPIO pins, you can:
* Export/Unexport pins via the /sys/class/gpio interface, where they will then be available to user programs (that then do not need to be run as root or with sudo)
* Export pins to enable edge-triggered interrupts via the /sys/class/gpio interface.
* Control the pins on the PiFace peripheral device.
* Load SPI and I2C modules and set /dev/ permissions to enable read/write by the user running the gpio program.
* Set the SPI buffer size and I2C baud rate (when loading the modules)
* Output values to the Gertboard DAC
* Read inputs from the Gertboard ADC
* Determine your Raspberry Pi board hardware revision.
See the man page for the gpio program to see what all the features are by typing
man gpio
at the command prompt.
== Usage ==
From the Linux command line:
gpio -v
This prints the version.
gpio -g …
The optional -g flag causes pin numbers to be interpreted as BCM_GPIO pin numbers rather than standard wiringPi pin numbers.
== Standard input and output commands ==
=== gpio mode ===
<nowiki>gpio [-g] mode <pin> in/out/pwm/up/down/tri</nowiki>
This sets the mode of a pin to be input, output or pwm and additionally can set the internal pull-up/down resistors to pull-up, pull-down or none.
=== gpio write ===
<nowiki>gpio [-g] write <pin> 0/1</nowiki>
This sets an output pin to high (1) or low (0)
=== gpio pwm ===
<nowiki>gpio [-g] pwm <pin> <value></nowiki>
Set the pin to a PWM value (0-1023 is supported)
=== gpio read ===
<nowiki>gpio [-g] read <pin></nowiki>
Reads and prints the logic value of the given pin. It will print 0 (low) or 1 (high).
=== gpio readall ===
<nowiki>gpio readall</nowiki>
This reads all the normally accessible pins and prints a table of their numbers (both wiringPi and BCM_GPIO, so makes for a handy cross-reference chart), along with their modes and current values.
== Module Load Commands ==
=== gpio load spi ===
<nowiki>gpio load spi [buffer size in KB]</nowiki>
This loads the SPI kernel modules and optionally sets the internal buffer to the given size in KB (multiples of 1024). The default is 4KB and is usually more than enough for most application which only exchange a byte or 2 at a time over the SPI bus.
The /dev/spi* entries are set to be owned by the person using the gpio program, so there is no need to run subsequent programs as root (unless they use other wiringPi functions)
=== gpio load i2c ===
<nowiki>gpio load i2c [baud rate in Kb/sec]</nowiki>
This loads the I2C kernel modules and optionally sets the baud rate to the given speed in Kb/sec (multiples of 1000). The default is 100Kb/sec.
The /dev/I2c* entries are set to be owned by the person using the gpio program, so there is no need to run subsequent programs as root (unless they use other wiringPi functions)
== /sys/class/gpio mode commands ==
=== gpio export ===
<nowiki>gpio export <pin> in/out</nowiki>
This exports the given pin (BCM-GPIO pin number) as an input or output and makes it available for a user program running as the same user to use.
=== gpio unexport ===
<nowiki>gpio unexport <pin></nowiki>
Removes the export of the given pin.
=== gpio unexport all ===
<nowiki>gpio unexportall</nowiki>
Removes all /sys/class/gpio exports.
=== gpio exports ===
<nowiki>gpio exports</nowiki>
This prints a list of all gpio pins which have been exported via the /sys/class/gpio interface and their modes.
=== gpio edge ===
<nowiki>gpio edge <pin> rising/falling/both/none</nowiki>
This enables the given pin for edge interrupt triggering on the rising, falling or both edges. (Or none which disables it)
Note: The pin numbers in the sys mode are always BCM-GPIO pin numbers.
== Exemples ==
<nowiki>gpio mode 0 out
gpio write 0 1</nowiki>
This uses the wiringPi pin numbers to set pin 0 as an output and then sets the pin to a logic 1.
<nowiki>gpio -g mode 0 in
gpio -g read 0</nowiki>
This uses the BCM_GPIO pin numbering scheme and reads pin 0 (SDA0 on a Rev. 1 Raspberry Pi)
== Internal pull up/down resistors ==
The GPIO lines have internal pull up or pull-down resistors which can be controlled via software when a pin is in input mode.
<nowiki>gpio mode 0 up
gpio mode 0 down
gpio mode 0 tri</nowiki>
These set the resistors to pull-up, pull-down and none respectively on wiringPi pin 0.
== PiFace Commands ==
The PiFace is somewhat limited in that it has 8 inputs pins and 8 output pins and these are fixed in the hardware, so only the write and read commands are implemented:
<nowiki>gpio -p write <pin> 0/1</nowiki>
Writes the value 0 (off) or 1 (on) to the output pin on the PiFace
<nowiki>gpio -p read <pin></nowiki>
Reads and prints the value on the given input pin.
<nowiki>gpio -p mode <pin> up/tri</nowiki>
This enables (up) or disables (tri) the internal pull-up resistor on the given input pin. You need to enable the pull-up if you want to read any of the on-board switches on the PiFace board.
{{Pi-WiringPi-TRAILER}}