Add GPIO config, interrupt registers, GPIO interrupt support, 'button' example

examples/button/FreeRTOSConfig.h

@@ -0,0 +1,127 @@
+/*
+    FreeRTOS V7.5.2 - Copyright (C) 2013 Real Time Engineers Ltd.
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that has become a de facto standard.             *
+     *                                                                       *
+     *    Help yourself get started quickly and support the FreeRTOS         *
+     *    project by purchasing a FreeRTOS tutorial book, reference          *
+     *    manual, or both from: http://www.FreeRTOS.org/Documentation        *
+     *                                                                       *
+     *    Thank you!                                                         *
+     *                                                                       *
+    ***************************************************************************
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.
+
+    >>! NOTE: The modification to the GPL is included to allow you to distribute
+    >>! a combined work that includes FreeRTOS without being obliged to provide
+    >>! the source code for proprietary components outside of the FreeRTOS
+    >>! kernel.
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available from the following
+    link: http://www.freertos.org/a00114.html
+
+    1 tab == 4 spaces!
+
+    ***************************************************************************
+     *                                                                       *
+     *    Having a problem?  Start by reading the FAQ "My application does   *
+     *    not run, what could be wrong?"                                     *
+     *                                                                       *
+     *    http://www.FreeRTOS.org/FAQHelp.html                               *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org - Documentation, books, training, latest versions,
+    license and Real Time Engineers Ltd. contact details.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High
+    Integrity Systems to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+#ifndef FREERTOS_CONFIG_H
+#define FREERTOS_CONFIG_H
+
+/*-----------------------------------------------------------
+ * Application specific definitions.
+ *
+ * These definitions should be adjusted for your particular hardware and
+ * application requirements.
+ *
+ * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
+ * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE. 
+ *
+ * See http://www.freertos.org/a00110.html.
+ *----------------------------------------------------------*/
+
+#define configUSE_PREEMPTION		1
+#define configUSE_IDLE_HOOK			0
+#define configUSE_TICK_HOOK			0
+#define configCPU_CLOCK_HZ			( ( unsigned long ) 80000000 )
+#define configTICK_RATE_HZ			( ( portTickType ) 100 )
+#define configMAX_PRIORITIES		( ( unsigned portBASE_TYPE ) 15 )
+#define configMINIMAL_STACK_SIZE	( ( unsigned short )156 )
+#define configTOTAL_HEAP_SIZE		( ( size_t ) ( 32 * 1024 ) )
+#define configMAX_TASK_NAME_LEN		( 16 )
+#define configUSE_TRACE_FACILITY	0
+#define configUSE_STATS_FORMATTING_FUNCTIONS 0
+#define configUSE_16_BIT_TICKS		0
+#define configIDLE_SHOULD_YIELD		1
+
+#define INCLUDE_xTaskGetIdleTaskHandle 1
+#define INCLUDE_xTimerGetTimerDaemonTaskHandle 1
+
+#define configCHECK_FOR_STACK_OVERFLOW  2
+#define configUSE_MUTEXES  1
+#define configUSE_TIMERS    1
+
+#if configUSE_TIMERS
+#define configTIMER_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
+#define configTIMER_QUEUE_LENGTH (10)
+#define configTIMER_TASK_STACK_DEPTH  ( ( unsigned short ) 512 )
+#endif
+
+/* Co-routine definitions. */
+#define configUSE_CO_ROUTINES 		0
+#define configMAX_CO_ROUTINE_PRIORITIES ( 2 )
+
+/* Set the following definitions to 1 to include the API function, or zero
+to exclude the API function. */
+
+#define INCLUDE_vTaskPrioritySet		1
+#define INCLUDE_uxTaskPriorityGet		1
+#define INCLUDE_vTaskDelete				1
+#define INCLUDE_vTaskCleanUpResources	0
+#define INCLUDE_vTaskSuspend			1
+#define INCLUDE_vTaskDelayUntil			1
+#define INCLUDE_vTaskDelay				1
+
+/*set the #define for debug info*/
+#define INCLUDE_xTaskGetCurrentTaskHandle 1
+#define INCLUDE_uxTaskGetStackHighWaterMark 1
+
+#endif /* FREERTOS_CONFIG_H */
+

examples/button/Makefile

@@ -0,0 +1,2 @@
+TARGET=button
+include ../../common.mk

examples/button/button.c

@@ -0,0 +1,84 @@
+/* Respond to a button press.
+ *
+ * This code combines two ways of checking for a button press -
+ * busy polling (the bad way) and button interrupt (the good way).
+ *
+ * This sample code is in the public domain.
+ */
+#include "espressif/esp_common.h"
+#include "espressif/sdk_private.h"
+#include "FreeRTOS.h"
+#include "task.h"
+#include "queue.h"
+#include "esp8266.h"
+
+/* pin config */
+const int gpio = 0;   /* gpio 0 usually has "PROGRAM" button attached */
+const int active = 0; /* active == 0 for active low */
+const gpio_interrupt_t int_type = INT_FALLING;
+#define GPIO_HANDLER gpio00_interrupt_handler
+
+
+/* This task polls for the button and prints the tick
+   count when it's seen.
+
+   Debounced to 200ms with a simple vTaskDelay.
+
+   This is not a good example of how to wait for button input!
+*/
+void buttonPollTask(void *pvParameters)
+{
+    printf("Polling for button press on gpio %d...\r\n", gpio);
+    while(1) {
+	while(gpio_read(gpio) != active)
+	{
+	    taskYIELD();
+	}
+	printf("Polled for button press at %dms\r\n", xTaskGetTickCount()*portTICK_RATE_MS);
+	vTaskDelay(200 / portTICK_RATE_MS);
+    }
+}
+
+/* This task configures the GPIO interrupt and uses it to tell
+   when the button is pressed.
+
+   The interrupt handler communicates the exact button press time to
+   the task via a queue.
+
+   This is a better example of how to wait for button input!
+*/
+void buttonIntTask(void *pvParameters)
+{
+    printf("Waiting for button press interrupt on gpio %d...\r\n", gpio);
+    xQueueHandle *tsqueue = (xQueueHandle *)pvParameters;
+    gpio_set_interrupt(gpio, int_type);
+
+    uint32_t last = 0;
+    while(1) {
+	uint32_t button_ts;
+	xQueueReceive(*tsqueue, &button_ts, portMAX_DELAY);
+	button_ts *= portTICK_RATE_MS;
+	if(last < button_ts-200) {
+	    printf("Button interrupt fired at %dms\r\n", button_ts);
+	    last = button_ts;
+	}
+    }
+}
+
+static xQueueHandle tsqueue;
+
+void GPIO_HANDLER(void)
+{
+    uint32_t now = xTaskGetTickCountFromISR();
+    xQueueSendToBackFromISR(tsqueue, &now, NULL);
+}
+
+void user_init(void)
+{
+    sdk_uart_div_modify(0, UART_CLK_FREQ / 115200);
+    gpio_enable(gpio, GPIO_INPUT);
+
+    tsqueue = xQueueCreate(2, sizeof(uint32_t));
+    xTaskCreate(buttonIntTask, (signed char *)"buttonIntTask", 256, &tsqueue, 2, NULL);
+    xTaskCreate(buttonPollTask, (signed char*)"buttonPollTask", 256, NULL, 1, NULL);
+}