View source for WiringNP: NanoPi NEO/NEO2/Air GPIO Programming with C/zh

==WiringPi简介==
wiringPi库最早是由Gordon Henderson所编写并维护的一个用C语言写成的类库，除了GPIO库，还包括了I2C库、SPI库、UART库和软件PWM库等，由于wiringPi的API函数和arduino非常相似，这也使得它广受欢迎。<br />
wiringPi库除了提供wiringPi类库及其头文件外，还提供了一个命令行工具gpio：可以用来设置和读写GPIO管脚，以方便在Shell脚本中控制GPIO管脚。<br />

==WiringNP简介==
wiringPi库最初是为BCM2835芯片编写的，后被爱好者移植到Allwinner H3平台，针对NanoPi的wiringPi衍生版本其项目命名为WiringNP，目前支持[[NanoPi M1]]和[[NanoPi NEO]]开发板, 最初版本是由[https://github.com/wertyzp 网友wertyzp]提供的版本。<br />
<br />
WiringNP项目主页: https://github.com/friendlyarm/WiringNP<br />

==WiringNP的安装==
通过ssh，或者串口终端进入开发板的命令行，从 github 上下载WiringNP代码并编译安装: <br />
<syntaxhighlight lang="bash">
git clone https://github.com/friendlyarm/WiringNP
cd WiringNP/
chmod 755 build
./build
</syntaxhighlight>

==== 测试安装 ====
WiringNP包括一套gpio命令，使用gpio命令可以控制NanoPi上的各种接口，通过以下指令可以测试WiringNP是否安装成功:
<syntaxhighlight lang="bash">
gpio readall
</syntaxhighlight>
如果安装成功会显示NanoPI的IO图，例如NanoPI M1会显示如下信息：
<syntaxhighlight lang="bash">
root@FriendlyARM:~# gpio readall
 +-----+-----+----------+------+---+-NanoPI M1+---+------+----------+-----+-----+
 | BCM | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | BCM |
 +-----+-----+----------+------+---+----++----+---+------+----------+-----+-----+
 |     |     |     3.3v |      |   |  1 || 2  |   |      | 5v       |     |     |
 |  12 |   8 |    SDA.0 | ALT5 | 0 |  3 || 4  |   |      | 5V       |     |     |
 |  11 |   9 |    SCL.0 | ALT5 | 0 |  5 || 6  |   |      | 0v       |     |     |
 | 203 |   7 |   GPIO.7 |  OUT | 0 |  7 || 8  | 0 | ALT5 | TxD3     | 15  | 198 |
 |     |     |       0v |      |   |  9 || 10 | 0 | ALT5 | RxD3     | 16  | 199 |
 |   0 |   0 |     RxD2 | ALT5 | 0 | 11 || 12 | 0 | OFF  | GPIO.1   | 1   | 6   |
 |   2 |   2 |     TxD2 |  OFF | 0 | 13 || 14 |   |      | 0v       |     |     |
 |   3 |   3 |     CTS2 |  OFF | 0 | 15 || 16 | 0 | OFF  | GPIO.4   | 4   | 200 |
 |     |     |     3.3v |      |   | 17 || 18 | 0 | OFF  | GPIO.5   | 5   | 201 |
 |  64 |  12 |     MOSI | ALT4 | 0 | 19 || 20 |   |      | 0v       |     |     |
 |  65 |  13 |     MISO | ALT4 | 0 | 21 || 22 | 0 | ALT5 | RTS2     | 6   | 1   |
 |  66 |  14 |     SCLK | ALT4 | 0 | 23 || 24 | 0 | ALT4 | CE0      | 10  | 67  |
 |     |     |       0v |      |   | 25 || 26 | 0 | OFF  | GPIO.11  | 11  | 17  |
 |  19 |  30 |    SDA.1 | ALT4 | 0 | 27 || 28 | 0 | ALT4 | SCL.1    | 31  | 18  |
 |  20 |  21 |  GPIO.21 |  OFF | 0 | 29 || 30 |   |      | 0v       |     |     |
 |  21 |  22 |  GPIO.22 |  OFF | 0 | 31 || 32 | 0 | OFF  | RTS1     | 26  | 7   |
 |   8 |  23 |  GPIO.23 |  OFF | 0 | 33 || 34 |   |      | 0v       |     |     |
 |  16 |  24 |  GPIO.24 | ALT4 | 0 | 35 || 36 | 0 | OFF  | CTS1     | 27  | 13  |
 |   9 |  25 |  GPIO.25 |  OFF | 0 | 37 || 38 | 0 | OFF  | TxD1     | 28  | 15  |
 |     |     |       0v |      |   | 39 || 40 | 0 | ALT4 | RxD1     | 29  | 14  |
 +-----+-----+----------+------+---+----++----+---+------+----------+-----+-----+
 | BCM | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | BCM |
 +-----+-----+----------+------+---+-NanoPI M1+---+------+----------+-----+-----+

 +-----+----NanoPI M1 Debug UART---+----+
 | BCM | wPi |   Name   | Mode | V | Ph |
 +-----+-----+----------+------+---+----+
 |     |     |       0v |      |   | 41 |
 |     |     |       5v |      |   | 42 |
 |   4 |  32 |   GPIO.4 | ALT5 | 0 | 43 |
 |   5 |  33 |   GPIO.5 | ALT5 | 0 | 44 |
 +-----+-----+----------+------+---+----+
</syntaxhighlight>

在这个表中，Physical这一列显示的NanoPI M1的物量引脚编号，从1~40，<br />
而 wPi 这一列代表的是 WiringNP 操作这个引脚时需要使用的编号，这种编号方式非常方便编程：<br />
[[File:WiringNP-GPIO-ALL.jpg|frameless|500px]]

==WiringNP示例==
将一个[[Matrix - LED]]通过连接至NanoPi M1，像下图这样：<br>
[[File:Matrix-LED_nanopi_m1.jpg|frameless|300px|Matrix-LED_nanopi_m1]]

其中，引脚的连接对应如下：
{| class="wikitable"
|-
|Matrix-LED || NanoPi M1
|-
|S    || Pin7
|-
|V    || Pin4
|- 
|G    || Pin6
|}

接下来我们用WiringNP实现一个LED闪烁的例子, <br />
首先通过命令gpio readall可以看一下物理引脚Pin7所对应的wPi编号是多少：
<syntaxhighlight lang="bash">
gpio readall
</syntaxhighlight>
结果物理引脚Pin7对应的wPi编号也是7，所以接下来在代码中使用数字7就可以操作这个引脚了:<br />
[[File:WiringNPPin7.jpg|frameless|500px|WiringNPPin7]]

创建一个C源文件：
<syntaxhighlight lang="bash">
vi test.c
</syntaxhighlight>
然后键入如下代码:
<syntaxhighlight lang="c">
#include <wiringPi.h>
int main(void)
{
  wiringPiSetup() ;
  pinMode (7, OUTPUT) ;
  for(;;)
  {
    digitalWrite(7, HIGH) ;
    delay (500) ;
    digitalWrite(7,  LOW) ;
    delay (500) ;
  }
}
</syntaxhighlight>
编译test.c并运行：
<syntaxhighlight lang="bash">
gcc -Wall -o test test.c -lwiringPi -lpthread
./test 
</syntaxhighlight>
看到LED灯一闪一闪的，就表示成功了。