report.h

Go to the documentation of this file.

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