# WiringPi

**Repository Path**: blue-net-vision/WiringPi

## Basic Information

- **Project Name**: WiringPi
- **Description**: 树莓派的gpio源代码，使用手动编译进行安装
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-04
- **Last Updated**: 2024-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WiringPi

WiringPi是一个用于树莓派板的高性能GPIO访问库，使用C语言编写。

:warning:️ :construction: 在树莓派5上，PWM支持目前正在开发中，目前无法正常工作。如果您对进展感兴趣，请查看[相关问题](https://github.com/GrazerComputerClub/WiringPi/issues/21)。

要使用wiringPi编译程序，您需要包含`wiringPi.h`头文件，并链接`wiringPi`库：

```c
#include <wiringPi.h> // Include WiringPi library!

int main(void)
{
  // uses BCM numbering of the GPIOs and directly accesses the GPIO registers.
  wiringPiSetupGpio();

  // pin mode ..(INPUT, OUTPUT, PWM_OUTPUT, GPIO_CLOCK)
  // set pin 17 to input
  pinMode(17, INPUT);

  // pull up/down mode (PUD_OFF, PUD_UP, PUD_DOWN) => down
  pullUpDnControl(17, PUD_DOWN);

  // get state of pin 17
  int value = digitalRead(17);

  if (HIGH == value)
  {
    // your code
  }
}
```

要编译这段代码，链接到wiiringpi:

```sh
gcc -o myapp myapp.c -l wiringPi
```

Be sure to check out the [examples](./examples/), build them using Make:

```sh
cd examples
make <example-name | really-all>
```

工具`gpio`可以用于设置单个引脚以及一次获取所有引脚的状态：

```
pi@wiringdemo:~ $ gpio readall
 +-----+-----+---------+------+---+---Pi 3B--+---+------+---------+-----+-----+
 | BCM | wPi |   Name  | Mode | V | Physical | V | Mode | Name    | wPi | BCM |
 +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
 |     |     |    3.3v |      |   |  1 || 2  |   |      | 5v      |     |     |
 |   2 |   8 |   SDA.1 |   IN | 1 |  3 || 4  |   |      | 5v      |     |     |
 |   3 |   9 |   SCL.1 |   IN | 1 |  5 || 6  |   |      | 0v      |     |     |
 |   4 |   7 | GPIO. 7 |   IN | 0 |  7 || 8  | 0 | IN   | TxD     | 15  | 14  |
 |     |     |      0v |      |   |  9 || 10 | 1 | IN   | RxD     | 16  | 15  |
 |  17 |   0 | GPIO. 0 |   IN | 1 | 11 || 12 | 1 | IN   | GPIO. 1 | 1   | 18  |
 |  27 |   2 | GPIO. 2 |   IN | 1 | 13 || 14 |   |      | 0v      |     |     |
 |  22 |   3 | GPIO. 3 |   IN | 1 | 15 || 16 | 0 | IN   | GPIO. 4 | 4   | 23  |
 |     |     |    3.3v |      |   | 17 || 18 | 1 | IN   | GPIO. 5 | 5   | 24  |
 |  10 |  12 |    MOSI |   IN | 0 | 19 || 20 |   |      | 0v      |     |     |
 |   9 |  13 |    MISO |   IN | 0 | 21 || 22 | 1 | IN   | GPIO. 6 | 6   | 25  |
 |  11 |  14 |    SCLK |   IN | 0 | 23 || 24 | 1 | IN   | CE0     | 10  | 8   |
 |     |     |      0v |      |   | 25 || 26 | 0 | IN   | CE1     | 11  | 7   |
 |   0 |  30 |   SDA.0 |   IN | 1 | 27 || 28 | 1 | IN   | SCL.0   | 31  | 1   |
 |   5 |  21 | GPIO.21 |   IN | 0 | 29 || 30 |   |      | 0v      |     |     |
 |   6 |  22 | GPIO.22 |   IN | 0 | 31 || 32 | 1 | IN   | GPIO.26 | 26  | 12  |
 |  13 |  23 | GPIO.23 |   IN | 1 | 33 || 34 |   |      | 0v      |     |     |
 |  19 |  24 | GPIO.24 |   IN | 1 | 35 || 36 | 1 | IN   | GPIO.27 | 27  | 16  |
 |  26 |  25 | GPIO.25 |   IN | 1 | 37 || 38 | 1 | IN   | GPIO.28 | 28  | 20  |
 |     |     |      0v |      |   | 39 || 40 | 1 | IN   | GPIO.29 | 29  | 21  |
 +-----+-----+---------+------+---+----++----+---+------+---------+-----+-----+
 | BCM | wPi |   Name  | Mode | V | Physical | V | Mode | Name    | wPi | BCM |
 +-----+-----+---------+------+---+---Pi 3B--+---+------+---------+-----+-----+
```


## 安装

您可以自己构建它，也可以使用预构建的二进制文件:

### 从源代码构建

1. 创建软件包

```sh
# 获取源代码
sudo apt install git
git clone https://gitee.com/blue-net-vision/WiringPi.git
cd WiringPi

# 构建软件包
./build
```


### 预建二进制文件

从[这里](https://github.com/WiringPi/WiringPi/releases)获取最新版本的发布版。

解压缩/使用便携式预构建版本：

```sh
# 解压缩压缩包
tar -xfv wiringpi_3.0.tar.gz
```

安装Debian软件包:

```sh
# 安装dpkg
sudo apt install ./wiringpi-3.0-1.deb
```


## 端口

wiringPi已经为多种语言进行了封装：

* Node - https://github.com/WiringPi/WiringPi-Node
* Perl - https://github.com/WiringPi/WiringPi-Perl
* PHP - https://github.com/WiringPi/WiringPi-PHP
* Python - https://github.com/WiringPi/WiringPi-Python
* Ruby - https://github.com/WiringPi/WiringPi-Ruby

## 支持

请使用GitHub的[问题系统](https://github.com/WiringPi/WiringPi/issues)。

如果您不确定是否要创建问题，请参与[讨论](https://github.com/WiringPi/WiringPi/discussions)！

请不要给Gordon或@Gadgetoid发送电子邮件。

请不要给GC2发送电子邮件报告问题，您可以[联系我们](mailto:wiringpi@gc2.at)获取非公开信息。

## 历史

这个存储库是'Gordon's wiringPi'的继续，该存储库已经[被弃用](https://web.archive.org/web/20220405225008/http://wiringpi.com/wiringpi-deprecated/)了一段时间。

* Gordon发布的最后一个“旧wiringPi”源代码可以在[`final_source_2.50`](https://github.com/WiringPi/WiringPi/tree/final_official_2.50)标签中找到。
* 默认的`master`分支包含自版本2.5以来编写的代码，以提供对新硬件的支持以及新功能。

:information_source:️ 自2024年起，[GC2](https://github.com/GrazerComputerClub)接管了该项目的维护工作，支持新的操作系统版本和当前的硬件。我们致力于使树莓派上性能最佳的GPIO库保持正常运行。我们会尽力而为，但请注意这是一个社区努力，我们无法提供任何保证或对您可能需要的特定功能的实现负责。

## 调试

WIRINGPI_DEBUG=1 ./my_wiringpi_program

WIRINGPI_DEBUG=1 gpio readall