【小e1开发板试用体验】分析程序一用户代码入口user_init函数分析

       至于最终需要的是哪个文件，我们在esp_common.h文件中看到这样的包含语句：
#include "et_types.h"
#include "c_types.h"
#include "esp_libc.h"
#include "esp_misc.h"
#include "esp_wifi.h"
#include "esp_softap.h"
#include "esp_sta.h"
#include "esp_system.h"
#include "esp_timer.h"
#include "esp_ssc.h"
#include "esp_spiffs.h"
#include "esp8266/esp8266.h"
#include "smartconfig.h"
#include "spi_flash.h"
        说明这里使用的文件是esp_libc.h，那os_printf函数的定义如下：
/* NOTE: don't use printf_opt in irq handler, for test */
#define os_printf(fmt, ...) do {   
        static const char flash_str[] ICACHE_RODATA_ATTR STORE_ATTR = fmt;  
        printf(flash_str, ##__VA_ARGS__);   
    } while(0)
     其中ICACHE_RODATA_ATTR定义如下：
#define ICACHE_RODATA_ATTR  __attribute__((section(".irom.text")))
       那么 这里flash_str这个数组就只是一个存储在.irom.text（代码区）的一个特殊数组，那么这个函数的第一句话就是把打印格式本分到.irom.text区，最终的flash_str=fmt，
      有意思的是printf(flash_str, ##__VA_ARGS__); 这句话，flash_str=fmt，所以printf(flash_str, ##__VA_ARGS__);就是printf(fmt, ##__VA_ARGS__);而__VA_ARGS__= ...，关于__VA_ARGS__请看http://blog.sina.com.cn/s/blog_661314940100qmfg.html
      那到这里就可以知道 os_printf(fmt, ...)等同于 printf(fmt, ...)，只是多了一个备份格式的操作而已，另外那既然printf函数是打印到串口的，那么必定要重写int fputc(int ch, FILE *f)函数，但是在source insight中怎么到找不到这个函数的定义，那么 fputc函数只能够藏在一个地方：shareSDKlib下面的.a文件中，这个是唯一一个有可能再次有代码的地方，逼不得已呀，这里直接把shareSDKlib里的所有.a文件的API（函数）给打印出来，如下：
esp8266@esp8266-VirtualBox:~$ cd ~/Share/SDK/lib
esp8266@esp8266-VirtualBox:~/Share/SDK/lib$ ls
libairkiss.a  libfac.a       libmesh.a      libpp.a           libwpa.a
libcirom.a    libfreertos.a  libminic.a     libpwm.a          libwps.a
libcrypto.a   libgcc.a       libmirom.a     libsmartconfig.a
libespconn.a  libjson.a      libnet80211.a  libspiffs.a
libespnow.a   liblwip.a      libnopoll.a    libssc.a
libetilink.a  libmain.a      libphy.a       libssl.a
esp8266@esp8266-VirtualBox:~/Share/SDK/lib$ nm *.a

libairkiss.a:

airkiss.o:
0000060c T airkiss_change_channel
00000000 t __airkiss_crc8
00000598 T airkiss_get_result
00000028 T airkiss_init
0000007c T airkiss_recv
00000020 T airkiss_version
00000018 r CRC8_ARRAY
.................................................................................
          这里的打印信息太多，保存到如下文件：

库文件函数说明.zip (58.17 KB, 下载次数: 19 )

           这个压缩包里面的《库文件函数说明.txt》就是所有的库函数信息
            这里我们可以查到fputc函数：
lib_a-fputc.o:
00000034 T fputc
00000000 T _fputc_r
         U _impure_ptr
         U _putc_r
         U __sinit
          说明fputc函数确实被定义了，只不过被封了起来而已！
        继续分析user_init函数：
    if(get_fac_norm_mode(&result) != SPI_FLASH_RESULT_OK)
    {
        os_printf("get_fac_norm_mode error, NORMAL moden");
    }
   
    if(result == FAC_MODE)
    {
        os_printf("run in factory moden");
        uart_init_new_uart1(BIT_RATE_115200);
        UART_SetPrintPort(UART1);
        uart_init_new(BIT_RATE_115200, result);
        return;
    }
  os_printf("run in normal moden");
     这里先从flash获取现在的运行模型，如果运行模型是出厂模式，result == FAC_MODE那么到这里之后设置完波特率就会退出程序。下来：
//if define IR_DEMO, ir rx or tx test
#ifdef IR_DEMO
    struct station_config config;
   
    memset(&config, 0, sizeof(config));
    wifi_set_opmode(STATION_MODE);
    wifi_station_set_config_current(&config);
   
//if define IR_RX, ir rx test
#ifdef IR_RX            
    ir_rx_init();

  //ir tx test
#else                     
    ir_tx_init(0);
    xTaskCreate(ir_tx_key, "ir_tx_key", 256, NULL, 2, NULL);
#endif

#else  
   如果当前的例程是IR_DEMO红外例程，将调用上面的程序，这里首先设置WiFi为station模型，然后如果定义IR_RX 红外接收模型，这里将会调用 ir_tx_init函数来初始化红外接收功能，如果没有定义为接受模型就会调用 ir_tx_init函数来初始化红外发送功能，不管是接收还是发送都会调用xTaskCreate来创建一个任务，这里我们分析上面提到的这三个函数, ir_rx_init:
ring_buf_init(&ir_rx_ring_buf, ir_rx_buf, sizeof(ir_rx_buf));
ir_rx_gpio_init();
xTaskCreate(ir_rx_task, "ir_rx_task", 256, NULL, 2, NULL);
     函数ring_buf_init初始化ir_rx_ring_buf这个缓存结构体，如下：
typedef struct
{
    et_uint8 * p_o;                /**< Original pointer */
    et_uint8 * volatile p_r;        /**< Read pointer */
    et_uint8 * volatile p_w;        /**< Write pointer */
    volatile et_int32 fill_cnt;    /**< Number of filled slots */
    et_int32    size;                /**< Buffer size */
}ring_buf_t;
    函数ir_rx_gpio_init就是初始化接收红外的关键：
LOCAL void ir_rx_gpio_init()
{
    //Select pin as gpio
    PIN_FUNC_SELECT(IR_GPIO_IN_MUX, IR_GPIO_IN_FUNC);
    //set GPIO as input
    GPIO_DIS_OUTPUT(IR_GPIO_IN_NUM);
    PIN_PULLUP_DIS(IR_GPIO_IN_MUX);
    //clear interrupt status
    GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(IR_GPIO_IN_NUM));
    //set negitive edge interrupt
    gpio_pin_intr_state_set(IR_GPIO_IN_NUM, GPIO_PIN_INTR_NEGEDGE);
    //register interrupt handler
    ETS_GPIO_INTR_ATTACH(ir_rx_intr_handler, NULL);
    //enable gpio interrupt
    ETS_GPIO_INTR_ENABLE();
}
    其中LOCAL代表static，这个函数的功能是初始化gpio5这个IO口，并且使能该IO口的中断。函数ir_rx_init的最后内容是创建一个任务名是"ir_rx_task"回调函数是ir_rx_task，任务缓存区是256，任务优先级是2，这里让我们看看这个任务回调函数：
void ir_rx_task(void *pvParameters)
{
    et_uint8 ir_data;

    while(1)
    {
        if(ir_rx_ring_buf.fill_cnt > 0)
        {
            ring_buf_get(&ir_rx_ring_buf, &ir_data, 1);
            os_printf("ir_data = %02xhn", ir_data);
        }
        delay_ms(500);
    }
}
     注意这里的任务回调函数是一个死循环，不会退出，那任务的调度就交给了操作系统，这里的回调函数的主要内容就是判断是否红外有接收到数据，然后通过串口打印出来，但是至于这个接收的数据的填充工作就应该在gpio5这个管脚中断上了， 这里我们看看这个管脚的中断：
LOCAL void ir_rx_intr_handler(void *para)
{
    et_int32  status;

    status = GPIO_REG_READ(GPIO_STATUS_ADDRESS);
    if((status >> IR_GPIO_IN_NUM) & BIT0)
    {
        ir_intr_handler();
    }
    else
    {
        os_printf("gpio num mismachedn");
        GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, status);
    }
}其中 ir_intr_handler函数经历了一些列的时序判断调用了这个语句：
ring_buf_put(&ir_rx_ring_buf, (ir_cmd >> 16) & 0xff);
这里吧数据填充到ir_rx_ring_buf数组中
   再回到user_init函数继续往下分析，如果不是红外接收模式，那就是红外发送模式，红外发送模式下调用ir_tx_init函数来初始化红外发送：
void ir_tx_init(et_uint8 req)
{
    hw_timer_init(req);
       hw_timer_set_func(ir_tx_handler);
}因为产生红外通许波形需要一个定时器，所以这里初始化一个定时器，这里传送的参数是0，所以这里的定时器初始化如下：RTC_REG_WRITE(FRC1_CTRL_ADDRESS,  FRC1_ENABLE_TIMER | DIVDED_BY_16 | TM_EDGE_INT);没有自动重装载的功能，所以定时器中断的时候必须要重装定时器数据，这也达到了产生不一样的占空比的功能。这里还注册了定时器中断处理函数ir_tx_handler，在这个函数主要的功能就是参数红外波形，这个叫做NEC时序的东西。因为红外发送口在GPIO14，和很多模块共用，所以这里我们看关键的一句WRITE_PERI_REG(IR_GPIO_OUT_MUX, (READ_PERI_REG(IR_GPIO_OUT_MUX)&0xfffffe0f)| (0x1<<4) );（在gen_carrier_clk函数中），这里我们知道他操作了红外发射管脚。红外发射程序的最后一步是设置一个任务名为"ir_tx_key"，回调函数是ir_tx_key，缓存也是256，优先等级为2.
      上面所有关于红外的内容本例程都没有使用到，这里我们继续分析要使用的例程，接下来的内容如下：
    key_gpio_t key;
    struct station_config config;
    struct ip_info info;
   
    // show logo
    user_show_logo();     //通过OLED显示logo
    这里除了定义唯一有用的语句就是 user_show_logo,该函数如下：
user_show_logo()
{   
    extern et_uchar BMP1[];
    et_uint32 len = 1024;    // BMP1 member
   
    i2c_master_gpio_init(); // I2C init
    OLED_init();             // OLED init
    OLED_clear();

    // show logo
    OLED_show_bmp(0, 0, 128, 8, BMP1, len);
}
    这里初始化了OLED_init，然后清屏，最后显示logoOLED_show_bmp(0, 0, 128, 8, BMP1, len);