Files
squeezelite-esp32/components/wifi-manager/network_status.h
2022-11-29 11:53:20 -05:00

61 lines
1.9 KiB
C

#pragma once
#include "network_manager.h"
#include "cJSON.h"
#ifdef __cplusplus
extern "C" {
#endif
char* network_status_alloc_get_ip_info_json();
/**
* @brief Tries to get access to json buffer mutex.
*
* The HTTP server can try to access the json to serve clients while the wifi manager thread can try
* to update it. These two tasks are synchronized through a mutex.
*
* The mutex is used by both the access point list json and the connection status json.\n
* These two resources should technically have their own mutex but we lose some flexibility to save
* on memory.
*
* This is a simple wrapper around freeRTOS function xSemaphoreTake.
*
* @param xTicksToWait The time in ticks to wait for the semaphore to become available.
* @return true in success, false otherwise.
*/
bool network_status_lock_json_buffer(TickType_t xTicksToWait);
/**
* @brief Releases the json buffer mutex.
*/
void network_status_unlock_json_buffer();
bool network_status_lock_sta_ip_string(TickType_t xTicksToWait);
void network_status_unlock_sta_ip_string();
/**
* @brief gets the string representation of the STA IP address, e.g.: "192.168.1.69"
*/
char* network_status_get_sta_ip_string();
/**
* @brief thread safe char representation of the STA IP update
*/
void network_status_safe_update_sta_ip_string(esp_ip4_addr_t * ip4);
/**
* @brief Generates the connection status json: ssid and IP addresses.
* @note This is not thread-safe and should be called only if network_status_lock_json_buffer call is successful.
*/
void network_status_update_ip_info(update_reason_code_t update_reason_code);
void init_network_status();
void destroy_network_status();
cJSON* network_status_get_basic_info(cJSON** old);
void network_status_update_basic_info();
void network_status_clear_ip();
void network_status_safe_reset_sta_ip_string();
update_reason_code_t get_last_reason_code();
char * network_status_alloc_get_system_url();
#ifdef __cplusplus
}
#endif