/*-
|
* Copyright (c) 2012-2013 Jan Breuer,
|
*
|
* All Rights Reserved
|
*
|
* Redistribution and use in source and binary forms, with or without
|
* modification, are permitted provided that the following conditions are
|
* met:
|
* 1. Redistributions of source code must retain the above copyright notice,
|
* this list of conditions and the following disclaimer.
|
* 2. Redistributions in binary form must reproduce the above copyright
|
* notice, this list of conditions and the following disclaimer in the
|
* documentation and/or other materials provided with the distribution.
|
*
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
* DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
|
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
|
* IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
*/
|
|
/**
|
* @file scpi_error.h
|
* @date Thu Nov 15 10:58:45 UTC 2012
|
*
|
* @brief Error handling and storing routines
|
*
|
*
|
*/
|
|
#ifndef SCPI_ERROR_H
|
#define SCPI_ERROR_H
|
|
#include "scpi/config.h"
|
#include "scpi/types.h"
|
|
#ifdef __cplusplus
|
extern "C" {
|
#endif
|
|
void SCPI_ErrorInit(scpi_t * context, scpi_error_t * data, int16_t size);
|
void SCPI_ErrorClear(scpi_t * context);
|
scpi_bool_t SCPI_ErrorPopEx(scpi_t * context, scpi_error_t * error);
|
int16_t SCPI_ErrorPop(scpi_t * context);
|
void SCPI_ErrorPushEx(scpi_t * context, int16_t err, char * info);
|
void SCPI_ErrorPush(scpi_t * context, int16_t err);
|
int32_t SCPI_ErrorCount(scpi_t * context);
|
const char * SCPI_ErrorTranslate(int16_t err);
|
|
|
/* Using X-Macro technique to define everything once
|
* http://en.wikipedia.org/wiki/X_Macro
|
*
|
* X macro is for minimal set of errors for library itself
|
* XE macro is for full set of SCPI errors available to user application
|
*/
|
#define LIST_OF_ERRORS \
|
XE(SCPI_ERROR_COMMAND, -100, "Command error") \
|
X(SCPI_ERROR_INVALID_CHARACTER, -101, "Invalid character") \
|
XE(SCPI_ERROR_SYNTAX, -102, "Syntax error") \
|
X(SCPI_ERROR_INVALID_SEPARATOR, -103, "Invalid separator") \
|
X(SCPI_ERROR_DATA_TYPE_ERROR, -104, "Data type error") \
|
XE(SCPI_ERROR_GET_NOT_ALLOWED, -105, "GET not allowed") \
|
X(SCPI_ERROR_PARAMETER_NOT_ALLOWED, -108, "Parameter not allowed") \
|
X(SCPI_ERROR_MISSING_PARAMETER, -109, "Missing parameter") \
|
XE(SCPI_ERROR_COMMAND_HEADER, -110, "Command header error") \
|
XE(SCPI_ERROR_HEADER_SEPARATOR, -111, "Header separator error") \
|
XE(SCPI_ERROR_PRG_MNEMONIC_TOO_LONG, -112, "Program mnemonic too long") \
|
X(SCPI_ERROR_UNDEFINED_HEADER, -113, "Undefined header") \
|
XE(SCPI_ERROR_HEADER_SUFFIX_OUTOFRANGE, -114, "Header suffix out of range") \
|
XE(SCPI_ERROR_UNEXP_NUM_OF_PARAMETER, -115, "Unexpected number of parameters") \
|
XE(SCPI_ERROR_NUMERIC_DATA_ERROR, -120, "Numeric data error") \
|
XE(SCPI_ERROR_INVAL_CHAR_IN_NUMBER, -121, "Invalid character in number") \
|
XE(SCPI_ERROR_EXPONENT_TOO_LONG, -123, "Exponent too large") \
|
XE(SCPI_ERROR_TOO_MANY_DIGITS, -124, "Too many digits") \
|
XE(SCPI_ERROR_NUMERIC_DATA_NOT_ALLOWED, -128, "Numeric data not allowed") \
|
XE(SCPI_ERROR_SUFFIX_ERROR, -130, "Suffix error") \
|
X(SCPI_ERROR_INVALID_SUFFIX, -131, "Invalid suffix") \
|
XE(SCPI_ERROR_SUFFIX_TOO_LONG, -134, "Suffix too long") \
|
X(SCPI_ERROR_SUFFIX_NOT_ALLOWED, -138, "Suffix not allowed") \
|
XE(SCPI_ERROR_CHARACTER_DATA_ERROR, -140, "Character data error") \
|
XE(SCPI_ERROR_INVAL_CHARACTER_DATA, -141, "Invalid character data") \
|
XE(SCPI_ERROR_CHARACTER_DATA_TOO_LONG, -144, "Character data too long") \
|
XE(SCPI_ERROR_CHARACTER_DATA_NOT_ALLOWED, -148, "Character data not allowed") \
|
XE(SCPI_ERROR_STRING_DATA_ERROR, -150, "String data error") \
|
X(SCPI_ERROR_INVALID_STRING_DATA, -151, "Invalid string data") \
|
XE(SCPI_ERROR_STRING_DATA_NOT_ALLOWED, -158, "String data not allowed") \
|
XE(SCPI_ERROR_BLOCK_DATA_ERROR, -160, "Block data error") \
|
XE(SCPI_ERROR_INVALID_BLOCK_DATA, -161, "Invalid block data") \
|
XE(SCPI_ERROR_BLOCK_DATA_NOT_ALLOWED, -168, "Block data not allowed") \
|
X(SCPI_ERROR_EXPRESSION_PARSING_ERROR, -170, "Expression error") \
|
XE(SCPI_ERROR_INVAL_EXPRESSION, -171, "Invalid expression") \
|
XE(SCPI_ERROR_EXPRESSION_DATA_NOT_ALLOWED, -178, "Expression data not allowed") \
|
XE(SCPI_ERROR_MACRO_DEFINITION_ERROR, -180, "Macro error") \
|
XE(SCPI_ERROR_INVAL_OUTSIDE_MACRO_DEF, -181, "Invalid outside macro definition") \
|
XE(SCPI_ERROR_INVAL_INSIDE_MACRO_DEF, -183, "Invalid inside macro definition") \
|
XE(SCPI_ERROR_MACRO_PARAMETER_ERROR, -184, "Macro parameter error") \
|
X(SCPI_ERROR_EXECUTION_ERROR, -200, "Execution error") \
|
XE(SCPI_ERROR_INVAL_WHILE_IN_LOCAL, -201, "Invalid while in local") \
|
XE(SCPI_ERROR_SETTINGS_LOST_DUE_TO_RTL, -202, "Settings lost due to rtl") \
|
XE(SCPI_ERROR_COMMAND_PROTECTED, -203, "Command protected") \
|
XE(SCPI_ERROR_TRIGGER_ERROR, -210, "Trigger error") \
|
XE(SCPI_ERROR_TRIGGER_IGNORED, -211, "Trigger ignored") \
|
XE(SCPI_ERROR_ARM_IGNORED, -212, "Arm ignored") \
|
XE(SCPI_ERROR_INIT_IGNORED, -213, "Init ignored") \
|
XE(SCPI_ERROR_TRIGGER_DEADLOCK, -214, "Trigger deadlock") \
|
XE(SCPI_ERROR_ARM_DEADLOCK, -215, "Arm deadlock") \
|
XE(SCPI_ERROR_PARAMETER_ERROR, -220, "Parameter error") \
|
XE(SCPI_ERROR_SETTINGS_CONFLICT, -221, "Settings conflict") \
|
XE(SCPI_ERROR_DATA_OUT_OF_RANGE, -222, "Data out of range") \
|
XE(SCPI_ERROR_TOO_MUCH_DATA, -223, "Too much data") \
|
X(SCPI_ERROR_ILLEGAL_PARAMETER_VALUE, -224, "Illegal parameter value") \
|
XE(SCPI_ERROR_OUT_OF_MEMORY_FOR_REQ_OP, -225, "Out of memory") \
|
XE(SCPI_ERROR_LISTS_NOT_SAME_LENGTH, -226, "Lists not same length") \
|
XE(SCPI_ERROR_DATA_CORRUPT, -230, "Data corrupt or stale") \
|
XE(SCPI_ERROR_DATA_QUESTIONABLE, -231, "Data questionable") \
|
XE(SCPI_ERROR_INVAL_VERSION, -233, "Invalid version") \
|
XE(SCPI_ERROR_HARDWARE_ERROR, -240, "Hardware error") \
|
XE(SCPI_ERROR_HARDWARE_MISSING, -241, "Hardware missing") \
|
XE(SCPI_ERROR_MASS_STORAGE_ERROR, -250, "Mass storage error") \
|
XE(SCPI_ERROR_MISSING_MASS_STORAGE, -251, "Missing mass storage") \
|
XE(SCPI_ERROR_MISSING_MASS_MEDIA, -252, "Missing media") \
|
XE(SCPI_ERROR_CORRUPT_MEDIA, -253, "Corrupt media") \
|
XE(SCPI_ERROR_MEDIA_FULL, -254, "Media full") \
|
XE(SCPI_ERROR_DIRECTORY_FULL, -255, "Directory full") \
|
XE(SCPI_ERROR_FILE_NAME_NOT_FOUND, -256, "File name not found") \
|
XE(SCPI_ERROR_FILE_NAME_ERROR, -257, "File name error") \
|
XE(SCPI_ERROR_MEDIA_PROTECTED, -258, "Media protected") \
|
XE(SCPI_ERROR_EXPRESSION_EXECUTING_ERROR, -260, "Expression error") \
|
XE(SCPI_ERROR_MATH_ERROR_IN_EXPRESSION, -261, "Math error in expression") \
|
XE(SCPI_ERROR_MACRO_UNDEF_EXEC_ERROR, -270, "Macro error") \
|
XE(SCPI_ERROR_MACRO_SYNTAX_ERROR, -271, "Macro syntax error") \
|
XE(SCPI_ERROR_MACRO_EXECUTION_ERROR, -272, "Macro execution error") \
|
XE(SCPI_ERROR_ILLEGAL_MACRO_LABEL, -273, "Illegal macro label") \
|
XE(SCPI_ERROR_IMPROPER_USED_MACRO_PARAM, -274, "Macro parameter error") \
|
XE(SCPI_ERROR_MACRO_DEFINITION_TOO_LONG, -275, "Macro definition too long") \
|
XE(SCPI_ERROR_MACRO_RECURSION_ERROR, -276, "Macro recursion error") \
|
XE(SCPI_ERROR_MACRO_REDEF_NOT_ALLOWED, -277, "Macro redefinition not allowed") \
|
XE(SCPI_ERROR_MACRO_HEADER_NOT_FOUND, -278, "Macro header not found") \
|
XE(SCPI_ERROR_PROGRAM_ERROR, -280, "Program error") \
|
XE(SCPI_ERROR_CANNOT_CREATE_PROGRAM, -281, "Cannot create program") \
|
XE(SCPI_ERROR_ILLEGAL_PROGRAM_NAME, -282, "Illegal program name") \
|
XE(SCPI_ERROR_ILLEGAL_VARIABLE_NAME, -283, "Illegal variable name") \
|
XE(SCPI_ERROR_PROGRAM_CURRENTLY_RUNNING, -284, "Program currently running") \
|
XE(SCPI_ERROR_PROGRAM_SYNTAX_ERROR, -285, "Program syntax error") \
|
XE(SCPI_ERROR_PROGRAM_RUNTIME_ERROR, -286, "Program runtime error") \
|
XE(SCPI_ERROR_MEMORY_USE_ERROR, -290, "Memory use error") \
|
XE(SCPI_ERROR_OUT_OF_MEMORY, -291, "Out of memory") \
|
XE(SCPI_ERROR_REF_NAME_DOES_NOT_EXIST, -292, "Referenced name does not exist") \
|
XE(SCPI_ERROR_REF_NAME_ALREADY_EXISTS, -293, "Referenced name already exists") \
|
XE(SCPI_ERROR_INCOMPATIBLE_TYPE, -294, "Incompatible type") \
|
XE(SCPI_ERROR_DEVICE_ERROR, -300, "Device specific error") \
|
X(SCPI_ERROR_SYSTEM_ERROR, -310, "System error") \
|
XE(SCPI_ERROR_MEMORY_ERROR, -311, "Memory error") \
|
XE(SCPI_ERROR_PUD_MEMORY_LOST, -312, "PUD memory lost") \
|
XE(SCPI_ERROR_CALIBRATION_MEMORY_LOST, -313, "Calibration memory lost") \
|
XE(SCPI_ERROR_SAVE_RECALL_MEMORY_LOST, -314, "Save/recall memory lost") \
|
XE(SCPI_ERROR_CONFIGURATION_MEMORY_LOST, -315, "Configuration memory lost") \
|
XE(SCPI_ERROR_STORAGE_FAULT, -320, "Storage fault") \
|
XE(SCPI_ERROR_OUT_OF_DEVICE_MEMORY, -321, "Out of memory") \
|
XE(SCPI_ERROR_SELF_TEST_FAILED, -330, "Self-test failed") \
|
XE(SCPI_ERROR_CALIBRATION_FAILED, -340, "Calibration failed") \
|
X(SCPI_ERROR_QUEUE_OVERFLOW, -350, "Queue overflow") \
|
XE(SCPI_ERROR_COMMUNICATION_ERROR, -360, "Communication error") \
|
XE(SCPI_ERROR_PARITY_ERROR_IN_CMD_MSG, -361, "Parity error in program message") \
|
XE(SCPI_ERROR_FRAMING_ERROR_IN_CMD_MSG, -362, "Framing error in program message") \
|
X(SCPI_ERROR_INPUT_BUFFER_OVERRUN, -363, "Input buffer overrun") \
|
XE(SCPI_ERROR_TIME_OUT, -365, "Time out error") \
|
XE(SCPI_ERROR_QUERY_ERROR, -400, "Query error") \
|
XE(SCPI_ERROR_QUERY_INTERRUPTED, -410, "Query INTERRUPTED") \
|
XE(SCPI_ERROR_QUERY_UNTERMINATED, -420, "Query UNTERMINATED") \
|
XE(SCPI_ERROR_QUERY_DEADLOCKED, -430, "Query DEADLOCKED") \
|
XE(SCPI_ERROR_QUERY_UNTERM_INDEF_RESP, -440, "Query UNTERMINATED after indefinite response") \
|
XE(SCPI_ERROR_POWER_ON, -500, "Power on") \
|
XE(SCPI_ERROR_USER_REQUEST, -600, "User request") \
|
XE(SCPI_ERROR_REQUEST_CONTROL, -700, "Request control") \
|
XE(SCPI_ERROR_OPERATION_COMPLETE, -800, "Operation complete") \
|
|
|
enum {
|
#define X(def, val, str) def = val,
|
#if USE_FULL_ERROR_LIST
|
#define XE X
|
#else
|
#define XE(def, val, str)
|
#endif
|
LIST_OF_ERRORS
|
|
#if USE_USER_ERROR_LIST
|
LIST_OF_USER_ERRORS
|
#endif
|
#undef X
|
#undef XE
|
};
|
|
#ifdef __cplusplus
|
}
|
#endif
|
|
#endif /* SCPI_ERROR_H */
|
