The button library provides convenience functions to interact with the virtual buttons drawn over specified areas of the front of the device. There are three virtual buttons aligned to the circles etched on the front of the Core2 for AWS IoT Kit reference hardware.

To enable this feature using KConfig, use the command pio run --environment core2foraws --target menuconfig from within the root of the project directory in your PlatformIO terminal window and go to the menu Component Config --> Core2 for AWS features to set the features you want to enable.

Example

The following example initializes the Core2 for AWS, which initializes the PMU for the battery and other user enabled hardware features — such as the FT6336U and virtual touch buttons. It then creates a FreeRTOS task of priority 1 that prints "MIDDLE PRESSED!" using the ESP logger if the middle button touch is pressed.

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
 
#include "esp_log.h"
#include "core2forAWS.h"
 
static const char *TAG = "EXAMPLE";
 
static void button_task(void* pvParameters){
    for(;;){
        if (Button_WasPressed(button_middle)) {
            ESP_LOGI(TAG, "MIDDLE PRESSED!");
        }
    
        vTaskDelay(pdMS_TO_TICKS(80));
    }
    vTaskDelete(NULL); // Should never get to here...
}
 
void app_main(void){
    Core2ForAWS_Init();
 
    xTaskCreatePinnedToCore(button_task, "buttonTask", configMINIMAL_STACK_SIZE * 3, NULL, 1, NULL, 1);     
}

Example

Enumerated Type Definitions

Structs

Variables

Functions