树莓派3B--深入学习wiringPi

 

资料一：

关于wiringPi的函数库

官方的在这里https://projects.drogon.net/raspberry-pi/wiringpi/functions/

点击打开链接

还有一个前辈翻译了一部分的

 

[html] view plain copy

1. API函数英文网页    ：https://projects.drogon.net/raspberry-pi/wiringpi/functions/  
2. BCM2835芯片手册 ：https://github.com/raspberrypi/documentation/blob/master/hardware/raspberrypi/bcm2835  
3. wiringPi库下载地址 : https://git.drogon.net/?p=wiringPi;a=summary  
4. wiringPi库Git地址   : git://git.drogon.net/wiringPi  
5.   
6. 在使用wiringPi库之前，你需要包含头文件：  
7. #include <wiringPi.h>  
8. 依赖你正在使用的系统环境你需要增加 -I/usr/local/include -L/usr/local/lib -lwiringPi 在使用命令行的时候编译你的程序，最重要的是-lwiringPi。  
9.   
10. 设置函数（Setup Functions）  
11.   
12. 这里有3中方式来初始化wiringPi。  
13. int wiringPiSetup (void) ;  
14. int wiringPiSetupGpio (void) ;  
15. int wiringPiSetupSys (void) ;  
16. 在你程序开始的时候必须调用其中一个设置函数，如果返回-1则初始化GPIO失败，然后你应该查阅全局错误代码去看为什么会失败。  
17. 下面是几个设置函数的区别：  
18.   
19. wiringPiSetup(void) ;  
20. 这个设置函数初始化wiringPi系统，假定当前程序将要使用wiringPi引脚编号方案，这是一个简单的编号方案，它提供了将虚拟引脚编号0~16映射到实际的Broadcom GPIO引脚编号。查看pins page图表来了解wiringPi引脚编号、Broadcom GPIO引脚编号和树莓派板子的边缘连接器物理位置的映射情况。  
21. 这个函数需要root权限才能调用。  
22.   
23. wiringPiSetupGpio(void) ;  
24. 这个函数与上面那个函数相同，然而它允许当前程序不重新映射直接地使用Broadcom GPIO引脚编号。  
25. 和上面一样，这个函数也需要root权限才能调用。  
26.   
27.   
28. wiringPiSetupSys(void)  
29. 这个函数初始化wiringPi系统，但是它用的是/sys/class/gpio接口而不是直接的访问硬件。它可以被非root用户调用，提供的GPIO引脚必须在事先使用gpio命令导出。在这种模式下的引脚编号是原生的Broadcom GPIO引脚编号。  
30.   
31. 注意：在这种模式下你仅仅能够使用通过/sys/class/gpio接口导出的引脚。在你调用你的程序之前你必须导出这些引脚。  
32. 你可以通过一个单独的shell脚本来做这件事，或者在你的程序中使用system()函数。  
33.   
34. 还需要注意的是一些函数(下面列出的)在使用这种模式的时候是无效的，它们可能不能在非root权限的情况下进行操作。  
35.   
36.   
37.   
38. 一般wiring函数（General wiring functions）  
39.   
40. void pinMode (int pin, int mode) ;  
41. 这个函数设置引脚的模式为INPUT、OUTPUT或者PWM_OUTPUT.注意仅仅wiringPi引脚1（BCM_GPIO 18）支持PWM输出，  
42. 引脚的编号可以从pins table中获得。  
43. 这个函数在系统模式（ Sys mode）下无效。  
44.   
45.   
46. void digitalWrite (int pin, int value) ;  
47. 向给出的引脚写HIGH或者LOW（1 or 0）值，并确保该引脚在之前已经被设置成输出模式。  
48.   
49.   
50. void digitalWriteByte (int value) ;  
51. 这个函数写8位字节到8个GPIO引脚，最快的方式是马上设置所有8位字节成一个特定的值，尽管它仍然需要对GPIO硬件进行了两次写操作。  
52.   
53.   
54. void pwmWrite (int pin, int value) ;  
55. 向给出引脚的PWM寄存器写value值，value的值必须在0~1024之间。(再次注意，仅仅pin1(BCM_GPIO18)支持PWM)  
56. 这个函数在系统模式（ Sys mode）下无效。  
57.   
58.   
59. int digitalRead (int pin) ;  
60. 这个函数返回读取pin引脚所获得的值，这个值将会是HIGH或者LOW（1 or 0）取决于改pin的逻辑电平。  
61.   
62.   
63. void pullUpDnControl (int pin, int pud) ;  
64. 这个函数将给出的引脚设置成上拉或者下拉电阻模式，引脚必须设置成输入模式。和Arduino不同，BCM2835  
65. 同时有用上拉和下拉内部电阻器。pud参数应该是;PUD_OFF(没有上拉或下拉),PUD_DOWN（下拉）,PUD_UP（上拉到3.3V）。  
66.   
67. 这个函数在Sys模式下无效，如果你需要启动一个上拉或者下拉，你可以在你开始运行程序前在一个脚本中使用gpio命令来完成。  
68.   
69.   
70. PWM控制（PWM Control）  
71.   
72. 当系统运行在Sys模式下的时候PWM不能被控制。  
73.   
74. pwmSetMode (int mode) ;  
75. PWM发生器可以以两种模式工作-"平稳模式"和"mark:space"。mark:space模式时传统的，然而  
76. PI的默认模式时平稳模式。你可以通过提供 PWM_MODE_BAL 或者 PWM_MODE_MS 参数来切换模式。  
77.   
78.   
79. pwmSetRange (unsigned int range) ;  
80. 这个函数设置了PWM发生器的寄存器的范围，默认是1024。  
81.   
82.   
83. pwmSetClock (int divisor) ;  
84. 这个函数用于设置PWM时钟的分频数。  
85.   
86. 你需要阅读Broadcom ARM 外设数据手册来了解更多关于PWM系统的信息。  
87.   
88.   
89. 定时函数（Timing functions）  
90.   
91. unsigned int millis (void)  
92. 这个函数返回一个数据，这个数据代表了从你的程序调用wiringPiSetup函数开始到当前所经历的毫秒数，它返回一个32位无符号数which wraps after 49 days。  
93.   
94.   
95. void delay (unsigned int howLong)  
96. 这个函数会导致程序执行暂停至少howLong毫秒，由于linux多任务的特性可能会更长。注意最大的延时时间是一个32位无符号整数或者大约为49天。  
97.   
98.   
99. void delayMicroseconds (unsigned int howLong)  
100. 这个函数会导致程序执行暂停至少howLong微秒，由于linux多任务的特性可能会更长。注意最大的延时时间是一个32位无符号整数微秒或者大约为71分钟。  
101.   
102.   
103.   
104. 程序/线程优先级（Program/Thread Priority）  
105.   
106. int piHiPri (int priority) ;  
107.   
108. 中断（Interrupts）  
109.   
110. 拥有一个更新了GPIO中断处理代码补丁的内核（也就是在2012年7月以后的内核），你现在就可以在你的程序  
111. 中等待中断的发生。这个功能在你等待中断发生的时候释放处理器去做其它任务。GPIO口可以产生的中断输入信号  
112. 有上升沿、下降沿或者两者都有。  
113. 注意：2013年1月：waitForInterrupt()函数已经被弃用了，你应该使用下面这个更新更简单的wiringPiISR() 函数。  
114.   
115. int waitForInterrupt (int pin, int timeOut) ;  
116. 当被调用的时候，你的程序会被挂起来等待该引脚有中断事件的发生。 timeOut 参数给入的是毫秒值，或者可以设置成-1当需要永久的等待的时候。  
117. 返回值是-1意味着发生了错误（errno会相应的被设置），是0如果超时，是1代表了成功检测到了的一个中断事件。  
118.   
119. 在调用waitForInterrupt之前，你首先必须初始化GPIO引脚，目前唯一能够做这件事的方式是使用gpio命令，也可以在一个脚本中，或者在你的程序中使用system()。  
120. 举例来说我们想要在GPIO引脚0上等待一个下降沿中断，因此要设置硬件，我们需要运行：  
121.         gpio edge 0 falling  
122. 在运行程序之前。  
123.   
124. int wiringPiISR (int pin, int edgeType,  void (*function)(void)) ;  
125. 这个函数在特殊的引脚上注册一个函数来接收中断，edgeType参数是INT_EDGE_FALLING、INT_EDGE_RISING,INT_EDGE_BOTH or INT_EDGE_SETUP中的一个。如果它是INT_EDGE_SETUP，则不会有初始化引脚的操作发生-它假定你已经在别处设置了引（例如 使用gpio命令），但是如果你指定了其它类型中的一种，然后这个引脚就会按照规定被导出和初始化。它通过合适的调用gpio通用命令来实现，因此它应该被使用。  
126.   
127. 引脚编号由当前的模式提供-native wiringPi, BCM_GPIO or Sys 模式。  
128.   
129. 这个函数（wiringPiISR ）可以在任何模式下工作，没必要获取root权限来工作。  
130.   
131. 当中断触发的时候function函数就会被调用，当它已经被触发了，在调用function函数之前它会在调度程序中被清除，因此如果在你处理完成（这次中断）之前一个后续的中断发生，然后它（后续的中断）不会被丢失。（不管怎样，它仅仅能够监测再多一个中断，它们（中断）会被忽略如果在一个中断正在被处理的时候又有不只一个中断发生）。  
132.   
133. 这个函数可以在高优先级别下运行（如果程序使用sudo运行或者在root权限下），与主程序同时执行。它能够完全访问所有的全局变量，打开文件句柄等等。  
134.   
135. 通过查看 isr.c例程来了解更多详细的内容和怎么去使用这些特性。  
136.   
137.   
138. 并行处理（Concurrent Processing (multi-threading)）  
139.   
140. int piThreadCreate (name) ;  
141. piLock (int keyNum) ;  
142. piUnlock (int keyNum) ;  
143. 混杂函数(Misc. Functions)  
144.   
145. piBoardRev (void) ;  
146.   
147. wpiPinToGpio (int wPiPin) ;  
148. setPadDrive (int group, int value) ;  
149.   
150. -----------------------------------------------------------------------------------------------------------------  
151. 本文属于本人原创文章，转载请注明出处：http://blog.csdn.net/a656343072/article/details/41209857  
152. 本人英文水平有限，欢迎指正错误。  
153. --huangzhigang  
154. ----------------------------------------------------------------------------------------------------------------- 

资料二：

（http://www.arduino.cn） 树莓派WiringPi常用函数中文手册

致谢：

1、 树莓派

2、wiringPi

3、树莓派wiringPi库API函数（翻译中）

4、（http://www.arduino.cn） 树莓派WiringPi常用函数中文手册