树莓派wiringPi库API函数(翻译中)

树莓派wiringPi库API函数


API函数英文网页    :https://projects.drogon.net/raspberry-pi/wiringpi/functions/

BCM2835芯片手册 :https://github.com/raspberrypi/documentation/blob/master/hardware/raspberrypi/bcm2835

wiringPi库下载地址 : https://git.drogon.net/?p=wiringPi;a=summary

wiringPi库git地址   : git://git.drogon.net/wiringPi


在使用wiringPi库之前,你需要包含头文件:

#include <wiringPi.h>
依赖你正在使用的系统环境你需要增加 -I/usr/local/include -L/usr/local/lib -lwiringPi 在使用命令行的时候编译你的程序,最重要的是-lwiringPi


设置函数(Setup Functions)

这里有3中方式来初始化wiringPi。

  • int wiringPiSetup (void) ;
  • int wiringPiSetupGpio (void) ;
  • int wiringPiSetupSys (void) ;
在你程序开始的时候必须调用其中一个设置函数,如果返回-1则初始化GPIO失败,然后你应该查阅全局错误代码去看为什么会失败。

下面是几个设置函数的区别:


  • wiringPiSetup(void) ;

这个设置函数初始化wiringPi系统,假定当前程序将要使用wiringPi引脚编号方案,这是一个简单的编号方案,它提供了将虚拟引脚编号0~16映射到实际的Broadcom GPIO引脚编号。查看pins page图表来了解wiringPi引脚编号、Broadcom GPIO引脚编号和树莓派板子的边缘连接器物理位置的映射情况。

这个函数需要root权限才能调用。


  • wiringPiSetupGpio(void) ;
这个函数与上面那个函数相同,然而它允许当前程序不重新映射直接地使用Broadcom GPIO引脚编号。
和上面一样,这个函数也需要root权限才能调用。


  • wiringPiSetupSys(void)
这个函数初始化wiringPi系统,但是它用的是/sys/class/gpio接口而不是直接的访问硬件。它可以被非root用户调用,提供的GPIO引脚必须在事先使用gpio命令导出。在这种模式下的引脚编号是原生的Broadcom GPIO引脚编号。

注意:在这种模式下你仅仅能够使用通过/sys/class/gpio接口导出的引脚。在你调用你的程序之前你必须导出这些引脚。
你可以通过一个单独的shell脚本来做这件事,或者在你的程序中使用system()函数。


还需要注意的是一些函数(下面列出的)在使用这种模式的时候是无效的,它们可能不能在非root权限的情况下进行操作。



一般wiring函数(General wiring functions)

  • void pinMode (int pin, int mode) ;
这个函数设置引脚的模式为INPUT、OUTPUT或者PWM_OUTPUT.注意仅仅wiringPi引脚1(BCM_GPIO 18)支持PWM输出,
引脚的编号可以从pins table中获得。
这个函数在系统模式( Sys mode)下无效。



  • void digitalWrite (int pin, int value) ;
向给出的引脚写HIGH或者LOW(1 or 0)值,并确保该引脚在之前已经被设置成输出模式。


  • void digitalWriteByte (int value) ;
这个函数写8位字节到8个GPIO引脚,最快的方式是马上设置所有8位字节成一个特定的值,尽管它仍然需要对GPIO硬件进行了两次写操作。


  • void pwmWrite (int pin, int value) ;
向给出引脚的PWM寄存器写value值,value的值必须在0~1024之间。(再次注意,仅仅pin1(BCM_GPIO18)支持PWM)
这个函数在系统模式( Sys mode)下无效。


  • int digitalRead (int pin) ;
这个函数返回读取pin引脚所获得的值,这个值将会是HIGH或者LOW(1 or 0)取决于改pin的逻辑电平。


  • void pullUpDnControl (int pin, int pud) ;
这个函数将给出的引脚设置成上拉或者下拉电阻模式,引脚必须设置成输入模式。和Arduino不同,BCM2835
同时有用上拉和下拉内部电阻器。pud参数应该是;PUD_OFF(没有上拉或下拉),PUD_DOWN(下拉),PUD_UP(上拉到3.3V)。

这个函数在Sys模式下无效,如果你需要启动一个上拉或者下拉,你可以在你开始运行程序前在一个脚本中使用gpio命令来完成。



PWM控制(PWM Control)

当系统运行在Sys模式下的时候PWM不能被控制

  • pwmSetMode (int mode) ;
PWM发生器可以以两种模式工作-"平稳模式"和"mark:space"。mark:space模式时传统的,然而
PI的默认模式时平稳模式。你可以通过提供 PWM_MODE_BAL 或者 PWM_MODE_MS 参数来切换模式。



  • pwmSetRange (unsigned int range) ;
这个函数设置了PWM发生器的寄存器的范围,默认是1024。


  • pwmSetClock (int divisor) ;
这个函数用于设置PWM时钟的分频数。

你需要阅读Broadcom ARM 外设数据手册来了解更多关于PWM系统的信息。


定时函数(Timing functions)

  • unsigned int millis (void)
这个函数返回一个数据,这个数据代表了从你的程序调用wiringPiSetup函数开始到当前所经历的毫秒数,它返回一个32位无符号数which wraps after 49 days。


  • void delay (unsigned int howLong)
这个函数会导致程序执行暂停至少howLong毫秒,由于linux多任务的特性可能会更长。注意最大的延时时间是一个32位无符号整数或者大约为49天。


  • void delayMicroseconds (unsigned int howLong)
这个函数会导致程序执行暂停至少howLong微秒,由于linux多任务的特性可能会更长。注意最大的延时时间是一个32位无符号整数微秒或者大约为71分钟。



程序/线程优先级(Program/Thread Priority)

  • int piHiPri (int priority) ;

中断(Interrupts)

拥有一个更新了GPIO中断处理代码补丁的内核(也就是在2012年7月以后的内核),你现在就可以在你的程序
中等待中断的发生。这个功能在你等待中断发生的时候释放处理器去做其它任务。GPIO口可以产生的中断输入信号
有上升沿、下降沿或者两者都有。
注意:2013年1月:waitForInterrupt()函数已经被弃用了,你应该使用下面这个更新更简单的wiringPiISR() 函数。

  • int waitForInterrupt (int pin, int timeOut) ;
当被调用的时候,你的程序会被挂起来等待该引脚有中断事件的发生。 timeOut 参数给入的是毫秒值,或者可以设置成-1当需要永久的等待的时候。
返回值是-1意味着发生了错误(errno会相应的被设置),是0如果超时,是1代表了成功检测到了的一个中断事件。

在调用waitForInterrupt之前,你首先必须初始化GPIO引脚,目前唯一能够做这件事的方式是使用gpio命令,也可以在一个脚本中,或者在你的程序中使用system()。
举例来说我们想要在GPIO引脚0上等待一个下降沿中断,因此要设置硬件,我们需要运行:
        gpio edge 0 falling
在运行程序之前。

  • int wiringPiISR (int pin, int edgeType,  void (*function)(void)) ;
这个函数在特殊的引脚上注册一个函数来接收中断,edgeType参数是INT_EDGE_FALLING、INT_EDGE_RISING,INT_EDGE_BOTH or INT_EDGE_SETUP中的一个。如果它是INT_EDGE_SETUP,则不会有初始化引脚的操作发生-它假定你已经在别处设置了引(例如 使用gpio命令),但是如果你指定了其它类型中的一种,然后这个引脚就会按照规定被导出和初始化。它通过合适的调用gpio通用命令来实现,因此它应该被使用。

引脚编号由当前的模式提供-native wiringPi, BCM_GPIO or Sys 模式。

这个函数(wiringPiISR )可以在任何模式下工作,没必要获取root权限来工作。

当中断触发的时候function函数就会被调用,当它已经被触发了,在调用function函数之前它会在调度程序中被清除,因此如果在你处理完成(这次中断)之前一个后续的中断发生,然后它(后续的中断)不会被丢失。(不管怎样,它仅仅能够监测再多一个中断,它们(中断)会被忽略如果在一个中断正在被处理的时候又有不只一个中断发生)。

这个函数可以在高优先级别下运行(如果程序使用sudo运行或者在root权限下),与主程序同时执行。它能够完全访问所有的全局变量,打开文件句柄等等。

通过查看 isr.c例程来了解更多详细的内容和怎么去使用这些特性。


并行处理(Concurrent Processing (multi-threading))

  • int piThreadCreate (name) ;
  • piLock (int keyNum) ;
  • piUnlock (int keyNum) ;
混杂函数(Misc. Functions)

  • piBoardRev (void) ;

  • wpiPinToGpio (int wPiPin) ;
  • setPadDrive (int group, int value) ;

-----------------------------------------------------------------------------------------------------------------
本文属于本人原创文章,转载请注明出处: http://blog.csdn.net/a656343072/article/details/41209857
本人英文水平有限,欢迎指正错误。
--huangzhigang
-----------------------------------------------------------------------------------------------------------------

你可能感兴趣的:(api,wiringPi,wiringPi,wiringPi中文翻译,wiringPi函数借口,wiringPi库使用)