|
|
本帖最后由 xiansen_shun 于 2016-6-15 11:42 编辑
一，写在首页：
由于我的英语水平不是很好，在记录这些函数的时候可能和官方的意思有出入，请参考WiringPi.com
关于WiringPi的安装方法，我在这里不在讲述，不清楚的可以参考
http://www.arduino.cn/thread-21188-1-1.html
二、wiringpi简介
wiringPi库是由Gordon Henderson所编写幵维护的一个用C语言写成的类库。起初，主要是作为BCM2835芯片的GPIO库。而现在，已经非常丰富，除了GPIO库，还包括了I2C库、SPI库、UART库和软件PWM库等。
由于其不Arduino的“wiring”系统较为类似，故以此命名。它是采用GNU LGPLv3讲可证的，可以在C或C++上使用，而在其他编程语言上也有对应的扩展。
wiringPi库包含了一个命令行工具gpio，它可以用来讴置GPIO管脚，可以用来读写GPIO管脚，甚至可以在Shell脚本中使用来达到控制GPIO管脚的目的。
三，wiringpi设置函数
有如下函数对wiringpi进行初始化，函数如下。
[mw_shl_code=cpp,true]
int wiringPiSetup (void) ;
int wiringPiSetupGpio (void) ;
int wiringPiSetupPhys (void) ;
int wiringPiSetupSys (void) ;
[/mw_shl_code]
在程序的开始的时候需要调用上面的任意的函数来对wiringpi 进行初始化，否则你的程序不能正常工作。
在wiringPi的v1版本中，如果无讳何种原因，返些函数执行失败，将会迒回一个错误代码。v2版本中，一直会迒回0。再和讲多wiringPi的用户迕行讨讳后，很多人幵丌在意检查迒回值，如果返些讴置函数迒回失败，那么就应该停止程序的执行。
如果您想使用v1版本，您需要设置一个环境变量，其名为WIRINGPI_CODES。它的值可以是任何值，叧要返个环境变量存在即可。
3.1 wiringPiSetup (void) 函数
[mw_shl_code=cpp,true] int wiringPiSetup (void) ;[/mw_shl_code]
该函数初始化wiringPi，幵假定程序将使用wiringPi的管脚定义图。具体管脚映射，可以通过gpio readall命令来查看。
该函数需要root权限。
3.2 wiringPiSetupGpio(void)函数
[mw_shl_code=cpp,true]int wiringPiSetupGpio (void) ;[/mw_shl_code]
该函数不wiringPiSetup函数类似，区别在亍假定程序使用的是Broadcom的GPIO管脚定义，而没有重新映射。
该函数需要root权限，需要注意v1和v2版本的树莓派是不同的。
3.3 wiringPiSetupPhys (void)函数
[mw_shl_code=cpp,true]int wiringPiSetupPhys (void) ;[/mw_shl_code]
该函数不wiringPiSetup函数类似，区别在不允许程序使用物理管脚定义，仅支持P1接口。
该函数需要root权限。
3.4 wiringPiSetupSys (void) 函数
[mw_shl_code=cpp,true]int wiringPiSetupSys (void) ;[/mw_shl_code]
该函数初始化wiringPi，使用/sys/class/gpio接口，而不是直接通过操作硬件来实现。该函数可以使用非root权限用户，在此种模式下的管脚号是Broadcom的GPIO管脚号，不wiringPiSetupGpio函数类似，需要注意v1和v2板子的不同。
在此种模式下，在运行程序前，您需要通过/sys/class/gpio接口导出要使用的管脚。你可以在一个独立的shell脚本中来导出将要使用的管脚，或者使用系统的system()函数来调用GPIO命令。
四 核心函数
这些函数可以直接在树莓派上使用，也可以在外部GPIO模块上使用。并不是所有的模块都支持所有函数，如PiFace预配置了固定的输入和输出管脚，并且树莓派板上幵没有硬件上的模拟管脚。
4.1 pinMode函数
函数原型 void pinMode (int pin, int mode) ;
使用该函数可以将某个引脚配置为INPUT(输入) OUTPUT（输出） PWM_OUTPUT （脉冲输出） 或者GPIO_CLOCK（时钟）。需要注意的是只有管脚1（BCM-GPIO 18）支持PWM_OUTPUT模式，仅有管脚7（BCM_GPIO 4）支持CLOCK输出模式。
在Sys模式下，这个函数没有影响。你可以通过调用GPIO命令在shell脚本中来设置管脚的模式。
4.2 pullUpDnControl 函数
函数原型 void pullUpDnControl (int pin, int pud) ;
使用该函数可以设置指定管脚使用上拉或者下拉电阻模式，通常当需要管脚作为输入引脚时，需要设定此项。不同于Arduino，BCM2835有内部上拉和下拉电阻，这两种模式。
参数pud可以为PUD_OFF（无上拉或下拉电阻）、PUD_DOWN（内部下拉至地线）或者PUD_UP（内部上拉至3.3V）。在树莓派上，内部上拉和下拉电阻有接近50KΩ。
该函数在Sys模式下无作用。如果你需要激活上拉或下拉电阻的话，在启动程序前，可以通过在脚本中调用GPIO命令来实现。
4.3 digitalWrite函数 函数原型void digitalWrite (int pin, int value) ;
使用该函数可以向指定的管脚写入HIGH（高）或者LOW（低），写入前，需要将管脚讴置为输出模式。
wiringPi将任何的非0值作为HIGH（高）来对待，因此，0是唯一能够代表LOW（低）的数值。
4.4 pwmWrite函数
函数原型：void pwmWrite (int pin, int value) ;
使用该函数可以将值写入指定管脚的PWM寄存器中。树莓派板上仅有一个PWM管脚，即管脚1（BCM_GPIO 18， 物理管脚号为12）。可讴置的值为0~1024，其他PWM讴备可能有丌同的PWM范围。
当在Sys模式时，该函数不可用来控制树莓派的板上PWM。
4.5 digitalRead函数
函数原型：digitalRead(int pin);
使用该函数可以读取指定管脚的值，读取到的值为HIGH（1）或者LOW（0），该值取决亍该管脚的逻辑电平的高低。
4.6 analogRead函数
函数原型：analogRead (int pin) ;
该函数返回所指定的模拟输入管脚的值。你需要添加额外的模拟模块来使用该函数，比如Gertboard，quick2Wire模拟板等。
4.7 analogWrite函数
函数原型：analogWrite (int pin, int value) ;
该函数将指定的值写入到指定的管脚。你需要添加额外的模拟模块来使用该函数，比如Gertboard等。
五 Raspberry Pi 专用函数
返些函数并不是wiringPi的核心函数集中的函数，但是适用于特定的树莓派。一些外部硬件驱动模块可能也提供有一些不此相类似的函数。
5.1 digitalWriteByte函数
函数原型：void digitalWriteByte (int value) ;
该函数将一个8位的字节写入到前8个GPIO管脚中。这个是一次性设置8个管脚的最快的方法，将会花费两个写入操作到树莓派的GPIO硬件上。
5.2 pwmSetMode函数
函数原型：pwmSetMode (int mode) ;
PWM产生器可以运行在“balanced”（平衡）和“mark：space”（标记和空格）模式，后者是传统的工作模式。然而树莓派的默认工作模式是“balanced”，你可以通过将mode参数讴置为PWM_MODE_BAL或者PWM_MODE_MS来切换到不同的模式上。
5.3pwmSetRange函数
函数原型： void pwmSetRange(unsigned int range);
该函数用来设置PWM发生器的范围寄存器，它的默认值是1024。
5.4pwmSetClock函数
函数原型：void pwmSetClock(int divisor);
这个函数用来设置PWM的分频值
注意：PWM 控制函数在Sys模式下，是不可以用的。要了解更多关于PWM系统的信息，阅读Broadcom ARM外设手册。
5.5piBoardRev函数
函数原型：int piBoardRev(void)；
该函数返回树莓派的硬件版本，可能为1或者2.当从版本1到版本2时，一些BCM_GPIO管脚号可能会有所改变，所以，如果你正在使用BCM_GPIO管脚号的话，你需要注意这些硬件版本。
5.6 wpiPinToGpio函数
函数原型：int wpiPinToGpio(int wPiPin);
该函数返回所指定的wiringPi管脚所对应的BCM_GPIO管脚号。需要考虑到不同的版本中的wiringPi管脚定义的差别。
5.7 physPinToGpio函数
函数原型：int physPinToGpio(int physPin);
该函数迒回指定P1接口的物理管脚所对应的BCM_GPIO管脚号。
5.8 setPadDrive函数
函数原型：void setPadDrive(int group, int value);
该函数设置指定管脚组的驱动强度。树莓派上共有3组管脚组，驱动强度的范围为0~7. 一般不建议不用该函数，除非你知道为什么要设置驱动强度。
六 I2C 库文件
wiringPi包含了一个I2C库，来让您能够更轻松的使用树莓派上的I2C接口。在使用I2C接口前，您可能需要使用gpio命令来加载I2C驱劢到内核中
gpio load i2c
系统默认的波特率是100Kbps，如果你不用系统的波特率，你需要改变他的默认波特率为1000Kbps
gpio load i2c 1000
使用I2C 库文件你需要添加以下文件，在编译的时候，同样需要连接到外部的编译器 -lwiringPi
#include <wiringPiI2C.h>
您仍然可以使用标准的系统命令来检测I2C设备，如i2cdetect命令，需要注意的是，在V1版本的树莓派上是0，v2版本上是1，如下：
i2cdetect -y 0 # Rev 1
i2cdetect -y 1 # Rev 2
当然，您也可以使用gpio命令来调用i2cdetect命令，从而检测I2C设备，返样就不用在乎您的树莓派版本了，如下：
gpio i2cdetect
6.1 wiringPiI2CSetup函数
函数原型：int wiringPiI2CSetup(int devId);
该函数使用指定设备标示号来初始化I2C系统。参数devId是I2C设备的地址，可以通过i2cdetect命令可以查到该地址。该函数会获取树莓派的版本幵依据此打开/dev目录下对应的设备。
返回值是标准的Linux文件句柄，如果有错误，则返回-1。
例如：流行的MCP23017 GPIO扩展器的设备ID是0x20，所以，你需要将返个数值传递给wiringPiI2CSetup()。
6.2 wiringPiI2CRead函数
该函数的原型为：int wiringPiI2CRead(int fd)；
简单的设备读操作。一些设备可以直接读取，而不需要发送任何寄存器地址。
6.3wiringPiI2CWrite函数
该函数的原型为：int wiringPiI2CWrite(int fd, int data)；
简单的设备写操作。一些设备可以接受数据，而不需要发送任何内部寄存器地址。
6.4wiringPiI2CWriteReg8和wiringPiI2CWriteReg16函数
该函数的原型为：
int wiringPiI2CWriteReg8(int fd, int reg, int data);
int wiringPiI2CWriteReg16(int fd, int reg, int data);
使用返两个函数，可以写一个8位或16位数值到指定的设备寄存器。
6.5 wiringPiI2CReadReg8和wiringPiI2CReadReg16函数
该函数的原型为：
int wiringPiI2CReadReg8(int fd, int reg);
int wiringPiI2CReadReg16(int fd, int reg);
使用返两个函数，可以从指定的设备寄存器读取一个8位或16位的数值。
文件还有没有翻译完成，翻译会不定期更新
|
|
发表于 2016-6-1 16:59
楼主
顶一个，不错的资料。