villivateur/pinout.vvzero.com
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Tweak iface pages and index for #375

Browse Source
This commit is contained in:
Phil Howard 2020-09-03 21:43:03 +01:00
parent 1e05a85d94
commit 88862ba65c
8 changed files with 30 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
generate-html.py
View File

@ -65,7 +65,7 @@ default_strings = {
'boards_title': 'Raspberry Pi HATs, pHATs & Add-ons',
'boards_subtitle': 'Click on a HAT, pHAT or add-on for more details and to see which pins it uses!'
}
exclude_pincounts = ['3v3-power', '5v-power', 'ground', 'iface-jtag', 'i2c', 'iface-gpclk', 'wiringpi', 'spi']
exclude_pincounts = ['3v3-power', '5v-power', 'ground', 'iface-jtag', 'i2c', 'iface-gpclk', 'wiringpi', 'spi', 'iface-1wire']
def debug(level, string):

8
src/en/overlay/3v3-power.md
View File

@ -11,8 +11,10 @@ pin:
-->
# 3v3 Power
The 3v3 supply pin on the early Raspberry Pi had a maximum available current of about 50 mA. Enough to power a couple of LEDs or a microprocessor, but not much more.
All Raspberry Pi models since the B+ can provide up to 500mA on the 3v3 pins, thanks to a switching regulator. In some cases it may be possible to draw more but, due to lack of documentation and testing on the actual limits, 500mA is given as a rule of thumb.
All Raspberry Pi since the Model B+ can provide quite a bit more, up to 500mA to remain on the safe side, thanks to a switching regulator.
The 3v3 supply pin on the early Raspberry Pi had a maximum available current of only 50mA.
Still, you should generally use the 5v supply, coupled with a 3v3 regulator for 3.3v projects.
The 5v supply coupled with a 3v3 regulator is recommended for powering 3.3v projects.
The Piversify blog has [an exploration of the 3v3 supply rail on the Raspberry Pi B+](https://raspberrypise.tumblr.com/post/144555785379/exploring-the-33v-power-rail)

6
src/en/overlay/5v-power.md
View File

@ -11,8 +11,6 @@ pin:
-->
# 5v Power
The 5v power pins are connected directly to the Pi's power input and will capably provide the full current of your mains adaptor, less that used by the Pi itself.
The 5v power pins are connected directly to the Pi's power input and will capably provide the full supply current of your mains adaptor, minus that used by the Pi itself.
With a decent power supply, such as the official Pi adaptor, you can expect to pull about 1.5A.
Don't be dissuaded by what sounds like a measly low voltage. You can do a lot with 5v. Power Arduinos, and even run a small electroluminescent wire inverter right off the 5v pin!
With a decent power supply, such as the official Pi adaptor, you can expect to pull about 1.5A. This varies by Pi model and adapter used. Devices that require a high current- such as LED panels, long LED strips or motors- should use an external power supply.

12
src/en/overlay/i2c.md
View File

@ -24,14 +24,12 @@ pin:
active: high
-->
# I2C - Inter Integrated Circuit
---
### I2C pins in BCM mode are: 2, 3
### I2C pins in WiringPi are: 8, 9
---
The Raspberry Pi's I2C pins are an extremely useful way to talk to many different types of external peripheral; from the MCP23017 digital IO expander, to a connected ATMega.
GPIO 2 and GPIO 3 - the Raspberry Pi's I2C1 pins - allow for two-wire communication with a variety of external sensors and devices.
The I2C pins include a fixed 1.8 kΩ pull-up resistor to 3.3v. This means they are not suitable for use as general purpose IO where a pull-up is not required.
The I2C pins include a fixed 1.8 kΩ pull-up resistor to 3.3v. They are not suitable for use as general purpose IO where a pull-up might interfere.
I2C is a multi-drop bus, multiple devices can be connected to these same two pins. Each device has its own unique I2C address.
You can verify the address of connected I2C peripherals with a simple one-liner:
@ -49,3 +47,5 @@ DEVICE_ADDR = 0x15
bus = smbus.SMBus(DEVICE_BUS)
bus.write_byte_data(DEVICE_ADDR, 0x00, 0x01)
```
GPIO 0 and GPIO 1 - I2C0 - can be used as an alternate I2C bus, but are typically used by the system to read the HAT EEPROM.

10
src/en/overlay/iface-1wire.md
View File

@ -11,6 +11,10 @@ pin:
-->
# W1-GPIO - One-Wire Interface
One-wire is a single-wire communication bus typically used to connect sensors to the Pi.
The Raspberry Pi supports one-wire on any GPIO pin, but the default is GPIO 4.
To enable the one-wire interface you need to add the following line to /boot/config.txt, before rebooting your Pi:
```
@ -23,9 +27,9 @@ or
dtoverlay=w1-gpio,gpiopin=x
```
if you would like to use a custom pin (default is GPIO 4, as illustrated in pinout herein).
if you would like to use a custom pin (the default is GPIO 4)
Alternatively you can enable the one-wire interface on demand using raspi-config, or the following:
Alternatively you can enable the one-wire interface on demand using `raspi-config`, or the following:
```
sudo modprobe w1-gpio
@ -45,4 +49,4 @@ once any of the steps above have been performed, and discovery is complete you c
ls /sys/bus/w1/devices/
```
n.b. Using w1-gpio on the Raspberry Pi typically needs a 4.7 kΩ pull-up resistor connected between the GPIO pin and a 3.3v supply (e.g. header pin 1 or 17). Other means of connecting 1-Wire devices to the Raspberry Pi are also possible, such as using i2c to 1-Wire bridge chips.
Using w1-gpio on the Raspberry Pi typically needs a 4.7 kΩ pull-up resistor connected between the GPIO pin and a 3.3v supply (e.g. header pin 1 or 17). Other means of connecting 1-Wire devices to the Raspberry Pi are also possible, such as using i2c to 1-Wire bridge chips.

6
src/en/template/footer.html
View File

@ -1,3 +1,3 @@
<p>Spotted an error, want to add your board's pinout? Head on over to our <a href="https://github.com/gadgetoid/Pinout.xyz">GitHub repository</a> and submit an Issue or a Pull Request!</p>
<p>Originally part of <a href="http://pi.gadgetoid.com">pi.gadgetoid.com</a>. Tweet us at <a href="https://twitter.com/pipinout"> @PiPinout</a>. Maintained by <a href="https://twitter.com/gadgetoid">@Gadgetoid</a> and <a href="https://twitter.com/roguehal13">@RogueHAL13</a>.</p>
<p>Want to help make Pinout.xyz better? Please support us at <a href="https://github.com/sponsors/Gadgetoid">GitHub</a> or <a href="https://www.patreon.com/gadgetoid">Patreon.com</a></p>
<p>Spotted an error, want to add your board's pinout? <a href="https://github.com/gadgetoid/Pinout.xyz">Contribute to Pinouyt.xyz at GitHub.com/gadgetoid/Pinout.xyz</a></p>
<p>Originally part of <a href="http://pi.gadgetoid.com">pi.gadgetoid.com</a>. Maintained by <a href="https://twitter.com/gadgetoid">@Gadgetoid</a>.</p>
<p>Want to help make Pinout.xyz better? Please <a href="https://github.com/sponsors/Gadgetoid">sponsor at GitHub</a> or <a href="https://www.patreon.com/gadgetoid">pledge at Patreon.com</a></p>

8
src/en/template/index.md
View File

@ -1,8 +1,8 @@
# Pinout!
### The comprehensive GPIO Pinout guide for the Raspberry Pi.
### The Raspberry Pi GPIO pinout guide.
This GPIO Pinout is designed to be both a quick and interactive reference to the Raspberry Pi GPIO pins, plus a comprehensive guide to your Raspberry Pi's GPIO interfaces. It also includes [dozens of pinouts for Raspberry Pi add-on boards, HATs and pHATs](/boards).
This GPIO Pinout is an interactive reference to the Raspberry Pi GPIO pins, and a guide to the Raspberry Pi's GPIO interfaces. Pinout also includes [dozens of pinouts for Raspberry Pi add-on boards, HATs and pHATs](/boards).
## Support Pinout.xyz
@ -19,7 +19,7 @@ Pinout has teamed up with Pimoroni to create a [prototype board compatibility to
## Explore HATs & pHATs
We've [added a board explorer](/boards)! Use it to find the pinout for a Raspberry Pi add-on board, or discover new ones. If you manufacture boards, we'd love to add yours too. [You can contribute over on GitHub](https://github.com/gadgetoid/Pinout.xyz).
[Check out Pinout's board explorer](/boards)! Use it to find the pinout for your Raspberry Pi add-on board, or discover new boards. If you manufacture boards, we'd love to add yours too. [You can contribute to Pinout.xyz at GitHub.com](https://github.com/gadgetoid/Pinout.xyz).
## What do these numbers mean?
@ -36,4 +36,4 @@ Pinout depicts pin 1 in the top left corner. Pin 1 is the only pin with a square
We've whipped up a simple graphical Raspberry Pi GPIO Pinout. Feel free to print, embed, share or hotlink this image and don't forget to credit us!
[![Graphical Raspberry Pi GPIO Pinout](/resources/raspberry-pi-pinout.png)](/resources/raspberry-pi-pinout.png)
![Graphical Raspberry Pi GPIO Pinout](https://raw.githubusercontent.com/Gadgetoid/Pinout.xyz/master/resources/raspberry-pi-pinout.png)

4
src/en/template/localised.yaml
View File

@ -1,5 +1,5 @@
strings:
- default_desc: 'The comprehensive Add-on boards & GPIO Pinout guide for the Raspberry Pi'
- default_desc: 'The comprehensive add-on boards & GPIO Pinout guide for the Raspberry Pi'
- default_title: 'Raspberry Pi GPIO Pinout'
- title_suffix: ' at Raspberry Pi GPIO Pinout'
- home: 'Home'
@ -27,7 +27,7 @@ strings:
- github_repository: 'GitHub Repository'
- board_schematic : 'Schematic'
- buy_now: 'Buy Now'
- browse_addons: 'Browse more HATs, pHATs and add-ons'
- browse_addons: 'Browse pinouts for HATs, pHATs and add-ons'
- return_home: 'Return to the Raspberry Pi GPIO Pinout'
- boards_title: 'Raspberry Pi HATs, pHATs &amp; Add-ons'
- boards_subtitle: 'Click on a HAT, pHAT or add-on for more details and to see which pins it uses!'