#ifndef NR_ANTENNA_CONTROL_H
#define NR_ANTENNA_CONTROL_H

#include "nr_antenna_state.h"
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

/// Default port for the test socket server (development mode only)
#define NR_ANTENNA_CONTROL_TEST_PORT 9999

/**
 * @brief Antenna control backend type
 */
typedef enum {
  ANTENNA_CTRL_BACKEND_NONE = 0,      ///< No external control
  ANTENNA_CTRL_BACKEND_MPLANE,        ///< O-RAN M-Plane NETCONF (production)
  ANTENNA_CTRL_BACKEND_TEST_SOCKET    ///< Test socket interface (development)
} nr_antenna_ctrl_backend_t;

/**
 * @brief Initialize antenna control with O-RAN M-Plane NETCONF backend
 * 
 * This is the O-RAN compliant production interface. It connects the
 * antenna state to a real NETCONF session to an O-RU.
 * 
 * When antenna masks are changed via nr_set_tx_antenna_bitmask() or
 * similar functions, the changes are automatically propagated to the
 * RU via NETCONF edit-config operations.
 * 
 * @param ant_state Pointer to the antenna state to control
 * @param ru_session Active M-Plane NETCONF session (from radio/fhi_72/mplane/)
 * @return true if initialization successful
 */
bool nr_antenna_control_init_mplane(nr_antenna_state_t *ant_state, 
                                     void *ru_session);

/**
 * @brief Start the test socket server (development mode only)
 * 
 * Creates a simple TCP server for testing antenna control without
 * NETCONF infrastructure. This is NOT O-RAN compliant.
 * 
 * Commands supported (for backwards compatibility):
 *   MUTE TX <ant_id>      - Mute TX antenna
 *   UNMUTE TX <ant_id>    - Unmute TX antenna
 *   MUTE RX <ant_id>      - Mute RX antenna
 *   UNMUTE RX <ant_id>    - Unmute RX antenna
 *   SET TX MASK <hex>     - Set TX antenna bitmask
 *   SET RX MASK <hex>     - Set RX antenna bitmask
 *   STATUS                - Get current antenna state
 *   STATS                 - Get energy saving statistics
 *   RESET STATS           - Reset statistics
 *   QUIT                  - Close connection
 * 
 * @param ant_state Pointer to the antenna state to control
 * @param port TCP port to listen on (use 0 for default)
 * @return true if server started successfully
 * 
 * @note This function logs a warning that it's not O-RAN compliant
 */
bool nr_antenna_control_start_test_server(nr_antenna_state_t *ant_state, int port);

/**
 * @brief Legacy function - start antenna control server
 * 
 * @deprecated Use nr_antenna_control_init_mplane() for O-RAN compliance
 *             or nr_antenna_control_start_test_server() for testing.
 * 
 * This function starts the test socket server for backwards compatibility.
 * It logs a deprecation warning.
 */
bool nr_antenna_control_start(nr_antenna_state_t *ant_state, int port);

/**
 * @brief Stop the antenna control interface
 * 
 * Stops the test socket server if running.
 * For M-Plane backend, this disconnects from NETCONF notifications.
 */
void nr_antenna_control_stop(void);

/**
 * @brief Check if antenna control is active
 * @return true if control interface is running
 */
bool nr_antenna_control_is_running(void);

/**
 * @brief Get current antenna control backend type
 * @return Backend type currently in use
 */
nr_antenna_ctrl_backend_t nr_antenna_control_get_backend(void);

/**
 * @brief Synchronize local antenna state to RU via M-Plane NETCONF
 * 
 * Sends the current antenna bitmask configuration to the RU.
 * Only applicable when using the M-Plane NETCONF backend.
 * 
 * @param ant_state Pointer to the antenna state
 * @return true if synchronization successful or not applicable
 */
bool nr_antenna_control_sync_to_ru(nr_antenna_state_t *ant_state);

/**
 * @brief Synchronize RU antenna state to local via M-Plane NETCONF
 * 
 * Reads the current antenna bitmask from the RU and updates local state.
 * Only applicable when using the M-Plane NETCONF backend.
 * 
 * @param ant_state Pointer to the antenna state
 * @return true if synchronization successful or not applicable
 */
bool nr_antenna_control_sync_from_ru(nr_antenna_state_t *ant_state);

#ifdef __cplusplus
}
#endif

#endif /* NR_ANTENNA_CONTROL_H */