// 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