一、WiringPi

**简介**

WiringPi是应用于树莓派平台的GPIO控制库函数，WiringPi遵守GUN Lv3。wiringPi使用C或者C++开发并且可以被其他语言包转，例如python、ruby或者PHP等。WiringPi中的函数类似于Arduino的wiring系统，这使得熟悉arduino的用户使用wringPi更为方便。

树莓派具有26个普通IO引脚，利用端口复用时支持I2C、SPI和UART通信协议。不使用复用时也可以作为普通端口使用。wiringPi包括一套gpio控制命令，使用gpio命令时可以控制树莓派GPIO管脚。用户可以利用gpio命令通过shell脚本控制或查询GPIO管脚。wiringPi是可以扩展的，用户可以利用wiringPi的内部模块或把自定义的扩展模块集成到wiringPi中以扩展更多的GPIO接口或支持更多的功能。

摘自：

https://blog.csdn.net/qintaiwu/article/details/73741722

二、安装

sudo apt-get install git
git clone https://github.com/WiringPi/WiringPi
cd wiringPi
git pull
./build

测试：检测GPIO口

gpio -v

三、常用gpio命令

gpio readall
gpio -g mode 20 out
gpio -g mode 21 in
gpio -g write 20 1 && gpio -g write 21 1 && gpio -g write 16 1
gpio -g read 20

四、 python wiringpi 环境安装

*如果python版本默认是2.0，可以先改一下版本：（现在新版本树莓派一般带python2.7和python3两个版本，可以直接使用python3）*

sudo apt-get install python3 # 如果没有安装3，先安装
sudo rm /usr/bin/python # 删除旧连接
sudo ln -s /usr/bin/python3.5 /usr/bin/python

安装wiringpi

sudo apt-get install python3-pip
pip install wiringpi
pip list | grep wiring \t\t# 检查安装

命令行设置引脚：

gpio -g mode 17 out
gpio -g write 17 0 //设置为低电平

五、WiringPi GPIO 和 BCM2835 GPIO映射关系

命令行设置示例：

gpio readdall
gpio -g mode 17 out
gpio -g write 17 0 //设置为低电平

五、使用

一般分为4步骤：

上面的代码非常简单，可以分为四个部分——wiringPiSetupi初始化、pinMode设置IO为输出方向、digitalWrite输出高电平或低电平和delay系统延时函数。

六、C 部分示例

wiringPiSetup(); //初始化
 
int i = 0;
// 设置IO口全部为输出状态
for( i = 0 ; i < 8 ; i++ )
 pinMode(i, OUTPUT);
 
 for (;;)
 {
 for( i = 0 ; i < 8 ; i++ )
 {
 // 点亮500ms 熄灭500ms
 // 输出
 digitalWrite(i, HIGH); delay(500);
 digitalWrite(i, LOW); delay(500);
 }
 }
// 读取引脚状态
\tdigitalRead(BtnPin); //1 输入高电平 0 输入低电平

六、Python 部分示例

import wiringpi \t#老版本是导入wiringpi2，新版本改为wiringpi
wiringpi.wiringPiSetup() \t\t\t\t\t#设置GPIO编号为wPi方式
wiringpi.wiringPiSetupSys() \t\t\t#设置GPIO编号为BCM方式
wiringpi.wiringPiSetupGpio() \t\t\t#设置GPIO编号为BCM方式
wiringpi.pinMode(6,1) \t\t\t\t\t\t#设置pin6为输出
wiringpi.digitalWrite(6,1) \t\t\t\t\t#pin6电平置为高
wiringpi.digitalRead(6) \t\t\t\t\t#读取pin6的电平

七、常用函数

### 初始化函数

### 通用GPIO工作模式

#### 1.void pinMode (int pin, int mode) ;

这个函数式设置pin脚的输入和输出模式以及PWM的输入和输出模式。在wiringPi中只有 pin 1 (BCM_GPIO 18)是支持PWM的输出的。

#### 2.void digitalWrite (int pin, int value) ;

这个函数式用来设置pin脚的高低电平的，当我们写HIGH or LOW (1 or 0)的时候pin脚的mode必须为输出模式。

#### 3.void digitalWriteByte (int value) ;

这个函数可以将8位字节写给8个GPIO pin脚，这是设置8个pin脚值的最快的方式。

#### 4.void pwmWrite (int pin, int value) ;

写入的值必须是0-1024。输出一个值到PWM寄存器，控制PWM输出。pin只能是wiringPi 引脚编号下的1脚（BCM下的18脚）

#### 5.int digitalRead (int pin) ;

这个函数是读取GPIO的pin脚的电平高低然后返回读取的值。

#### 6.void pullUpDnControl (int pin, int pud) ;

这个函数是设置GPIO的pin脚是否接上拉电阻和下拉电阻的。函数的参数pud必须设置，当设置为PUD_OFF时表示没有上拉电阻和下拉电阻，当设置为PUD_DOWN 时为下拉电阻，设置为PUD_UP是为上拉电阻。

#### 7. void analogWrite(int pin, int value)

pin:引脚

value：输出的模拟量

模拟量输出 树莓派的引脚本身是不支持AD转换的，也就是不能使用模拟量的API，

需要增加另外的模块

#### 8. int analogRead (int pin)

pin：引脚

返回：引脚上读取的模拟量

模拟量输入 树莓派的引脚本身是不支持AD转换的，也就是不能使用模拟量的API，需要增加另外的模块

### PWM的控制：

#### 1.pwmSetMode (int mode) ;

这个函数是设置PWM的占空比模式一般为50%占空比和占空比可调模式。树莓派默认是50%占空比模式，我们可以通过PWM_MODE_BAL 和PWM_MODE_MS这两个参数来设置。

#### 2.pwmSetRange (unsigned int range) ;

这个函数是设置PWM寄存器写入的范围，一般默认为1024.

#### 3.pwmSetClock (int divisor) ;

这个函数的设置PWM时钟的分频因子。

### 时间控制函数：

#### 1.void delay (unsigned int howLong)

这个是毫秒级的延时函数。

#### 2.void delayMicroseconds (unsigned int howLong)

微秒级的延时函数

#### 3. unsigned int millis (void)

这个函数返回 一个 从你的程序执行 wiringPiSetup 初始化函数（或者wiringPiSetupGpio ） 到 当前时间 经过的 毫秒数。

返回类型是unsigned int，最大可记录 大约49天的毫秒时长。

#### 4. unsigned int micros (void)

这个函数返回 一个 从你的程序执行 wiringPiSetup 初始化函数（或者wiringPiSetupGpio ） 到 当前时间 经过的 微秒数。

返回类型是unsigned int，最大可记录 大约71分钟的时长。

### 关于中断的函数：

#### 1.int waitForInterrupt (int pin, int timeOut) ;

这一个等待事件中断函数，timeout参数是毫秒级别的参数，当为-1时代表永远等待中断状态。如果发生错误返回值是-1,0表示超时，1表示成功中断。调用这个函数之前我们需要对GPIO进行初始化。

例如我们要设置GPIO 0为等待下降沿中断：

我们需要在运行程序之前先终端运行 gpio edge 0 falling

#### 2.int wiringPiISR (int pin, int edgeType, void (*function)(void)) ;

这个函数是利用一个函数作为参数来获取在特定的GPIO pin脚的中断。edge_Type参数可以设定为 INT_EDGE_FALLING, INT_EDGE_RISING, INT_EDGE_BOTH or INT_EDGE_SETUP.

当中断发生的时候function将被调用，调用function之前会先清除相应的标志位，这就使得随后的中断不会被影响。