Difference between revisions of "WiringNP: NanoPi NEO/NEO2/Air GPIO Programming with C/zh"

Revision as of 05:28, 16 May 2017

English

1 WiringPi简介

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

2 WiringNP简介

wiringPi库最初是为BCM2835芯片编写的，后被移植到Allwinner平台，针对NanoPi的wiringPi衍生版本其项目命名为WiringNP，目前支持NanoPi M1、NanoPi NEO和NanoPi NEO2开发板, 最初版本是由网友wertyzp提供的版本，而针对NEO2的H5版本由FriendlyELEC提供支持。

WiringNP项目主页: https://github.com/friendlyarm/WiringNP

3 WiringNP在H3平台上的安装 (NanoPi NEO/NanoPi M1)

通过ssh，或者串口终端进入开发板的命令行，从 github 上下载WiringNP代码并编译安装:

git clone https://github.com/friendlyarm/WiringNP
cd WiringNP/
chmod 755 build
./build

4 WiringNP在H5平台上的安装 (NanoPi NEO2)

通过ssh，或者串口终端进入开发板的命令行，从 github 上下载WiringNP代码并编译安装:

git clone https://github.com/friendlyarm/WiringNP
cd WiringNP/
git checkout h5
chmod 755 build
./build

4.1 测试安装

WiringNP包括一套gpio命令，使用gpio命令可以控制NanoPi上的各种接口，通过以下指令可以测试WiringNP是否安装成功:

gpio readall

如果安装成功会显示NanoPI的IO图，例如NanoPI NEO2会显示如下信息：

root@FriendlyARM:~# gpio readall
 +-----+-----+----------+------+---+-NanoPi NEO2--+------+----------+-----+-----+
 | BCM | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | BCM |
 +-----+-----+----------+------+---+----++----+---+------+----------+-----+-----+
 |     |     |     3.3V |      |   |  1 || 2  |   |      | 5V       |     |     |
 |  12 |   8 |  GPIOA12 | ALT5 | 0 |  3 || 4  |   |      | 5V       |     |     |
 |  11 |   9 |  GPIOA11 | ALT5 | 0 |  5 || 6  |   |      | 0v       |     |     |
 | 203 |   7 |  GPIOG11 |  OFF | 0 |  7 || 8  | 0 | ALT5 | GPIOG6   | 15  | 198 |
 |     |     |       0v |      |   |  9 || 10 | 0 | ALT5 | GPIOG7   | 16  | 199 |
 |   0 |   0 |   GPIOA0 |  OFF | 0 | 11 || 12 | 0 | OFF  | GPIOA6   | 1   | 6   |
 |   2 |   2 |   GPIOA2 |  OFF | 0 | 13 || 14 |   |      | 0v       |     |     |
 |   3 |   3 |   GPIOA3 |  OFF | 0 | 15 || 16 | 0 | OFF  | GPIOG8   | 4   | 200 |
 |     |     |     3.3v |      |   | 17 || 18 | 0 | OFF  | GPIOG9   | 5   | 201 |
 |  64 |  12 |   GPIOC0 | ALT4 | 0 | 19 || 20 |   |      | 0v       |     |     |
 |  65 |  13 |   GPIOC1 | ALT4 | 0 | 21 || 22 | 0 | OFF  | GPIOA1   | 6   | 1   |
 |  66 |  14 |   GPIOC2 | ALT4 | 0 | 23 || 24 | 0 | ALT4 | GPIOC3   | 10  | 67  |
 +-----+-----+----------+------+---+----++----+---+------+----------+-----+-----+
 | BCM | wPi |   Name   | Mode | V | Physical | V | Mode | Name     | wPi | BCM |
 +-----+-----+----------+------+---+-NanoPi NEO2--+------+----------+-----+-----+
 
 +-----+----NanoPi NEO2 Debug UART-+----+
 | BCM | wPi |   Name   | Mode | V | Ph |
 +-----+-----+----------+------+---+----+
 |   4 |  17 |   GPIOA4 | ALT5 | 0 | 37 |
 |   5 |  18 |   GPIOA5 | ALT5 | 0 | 38 |
 +-----+-----+----------+------+---+----+

5 NanoPi M1的GPIO在WiringNP上编码方式

在上一章节gpio readall命令得到的列表中，Physical这一列显示的NanoPI M1的物量引脚编号，从1~40，
而 wPi 这一列代表的是 WiringNP 操作这个引脚时需要使用的编号，这种编号方式非常方便编程，下图是NanoPi M1的所有引脚编码：

6 WiringNP示例

将一个Matrix - LED通过连接至NanoPi M1，像下图这样：

其中，引脚的连接对应如下：

接下来我们用WiringNP实现一个LED闪烁的例子,
首先通过命令gpio readall可以看到物理引脚Pin7所对应的wPi编号是7，所以接下来在代码中使用数字7就可以操作这个引脚。

6.1 C语言示例

创建一个C源文件：

vi test.c

然后键入如下代码:

#include <wiringPi.h>
int main(void)
{
  wiringPiSetup() ;
  pinMode (7, OUTPUT) ;
  for(;;)
  {
    digitalWrite(7, HIGH) ;
    delay (500) ;
    digitalWrite(7,  LOW) ;
    delay (500) ;
  }
}

编译test.c并运行：

gcc -Wall -o test test.c -lwiringPi -lpthread
./test

看到LED灯一闪一闪的，就表示成功了。

6.2 Shell示例

创建一个shell脚本：

vi test.sh

然后键入如下代码:

LED=7
gpio mode $LED out
while true; do
  gpio write $LED 1
  sleep 0.5
  gpio write $LED 0
  sleep 0.5
done

运行脚本：

source test.sh

会看到LED闪烁了。

7 WiringNP 常用API速查

7.1 初始化函数

7.1.1 wiringPiSetup (void)

该函数初始化wiringPi，并假定程序将使用wiringPi的管脚定义图。具体管脚映射，可以通过gpio readall命令来查看。
该函数需要root权限。

7.1.2 int wiringPiSetupGpio(void)

该函数和wiringPiSetup函数类似，区别在于假定程序使用的是CPU的GPIO管脚定义，而没有重新映射。
该函数需要root权限。

7.1.3 int wiringPiSetupPhys (void)

该函数和wiringPiSetup函数类似，区别在于不允许程序使用物理管脚定义，仅支持P1接口。
该函数需要root权限。

7.1.4 int wiringPiSetupSys (void)

该函数初始化wiringPi，使用/sys/class/gpio接口，而不是直接通过操作硬件来实现。
该函数可以使用非root权限用户，在此种模式下的管脚号是CPU的GPIO管脚号，和wiringPiSetupGpio函数类似。
在此种模式下，在运行程序前，您需要通过/sys/class/gpio接口导出要使用的管脚。
你可以在一个独立的shell脚本中来导出将要使用的管脚，或者使用系统的system()函数来调用GPIO命令。

7.2 核心函数

7.2.1 void pinMode (int pin, int mode)

使用该函数可以将某个引脚配置为INPUT(输入) OUTPUT（输出）PWM_OUTPUT（脉冲输出）或者GPIO_CLOCK（时钟）。
在Sys模式下，这个函数没有影响。
你可以通过调用GPIO命令在shell脚本中来设置管脚的模式。

7.2.2 void pullUpDnControl (int pin, int pud)

使用该函数可以设置指定管脚使用上拉或者下拉电阻模式，通常当需要管脚作为输入引脚时，需要设定此项。
不同于Arduino，CPU有内部上拉和下拉电阻这两种模式。
参数pud可以为PUD_OFF（无上拉或下拉电阻）、PUD_DOWN（内部下拉至地线）或者PUD_UP（内部上拉至3.3V）。
在NanoPi M1上，内部上拉和下拉电阻有接近100KΩ。
该函数在Sys模式下无作用。
如果你需要激活上拉或下拉电阻的话，在启动程序前，可以通过在脚本中调用GPIO命令来实现。

7.2.3 void digitalWrite (int pin, int value)

使用该函数可以向指定的管脚写入HIGH（高）或者LOW（低），写入前，需要将管脚设置为输出模式。
wiringPi将任何的非0值作为HIGH（高）来对待，因此，0是唯一能够代表LOW（低）的数值。

7.2.4 void pwmWrite (int pin, int value)

使用该函数可以将值写入指定管脚的PWM寄存器中，可设置的值为0~1024，其他PWM讴备可能有不同的PWM范围。
当在Sys模式时，该函数不可用来控制板上PWM。

7.2.5 digitalRead(int pin);

使用该函数可以读取指定管脚的值，读取到的值为HIGH（1）或者LOW（0），该值取决于该管脚的逻辑电平的高低。

7.2.6 analogRead (int pin) ;

该函数返回所指定的模拟输入管脚的值。你需要添加额外的模拟模块来使用该函数，比如Gertboard，quick2Wire模拟板等。

7.2.7 analogWrite (int pin, int value) ;

该函数将指定的值写入到指定的管脚。你需要添加额外的模拟模块来使用该函数，比如Gertboard等。