/*
  report.h - reporting and messaging methods

  Part of grblHAL

  Copyright (c) 2018-2026 Terje Io
  Copyright (c) 2012-2016 Sungeun K. Jeon for Gnea Research LLC

  grblHAL is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.

  grblHAL 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. See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with grblHAL. If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef _REPORT_H_
#define _REPORT_H_

#include "system.h"
#include "ngc_params.h"

typedef enum {
    SettingsFormat_MachineReadable = 0,
    SettingsFormat_HumanReadable,
    SettingsFormat_Grbl,
    SettingsFormat_grblHAL
} settings_format_t;

// Initialize reporting subsystem
void report_init (void);
void report_init_fns (void);

// Prints feedback message, typically from gcode.
void report_message (const char *msg, message_type_t type);

// Message helper to be run as foreground task.
void report_plain (void *message);

// Message helper to be run as foreground task.
void report_info (void *message);

// Message helper to be run as foreground task.
void report_warning (void *message);

// Prints grblHAL help.
status_code_t report_help (char *args);

void report_plugin (const char *name, const char *version);

// Prints grblHAL settings
void report_grbl_settings (bool all, void *data);

// Prints grblHAL setting
status_code_t report_grbl_setting (setting_id_t id, void *data);

// Prints an echo of the pre-parsed line received right before execution.
void report_echo_line_received (char *line);

// Prints realtime status report.
void report_realtime_status (stream_write_ptr stream_write, status_report_tracking_t *report);

// Prints recorded probe position.
void report_probe_parameters (void);

// Prints current tool offsets.
void report_tool_offsets (void);

#if NGC_PARAMETERS_ENABLE

// Prints NIST/LinuxCNC NGC parameter value
status_code_t report_ngc_parameter (ngc_param_id_t id);

// Prints named LinuxCNC NGC parameter value
status_code_t report_named_ngc_parameter (char *arg);

#endif

// Prints grblHAL NGC parameters (coordinate offsets, probe).
void report_ngc_parameters (void);

// Prints current g-code parser mode state.
void report_gcode_modes (stream_write_ptr stream_write);

// Prints startup line when requested and executed.
void report_startup_line (uint8_t n, char *line);
void report_execute_startup_message (char *line, status_code_t status_code);

// Prints build info and user info.
void report_build_info (char *line, bool extended);

status_code_t report_alarm_details (bool grbl_format);
status_code_t report_error_details (bool grbl_format);
status_code_t report_setting_group_details (bool by_id, char *prefix);
status_code_t report_settings_details (settings_format_t format, setting_id_t setting, setting_group_t group);
status_code_t report_setting_description (settings_format_t format, setting_id_t id);

status_code_t report_last_signals_event (sys_state_t state, char *args);
status_code_t report_current_limit_state (sys_state_t state, char *args);
status_code_t report_current_home_signal_state (sys_state_t state, char *args);

// Prints spindle data (encoder pulse and index count, angular position).
status_code_t report_spindle_data (sys_state_t state, char *args);

// Prints pin assignments.
status_code_t report_pins (sys_state_t state, char *args);

status_code_t report_pin_states (sys_state_t state, char *args);

status_code_t report_uart_ports (sys_state_t state, char *args);

// Prints registered spindles.
status_code_t report_spindles (bool machine_readable);

// Prints current stepper (motor) status.
status_code_t report_stepper_status (sys_state_t state, char *args);

// Prints current RTC datetime in ISO8601 format (when available)
status_code_t report_time (void);

// Prints current PID log.
void report_pid_log (void);

report_tracking_flags_t report_get_rt_flags_all (void);
void report_add_realtime (report_tracking_t report);

#endif