alarms.h

Go to the documentation of this file.

/*
  alarms.h -
 
  Part of grblHAL
 
  Copyright (c) 2017-2025 Terje Io
  Copyright (c) 2011-2016 Sungeun K. Jeon for Gnea Research LLC
  Copyright (c) 2009-2011 Simen Svale Skogsrud
 
  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 _ALARMS_H_
#define _ALARMS_H_
 
// Alarm codes. Valid values (1-255). Zero is reserved.
// Code 0 - 9 is equal to legacy Grbl codes, 15 equals to legacy Grbl code 10
typedef enum {
    Alarm_None = 0,                             
    Alarm_HardLimit = 1,                        
    Alarm_SoftLimit = 2,                        
    Alarm_AbortCycle = 3,                       
    Alarm_ProbeFailInitial = 4,                 
    Alarm_ProbeFailContact = 5,                 
    Alarm_HomingFailReset = 6,                  
    Alarm_HomingFailDoor = 7,                   
    Alarm_FailPulloff = 8,                      
    Alarm_HomingFailApproach = 9,               
    Alarm_EStop = 10,                           
    Alarm_HomingRequired = 11,                  
    Alarm_LimitsEngaged = 12,                   
    Alarm_ProbeProtect = 13,                    
    Alarm_Spindle = 14,                         
    Alarm_HomingFailAutoSquaringApproach = 15,  
    Alarm_SelftestFailed = 16,                  
    Alarm_MotorFault = 17,                      
    Alarm_HomingFail = 18,                      
    Alarm_ModbusException = 19,                 
    Alarm_ExpanderException = 20,               
    Alarm_NVS_Failed = 21,                      
    Alarm_AlarmMax = Alarm_NVS_Failed
} __attribute__ ((__packed__)) alarm_code_t;
 
typedef struct {
    alarm_code_t id;
    const char *description;
} alarm_detail_t;
 
typedef struct alarm_details {
    const uint16_t n_alarms;
    const alarm_detail_t *alarms;
    struct alarm_details *next;
} alarm_details_t;
 
typedef alarm_details_t *(*on_get_alarms_ptr)(void);
 
alarm_details_t *alarms_get_details (void);
const char *alarms_get_description (alarm_code_t id);
void alarms_register (alarm_details_t *details);
 
static inline bool alarm_is_critical (alarm_code_t alarm)
{
    return alarm == Alarm_HardLimit ||
            alarm == Alarm_SoftLimit ||
             alarm == Alarm_EStop ||
              alarm == Alarm_MotorFault ||
               alarm == Alarm_ExpanderException;
}
 
#endif