上一次讲了ESP8266这块芯片的深度开发的准备工作和有关编译指导文件makefile的一些要点，那么这一次就来讲讲关于SDK的正式开发吧。
程序入口
![]()
app.png
首先，在工程文件夹下找到app文件夹，再打开user文件夹，如上图所示，从user文件夹中找到user_main.c这个文件，这就是我们程序的主程序了。打开文件，找到user_init()，这就是我们程序的入口函数了（SDK1.5版本以上的还有user_rf_pre_init()这个函数，不过我们的主程序还是在user_init()里面编辑就好，user_rf_pre_init()这个函数可以留空函数）。
串口设置
串口调试可以说是SDK开发的一个必要环节，只有通过串口通讯环节，我们才有了和芯片沟通的能力，所以串口设置是我比较推荐在user_init()里面最先编写的部分。下面是几个常用函数：
- void uart_init(UartBautRate uart0_br, UartBautRate uart1_br)
功能：双 uart 模式，两个 uart 波特率初始化；
ESP8266有两个串口通道，第一个参数是uart0的波特率，第一个参数是uart1的波特率，芯片默认的波特率是78840，我建议是改成115200或者9600这两个使用率比较高的波特率，当然你用其他的波特率也可以，只要你所设置的和你的串口调试工具中的设置能对应起来就行。 - void uart0_sendStr(const char *str)
功能：通过 UART0 发送用户自定义数据；
由于我用的是ESP8266-01的板，它默认引出来的串口就是uart0，所以我的串口打印数据就用这个函数，参数可以直接输入字符串，十分方便。
IO口设置
- void gpio_output_set(uint32 set_mask, uint32 clear_mask, uint32 enable_mask,
uint32 disable_mask)
功能：设置 gpio 口属性
例子：
设置 GPIO12 输出高电平，则：gpio_output_set(BIT12, 0, BIT12, 0);
设置 GPIO12 输出低电平，则：gpio_output_set(0, BIT12, BIT12, 0);
设置 GPIO12 输出高电平，GPIO13 输出低电平，则：gpio_output_set(BIT12,BIT13, BIT12|BIT13, 0);
设置 GPIO12 为输入，则 gpio_output_set(0, 0, 0, BIT12); - void gpio_pin_intr_state_set(uint32 i, GPIO_INT_TYPE intr_state)
功能：设置 gpio 脚中断触发状态
输入参数：
uint32 i——GPIO 管脚 ID，如需设置 GPIO14，则为 GPIO_ID_PIN(14)；
GPIO_INT_TYPE intr_state——中断触发状态
其中：
typedef enum{
GPIO_PIN_INTR_DISABLE = 0, （不触发中断）
GPIO_PIN_INTR_POSEDGE= 1,（上升沿触发）
GPIO_PIN_INTR_NEGEDGE= 2,（下降沿触发）
GPIO_PIN_INTR_ANYEGDE=3,
GPIO_PIN_INTR_LOLEVEL= 4, （低电平触发）
GPIO_PIN_INTR_HILEVEL = 5,（高电平触发）
}GPIO_INT_TYPE; - GPIO_OUTPUT_SET(gpio_no, bit_value)
设置 gpio_no 管脚输出 bit_value，同上述例子中输出高低电平的功能。 - GPIO_DIS_OUTPUT(gpio_no)
设置 gpio_no 管脚为输入，同上述例子中输入。 - GPIO_INPUT_GET(gpio_no)
获取 gpio_no 管脚的电平状态。
例子
如果我们要使用GPIO12这个IO口，只需要配置以下几步
// Use MTDI pin as GPIO12.
PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDI_U, FUNC_GPIO12);
//输出高电平
GPIO_OUTPUT_SET(FUNC_GPIO12, 1);
//配置输入
GPIO_DIS_OUTPUT(FUNC_GPIO12)；
//获得GPIO电平
uin16 status=GPIO_INPUT_GET(FUNC_GPIO12);
//配置GPIO中断处理函数：
ETS_GPIO_INTR_ATTACH(func, arg)
使用方法：先定义一个GPIO中断处理函数，arg如果没有参数直接输入NULL
void GPIO_INTER(void)
{
......//这一部分可以加入自己想要响应中断的函数；
在 GPIO 中断处理函数内，需要做如下操作来清除响应位的中断状态：
uint32 gpio_status;
gpio_status = GPIO_REG_READ(GPIO_STATUS_ADDRESS);
//clear interrupt status
GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, gpio_status);
}
ETS_GPIO_INTR_ATTACH(GPIO_INTER, NULL); //注册 GPIO 中断处理函数
WIFI设置
由于ESP8266是一块wifi芯片，所以wifi的配置是少不了的。
芯片的wifi工作模式有以下三种：
- STATION_MODE（客户端模式，也就是主动去连接路由器）
- SOFTAP_MODE（服务器模式，也就是可以充当路由器，等其他设备连接）
- STATIONAP_MODE（主从一体模式，也就是俗称的wifi中继功能）
常用的函数是下列几个：
- wifi_get_opmode(void)
功能：获取 wifi 工作模式；
wifi 工作模式，其中 0x01 时为 STATION_MODE，0x02 时为 SOFTAP_MODE，
0x03 时为 STATIONAP_MODE。 - wifi_set_opmode(uint8 opmode)
功能：设置 wifi 工作模式为 STATION、SOFTAP、STATION+SOFTAP
其中 STATION_MODE 为 0x01，SOFTAP_MODE 为 0x02，STATIONAP_MODE 为0x03。 - wifi_station_set_config(struct station_config *config)
功能：设置 wifi 的 station 接口参数。
其中，参数中结构体定义如下：
struct station_config {
uint8 ssid[32];
uint8 password[64];
};
以下为wifi配置的例子，只需修改SSID和PASSWORD即可工作：
<pre><code>user_set_station_config(void)
{
// Wifi configuration
char ssid[32] = SSID; //SSID为输入的你的路由名称
char password[64] = PASSWORD; //PASSWORD为输入的wifi密码
struct station_config stationConf;
//need not mac address
stationConf.bssid_set = 0;
//Set ap settings
os_memcpy(&stationConf.ssid, ssid, 32);
os_memcpy(&stationConf.password, password, 64);
wifi_station_set_config(&stationConf);
//set a timer to check whether got ip from router succeed or not.
os_timer_disarm(&client_timer);
os_timer_setfn(&client_timer, (os_timer_func_t *)user_check_ip, NULL);
os_timer_arm(&client_timer, 100, 0);
}</pre></code>
在user_init()中：
<pre><code>void user_init(void)
{
//Set uart port
uart_init(115200,9600);
os_printf("SDK version:%s\n", system_get_sdk_version());
//Set station mode
wifi_set_opmode(STATION_MODE);
//ESP8266 connect to router
user_set_station_config();
}</pre></code>
总结
通过今天的介绍，大家应该已经了解了SDK的基础工作函数了，而我们的ESP8266已经可以顺利地连上路由器了，当然连上路由器仅仅是基础，关于后续的网络通讯开发我们下次再叙。
