Example: Blink a LED

Like in the Arduino case one of the first thinks to try it is to blink an LED.

The following link contains the code for blink an LED.

Materials:

• ESP-01 - or other version 
• LED 
• SERIAL to USB

If you have my setup described here 

1. put the the archive into this directory

/opt/Espressif/ESP8266_SDK   

2. untar the file

tar -xvf blinky.tar

3. enter in the app directory

cd blinky

4. compile the code

make clean ; make.

5. Upload the resulting files ( from the firmware directory) to your ESP after this steps

5.1 Unplug the VCC power pin

5.2 Connect the GPIO0 pin to ground

5.3.Use the command to write the firmware

./burnESP

Anatomy of the code

 The main application file is the user_main.c file located in 

/opt/Espressif/ESP8266_SDK/blinky/user

The file content is:

#include "ets_sys.h"

#include "osapi.h"

#include "gpio.h"

#include "os_type.h"

#include "user_config.h"

#define user_procTaskPrio        0

#define user_procTaskQueueLen    1

os_event_t    user_procTaskQueue[user_procTaskQueueLen];

static void user_procTask(os_event_t *events);

static volatile os_timer_t some_timer;

void some_timerfunc(void *arg)

{

    //Do blinky stuff

    if (GPIO_REG_READ(GPIO_OUT_ADDRESS) & BIT2)

    {

        //Set GPIO2 to LOW - TURN OFF the LED

        gpio_output_set(0, BIT2, BIT2, 0);

    }

    else

    {

        //Set GPIO2 to HIGH - TURN ON the LED

        gpio_output_set(BIT2, 0, BIT2, 0);

    }

}

//Do nothing function

static void ICACHE_FLASH_ATTR  user_procTask(os_event_t *events)

{

    os_delay_us(10);

}

//Init function 

void ICACHE_FLASH_ATTR user_init()

{

    // Initialize the GPIO subsystem.

    gpio_init();

    //Set GPIO2 to output mode

    PIN_FUNC_SELECT(PERIPHS_IO_MUX_GPIO2_U, FUNC_GPIO2);

    //Set GPIO2 low

    gpio_output_set(0, BIT2, BIT2, 0);

    //Disarm timer

    os_timer_disarm(&some_timer);

    //Setup timer

    os_timer_setfn(&some_timer, (os_timer_func_t *)some_timerfunc, NULL);

    //Arm the timer, &some_timer is the pointer 1000 is the fire time in ms

    //0 for once and 1 for repeating timer

    os_timer_arm(&some_timer, 1000, 1);

    

    //Start os task

    system_os_task(user_procTask, user_procTaskPrio,user_procTaskQueue, user_procTaskQueueLen);

}

and is pretty much self explanatory.

1. Include the necessary headers. See that user_config.h is empty so if you can use this app as a skeleton for your future applications. 

2. In user_init() function the GPIO is initialized, GPIO2 is set up as an output pin and is set

to 0 (LOW, GND).

3. A timer is defined (some_timer) and initialized and the  callback function is set to be called every 1000ms (1sec) interval. 

4. Callback function some_timerfunc is doing all the stuff, if the LED is ON turn it to OFF,

otherwise turn the LED ON.

If you want to add extra functionality check this post for how to have arduino like functions

to manipulate your GPIO. 

Happy codding !!!