Difference between revisions of "RPi Low-level peripherals"

From eLinux.org
Jump to: navigation, search
(General Purpose Input/Output (GPIO))
(SPI)
(257 intermediate revisions by 69 users not shown)
Line 4: Line 4:
  
 
==Introduction==
 
==Introduction==
[TODO]
+
In addition to the familiar USB, Ethernet and HDMI ports, the Raspberry Pi offers the ability to connect directly to a variety of electronic devices. These include:
 +
* Digital outputs: turn lights, motors, or other devices on or off
 +
* Digital inputs: read an on or off state from a button, switch, or other sensor
 +
* Communication with chips or modules using low-level protocols: [http://www.corelis.com/education/SPI_Tutorial.htm SPI], [http://i2c.info/ I²C], or [https://learn.sparkfun.com/tutorials/serial-communication serial UART]
  
==General Purpose Input/Output (GPIO)==
+
Connections are made using GPIO ([https://en.wikipedia.org/wiki/General-purpose_input/output "General Purpose Input/Output"]) pins. Unlike USB, etc., these interfaces are not "plug and play" and require care to avoid miswiring. The Raspberry PI GPIOs use 3.3V [https://learn.sparkfun.com/tutorials/logic-levels/all logic levels], and can be damaged if connected directly to 5V levels (as found in many older digital systems) without level-conversion circuitry.
[[File:GPIOs.png|thumb|254px|right|the layout of the Rpi GPIO's, colour coded to the table. [https://sites.google.com/site/burngatehouse/home/drawings/GPIOs.gif Source] ]]
 
  
General Purpose Input/Output (a.k.a. GPIO) is a generic pin on a chip whose behavior (including whether it is an input or output pin) can be controlled (programmed) through software.
+
Note that no analogue input or output is available. However, add-on boards such as the [[Rpi Gertboard]] provide this capability.
  
The Rpi allows peripherals and expansion boards (such as the upcoming [[Rpi Gertboard]]) to access the CPU by exposing the in and outputs.
+
=== Links ===
 +
* For further specific information about the Raspberry Pi's BCM2835 GPIOs, see: [[RPi BCM2835 GPIOs]].
 +
* Sample code in many different languages is on the [[RPi GPIO Code Samples]] page
 +
* To connect devices to the serial port (UART), see the [[RPi Serial Connection]] page.
 +
* Sample circuits for interfacing the GPIOs with other electronics are shown on the [[RPi GPIO Interface Circuits]] page.
 +
<br>
 +
= General Purpose Input/Output (GPIO) =
  
For further general information about GPIOs, see:[http://en.wikipedia.org/wiki/GPIO the wikipedia article].
+
== Model A and B (Original) ==
  
The production Raspberry Pi board has a 26-pin 2.54mm (100mil)<ref>http://www.raspberrypi.org/forum/features-and-requests/easy-gpio-hardware-software/page-3/#p31907</ref> expansion header, arranged in a 2x13 strip. They provide 8 GPIO pins plus access to I2C, SPI, UART), as well as +3V3, +5V and GND supply lines.  Pin one is the pin in the first column and on the bottom row. <ref>http://www.raspberrypi.org/archives/384</ref>
+
=== P1 Header ===
  
Voltage levels are 3v3. There is no over-voltage protection on the board - the intention is that people interested in serious interfacing will use an external board with buffers, level conversion and analog I/O rather than soldering directly onto the main board.
+
{|
 +
|-
 +
| [[File:Pi-GPIO-header-26-sm.png|thumb||right|26-pin GPIO header layout. Note that Rev 1 PCBs had different assignments for pins 3, 5, and 13]]. | [[File:RPi_P1_header.png|thumb|450px|left]]
 +
|}
 +
 
 +
The Raspberry Pi Model A and B boards have a 26-pin 2.54&nbsp;mm (100&nbsp;mil)<ref>[http://www.raspberrypi.org/forum/features-and-requests/easy-gpio-hardware-software/page-3/#p31907 raspberrypi.org]</ref> expansion header, marked as P1, arranged in a 2x13 strip. They provide 8 GPIO pins plus access to I²C, SPI, UART), as well as +3.3&nbsp;V, +5&nbsp;V and GND supply lines. Pin one is the pin in the first column and on the bottom row. <ref>[http://www.raspberrypi.org/archives/384 raspberrypi.org]</ref>
  
On the production board, all the UART, SPI and I2C pins can be reconfigured as GPIO pins, to provide a total of 17 GPIO pins<ref>http://www.raspberrypi.org/archives/384</ref>. Each of their functions and full details of how to access are detailed in the chipset datasheet <ref>http://www.raspberrypi.org/wp-content/uploads/2012/02/BCM2835-ARM-Peripherals.pdf</ref>.
+
'''Revision 1 PCBs:''' Raspberry Pis with a revision 1 PCB (September 2012 or earlier) have a different pin assignment on the P1 connector:
 +
* P1 pin 3 is GPIO 0 / SDA0 (not GPIO 2)
 +
* P1 pin 5 is GPIO 1 / SCL0 (not GPIO 3)
 +
* P1 pin 13 is GPIO 21 (not GPIO 27)
  
The availabile alternative functions and their corresponding pins are detailed below. These numbers are in reference to the chipset documentation and may not match the numbers exposed in linux. Only fully usable functions are detailed, for some alternative functions not all the necessary pins are available for the funtionality to be actually used.
+
Revision 1 PCBs also do not have the P5 header (see below). See [http://www.raspberrypi.org/archives/1929#comment-31646 this discussion] for more details of the changes between Rev 1 and Rev 2 PCBs.
  
Kernel boot messages go to the [[RPi_Serial_Connection|UART]] at 115200bps.
+
=== P2 header ===
 +
The P2 header is the VideoCore JTAG and used only during the production of the board. It cannot be used as the ARM JTAG <ref>http://www.raspberrypi.org/phpBB3/viewtopic.php?f=24&t=5894</ref>. This connector is unpopulated in Rev 2.0 boards.  
  
 +
[[File:RPi_P2_header.png]]
  
'''Header Pinout, top row:'''
+
Useful P2 pins:
 +
* Pin 1 - 3.3V (same as P1-01, 50 mA max current draw across both of them)
 +
* Pin 7 - GND
 +
* Pin 8 - GND
 +
 
 +
=== P3 header ===
 +
The P3 header, unpopulated, is the LAN9512 JTAG <ref>http://www.raspberrypi.org/phpBB3/viewtopic.php?f=24&t=5894</ref>.
 +
 
 +
[[File:RPi_P3_header.png]]
 +
 
 +
Useful P3 pins:
 +
* Pin 7 - GND
 +
 
 +
=== P5 header ===
 +
The P5 header was added with the release of the Revision 2.0 PCB design.
 +
 
 +
[[File:RPi_P5_header.png]]
 +
 
 +
===P5 Header pinout, top row===
 +
As seen from the back of the board:
 
{| border="1" style="text-align:center;"
 
{| border="1" style="text-align:center;"
| '''Pin Name''' || '''Pin Function''' || '''Hardware Notes''' || '''General Notes''' || '''Alternative Functions'''
+
| '''Pin Number''' || '''Pin Name Rev2''' || '''Hardware Notes''' || '''Alt 0 Function''' || '''Other Alternative Functions'''
 
|-
 
|-
| P1-02 || bgcolor="red" | <span style="color:white">5V0</span>  
+
| P5-01 || bgcolor="red" | <span style="color:white">5V0</span> || Supply through input poly fuse
 
|-
 
|-
| P1-04 || DNC || pulled high (5v) in v1
+
| P5-03 || bgcolor="lime" | GPIO28 || || bgcolor="cyan" | I2C0_SDA || ALT2 = PCM_CLK
 
|-
 
|-
| P1-06 || bgcolor="black" | <span style="color:white">GND</span>
+
| P5-05 || bgcolor="lime" | GPIO30 || || || ALT2 = PCM_DIN ALT3 = UART0_CTS ALT5 = UART1_CTS
 
|-
 
|-
| P1-08 || bgcolor="yellow" | UART0_TXD || || (BCM2835 GPIO14-ALT0) || GPIO14-ALT5 is UART1_TXD, GPIO14
+
| P5-07 || bgcolor="black" | <span style="color:white">GND</span>
 +
|}
 +
 
 +
===P5 Header pinout, bottom row===
 +
As seen from the back of the board:
 +
{| border="1" style="text-align:center;"
 +
| '''Pin Number''' || '''Pin Name Rev2''' || '''Hardware Notes''' || '''Alt 0 Function''' || '''Other Alternative Functions'''
 
|-
 
|-
| P1-10 || bgcolor="yellow" | UART0_RXD || || (BCM2835 GPIO15-ALT0) || GPIO15-ALT5 is UART1_RXD, GPIO15
+
| P5-02 || bgcolor="orange" | 3.3&nbsp;V || 50&nbsp;mA max (combined with P1)
 
|-
 
|-
| P1-12 || bgcolor="lime" | BCM2835 GPIO18 || || || GPIO18-ALT5 is PWM0
+
| P5-04 || bgcolor="lime" | GPIO29 || || bgcolor="cyan" | I2C0_SCL || ALT2 = PCM_FS
 
|-
 
|-
| P1-14 || DNC || pulled low in v1
+
| P5-06 || bgcolor="lime" | GPIO31 || || || ALT2 = PCM_DOUT ALT3 = UART0_RTS ALT5 = UART1_RTS
 
|-
 
|-
| P1-16 || bgcolor="lime" | BCM2835 GPIO23
+
| P5-08 || bgcolor="black" | <span style="color:white">GND</span>
 +
|}
 +
 
 +
[[File:Male-slanted2small.jpg|150px|thumb|left|Slanted P5 header]]
 +
 
 +
Note that the connector is intended to be mounted on the bottom of the PCB, so that for those who put the connector on the top side, the pin numbers are mirrored. Pin 1 and pin 2 are swapped, pin 3 and 4, etc.
 +
 
 +
An alternative way to attach this header is on top, [http://raspi.tv/2013/the-leaning-header-of-pi5a-how-best-to-solder-a-header-on-p5 at a slant away from the P1 header.]
 +
 
 +
The new header can provide a second I²C channel (SDA + SCL) and handshake lines for the existing UART (TxD and RxD), or it can be used for an I2S (audio codec chip) interface using the PCM signals CLK, FS (Frame Sync), Din and Dout.
 +
 
 +
Note that the connector is placed JUST off-grid with respect to the P1 connector.
 +
 
 +
=== P6 header ===
 +
The P6 header was added with the release of the Revision 2.0 PCB design.
 +
 
 +
[[File:RPi_P6_header.png]]
 +
 
 +
===P6 Pinout===
 +
{| border="1" style="text-align:center;"
 +
| '''Pin Number''' || '''Pin Name Rev2''' || '''Hardware Notes'''
 
|-
 
|-
| P1-18 || bgcolor="lime" | BCM2835 GPIO24
+
| P6-01 || RUN || Short to ground to reset the BCM2835
 
|-
 
|-
| P1-20 || DNC || pulled low in v1
+
| P6-02 || bgcolor="black" | <span style="color:white">GND</span>
 +
|}
 +
 
 +
A reset button can be attached to the P6 header.<ref>[http://raspi.tv/2012/making-a-reset-switch-for-your-rev-2-raspberry-pi raspi.tv]</ref> Momentarily shorting the two pins of P6 together will cause a soft reset of the CPU (which can also 'wake' the Pi from halt/shutdown state).
 +
 
 +
== Model A+, B+ and B2 ==
 +
 
 +
{|
 +
|-
 +
| [[File:A_plus_hdr_sm.jpg|thumb|Model A+]] || [[File:B_plus_hdr_sm.jpg|thumb|Models B+, B2]] || [[File:Pi-GPIO-header.png|thumb|Connector pinout]]
 +
|}
 +
 
 +
<br>The Raspberry Pi Model A+ and B+ boards, and the Pi 2 Model B, have a 40-pin header marked J8, arranged as 2x20 pins. The first 26 pins are the same as P1 on the A/B boards, with the remaining 14 pins providing additional GPIO and ground pins, and an EEPROM ID feature for auto-configuration with add-on "HAT" boards.<ref>[http://www.raspberrypi.org/wp-content/uploads/2014/04/bplus-gpio.png raspberrypi.org]</ref>
 +
 
 +
== Interfacing with GPIO pins ==
 +
 
 +
'''GPIO voltage levels are 3.3&nbsp;V and are not 5&nbsp;V tolerant. There is no over-voltage protection on the board''' - the intention is that people interested in serious interfacing will use an external board with buffers, level conversion and analog I/O rather than soldering directly onto the main board.
 +
 
 +
All the GPIO pins can be reconfigured to provide alternate functions, SPI, [http://en.wikipedia.org/wiki/Pulse-width_modulation PWM], I²C and so. At reset only pins GPIO 14 & 15 are assigned to the alternate function UART, these two can be switched back to GPIO to provide a total of 17 GPIO pins<ref>[http://www.raspberrypi.org/archives/384 raspberrypi.org]</ref>. Each of their functions and full details of how to access are detailed in the chipset datasheet <ref>[http://www.raspberrypi.org/wp-content/uploads/2012/02/BCM2835-ARM-Peripherals.pdf raspberrypi.org]</ref>.
 +
 
 +
Each GPIO can interrupt, high/low/rise/fall/change.<ref>http://www.raspberrypi.org/archives/384#comment-5217</ref><ref>http://www.raspberrypi.org/wp-content/uploads/2012/02/BCM2835-ARM-Peripherals.pdf</ref> There is currently no support for GPIO interrupts in the official kernel, however a patch exists, requiring compilation of modified source tree.<ref>http://www.raspberrypi.org/phpBB3/viewtopic.php?f=44&t=7509</ref> The 'Raspbian "wheezy"' <ref>http://www.raspberrypi.org/downloads</ref> version that is currently recommended for starters already includes GPIO interrupts.
 +
 
 +
GPIO input hysteresis (Schmitt trigger) can be on or off, output slew rate can be fast or limited, and source and sink current is configurable from 2&nbsp;mA up to 16&nbsp;mA. Note that chipset GPIO pins 0-27 are in the same block and these properties are set per block, not per pin. See [http://www.scribd.com/doc/101830961/GPIO-Pads-Control2 GPIO Datasheet Addendum - GPIO Pads Control]. Particular attention should be applied to the note regarding SSO (Simultaneous Switching Outputs): to avoid interference, driving currents should be kept as low as possible.
 +
 
 +
The available [[RPi BCM2835 GPIOs|alternative functions]] and their corresponding pins are detailed below. These numbers are in reference to the chipset documentation and may not match the numbers exposed in Linux. Only fully usable functions are detailed, for some alternative functions not all the necessary pins are available for the funtionality to be actually used.
 +
 
 +
There is also some information on the [[RPi Tutorial Easy GPIO Hardware & Software|Tutorial on Easy GPIO Hardware & Software]].
 +
 
 +
Kernel boot messages go to the UART at 115200&nbsp;bit/s - there are more details on the [[RPi Serial Connection|serial port]] page.
 +
 
 +
 
 +
 
 +
===P1 Header pinout, top row===
 +
{| border="1" style="text-align:center;"
 +
| '''Pin Number''' || '''Pin Name Rev1''' || '''Pin Name Rev2''' || '''Hardware Notes''' || '''Alt 0 Function''' || '''Other Alternative Functions'''
 +
|-
 +
| P1-02 || bgcolor="red"  colspan="2" | <span style="color:white">5V0</span> || Supply through input poly fuse
 +
| &nbsp;
 +
| &nbsp;
 +
|-
 +
| P1-04 || bgcolor="red"  colspan="2" | <span style="color:white">5V0</span> || Supply through input poly fuse
 +
| &nbsp;
 +
| &nbsp;
 +
|-
 +
| P1-06 || bgcolor="black"  colspan="2" | <span style="color:white">GND</span>
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|-
 +
| P1-08 || bgcolor="lime"  colspan="2" | GPIO 14 || Boot to Alt 0 -> || bgcolor="yellow" | UART0_TXD || ALT5 = UART1_TXD
 +
|-
 +
| P1-10 || bgcolor="lime"  colspan="2" | GPIO 15 || Boot to Alt 0 -> || bgcolor="yellow" | UART0_RXD || ALT5 = UART1_RXD
 +
|-
 +
| P1-12 || bgcolor="lime"  colspan="2" | GPIO 18  ||&nbsp; || PCM_CLK || ALT4 = SPI1_CE0_N ALT5 = PWM0
 
|-
 
|-
| P1-22 || bgcolor="lime" | BCM2835 GPIO25
+
| P1-14 || bgcolor="black" colspan="2" | <span style="color:white">GND</span>
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp; 
 
|-
 
|-
| P1-24 || bgcolor="purple" | <span style="color:white">SPI_CE0_N</span> || || (BCM2835 GPIO8-ALT0) || GPIO08
+
| P1-16 || bgcolor="lime" colspan="2" | GPIO23 || || || ALT3 = SD1_CMD ALT4 = ARM_RTCK
 
|-
 
|-
| P1-26 || bgcolor="purple" | <span style="color:white">SPI_CE1_N</span> || || (BCM2835 GPIO7-ALT0) || GPIO08
+
| P1-18 || bgcolor="lime"  colspan="2" | GPIO24 || || || ALT3 = SD1_DAT0 ALT4 = ARM_TDO
 +
|-
 +
| P1-20 || bgcolor="black"  colspan="2" | <span style="color:white">GND</span>
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|-
 +
| P1-22 || bgcolor="lime"  colspan="2" | GPIO25 || || || ALT3 = SD1_DAT1 ALT4 = ARM_TCK
 +
|-
 +
| P1-24 || bgcolor="lime"  colspan="2" | GPIO08 || || bgcolor="purple" | <span style="color:white">SPI0_CE0_N</span> ||
 +
|-
 +
| P1-26 || bgcolor="lime"  colspan="2" | GPIO07 || || bgcolor="purple" | <span style="color:white">SPI0_CE1_N</span> ||  
 
|}
 
|}
  
 
+
===P1 Header pinout, bottom row===
'''Header Pinout, bottom row:'''
 
 
{| border="1" style="text-align:center;"
 
{| border="1" style="text-align:center;"
| '''Pin Name''' || '''Pin Function''' || '''Hardware Notes''' || '''General Notes''' || '''Alternative Functions'''
+
| '''Pin Number''' || '''Pin Name Rev1''' || '''Pin Name Rev2''' || '''Hardware Notes''' || '''Alt 0 Function''' || '''Other Alternative Functions'''
 
|-
 
|-
| P1-01 || bgcolor="orange" | 3V3
+
| P1-01 || bgcolor="orange"  colspan="2" | 3.3&nbsp;V  || 50&nbsp;mA max (01 & 17)
 +
| &nbsp;
 +
| &nbsp;
 
|-
 
|-
| P1-03 || bgcolor="cyan" | I2C0_SDA || 1K8 pull up resistor || (BCM2835 GPIO0-ALT0) || GPIO00
+
| P1-03 || bgcolor="lime" | GPIO 0 || bgcolor="lime" | '''GPIO 2'''|| 1K8 pull up resistor || bgcolor="cyan" | I2C0_SDA / '''I2C1_SDA''' ||
 
|-
 
|-
| P1-05 || bgcolor="cyan" | I2C0_SCL || 1K8 pull up resistor || (BCM2835 GPIO1-ALT0) || GPIO01
+
| P1-05 || bgcolor="lime" | GPIO 1 || bgcolor="lime" | '''GPIO 3'''|| 1K8 pull up resistor || bgcolor="cyan" | I2C0_SCL / '''I2C1_SCL''' ||
 
|-
 
|-
| P1-07 || bgcolor="lime" | GPCLK0 || || (BCM2835 GPIO4-ALT0) || GPIO04-ALT5 is ARM_TDI, GPIO4
+
| P1-07 || bgcolor="lime"  colspan="2" | GPIO 4 || || GPCLK0 || ALT5 = ARM_TDI
 
|-
 
|-
| P1-09 || DNC || pulled low in v1
+
| P1-09 || bgcolor="black"  colspan="2" | <span style="color:white">GND</span>
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp; 
 
|-
 
|-
| P1-11 || bgcolor="lime" | BCM2835 GPIO17 || || ||| GPIO17_ALT3 is UART0_RTS
+
| P1-11 || bgcolor="lime"  colspan="2" | GPIO17 || || ||| ALT3 = UART0_RTS ALT4 = SPI1_CE1_N ALT5 = UART1_RTS
 
|-
 
|-
| P1-13 || bgcolor="lime" | BCM2835 GPIO21 || ||
+
| P1-13 || bgcolor="lime" | GPIO21 || bgcolor="lime" | '''GPIO27''' || || PCM_DOUT / '''reserved''' || ALT4 = SPI1_SCLK ALT5 = GPCLK1 / '''ALT3 = SD1_DAT3 ALT4 = ARM_TMS'''
 
|-
 
|-
| P1-15 || bgcolor="lime" | BCM2835 GPIO22 || ||
+
| P1-15 || bgcolor="lime"  colspan="2" | GPIO22 || || || ALT3 = SD1_CLK ALT4 = ARM_TRST
 
|-
 
|-
| P1-17 || DNC || pulled high (3v3) in v1
+
| P1-17 || bgcolor="orange"  colspan="2" | 3.3&nbsp;V || 50&nbsp;mA max (01 & 17)
 +
| &nbsp;
 +
| &nbsp;
 
|-
 
|-
| P1-19 || bgcolor="purple" | <span style="color:white">SPI_MOSI</span> || || (BCM2835 GPIO10-ALT0) || GPIO10
+
| P1-19 || bgcolor="lime"  colspan="2" | GPIO10 || || bgcolor="purple" | <span style="color:white">SPI0_MOSI</span> ||  
 
|-
 
|-
| P1-21 || bgcolor="purple" | <span style="color:white">SPI_MISO</span> || || (BCM2835 GPIO09-ALT0) || GPIO09
+
| P1-21 || bgcolor="lime" colspan="2"  | GPIO9 || || bgcolor="purple" | <span style="color:white">SPI0_MISO</span> ||
 
|-
 
|-
| P1-23 || bgcolor="purple" | <span style="color:white">SPI_SCLK</span> || || (BCM2835 GPIO11-ALT0) || GPIO11
+
| P1-23 || bgcolor="lime"  colspan="2" | GPIO11 || || bgcolor="purple" | <span style="color:white">SPI0_SCLK</span> ||  
 
|-
 
|-
| P1-25 || DNC || pulled low in v1
+
| P1-25 || bgcolor="black"  colspan="2" | <span style="color:white">GND</span>
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 
|}
 
|}
  
Line 93: Line 232:
 
! Colour legend
 
! Colour legend
 
|-
 
|-
| bgcolor="red" | <span style="color:white">+5V</span>
+
| bgcolor="red" | <span style="color:white">+5&nbsp;V</span>
 
|-
 
|-
| bgcolor="orange" | +3.3V
+
| bgcolor="orange" | +3.3&nbsp;V
 
|-
 
|-
| Do not connect
+
| bgcolor="black" | <span style="color:white">Ground, 0V</span>
 
|-
 
|-
 
| bgcolor="yellow" | UART
 
| bgcolor="yellow" | UART
Line 105: Line 244:
 
| bgcolor="purple" | <span style="color:white">SPI</span>
 
| bgcolor="purple" | <span style="color:white">SPI</span>
 
|-
 
|-
| bgcolor="cyan" | I2C
+
| bgcolor="cyan" | I²C
 
|}
 
|}
  
KiCad symbol: [[File:Conn-raspberry.lib]]
+
KiCad symbol: [[File:Conn-raspberry.lib]]<ref>http://www.raspberrypi.org/forum/projects-and-collaboration-general/gpio-header-pinout-clarification/page-2</ref>
 
 
<ref>http://www.raspberrypi.org/forum/projects-and-collaboration-general/gpio-header-pinout-clarification/page-2</ref>
 
 
 
The complete list of chipset GPIO pins which are available is: <pre>0, 1, 4, 7, 8, 9, 10, 11, 14, 15, 17, 18, 21, 22, 23, 24, 25</pre>
 
 
 
Pin 3 (SDA0) and Pin 5 (SCL0) are preset to be used as I2C interface. So there are 1K8 pulls up resistors on the board for these pins.<ref>http://www.raspberrypi.org/forum/features-and-requests/easy-gpio-hardware-software/page-6/#p56480</ref>
 
 
 
Pin 12 supports PWM.
 
 
 
GPIO voltage level is 3V3 and are not 5V tolerant.
 
 
 
Each GPIO can interrupt, high/low/rise/fall/change.<ref>http://www.raspberrypi.org/archives/384#comment-5217</ref><ref>http://www.raspberrypi.org/wp-content/uploads/2012/02/BCM2835-ARM-Peripherals.pdf</ref>
 
 
 
It is also possible to reconfigure some of the pins to provide an ARM JTAG interface.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.1</ref> However ARM_TMS isn't available for this (chipset pin 12 or 27 is needed).
 
  
It is also possible to reconfigure some of the pins to provide an I2S (hardware mod may be required<ref name="I2S">[http://www.raspberrypi.org/forum/features-and-requests/sad-about-removal-of-i2s-why-was-this-change-made Forum:Sad about removal of I2S. Why was this change made?]</ref>) or PCM interface.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.2</ref> However, PCM_FS and PCM_DIN (chipset pins 19 or 29 and 20 or 30) are needed for I2S or PCM.
+
Pin 3 (SDA0) and Pin 5 (SCL0) are preset to be used as an I²C interface. So there are 1.8&nbsp;kohm pulls up resistors on the board for these pins.<ref>http://www.raspberrypi.org/forum/features-and-requests/easy-gpio-hardware-software/page-6/#p56480</ref>
  
It is also possible to reconfigure some of the pins to provide a second I2C interface. [no-ref]
+
Pin 12 supports [http://en.wikipedia.org/wiki/Pulse-width_modulation PWM].
  
There is also some information here [http://elinux.org/RPi_Tutorial_Easy_GPIO_Hardware_%26_Software]
+
It is also possible to reconfigure GPIO connector pins P1-7, 15, 16, 18, 22 (chipset GPIOs 4 and 22 to 25) to provide an ARM JTAG interface.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.1</ref> However ARM_TMS is not available on the GPIO connector (chipset pin 12 or 27 is needed). Chipset pin 27 is available on S5, the CSI camera interface however.
  
===A note about GPIO vs the schematic===
+
It is also possible to reconfigure GPIO connector pins P1-12 and 13 (chipset GPIO 18 and 21) to provide an I2S (a hardware modification may be required<ref name="I2S">[http://www.raspberrypi.org/forum/features-and-requests/sad-about-removal-of-i2s-why-was-this-change-made Forum:Sad about removal of I2S. Why was this change made?]</ref>) or PCM interface.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.2</ref> However, PCM_FS and PCM_DIN (chipset pins 19 and 20) are needed for I2S or PCM.
  
You may notice that the GPIO connector as documented in the schematic does NOT match with what is on this wiki page. Do NOT update this wiki page. The pins which are marked as NC should not be used in order to be compatible with possible future designs. The plan is that if a new design comes along and if the layout permits it we will connect additional GPIO pins to those NC pins. (Gert's first vote is for GPIO 19 and 20, That gives us the second PWM, second SPI and I2S)
+
A second I²C interface (GPIO02_ALT0 is SDA1 and GPIO03_ALT0 is SCL1) and two further GPIOs (GPIO05_ALT0 is GPCLK1, and GPIO27) are available on S5, the CSI camera interface.
  
 
===Referring to pins on the Expansion header===
 
===Referring to pins on the Expansion header===
 
 
The header is referred to as "The GPIO Connector (P1)".  To avoid nomenclature confusion between Broadcom signal names on the SoC and pin names on the expansion header, the following naming is highly recommended:
 
The header is referred to as "The GPIO Connector (P1)".  To avoid nomenclature confusion between Broadcom signal names on the SoC and pin names on the expansion header, the following naming is highly recommended:
 
 
* The expansion header is referred to as "Expansion Header" or "GPIO Connector (P1)"
 
* The expansion header is referred to as "Expansion Header" or "GPIO Connector (P1)"
 
* Pins on the GPIO connector (P1) are referred to as P1-01, etc.
 
* Pins on the GPIO connector (P1) are referred to as P1-01, etc.
* Names GPIO0, GPIO1, GPIOx-ALTy, etc refer to the signal names on the SoC as enumerated in the Broadcom datasheet, where "x" matches BCM2835 number (without leading zero) and "y" is the alternate number column 0 to 5 on page 102-103 of the Broadcom document. For example, depending on what you are describing, use either "GPIO7" to refer to a row of the table, and "GPIO7-ALT0" would refer to a specific cell of the table.
+
* Names GPIO0, GPIO1, GPIOx-ALTy, etc. refer to the signal names on the SoC as enumerated in the Broadcom datasheet, where "x" matches BCM2835 number (without leading zero) and "y" is the alternate number column 0 to 5 on page 102-103 of the Broadcom document. For example, depending on what you are describing, use either "GPIO7" to refer to a row of the table, and "GPIO7-ALT0" would refer to a specific cell of the table.
* When refering to signal names, you should modify the Broadcom name slightly to minimize confusion. The Broadcom SPI bus pin names are fine, such as "SPI0_*" and "SPI1_*", but they didn't do the same on the I2C and UART pins. Instead of using "SDA0" and "SCL0", you should use "I2C0_SDA" and "I2C0_SCL"; and instead of "TX" or "TXD" and "RX" or "RXD", you should use "UART0_TXD" and "UART0_RXD".
+
* When refering to signal names, the Broadcom name should be modified slightly to minimize confusion. The Broadcom SPI bus pin names are fine, such as "SPI0_*" and "SPI1_*", but they did not do the same on the I²C and UART pins. Instead of using "SDA0" and "SCL0", "I2C0_SDA" and "I2C0_SCL" should be used; and "UART0_TXD" and "UART0_RXD" instead of "TX" or "TXD" and "RX" or "RXD".
  
 
===Power pins===
 
===Power pins===
Maximum permitted current draw from the 3v3 pin is 50mA.
+
The maximum permitted current draw from the 3.3&nbsp;V pins is 50&nbsp;mA.
  
Maximum permitted current draw from the 5v pin is the USB input current (usually 1A) minus any current draw from the rest of the board.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1536#postid-21841</ref>
+
Maximum permitted current draw from the 5&nbsp;V pin is the USB input current (usually 1&nbsp;A) minus any current draw from the rest of the board.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1536#postid-21841</ref>
*Model A: 1000mA - 500mA -> max power draw: 500mA
+
*Model A: 1000&nbsp;mA - 500&nbsp;mA -> max current draw: 500&nbsp;mA
*Model B: 1000mA - 700mA -> max power draw: 300mA
+
*Model B: 1000&nbsp;mA - 700&nbsp;mA -> max current draw: 300&nbsp;mA
 +
Be very careful with the 5&nbsp;V pins P1-02 and P1-04, because if you short 5&nbsp;V to any other P1 pin you may permanently damage your RasPi. Before probing P1, it is a good idea to strip short pieces of insulation off a wire and push them over the 5&nbsp;V pins are not accidentally shorted with a probe.
  
===Driver support===
+
=== GPIO hardware hacking ===
 +
The complete list of [[RPi_BCM2835_GPIOs|chipset GPIO pins]] which are available on the GPIO connector is: <blockquote>[[RPi_BCM2835_GPIOs#GPIO0|0]], [[RPi_BCM2835_GPIOs#GPIO1|1]], [[RPi_BCM2835_GPIOs#GPIO4|4]], [[RPi_BCM2835_GPIOs#GPIO7|7]], [[RPi_BCM2835_GPIOs#GPIO8|8]], [[RPi_BCM2835_GPIOs#GPIO9|9]], [[RPi_BCM2835_GPIOs#GPIO10|10]], [[RPi_BCM2835_GPIOs#GPIO11|11]], [[RPi_BCM2835_GPIOs#GPIO14|14]], [[RPi_BCM2835_GPIOs#GPIO15|15]], [[RPi_BCM2835_GPIOs#GPIO17|17]], [[RPi_BCM2835_GPIOs#GPIO18|18]], [[RPi_BCM2835_GPIOs#GPIO21|21]], [[RPi_BCM2835_GPIOs#GPIO22|22]], [[RPi_BCM2835_GPIOs#GPIO23|23]], [[RPi_BCM2835_GPIOs#GPIO24|24]], [[RPi_BCM2835_GPIOs#GPIO25|25]]</blockquote>
  
The Foundation will not include a GPIO driver in the initial release, standard linux GPIO drivers should work with minimal modification.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1278.0</ref>
+
(on the Revision2.0 RaspberryPis, this list changes to: [[RPi_BCM2835_GPIOs#GPIO2|2]], [[RPi_BCM2835_GPIOs#GPIO3|3]], [[RPi_BCM2835_GPIOs#GPIO4|4]], [[RPi_BCM2835_GPIOs#GPIO7|7]], [[RPi_BCM2835_GPIOs#GPIO8|8]], [[RPi_BCM2835_GPIOs#GPIO9|9]], [[RPi_BCM2835_GPIOs#GPIO10|10]], [[RPi_BCM2835_GPIOs#GPIO11|11]], [[RPi_BCM2835_GPIOs#GPIO14|14]], [[RPi_BCM2835_GPIOs#GPIO15|15]], [[RPi_BCM2835_GPIOs#GPIO17|17]], [[RPi_BCM2835_GPIOs#GPIO18|18]], [[RPi_BCM2835_GPIOs#GPIO22|22]], [[RPi_BCM2835_GPIOs#GPIO23|23]], [[RPi_BCM2835_GPIOs#GPIO24|24]], [[RPi_BCM2835_GPIOs#GPIO25|25]], [[RPi_BCM2835_GPIOs#GPIO27|27]], with [[RPi_BCM2835_GPIOs#GPIO28|28]], [[RPi_BCM2835_GPIOs#GPIO29|29]], [[RPi_BCM2835_GPIOs#GPIO30|30]], [[RPi_BCM2835_GPIOs#GPIO31|31]] additionally available on the [[#P5_header|P5 header]])
The Foundation will not include an SPI driver in the initial release, we hope the community might write one.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1278.0</ref>
 
The Foundation will not include an I2C driver in the initial release, we hope the community might provide one, standard linux I2C drivers should work with minimal modification.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1202</ref>
 
  
===Code examples===
+
As noted above, P1-03 and P1-05 (SDA0 and SCL0 / SDA1 and SCL1) have 1.8&nbsp;kohm pull-up resistors to 3.3&nbsp;V.
====GPIO Driving Example (C)====
 
[http://www.raspberrypi.org/forum/educational-applications/gertboard/page-4/#p31555 Gert van Loo & Dom, has provided] some tested code which accesses the GPIO pins through direct GPIO register manipulation in C-code.
 
(Thanks to Dom for doing the difficult work of finding and testing the mapping.)
 
Example GPIO code:
 
  
<pre>
+
If 17 GPIOs are not sufficient for a project, there are a few other signals potentially available, with varying levels of software and hardware (soldering iron) hackery skills:
//
 
//  How to access GPIO registers from C-code on the Raspberry-Pi
 
//  Example program
 
//  15-January-2012
 
//  Dom and Gert
 
//
 
  
 +
GPIO02, 03, 05 and 27 are available on S5 (the CSI interface) when a camera peripheral is not connected to that socket, and are configured by default to provide the functions SDA1, SCL1, CAM_CLK and CAM_GPIO respectively.  SDA1 and SCL1 have 1K6 pull-up resistors to 3.3&nbsp;V.
  
// Access from ARM Running Linux
+
GPIO06 is LAN_RUN and is available on pad 12 of the footprint for IC3 on the Model A. On Model B, it is in use for the Ethernet function.
  
#define BCM2708_PERI_BASE        0x20000000
+
There are a few other chipset GPIO pins accessible on the PCB but are in use:
#define GPIO_BASE                (BCM2708_PERI_BASE + 0x200000) /* GPIO controller */
+
* GPIO16 drives status LED D5 (usually SD card access indicator)
 +
* GPIO28-31 are used by the board ID and are connected to resistors R3 to R10 (only on Rev1.0 boards).
 +
* GPIO40 and 45 are used by analogue audio and support [http://en.wikipedia.org/wiki/Pulse-width_modulation PWM]. They connect to the analogue audio circuitry via R21 and R27 respectively.
 +
* GPIO46 is HDMI hotplug detect (goes to pin 6 of IC1).
 +
* GPIO47 to 53 are used by the SD card interface.  In particular, GPIO47 is SD card detect (this would seem to be a good candidate for re-use).  GPIO47 is connected to the SD card interface card detect switch; GPIO48 to 53 are connected to the SD card interface via resistors R45 to R50.
  
  
#include <stdio.h>
+
===Internal Pull-Ups & Pull-Downs===
#include <string.h>
+
The GPIO ports include the ability to enable and disable internal pull-up or pull-down resistors (see below for code examples/support of this):
#include <stdlib.h>
+
* Pull-up is 50 kOhm - 65 kOhm
#include <dirent.h>
+
* Pull-down is 50 kOhm - 60 kOhm
#include <fcntl.h>
 
#include <assert.h>
 
#include <sys/mman.h>
 
#include <sys/types.h>
 
#include <sys/stat.h>
 
  
#include <unistd.h>
+
===Driver support===
 
+
The Foundation will not include a GPIO driver in the initial release, standard Linux GPIO drivers should work with minimal modification.<ref>http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1278.0</ref>
#define PAGE_SIZE (4*1024)
 
#define BLOCK_SIZE (4*1024)
 
 
 
int  mem_fd;
 
char *gpio_mem, *gpio_map;
 
char *spi0_mem, *spi0_map;
 
 
 
 
 
// I/O access
 
volatile unsigned *gpio;
 
 
 
 
 
// GPIO setup macros. Always use INP_GPIO(x) before using OUT_GPIO(x) or SET_GPIO_ALT(x,y)
 
#define INP_GPIO(g) *(gpio+((g)/10)) &= ~(7<<(((g)%10)*3))
 
#define OUT_GPIO(g) *(gpio+((g)/10)) |= (1<<(((g)%10)*3))
 
#define SET_GPIO_ALT(g,a) *(gpio+(((g)/10))) |= (((a)<=3?(a)+4:(a)==4?3:2)<<(((g)%10)*3))
 
 
 
#define GPIO_SET *(gpio+7)  // sets  bits which are 1 ignores bits which are 0
 
#define GPIO_CLR *(gpio+10) // clears bits which are 1 ignores bits which are 0
 
 
 
void setup_io();
 
 
 
int main(int argc, char **argv)
 
{ int g,rep;
 
 
 
  // Set up gpi pointer for direct register access
 
  setup_io();
 
 
 
  // Switch GPIO 7..11 to output mode
 
 
 
/************************************************************************\
 
  * You are about to change the GPIO settings of your computer.          *
 
  * Mess this up and it will stop working!                              *
 
  * It might be a good idea to 'sync' before running this program        *
 
  * so at least you still have your code changes written to the SD-card! *
 
\************************************************************************/
 
 
 
  // Set GPIO pins 7-11 to output
 
  for (g=7; g<=11; g++)
 
  {
 
    INP_GPIO(g); // must use INP_GPIO before we can use OUT_GPIO
 
    OUT_GPIO(g);
 
  }
 
 
 
  for (rep=0; rep<10; rep++)
 
  {
 
    for (g=7; g<=11; g++)
 
    {
 
      GPIO_SET = 1<<g;
 
      sleep(1);
 
    }
 
    for (g=7; g<=11; g++)
 
    {
 
      GPIO_CLR = 1<<g;
 
      sleep(1);
 
    }
 
  }
 
 
 
  return 0;
 
 
 
} // main
 
 
 
 
 
//
 
// Set up a memory regions to access GPIO
 
//
 
void setup_io()
 
{
 
 
 
  /* open /dev/mem */
 
  if ((mem_fd = open("/dev/mem", O_RDWR|O_SYNC) ) < 0) {
 
      printf("can't open /dev/mem \n");
 
      exit (-1);
 
  }
 
 
 
  /* mmap GPIO */
 
 
 
  // Allocate MAP block
 
  if ((gpio_mem = malloc(BLOCK_SIZE + (PAGE_SIZE-1))) == NULL) {
 
      printf("allocation error \n");
 
      exit (-1);
 
  }
 
 
 
  // Make sure pointer is on 4K boundary
 
  if ((unsigned long)gpio_mem % PAGE_SIZE)
 
    gpio_mem += PAGE_SIZE - ((unsigned long)gpio_mem % PAGE_SIZE);
 
 
 
  // Now map it
 
  gpio_map = (unsigned char *)mmap(
 
      (caddr_t)gpio_mem,
 
      BLOCK_SIZE,
 
      PROT_READ|PROT_WRITE,
 
      MAP_SHARED|MAP_FIXED,
 
      mem_fd,
 
      GPIO_BASE
 
  );
 
 
 
  if ((long)gpio_map < 0) {
 
      printf("mmap error %d\n", (int)gpio_map);
 
      exit (-1);
 
  }
 
 
 
  // Always use volatile pointer!
 
  gpio = (volatile unsigned *)gpio_map;
 
 
 
 
 
} // setup_io
 
 
 
</pre>
 
 
 
====GPIO Pull Up/Pull Down Register Example====
 
<pre>
 
  // enable pull-up on GPIO24&25
 
  GPIO_PULL = 2;
 
  short_wait();
 
  // clock on GPIO 24 & 25 (bit 24 & 25 set)
 
  GPIO_PULLCLK0 = 0x03000000;
 
  short_wait();
 
  GPIO_PULL = 0;
 
  GPIO_PULLCLK0 = 0;
 
</pre>
 
 
 
====GPIO Driving Example (Python)====
 
This uses the Python module available at http://pypi.python.org/pypi/RPi.GPIO
 
* Disclaimer: Untested !
 
<pre>
 
import RPi.GPIO as GPIO
 
 
 
# set up the GPIO channels - channel 0 (input) and channel 1 (output)
 
GPIO.setup(0, GPIO.IN)
 
GPIO.setup(1, GPIO.OUT)
 
  
# input from channel 0 - note that input_value will be a boolean
+
The community implemented SPI and I²C drivers <ref>http://www.bootc.net/projects/raspberry-pi-kernel/</ref>, which will be integrated with the new Linux pinctrl concept in a later version of the kernel. (On Oct. 14 2012, it was already included in the latest raspbian image.) A first compiled version as Linux modules is available to install on the 19/04/2012 Debian image, including 1-wire support<ref>http://www.raspberrypi.org/phpBB3/viewtopic.php?p=86172#p86172</ref>. The I²C and SPI driver uses the hardware modules of the microcontroller and interrupts for low CPU usage, the 1-wire support uses bitbanging on the GPIO ports, which results in higher CPU usage.
input_value = GPIO.input(0)
 
  
# output True to channel 1. NB you can use '1', 1 or anything that evaluates to True/False
+
GordonH<ref>http://www.raspberrypi.org/forum/general-discussion/wiring-for-the-raspberry-pis-gpio</ref> wrote a (mostly) Arduino compatible/style [https://projects.drogon.net/raspberry-pi/wiringpi/ WiringPi library] in C for controlling the GPIO pins.
GPIO.output(1, True)
 
</pre>
 
  
====GPIO Driving Example (Shell script)====
+
A useful tutorial on setting up I²C driver support can be found at [http://www.robot-electronics.co.uk/htm/raspberry_pi_examples.htm Robot Electronics] - look for the downloadable document rpi_i2c_setup.doc
* Disclaimer: Untested !
 
<pre>
 
#!/bin/sh
 
  
# GPIO numbers should be from this list
+
==SPI==
# 0, 1, 4, 7, 8, 9, 10, 11, 14, 15, 17, 18, 21, 22, 23, 24, 25
 
  
# set up GPIO 4 and set to output
+
There are two SPI bus brought out to the header: [[RPi_SPI]]
echo "4" > /sys/class/gpio/export
 
echo "out" > /sys/class/gpio/gpio4/direction
 
  
# set up GPIO 7 and set to input
+
==I²C==
echo "7" > /sys/class/gpio/export
 
echo "in" > /sys/class/gpio/gpio7/direction
 
  
# write output
+
There are two I²C-buses on the Raspberry Pi: One on P1, and one on P5.
echo "1" > /sys/class/gpio/gpio4/value
 
  
# read from input
+
Note that there's a bug concerning I²C-clock-stretching, so don't use I²C-devices which use clock-stretching directly with the Raspberry Pi, or use a workaround. Details about this bug can be found at:
cat /sys/class/gpio/gpio7/value
 
  
# clean up
+
* http://www.raspberrypi.org/phpBB3/viewtopic.php?f=44&t=13771
echo "4" > /sys/class/gpio/unexport
+
* http://www.advamation.com/knowhow/raspberrypi/rpi-i2c-bug.html
echo "7" > /sys/class/gpio/unexport
 
</pre>
 
  
 
==MIPI CSI-2==
 
==MIPI CSI-2==
  
On the production board, we bring out the MIPI CSI-2 interface to a 15-way flat flex connector
+
On the production board<ref>http://www.raspberrypi.org/wp-content/uploads/2012/04/Raspberry-Pi-Schematics-R1.0.pdf</ref>, the Raspberry Pi Foundation design brings out the MIPI CSI-2 (Camera Serial Interface<ref>http://www.mipi.org/specifications/camera-interface</ref>) to a 15-way flat flex connector S5, between the Ethernet and HDMI connectors. A compatible camera<ref>http://elinux.org/Rpi_Camera_Module</ref> with 5 Megapixels and 1080p video resolution was released in May 2013.
 
 
is Sony sub-LVDS same as MIPI CSI-2? Sony IMX020 5Mbip module is available for $5-7 (SE K850i replacement camera).
 
 
 
Looks like Nokia N95 uses CSI-2 5Mpix camera module with autofocus. ~$15 replacement part.
 
  
 
==DSI==
 
==DSI==
  
On the production board, we bring out the DSI interface to a 15-way flat flex connector.
+
On the production board, the Raspberry Pi Foundation design brings out the DSI (Display Serial Interface<ref>http://www.mipi.org/specifications/display-interface</ref>) to a 15-way flat flex connector labelled S2, next to Raspberry Pi logo. It has two data lanes and a clock lane, to drive a possible future LCD screen device. Some smart phone screens use DSI<ref>http://en.wikipedia.org/wiki/Display_Serial_Interface</ref>.
  
 
==CEC==
 
==CEC==
Line 371: Line 334:
 
[[CEC (Consumer Electronics Control) over HDMI|HDMI-CEC (Consumer Electronics Control for HDMI)]] is supported by hardware but some driver work will be needed and currently isn't exposed into Linux userland.
 
[[CEC (Consumer Electronics Control) over HDMI|HDMI-CEC (Consumer Electronics Control for HDMI)]] is supported by hardware but some driver work will be needed and currently isn't exposed into Linux userland.
 
Eben notes that he has seen CEC demos on the Broadcom SoC they are using.  
 
Eben notes that he has seen CEC demos on the Broadcom SoC they are using.  
 +
 +
libCEC with Raspberry Pi support has been included in OpenELEC and will be included in Raspbmc RC4.<ref>http://blog.pulse-eight.com/2012/08/01/libcec-1-8-0-a-firmware-upgrade-and-raspberry-pi-support/</ref>
  
 
For more information about HDMI-CEC and what you could do with it on the Raspberry Pi please see the [[CEC (Consumer Electronics Control) over HDMI]] article.
 
For more information about HDMI-CEC and what you could do with it on the Raspberry Pi please see the [[CEC (Consumer Electronics Control) over HDMI]] article.

Revision as of 08:15, 19 January 2017


RaspPi.png Back to the Hub


Hardware & Peripherals:

Hardware - detailed information about the Raspberry Pi boards.

Hardware History - guide to the Raspberry Pi models.

Low-level Peripherals - using the GPIO and other connectors.

Expansion Boards - GPIO plug-in boards providing additional functionality.

Screens - attaching a screen to the Raspberry Pi.

Cases - lots of nice cases to protect the Raspberry Pi.

Other Peripherals - all sorts of peripherals used with the Raspberry Pi.


Introduction

In addition to the familiar USB, Ethernet and HDMI ports, the Raspberry Pi offers the ability to connect directly to a variety of electronic devices. These include:

  • Digital outputs: turn lights, motors, or other devices on or off
  • Digital inputs: read an on or off state from a button, switch, or other sensor
  • Communication with chips or modules using low-level protocols: SPI, I²C, or serial UART

Connections are made using GPIO ("General Purpose Input/Output") pins. Unlike USB, etc., these interfaces are not "plug and play" and require care to avoid miswiring. The Raspberry PI GPIOs use 3.3V logic levels, and can be damaged if connected directly to 5V levels (as found in many older digital systems) without level-conversion circuitry.

Note that no analogue input or output is available. However, add-on boards such as the Rpi Gertboard provide this capability.

Links


General Purpose Input/Output (GPIO)

Model A and B (Original)

P1 Header

thumb 26-pin GPIO header layout. Note that Rev 1 PCBs had different assignments for pins 3, 5, and 13. |
RPi P1 header.png

The Raspberry Pi Model A and B boards have a 26-pin 2.54 mm (100 mil)[1] expansion header, marked as P1, arranged in a 2x13 strip. They provide 8 GPIO pins plus access to I²C, SPI, UART), as well as +3.3 V, +5 V and GND supply lines. Pin one is the pin in the first column and on the bottom row. [2]

Revision 1 PCBs: Raspberry Pis with a revision 1 PCB (September 2012 or earlier) have a different pin assignment on the P1 connector:

  • P1 pin 3 is GPIO 0 / SDA0 (not GPIO 2)
  • P1 pin 5 is GPIO 1 / SCL0 (not GPIO 3)
  • P1 pin 13 is GPIO 21 (not GPIO 27)

Revision 1 PCBs also do not have the P5 header (see below). See this discussion for more details of the changes between Rev 1 and Rev 2 PCBs.

P2 header

The P2 header is the VideoCore JTAG and used only during the production of the board. It cannot be used as the ARM JTAG [3]. This connector is unpopulated in Rev 2.0 boards.

RPi P2 header.png

Useful P2 pins:

  • Pin 1 - 3.3V (same as P1-01, 50 mA max current draw across both of them)
  • Pin 7 - GND
  • Pin 8 - GND

P3 header

The P3 header, unpopulated, is the LAN9512 JTAG [4].

RPi P3 header.png

Useful P3 pins:

  • Pin 7 - GND

P5 header

The P5 header was added with the release of the Revision 2.0 PCB design.

RPi P5 header.png

P5 Header pinout, top row

As seen from the back of the board:

Pin Number Pin Name Rev2 Hardware Notes Alt 0 Function Other Alternative Functions
P5-01 5V0 Supply through input poly fuse
P5-03 GPIO28 I2C0_SDA ALT2 = PCM_CLK
P5-05 GPIO30 ALT2 = PCM_DIN ALT3 = UART0_CTS ALT5 = UART1_CTS
P5-07 GND

P5 Header pinout, bottom row

As seen from the back of the board:

Pin Number Pin Name Rev2 Hardware Notes Alt 0 Function Other Alternative Functions
P5-02 3.3 V 50 mA max (combined with P1)
P5-04 GPIO29 I2C0_SCL ALT2 = PCM_FS
P5-06 GPIO31 ALT2 = PCM_DOUT ALT3 = UART0_RTS ALT5 = UART1_RTS
P5-08 GND
Slanted P5 header

Note that the connector is intended to be mounted on the bottom of the PCB, so that for those who put the connector on the top side, the pin numbers are mirrored. Pin 1 and pin 2 are swapped, pin 3 and 4, etc.

An alternative way to attach this header is on top, at a slant away from the P1 header.

The new header can provide a second I²C channel (SDA + SCL) and handshake lines for the existing UART (TxD and RxD), or it can be used for an I2S (audio codec chip) interface using the PCM signals CLK, FS (Frame Sync), Din and Dout.

Note that the connector is placed JUST off-grid with respect to the P1 connector.

P6 header

The P6 header was added with the release of the Revision 2.0 PCB design.

RPi P6 header.png

P6 Pinout

Pin Number Pin Name Rev2 Hardware Notes
P6-01 RUN Short to ground to reset the BCM2835
P6-02 GND

A reset button can be attached to the P6 header.[5] Momentarily shorting the two pins of P6 together will cause a soft reset of the CPU (which can also 'wake' the Pi from halt/shutdown state).

Model A+, B+ and B2

Model A+
Models B+, B2
Connector pinout


The Raspberry Pi Model A+ and B+ boards, and the Pi 2 Model B, have a 40-pin header marked J8, arranged as 2x20 pins. The first 26 pins are the same as P1 on the A/B boards, with the remaining 14 pins providing additional GPIO and ground pins, and an EEPROM ID feature for auto-configuration with add-on "HAT" boards.[6]

Interfacing with GPIO pins

GPIO voltage levels are 3.3 V and are not 5 V tolerant. There is no over-voltage protection on the board - the intention is that people interested in serious interfacing will use an external board with buffers, level conversion and analog I/O rather than soldering directly onto the main board.

All the GPIO pins can be reconfigured to provide alternate functions, SPI, PWM, I²C and so. At reset only pins GPIO 14 & 15 are assigned to the alternate function UART, these two can be switched back to GPIO to provide a total of 17 GPIO pins[7]. Each of their functions and full details of how to access are detailed in the chipset datasheet [8].

Each GPIO can interrupt, high/low/rise/fall/change.[9][10] There is currently no support for GPIO interrupts in the official kernel, however a patch exists, requiring compilation of modified source tree.[11] The 'Raspbian "wheezy"' [12] version that is currently recommended for starters already includes GPIO interrupts.

GPIO input hysteresis (Schmitt trigger) can be on or off, output slew rate can be fast or limited, and source and sink current is configurable from 2 mA up to 16 mA. Note that chipset GPIO pins 0-27 are in the same block and these properties are set per block, not per pin. See GPIO Datasheet Addendum - GPIO Pads Control. Particular attention should be applied to the note regarding SSO (Simultaneous Switching Outputs): to avoid interference, driving currents should be kept as low as possible.

The available alternative functions and their corresponding pins are detailed below. These numbers are in reference to the chipset documentation and may not match the numbers exposed in Linux. Only fully usable functions are detailed, for some alternative functions not all the necessary pins are available for the funtionality to be actually used.

There is also some information on the Tutorial on Easy GPIO Hardware & Software.

Kernel boot messages go to the UART at 115200 bit/s - there are more details on the serial port page.


P1 Header pinout, top row

Pin Number Pin Name Rev1 Pin Name Rev2 Hardware Notes Alt 0 Function Other Alternative Functions
P1-02 5V0 Supply through input poly fuse    
P1-04 5V0 Supply through input poly fuse    
P1-06 GND      
P1-08 GPIO 14 Boot to Alt 0 -> UART0_TXD ALT5 = UART1_TXD
P1-10 GPIO 15 Boot to Alt 0 -> UART0_RXD ALT5 = UART1_RXD
P1-12 GPIO 18   PCM_CLK ALT4 = SPI1_CE0_N ALT5 = PWM0
P1-14 GND      
P1-16 GPIO23 ALT3 = SD1_CMD ALT4 = ARM_RTCK
P1-18 GPIO24 ALT3 = SD1_DAT0 ALT4 = ARM_TDO
P1-20 GND      
P1-22 GPIO25 ALT3 = SD1_DAT1 ALT4 = ARM_TCK
P1-24 GPIO08 SPI0_CE0_N
P1-26 GPIO07 SPI0_CE1_N

P1 Header pinout, bottom row

Pin Number Pin Name Rev1 Pin Name Rev2 Hardware Notes Alt 0 Function Other Alternative Functions
P1-01 3.3 V 50 mA max (01 & 17)    
P1-03 GPIO 0 GPIO 2 1K8 pull up resistor I2C0_SDA / I2C1_SDA
P1-05 GPIO 1 GPIO 3 1K8 pull up resistor I2C0_SCL / I2C1_SCL
P1-07 GPIO 4 GPCLK0 ALT5 = ARM_TDI
P1-09 GND      
P1-11 GPIO17 ALT3 = UART0_RTS ALT4 = SPI1_CE1_N ALT5 = UART1_RTS
P1-13 GPIO21 GPIO27 PCM_DOUT / reserved ALT4 = SPI1_SCLK ALT5 = GPCLK1 / ALT3 = SD1_DAT3 ALT4 = ARM_TMS
P1-15 GPIO22 ALT3 = SD1_CLK ALT4 = ARM_TRST
P1-17 3.3 V 50 mA max (01 & 17)    
P1-19 GPIO10 SPI0_MOSI
P1-21 GPIO9 SPI0_MISO
P1-23 GPIO11 SPI0_SCLK
P1-25 GND      


Colour legend
+5 V
+3.3 V
Ground, 0V
UART
GPIO
SPI
I²C

KiCad symbol: File:Conn-raspberry.lib[13]

Pin 3 (SDA0) and Pin 5 (SCL0) are preset to be used as an I²C interface. So there are 1.8 kohm pulls up resistors on the board for these pins.[14]

Pin 12 supports PWM.

It is also possible to reconfigure GPIO connector pins P1-7, 15, 16, 18, 22 (chipset GPIOs 4 and 22 to 25) to provide an ARM JTAG interface.[15] However ARM_TMS is not available on the GPIO connector (chipset pin 12 or 27 is needed). Chipset pin 27 is available on S5, the CSI camera interface however.

It is also possible to reconfigure GPIO connector pins P1-12 and 13 (chipset GPIO 18 and 21) to provide an I2S (a hardware modification may be required[16]) or PCM interface.[17] However, PCM_FS and PCM_DIN (chipset pins 19 and 20) are needed for I2S or PCM.

A second I²C interface (GPIO02_ALT0 is SDA1 and GPIO03_ALT0 is SCL1) and two further GPIOs (GPIO05_ALT0 is GPCLK1, and GPIO27) are available on S5, the CSI camera interface.

Referring to pins on the Expansion header

The header is referred to as "The GPIO Connector (P1)". To avoid nomenclature confusion between Broadcom signal names on the SoC and pin names on the expansion header, the following naming is highly recommended:

  • The expansion header is referred to as "Expansion Header" or "GPIO Connector (P1)"
  • Pins on the GPIO connector (P1) are referred to as P1-01, etc.
  • Names GPIO0, GPIO1, GPIOx-ALTy, etc. refer to the signal names on the SoC as enumerated in the Broadcom datasheet, where "x" matches BCM2835 number (without leading zero) and "y" is the alternate number column 0 to 5 on page 102-103 of the Broadcom document. For example, depending on what you are describing, use either "GPIO7" to refer to a row of the table, and "GPIO7-ALT0" would refer to a specific cell of the table.
  • When refering to signal names, the Broadcom name should be modified slightly to minimize confusion. The Broadcom SPI bus pin names are fine, such as "SPI0_*" and "SPI1_*", but they did not do the same on the I²C and UART pins. Instead of using "SDA0" and "SCL0", "I2C0_SDA" and "I2C0_SCL" should be used; and "UART0_TXD" and "UART0_RXD" instead of "TX" or "TXD" and "RX" or "RXD".

Power pins

The maximum permitted current draw from the 3.3 V pins is 50 mA.

Maximum permitted current draw from the 5 V pin is the USB input current (usually 1 A) minus any current draw from the rest of the board.[18]

  • Model A: 1000 mA - 500 mA -> max current draw: 500 mA
  • Model B: 1000 mA - 700 mA -> max current draw: 300 mA

Be very careful with the 5 V pins P1-02 and P1-04, because if you short 5 V to any other P1 pin you may permanently damage your RasPi. Before probing P1, it is a good idea to strip short pieces of insulation off a wire and push them over the 5 V pins are not accidentally shorted with a probe.

GPIO hardware hacking

The complete list of chipset GPIO pins which are available on the GPIO connector is:

0, 1, 4, 7, 8, 9, 10, 11, 14, 15, 17, 18, 21, 22, 23, 24, 25

(on the Revision2.0 RaspberryPis, this list changes to: 2, 3, 4, 7, 8, 9, 10, 11, 14, 15, 17, 18, 22, 23, 24, 25, 27, with 28, 29, 30, 31 additionally available on the P5 header)

As noted above, P1-03 and P1-05 (SDA0 and SCL0 / SDA1 and SCL1) have 1.8 kohm pull-up resistors to 3.3 V.

If 17 GPIOs are not sufficient for a project, there are a few other signals potentially available, with varying levels of software and hardware (soldering iron) hackery skills:

GPIO02, 03, 05 and 27 are available on S5 (the CSI interface) when a camera peripheral is not connected to that socket, and are configured by default to provide the functions SDA1, SCL1, CAM_CLK and CAM_GPIO respectively. SDA1 and SCL1 have 1K6 pull-up resistors to 3.3 V.

GPIO06 is LAN_RUN and is available on pad 12 of the footprint for IC3 on the Model A. On Model B, it is in use for the Ethernet function.

There are a few other chipset GPIO pins accessible on the PCB but are in use:

  • GPIO16 drives status LED D5 (usually SD card access indicator)
  • GPIO28-31 are used by the board ID and are connected to resistors R3 to R10 (only on Rev1.0 boards).
  • GPIO40 and 45 are used by analogue audio and support PWM. They connect to the analogue audio circuitry via R21 and R27 respectively.
  • GPIO46 is HDMI hotplug detect (goes to pin 6 of IC1).
  • GPIO47 to 53 are used by the SD card interface. In particular, GPIO47 is SD card detect (this would seem to be a good candidate for re-use). GPIO47 is connected to the SD card interface card detect switch; GPIO48 to 53 are connected to the SD card interface via resistors R45 to R50.


Internal Pull-Ups & Pull-Downs

The GPIO ports include the ability to enable and disable internal pull-up or pull-down resistors (see below for code examples/support of this):

  • Pull-up is 50 kOhm - 65 kOhm
  • Pull-down is 50 kOhm - 60 kOhm

Driver support

The Foundation will not include a GPIO driver in the initial release, standard Linux GPIO drivers should work with minimal modification.[19]

The community implemented SPI and I²C drivers [20], which will be integrated with the new Linux pinctrl concept in a later version of the kernel. (On Oct. 14 2012, it was already included in the latest raspbian image.) A first compiled version as Linux modules is available to install on the 19/04/2012 Debian image, including 1-wire support[21]. The I²C and SPI driver uses the hardware modules of the microcontroller and interrupts for low CPU usage, the 1-wire support uses bitbanging on the GPIO ports, which results in higher CPU usage.

GordonH[22] wrote a (mostly) Arduino compatible/style WiringPi library in C for controlling the GPIO pins.

A useful tutorial on setting up I²C driver support can be found at Robot Electronics - look for the downloadable document rpi_i2c_setup.doc

SPI

There are two SPI bus brought out to the header: RPi_SPI

I²C

There are two I²C-buses on the Raspberry Pi: One on P1, and one on P5.

Note that there's a bug concerning I²C-clock-stretching, so don't use I²C-devices which use clock-stretching directly with the Raspberry Pi, or use a workaround. Details about this bug can be found at:

MIPI CSI-2

On the production board[23], the Raspberry Pi Foundation design brings out the MIPI CSI-2 (Camera Serial Interface[24]) to a 15-way flat flex connector S5, between the Ethernet and HDMI connectors. A compatible camera[25] with 5 Megapixels and 1080p video resolution was released in May 2013.

DSI

On the production board, the Raspberry Pi Foundation design brings out the DSI (Display Serial Interface[26]) to a 15-way flat flex connector labelled S2, next to Raspberry Pi logo. It has two data lanes and a clock lane, to drive a possible future LCD screen device. Some smart phone screens use DSI[27].

CEC

HDMI-CEC (Consumer Electronics Control for HDMI) is supported by hardware but some driver work will be needed and currently isn't exposed into Linux userland. Eben notes that he has seen CEC demos on the Broadcom SoC they are using.

libCEC with Raspberry Pi support has been included in OpenELEC and will be included in Raspbmc RC4.[28]

For more information about HDMI-CEC and what you could do with it on the Raspberry Pi please see the CEC (Consumer Electronics Control) over HDMI article.

References

  1. raspberrypi.org
  2. raspberrypi.org
  3. http://www.raspberrypi.org/phpBB3/viewtopic.php?f=24&t=5894
  4. http://www.raspberrypi.org/phpBB3/viewtopic.php?f=24&t=5894
  5. raspi.tv
  6. raspberrypi.org
  7. raspberrypi.org
  8. raspberrypi.org
  9. http://www.raspberrypi.org/archives/384#comment-5217
  10. http://www.raspberrypi.org/wp-content/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
  11. http://www.raspberrypi.org/phpBB3/viewtopic.php?f=44&t=7509
  12. http://www.raspberrypi.org/downloads
  13. http://www.raspberrypi.org/forum/projects-and-collaboration-general/gpio-header-pinout-clarification/page-2
  14. http://www.raspberrypi.org/forum/features-and-requests/easy-gpio-hardware-software/page-6/#p56480
  15. http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.1
  16. Forum:Sad about removal of I2S. Why was this change made?
  17. http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1288.2
  18. http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1536#postid-21841
  19. http://www.raspberrypi.org/forum?mingleforumaction=viewtopic&t=1278.0
  20. http://www.bootc.net/projects/raspberry-pi-kernel/
  21. http://www.raspberrypi.org/phpBB3/viewtopic.php?p=86172#p86172
  22. http://www.raspberrypi.org/forum/general-discussion/wiring-for-the-raspberry-pis-gpio
  23. http://www.raspberrypi.org/wp-content/uploads/2012/04/Raspberry-Pi-Schematics-R1.0.pdf
  24. http://www.mipi.org/specifications/camera-interface
  25. http://elinux.org/Rpi_Camera_Module
  26. http://www.mipi.org/specifications/display-interface
  27. http://en.wikipedia.org/wiki/Display_Serial_Interface
  28. http://blog.pulse-eight.com/2012/08/01/libcec-1-8-0-a-firmware-upgrade-and-raspberry-pi-support/