From 11f2f2e329ef404d0e9c022cb2f9fbbb45bae285 Mon Sep 17 00:00:00 2001 From: nancy.liao <huihui.liao@greentest.com.cn> Date: 周日, 27 4月 2025 17:33:31 +0800 Subject: [PATCH] 完成了SCPI命令语法分析器的完整规则 --- libscpi/src/error.c | 156 ++++++++++++++++++++++++++++------------------------ 1 files changed, 84 insertions(+), 72 deletions(-) diff --git a/libscpi/src/error.c b/libscpi/src/error.c index d1307a4..00f4869 100644 --- a/libscpi/src/error.c +++ b/libscpi/src/error.c @@ -1,30 +1,30 @@ /*- - * Copyright (c) 2012-2013 Jan Breuer, + * BSD 2-Clause License * - * All Rights Reserved + * Copyright (c) 2012-2018, 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. + * modification, are permitted provided that the following conditions are met: * - * 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. + * * Redistributions of source code must retain the above copyright notice, this + * list of conditions and the following disclaimer. + * + * * 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 COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT HOLDER 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.c * @date Thu Nov 15 10:58:45 UTC 2012 @@ -36,10 +36,17 @@ #include <stdint.h> -#include "scpi/parser.h" -#include "scpi/ieee488.h" -#include "scpi/error.h" +#include <scpi/parser.h> +#include <scpi/ieee488.h> +#include <scpi/error.h> #include "fifo_private.h" +#include <scpi/constants.h> + +#if USE_DEVICE_DEPENDENT_ERROR_INFORMATION +#define SCPI_ERROR_SETVAL(e, c, i) do { (e)->error_code = (c); (e)->device_dependent_info = (i); } while(0) +#else +#define SCPI_ERROR_SETVAL(e, c, i) do { (e)->error_code = (c); (void)(i);} while(0) +#endif /** * Initialize error queue @@ -82,11 +89,11 @@ */ void SCPI_ErrorClear(scpi_t * context) { #if USE_DEVICE_DEPENDENT_ERROR_INFORMATION - scpi_error_t error; - while(fifo_remove(&context->error_queue, &error)){ - SCPIDEFINE_free(&context->error_info_heap, error.device_dependent_info, false); - } -#endif + scpi_error_t error; + while (fifo_remove(&context->error_queue, &error)) { + SCPIDEFINE_free(&context->error_info_heap, error.device_dependent_info, false); + } +#endif fifo_clear(&context->error_queue); SCPI_ErrorEmitEmpty(context); @@ -96,17 +103,16 @@ * Pop error from queue * @param context - scpi context * @param error - * @return + * @return */ scpi_bool_t SCPI_ErrorPop(scpi_t * context, scpi_error_t * error) { - if(!error || !context) return FALSE; - error->error_code = 0; - error->device_dependent_info = NULL; - fifo_remove(&context->error_queue, error); + if (!error || !context) return FALSE; + SCPI_ERROR_SETVAL(error, 0, NULL); + fifo_remove(&context->error_queue, error); - SCPI_ErrorEmitEmpty(context); + SCPI_ErrorEmitEmpty(context); - return TRUE; + return TRUE; } /** @@ -122,10 +128,22 @@ return result; } -static scpi_bool_t SCPI_ErrorAddInternal(scpi_t * context, int16_t err, char * info) { - if (!fifo_add(&context->error_queue, err, info)) { - fifo_remove_last(&context->error_queue, NULL); - fifo_add(&context->error_queue, SCPI_ERROR_QUEUE_OVERFLOW, NULL); +static scpi_bool_t SCPI_ErrorAddInternal(scpi_t * context, int16_t err, char * info, size_t info_len) { + scpi_error_t error_value; + /* SCPIDEFINE_strndup is sometimes a dumy that does not reference it's arguments. + Since info_len is not referenced elsewhere caoing to void prevents unusd argument warnings */ + (void) info_len; + char * info_ptr = NULL; + if (info) { + info_ptr = SCPIDEFINE_strndup(&context->error_info_heap, info, info_len); + } + SCPI_ERROR_SETVAL(&error_value, err, info_ptr); + if (!fifo_add(&context->error_queue, &error_value)) { + SCPIDEFINE_free(&context->error_info_heap, error_value.device_dependent_info, true); + fifo_remove_last(&context->error_queue, &error_value); + SCPIDEFINE_free(&context->error_info_heap, error_value.device_dependent_info, true); + SCPI_ERROR_SETVAL(&error_value, SCPI_ERROR_QUEUE_OVERFLOW, NULL); + fifo_add(&context->error_queue, &error_value); return FALSE; } return TRUE; @@ -134,10 +152,10 @@ struct error_reg { int16_t from; int16_t to; - scpi_reg_val_t bit; + scpi_reg_val_t esrBit; }; -#define ERROR_DEFS_N 9 +#define ERROR_DEFS_N 9 static const struct error_reg errs[ERROR_DEFS_N] = { {-100, -199, ESR_CER}, /* Command error (e.g. syntax error) ch 21.8.9 */ @@ -153,38 +171,33 @@ /** * Push error to queue - * @param context - scpi context + * @param context * @param err - error number + * @param info - additional text information or NULL for no text + * @param info_len - length of text or 0 for automatic length */ -void SCPI_ErrorPushEx(scpi_t * context, int16_t err, char * info) { - int i; - char * info_ptr = NULL; - -#if USE_DEVICE_DEPENDENT_ERROR_INFORMATION - if (info){ - info_ptr = SCPIDEFINE_strdup(&context->error_info_heap, info); - } -#endif +void SCPI_ErrorPushEx(scpi_t * context, int16_t err, char * info, size_t info_len) { + int i; + /* automatic calculation of length */ + if (info && info_len == 0) { + info_len = SCPIDEFINE_strnlen(info, SCPI_STD_ERROR_DESC_MAX_STRING_LENGTH); + } + scpi_bool_t queue_overflow = !SCPI_ErrorAddInternal(context, err, info, info_len); - scpi_bool_t queue_overflow = !SCPI_ErrorAddInternal(context, err, info_ptr); + for (i = 0; i < ERROR_DEFS_N; i++) { + if ((err <= errs[i].from) && (err >= errs[i].to)) { + SCPI_RegSetBits(context, SCPI_REG_ESR, errs[i].esrBit); + } + } - for (i = 0; i < ERROR_DEFS_N; i++) { - if ((err <= errs[i].from) && (err >= errs[i].to)) { - SCPI_RegSetBits(context, SCPI_REG_ESR, errs[i].bit); - } - } + SCPI_ErrorEmit(context, err); + if (queue_overflow) { + SCPI_ErrorEmit(context, SCPI_ERROR_QUEUE_OVERFLOW); + } - SCPI_ErrorEmit(context, err); - if (queue_overflow) { - SCPI_ErrorEmit(context, SCPI_ERROR_QUEUE_OVERFLOW); -#if USE_DEVICE_DEPENDENT_ERROR_INFORMATION - SCPIDEFINE_free(&context->error_info_heap, info_ptr, true); -#endif - } - - if (context) { - context->cmd_error = TRUE; - } + if (context) { + context->cmd_error = TRUE; + } } /** @@ -193,8 +206,8 @@ * @param err - error number */ void SCPI_ErrorPush(scpi_t * context, int16_t err) { - SCPI_ErrorPushEx(context, err, NULL); - return; + SCPI_ErrorPushEx(context, err, NULL, 0); + return; } /** @@ -204,7 +217,6 @@ */ const char * SCPI_ErrorTranslate(int16_t err) { switch (err) { - case 0: return "No error"; #define X(def, val, str) case def: return str; #if USE_FULL_ERROR_LIST #define XE X -- Gitblit v1.9.1