C语言树莓派API

安装wiringPi

1. 验证wiringPi的是否安装成功，输入gpio -v，会在终端中输出相关wiringPi的信息。否则安装失败。
2. gpio readall 查看IO口信息表

头文件

在使用wiringPi库时，你需要包含头文件 #include<wiringPi.h>。凡是写wiringPi的程序，都包含这个头文件。

1. 硬件初始化函数

使用wiringPi时，你必须在执行任何操作前初始化树莓派，否则程序不能正常工作,可以调用下表函数之一进行初始化，它们都会返回一个int ， 返回 -1 表示初始化失败。

1. wiringPiSetup

int wiringPiSetup (void);

返回:执行状态，-1表示失败	
当使用这个函数初始化树莓派引脚时，程序使用的是wiringPi 引脚编号表。引脚的编号为 0~16
需要root权限

2. wiringPiSetupGpio

int wiringPiSetupGpio (void);

回执行状态，-1表示失败	
当使用这个函数初始化树莓派引脚时，程序中使用的是BCM GPIO 引脚编号表。
需要root权限

3. wiringPiSetupPhys(void) 不常用，不做介绍;
4. wiringPiSetupSys (void) ;不常用，不做介绍;

2. 通用GPIO控制函数

1.pinMode

void pinMode (int pin, int mode);	

pin：配置的引脚;	
mode:指定引脚的IO模式	作用：配置引脚的IO模式;
可取的值：INPUT、OUTPUT、PWM_OUTPUT，GPIO_CLOCK	

注意：
只有wiringPi 引脚编号下的1脚（BCM下的18脚） 支持PWM输出
只有wiringPi编号下的7（BCM下的4号）支持GPIO_CLOCK输出
2. digitalWrite

void digitalWrite (int pin, int value);

pin：控制的引脚，让对一个已近配置为输出模式的引脚，输出指定的电平信号
value：引脚输出的电平值。	可取的值：HIGH，LOW分别代表高低电平	

3.digitalRead

int digitalRead (int pin);

pin：读取的引脚,读取一个引脚的电平值 LOW  HIGH ，
返回：引脚上的电平，可以是LOW HIGH 之一	

4.analogWrite

void analogWrite(int pin, int value);

pin:引脚	模拟量输出
value：输出的模拟量

注意：树莓派的引脚本身是不支持AD转换的，也就是不能使用模拟量的API，需要增加另外的模块
3. analogRead

int analogRead (int pin);

pin：引脚, 模拟量输入
返回：引脚上读取的模拟量

注意： 树莓派的引脚本身是不支持AD转换的，也就是不能使用模拟量的API，需要增加另外的模块
6.pwmWrite

void pwmWrite (int pin, int value);

pin：引脚	输出一个值到PWM寄存器，控制PWM输出。
value：写入到PWM寄存器的值，范围在0~1024之间。	
pin只能是wiringPi 引脚编号下的1脚（BCM下的18脚）

7.pullUpDnControl

void pullUpDnControl (int pin, int pud);

pin：引脚	对一个设置IO模式为 INPUT 的输入引脚设置拉电阻模式。
pud：拉电阻模式	与Arduino不同的是，树莓派支持的拉电阻模式更丰富。	

可取的值：
PUD_OFF 不启用任何拉电阻。关闭拉电阻。 树莓派内部的拉电阻达50K欧姆
PUD_DOWN 启用下拉电阻，引脚电平拉到GND
PUD_UP 启用上拉电阻，引脚电平拉到3.3v

3. 时间控制函数

1. millis(计数-毫秒)

unsigned int millis (void);

返回一个从程序执行wiringPiSetup初始化函数（或者wiringPiSetupGpio）到当前时间经过的毫秒数。
返回类型是unsigned int，最大可记录 大约49天的毫秒时长。		

2. micros （计数-微秒）

unsigned int micros (void);

函数返回一个从程序执行wiringPiSetup初始化函数(或者wiringPiSetupGpio)到当前时间经过的微秒数。	
返回类型是unsigned int，最大可记录 大约71分钟的时长。	

3. delay（暂停函数-毫秒）

void delay (unsigned int howLong);

将当前执行流暂停 指定的毫秒数。
因为Linux本身是多线程的，所以实际暂停时间可能会长一些。
参数是unsigned int 类型，最大延时时间可达49天	

4. delayMicroseconds （暂停函数-微秒）

void delayMicroseconds (unsigned int howLong)；

将执行流暂停 指定的微秒数（1000微秒 = 1毫秒 = 0.001秒）。
因为Linux本身是多线程的，所以实际暂停时间可能会长一些。参数是unsigned int 类型，最大延时时间可达71分钟；
中断	wiringPi提供了一个中断处理注册函数，它只是一个注册函数，并不处理中断。他无需root权限。	

5. wiringPiISR

int wiringPiISR (int pin, int edgeType,void(*function)(void));	

返回值：返回负数则代表注册失败	
pin：接受中断信号的引脚	
edgeType：触发的方式。	
function：中断处理函数的指针，它是一个无返回值，无参数的函数。	

注意：注册的函数会在中断发生时执行,和51单片机不同的是：这个注册的中断处理函数会和main函数并发执行（同时执行，谁也不耽误谁）当本次中断函数还未执行完毕，这个时候树莓派又触发了一个中断，那么这个后来的中断不会被丢弃，它仍然可以被执行。
但是wiringPi最多可以跟踪并记录后来的仅仅1个中断，如果不止1个，则他们会被忽略，得不到执行。
INT_EDGE_FALLING：下降沿触发
INT_EDGE_RISING：上升沿触发
INT_EDGE_BOTH ：上下降都会触发
INT_EDGE_SETUP：编程时用不到。

4. 多线程

wiringPi提供了简单的Linux系统下的通用的 Posix threads线程库接口来支持并发。

1. piThreadCreate

int piThreadCreate(name);
name:被包装的线程执行函数
返回：状态码,返回0表示成功启动，反之失败。

包装一个用PI_THEEAD定义的函数为一个线程，并启动这个线程;
首先需要通过以下方式创建一个特特殊的函数，这个函数中的代码就是在新的线程中将执行的代码。
myTread是你自己线程的名字，可自定义。
源代码：

PI_THREAD (myThread);
int piThreadCreate (void *(*fn)(void *))	
{
   
	{
   	 																		  //在这里面写上的代码会和主线程并发执行。
 	pthread_t myThread ;	
 	}
 return pthread_create (&myThread, NULL, fn, NULL) ;
 //在wiringPi.h中，我发现这样一个宏定义：#define PI_THREAD(X) void *X (void *dummy)
}
//那么，被预处理后我们写的线程函数会变成下面这个样子，请注意返回值，难怪我每次写都会警告，因为没有返回一个指针,那么，以后注意返回NULL，或者 (void*)0  
void *myThread (void *dummy)
{
   
 //在这里面写上的代码会和主线程并发执行。
}

2. piLock

piLock(int keyNum);

keyNum：0,1,2,3 每一个数字就代表一把锁。
keyNum:0-3的值，每一个值代表一把锁,使能同步锁。
wiringPi只提供了4把锁，也就是keyNum只能取0~3的值，官方认为有这4把锁就够了。

源代码：