Arduino IED for EDP8266编写的相关函数

原文出处：http://www.yfrobot.com/thread-11798-1-1.html

直接使用arduino IDE 编译 ESP8266程序非常方便！本文将介绍其相关语法，在http://esp8266.github.io/Arduino/versions/2.1.0/ 可以找到相关文档。

数字I/O口 Digital IO
Arduino 引脚号直接对应ESP8266 GPIO 引脚。pinMode，digitalRead，和 digitalWrite 函数照常使用，所以读取GPIO2引脚，这样写：digitalRead(2) 。
数字引脚 0~15可以设置为 INPUT，OUTPUT 或者 INPUT_PULLUP 模式。引脚 16可以设置为INPUT，OUTPUT 或者 INPUT_PULLDOWN_16 模式。在启动时，引脚被配置为INPUT。
引脚同样可以提供其他功能，像串行,I2C,SPI。这些函数通常需要使用相应的库。下图为ESP-12模块的引脚图：

可见图中没有数字引脚6~11，因为大部分模块使用这几个引脚连接了flash存储芯片了。这些引脚不可使用，否则可能导致程序崩溃。

注意：有些电路板和模块（ESP-12ED NodeMCU 1.0）也释放了引脚9和11，如果Flash芯片工作在DIO模式下（默认QIO模式），它们可以被当做IO口使用。
引脚中断可以使用 attachInterrupt,detachInterrupt函数。除了GPIO16引脚，其他引脚都可以使用中断功能。标准的Arduino 中断类型都是支持的：CHANGE,RISING,FALLING。

模拟输入 Analog input
ESP8266只有一个ADC通道提供给用户。它可以使用于读取ADC引脚电压，也可使用于读取模块电源电压（VCC）。
读取ADC引脚值电压，使用analogRead(A0)。输入电压范围：0~1.0V。
读取模块电源电压，使用ESP.getVcc() 且ADC引脚不能连接。另外，下面的代码必须添加至程序中：
ADC_MODE(ADC_VCC);
这条代码不能包含在任何函数中，放在程序中 #include 之后即可。
模拟输出 Analog output
analogWrite(pin, value) 在已有的引脚上使能软件PWM功能。PWM可以用在引脚0~16。调用analogWrite(pin, 0) 可以关闭引脚PWM。取值范围：0~ PWMRANGE,默认为1023。 PWM 范围可以使用analogWriteRange(new_range)语句来更改。
PWM 默认频率：1KHz。使用analogWriteFreq(new_frequency) 可以更改频率。

时间与延时  Timing and delays
millis() 和 micros() 分别返回单位为毫秒和微秒的值，复位后值重置。
delay(ms) 暂时程序给定毫秒时间并允许WiFi和TCP/IP任务的运行。delayMicroseconds(us) 暂时程序给定微秒时间。
记住wifi连接后除了素描程序外还有许多代码需要再芯片上运行。每次loop()函数完成时或当delay被调用时，Wifi和TCP/IP库都有机会处理任何等待事件。如果你程序中某处有循环，消耗事件大于50ms且没有调用delay，你可以考虑添加一个调用延时函数以保持Wifi堆栈的平稳运行。
有个 yield()函数和delay(0)功能相同。delayMicroseconds函数，在另一方面，不会为其他任务让步，所以当延时超过20ms时不推荐使用它。

串行 Serial
Serial 功能几乎和普通arduino一样，除了硬件FIFO (128 bytes for TX and RX)有额外256byte TX and RX缓冲区。传输和接收都是中断驱动。当FIFO和缓冲区分别为满和空时，读写功能将阻止程序的运行。
Serial 使用UART0，即引脚映射GPIO1(TX)和GPIO3(RX)。Serial.begin 之后调用Serial.swap()时，Serial引脚将映射到GPIO15(TX)和GPIO13(RX)。再次调用 swap时 引脚映射将回到GPIO1(TX)和GPIO3(RX)。
Serial1 使用UART1，TX引脚为GPIO2。UART1不能用来接收数据因为通常情况RX引脚被用到flash芯片连接了。使用Serail1，调用 Serial1.begin(baudrate)。
如果Serial1没有使用且Serial没有被调换 - 通过在Serial.begin之后调用Serial.set_tx(2)或者直接调用Serial.begin(baud,config,mode,2) 可以将UART0的TX映射到GPIO2。
默认情况下当你调用Serial.begin，Wifi库诊断输出是禁用的。再次启动调试输出，调用Serial.setDebugOutput(true)。调用Serial1.setDebugOutput(true)，Serial1重定向调试输出。
你也需要使用Serial.setDebugOutput(true)去使能printf()函数的输出。
Serial和Serial1都支持 5,6,7,8数据位；奇 (O), 偶 (E),无(N) 校验位；1或2停止位。设置所需模式，调用Serial.begin(baudrate,SRIAL_8N1),Serial.begin(baudrate, SERIAL_6E2), etc.

Progmem

程序内存工作特性和arduino页非常相似，在只读存储器中的存放只读数据和字符串，为你的应用释放堆。最重要的区别是在ESP8266上字符串不合并。这意味着在代码中定义在F("")和PSTR("")中的相同字符串在每个实例中都将占用空间。所以你需要自行管理重复的字符串。

有个附加辅助宏，让它更容易通过 const PROGMEM 字符串去使用 FPSTR()（__FlashStringHelper）方法。这样使用将有助于使合并字符串更简便。Not pooling strings...（这尼玛什么鬼，不懂）

[C] 纯文本查看 复制代码

?

1

2

3

4

5

String response1;

response1 += F("http:");

...

String response2;

response2 += F("http:");

使用 FPSTR 将变为：

[C] 纯文本查看 复制代码

?

1

2

3

4

5

6

7

8

9

constchar HTTP[] PROGMEM = "http:";

...

{

    String response1;

    response1 += FPSTR(HTTP);

    ...

    String response2;

    response2 += FPSTR(HTTP);

}

Libraries 更多文档资料，点击查看：http://esp8266.github.io/Arduino/versions/2.1.0/doc/libraries.html