mirror of
https://github.com/Lurkars/esp-ena.git
synced 2024-11-22 10:06:11 +01:00
301 lines
7.4 KiB
C
301 lines
7.4 KiB
C
// Copyright 2020 Lukas Haubaum
|
|
//
|
|
// Licensed under the GNU Affero General Public License, Version 3;
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// https://www.gnu.org/licenses/agpl-3.0.html
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
/**
|
|
* @file
|
|
*
|
|
* @brief interface functionality via input buttons for control and setup
|
|
*
|
|
*/
|
|
#ifndef _interface_H_
|
|
#define _interface_H_
|
|
|
|
#include "driver/gpio.h"
|
|
|
|
#define INTERFACE_LOG "INTERFACE" // TAG for Logging
|
|
|
|
#define INTERFACE_FORMAT_TIME "%X"
|
|
|
|
#define INTERFACE_NUM_LOCALE 2
|
|
|
|
#define INTERFACE_IDLE_SECONDS CONFIG_ENA_INTERFACE_IDLE_TIME
|
|
|
|
#define INTERFACE_INPUT_TICKS_MS 20
|
|
#define INTERFACE_LONG_STATE_SECONDS 0.6
|
|
|
|
/**
|
|
* @brief available commands
|
|
*/
|
|
typedef enum
|
|
{
|
|
INTERFACE_COMMAND_RST = 0,
|
|
INTERFACE_COMMAND_SET,
|
|
INTERFACE_COMMAND_MID,
|
|
INTERFACE_COMMAND_RHT,
|
|
INTERFACE_COMMAND_LFT,
|
|
INTERFACE_COMMAND_DWN,
|
|
INTERFACE_COMMAND_UP,
|
|
INTERFACE_COMMAND_RST_LONG,
|
|
INTERFACE_COMMAND_SET_LONG,
|
|
INTERFACE_COMMANDS_SIZE,
|
|
} interface_command_t;
|
|
|
|
/**
|
|
* @brief available locales
|
|
*/
|
|
typedef enum
|
|
{
|
|
EN = 0,
|
|
DE,
|
|
} interface_locale_t;
|
|
|
|
typedef struct
|
|
{
|
|
|
|
char *text[INTERFACE_NUM_LOCALE];
|
|
|
|
} interface_label_t;
|
|
|
|
// label variables
|
|
interface_label_t interface_text_button_cancel;
|
|
interface_label_t interface_text_button_ok;
|
|
interface_label_t interface_text_button_back;
|
|
interface_label_t interface_text_button_menu;
|
|
interface_label_t interface_text_button_report;
|
|
|
|
interface_label_t interface_text_headline_tan;
|
|
interface_label_t interface_text_headline_report;
|
|
interface_label_t interface_text_headline_wifi;
|
|
interface_label_t interface_text_headline_time;
|
|
interface_label_t interface_text_headline_data;
|
|
interface_label_t interface_text_headline_settings;
|
|
interface_label_t interface_text_headline_info;
|
|
interface_label_t interface_text_headline_debug;
|
|
|
|
interface_label_t interface_text_settings_locale;
|
|
interface_label_t interface_text_settings_locales[INTERFACE_NUM_LOCALE];
|
|
interface_label_t interface_text_settings_timezone;
|
|
|
|
interface_label_t interface_text_info_num_keys;
|
|
interface_label_t interface_text_info_last_keys;
|
|
interface_label_t interface_text_info_exp_update;
|
|
interface_label_t interface_text_info_exp_days;
|
|
interface_label_t interface_text_info_exp_num;
|
|
interface_label_t interface_text_info_exp_max;
|
|
interface_label_t interface_text_info_exp_sum;
|
|
interface_label_t interface_text_info_scan_status_scanning;
|
|
interface_label_t interface_text_info_scan_status_notscanning;
|
|
interface_label_t interface_text_info_scan_status_waiting;
|
|
interface_label_t interface_text_info_scan_last;
|
|
|
|
interface_label_t interface_text_report_pending;
|
|
interface_label_t interface_text_report_success;
|
|
interface_label_t interface_text_report_fail;
|
|
|
|
interface_label_t interface_text_wifi_waiting;
|
|
interface_label_t interface_text_wifi_scanning;
|
|
interface_label_t interface_text_wifi_connecting;
|
|
interface_label_t interface_text_wifi_nothing;
|
|
|
|
interface_label_t interface_text_data_del[6];
|
|
|
|
interface_label_t interface_texts_weekday[7];
|
|
|
|
interface_label_t interface_texts_month[12];
|
|
|
|
/**
|
|
* @brief callback function for command input (button press)
|
|
*/
|
|
typedef void (*interface_command_callback)(void);
|
|
|
|
/**
|
|
* @brief current display function
|
|
*/
|
|
typedef void (*interface_display_function)(void);
|
|
|
|
/**
|
|
* @brief callback function for text_input
|
|
*
|
|
* @param[in] text the text from input
|
|
* @param[in] cursor current cursor position
|
|
*/
|
|
typedef void (*interface_text_callback)(char *text, uint8_t cursor);
|
|
|
|
|
|
/**
|
|
* @brief start input routine
|
|
*
|
|
* MUST BE DEFINED DEVICE SPECIFIC
|
|
*
|
|
*/
|
|
void interface_input_start(void);
|
|
|
|
|
|
/**
|
|
* @brief is interface in idle mode
|
|
*
|
|
* @return if interface is idle
|
|
*/
|
|
bool interface_is_idle(void);
|
|
|
|
/**
|
|
* @brief init label
|
|
*/
|
|
void interface_init_label(void);
|
|
|
|
/**
|
|
* @brief get text from label for set locale
|
|
*
|
|
* @param[in] label the label to get the text from
|
|
*/
|
|
char *interface_get_label_text(interface_label_t *label);
|
|
|
|
/**
|
|
* @brief get locale for interface
|
|
*
|
|
* @return
|
|
* interface_locale_t current locale
|
|
*/
|
|
interface_locale_t interface_get_locale(void);
|
|
|
|
/**
|
|
* @brief set locale for interface
|
|
*
|
|
* @param[in] locale the locale to set
|
|
*/
|
|
void interface_set_locale(interface_locale_t locale);
|
|
|
|
/**
|
|
* @brief get timezone offset for interface
|
|
*
|
|
* @return
|
|
* int current timezone offset
|
|
*/
|
|
int interface_get_timezone_offset(void);
|
|
|
|
/**
|
|
* @brief set timezone offset for interface
|
|
*
|
|
* @param[in] timezone_offset the timezone offset to set
|
|
*/
|
|
void interface_set_timezone_offset(int timezone_offset);
|
|
|
|
/**
|
|
* @brief register a callback function for command event
|
|
*
|
|
* @param[in] command id of the command to listen to
|
|
* @param[in] callback callback function
|
|
*/
|
|
void interface_register_command_callback(interface_command_t command, interface_command_callback callback);
|
|
|
|
/**
|
|
* @brief set if command is trigger
|
|
*
|
|
* @param[in] command id of the command to set as trigger
|
|
*/
|
|
void interface_command_callback_set_trigger(interface_command_t command);
|
|
|
|
/**
|
|
* @brief execute a command
|
|
*
|
|
* @param[in] command id of the command to trigger
|
|
*/
|
|
void interface_execute_command(interface_command_t command);
|
|
|
|
/**
|
|
* @brief execute a command as trigger
|
|
*
|
|
* @param[in] command id of the command to trigger
|
|
*/
|
|
void interface_execute_command_trigger(interface_command_t command);
|
|
|
|
/**
|
|
* @brief set the display function
|
|
*
|
|
* @param[in] display_function display function
|
|
*/
|
|
void interface_set_display_function(interface_display_function display_function);
|
|
|
|
/**
|
|
* @brief set the display refresh function
|
|
*
|
|
* @param[in] display_function display function
|
|
*/
|
|
void interface_set_display_refresh_function(interface_display_function display_function);
|
|
|
|
/**
|
|
* @brief start interface logic
|
|
*
|
|
* This will initialize the controls and start a task to listen to button inputs and calling the callbacks.
|
|
*/
|
|
void interface_start(void);
|
|
|
|
/**
|
|
* @brief set interface flipped or not
|
|
*
|
|
* @param[in] on true interface is flipped
|
|
*/
|
|
void interface_flipped(bool flipped);
|
|
|
|
/**
|
|
* @brief start delete data interface
|
|
*/
|
|
void interface_data_start(void);
|
|
|
|
/**
|
|
* @brief start datetime interface
|
|
*/
|
|
void interface_datetime_start(void);
|
|
|
|
/**
|
|
* @brief start main interface
|
|
*/
|
|
void interface_main_start(void);
|
|
|
|
/**
|
|
* @brief start report interface
|
|
*/
|
|
void interface_report_start(void);
|
|
|
|
/**
|
|
* @brief start wifi interface
|
|
*/
|
|
void interface_wifi_start(void);
|
|
|
|
/**
|
|
* @brief start settings interface
|
|
*/
|
|
void interface_settings_start(void);
|
|
|
|
/**
|
|
* @brief start info interface
|
|
*/
|
|
void interface_info_start(void);
|
|
|
|
/**
|
|
* @brief start interface for input
|
|
*
|
|
* @param[in] callback_rst function to call on RST
|
|
* @param[in] callback_set function to call on SET
|
|
* @param[in] limit max character allowed (0=255)
|
|
*/
|
|
void interface_input(interface_text_callback callback_rst, interface_text_callback callback_set, uint8_t limit);
|
|
|
|
/**
|
|
* @brief set text for input interface
|
|
*
|
|
* @param[in] text the text to set
|
|
*/
|
|
void interface_input_set_text(char *text);
|
|
|
|
#endif |